Errores al importar un CSV de expediciones para el DeCA

Define el contrato del archivo antes de aceptar datos

Empieza por una plantilla versionada que indique nombre y orden de las columnas, separador, codificación, formato de fecha, signo decimal y campos obligatorios. El productor y el importador deben trabajar con la misma versión. Si una exportación del ERP cambia una cabecera o añade una columna, el sistema debe mostrar la diferencia y pedir un nuevo mapeo; adivinar por posición puede asignar un NIF al campo de peso sin que el archivo parezca roto.

RFC 4180 documenta convenciones comunes para CSV, pero es un documento informativo y no una garantía de que todos los programas produzcan el mismo dialecto. Registra si la primera fila contiene cabeceras, exige el mismo número de campos en cada registro y decide de forma explícita si se admiten columnas desconocidas. Conserva una muestra sintética aprobada para comparar futuras exportaciones.

Versión de plantilla y sistema que genera el archivo.
Codificación admitida, por ejemplo UTF-8 o Windows-1252 declarada.
Separador, carácter de comillas y tratamiento de líneas vacías.

Error 1: separadores, comillas y saltos de línea

En España es frecuente encontrar punto y coma porque la coma se utiliza como separador decimal, mientras otras herramientas exportan coma o tabulador. Detectar el separador contando caracteres en la primera línea es frágil: una dirección o descripción también puede contener comas. El importador debe aplicar el dialecto configurado y presentar un error comprensible cuando una fila produce más o menos campos que la cabecera.

Según las convenciones recogidas en RFC 4180, un campo con coma, comillas o salto de línea puede ir entre comillas dobles y una comilla interna se representa duplicándola. No dividas el archivo con una operación simple por comas. Usa un analizador CSV, limita el tamaño de cada celda y señala la fila y la columna donde el contenido queda sin cerrar. El usuario debe poder corregir el origen y repetir una previsualización antes de confirmar.

No mezclar coma y punto y coma dentro del mismo lote.
No eliminar comillas antes de interpretar el registro completo.
Rechazar registros con una cantidad de campos distinta de la esperada.

Error 2: columnas desplazadas, fechas y ceros iniciales

Una hoja de cálculo puede convertir 00123 en 123, interpretar una referencia como fecha o cambiar 1.250 entre mil doscientos cincuenta y uno con veinticinco. Trata teléfonos, códigos postales, matrículas, referencias y NIF como texto. Para cantidades define una unidad y un separador decimal; para fechas usa un formato inequívoco como AAAA-MM-DD y rechaza valores ambiguos como 03/04/26.

La codificación también altera datos válidos. Si aparecen caracteres de sustitución en razón social, localidad o mercancía, no los guardes como si fueran definitivos. Permite solo las codificaciones declaradas, muestra la interpretación antes del alta y conserva el valor original dentro de la revisión del lote. Normalizar espacios o mayúsculas puede ayudar a comparar, pero no debe modificar silenciosamente nombres, identificadores o descripciones legales.

Referencias e identificadores se importan como texto.
Peso y unidades viajan en campos separados y con reglas visibles.
Fechas ambiguas, imposibles o fuera del periodo esperado detienen la fila.

Error 3: contenido que una hoja de cálculo puede ejecutar

Las celdas que empiezan por igual, más, menos, arroba, tabulador o retorno pueden interpretarse como fórmulas al abrir un CSV en una hoja de cálculo. OWASP describe este riesgo como inyección CSV y advierte que un separador o una comilla introducidos dentro de un valor también pueden hacer que un carácter peligroso aparezca al comienzo de otra celda. Un archivo de expediciones no necesita fórmulas para transportar datos.

Para una importación automática, rechaza esas celdas y explica cuál debe corregirse en el sistema de origen. No confíes en anteponer un carácter como solución universal: OWASP señala que no existe una mitigación única segura para todos los programas que puedan consumir el archivo. Separa el CSV destinado a máquinas de cualquier informe que una persona vaya a editar y nunca reproduzcas contenido no confiable como HTML.

Bloquear indicadores de fórmula al inicio real de cada celda.
Validar de nuevo después de interpretar comillas y separadores.
Escapar la salida en informes y no insertar valores como código.

Error 4: el mapeo omite datos esenciales del transporte

Aceptar sintácticamente una fila no significa que permita preparar un DeCA. La Orden FOM/2861/2012 consolidada identifica datos esenciales del documento de control: cargador contractual y transportista efectivo, origen y destino, naturaleza y peso de la mercancía, fecha del transporte, matrículas y, cuando corresponda, referencia a la autorización especial. El mapeo debe distinguir estos conceptos de campos parecidos del ERP.

Por ejemplo, el cliente comercial puede no ser el cargador contractual y el proveedor habitual puede no ser el transportista efectivo de ese servicio. Define reglas por origen, exige los identificadores y direcciones aplicables y presenta la fila incompleta para revisión. Las responsabilidades sobre la exactitud de la información se reparten entre sujetos obligados; el software facilita controles, pero no determina por sí solo el rol jurídico de cada empresa.

Cargador contractual y transportista efectivo identificados por separado.
Lugar de origen y destino con datos suficientes para el documento.
Naturaleza, peso y unidad de la mercancía sin inferencias ocultas.

Error 5: duplicados, reimportaciones y lotes a medias

Una caída de red o una duda del usuario puede provocar que el mismo archivo se envíe dos veces. Define una clave externa estable por expedición y una clave de idempotencia por lote. Antes de crear nada, compara referencias repetidas dentro del archivo y contra documentos existentes. El resultado debe diferenciar una expedición nueva, una repetición idéntica y un registro que comparte referencia pero contiene cambios.

La confirmación debe ser atómica: o se aceptan todas las filas seleccionadas o ninguna queda creada cuando el lote exige integridad completa. Si el producto permite aceptación parcial, debe mostrarlo expresamente y entregar un informe de filas creadas y rechazadas. Nunca consumas dos veces el cupo por repetir la misma petición, y no marques una importación como completada si falla la generación posterior.

Vista previa con totales de nuevas, repetidas, modificadas y erróneas.
Clave estable que no dependa del número de fila ni del nombre del archivo.
Repetición idempotente que devuelve el resultado anterior.

Convierte solo las filas aceptadas en PDF y QR

El CSV es una fuente de datos, no el documento electrónico de control. La Resolución de 5 de junio de 2026 exige generar, antes del inicio efectivo del servicio, un PDF nativo digital a partir de datos estructurados. El fichero debe ser legible, no superar 5 MB e incorporar un código QR cuya URL permita a las personas habilitadas descargar directamente ese PDF durante el transporte.

Después de importar, genera un caso de prueba con datos sintéticos y compara campo a campo la fila, la pantalla y el PDF. Abre el documento con otro visor y escanea el QR desde un móvil sin sesión corporativa. Confirma que la URL usa HTTPS, entrega el PDF correcto y mantiene la vigencia necesaria. No presentes una fila aceptada, un mensaje enviado o un QR leído como prueba automática de entrega al conductor.

Estado separado para validado, importado, PDF generado y copia entregada.
Correspondencia entre referencia CSV, documento y URL única.
PDF nativo y legible con metadatos coherentes.

Cierra el piloto con criterios de aceptación verificables

Ensaya archivos válidos y casos que deban fallar: separador incorrecto, comillas abiertas, fecha ambigua, fórmula, identificador duplicado, caracteres dañados y ausencia de cada dato esencial. Comprueba que el sistema señala la ubicación del problema, no crea documentos parciales y permite repetir la operación corregida sin duplicar resultados. Guarda solo la evidencia necesaria y evita conservar copias del archivo más tiempo del definido.

Un piloto reduce errores, pero no garantiza que cualquier exportación futura sea compatible ni certifica por sí solo el cumplimiento de todos los transportes. Si el ERP tiene desarrollos propios, columnas variables o reglas de negocio modificadas, hay que revisar una muestra y cotizar el conector o mapeo. Los supuestos especiales, exenciones y mercancías reguladas requieren validación jurídica u operativa competente antes de emitir.

Matriz de casos válidos e inválidos firmada por el responsable del proceso.
Revisión de una muestra completa desde origen hasta PDF y QR.
Procedimiento para cambios de plantilla y rollback.

Preguntas frecuentes

¿Por qué un CSV que abre en Excel falla al importarlo?

Porque abrirlo visualmente no demuestra que use el separador, codificación, cabeceras y tipos acordados. La importación necesita un contrato de datos y valida cada registro completo.

¿Se pueden corregir automáticamente fechas o columnas ambiguas?

Conviene detener la fila y pedir una corrección o un mapeo explícito. Adivinar puede producir un documento coherente en apariencia pero asociado a datos de transporte incorrectos.

¿Qué hago si una celda contiene una fórmula?

En un archivo de intercambio automático debe rechazarse y corregirse en el origen. No existe una limpieza universal segura para todos los programas que pueden abrir un CSV.

¿Importar el CSV ya crea un DeCA válido?

No. Después hay que validar los datos legales aplicables, generar el PDF nativo con su QR, comprobar la URL y entregar la copia al conductor antes del servicio.

Fuentes oficiales y técnicas

Fuentes consultadas o verificadas el 22 de septiembre de 2026. Verifica siempre la versión consolidada y su aplicación a tu caso.