ValidationImportRow
Parsed row from a validation import batch. Represents the state of an individual validation within the batch, from parsing through the Banxico response.
Properties
| Field | Type | Description |
|---|---|---|
type | string | JSON:API resource type (always `validation_import_row`). |
id | string | Numeric row ID as a string (JSON:API convention). |
attributes | object | Parsed row attributes. |
row_index | integer | 0-based index of the row within the original file. |
status | string | Row lifecycle state: `pending_ocr` = awaiting OCR; `valid` = complete data ready to commit; `correctable` = incomplete data the user can edit; `fatal` = invalid data that cannot be corrected; `duplicate` = duplicated within the batch; `queued` = dispatched to stream after commit; `processing` = actively being processed; `validated_valid` / `validated_not_found` / `validated_invalid` / `validated_cep_unavailable` / `validated_error` = final Banxico result; `skipped` = skipped; `cancelled` = cancelled by the user. |
parsed_clave_rastreo | string | null | SPEI tracking key extracted from the file. null if it could not be extracted. |
parsed_referencia_numerica | string | null | Numeric payment reference extracted from the file. `null` if it could not be extracted. |
parsed_fecha | string | null | Transaction date in `YYYY-MM-DD` format (normalized during parsing). `null` if it could not be extracted. |
parsed_monto | number | null | Transaction amount in MXN pesos. `null` if it could not be extracted. |
parsed_cuenta_beneficiaria | string | null | Beneficiary account extracted: 18-digit CLABE, debit card number, or 10-digit mobile number (DiMo). `null` if it could not be extracted. |
parsed_emisor | string | null | 4-5 digit SPEI code of the issuing bank, resolved from the account or bank name. `null` if it could not be resolved. |
parsed_receptor | string | null | 4-5 digit SPEI code of the receiving bank, resolved from the account or bank name. `null` if it could not be resolved. |
error_codes | array | null | Local parse error codes (e.g. `clabe_checksum_failed`, `fecha_missing`). null if the row has no errors. |
corrections_applied | array | null | Warnings for corrections applied during normalization (e.g. receiving bank inferred from CLABE prefix). null if no corrections were applied. |
user_overrides | object | null | Fields overridden by the user in the preview (via PATCH). Values here take precedence over parsed fields at commit time. null if no overrides. |
validation_id | string | null | UUID of the validation record created in the `validations` table after commit. `null` before commit or if the row was skipped. |
Used in operations
GET /v1/validations/imports/{id}/previewPATCH /v1/validations/imports/{id}/rows/{row_id}