SifenConsultarDE

Descripción

Consulta en SIFEN el estado de un Documento Electrónico a partir de su CDC (siConsDE), el Código de Control de 44 dígitos que la DNIT asigna a cada comprobante. Es útil para verificar si un DE fue aprobado, para reconciliar el estado después de un timeout en la emisión síncrona, o para validar un comprobante recibido de un tercero.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial de SIFEN
cdc	text	No	CDC del DE, 44 dígitos. Si se deja vacío se toma de los datos de entrada

Credenciales

Este módulo requiere una credencial de tipo sifen (certificado .p12, RUC y ambiente). Ver el detalle de campos en SifenEmitirDE.

Salida

{
  "success": true,
  "cdc": "01800123456001001000001234567890123456789012",
  "codigo": "0422",
  "mensaje": "Consulta CDC exitosa",
  "encontrado": true,
  "detalle": { "estado": "Aprobado", "fechaProceso": "2026-08-05T10:15:00" }
}

Ejemplo de Uso

{
  "credentials_id": "cred-sifen-prod",
  "cdc": "01800123456001001000001234567890123456789012"
}

Notas

• El CDC debe tener exactamente 44 dígitos; si no cumple ese formato el nodo rechaza la consulta antes de contactar a SIFEN
• No requiere firma digital, solo la credencial (certificado y ambiente) para autenticar la conexión SOAP
• Si encontrado es false, el CDC no existe en SIFEN para el ambiente consultado (test/prod son bases distintas)

Nodos Relacionados

• SifenEmitirDE - Emitir el DE que luego se consulta
• SifenCancelarDE - Cancelar un DE ya aprobado
• SifenKuDE - Generar el KuDE (PDF/QR) del DE