Guía completa para integrar la API DIAN en tu software
Jhon Frey Diaz
MercaloAPI
Integrar facturación electrónica DIAN en tu software no tiene que ser complicado. Con MercaloAPI puedes hacerlo en 3 pasos: crear cuenta, registrar tu empresa con su certificado digital, y empezar a emitir facturas vía API.
El primer paso es obtener tus credenciales de API. Después del registro, ve a Dashboard → API Keys y genera una clave de sandbox (sk_test_) para desarrollo. Estas claves funcionan contra nuestro ambiente de pruebas sin tocar la DIAN real.
Para registrar una empresa, necesitas su NIT, razón social y certificado digital .p12 en base64. Usa el endpoint POST /v1/companies con estos datos. MercaloAPI almacena el certificado cifrado con AES-256.
Para emitir tu primera factura, envía un POST a /v1/invoices con el companyId, datos del cliente y los items. MercaloAPI genera el XML UBL 2.1, lo firma con XAdES-EPES, lo transmite a la DIAN y te devuelve el CUFE, estado, PDF y XML.
Configura webhooks para recibir notificaciones cuando la DIAN procese tus documentos. Esto es especialmente útil para facturas que entran en validación asíncrona.
¿Listo para empezar?
Prueba MercaloAPI gratis y emite tu primera factura electrónica DIAN en menos de 5 minutos.
Crear cuenta gratis