Skip to main content
POST
Validar CSV

Endpoint

Descripción

Content-Type: multipart/form-data. Respuesta: JSON con ok: true/false. HTTP 200 incluso si falla — revisar ok. Para mapeos con target === user_event, la API también valida cada fila de datos tras pasar cabeceras (mapeo, enums, identificadores requeridos) y falla el preflight con ok: false. Para mapeos con target === transaction, la API recorre las filas de datos (hasta 50.000) y devuelve warnings blandos: el preflight sigue respondiendo ok: true y la importación se permite. Los targets de entidades validan solo cabeceras.

Autenticación

Campos del formulario

Éxito — solo cabeceras (entity_*)

Éxito con avisos — transacciones

Los problemas de fila nunca bloquean la importación; se agrupan por problema, así cada entrada informa la primera fila afectada y cuántas filas lo comparten.
Códigos de aviso: INVALID_ENUM_VALUE, AMOUNT_UNPARSEABLE, TYPE_OTHER, MISSING_REQUIRED_AFTER_MAP, DATE_UNPARSEABLE, DATE_KIND_AMBIGUOUS, MASKED_CARD_UNPARSEABLE, SCIENTIFIC_NOTATION.

Éxito — eventos de usuario (todas las filas válidas)

Fallo de filas — eventos de usuario

Si una o más filas fallan validación de mapeo:
Usá este preflight antes de importar. Con batchErrorHandling: continue_collect_errors en Importar eventos, las filas inválidas se omiten y quedan en el CSV de fallos del job; con rollback_all, el import devuelve 400. Ver también: Importaciones masivas.