Consultar Estado
GET /api/v1/documento-electronico/status/:cdc — consultá el estado de procesamiento de un documento electrónico por CDC.
GET /api/v1/documento-electronico/status/:cdc
Consultá el documento con su CDC de 44 dígitos y una API key del mismo contribuyente y ambiente.
curl "https://api.sifende.com.py/api/v1/documento-electronico/status/$CDC" \
-H "Authorization: Bearer $SIFENDE_API_KEY"Respuesta exitosa
Status: 200 OK
{
"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 | |
numeroDocumento es un número. El valor con formato 001-001-0000001 está en numeroFormateado, que devuelve 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.
Estados posibles
| 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 |
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.
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.
Errores
| Status | Tipo | Qué significa |
|---|---|---|
| 401 | — | API key ausente o inválida |
| 403 | document-archived | Terminó el período de acceso del plan |
| 404 | documento-electronico-not-found | El documento no está disponible para esa clave |
Para automatizar la espera, consultá Polling de resultados.
Emitir Documento Electrónico
POST /api/v1/documento-electronico — emite cualquier tipo de documento electrónico (FE, AFE, NCE, NDE, NRE) y retorna una respuesta con el CDC y URLs de seguimiento.
Descargar KuDE
GET /api/v1/documento-electronico/:cdc/kude — descargá el KuDE (comprobante) en PDF o seguí la preparación asincrónica cuando todavía no está disponible.