Ir al contenido

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).

  • 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).
  1. Pide tu API key (sk_test_… para habilitación) y regístrala como Authorization: Bearer. Ver Autenticación.
  2. Registra el facturador, su software DIAN, sus rangos y su certificado. Ver Set de pruebas.
  3. Emite: POST /v1/invoices con el JSON de la factura. Ver Emitir documentos.
  4. 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.