← Volver al índice de esquemas
BeneficiaryImportRow
Fila extraída de un archivo de importación de beneficiarios, con su grupo de clasificación y los campos parseados. Los números de tarjeta (PANs) aparecen enmascarados; las CLABEs se muestran en claro al dueño de la importación. Envuelta bajo `{ type, id, attributes }` siguiendo el formato JSON:API.
ExtiendeJsonApiResourceBase
Propiedades
| Campo | Tipo | Descripción |
|---|---|---|
type | string | Tipo del recurso JSON:API (siempre `beneficiary_import_row`). |
id | string | Identificador numérico de la fila (expresado como string). |
attributes | object | Campos de la fila analizada. |
row_index | integer | Posición (desde el 0) de la fila en el archivo original. Permite al usuario localizar la fila en el documento fuente. |
status | string | Grupo de clasificación — `valid`: Lista para confirmación; `correctable`: Corregida automáticamente; `fatal`: Error no corregible, se omite; `duplicate_account`: Cuenta ya registrada (se reactiva si estaba archivada); `duplicate_alias`: Alias duplicado, se persiste con sufijo. |
parsed_account | string | null | Número de cuenta extraído del archivo (normalizado). El propietario de la importación puede ver y editar este valor en la vista de vista previa; `null` si no fue posible extraer una cuenta. |
parsed_account_type | string | null | Tipo de cuenta detectado. Los tipos son `clabe`, `card` y `phone`. Además de `null` si `parsed_account` es nulo. |
parsed_bank_code | string | null | Código SPEI (5 dígitos) del banco resuelto, derivado de \ `parsed_account`. Es `null` si no pudo resolverse. |
parsed_bank_name | string | null | Nombre oficial del banco resuelto resuelto. Es `null` si no pudo resolverse. |
parsed_label | string | null | Etiqueta/alias extraída del archivo (o asignada automáticamente). `null` si no fue posible extraer una etiqueta y no se asignó automáticamente. |
error_codes | array | Códigos de error estables de la fila (p.ej. `clabe_checksum_failed`, `alias_missing`). Vacío para filas `valid`. |
corrections_applied | object | Auto-correcciones que el sistema aplicó a esta fila (p.ej. `{ "alias_auto_assigned": "Proveedor 001" }`). Vacío si no hubo correcciones. |
user_overrides | object | Correcciones manuales del usuario enviadas mediante `PATCH /v1/beneficiaries/imports/{id}/rows/{rowId}`. Tienen precedencia sobre los valores parseados en la confirmación. |
raw_preview | object | Fragmento del archivo original para diagnóstico. Los dígitos de 6 o más caracteres consecutivos aparecen enmascarados (`••••`) para evitar exposición de PANs en payloads de depuración. |
created_beneficiary_id | integer | null | Identificador numérico del beneficiario creado tras la confirmación. `null` hasta que la importación completó y esta fila fue persistida. |
Usado en operaciones
GET /v1/beneficiaries/imports/{id}/previewPATCH /v1/beneficiaries/imports/{id}/rows/{row_id}