Estructura del Catálogo
Este catálogo estandariza la descripción del activo rodante ferroviario:
| Columna | Descripción | Lógica de Negocio |
|---|---|---|
| Clave | Código alfanumérico (ej. TC01) | Valor para atributo TipoCarro en XML |
| Tipo de carro | Descripción del vagón | Furgón, Góndola, Tolva, Tanque, Plataforma |
| Contenedor | Indicador 0/1 de capacidad para contenedores | Define si puede transportar contenedores intermodales |
¿Qué tipo de vagón uso?
En palabras simples: Este catálogo describe "qué tipo de vagón de tren" transporta tu mercancía. Es el equivalente ferroviario de c_ConfigAutotransporte para camiones.
La columna clave: "Contenedor" indica si el vagón puede llevar contenedores intermodales (los mismos que vienen del barco o camión). Si tu servicio es de contenedores, necesitas un vagón con Contenedor=1.
Dependencia con TransporteFerroviario
Uso obligatorio:
- Modalidad: Exclusivamente para transporte ferroviario
- Nodo: TransporteFerroviario/Carro
- Atributo: TipoCarro (mandatorio)
- Múltiples carros: Nodo ilimitado para trenes con varios vagones
Tipos de Vagones Principales
Carga General:
- Furgón: Vagón cerrado para carga protegida
- Boxcar: Similar a furgón, carga general cubierta
- Góndola: Vagón abierto para materiales a granel
- Plataforma: Superficie plana para carga pesada
Especializados:
- Tolva: Graneles sólidos con descarga por gravedad
- Tanque (Cisterna): Líquidos, gases, productos químicos
- Refrigerado: Productos perecederos con control temperatura
- Automotriz: Transporte de vehículos (porta autos)
Intermodales:
- Plataforma Intermodal: Diseñada para contenedores
- Well Car: Vagón rebajado para contenedores dobles
- Spine Car: Contenedores articulados
- Stack Car: Contenedores apilados
Especiales:
- Mantenimiento de vía: Equipos de construcción ferroviaria
- Locomotora: Unidades motrices (sin carga)
- Pasajeros: Coches de pasajeros (servicios especiales)
Coordinación con Contenedores
Indicador "Contenedor" crítico:
- Contenedor = 1: Carro APTO para contenedores intermodales
- Contenedor = 0: Carro NO diseñado para contenedores
- Validación cruzada: Con c_TipoDeServicio
- Nodo requerido: Si servicio es contenedores + carro apto
Casos Especiales
Trenes Mixtos
Para composiciones con múltiples tipos:
- Nodos múltiples: Un nodo Carro por cada vagón/grupo
- Tipos diferentes: Tolvas + Tanques en mismo tren
- Documentación: TipoCarro, MatriculaCarro, GuiaCarro individuales
- Peso: ToneladasNetasCarro por cada vagón
Transporte Intermodal
Para contenedores en tren:
- Plataforma intermodal: TipoCarro con Contenedor=1
- Nodo Contenedor: Obligatorio si TipoDeServicio indica contenedores
- Error CP192: Falta nodo Contenedor cuando servicio lo requiere
- Coordinación: Con transporte terrestre en terminales
Carga Automotriz
Para transporte de vehículos:
- Porta autos: Vagones especializados de 2-3 niveles
- Capacidad: Número específico de vehículos por vagón
- Sujeción: Sistemas de amarre especializados
- Terminales: Instalaciones especiales de carga/descarga
Productos Peligrosos
Para sustancias controladas:
- Tanques especializados: DOT, TC certificados
- Coordinación: Con c_MaterialPeligroso
- Rutas: Restricciones específicas por producto
- Señalización: Placards y etiquetas obligatorias
Graneles y Minerales
Para productos a granel:
- Tolvas: Descarga por gravedad (cereales, minerales)
- Góndolas: Carga abierta (chatarra, carbón)
- Capacidad: Toneladas específicas por tipo de vagón
- Descarga: Instalaciones especializadas en destino
Mantenimiento de Vía
Para equipos especiales:
- Maquinaria ferroviaria: Equipos de construcción/reparación
- Locomotoras solas: Traslado sin carga comercial
- Uso: Documentar aunque no transporten mercancía
- Vías generales: Requieren documentación si usan red pública
Diferencias con Autotransporte
Conceptos excluyentes:
- c_TipoCarro: Solo TransporteFerroviario (vagones)
- c_ConfigAutotransporte: Solo Autotransporte (camiones)
- No mezclar: Son modalidades completamente diferentes
- Validación: Error si se usan en modalidad incorrecta
Coordinación de Pesos
Para validación aritmética:
- ToneladasNetasCarro: Peso por vagón individual
- Suma total: Debe coincidir con PesoNetoTotal
- Error CP191/152: Discrepancias en suma de pesos
- Verificación: Antes del timbrado validar aritmética
Servicios Ferroviarios
Para diferentes tipos de operación:
- Carga general: Servicios regulares programados
- Unitarios: Trenes completos para un cliente
- Intermodal: Combinación con otros medios
- Especializado: Productos específicos (automotriz, químicos)
Errores Comunes de Validación
CP191: Falta ToneladasNetasCarro o Suma Incorrecta
"No existe el atributo 'Carro:ToneladasNetasCarro', está vacío, o la suma no corresponde."
🔴 Causa del Error: No declaraste el peso de cada vagón, o la suma de todos los ToneladasNetasCarro no cuadra con el PesoNetoTotal de las mercancías.
🛠️ Solución Manual:
- Verifica que cada nodo Carro tenga el atributo ToneladasNetasCarro
- Suma manualmente todos los ToneladasNetasCarro declarados
- Compara con el PesoNetoTotal en la sección de mercancías
- Corrige las discrepancias aritméticas antes de timbrar
CP192: Falta Nodo Contenedor en Servicio Intermodal
"No existe el nodo 'Carro:Contenedor' cuando el atributo 'TipoDeServicio' contiene valor '1' en la columna 'Contenedor'."
🔴 Causa del Error: Declaraste un servicio de contenedores pero no incluiste el nodo Contenedor obligatorio dentro del vagón.
🛠️ Solución Manual:
- Verifica tu TipoDeServicio — si indica servicio de contenedores
- Confirma que el TipoCarro elegido tenga Contenedor=1 (apto para intermodal)
- Agrega el nodo Contenedor con los datos del contenedor físico
- Si el vagón no es intermodal (Contenedor=0), cambia el TipoCarro o el TipoDeServicio
CP152: PesoNetoTotal No Coincide con Suma de Vagones
"El atributo 'PesoNetoTotal' no corresponde a la suma de los atributos 'ToneladasNetasCarro'."
🔴 Causa del Error: Error aritmético — la suma de las toneladas de cada vagón no cuadra con el total declarado en mercancías.
🛠️ Solución Manual: Verifica la aritmética. Suma cada ToneladasNetasCarro declarado y compara con PesoNetoTotal. Corrige el valor que esté mal antes de intentar timbrar nuevamente.
Error Genérico: Clave No Existe
"El valor registrado no existe en el catálogo."
🔴 Causa del Error: La clave de TipoCarro que enviaste no existe en la versión actual del catálogo SAT.
🛠️ Solución Manual: Descarga la versión más reciente del catálogo c_TipoCarro del portal del SAT y verifica que la clave exista. Puede haber cambiado o ser un error de captura.