Infraestructura V2.1 Directa · DIAN Autorizado

API de Facturación Electrónica
Integración Fiscal Directa DIAN

Integra facturación electrónica, nómina y RIPS directamente con la DIAN desde tu aplicación. Sin intermediarios, sin bridges — firma y transmisión en una sola capa de infraestructura con latencias inferiores a 250ms.

Siivro — Proveedor Tecnológico Autorizado por la DIAN e ISO 27001 Certified
REST APIJSON ProtocolXAdES-EPES SignatureDIAN Autorizado
Guía de inicio rápidoReferencia de API
<250msLatencia promedio DIAN
99.98%Uptime garantizado SLA
V2.1API DIAN directa activa
RESTJSON + XAdES-EPES

Primer request en menos de 60 segundos

Autentica tu aplicación, envía tu primer documento y recibe validación DIAN síncrona. Sin intermediarios ni configuraciones complejas.

  1. Genera tu API Key

    Desde el panel de control, crea una clave de acceso para tu entorno de pruebas o producción.

  2. Envía un POST /v1/invoices

    Construye tu payload JSON con los datos del documento. Siivro genera el XML UBL 2.1 automáticamente.

  3. Recibe validación síncrona

    La respuesta incluye CUFE, estado DIAN y PDF en una sola llamada. Sin polling, sin webhooks opcionales.

Ver guía completa
POST /v1/invoices
curl -X POST \
  https://api.siivro.com/v1/invoices \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_type": "01",
    "resolution_number": "18760000001",
    "customer": {
      "identification": "901944128",
      "name": "COLABSOFT SAS"
    },
    "items": [{
      "description": "Infraestructura API Siivro",
      "quantity": 1,
      "price": 59000,
      "tax_rate": "19.00"
    }]
  }'

RESPONSE 200 OK

"status": "DIAN_ACCEPTED", "cufe": "abc123…"

Arquitectura de Conexión

Siivro elimina capas intermedias entre tu aplicación y el WebService DIAN, reduciendo latencia, puntos de fallo y costos operativos.

Integración Tradicional

Arquitectura con terceros tecnológicos como puentes intermedios. Añade latencia variable, dependencias externas y puntos de fallo fuera de tu control.

Tu App→Intermediario→Bridge→DIAN
  • Latencia acumulada por cada salto
  • Dependencia de SLA de terceros
  • Menor trazabilidad de errores
En vivo

Siivro Direct Engine

Conexión directa y síncrona. Firma XAdES-EPES y transmisión al WebService DIAN ocurren en una única capa de infraestructura de alto rendimiento, sin intermediarios.

Tu App→Siivro Core→WebService DIAN
  • Latencia inferior a 250ms end-to-end
  • SLA 99.98% garantizado
  • Trazabilidad completa por documento

Estructura del Payload

Siivro genera automáticamente el XML UBL 2.1, firma XAdES-EPES y CUFE. Solo envías JSON.

Auth: Bearer Token

Siivro genera automáticamente: XML UBL 2.1, firma digital XAdES-EPES, validación estructural DIAN, CUFE y PDF del documento. Solo necesitas enviar el JSON con los datos del negocio.

Requiere resolución DIAN configurada y credenciales habilitadas en tu cuenta. Disponible en entorno de pruebas y producción.

POST /v1/invoices · application/json
{
  "document_type": "01",           // 01 = Factura de Venta
  "resolution_number": "18760000001",
  "customer": {
    "identification": "901944128",
    "identification_type": "NIT",
    "name": "COLABSOFT SAS",
    "email": "pagos@colabsoft.com"
  },
  "items": [
    {
      "description": "Infraestructura API Siivro",
      "quantity": 1,
      "price": 59000,
      "tax_rate": "19.00"          // IVA estándar 19%
    }
  ],
  "payment_method": "10",          // 10 = Efectivo / 42 = Crédito
  "due_date": "2025-02-28"
}
XML UBL 2.1 GeneradoFirma XAdES-EPESTransmisión SíncronaCUFE Incluido

Preguntas frecuentes

Respuestas a las dudas más comunes sobre la integración con la API Siivro y la DIAN.