API DIAN Colombia Desarrolladores

¿Tu software necesita emitir facturas electrónicas válidas ante la DIAN?

Si eres desarrollador y tu aplicación — en PHP, Laravel, Node.js, Python o cualquier otro lenguaje — necesita generar facturas electrónicas, notas débito o notas crédito válidas en Colombia, la API DIAN de DonPedro es lo que buscas.

Es un servicio REST alojado en servidor cloud dedicado. Tú consumes los endpoints, nosotros manejamos la conexión con la DIAN, la firma digital, los XML y la resolución de facturación. Documentos ilimitados desde $99.000 COP/mes por empresa.


¿Qué hace esta API?

Actúa como intermediario técnico certificado entre tu sistema y la DIAN. Tú envías un JSON con los datos de la factura; nosotros:

  1. Generamos el XML en formato oficial DIAN (UBL 2.1)
  2. Aplicamos la firma digital con el certificado tributario
  3. Transmitimos el documento a la DIAN en tiempo real
  4. Retornamos el CUFE, el PDF y el XML para entregar al cliente final

Todo en una sola llamada REST. Sin instalaciones locales, sin certificados propios, sin gestionar resoluciones.


Endpoints principales

Endpoint Función
POST /api/v1/invoice Emitir factura electrónica de venta
POST /api/v1/credit-note Nota crédito (devolución / anulación)
POST /api/v1/debit-note Nota débito (ajuste de valor)
GET /api/v1/invoice/{id} Consultar estado de un documento
GET /api/v1/invoice/{id}/pdf Descargar PDF firmado
GET /api/v1/invoice/{id}/xml Descargar XML UBL 2.1

Ejemplo de integración en Laravel

use Illuminate\Support\Facades\Http;

$response = Http::withToken(env('APIDIAN_KEY'))
    ->post('https://api.posdonpedro.com/api/v1/invoice', [
        'empresa_nit'     => '900123456-1',
        'cliente_nit'     => '800987654-3',
        'cliente_nombre'  => 'Distribuciones S.A.S',
        'cliente_email'   => 'factura@empresa.com',
        'items' => [
            [
                'descripcion'  => 'Servicio de desarrollo web',
                'cantidad'     => 1,
                'precio_unit'  => 2500000,
                'impuesto_iva' => 19,
            ]
        ],
        'forma_pago' => 'contado',
    ]);

$cufe    = $response->json('cufe');
$pdf_url = $response->json('pdf_url');

La respuesta incluye el CUFE, URL del PDF, XML firmado y estado DIAN (aceptado, aceptado_con_notificacion o rechazado con detalle del error).


Características técnicas

  • ✅ Stack: PHP 8.2 / Laravel — servidor cloud dedicado en Colombia
  • ✅ Protocolo: REST API · autenticación Bearer Token
  • ✅ Formato de respuesta: JSON
  • ✅ Tiempo de respuesta: < 3 segundos por documento
  • ✅ Uptime: 99.5% — servidor dedicado, no compartido
  • ✅ Documentos ilimitados por empresa suscrita
  • ✅ Multi-empresa: una integración para N empresas, cada una con su token
  • ✅ Resolución DIAN incluida en el onboarding
  • ✅ Sandbox gratis sobre el ambiente de habilitación DIAN
  • ✅ Soporte técnico directo con el equipo de desarrollo

Compatible con cualquier lenguaje

Es una API REST estándar. Funciona con cualquier stack que haga llamadas HTTP:

  • PHP · Laravel · Symfony · WordPress
  • Python · Django · FastAPI
  • Node.js · Express · NestJS
  • Java · Spring Boot
  • .NET / C#

Precio

Plan Precio Documentos Empresas
Por empresa $99.000 COP/mes Ilimitados 1 NIT
Multi-empresa Consultar Ilimitados 2+ NIT

Sin costos de configuración inicial. Sin cobro por volumen.


Preguntas frecuentes

¿Necesito tramitar la resolución de facturación con la DIAN?

No. En el onboarding gestionamos la resolución por cada empresa. Tú solo integras los endpoints.

¿La API es multi-tenant?

Sí. Cada empresa tiene su propio Bearer Token y resolución DIAN independiente. Desde tu sistema puedes manejar N empresas cambiando únicamente el token por petición.

¿Qué pasa si la DIAN rechaza una factura?

La respuesta trae el código y descripción exacta del rechazo. Los errores más frecuentes están documentados en la guía de errores que entregamos al contratar.

¿Hay sandbox de pruebas?

Sí. Gratuito, sobre el ambiente de habilitación DIAN. No genera documentos reales. Acceso inmediato al contratar.

¿Soporta régimen simplificado y retenciones?

Sí. Soporta responsables y no responsables de IVA, ReteIVA, ReteICA y Retefuente.

Comentarios

Una respuesta a «API DIAN Colombia Desarrolladores»

  1. […] API de facturación electrónica DIAN permite que tu software genere, firme y transmita documentos fiscales ante la DIAN directamente […]

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

💬