Cuatro documentos
Factura de venta, nota crédito, nota débito, documento soporte y documento equivalente POS. Cada uno con su familia de numeración y su código de seguridad.
API de facturación electrónica
Factura electrónica, documento soporte y documento equivalente POS ante
la DIAN. Tú mandas un JSON; nosotros numeramos, firmamos, validamos y
entregamos.
Qué resuelve
Sección titulada «Qué resuelve»Emitir un documento electrónico en Colombia no es un POST: hay que
numerarlo dentro de un rango que la DIAN autorizó, calcular el CUFE con la
clave técnica de ese rango, armar el UBL, firmarlo con el certificado del
emisor, mandarlo al servicio de la DIAN, interpretar la respuesta y
guardar el XML por diez años.
Este API hace todo eso. Tú mandas el documento en JSON y recibes el CUFE, el QR y el PDF.
Asíncrono y con reintento
El documento se encola, se firma y se transmite. Si la DIAN no responde, se reintenta sin gastar otro consecutivo.
Idempotente
Repetir un envío con el mismo reference_code devuelve el documento
que ya existe. Un reintento tuyo nunca produce dos facturas.
Webhooks firmados
Te avisamos cuando la DIAN valida o rechaza, sin que tengas que consultar en bucle.
Por dónde empezar
Sección titulada «Por dónde empezar»Primera factura en 10 minutosDel token a un CUFE, con curl. Sin leer nada más.
Ambientes y URLsSandbox, habilitación y producción: en qué se diferencian.
GlosarioCUFE, CUDE, rango de numeración, clave técnica, adquirente.
AutenticaciónCómo obtener y usar tus credenciales.