← Back to schema index

`ValidationImportRow`

Parsed row from a validation import batch. Represents the state of an individual validation within the batch, from parsing through the Banxico response.

ExtendsJsonApiResourceBase

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}/preview
PATCH /v1/validations/imports/{id}/rows/{row_id}