Introducción
Integrar un ERP con la API DIAN es una de las tareas más técnicas del ecosistema tributario. Si se hace bien, permite automatizar completamente la emisión, recepción y validación de documentos electrónicos.
1. Arquitectura General
ERP → Servicio de integración → Firma digital → Envío XML → Validación DIAN → Respuesta JSON.
Diagrama de flujo (texto)
[ERP]
↓ genera factura
[Middleware/API]
↓ firma y envía
[DIAN Web Service]
↓ valida y responde
[ERP] almacena resultado
2. Requisitos Técnicos
Certificado digital (.p12).
Conectividad HTTPS y autenticación por token.
Estructura XML conforme a Anexo Técnico 1.9 o superior.
3. Ejemplo de Código (PHP/Laravel)
$response = Http::withHeaders([
'Authorization' => 'Bearer '.$token
])->post('https://api.dian.gov.co/v2/invoice/send', [
'xml_base64' => base64_encode($xml),
'document_type' => 'FE'
]);
4. Mejores Prácticas
Validar esquema XSD antes de firmar.
Implementar logs de respuesta DIAN.
Separar ambiente de pruebas y producción.
Una integración bien construida garantiza automatización, cumplimiento y trazabilidad total.
