Producción ListaUBL 2.1 · DIANSolo Backend

Guía de Inicio Rápido
API de Facturación Electrónica · Integración Fiscal Directa DIAN

Ejecute su primera validación fiscal ante la DIAN en menos de un minuto. SIIVRO automatiza la firma XAdES-EPES y la generación UBL 2.1 de forma nativa — exclusivamente desde tu backend.

Latencia <250ms
99.98% uptime
Res. 000042 de 2020
<250ms
Respuesta DIAN
99.98%
Disponibilidad
V2.1
UBL Oficial

Modelo de Integración (No Negociable)

SIIVRO se consume exclusivamente desde backend. Jamás desde el frontend ni expuesto en código cliente.

Arquitectura correcta

FrontendCaptura datos Sin lógica fiscal
→
Backend tuyo/create-invoice Lógica de negocio
→
SIIVROXML · Firma · DIAN Impuestos · CUFE
→
DIANValidación fiscal real

Regla de oro: Tu API Key vive solo en tu backend. Si aparece en código frontend, la seguridad de tu cuenta está comprometida.

⚠Errores a evitar: consumir SIIVRO desde el frontend, generar XML manualmente, calcular impuestos fuera de SIIVRO, o enviar datos incompletos. SIIVRO resuelve toda la complejidad fiscal por ti.

Componentes Que Necesitas

Tres piezas mínimas para una integración funcional y segura.

Frontend

Formulario de facturación

Inputs: cliente, productos, valores

Botón 'facturar'

Sin lógica fiscal aquí

Backend (crítico)

Endpoint /create-invoice

Autenticación interna

Recibir y validar datos

Llamar a SIIVRO

Aquí vive la integración real

Cuenta SIIVRO

API Key (solo en backend)

Resolución DIAN configurada

Certificado digital

Datos fiscales del emisor

Configuración única por tenant

Flujo de Implementación

1

Handshake de Seguridad (API Key)

Obtenga sus credenciales desde el Dashboard de SIIVRO. El prefijo determina el entorno. Esta key jamás debe aparecer en el frontend.

HTTP Header · Backend Only
// Tu backend enviará esto a SIIVRO
Authorization: Bearer test_siivro_YOUR_SECRET_KEY

Sandbox

prefix: test_

Pruebas sin impacto fiscal. DIAN de habilitación.

Producción

prefix: prod_

DIAN real. Documentos con validez legal inmediata.

2

Tu Backend Llama a SIIVRO

Tu backend recibe el request del frontend, valida los datos y llama a SIIVRO con el JSON de negocio. No generes XML. No calcules impuestos. Solo envía datos.

cURL · Desde Tu Servidor
curl -X POST https://api.siivro.com/v1/invoices \
  -H "Authorization: Bearer test_siivro_8273" \
  -H "Content-Type: application/json" \
  -d '{'
    "document_type": "01",
    "resolution_number": "18760000001",
    "customer": {
      "identification": "901944128",
      "name": "COLABSOFT SAS"
    },
    "items": [{
      "description": "Infraestructura API V2.1",
      "quantity": 1,
      "price": 59000.00,
      "tax_rate": "19.00"
    }]
  }'
3

SIIVRO Resuelve Todo · Tu Backend Recibe

SIIVRO genera el XML, firma, calcula IVA/ICA/Retefuente, transmite a la DIAN y devuelve la respuesta lista para mostrar al usuario.

201 Created · Application Response
{
  "status": "DIAN_ACCEPTED",
  "cufe": "a8f3c2...e8273x",
  "qr_code": "https://siivro.cloud/v/a8f3c2...",
  "xml_path": "https://storage.siivro.com/...",
  "pdf_path": "https://storage.siivro.com/..."
}

Responsabilidades Claras

Esto es lo que diferencia a SIIVRO de una integración manual.

Tú (el desarrollador)

✔ Captura datos de negocio
✔ Define qué quieres facturar
✔ Envías JSON limpio a SIIVRO
✔ Muestras el resultado al usuario

SIIVRO (tu motor fiscal)

✔ Genera XML UBL 2.1 válido
✔ Firma XAdES-EPES automática
✔ Calcula IVA, ICA, Retefuente
✔ Valida estructura ante DIAN
✔ Transmite y obtiene CUFE
✔ Devuelve respuesta procesada

Flujo Completo

Visión global de cómo viajan los datos de punta a punta.

Usuario llena formulario
Frontend → BackendSolo datos, sin lógica fiscal
Backend → SIIVROPOST /v1/invoices con API Key
SIIVRO procesa todoXML · Firma · Impuestos · CUFE
DIAN validaApplicationResponse
Frontend muestra resultadoCUFE · PDF · QR

Errores Comunes a Prevenir

✕Consumir SIIVRO desde el frontend directamente
✕Generar XML UBL manualmente antes de enviar
✕Calcular impuestos fuera de SIIVRO
✕Enviar datos incompletos o sin validar
✕Exponer la API Key en código cliente
✕Mezclar entornos sandbox y producción

Mensaje clave

El cliente envía datos de negocio.
SIIVRO resuelve la complejidad fiscal.

Preguntas de Integración