Integración API Facturación Electrónica: Conecta tu ERP en Horas, No Semanas

Arquitectura API First

AuroraFE expone una REST API completa documentada en OpenAPI 3.1, diseñada para integración nativa con ERPs, POS, e-commerce y sistemas propios.

Endpoints Principales

Método	Endpoint	Descripción
POST	/api/v1/facturas/firmar-transmitir	Firma delegada: JSON → XML firmado + transmisión DIAN
POST	/api/v1/facturas	Crear factura en borrador
GET	/api/v1/facturas/{id}	Consultar factura + estado DIAN + XML + PDF
POST	/api/v1/notas/credito	Crear y transmitir nota crédito
POST	/api/v1/notas/debito	Crear y transmitir nota débito
GET	/api/v1/terceros	Listar/crear/actualizar terceros
GET	/api/v1/productos	Catálogo de productos/servicios
POST	/api/v1/webhooks	Registrar/actualizar webhooks

Firma Delegada: Tu JSON, Nuestro XML

// Request
POST /api/v1/facturas/firmar-transmitir
Authorization: Bearer {api_key}
Content-Type: application/json

{
  "empresa_id": "uuid-empresa",
  "resolucion_id": "uuid-resolucion",
  "factura": {
    "tipo_documento": "01",
    "prefijo": "SETP",
    "consecutivo": 1001,
    "fecha_emision": "2024-01-15T10:30:00-05:00",
    "moneda": "COP",
    "tercero": { "nit": "900123456", "nombre": "Cliente Ejemplo S.A.S." },
    "lineas": [
      { "codigo": "PROD001", "descripcion": "Producto A", "cantidad": 2, "valor_unitario": 50000, "impuestos": [{ "codigo": "01", "porcentaje": 19, "base": 100000, "valor": 19000 }] }
    ],
    "totales": { "subtotal": 100000, "impuestos": 19000, "total": 119000 }
  }
}

// Response (800-1500ms típico)
{
  "cufe": "A1B2C3D4E5F6...",
  "xml_firmado": "",
  "estado_dian": "aceptada",
  "acuse_recibo": { "codigo": "200", "descripcion": "Procesado Correctamente" },
  "pdf_url": "https://.../facturas/uuid/pdf"
}

Webhooks Inteligentes

POST /api/v1/webhooks
{
  "url": "https://tu-erp.com/webhooks/aurorafe",
  "eventos": [
    "factura.aceptada",
    "factura.rechazada",
    "contingencia.activada",
    "resolucion.venciendo",
    "certificado.venciendo"
  ],
  "reintentos": {
    "max_intentos": 6,
    "backoff": "exponencial", // 1m, 5m, 15m, 1h, 6h, 24h
    "dead_letter_queue": true
  },
  "firma_hmac": "sha256",
  "secreto": "tu_secreto_compartido"
}

SDKs Disponibles

• TypeScript/Node: npm install @aurorafe/sdk
• Python: pip install aurorafe-sdk
• Postman Collection: Importar desde dashboard

Sandbox Ilimitado

Ambiente de pruebas idéntico a producción:

• Certificados de prueba DIAN incluidos
• Sin límites de requests
• Datos de prueba realistas precargados
• Logs de request/response para debugging

Tiempo Típico de Integración

Perfil	Tiempo Estimado	Complejidad
Desarrollador Senior (Node/Python)	3-5 días	Baja
Desarrollador Mid-level	1-2 semanas	Media
Equipo sin experiencia DIAN	2-3 semanas	Media-Alta