docuar · API de documentos electrónicos DIAN
docuar emite documentos electrónicos ante la DIAN (Anexo Técnico 1.9) a partir de JSON. La API genera el XML UBL 2.1, calcula el CUFE/CUDE/CUDS/CUNE, firma con el certificado del facturador (XAdES-EPES), lo envía al web service de la DIAN, procesa su respuesta y genera la representación gráfica (PDF con QR).
Cómo se organiza
Sección titulada «Cómo se organiza»- Cuenta: tú (el ERP o la software house que integra la API). Compras bolsas de documentos.
- Facturador: cada NIT que emite a través de tu cuenta, con su software DIAN, sus rangos de numeración y su certificado de firma. Una cuenta puede tener muchos.
- API keys: de cuenta (operan sobre cualquier facturador con el header
X-Tenant-Id) o restringidas a un facturador (para entregárselas a tu cliente final).
El primer documento
Sección titulada «El primer documento»- Pide tu API key (
sk_test_…para habilitación) y regístrala comoAuthorization: Bearer. Ver Autenticación. - Registra el facturador, su software DIAN, sus rangos y su certificado. Ver Set de pruebas.
- Emite:
POST /v1/invoicescon el JSON de la factura. Ver Emitir documentos. - Consulta el estado, el XML y el PDF. Ver Consultar documentos.
La Referencia de la API (en la barra lateral) lista cada ruta con sus campos, sus respuestas y sus errores. Se genera del mismo código que valida las peticiones: siempre está al día.