Consultar Estado de un Documento
Cómo verificar si un documento fue aprobado o rechazado por SIFEN usando el CDC, con la estrategia de polling recomendada.
Guardá el CDC que recibiste al emitir y consultalo con la misma clave o con otra del mismo contribuyente y ambiente:
curl "https://api.sifende.com.py/api/v1/documento-electronico/status/$CDC" \
-H "Authorization: Bearer $SIFENDE_API_KEY"Respuesta
{
"cdc": "01800123451001001000000122026042710000000006",
"estado": "APROBADO",
"ambiente": "DEV",
"iTiDe": 1,
"numeroDocumento": 1,
"fechaCreacion": "2026-04-27T10:30:00",
"protocoloAutorizacion": "01202604150000123456",
"mensajeRechazo": null
}| Campo | Tipo | Descripción |
|---|---|---|
cdc | string | Identificador de 44 dígitos del documento |
estado | string | Estado de procesamiento |
ambiente | string | Ambiente en que se emitió el documento: DEV, PROD o SANDBOX. No cambia |
iTiDe | integer | Tipo de documento: 1 para FE, 5 para NCE, 6 para NDE y 7 para NRE |
numeroDocumento | integer | Número correlativo del documento |
fechaCreacion | datetime | Fecha y hora de creación, sin zona horaria |
protocoloAutorizacion | string | null | Protocolo de SIFEN en DEV/PROD; en SANDBOX, SBX- seguido del CDC |
mensajeRechazo | string | null | Rechazos u observaciones, en formato [código] mensaje; varias entradas se separan por | |
El número con formato 001-001-0000001 se obtiene de numeroFormateado en la respuesta de emisión.
En SANDBOX, la consulta puede pasar de PENDIENTE a APROBADO sin envío a SIFEN. El protocolo es SBX- seguido del CDC y no tiene validez fiscal. Los estados de envío y respuestas de SIFEN de esta tabla corresponden a DEV y PROD.
Qué hacer con cada estado
| Estado | Qué significa | Qué hacer |
|---|---|---|
PENDIENTE | Sifende recibió el documento y está preparando su envío | Seguí consultando |
EN_LOTE | En proceso de envío o a la espera del resultado de SIFEN | Seguí consultando |
APROBADO | SIFEN aceptó el documento | Detené las consultas; guardá el protocolo |
APROBADO_OBSERVACION | SIFEN aceptó el documento con observaciones | Detené las consultas y revisá mensajeRechazo; no lo reemitas |
RECHAZADO | SIFEN rechazó el documento | Detené las consultas y corregí el motivo antes de emitir uno nuevo |
CANCELADO | Se confirmó la cancelación de un documento aprobado | Detené las consultas |
ERROR | El envío falló de forma definitiva | Detené las consultas y revisá el panel; no lo reemitas |
Si después de varias horas sigue en EN_LOTE, puede pertenecer a un lote Fallido. Revisá Historial de Lotes en el detalle del documento y, si el lote está Fallido, seguí la guía de reintento. Conservá el mismo CDC.
En ERROR, el documento no se reintenta solo. Pedí el reintento a soporte o seguí la guía para reintentar el lote. Al reintentarlo vuelve a EN_LOTE y podés retomar las consultas con el mismo CDC.
Automatizar la consulta
Consultá cada 5 segundos durante un máximo de 5 minutos. Si sigue en proceso, guardá el CDC y retomá después. No reemitas por haber agotado el tiempo de espera.
La guía de Polling de resultados incluye un ejemplo completo en TypeScript. También podés recibir webhooks.
Rechazos y observaciones
mensajeRechazo contiene el código y el mensaje de SIFEN. En un documento RECHAZADO, corregí la causa y emití uno nuevo. Si está APROBADO_OBSERVACION, guardá la observación: el documento ya quedó aceptado y no hay que reemitirlo.