Payload principal de la respuesta. La forma varía según el endpoint (objeto, array, o envelope JSON:API con type, id, attributes).

Tipo del recurso JSON:API (siempre beneficiary_import).

Identificador numérico del trabajo de importación (expresado como string).

Campos de la importación.

Estado del trabajo de importación — pending: Subido y en espera de parseo; parsing: En proceso de extracción de filas; preview_ready: Listo para revisión del usuario; committing: Persistiendo filas confirmadas; completed: Importación completada; failed: Fallo no recuperable (ver error_code); cancelled: Cancelado por el usuario.

Formato del archivo subido. Aceptados: csv, xls, xlsx, txt o pdf.

Modo de parseo — template: Formato de columnas fijo (plantilla descargable); free: Formato libre, el sistema deduce la estructura.

Total de filas extraídas del archivo (solo disponible una vez que el estado es preview_ready o posterior).

Conteo de filas sin errores, listas para confirmación de persistencia.

Filas con correcciones automáticas aplicadas. Se persisten salvo que el usuario las rechace.

Filas con errores no corregibles automáticamente. No se persisten y se omiten de la confirmación.

Suma de filas duplicate_account y duplicate_alias. Las filas con duplicate_account se omiten de la confirmación salvo que la cuenta esté archivada (en cuyo caso se reactiva); las duplicate_alias se persisten con sufijo de alias.

Filas efectivamente persistidas en la lista de beneficiarios (solo disponible una vez que el estado es completed).

Filas no persistidas (fatales o duplicate_account sin reactivación posible).

true si el motor de IA (LLM) se utilizó durante el parseo para resolver filas ambiguas en modo libre.

Código estable del error cuando status=failed (p.ej. file_corrupt, plan_cap_exceeded). null en estados no fallidos.

Mensaje diagnóstico legible cuando status=failed. Los números de tarjeta (PANs) aparecen enmascarados en este campo.

Timestamp ISO 8601 en UTC con sufijo Z explícito. Ejemplo: "2026-05-01T05:14:38Z". Cada campo *_at, *_end, *_start, *_date de la API usa esta forma. El descriptor compañero en meta.datetime permite afirmar el contrato en tiempo de ejecución sin volver a leer este spec. El new Date(value) nativo del navegador, el datetime.fromisoformat (≥3.11) de Python y el time.Parse(time.RFC3339) de Go parsean este formato directamente.

Timestamp (ISO 8601 UTC) de finalización del parseo. null hasta que el parseo completa.

Timestamp (ISO 8601 UTC) del inicio de la confirmación. null hasta que la confirmación comienza.

Timestamp (ISO 8601 UTC) de finalización de la importación. null mientras la importación no ha completado.

Metadatos de la respuesta, incluyendo versión de la API, prefijo de ruta, identificador único de la petición y marca temporal del servidor en UTC.

Versión de la API que procesó la petición.

Versión del prefijo de ruta de la API (ej. v1).

Identificador único de la petición (hex).

Descriptor compañero presente en el bloque meta de cada respuesta (y en el meta del cuerpo de los webhooks salientes). Permite a los clientes afirmar el contrato de zona horaria sin releer el spec.

Siempre UTC — la zona canónica para cada campo datetime del cuerpo.

Siempre ISO 8601 — sufijo Z explícito en cada datetime.

Enlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada.