← 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. La cuenta viaja completa para el dueño de la importación, que la revisa y corrige antes de confirmar; la vista admin de otro usuario la enmascara. 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 | Datos de la fila interpretada. |
row_index | integer | Posición de la fila dentro del archivo original, empezando en `0`. Permite localizar la fila en el documento original. |
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` cuando 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` cuando `parsed_account` es nulo. |
parsed_bank_code | string | null | Código SPEI (5 dígitos) del banco resuelto, derivado de \ `parsed_account`. Es `null` cuando no pudo resolverse. |
parsed_bank_name | string | null | Nombre oficial del banco resuelto resuelto. Es `null` cuando no pudo resolverse. |
parsed_label | string | null | Etiqueta/alias extraída del archivo (o asignada automáticamente). `null` cuando 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. Las series de 13 a 19 dígitos que no son una CLABE (18 dígitos) aparecen enmascaradas (`••••` y los últimos cuatro), igual que un número de celular de 10 dígitos cuando lo precede una etiqueta como «cuenta» o «celular», para evitar exposición de números de tarjeta en los cuerpos 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}