Editar una fila del preview

PATCH https://api.veriko.mx/v1/beneficiaries/imports/{id}/rows/{row_id}

Audiencia: public
Autenticación: API key
Permiso: beneficiaries:create

Persiste un override del usuario sobre una fila del preview antes de confirmar la importación. Acepta envoltorio JSON:API o un objeto plano. Todos los atributos son opcionales; solo se sobreescriben los presentes. Cinco campos editables: parsed_account, parsed_label, parsed_account_type, parsed_bank_code, parsed_bank_name. Tras persistir el override el servidor re-procesa la fila (re-deriva banco a partir del prefijo CLABE / BIN nuevos) para que los contadores del job y la columna Banco del preview queden sincronizados sin esperar al commit. Solo válido cuando el job está en estado preview_ready — en otros estados devuelve 422 job_not_editable.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id` *	path	`integer`	obligatorio	ID numérico del job de importación.
`row_id` *	path	`integer`	obligatorio	ID numérico de la fila dentro del job.

Parámetros
Parámetro	Tipo	Obligatorio	Descripción
`parsed_account`	string (patrón, ?–32)	opcional	Número de cuenta corregido por el usuario. Acepta hasta 32 caracteres de dígitos, espacios, guiones y espacios no rompibles (NBSP). El `RowProcessor` re-normaliza al re-procesar. p. ej. `012180004412345678`
`parsed_label`	string (?–100)	opcional	Etiqueta corregida. Saneada antes de almacenar (se aplica un escape anti formula-injection sobre el primer carácter si es uno de `=+-@\t\r`). p. ej. `Mamá`
`parsed_account_type`	string (enumeración)	opcional	Tipo de cuenta corregido. Si el cliente envía un valor fuera del enum, el servidor responde `422 invalid_account_type`. p. ej. `clabe`
`parsed_bank_code`	string (patrón)	opcional	Código Banxico SPEI corregido (4–5 dígitos). Útil para cuentas tipo `phone` que necesitan reasignación de banco. Para CLABE/card el RowProcessor lo sobrescribe en su re-derivación. p. ej. `40012`
`parsed_bank_name`	string (?–50)	opcional	Nombre del banco corregido. El RowProcessor puede sobrescribirlo durante la re-derivación. p. ej. `BBVA MEXICO`

Petición

cURLPython•JavaScript•PHP•

curl -X PATCH 'https://api.veriko.mx/v1/beneficiaries/imports/{id}/rows/{row_id}' \
  -H 'Authorization: Bearer mxcep_••••' \
  -H 'Content-Type: application/json' \
  -d '{
    "parsed_account": "0121-8000-4412-3456-78"
  }'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200** `PatchBeneficiaryImportRowResponse` — Fila actualizada con el override aplicado y re-procesada.
Campo	Tipo	Descripción
`type`	`string`	Tipo del recurso JSON:API (siempre `beneficiary_import_row`).
`id`	`string`	ID numérico de la fila expresado como string (formato JSON:API).
`attributes`	`object`	Campos de la fila parseada.
`row_index`	`integer`	Posición 0-based de la fila en el archivo original. Permite al usuario localizar la fila en el documento fuente.
`status`	`string`	Bucket de clasificación: `valid` — lista para commit; `correctable` — corregida automáticamente, confirmable; `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` anulable	Número de cuenta normalizado extraído del archivo. El propietario del job puede ver y editar este valor en la vista de preview; `null` si no fue posible extraer una cuenta.
`parsed_account_type`	`string \| null` anulable	Tipo de cuenta detectado. `null` si `parsed_account` es nulo.
`parsed_bank_code`	`string \| null` anulable	Código Banxico de 5 dígitos del banco receptor derivado de la cuenta parseada. `null` si no pudo resolverse.
`parsed_bank_name`	`string \| null` anulable	Nombre del banco receptor resuelto. `null` si no pudo resolverse.
`parsed_label`	`string \| null` anulable	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`	Overrides manuales del usuario enviados via `PATCH /v1/beneficiaries/imports/{id}/rows/{rowId}`. Tienen precedencia sobre los valores parseados en el commit.
`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` anulable	ID del registro de beneficiario creado tras el commit. `null` hasta que el job completó y esta fila fue persistida.

**Códigos de respuesta** `PATCH /v1/beneficiaries/imports/{id}/rows/{row_id}`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Fila actualizada con el override aplicado y re-procesada.	`PatchBeneficiaryImportRowResponse`
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
403	`4xx`	Permisos insuficientes	`ErrorResponse`
404	`4xx`	El recurso no existe o no es visible para el llamador	`Error`
422	`4xx`	Falló la validación o el job no es editable. Códigos: `invalid_account` (pattern violation), `invalid_account_type`, `invalid_bank_code`, `no_valid_fields`, `job_not_editable`.	`ErrorResponse`

**Errores de `PATCH /v1/beneficiaries/imports/{id}/rows/{row_id}`**
Código	Clave	Detalle
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b9`
403	`forbidden`	You do not have permission to access this resource. Envelope meta.request_id `d5e6f7a8b9c0`
422	`invalid_account_type`	parsed_account_type must be clabe, card, or phone. Envelope meta.request_id `e3f4a5b6c7d8`
422	`job_not_editable`	Job is not in preview_ready state. Envelope meta.request_id `d2e3f4a5b6c7`