Confirmar la importación masiva

POST https://api.veriko.mx/v1/beneficiaries/imports/{id}/commit

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

Confirma el job de importación y dispara la persistencia de filas en GET /v1/beneficiaries. La operación es asíncrona: el endpoint devuelve 202 y el job pasa a committing mientras el worker procesa las filas. Sondea GET /v1/beneficiaries/imports/{id} hasta completed o failed. Reglas del commit:

Filas valid y correctable se persisten (con sufijo de alias si hubo colisión de alias).
Filas fatal y duplicate_account se omiten. - Cuentas previamente archivadas con el mismo número se reactivan en lugar de duplicarse.

El cap del plan (beneficiaries_max) está fijo en -1 (ilimitado) hasta que la columna correspondiente se agregue al esquema de planes — en esa versión se aplicará el check con código plan_cap_exceeded.

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

Petición

cURLPython•JavaScript•PHP•

curl -X POST 'https://api.veriko.mx/v1/beneficiaries/imports/{id}/commit' \
  -H 'Authorization: Bearer mxcep_••••' \
  -H 'Content-Type: application/json'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 202** `CommitBeneficiaryImportResponse` — Commit encolado al worker. El job pasa a `committing`.
Campo	Tipo	Descripción
`type` *	`string`	Tipo del recurso JSON:API.
`id` *	`string`	ID numérico del job expresado como string.
`attributes` *	`object`	Atributos del job devueltos tras el commit (estado de transición).
`status` *	`string`	Nuevo estado tras encolar el commit.

**Códigos de respuesta** `POST /v1/beneficiaries/imports/{id}/commit`
Código	Clase	Descripción	Cuerpo
202	`2xx`	Commit encolado al worker. El job pasa a `committing`.	`CommitBeneficiaryImportResponse`
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`	Pre-condición de commit no cumplida. Códigos posibles: `job_not_committable` (estado != preview_ready), `plan_cap_exceeded` (cuando el cap esté activo) o el genérico `commit_failed` fallback.	`ErrorResponse`

**Errores de `POST /v1/beneficiaries/imports/{id}/commit`**
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	`job_not_committable`	Commit not allowed. Envelope meta.request_id `a5b6c7d8e9f0`