https://api.veriko.mx/v1/validations/imports/{id}/preview Filas parseadas del lote
Lista todas las filas extraídas del archivo subido, con sus campos parseados, el bucket asignado y los códigos de error encontrados. Filtrable por uno o varios buckets vía buckets[]. La respuesta NO está paginada — la lista se devuelve completa (acotada por total_rows del job). Endpoint cookie-only: rechaza llamadas con API key (401).
| Parámetro | Ubicación | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
id * | path | integer | obligatorio | ID numérico del job de importación. |
buckets[] | query | array<string> | opcional | Filtra por uno o varios buckets. Si se omite o todos los valores son inválidos, devuelve todas las filas del job. |
curl -X GET 'https://api.veriko.mx/v1/validations/imports/{id}/preview' \
-H 'Authorization: Bearer mxcep_••••'
Ejemplo en Python — próximamente.
Ejemplo en JavaScript — próximamente.
Ejemplo en PHP — próximamente.
| Campo | Tipo | Descripción |
|---|---|---|
type | string | Tipo de recurso JSON:API (siempre `validation_import_row`). |
id | string | ID numérico de la fila como string (convención JSON:API). |
attributes | object | Atributos de la fila parseada. |
row_index | integer | Índice 0-based de la fila dentro del archivo original. |
status | string | Estado en el ciclo de vida de la fila: `pending_ocr` = esperando OCR; `valid` = datos completos listos para commit; `correctable` = datos incompletos que el usuario puede editar; `fatal` = datos inválidos no corregibles; `duplicate` = duplicada dentro del lote; `queued` = despachada al stream tras commit; `processing` = en procesamiento activo; `validated_valid` / `validated_not_found` / `validated_invalid` / `validated_cep_unavailable` / `validated_error` = resultado final de Banxico; `skipped` = omitida; `cancelled` = cancelada por el usuario. |
parsed_clave_rastreo | string | null anulable | Clave de rastreo SPEI extraída del archivo. null si no se pudo extraer. |
parsed_referencia_numerica | string | null anulable | Referencia numérica del pago extraída del archivo. `null` si no se pudo extraer. |
parsed_fecha | string | null anulable | Fecha de la transacción en formato `YYYY-MM-DD` (normalizada durante el parseo). `null` si no se pudo extraer. |
parsed_monto | number | null anulable (> 0) | Monto de la transacción en pesos MXN. `null` si no se pudo extraer. |
parsed_cuenta_beneficiaria | string | null anulable | Cuenta del beneficiario extraída: CLABE de 18 dígitos, número de tarjeta de débito, o número de celular de 10 dígitos (DiMo). `null` si no se pudo extraer. |
parsed_emisor | string | null anulable | Código SPEI de 4-5 dígitos del banco emisor, resuelto a partir de la cuenta o nombre del banco. `null` si no se pudo resolver. |
parsed_receptor | string | null anulable | Código SPEI de 4-5 dígitos del banco receptor, resuelto a partir de la cuenta o nombre. `null` si no se pudo resolver. |
error_codes | array | null anulable | Códigos de error de parseo local (ej. `clabe_checksum_failed`, `fecha_missing`). null si la fila no tiene errores. |
corrections_applied | array | null anulable | Avisos de correcciones aplicadas durante la normalización (ej. banco receptor inferido desde prefijo CLABE). null si no hubo correcciones. |
user_overrides | object | null anulable | Campos sobreescritos por el usuario en el preview (vía PATCH). Los valores aquí tienen precedencia sobre los campos parseados en el commit. null si no hay sobreescrituras. |
validation_id | string | null anulable | UUID de la validación creada en la tabla `validations` tras el commit. `null` antes del commit o si la fila fue omitida. |
| Código | Clase | Descripción | Cuerpo |
|---|---|---|---|
| 200 | 2xx | Filas del preview con metadata de totales y job. | Sin cuerpo |
| 401 | 4xx | Sin sesión activa O llamada con API key (cookie-only). | ErrorResponse |
| 404 | 4xx | Job no encontrado o no pertenece al usuario (`not_found`). | ErrorResponse |
| Código | Clave | Detalle |
|---|