Para importar un catálogo CSV sin alterar su significado, valida identificadores, unidades, estados y relaciones antes de escribir en producción. Un archivo que se abre y procesa sin errores puede convertir una referencia en número, interpretar mal un decimal o borrar datos que debían conservarse. La aceptación técnica no demuestra corrección comercial.

La pregunta decisiva es qué entiende el sistema por cada columna y qué hará cuando un valor falte. Ese contrato debe quedar definido antes de cargar miles de filas. Una vista previa que solo cuenta registros no permite descubrir cambios de significado.

Define qué representa una fila

Una fila puede ser un producto, una variante, una tarifa o una combinación de producto y almacén. Si el sistema de origen y el destino utilizan entidades distintas, copiar campos con nombres parecidos puede producir duplicados o sobrescribir información que pertenece a otra relación.

Escribe la identidad de cada registro: qué combinación permite reconocerlo y actualizarlo. Conserva los identificadores como tales. Una referencia con ceros iniciales no debe perderlos por tratarse como número si forman parte de su identidad comercial.

Aclara también si el archivo contiene todo el catálogo o un conjunto de cambios. La ausencia de una referencia en un envío parcial no significa retirada. Un importador que deduce borrados sin conocer ese alcance puede eliminar productos válidos.

Formato válido y significado válido

La guía de validación de entradas de OWASP distingue validación sintáctica y semántica: comprobar formato y comprobar si el valor tiene sentido para la operación. También separa esas validaciones de otras defensas de seguridad. Aplicado al catálogo, pasar la primera no asegura la segunda.

Un precio puede ser numérico y corresponder a otra moneda. Una medida puede entrar como decimal y utilizar una unidad diferente. Una fecha puede ser válida y no representar el periodo que esperabas. La regla de negocio debe acompañar al tipo de dato.

No resuelvas ambigüedades con conversiones silenciosas. Si el separador decimal o la unidad no están definidos, rechaza o deja pendiente la fila con un mensaje claro. El equipo responsable debe confirmar la interpretación antes de convertirla en información pública.

Vacío, cero y conservar son decisiones diferentes

Define qué significa una celda vacía: dato no disponible, borrar el anterior o mantenerlo. Reserva una forma explícita para eliminar valores cuando la operación lo permita. Si vacío significa cosas distintas según la columna, debe quedar documentado y aparecer en la vista previa.

Propongo un contrato de importación con entidad, clave, campo, formato, unidad, estados admitidos y comportamiento ante ausencia. Añade responsable de cada significado y un ejemplo correcto junto a otro que debe rechazarse. Es la base para revisar el importador, no solo el archivo.

  • Identidad: referencia textual y reglas de actualización.
  • Magnitudes: unidad y precisión confirmadas por campo.
  • Oferta: moneda, impuestos y alcance cuando correspondan.
  • Estados: vocabulario permitido y efecto sobre publicación.
  • Relaciones: referencias que deben existir antes de importar.

Incluye las columnas desconocidas. Ignorarlas puede ocultar un cambio de esquema; aceptarlas sin uso puede hacer creer al operador que se han aplicado. Decide si detienen la importación o generan un aviso que exige revisión antes de continuar.

La vista previa debe mostrar diferencias

Prepara una simulación que separe altas, modificaciones, rechazos y posibles retiradas. Para cada modificación relevante, enseña valor anterior y propuesto con su unidad. Un total de «filas procesadas» no permite reconocer una alteración de alcance.

Usa una muestra que cubra casos difíciles: referencia con ceros, decimal, dato ausente, variante y relación inexistente. No elijas solo las primeras filas del archivo. Una muestra representativa comprueba reglas que pueden fallar aunque muchos registros sencillos entren correctamente.

Define cómo volver al estado anterior y verifica el mecanismo en un entorno controlado. Un archivo de exportación no demuestra recuperación por sí solo. La importación debe tener una identificación que permita revisar qué se aplicó y qué quedó pendiente.

Caso hipotético: una tarifa mezcla significados

Un distribuidor ficticio recibe un CSV de un proveedor. Su importador acepta todas las filas y anuncia éxito. Después descubre que una referencia perdió ceros iniciales y que una columna vacía borró una descripción que debía conservarse.

El equipo redefine la clave como texto y establece el significado de las celdas vacías. Prepara la simulación con diferencias visibles y revisa una muestra que incluye referencias especiales. La siguiente carga no se aprueba por el número de filas, sino por el cumplimiento del contrato.

El caso hipotético no acredita pérdidas ni mejoras operativas. Para evaluar el proceso, distingue aceptación del archivo, corrección de los cambios y publicación verificada. Una reducción de errores visibles puede deberse a rechazar más datos, por lo que también debe revisarse qué queda pendiente.

El contrato importa más cuando una IA prepara el archivo

Mi hipótesis es que la validación semántica ganará importancia si herramientas generativas ayudan a transformar catálogos. Un archivo puede tener un aspecto consistente y contener interpretaciones plausibles que nadie autorizó: unidades asumidas, atributos completados o estados traducidos de forma incorrecta.

La apoyarían discrepancias que el formato no detecta y que solo reconoce quien conoce el producto. La debilitaría un origen estructurado, estable y con correspondencias verificadas. No implica que deba evitarse toda automatización; exige conservar reglas y procedencia del cambio.

Importa decisiones confirmadas, no suposiciones

Elige un archivo pequeño que contenga los casos difíciles y acuerda qué significa cada columna. Comprueba diferencias antes de aplicar y verifica el catálogo publicado después. La confianza en una importación empieza cuando puedes explicar qué cambió, por qué y cómo deshacerlo.

Para completar esta decisión, consulta Cómo revisar automatizaciones cuando cambia el proceso comercial.