Consultar el estado de una importación

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).

Datos del trabajo de importación.

Cupo de beneficiarios activos del plan y ocupación actual de la cuenta autenticada.

Tope de beneficiarios activos. -1 significa sin tope.

Cantidad de beneficiarios activos guardados, independientemente del filtro de archivados.

Cantidad de lugares necesarios para crear o reactivar cuentas del trabajo de importación.

true cuando el trabajo de importación necesita lugares nuevos y supera el cupo disponible.

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, json o pdf.

Modo de lectura del archivo — template: Respeta los encabezados canónicos; free: Formato libre, el sistema deduce la estructura.

Cantidad de filas extraídas del archivo. Sólo disponible cuando el estado es preview_ready o posterior.

Cantidad de filas sin errores, listas para la confirmación.

Cantidad de filas con errores que admiten corrección. Se persisten salvo que el usuario las rechace.

Cantidad de filas que no pueden procesarse con sus datos actuales. No se persisten y se omiten de la confirmación.

Cantidad de filas detectadas como duplicadas dentro del trabajo. Las de duplicate_account se omiten de la confirmación, salvo que la cuenta esté archivada, en cuyo caso se reactiva; las de duplicate_alias se persisten con un sufijo en el alias.

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

Cantidad de filas omitidas durante la ejecución del trabajo. Son las fatales y las duplicate_account sin reactivación posible.

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

Código estable del fallo del trabajo. null cuando no terminó en failed. Por ejemplo, file_corrupt o empty_file.

Resumen legible del fallo del trabajo. null cuando no terminó en failed. Los números de tarjeta aparecen enmascarados.

Timestamp ISO 8601 en UTC con sufijo Z explícito; por ejemplo, "2026-05-01T05:14:38Z". Los campos *_at, *_end, *_start y *_date adoptan esta forma. meta.datetime describe el mismo contrato en la respuesta.

Fecha y hora del fin de la lectura del archivo, en ISO 8601 UTC. null mientras no haya terminado.

Fecha y hora del inicio de la confirmación, en ISO 8601 UTC. null mientras no se haya confirmado.

Fecha y hora de la finalización, en ISO 8601 UTC. null mientras no haya terminado.

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.