Estructura del Catálogo
Este catálogo controla la estructura del XML ferroviario mediante bandera lógica:
| Columna | Descripción | Lógica de Negocio |
|---|---|---|
| Clave | Código del servicio (TS01, TS02, TS03) | Valor para atributo TipoDeServicio |
| Descripción | Modalidad del servicio ferroviario | Carro Entero, Intermodal, Unitario |
| Contenedor | Bandera crítica 0/1 | 1=Obliga nodo Contenedor, 0=Omitir contenedor |
¿Qué determina el tipo de servicio?
En palabras simples: Este catálogo describe CÓMO viaja tu carga en el tren — ¿en vagón completo? ¿en contenedor intermodal? ¿en tren dedicado?
La columna clave: "Contenedor" (0 o 1) determina si DEBES o NO DEBES agregar el nodo Contenedor en tu XML. Inconsistencia = rechazo.
Dependencia con TransporteFerroviario
Uso obligatorio:
- Modalidad: Exclusivamente para transporte ferroviario
- Nodo: TransporteFerroviario
- Atributo: TipoDeServicio (mandatorio)
- Control estructural: Determina validaciones del XML
Tipos de Servicios Ferroviarios
Servicios sin Contenedores (Contenedor = 0):
- Carro Entero: Mercancía suelta o paletizada en vagón
- Servicio Unitario: Tren completo para un cliente
- Graneles: Productos a granel en tolvas/góndolas
- Líquidos: Tanques cisternas especializados
Servicios con Contenedores (Contenedor = 1):
- Intermodal: Contenedores que cambian de modalidad
- Piggyback: Trailer completo sobre vagón
- Contenedores marítimos: En plataformas ferroviarias
- COFC/TOFC: Container/Trailer on Flat Car
Control de Validación Crítico
Bandera "Contenedor" determina estructura:
- Contenedor = 1: OBLIGATORIO nodo Carro:Contenedor
- Contenedor = 0: PROHIBIDO nodo Contenedor
- Error CP192: Discrepancia entre servicio y estructura
- Validación automática: PAC rechaza si no coincide
Casos Especiales
Servicio Intermodal
Para contenedores que cambian de modalidad:
- Obligatorio: Nodo Contenedor con detalles completos
- Información requerida: Tipo, peso, sellos del contenedor
- Coordinación: Con c_TipoCarro (plataformas)
- Terminales: Instalaciones especializadas de transferencia
Servicio de Carro Entero
Para mercancía directa en vagón:
- Prohibido: Nodo Contenedor en el XML
- Carga: Directamente en furgón, tolva, góndola
- Embalaje: c_TipoEmbalaje para mercancías
- Paletización: Carga organizada pero sin contenedor
Trenes Unitarios
Para servicios dedicados:
- Cliente único: Tren completo para una empresa
- Productos específicos: Graneles, químicos, automotriz
- Rutas directas: Origen-destino sin cambios
- Eficiencia: Mayor control y menor manipulación
Transporte de Automóviles
Para vehículos en tren:
- Vagones especializados: Porta autos de 2-3 niveles
- Sin contenedores: Vehículos directos en vagón
- Contenedor = 0: No usar nodo Contenedor
- Terminales: Instalaciones automotrices especializadas
Productos Químicos y Peligrosos
Para sustancias controladas:
- Cisternas: Vagones tanque especializados
- Trenes unitarios: Generalmente servicio dedicado
- Coordinación: Con c_MaterialPeligroso
- Contenedor = 0: Producto directo en cisterna
Graneles Agrícolas y Mineros
Para productos a granel:
- Tolvas: Descarga por gravedad
- Góndolas: Materiales como carbón, mineral
- Sin contenedores: Carga directa en vagón
- Terminales: Instalaciones de carga/descarga especializada
Diferencia con Tipo de Carro
Conceptos complementarios:
- c_TipoDeServicio: Modalidad comercial/logística del servicio
- c_TipoCarro: Vehículo físico específico (furgón, tolva)
- Ambos requeridos: En nodo TransporteFerroviario
- Control diferente: TipoDeServicio controla contenedores
Coordinación Intermodal
Para servicios combinados:
- Contenedores marítimos: Del puerto al tren
- Terminales FFCC: Instalaciones de transferencia
- Documentación: Continuidad en diferentes modalidades
- Trazabilidad: Seguimiento completo puerta a puerta
Hidrocarburos y Petrolíferos
Para productos energéticos:
- Trenes unitarios: Generalmente TS03 o similar
- Cisternas especializadas: DOT certificadas
- Complementos adicionales: Hidrocarburos si aplica
- Rutas controladas: Autoridades especializadas
Validación Antes del Timbrado
Verificaciones obligatorias:
- TipoDeServicio seleccionado: Corresponde a operación real
- Columna Contenedor: Verificar valor 0 o 1
- Estructura XML: Incluir/omitir nodo Contenedor según corresponde
- Coherencia: TipoCarro compatible con TipoDeServicio
Errores Comunes de Validación
CP192: Inconsistencia Contenedor vs Tipo de Servicio
"Cuando el valor registrado en el atributo Mercancias:TransporteFerroviario:TipoDeServicio del catálogo catCartaPorte:c_TipoDeServicio, contenga en la columna "Contenedor" el valor "1", este nodo debe existir, en caso contrario se debe omitir."
🔴 Causa del Error: Hay inconsistencia entre el tipo de servicio y la presencia/ausencia del nodo Contenedor.
🛠️ Solución Manual:
- Si seleccionaste servicio Intermodal (Contenedor=1): DEBES agregar nodo TransporteFerroviario:Carro:Contenedor con información completa
- Si seleccionaste Carro Entero (Contenedor=0): NO agregues nodo Contenedor, solo información del carro (furgón, tolva, etc.)