API: consultar estado de un documento por CDC

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

Retorna el estado de procesamiento de un documento electrónico en SIFEN.

Autenticación

Authorization: Bearer {api-key} — requerido

Path parameters

Parámetro	Tipo	Descripción
`cdc`	`string`	CDC de 44 caracteres del documento

Respuesta exitosa

Status: 200 OK

{
  "cdc": "01800123451001001000000122026042710000000006",
  "estado": "APROBADO",
  "fechaEmision": "2026-04-15T10:30:00",
  "tipoDocumento": "FACTURA_ELECTRONICA",
  "numeroDocumento": "001-001-0000001",
  "mensajeRechazo": null
}

Estados posibles

Estado	Descripción
`PENDIENTE`	Recibido, aún no incluido en un lote
`EN_LOTE`	Incluido en un lote, esperando ser transmitido a SIFEN
`ENVIADO`	Transmitido a SIFEN, esperando el resultado del lote
`APROBADO`	Aprobado por SIFEN — documento válido
`APROBADO_OBSERVACION`	Aprobado y registrado por SIFEN, con observaciones: ver `mensajeRechazo`
`RECHAZADO`	Rechazado por SIFEN — ver `mensajeRechazo`
`ERROR`	Falla técnica de procesamiento; Sifende reintenta solo
`CANCELADO`	Cancelado tras aprobación
`DESCONOCIDO`	El lote agotó reintentos sin respuesta concluyente de SIFEN

Es la lista completa: se corresponde uno a uno con el enum EstadoDocumento del backend. Ver Ciclo de Vida para el detalle de cada uno.

Si el estado es RECHAZADO o APROBADO_OBSERVACION, el detalle está en mensajeRechazo, con el formato [código] mensaje (varias entradas separadas por |). En APROBADO_OBSERVACION el documento sí quedó registrado: no lo reemitas. Durante el onboarding, casi todos los rechazos son datos que no coinciden con el registro de SET: revisá Rechazos comunes de SIFEN — sobre todo 1101 — timbrado inválido y actividad económica incorrecta.

Errores

Status	Tipo	Descripción
403	`document-archived`	El período de acceso del plan actual finalizó
404	`documento-electronico-not-found`	CDC no encontrado o documento cuya conservación física venció

Un documento archivado responde el mismo Problem Detail document-archived que KuDE y cancelación. No se entrega su estado mientras permanezca fuera del período de acceso.

Ejemplo

curl https://api.sifende.com.py/api/v1/documento-electronico/status/01800123451001001000000122026042710000000006 \
  -H "Authorization: Bearer $SIFENDE_API_KEY"

Consultar Estado