Libro de Tubos

Entrenamiento (caso práctico con bifurcación) · Formato Reporte Diario de Curvado · Formato Reporte Diario de Soldadura

Registro de trazabilidad de cada tubo y accesorio instalado: material (colada), posición (PK), juntas soldadas, curvado e inspecciones END. Ruta del módulo: /ncs_libro_tubo. Para aprender con un caso completo, pulse Cargar ejemplo y siga el entrenamiento.

Contenido
  1. Empresa y orden de trabajo (OT)
  2. Flujo de trabajo
  3. Cálculo del PK
  4. Mapa visual de la pantalla del libro — 4.1 barra superior · 4.2 herramientas de la tabla · 4.3 encabezados, filas y pie
  5. Detalle de los botones del libro — 5.1 Agregar tramo · 5.2 Validar · 5.3 Recalcular PK · 5.4 Consolidar END · 5.5 Excel · 5.6 Vaciar libro · 5.7 Editar · 5.8 Cortar (tijera) · 5.9 Ramal · 5.10 Borrar tramo · 5.11 Diagrama
  6. Referencia de botones por pantalla — 6.1 principal · 6.2 barra de tablas · 6.3 libros (6.3.1 nuevo libro · 6.3.2 exportar · 6.3.3 importar) · 6.4 inventario · 6.5 soldaduras y END · 6.6 auditoría · 6.7 libro · 6.8 formulario de tramo (pestañas Tramo y Uniones) · 6.9 botones de fila
  7. Cortes, niples, bifurcaciones y ecuación de PK
  8. Auditoría
  9. Diseño de junta soldada: guía para el inspector — 9.1 qué es · 9.2 anatomía · 9.3 catálogo de tipos · 9.4 pases · 9.5 lados · 9.6 cómo llenarlo · 9.7 errores · 9.8 normas · 9.9 derivaciones y soldadura por el interior · 9.10 comparación por tipo de unión

1. Empresa y orden de trabajo (OT)

Cada libro queda asociado internamente a su empresa y a la orden de trabajo (OT) actual (la OT en la que usted ingresó en el ERP); esa referencia se guarda en la base de datos y no se muestra en pantalla.

2. Flujo de trabajo

  1. Inventario (acopio): cargue los tubos y accesorios con ID, colada, diámetro, espesor, revestimiento y longitud de fábrica.
  2. Libros y ramales → Nuevo ramal: nombre y PK de arranque en metros (ej. 5100 = 5+100.00).
  3. Abrir el libro → Agregar tramo: elija el elemento de acopio, indique juntas, coordenadas y curvado. El PK se calcula solo.
  4. Validar al cierre del día y Excel para entregar el libro.

Cada día: primero el Reporte Diario de Curvado, luego el Reporte Diario de Soldadura, y al final la validación cruzada (ver entrenamiento, sección 5 y sección 6).

3. Cálculo del PK

4. Mapa visual de la pantalla del libro

Pantalla que se abre con Abrir en la lista de libros. Los números de la imagen corresponden a la lista de componentes de abajo (rojo: botones de acción; azul: datos y herramientas de la tabla; verde: encabezados y paginación).

Pantalla del libro de tubos123456789101112131415161718192021

4.1 Componentes de la barra superior

N°ComponentePara qué sirve
1Título y ? (ayuda)Nombre del libro abierto. El ícono ? abre esta ayuda.
2Agregar tramoInstala un tubo o accesorio del acopio al final del libro o intercalado. Calcula solo el PK del tramo nuevo. Ver detalle · campos en 6.8.
—DiagramaBotón gris, a la derecha de Agregar tramo (no aparece en la captura). Muestra u oculta un esquema lineal de tramos y uniones. Ver detalle.
3ValidarRevisión de solo lectura: continuidad de PK, topología de juntas, extremos abiertos y colada. Ver detalle y ejemplo.
4Recalcular PKRehace en cascada la numeración y los PK de todos los tramos. Ver fórmula y ejemplo · regla general en capítulo 3.
5Consolidar ENDResume en cada junta el resultado de sus reportes END (Estado NDT). Ver reglas y ejemplo.
6ExcelDescarga el libro en .xlsx. Ver detalle.
7Vaciar libroBorra todos los tramos del libro y sus ramales. Ver detalle.
8LibrosVuelve a la lista de libros y ramales (6.3).

4.2 Datos y herramientas de la tabla

N°ComponentePara qué sirve
9PK de arranquePK donde empieza el libro, en formato K+MMM.MM. Se cambia desde Editar en la lista de libros (en un ramal siempre es 0+000.00).
10BuscarFiltra las filas por texto (ID, colada, soldadura, observaciones…).
11Actualizar (⟳)Vuelve a pedir los datos al servidor.
12TarjetasAlterna entre vista de tabla y vista de tarjetas (útil en móvil).
13Altura de fila (↕)Alterna entre filas de altura fija (con desplazamiento) y filas con todo su contenido. Se recuerda en el navegador.
14ColumnasMuestra u oculta columnas (diámetro, espesor, revestimiento, WPS, coordenadas, costura). Se recuerda en el navegador.
15ExportarMenú con icono: CSV ( , ), CSV ( ; ), TXT, Excel, Word vertical, Word horizontal, PDF vertical, PDF horizontal y PNG. Ver 6.2.

4.3 Encabezados, botones de fila y pie

N°ComponentePara qué sirve
16Encabezados de columnaClic para ordenar (flecha ▲▼); arrastre para reordenar columnas. Columnas: Item, ID Tubo, N° Colada, Long., PK Inicio, PK Fin, Unión Ant./Post., Estado NDT, Curvado, Observaciones.
17Editar (lápiz naranja)Modifica el tramo (longitud, juntas, curvado, coordenadas…). Recalcula los PK posteriores. Ver detalle.
18Cortar (tijera celeste)Registra un corte en obra: el instalado queda ID-A y el sobrante vuelve a acopio como ID-B. Ver detalle y ejemplo.
19Borrar (papelera roja)Elimina el tramo; el elemento vuelve a acopio y los PK se recalculan.
20Ramal (solo en Te)En accesorios Te aparece el botón Crear ramal; si ya existe, una etiqueta con el nombre del ramal (ej. Ramal: DEMO Ramal B). La Te con ramal no se puede borrar.
21Pie de tablaCantidad de resultados mostrados y paginación (10 a todas las filas).
Colores de Estado NDT: Aprobado (todos los reportes END aprobados), Rechazado (algún reporte rechazado), Pendiente (hay reportes sin resultado). Vacío = la junta aún no existe (ej. frente de soldadura del último tubo).

5. Detalle de los botones del libro

Explicación paso a paso de cada botón de la barra superior y de los botones de cada fila (números 2 a 8 y 17 a 20 del mapa), con fórmulas y ejemplos.

5.1 Agregar tramo

Abre el formulario descrito en 6.8. Al guardar, el sistema asigna la secuencia, calcula PK inicio y PK fin y recalcula los tramos siguientes si se intercaló.

Ejemplo. Libro con PK de arranque 5+100.00 y tramos de 12.05 m y 11.95 m (último PK fin = 5+124.00). Se agrega un tubo de 12.10 m al final:
PK inicio = 5+124.00 · PK fin = 5+124.00 + 12.10 = 5+136.10.
Si se indica "Intercalar en posición 2", el nuevo tramo pasa a ser el 2 y los que estaban desde el 2 se desplazan (+1) con todos sus PK corridos 12.10 m.

Lo que cambia en el acopio: el elemento pasa a estado Instalado. Las juntas escritas se crean si no existían (6.5).

5.2 Validar

Recorre el libro tramo por tramo y arma una lista de hallazgos en un panel. No modifica ningún dato: se puede ejecutar cuantas veces se quiera, normalmente al cierre del día, después de cargar el Reporte de Curvado y el de Soldadura (entrenamiento, sección 6).

ControlQué verificaCómo corregirlo
Continuidad de PK (inicio)El PK inicio de cada tramo debe ser igual al PK fin del anterior (o al PK de arranque en el primero; o la Ecuación PK si el tramo la tiene).Use Recalcular PK.
Continuidad de PK (fin)PK fin = PK inicio + longitud instalada.Use Recalcular PK.
Colada informadaTodo elemento instalado debe tener N° de colada.Complete la colada en el Inventario (6.4).
Unión anterior = unión posterior previaEl tipo de empalme de entrada de un tramo debe ser el mismo que el de salida del tramo anterior; si es junta soldada, también el mismo código.Edite el tramo (6.8.2) y corrija el tipo o el código.
Junta soldada sin códigoSi el tipo es Junta soldada, debe tener código de junta.Escriba el código en la pestaña de unión.
Extremo abiertoSolo el último tramo puede tener la unión posterior Sin definir (frente abierto o fin de línea).Defina la unión posterior del tramo.
Fin de línea mal marcadoUn tramo marcado como fin de línea no puede tener tramos posteriores ni una unión posterior definida.Desmarque Es el fin de línea o borre los tramos que sobran.
Junta compartida por tramos no contiguosUna junta une exactamente dos tramos consecutivos; no puede aparecer en tres, ni en dos que no sean vecinos.Revise si se repitió un código de soldadura.
Ejemplo de hallazgos.
Item 3 (TB-D003): junta anterior (W-D009) distinta de la junta posterior del item previo (W-D002). → el tramo 3 se cargó con un código de junta equivocado.
Item 4 (TE-D01): union anterior (Brida) distinta de la union posterior del item previo (Junta soldada). → el tipo de empalme no coincide entre tramos contiguos.
Item 5 (TB-D004): union posterior sin definir y no es el ultimo item (extremo abierto). → falta definir la unión de salida.
Si todo está bien el panel no muestra errores. Un libro sin tramos solo informa "El libro no tiene items".

5.3 Recalcular PK

Ordena los tramos por secuencia, los renumera 1, 2, 3… sin huecos y rehace todos los PK con esta regla (la misma de la capítulo 3):

PK inicio(n) = PK fin(n−1)  ·  PK fin(n) = PK inicio(n) + longitud instalada(n)  ·  PK inicio(1) = PK de arranque

Si un tramo tiene PK adelante (ecuación de PK, capítulo 7), ese valor reemplaza al PK fin del anterior y desde ahí sigue la cascada. El cálculo se hace en centímetros enteros, sin error de decimales.

Ejemplo. PK de arranque 5+100.00 (= 5100 m):
TramoLongitudPK inicioPK fin
112.055+100.005+112.05
211.955+112.055+124.00
312.105+124.005+136.10
Si el tramo 2 se edita a 12.20 m, los PK del 2 en adelante cambian +0.25 m: el tramo 3 pasa a 5+124.25 → 5+136.35.
Si el tramo 3 tuviera PK adelante = 5200, quedaría 5+200.00 → 5+212.10 sin importar el PK fin del tramo 2.

¿Cuándo usarlo? Normalmente nunca: el libro se recalcula solo al agregar, editar, cortar o borrar. Úselo cuando Validar informe "PK inicio no coincide con el esperado" (por ejemplo, tras una carga masiva o una corrección directa en la base de datos). Deja un registro resumen en la auditoría con la cantidad de tramos modificados y el PK final de la línea.

5.4 Consolidar END

Cada junta puede tener varias referencias a reportes END (Rx, UT, AUT, VT…), registradas en la pestaña Soldaduras y END (6.5). Este botón resume esas referencias en la columna Estado NDT de cada junta del libro, con esta regla (se evalúa en este orden):

Condición sobre los reportes de la juntaEstado NDT
Al menos un reporte RechazadoRechazado
Hay reportes y ninguno está PendienteAprobado
Sin reportes, o con alguno PendientePendiente
Ejemplo. Junta W-D004: Rx-101 Aprobado + UT-045 Aprobado → Aprobado. Si luego llega UT-046 Rechazado → Rechazado (basta uno). Junta W-D006: Rx-120 Aprobado + UT-060 Pendiente → Pendiente. Junta sin reportes → Pendiente.

Solo se actualizan las juntas cuyo estado cambió; el mensaje informa cuántas. No es automático: después de agregar o cambiar referencias END hay que volver a pulsar el botón. Queda registrado en la auditoría (evento consolidar_end).

5.5 Excel

Descarga un archivo .xlsx con el libro tal como está en ese momento (no hace falta guardar nada antes). Tiene dos hojas:

Recomendación: ejecute Recalcular PK si hace falta, Validar y Consolidar END antes de exportar, para entregar un libro consistente (flujo en la capítulo 2).

5.6 Vaciar libro

Elimina todos los tramos del libro y de sus ramales. Los tubos y accesorios vuelven al acopio como En Acopio; se conservan la cabecera del libro (nombre, PK de arranque) y la auditoría. Sirve para rehacer el libro desde cero o repetir el ejemplo (entrenamiento, sección 1).

Pide escribir VACIAR para confirmar. No se puede deshacer. Para borrar el libro en sí, vacíelo y luego use Borrar en la lista de libros (6.3).

5.7 Editar tramo (lápiz naranja)

Abre el mismo formulario de 6.8 con los datos del tramo. Se puede cambiar longitud, juntas, WPS, fechas, costura, ecuación de PK, coordenadas, curvado y observaciones. No se puede cambiar el tubo o accesorio del tramo.

Ejemplo. El tramo 2 mide 11.95 m y se corrige a 12.20 m en obra: diferencia +0.25 m. El PK fin del tramo 2 pasa de 5+124.00 a 5+124.25 y todos los siguientes se corren +0.25 m.

¿Quiere cambiar el tubo? Borre el tramo (5.10) y agréguelo de nuevo con el otro elemento indicando "Intercalar en posición" (5.1).

5.8 Cortar / niple (tijera celeste)

Registra que en obra se cortó el tubo para ajustarlo a la zanja o al empalme. El sistema deja trazabilidad completa: el trozo instalado y el sobrante conservan la colada y el ID de fábrica.

Cómo usarlo: pulse la tijera de la fila → escriba la nueva longitud instalada (en metros) → confirme.

Condición: 0 < longitud instalada < longitud de fábrica. La comparación es contra la longitud original del acopio, no contra la que tenga el tramo en ese momento. Si no se cumple, el sistema informa "La longitud instalada debe ser mayor que 0 y menor que la longitud de fabrica (X m)" y no cambia nada.

Qué cambiaAntesDespués
ID del tubo instaladoTB-D006TB-D006A (el ID de fábrica se conserva aparte)
Longitud instalada del tramo12.00 m9.50 m (la que usted escribió)
Sobranteno existeNuevo elemento TB-D006B, estado En Acopio, misma colada, diámetro, espesor y revestimiento
Longitud del sobrante—fábrica − instalada = 12.00 − 9.50 = 2.50 m
Observaciones del tramo—Se agrega automáticamente: Corte de tubo (origen 12 m); sobrante TB-D006B
PK de los tramos posteriores—Se recalculan (5.3): el tramo y los siguientes se acortan 2.50 m
Ejemplo. Tramo 7, tubo TB-D006 de 12.00 m, PK inicio 5+161.60. Sin corte terminaría en 5+173.60. Se corta a 9.50 m → PK fin = 5+161.60 + 9.50 = 5+171.10, y el tramo 8 arranca ahí. El sobrante de 2.50 m queda disponible en el Inventario (6.4) y puede instalarse después con Agregar tramo.
Todo corte queda en la auditoría (evento corte). No hay botón para deshacerlo: si se equivocó, edite la longitud del tramo (5.7) y ajuste el sobrante en el Inventario. Detalle del flujo de campo en el entrenamiento, sección 5.

5.9 Crear ramal (bifurcación, botón celeste)

Solo aparece en filas cuyo elemento es una Te. Crea el libro del ramal que sale de esa Te.

Cómo usarlo: pulse el botón → escriba el nombre del ramal (obligatorio, hasta 100 caracteres) → confirme.

Dato del ramalValor que asigna el sistema
PK de arranque0+000.00 (bloqueado, no se puede editar)
Línea madreEl libro desde el que se creó
PK de derivaciónCentro de la Te: (PK inicio + PK fin) ÷ 2
Coordenadas Norte / Este / CotaCopiadas de la Te
Nota de amarre (Tie-in)Texto automático con el ID de la Te, el PK de derivación y el nombre de la línea madre
Ejemplo. Te TE-D01 con 2.00 m pasantes entre 5+136.10 y 5+138.10. Centro = (5136.10 + 5138.10) ÷ 2 = 5137.10 m → 5+137.10. El ramal DEMO Ramal B parte en 0+000.00 amarrado a ese punto. La línea principal solo suma los 2.00 m pasantes y sigue su PK sin reiniciarse.

5.10 Borrar tramo (papelera roja)

Quita el tramo del libro. Pide confirmación.

Ejemplo. Se borra el tramo 2 (11.95 m): el tramo 3 pasa de PK inicio 5+124.00 a 5+112.05 y todos los siguientes se corren −11.95 m.
Al borrar un tramo del medio, la junta posterior del tramo anterior ya no coincide con la junta anterior del siguiente. Ejecute Validar y corrija las juntas con Editar.

5.11 Diagrama

Botón gris Diagrama, junto a Agregar tramo. Abre (y vuelve a cerrar) un panel con un esquema lineal del libro, dibujado con los mismos datos de la tabla, de izquierda a derecha en el orden de los tramos.

Sirve para revisar de un vistazo la continuidad de uniones y detectar extremos abiertos antes de Validar.

5.12 Detalle de tramo y de junta (bajo el diagrama)

Al hacer clic en un tramo o en una junta (círculo) del diagrama se abre un panel de detalle debajo. Todos los paneles tienen el botón Cerrar (vuelve al mensaje inicial). El panel de un tramo ofrece además Editar tramo (abre el formulario de 6.8).

Si el círculo es una junta soldada, el panel muestra:

Si el círculo es otro tipo de empalme (brida, acople, otro) o un extremo sin definir, el panel muestra solo los datos básicos del empalme (sin pases, END ni reporte).

6. Referencia de botones por pantalla

6.1 Pantalla principal

BotónQué haceOpciones / observaciones
? (ayuda)Abre esta ayuda.
Cargar ejemploCrea los datos del tutorial: libro DEMO Gasoducto Troncal 24, ramal DEMO Ramal B, inventario, juntas y referencias END.Pide confirmación. Si el ejemplo ya existe lo informa y no duplica. Para repetirlo: Vaciar libro o Borrar todo.
Borrar todoElimina todos los libros, ramales, tramos, curvados, inventario, juntas y referencias END de su empresa.Exige escribir BORRAR. La auditoría se conserva y registra el borrado con los totales. No se puede deshacer.
PestañasLibros y ramales · Inventario (acopio) · Soldaduras y END · Auditoría.La auditoría se carga al abrir su pestaña.

6.2 Barra de todas las tablas

ElementoQué hace
BuscarFiltra en el servidor por las columnas de texto de la tabla.
Actualizar (⟳)Vuelve a pedir los datos.
TarjetasAlterna entre tabla y vista de tarjetas.
ColumnasMuestra u oculta columnas. La elección se recuerda en el navegador. También puede arrastrar los encabezados para reordenar.
Altura de fila (↕)Filas de altura fija con desplazamiento, o con todo su contenido (se recuerda en el navegador).
ExportarMenú con icono, igual en todas las tablas del sistema: CSV ( , ) y CSV ( ; ) (Excel abre bien las tildes), TXT, Excel, Word vertical / horizontal, PDF vertical / horizontal y PNG. Exporta todas las filas que cumplen la búsqueda y el orden actuales (no solo la página visible), con todas las columnas de la tabla aunque estén ocultas, menos la de acciones y con las fechas en el formato de su empresa. PNG es la imagen de la página que se ve. CSV, TXT y PNG se generan en el navegador; Excel, Word y PDF, en el servidor (el PDF es un bloque por registro).
Paginación10, 25, 50, 100, 200 o todas las filas.

6.3 Pestaña Libros y ramales

BotónQué haceOpciones / observaciones
Nuevo ramalCrea una línea principal.Nombre (obligatorio), PK de arranque en metros (se muestra en formato K+MMM), observaciones y, opcional, la geometría de tubería (pestaña Geometría). Ver 6.3.1.
ExportarGenera un archivo XML (o SQL, solo usuarios autorizados) con los libros de la orden.Ver 6.3.2.
ImportarCarga en la orden actual un XML generado con Exportar.Ver 6.3.3.
AbrirEntra al libro para cargar y consultar sus tramos.Los ramales se abren igual, desde esta lista.
Editar (lápiz)Cambia nombre, PK de arranque y observaciones.Cambiar el PK de arranque recalcula todos los PK. En un ramal el PK de arranque está bloqueado (siempre 0+000.00).
Borrar (papelera)Elimina el libro.Solo si no tiene tramos ni ramales (use antes Vaciar libro).

Columnas: tipo (línea principal o ramal), línea madre, PK de arranque, cantidad de tramos y nota de amarre (Tie-in) del ramal.

6.3.1 Ventana Nuevo ramal (pestañas General, Especificación de tubería y Diseño de junta)

Se abre con Nuevo ramal. Con Editar (lápiz) es la misma ventana, con el título «Editar libro #N» y los datos cargados. Es una ventana ancha con tres pestañas: General, Especificación de tubería (antes llamada «Geometría») y Diseño de junta. El ícono ? del título abre esta ayuda en el tema de la pestaña que esté activa.

En ramales anteriores a este cambio el diseño de junta puede estar vacío; al editarlos hay que completarlo para poder guardar. Nuevo libro (nombre anterior de «Nuevo ramal») y Geometría (nombre anterior de «Especificación de tubería») aparecen así en las capturas antiguas, que se conservan en las carpetas de imágenes.

Pestaña General (datos básicos del ramal):

Ventana Nuevo ramal, pestaña General123456789101112
N°Campo / elementoQué hace
1Título y ? (ayuda)«Nuevo ramal» (o «Editar libro #N» al editar). El ícono ? abre esta ayuda en el tema de la pestaña que esté activa: General, Especificación de tubería o Diseño de junta.
2Pestaña GeneralPestaña activa al abrir (resaltada): nombre, PK de arranque, posición GPS y observaciones del ramal.
3Pestaña Especificación de tuberíaDefine el diámetro (NPS) y el schedule o espesor de pared de la tubería del ramal (antes llamada «Geometría»). Ver la imagen siguiente.
4Pestaña Diseño de juntaPreparación de bordes de las soldaduras: tipo de junta, número de pases y lados. Obligatoria. Ver más abajo.
5Etiqueta de resumenAparece junto al nombre de la pestaña Diseño de junta cuando ya se eligió un tipo (aquí V); con pases, muestra por ejemplo V · 6. En la pestaña Especificación de tubería la etiqueta muestra el NPS y el schedule elegidos (ej. NPS 24 SCH40).
6NombreObligatorio, hasta 100 caracteres. Identifica el ramal en las listas y en el Excel (ej. Gasoducto Troncal 24 pulg).
7PK de arranque [m] (*)Obligatorio. PK donde empieza el ramal, en metros (mínimo 0, hasta 2 decimales). Es el PK inicio del primer tramo (capítulo 3). Al editarlo, todos los PK del libro se recalculan. En un ramal creado desde una Te está bloqueado en 0+000.00.
8Botón de posición GPSÍcono de ubicación junto al PK. Abre un panel para registrar la posición GPS del ramal (opcional): latitud y longitud en grados decimales (WGS84) y altura en metros. El panel trae Obtener (toma la posición del dispositivo; el navegador pide permiso), Ver en mapa (OpenStreetMap), Limpiar (borra los tres datos) y, para coordenadas UTM, una conversión con zona (1 a 60) y hemisferio (N o S). Cuando hay posición guardada el botón muestra una marca ✓.
9Equivalente K+MMMTexto gris bajo el PK: muestra el valor ingresado en formato de kilometraje (5100 → 5+100.00). Se actualiza al escribir.
10ObservacionesTexto libre opcional (alcance de la línea, referencia de diseño).
11GuardarCrea el ramal (o guarda los cambios) con los datos de las tres pestañas, cierra la ventana y actualiza la lista. Exige una OT actual (capítulo 1) y que el diseño de junta esté completo; si falta algo, abre la pestaña correspondiente y avisa.
12CerrarCierra la ventana sin guardar (igual que la ×).

Pestaña Especificación de tubería (opcional):

Ventana Nuevo ramal, pestaña Especificación de tubería1234567891011
N°Campo / elementoQué hace
1Título y ? (ayuda)Con esta pestaña activa, el ? abre este tema.
2Pestaña GeneralVuelve a los datos básicos. No se pierde lo ya escrito al cambiar de pestaña.
3Pestaña Especificación de tuberíaPestaña activa (resaltada, con ícono de regla).
4Pestaña Diseño de juntaSalta al diseño de junta (obligatorio).
5Texto explicativoLos datos se toman de la base de componentes (módulo Componentes de tubería). Con la especificación definida, los tramos del libro solo aceptan elementos con ese diámetro (NPS) y, los tubos, ese espesor de pared. Es opcional: sin especificación no se restringe nada.
6Diámetro de tubería (NPS)Título de la primera lista.
7Lista de diámetrosDiámetros nominales (NPS) disponibles en el catálogo de tuberías. Por defecto — Sin definir —. Al elegir uno se carga la lista siguiente.
8Schedule / espesor de paredTítulo de la segunda lista.
9Lista de schedulesSchedules (o espesores) del catálogo para el NPS elegido (ej. SCH40, STD). — Sin definir — = sin restricción de espesor. Al elegir uno aparece un recuadro gris con los datos del catálogo: Norma | OD (mm) | Espesor (mm) | Peso (kg/m, o «sin peso» si la norma no define factor), y la etiqueta de la pestaña se completa con el resumen (ej. NPS 24 SCH40).
10GuardarGuarda el ramal con la especificación elegida (y el resto de los datos; el diseño de junta debe estar completo).
11CerrarCierra sin guardar.
Ejemplo. Línea de 24" schedule 40: pestaña General → nombre «Gasoducto Troncal 24»; pestaña Especificación de tubería → diámetro 24, schedule 40. Desde ahora los tramos de ese ramal solo aceptan elementos de 24" con ese espesor.
Si la lista de diámetros está vacía, aún no hay tuberías cargadas en el módulo Componentes: cárguelas allí (ayuda de Componentes) o deje la especificación sin definir. El inventario (6.4) también usa estas listas de NPS y schedule para completar el diámetro y el espesor de cada elemento.

Pestaña Diseño de junta (obligatoria; cada campo se explica con más detalle en el capítulo 9):

Ventana Nuevo ramal, pestaña Diseño de junta123456789101112131415161718
N°Campo / elementoQué hace
1Título y ? (ayuda)Con esta pestaña activa, el ? abre este tema.
2Pestaña GeneralVuelve a los datos básicos.
3Pestaña Especificación de tuberíaDiámetro y espesor de la tubería del ramal.
4Pestaña Diseño de juntaPestaña activa (resaltada, con ícono de llama). Obligatoria: no se puede guardar el ramal sin completarla.
5Etiqueta de resumenMuestra el tipo elegido y, cuando se escribe, el número de pases (ej. V · 6). Permite ver el diseño sin abrir la pestaña.
6Franja informativaMensaje fijo: «Este es el diseño de la junta que se empleará mayormente en este ramal. La apropiada selección del tipo de junta, del número de pases y de los lados en que se soldará influirá en la preparación de la documentación necesaria para las inspecciones.» Recuerda que se registra una junta predominante por ramal.
7? de la franjaAbre el apartado 9.1 de la ayuda (qué es el diseño de junta y para qué sirve).
8Tipo de junta (*)Título de la lista; el asterisco indica que es obligatorio.
9Lista de tipos de juntaCatálogo de preparaciones de borde y uniones usadas en piping (catálogo del capítulo 9): recta, V, V con talón ancho, X, bisel simple, K, U, doble U, J, doble J, bisel compuesto, filete, enchufe, brida deslizante, brida loca, derivación apoyada, derivación insertada y olet. Al elegir uno se muestra su esquema (16). Por defecto — Sin definir —, que no permite guardar.
10Número de pases (*)Título del campo; obligatorio.
11Campo del número de pasesCantidad de pasadas de soldadura previstas (raíz, relleno y presentación), según el WPS; entre 1 y 99. Se habilita al elegir el tipo de junta. Define cuántos pases debe documentar el inspector (9.4).
12Ayuda del campoTexto gris: «Cantidad de pasadas previstas: raíz, relleno y presentación (vista), según el WPS. Entre 1 y 99.»
13Se puede soldar por (*) y ?Obligatorio. El ícono ? abre el apartado 9.5 (una cara o dos caras, con el detalle).
14Un lado / Ambos ladosUn lado (una cara): acceso solo por el exterior, lo habitual en tubería. Ambos lados (dos caras): se puede soldar y resanar por el reverso. Se habilitan al elegir el tipo de junta.
15Resumen de una y dos carasTexto gris: «Una cara (un lado): acceso solo por el exterior, lo habitual en tubería; la penetración depende del pase de raíz. Dos caras (ambos lados): se puede soldar y resanar la raíz por el reverso.» El detalle está en 9.5.
16Vista previa 200 × 200 pxEsquema del tipo elegido (ilustrativo, sin escala): en gris las piezas y en naranja el metal depositado. Si el tipo aún no tiene dibujo muestra «Sin imagen».
17GuardarValida los tres datos del diseño de junta: si falta alguno, abre esta pestaña y avisa que son obligatorios.
18CerrarCierra sin guardar.
Ejemplo. Ramal de 24" con soldaduras a tope y un solo acceso por el exterior: pestaña Diseño de junta → tipo En V (bisel en V), número de pases 6, se puede soldar por Un lado (una cara) → Guardar. En la lista de ramales aparece la columna «Diseño de junta» con el resumen En V (bisel en V) · 6 pases · Un lado (una cara). Los valores son orientativos: los definitivos son los del WPS. Si falta alguno de los tres datos, la ventana abre esta pestaña y avisa que son obligatorios.

6.3.2 Ventana Exportar libros

Se abre con el botón Exportar de la pestaña Libros y ramales. Genera un archivo con los libros de la orden actual para llevarlos a otra orden o empresa, o para respaldo.

Ventana Exportar libros1234567891011
N°ElementoQué hace
1Título y ? (ayuda)"Exportar libros". El ícono ? abre esta ayuda en este punto.
2Nota informativaResume el alcance: se exporta solo la información de esta orden y esta empresa, sin sus códigos (empresa, orden e identificadores internos), para poder usarla en otra empresa u orden. Incluye los tubos, juntas, estampes y reportes END de los libros elegidos; no incluye la auditoría.
3¿Qué exportar?Define el alcance (opciones 4 y 5).
4Todos los libros de esta ordenOpción por defecto. Exporta todas las líneas principales de la orden con todos sus ramales.
5Un libro (incluye sus ramales)Exporta un solo libro, con sus ramales y los ramales de estos. Al marcarla se habilita la lista (6).
6Seleccione el libroLista de las líneas principales de la orden. Está desactivada con la opción "Todos". Si elige "Un libro" y no selecciona ninguno, el sistema pide elegir uno.
7FormatoTipo de archivo que se genera (opciones 8 y 9).
8XMLOpción por defecto y la recomendada. Es el archivo que se puede importar en otra orden o empresa con el botón Importar (6.3.3). Disponible para todos los usuarios.
9SQLSolo disponible para algunos usuarios (ver recuadro). Genera un script para ejecutar directamente en la base de datos. Si su usuario no tiene permiso, esta opción no aparece en la ventana.
10ExportarGenera y descarga el archivo. Si la orden no tiene libros informa "No hay libros para exportar en esta orden."
11CerrarCierra la ventana sin generar nada (igual que la ×).
El formato SQL está restringido. Solo lo ven y pueden usarlo: los usuarios administradores, la cuenta de administración del sistema y el personal con el rol ncs_entwicker (desarrollador). A los demás no se les muestra la opción, y aunque se intente forzar, el sistema responde "El formato SQL solo está disponible para el rol desarrollador (o root)". Los demás usuarios deben usar XML + Importar.

Contenido del archivo (ambos formatos): libros y ramales con su vínculo a la Te de origen; tubos y accesorios instalados en esos libros (ID, colada, tipo, diámetro, espesor, revestimiento, longitud, y el tubo de origen si es un sobrante de corte); tramos con sus PK, coordenadas, uniones y fin de línea; juntas con WPS, fecha, Estado NDT, pases/estampes y referencias END; y curvados.

Nombre del archivo: libro_empresa{id}_orden{OT-año}_{fecha}.xml (o .sql).

Cómo se usa el SQL (solo usuarios autorizados):

  1. Abra el script y complete las tres variables del encabezado con los datos de la empresa y la orden destino: @company_id, @company_key y @ot_key.
  2. Ejecútelo en la base de datos destino. Corre dentro de una transacción (START TRANSACTION … COMMIT).
  3. Los tubos y las juntas que ya existan en la empresa destino se reutilizan; sus pases, reportes END y curvados se agregan.
El SQL no se valida al ejecutarlo: haga un respaldo antes y revise los valores de las variables. Para trasladar libros entre órdenes o empresas sin intervención técnica, use XML e Importar.
Ejemplo. Llevar el libro "Gasoducto Troncal 24" y su ramal a otra orden: abra la ventana → "Un libro" → elija "Gasoducto Troncal 24" → formato XML → Exportar. En la otra orden, use Importar con ese archivo.

6.3.3 Ventana Importar libros

Se abre con el botón Importar. Carga en la orden actual un archivo XML generado con Exportar (6.3.2). Solo acepta XML; el SQL no se importa desde aquí.

Ventana Importar libros123456
N°ElementoQué hace
1Título y ? (ayuda)"Importar libros". El ícono ? abre esta ayuda en este punto.
2Nota informativaLos libros se crean en la orden y empresa actuales. Si un tubo, accesorio o junta ya existe en la empresa se reutiliza (y se avisa). Si un tubo ya está instalado en otro libro, la importación se cancela sin cambios.
3Archivo XML generado por este módulo (*)Campo obligatorio: solo acepta un archivo .xml creado con Exportar (6.3.2).
4Examinar…Abre el selector de archivos del equipo. Junto al botón se muestra el nombre del archivo elegido, o "No se ha seleccionado ningún archivo".
5ImportarValida y carga el archivo. Al terminar muestra el resumen del resultado. Si no hay archivo, pide seleccionarlo.
6CerrarCierra la ventana sin importar (igual que la ×).
SituaciónQué hace el sistema
Tubo o accesorio con un ID que ya existe en la empresaSe reutiliza (no se duplica) y se lista en el aviso final.
Junta con un código que ya existeSe reutiliza; no se vuelven a cargar sus reportes END.
Elemento ya instalado en otro libroSe cancela la importación: "El elemento X ya está instalado en otro libro".
Elementos y juntas nuevosSe crean; los elementos quedan Instalado.
PKSe recalculan en todos los libros importados (5.3).

Al terminar muestra un resumen: libros, tramos, elementos nuevos y reutilizados, juntas nuevas y reutilizadas. La importación queda registrada en la auditoría (evento importar).

6.4 Pestaña Inventario (acopio)

BotónQué haceOpciones / observaciones
Agregar elementoRegistra un tubo o accesorio recibido.ID (único por empresa), N° de colada, tipo (Tubo, Te, Codo, Válvula), diámetro (pulg), espesor (mm), revestimiento (FBE, 3LPE…) y longitud de fábrica (m). Ver 6.4.1.
EditarModifica los datos del elemento.
BorrarElimina el elemento.No se puede si está instalado en un libro.

Estados: En Acopio → Curvado (si tiene reporte de curvado) → Instalado. Los sobrantes de un corte (ID-B) vuelven como "En Acopio".

6.4.1 Ventana Agregar elemento

Se abre con Agregar elemento. Con Editar es la misma ventana con los datos cargados. Todos los campos son obligatorios.

Ventana Agregar elemento12345678910
N°Campo / botónQué hace
1Título y ? (ayuda)"Agregar elemento" o el de edición. El ícono ? abre esta ayuda en este punto.
2ID Tubo/Accesorio (*)Código con que el elemento se identifica en obra (ej. TB-D001), hasta 50 caracteres. Debe ser único en la empresa. Es el que se busca al agregar un tramo. Se conserva además como ID de fábrica: si luego se corta el tubo, el instalado pasa a ID-A y el sobrante a ID-B (5.8).
3N° Colada (*)N° de colada del acero (trazabilidad de material), hasta 50 caracteres. Sin colada, Validar marca el tramo como error. Los sobrantes de un corte heredan la misma colada.
4Tipo (*)Tubo, Te, Codo o Valvula. Solo las Te permiten crear un ramal (5.9).
5Diámetro (pulg) (*)Diámetro nominal en pulgadas (ej. 24); mayor que 0, hasta 999.
6Espesor (mm) (*)Espesor de pared en milímetros (ej. 12.70); mayor que 0, hasta 999.
7Revestimiento (*)Tipo de recubrimiento (ej. FBE, 3LPE), hasta 50 caracteres.
8Longitud fábrica (m) (*)Largo original del elemento en metros (ej. 12.00); mayor que 0, hasta 9999. Es la longitud sugerida al instalarlo y el límite máximo al cortarlo (5.8). En una Te, su longitud pasante.
9GuardarValida (si el ID ya existe o falta un campo, muestra el error y no guarda), registra el elemento como En Acopio, cierra la ventana y actualiza la lista.
10CerrarCierra sin guardar (igual que la ×).
Diámetro, espesor y revestimiento aparecen como columnas ocultas en la pantalla del libro (menú Columnas, 4.2). El estado del elemento (En Acopio → Curvado → Instalado) lo gestiona el sistema, no se escribe aquí.

6.5 Pestaña Soldaduras y END

BotónQué haceOpciones / observaciones
END (lápiz)Abre la junta: edita código, WPS y fecha, y administra sus referencias a reportes END.Para agregar una referencia: N° de reporte, método (Rx, UT, AUT, VT…), fecha, resultado (Pendiente / Aprobado / Rechazado) y observaciones. El botón rojo borra una referencia.
BorrarElimina la junta.No se puede si algún tramo la usa.

Las juntas se crean al escribir su código en un tramo. El Estado NDT se actualiza con Consolidar END (dentro del libro).

6.6 Pestaña Auditoría

Lista cada alta, cambio y baja: N°, fecha, usuario, evento (created, updated, deleted, recalculo_pk, corte, ramal, consolidar_end, vaciar_libro, borrar_todo), tabla, registro, libro, valores antes y después, e IP. Se busca por usuario, evento o tabla.

6.7 Pantalla del libro (botones superiores)

Vea también el mapa visual de la pantalla.

BotónQué haceOpciones / observaciones
Agregar tramoInstala un tubo o accesorio de acopio al final del libro (o intercalado).Ver 6.8.
ValidarEjecuta la validación cruzada y muestra los hallazgos en un panel.Revisa continuidad de PK, topología de juntas, extremos abiertos, juntas compartidas por tramos no contiguos y colada informada. No modifica datos.
Recalcular PKRecalcula en cascada todos los PK del libro.Normalmente no hace falta (se recalcula solo al agregar, editar o borrar); sirve para reparar datos.
Consolidar ENDActualiza el Estado NDT de cada junta del libro desde sus referencias END.Rechazado si algún reporte lo es; Aprobado si hay reportes y ninguno está pendiente; si no, Pendiente.
ExcelDescarga el libro en .xlsx con dos hojas: LIBRO DE TUBOS y DOCUMENTACION Y GUIA.Incluye PK en formato K+MMM, juntas, WPS, estado NDT, curvado, coordenadas y observaciones.
Vaciar libroElimina todos los tramos del libro y de sus ramales; los tubos vuelven a acopio.Exige escribir VACIAR. Conserva la cabecera del libro y la auditoría. No se puede deshacer.
LibrosVuelve a la pantalla principal.

6.8 Formulario Agregar / Editar tramo

Ventana emergente que se abre con Agregar tramo (5.1) o con Editar en una fila (5.7). Tiene tres pestañas: Tramo, Unión anterior y Unión posterior. En todos los campos, el ícono ⓘ muestra una descripción al pasar el mouse. (*) = obligatorio.

6.8.1 Pestaña Tramo

La imagen es de un tramo en edición; al agregar, aparecen además Tubo / accesorio (*) y Posición (ver tabla bajo la imagen). Los números están junto al nombre de cada campo, sin cubrirlo.

Formulario Editar tramo123456789101112131415161718
N°Campo / botónQué hace
1Título y ? (ayuda)Muestra "Agregar tramo" o "Editar tramo N — ID". El ícono ? abre esta ayuda en este punto (sección 6.8).
2Pestaña TramoDatos del elemento instalado: longitud, posición, topografía y curvado. El PK se calcula solo. Es la pestaña que se abre primero.
3Pestaña Unión anteriorCómo se empalma el inicio de este tramo con el tramo anterior (ver 6.8.2). La etiqueta de color a su lado resume el estado: sin definir, el código de la junta o el tipo de empalme.
4Pestaña Unión posteriorCómo se empalma el final de este tramo con el siguiente (ver 6.8.2). Misma etiqueta resumen (ej. W-D001); también muestra Fin de línea si se marcó.
5Longitud (m)Largo real instalado en la zanja. Vacío = longitud post-corte (15) y, si no hay, la de fábrica. En una Te, la longitud pasante. Es obligatoria al editar. Define PK fin = PK inicio + longitud (capítulo 3).
6CosturaPosición de la costura longitudinal de fábrica como hora de reloj (ej. 12:00 = parte superior). Máx. 20 caracteres.
7Ecuación PK (m)Opcional. PK de diseño ("adelante") en metros (ej. 5200 = 5+200.00) que reemplaza al PK fin del tramo anterior; la cascada sigue desde ahí. Deje la memoria de cálculo en Observaciones (capítulo 7).
8NorteCoordenada UTM Norte (m) del inicio del tramo, para GIS. En una Te se copia al ramal (5.9).
9EsteCoordenada UTM Este (m) del inicio del tramo. En una Te se copia al ramal.
10CotaElevación en m.s.n.m. del inicio del tramo. En una Te se copia al ramal.
11Curvado en fríoDatos del Reporte Diario de Curvado. Déjelo en Recto si el tubo no fue curvado.
12TipoRecto (sin curvado), Sag (columpio, cóncava), Overbend (cresta, convexa), Sidebend (lateral) o Combinada (vertical y horizontal). Tipo y Grados van juntos: si completa uno, el otro es obligatorio.
13GradosÁngulo de curvatura en grados (ej. 10.50); mayor que 0 y hasta 99.99. Obligatorio si hay tipo de curva.
14FechaFecha del Reporte Diario de Curvado. Vacía = fecha de hoy.
15Post-corte (m)Longitud final si el bisel obligó a cortar el tubo al curvarlo. Si Longitud (5) está vacía, se usa como longitud instalada.
16ObservacionesTexto libre: cortes, desvíos, hallazgos de QA/QC y N° de reportes de campo (RDC-xxx / RDS-xxx). Se ve en la última columna de la tabla.
17GuardarValida los datos (si hay errores los muestra y no guarda). Al guardar: crea o actualiza el tramo, recalcula los PK (5.3), deja el tubo en Instalado, cierra la ventana y actualiza la tabla.
18CerrarCierra la ventana sin guardar. Equivale a la × de la esquina superior derecha.

Solo al agregar (no se ven al editar):

CampoQué hace
Tubo / accesorio (*)Obligatorio. Lista con buscador: escriba parte del ID o de la colada. Solo aparecen elementos En Acopio o Curvado (máx. 50), con el formato ID | tipo | colada | longitud. Va en la primera fila, a la izquierda de Longitud.
PosiciónVacío ("al final") = el tramo se agrega al final de la línea. Un número lo intercala en esa posición, desplaza los siguientes y recalcula los PK (5.3). Un número mayor que la cantidad de tramos equivale a agregar al final. Va a la derecha de Longitud.

6.8.2 Pestañas Unión anterior y Unión posterior

Las dos pestañas tienen los mismos campos; describen el empalme con el tramo contiguo. Unión anterior = entre el inicio de este tramo y el tramo anterior (aguas arriba). Unión posterior = entre el final de este tramo y el siguiente (aguas abajo).

Ejemplo con tipo "Junta soldada" (pestaña Unión anterior de un tramo en edición; la Unión posterior es igual):

Pestaña Unión anterior con junta soldada12345678910
N°ElementoQué significa
1Pestaña Unión anteriorPestaña activa (azul). Texto de ayuda: empalme entre el inicio de este tramo y el tramo anterior (aguas arriba).
2Etiqueta de estadoResume la unión sin abrir la pestaña. Aquí W-DERIV-01 = junta soldada con ese código. Si no hay unión dice sin definir; si es brida o acople, el tipo.
3Pestaña Unión posteriorMisma ventana para el extremo final. Su etiqueta (ej. W-DB01) muestra la junta de salida del tramo.
4Tipo de empalmeCon Junta soldada se muestran los campos 5 a 7 y el aviso 8. Con otro tipo se muestra, en su lugar, Descripción.
5Código de junta (*)Obligatorio con junta soldada. Es el N° de la soldadura (ej. W-DERIV-01); sugiere las existentes. Esta misma junta debe figurar como Unión posterior del tramo anterior, y viceversa.
6WPSProcedimiento de soldadura (ej. WPS-01). Se completa solo si la junta ya existe.
7Fecha de soldaduraFecha de ejecución según el Reporte Diario de Soldadura (selector dd/mm/aaaa). Se completa solo si la junta ya existe.
8Aviso de la juntaFranja informativa bajo los campos. Junta existente: muestra su WPS, fecha, Estado NDT (ej. Pendiente) y cantidad de Reportes END (6.5). Junta nueva: se creará al guardar si el código no existe.
9GuardarGuarda el tramo con sus dos uniones (se guardan juntas aunque solo haya editado una pestaña).
10CerrarCierra sin guardar.
Si cambia el código por uno existente, se cargan su WPS y fecha; si escribe uno nuevo, se crea la junta al guardar. Una junta une exactamente dos tramos consecutivos: si el código aparece en tramos no contiguos, Validar lo informa.

Ejemplo con tipo "Brida" (también válido para Acople mecánico y Otro):

Pestaña Unión anterior con brida123456
N°ElementoQué significa
1Etiqueta de estadoJunto al nombre de la pestaña muestra el tipo elegido (aquí Brida). Comparada con la del ejemplo anterior (código de junta), indica de un vistazo qué tipo de empalme tiene cada extremo.
2Tipo de empalmeTítulo del selector.
3Lista de tiposCon Brida, Acople mecánico u Otro desaparecen Código, WPS y Fecha y se muestra solo Descripción. No se crea ninguna junta soldada: el empalme no aparece en la pestaña Soldaduras y END (6.5) ni tiene Estado NDT.
4DescripciónIdentificación del empalme, hasta 255 caracteres (ej. Brida 24" clase 600, N° B-01). Es opcional con Brida y Acople mecánico, y obligatoria con Otro (en ese caso la etiqueta muestra (*)).
5GuardarGuarda el tramo con sus dos uniones.
6CerrarCierra sin guardar.
Regla de coincidencia: el tipo de la unión anterior de un tramo debe ser igual al de la unión posterior del tramo previo (Brida con Brida). Si no, Validar informa "union anterior (Brida) distinta de la union posterior del item previo". Al agregar un tramo con la unión anterior en Sin definir, hereda el tipo y la descripción de la unión posterior del tramo previo.

Descripción de todos los campos:

CampoQué hace
Tipo de empalmeOpciones: Sin definir, Junta soldada, Brida, Acople mecánico, Otro. Según la elección se muestran los campos siguientes. Sin definir en la anterior = en un tramo nuevo hereda la unión posterior del tramo previo; en la posterior = el extremo aún no está unido.
Código de junta (*)
solo Junta soldada
N° único de la soldadura (ej. W-D001, máx. 50 caracteres). Sugiere las juntas ya existentes. Debajo aparece un aviso: Junta existente (con su WPS, fecha, Estado NDT y cantidad de reportes END) o Junta nueva: se creará al guardar. Una junta une exactamente dos tramos contiguos.
WPS
solo Junta soldada
Procedimiento de soldadura calificado aplicado (Reporte Diario de Soldadura). Si la junta ya existe y el campo está vacío, se completa solo con el WPS registrado.
Fecha de soldadura
solo Junta soldada
Fecha de ejecución de la junta. Igual que WPS: se autocompleta si la junta ya existe.
Descripción
Brida, Acople, Otro
Identificación del empalme: N° de brida, tipo de acople, norma, etc. (máx. 255). Obligatoria si el tipo es Otro. Ej.: Brida 24" clase 600, N° B-01.

Solo en la pestaña Unión posterior, cuando el tipo es Sin definir, aparece el panel Extremo sin unión definida:

CampoQué hace
Es el fin de líneaMarque si este es el último tramo y no habrá más. Si no se marca, el extremo queda como frente abierto, a la espera del siguiente tramo. En la tabla se ve como FIN DE LÍNEA.
GPS Norte / Este / Cota del extremoCoordenadas del punto final del tramo, mientras no esté unido a otro elemento.
Al agregar el siguiente tramo, el extremo abierto del anterior se completa solo con la unión anterior del nuevo, y se borran la marca de fin de línea y el GPS del extremo. Un tramo no puede ser fin de línea si tiene una unión posterior definida.
Ejemplo. Tramo 1 (TB-D001): pestaña Unión posterior → tipo Junta soldada, código W-D001, WPS y fecha. La pestaña muestra la etiqueta W-D001. Luego se agrega el tramo 2 dejando su Unión anterior en Sin definir: hereda W-D001 automáticamente.

6.9 Botones de cada fila del libro

BotónQué haceOpciones / observaciones
Editar (lápiz)Modifica el tramo (el elemento no se puede cambiar).Recalcula los PK posteriores.
TijeraRegistra un corte en obra (niple).Pide la nueva longitud instalada (menor que la de fábrica). El instalado pasa a ID-A; el sobrante reingresa a acopio como ID-B con la misma colada.
Ramal (bifurcación)Solo en accesorios Te: crea el libro del ramal.Pide el nombre. El ramal arranca en 0+000.00, amarrado al centro de la Te, con la nota de Tie-in y las coordenadas. Si ya hay ramal, se muestra su nombre.
BorrarElimina el tramo.El elemento vuelve a acopio y los PK posteriores se recalculan. No se puede borrar una Te que originó un ramal.

Columnas ocultas por defecto: diámetro, espesor, revestimiento, WPS, coordenadas y costura (actívelas en el menú Columnas).

7. Cortes, niples, bifurcaciones y ecuación de PK

8. Auditoría

Fechas y hora: todas las fechas que muestra el módulo (auditoría, juntas, reportes END, reportes Word/PDF y el selector de rango de fechas) usan el formato de fecha y la zona horaria de la configuración general de su empresa. Los filtros por rango se interpretan como días completos de esa zona horaria. Los campos de calendario de los formularios (ej. fecha de soldadura) muestran la fecha según el idioma de su navegador, pero se guardan y se reportan con el formato de la empresa.

Cada alta, cambio y baja queda con usuario, fecha, IP y valores antes/después. Los recálculos, cortes, ramales, consolidaciones END y borrados masivos dejan un registro resumen.

9. Diseño de junta soldada: guía para el inspector

Este capítulo explica, para quien se inicia en la inspección de soldaduras, qué significa cada dato de la pestaña Diseño de junta del libro (6.3.1), de dónde sale y cómo se usa. Complementa al WPS: no lo reemplaza.

9.1 Qué es el diseño de junta y para qué sirve en el libro

El diseño de junta (en inglés joint design) es la forma en que se preparan y se enfrentan los bordes de las piezas antes de soldar: ángulo del bisel, altura del talón, separación entre piezas y acceso para soldar. Determina cuánto metal de aporte hace falta, cuántos pases se necesitan, si se puede inspeccionar la raíz y qué tan fácil es lograr una penetración completa.

En el libro de tubos se registra de forma obligatoria (tipo de junta, número de pases y lados) y por ramal, porque definen la documentación de inspección que se prepara; así el soldador y el inspector sepan cuál es la preparación prevista de las soldaduras de esa línea. En ASME Sección IX el diseño de junta es una de las variables del procedimiento de soldadura (QW-402, «Joints»): el diseño vigente es el que figura en el WPS aprobado; este dato del libro es una referencia de apoyo.

Límite del dato: el libro guarda un único diseño por libro (por ramal). Si en una misma línea hay uniones con preparaciones distintas (por ejemplo, tubo-tubo en V y derivaciones en bisel simple), registre aquí la predominante y deje las demás en las Observaciones del tramo o en el WPS.

9.2 Anatomía de una junta a tope

ElementoQué es
Bisel (bevel)Corte inclinado hecho al borde de la pieza. Se mide en grados respecto a la perpendicular de la superficie.
Ángulo incluidoÁngulo total que forman los dos biseles al enfrentar las piezas (en una V de 37,5° por lado, unos 75°).
Talón (root face, land)Parte recta que queda en la raíz, sin biselar. Evita perforar la pieza con el primer pase.
Apertura de raíz (root gap)Separación entre las dos piezas en la raíz. Permite que el primer pase penetre hasta el reverso.
RaízZona más cercana al reverso, donde se hace el primer pase (pase de raíz).
Refuerzo (reinforcement)Sobreespesor del metal depositado por encima de la superficie (visible en los esquemas como la «corona» naranja).

Valores de la norma. ASME B16.25 (preparación de extremos para soldadura a tope) fija, para paredes de hasta 22 mm, un bisel de 37,5° ± 2,5° y un talón de 1,6 mm ± 0,8 mm. La preparación en obra de las juntas a tope de tubería se rige por ASME B31.3 §328.4 (figura 328.4.2).

9.3 Catálogo de tipos de junta del libro

La lista desplegable Tipo de junta muestra estos diseños. Los esquemas son ilustrativos, sin escala: el metal depositado se ve en naranja y las piezas en gris. Los espesores y usos son orientativos; el WPS manda.

EsquemaTipo (código)DescripciónCuándo se usaLadosObservaciones
Recta (a tope, sin bisel)Recta (a tope, sin bisel)
I
Bordes rectos, sin preparación; solo se deja una apertura de raíz pequeña.Pared delgada (del orden de pocos milímetros) y procesos con buena penetración.Un lado o ambosNo requiere maquinado; la apertura de raíz debe controlarse con precisión.
En V (bisel en V)En V (bisel en V)
V
Cada borde lleva un bisel; juntos forman una «V». La preparación más común en tubería de proceso y de transporte.Hasta unos 22 mm de pared (ASME B16.25: bisel estándar de 37,5° ± 2,5° y talón de 1,6 mm ± 0,8 mm en ese rango).Un ladoPenetración completa con un buen pase de raíz; es la junta que usa el cálculo de metal de aporte del ejemplo 30 de Componentes.
En V con talón anchoEn V con talón ancho
V_TALON
Igual que la V pero con el talón (cara de raíz) más alto.Cuando se quiere reducir el riesgo de perforar la raíz o el volumen del bisel.Un ladoExige buen control de la apertura y de la penetración de raíz; se define en el WPS.
En X (doble V)En X (doble V)
X
Bisel en ambas caras; la sección queda con forma de «X». Reduce el volumen de soldadura frente a la V y equilibra el calor.Paredes gruesas con acceso por los dos lados.Ambos ladosRequiere resanar (back-gouging) la raíz desde el reverso antes del primer pase del segundo lado.
Bisel simple (medio V)Bisel simple (medio V)
BISEL
Solo uno de los dos bordes lleva bisel; el otro queda recto (a escuadra).Uniones en T y derivaciones donde una pieza llega perpendicular a la otra.Un ladoSe indica cuál es el borde biselado.
En K (doble bisel)En K (doble bisel)
K
Un borde recto y el otro con bisel por ambas caras, en forma de «K».Uniones en T de espesor grande con acceso por ambos lados.Ambos ladosEquivale a la X cuando uno de los bordes es perpendicular a la otra pieza.
En UEn U
U
El fondo del bisel es curvo (radio); los costados casi rectos.Paredes gruesas: menor volumen de metal de aporte que la V para el mismo espesor.Un ladoSe prepara por maquinado (más costosa que el bisel recto).
Doble UDoble U
U2
Dos preparaciones en U, una por cada cara.Paredes muy gruesas con acceso por ambos lados.Ambos ladosRequiere resane de raíz; el menor volumen de aporte de todas las geometrías a tope.
En JEn J
J
Un borde recto y el otro con una curva en la raíz, en forma de «J».Uniones en T y derivaciones de pared gruesa.Un ladoSe prepara por maquinado.
Doble JDoble J
J2
Dos preparaciones en J, una por cada cara.Uniones en T gruesas con acceso por ambos lados.Ambos ladosSe prepara por maquinado; requiere resane de raíz.
Bisel compuesto (pared gruesa)Bisel compuesto (pared gruesa)
COMPUESTO
Bisel con dos ángulos: más abierto en la parte superior y más cerrado cerca de la raíz.Paredes gruesas (en ASME B16.25, espesores mayores que 22 mm).Un ladoReduce el volumen de aporte frente a un bisel recto de 37,5°; los ángulos y alturas exactos están en la norma.
Filete (en T o esquina)Filete (en T o esquina)
FILETE
No hay bisel: el metal de aporte forma un triángulo entre las dos piezas. Se dimensiona por el cateto o la garganta.Soportes, refuerzos, uniones solapadas y accesorios sin penetración completa (ASME B31.3 §328.5).Un lado o ambosNo lleva talón ni apertura de raíz.
Enchufe (socket weld)Enchufe (socket weld)
SOCKET
El tubo se inserta en el enchufe del accesorio y se une con un filete en la boca. Se deja una pequeña separación antes de soldar (típicamente 1,6 mm, ver ASME B31.3 §328.5.2).Tubería de diámetro pequeño, alta presión (accesorios de ASME B16.11).Un ladoLa separación evita que el tubo quede apoyado en el fondo del enchufe al dilatar durante la soldadura.
Brida deslizante (filete doble)Brida deslizante (filete doble)
SLIPON
El tubo atraviesa la brida; se hacen dos filetes: uno exterior en el cubo y otro interior en la cara de la brida.Bridas deslizantes (slip-on) de ASME B16.5 (ASME B31.3 §328.5.2).Ambos ladosEl filete interior no es accesible al tubo ya montado: se hace antes del resto.
Sin imagenJunta con brida loca (lap joint, stub-end)
LAP
Un extremo de tubo con collarín (stub-end) soldado a tope; la brida es suelta y gira sobre el collarín.Líneas que se desmontan con frecuencia o de aleaciones especiales (titanio, Inconel, dúplex): el stub-end es de la aleación y la brida puede ser de acero al carbono.Un ladoLa soldadura es una junta a tope entre el tubo y el stub-end (se registra aquí su preparación). Ver 9.10.
Sin imagenDerivación apoyada (set-on)
DERIV_SOBRE
El tubo de la derivación se apoya sobre la superficie del cabezal; la unión es un filete o un bisel por el exterior.Derivaciones de tuberías (ASME B31.3 §328.5.4).Un ladoSin esquema todavía (aparece «Sin imagen»). El refuerzo se calcula aparte (ASME B31.3 §304.3).
Sin imagenDerivación insertada (set-in, penetración completa)
DERIV_INS
El tubo de la derivación entra en un agujero del cabezal y se suelda con penetración completa.Derivaciones con exigencias de resistencia o fatiga (ASME B31.3 §328.5.4).Un lado o ambosSin esquema todavía (aparece «Sin imagen»).
Sin imagenDerivación con olet (Weldolet / Sockolet, MSS SP-97)
OLET
Accesorio forjado integral que se suelda al cabezal por el exterior con soldadura de ranura y filete combinadas.Derivaciones de diámetro menor sin espacio o presupuesto para una Te; cuando el cabezal no permite soldar por el interior (9.9).Un ladoEl bisel de penetración varía con la curvatura del cabezal: exige validar las dimensiones. Esquema pendiente.
Cómo elegir (guía rápida). Pared delgada y poco acceso: recta. Tubería de proceso o transporte hasta unos 22 mm: en V. Pared gruesa con acceso por un solo lado: bisel compuesto o en U. Pared gruesa con acceso por los dos lados (por ejemplo, un cabezal grande o una pieza fabricada en taller): en X o doble U. Derivaciones y uniones en T: bisel simple, K, J, filete u olet. Diámetros pequeños y presión alta: enchufe (socket).

9.4 Número de pases

Un pase es una pasada de soldadura a lo largo de la junta. Una junta se completa con varios pases depositados en orden:

PaseFunción
Raíz (root pass)Primer pase: funde los dos talones y asegura la penetración hasta el reverso. Es el más crítico para la inspección (RT, UT).
Pase caliente (hot pass)Segundo pase, depositado sobre la raíz; la refunde y limpia (en muchos procedimientos se identifica por separado).
Relleno (fill)Los pases siguientes que llenan el bisel.
Presentación (cap, cover)Último pase; da la forma final y el refuerzo de la soldadura.

Qué se ingresa: el número previsto de pases (entre 1 y 99), según el WPS. Cómo se estima: aumenta con el espesor y con el ángulo del bisel, y depende del proceso (SMAW, GTAW, GMAW, FCAW, SAW) y del diámetro del electrodo; no existe una fórmula única: se toma del WPS o del PQR.

Ejemplo (ilustrativo). Tubo de 12,7 mm de pared en V: raíz (1) + relleno (2 o 3 pases) + presentación (1) → entre 4 y 5 pases. El mismo tubo de 25 mm, con más material que depositar, necesitará bastantes más (decenas de pases es normal en paredes muy gruesas).
Relación con el registro real. El número de pases del libro es una previsión. En la pestaña Soldaduras y END (6.5) cada junta registra sus pases reales, uno por uno, con su estampe (identificación del soldador) y el lado: la lista de pases acepta Raíz y los pases 1 a 10 por lado. En juntas con más de 11 pases por lado, los restantes no se pueden registrar individualmente; anótelo en el comentario de la junta.

9.5 Se puede soldar por un lado o por ambos lados (una cara o dos caras)

Resumen: una cara = se suelda solo desde el exterior; dos caras = se puede soldar por el frente y por el reverso (y resanar la raíz). El dato define qué ensayos y registros pide la documentación de inspección. En la ventana del ramal este resumen aparece bajo el campo y el ícono ? abre este apartado.

OpciónQué significaConsecuencias para el inspector
Un ladoEl acceso es solo por el exterior (caso habitual en tubería: no se puede entrar al interior). La penetración completa depende del pase de raíz.La raíz solo se ve desde dentro con medios especiales (boroscopio) o con ensayos volumétricos (RT/UT). Es importante controlar la apertura de raíz, el talón y la protección del reverso (gas de purga en acero inoxidable). Se puede usar un respaldo (anillo o platina) cuando la norma o el WPS lo permiten.
Ambos ladosSe tiene acceso por las dos caras (placas, cabezales y piezas fabricadas). Permite soldar un lado, resanar (back-gouging: eliminar por esmerilado o arco-aire la raíz desde el reverso hasta metal sano) y soldar el otro lado.Se verifica el resane (inspección visual y, si se pide, líquidos penetrantes o partículas magnéticas) antes de soldar el segundo lado. Los pases se registran con el lado 1 o 2 (6.5). El calor está mejor balanceado, lo que reduce la distorsión.

9.6 Cómo llenar la pestaña paso a paso

  1. Abra el libro con Nuevo ramal (o con el lápiz de un libro existente) y vaya a la pestaña Diseño de junta.
  2. En Tipo de junta elija la preparación del WPS de la línea. A la derecha verá el esquema. Si dice Sin imagen, el tipo existe pero no tiene dibujo todavía.
  3. Escriba el Número de pases previsto (según el WPS o el PQR). Es obligatorio.
  4. Elija Se puede soldar por: Un lado (una cara) o Ambos lados (dos caras). Es obligatorio; el ícono ? junto al campo abre el apartado 9.5.
  5. Pulse Guardar. En la lista de libros se agrega la columna Diseño de junta con el resumen (ej. «En V (bisel en V) · 6 pases · Un lado»).
Para modificarlo: abra el lápiz del ramal, cambie los valores y guarde. Los tres datos son obligatorios: si falta alguno, la ventana abre la pestaña Diseño de junta y no guarda hasta completarlos.

Orden de llenado: primero el Tipo de junta; con él elegido se habilitan Número de pases y Se puede soldar por.

9.7 Errores frecuentes

9.8 Normas y referencias

NormaQué aporta a este tema
ASME B31.3, §328.4 y figura 328.4.2Preparación de los extremos para soldadura a tope en tubería de proceso.
ASME B31.3, §328.5.2Soldaduras de filete y de enchufe (socket); detalles de bridas deslizantes.
ASME B31.3, §328.5.4 y §304.3Derivaciones soldadas (set-on, set-in) y su refuerzo.
ASME B16.25Preparación de extremos a soldar de accesorios y válvulas (bisel 37,5° ± 2,5°, talón 1,6 mm ± 0,8 mm; bisel compuesto en paredes gruesas).
ASME B16.11Accesorios forjados con enchufe y roscados (socket weld).
ASME BPVC Sección IX, QW-402 («Joints»)El diseño de junta como variable del WPS/PQR.
MSS SP-97Accesorios forjados de derivación integralmente reforzados (Weldolet, Sockolet y similares).
ISO 9692-1Preparación de bordes para soldadura por arco de aceros (formas V, X, U, bisel, etc. con sus dimensiones).

Para el detalle de las figuras y de las tolerancias consulte la edición vigente de cada norma: este manual no reproduce su contenido.

9.9 Derivaciones (ramales) y soldadura por el interior: NPS mínimo del cabezal

En la fabricación de ramales de piping (derivaciones fabricadas a partir de la intersección tubo con tubo) hay una pregunta práctica que condiciona el tipo de junta: ¿el soldador puede entrar al cabezal (pipe run o header) para soldar por el interior?

Como criterio de fabricación, el NPS mínimo del cabezal para poder soldar por el interior es, en general, NPS 24 (aproximadamente 600 mm). Este valor no sale de una fórmula de códigos como ASME B31.3 (que trata el refuerzo de la derivación en §304.3): lo fija la accesibilidad física y la ergonomía del soldador.

FactorExplicación
Espacio confinadoUn tubo de NPS 24 tiene un diámetro interior aproximado de 570 a 590 mm (según su schedule o espesor). Es el espacio mínimo medio para que un soldador, o el operador de un equipo automático de soldadura orbital o interna, pueda introducir el brazo, la antorcha o la cabeza y garantizar la visibilidad de la raíz, la eliminación de escoria y la integridad del cordón de sellado interno.

Tipos de junta de ramal relacionados (en la lista de tipos del libro: Derivación insertada y Derivación apoyada):

TipoDescripciónSoldadura
Stub-in (inserto) — «Derivación insertada»El tubo del ramal se introduce hasta la pared interior del cabezal.Se prefiere cuando se necesita soldar también por el interior (respaldo) para lograr una penetración completa y lisa que evite turbulencias o corrosión localizada en la raíz. Requiere cabezal con acceso interior (≈ NPS 24 o mayor).
Stub-on (montado) — «Derivación apoyada»El ramal descansa sobre la superficie exterior del cabezal.Se suelda enteramente por el exterior, por las limitaciones de diámetro del cabezal.

Alternativas cuando el cabezal es menor que NPS 24. Si el diseño exige una junta de ramal de penetración completa o de máxima confiabilidad pero el cabezal no admite soldar por dentro, se emplean estas prácticas:

  1. Soldadura desde el exterior con penetración completa. Se prepara una junta biselada con una apertura de raíz calculada y se usa un proceso de alta calidad para el pase de raíz, como TIG (GTAW), de modo que el cordón penetre de forma uniforme hasta el interior sin necesidad de entrar al tubo.
  2. Accesorios integrales de refuerzo (MSS SP-97). Se instalan componentes forjados, como Weldolet o Sockolet, que se sueldan al cabezal totalmente por el exterior con soldaduras de ranura y filete combinadas.
Ejemplo (ilustrativo). Cabezal de NPS 30 con ramal de NPS 12 y exigencia de penetración completa lisa: se puede elegir Derivación insertada con acceso por ambos lados. Si el cabezal es de NPS 12 con ramal de NPS 4, no se puede entrar: se registra Derivación apoyada con soldadura de raíz desde el exterior (un lado), o Derivación con olet.
Es un criterio práctico de accesibilidad: confirme siempre el límite con el procedimiento de soldadura (WPS) y con la especificación de la línea.

9.10 Comparación por tipo de unión: aplicación, restricciones, ventajas y riesgos

Resumen de ingeniería para decidir y para explicar a quien se inicia en el tema. Los usos y límites son criterios generales de la práctica de piping: la especificación de la línea y el código aplicable prevalecen.

Tipo de uniónAplicación típica y uso generalRestricciones principalesVentajas de ingenieríaDesventajas y riesgos
A tope (Butt weld, BW)Sistemas críticos, alta presión, temperaturas extremas, servicios cíclicos o fluidos corrosivos. Se emplea obligatoriamente en diámetros mayores o iguales que 2 in.Exige acceso perimetral completo, mecanizado preciso del bisel y control estricto de la alineación (Hi-Lo).• Máxima resistencia a la fatiga térmica y mecánica.
• Perfil interno continuo, sin turbulencia.
• Inspeccionable al 100 % por radiografía (RT) y ultrasonido (UT).
• Alto costo de preparación y de horas-hombre.
• La penetración de raíz exige gran destreza (con frecuencia se requiere el proceso TIG).
Enchufe (Socket weld, SW)Líneas de diámetro pequeño (hasta 2 in), purgas, instrumentación y fluidos no críticos a alta presión.Estrictamente prohibido en servicios donde el fluido provoque corrosión por hendidura (crevice corrosion) o erosión por partículas.• Elimina la necesidad de biselar los tubos.
• El accesorio guía y sostiene la alineación inicial.
• Ejecución rápida y económica.
• Obliga a dejar una separación (gap) en la raíz, de unos 1,5 a 1,6 mm, que crea una trampa de sólidos y un concentrador de esfuerzos.
• La raíz no se puede inspeccionar por radiografía.
Brida deslizante (Slip-on)Sistemas de baja o media severidad y presión: agua de refrigeración, aire comprimido.Limitada por los códigos ASME en condiciones de fatiga cíclica alta, temperaturas altas o manejo de gases inflamables o tóxicos.• Menor costo de material que la brida de cuello soldable (welding neck).
• Mayor tolerancia en la longitud de corte del tubo.
• Montaje inicial más simple.
• Estructuralmente más débil ante impacto y vibración.
• Mayor riesgo de distorsión térmica en la cara de la brida al depositar el filete interior.
Brida loca (Lap joint)Sistemas de desmontaje frecuente o tuberías de aleaciones especiales (titanio, Inconel, dúplex).La junta final puede carecer de rigidez ante vibraciones mecánicas severas y provocar fugas en el empaque.• Separa las metalurgias: se usa un stub-end costoso y una brida económica de acero al carbono.
• Alinea al instante los agujeros de los pernos.
• Conjunto más pesado en volumen.
• Añade la soldadura a tope obligatoria del stub-end antes de acoplar.
Derivación con oletPuntos donde se extrae flujo perpendicular desde un cabezal mayor y no hay espacio o presupuesto para una Te.El diseño del bisel de penetración varía según la curvatura; requiere validación dimensional precisa frente a la pared del cabezal.• Restituye de forma integral la resistencia mecánica perdida al perforar el tubo principal.
• Reduce el volumen de soldadura frente a un injerto stub-in directo a tubo.
• Soldadura geométricamente compleja (silla de montar).
• Alta contracción térmica local que puede ovalar el cabezal si no se controla el aporte térmico.

Relación con el libro: los tipos Recta, V, X, bisel, U, J… son preparaciones de una unión a tope; Enchufe, Brida deslizante, Junta con brida loca y Derivación con olet son uniones propias de ciertos componentes; las derivaciones fabricadas se registran como Derivación apoyada o insertada (9.9).

12. Escribir el libro de tubo en una hoja de Google Sheets (acceso remoto)

El botón Libro de tubo de la línea abre el listado de juntas con su tramo aguas arriba y aguas abajo. El botón de actualizar de ese panel escribe ese listado en una hoja de Google Sheets, sin abrir la hoja ni descargar archivos. La conexión usa una cuenta de servicio de Google y se configura una sola vez por línea en la pestaña Configuración.

12.1 Qué se necesita en Google

  1. En Google Cloud, en el proyecto elegido, active la API de Google Sheets.
  2. Cree una cuenta de servicio y, en su pestaña Claves, use Agregar clave → Crear clave nueva → JSON. El archivo descargado contiene "type": "service_account", client_email y private_key. (El archivo client_secret_*.json es un cliente OAuth y no sirve.)
  3. Abra la hoja de Google Sheets y compártala como Editor con el correo de la cuenta de servicio (…@…iam.gserviceaccount.com).

12.2 Configuración en el libro

CampoQué se escribe
Archivo JSONArrástrelo a la zona punteada o haga clic para elegirlo. Se guarda cifrado en el servidor (cifrado de Laravel) y no se puede volver a ver ni descargar. El botón Borrar clave lo elimina del sistema.
ID o URL de la hojaEl ID es el texto entre /d/ y /edit en la dirección de la hoja. También se puede pegar la URL completa.
Celda inicio de ítemsLa celda siguiente al encabezado de la tabla, donde se escribe el primer ítem, con el formato Pestaña!Celda, por ejemplo Hoja1!A5. Solo se escriben los ítems, nunca los encabezados.
Celda fechaCelda del encabezado, por ejemplo Hoja1!B2. En cada actualización se sobrescribe con la fecha y hora de esa actualización. Es opcional.
El nombre de la pestaña debe ser exactamente el de la hoja (por ejemplo Sheet1 si la hoja está en inglés). Si no existe, el mensaje de error lista las pestañas de la hoja. La configuración y la clave se guardan por empresa, orden de trabajo y línea.

12.3 Actualizar

Pulse el botón de actualizar de la barra del panel. Si falta la clave JSON o la hoja, aparece un mensaje de error y no se escribe nada. Los datos se escriben como texto (no se interpretan fórmulas). Si una actualización trae menos filas que la anterior, las filas sobrantes de la hoja no se borran.

12.4 Formato ITEM: actualizar un solo ítem

En el panel Libro de tubo, el botón de refrescar de cada fila actualiza en la hoja remota el bloque de celdas de ese ítem. La forma del bloque la define un Excel (.xlsx) que se elige en Configuración → Formato ITEM con su propio campo de arrastrar y soltar y se guarda junto con la hoja al pulsar Guardar hoja; puede cambiarse cuando el formato varía.

En el Excel del formatoQué hace al refrescar
Celda con ${nombre_columna}Se escribe el valor de esa columna del ítem. Los nombres son los de la consulta del libro de tubo (id_tubo_arriba, pk_inicio_arriba, n_junta…). Una celda puede mezclar texto y varias variables.
Celda con color de rellenoSe dibuja en la hoja remota (relleno y bordes). Las celdas combinadas del bloque también se combinan.
Celda en blanco, sin colorNo se agrega ni se modifica ningún valor.
Texto fijo sin ${}No se escribe: solo se actualizan las celdas con variables.
${sold_code_pk}Es obligatoria: marca el inicio del bloque. Se ubica en la columna A, en la fila fila de la celda inicio de ítems + (ítem + 1) + ítem × 3 + 1 de la pestaña configurada, y el resto del bloque se coloca relativo a ella. Por ejemplo, con inicio en Hoja1!A10, el ítem 1 queda en la fila 16 y el ítem 2 en la 20.