Validar CSV con un esquema de columnas y detectar errores

Este validador compara la cabecera con las columnas exactas que usted espera y revisa cada fila mediante reglas explícitas para texto, números, enteros, booleanos y fechas ISO. En lugar de detenerse ante la primera celda incorrecta, devuelve una lista completa de infracciones con números de fila y nombres de columna. Puede ejecutarlo gratis en el navegador o usar la API por $0.002 por solicitud dentro de un flujo automatizado.

Defina el contrato antes de revisar el archivo

Describa cada columna esperada mediante tres propiedades: su nombre exacto, su tipo y si es obligatoria. El orden importa porque CSV representa datos posicionales; una cabecera nombre,id no puede intercambiarse con id,nombre de forma segura, aunque contenga los mismos nombres. Por eso, el validador compara la cabecera completa con el esquema antes de examinar las filas. Una columna ausente, adicional, renombrada, duplicada o reordenada provoca un error de entrada, no un informe engañoso. Se admiten los tipos string, number, integer, boolean y date. Los números aceptan notación decimal y científica; los enteros deben ser números enteros seguros; los booleanos aceptan true o false sin distinguir mayúsculas; y las fechas usan YYYY-MM-DD con comprobación del calendario. Un texto admite cualquier valor no vacío, mientras que required determina por separado si se permite una celda vacía. Así, un entero opcional puede quedar vacío, pero, si aparece, debe seguir siendo entero.

Interprete correctamente las infracciones

El resultado comienza con el indicador valid y con recuentos de filas, columnas e infracciones. Cuando valid es false, el arreglo violations identifica cada problema mediante número de fila, nombre de columna, código estable y mensaje legible. La numeración sigue el propio CSV: la fila 1 es la cabecera y el primer registro ocupa la fila 2. Así, usted puede abrir el archivo original y acudir directamente al punto señalado. Una infracción required indica que una celda obligatoria está vacía. Una infracción type señala que un valor presente no satisface el tipo declarado. Las filas con más o menos campos reciben column_count bajo la columna especial _row, ya que el fallo estructural no puede atribuirse con fiabilidad a una sola celda. El analizador entiende comas entre comillas, comillas escapadas, saltos de línea internos y archivos CRLF; por tanto, la puntuación válida dentro de un campo citado no desplaza las columnas posteriores ni genera avisos falsos.

Sitúe la validación en el límite del flujo

Valide el archivo lo más cerca posible de su entrada al sistema. Puede rechazar la carga de un socio antes de que llegue a la base de datos, comprobar una exportación programada antes de ejecutar cálculos posteriores o mostrar todas las celdas corregibles desde un importador. Como el algoritmo es determinista y no utiliza la red, el mismo CSV y el mismo esquema siempre producen el mismo informe. Esto permite usar la salida tanto en controles automáticos como en tareas de limpieza asistida. Trate una cabecera incorrecta de manera distinta a las infracciones de filas: la primera indica que el archivo no corresponde al conjunto de datos esperado; las segundas indican que existen registros reconocibles que deben corregirse. El validador solo informa: nunca edita, convierte, recorta ni sustituye valores. Así evita alterar silenciosamente identificadores, ceros iniciales o texto escrito por personas. Si necesita normalización, realícela como un paso independiente y vuelva a validar después contra el contrato real del destino.