cufeav2.1
Anexo Técnico DIAN UBL 2.1Infraestructura Fiscal →

Facturación electrónica para developers

Envía un JSON limpio, obtén XML UBL 2.1 firmado, validación previa y CUFE en milisegundos. Diseñada para equipos que construyen software moderno en Colombia.

$npm install @cufea/sdkcontent_copy

Diseñado para la pila tecnológica moderna en producción

polyline Next.js
javascript Node.js
terminal Python
code_blocks Laravel
data_array Go
bolt Supabase
database PostgreSQL
Integración Instantánea

Una simple llamada REST. El estándar DIAN resuelto.

TypeScriptPythoncURLGo
factura.ts
POST /v1/invoices
import { CufeaClient } from '@cufea/sdk';

// Inicializar cliente con clave de Sandbox o Producción
const cufea = new CufeaClient({ apiKey: process.env.CUFEA_KEY });

// Generar factura electrónica, firma X.509 y validación DIAN
const invoice = await cufea.invoices.create({
  idempotencyKey: 'order_98014',
  prefix: 'SETT',
  number: 10924,
  customer: {
    legalName: 'Acme Colombia S.A.S.',
    nit: '901.428.119-3',
    email: 'contabilidad@acme.co'
  },
  items: [{
    sku: 'INFRA-NODE-01',
    description: 'Cufea Enterprise Cluster BOG1',
    quantity: 1,
    price: 4500000.00,
    taxRate: 0.19 // IVA 19%
  }]
});
Latencia DIAN Gateway: ~165msplay_arrowEjecutar llamada
201 CREATEDDIAN Status 00
verifiedValidado Previo
{
  "id": "inv_98014aef9b22",
  "status": "dian_validated",
  "cufe": "fe8071a9c3d4e5f012bca768d90e2105432ab194...",
  "dian_response": {
    "status_code": "00",
    "message": "Aprobado y emitido con éxito",
    "track_id": "c9f131a4-9290-410a"
  },
  "artifacts": {
    "xml_url": "https://vault.cufea.co/xml/inv_98014.xml",
    "pdf_url": "https://vault.cufea.co/pdf/inv_98014.pdf"
  }
}
NuevoCufea MCP

La infraestructura fiscal,
lista para agentes de IA.

Un servidor MCP conectado a la DIAN y a la API de Cufea. Elegí tu agente y conectalo en un clic — emití, validá y consultá documentos electrónicos sin construir payloads UBL a mano.

Elegí tu agente
Configurá el servidor MCP de Cufea en Claude:

claude mcp add --transport http cufea \
  https://mcp.cufea.com/co \
  --header "Authorization: Bearer <token>"

Usá mi token de Cufea (lo tengo en la variable CUFEA_TOKEN) y, cuando termines, confirmá que las tools de cufea quedaron disponibles.
Diseñado para la escala

First-class developer experience

La DIAN no tiene que ser un dolor de cabeza. Construimos las primitivas exactas que tu equipo necesita para olvidarse de los XMLs rotos.

sync_saved_locally

Idempotencia Nativa

Evita facturación duplicada ante caídas transitorias de red o doble clic en pasarelas de pago. Cufea deduplica las solicitudes automáticamente en el borde.

Idempotency-Key: ik_live_79af8c1209b4200 OK (Cache Replay)
webhook

Webhooks con firma HMAC

Recibe notificaciones en tiempo real con invoice.dian_approved y valida la firma criptográfica con tu secreto.

Reintentos automáticos
qr_code_2

PDF y QR en el Edge (<80ms)

Renderizado vectorial ultra veloz de representaciones gráficas reglamentarias sin pesados motores Chromium que ralenticen tu backend.

SVG Vectorial Nativo
terminal

Sandbox Determinista

Prueba casos de borde, rechazos tributarios o fallos del servidor estatal sin emitir facturas legales reales ni usar tu certificado digital.

Entorno 100% aislado
lock

Bóveda UBL 2.1 Inmutable

Custodia legal obligatoria de 5 años bajo cifrado AES-256 en reposo con trazabilidad criptográfica y auditoría tributaria directa.

Art. 684-2 Estatuto Tributario
Flujo de Trabajo

Integra en 5 minutos

Diseñado para acoplarse con tu stack existente sin modificar la lógica interna de tu base de datos ni tu frontend.

01. AUTENTICACIÓN
Inicializar el SDK

Configura tus credenciales seguras de sandbox o producción en una línea.

02. EMISIÓN
POST /v1/invoices

Envía los items y datos fiscales. Cufea compila y firma el XML UBL 2.1.

03. ASINCRONÍA
Webhooks & Eventos

Recibe la validación previa de la DIAN y el CUFE en tu infraestructura.

client.ts
content_copy Copiar
import { CufeaClient } from '@cufea/sdk';

export const cufea = new CufeaClient({
  apiKey: process.env.CUFEA_SECRET_KEY!,
  environment: 'sandbox', // 'sandbox' | 'production'
  timeoutMs: 5000
});

// Comprobar conectividad directa con el Gateway DIAN
const { status, dianGateway } = await cufea.ping();
console.log(`Cufea: ${status} | DIAN: ${dianGateway}`);
Ambiente Sandbox Ilimitado

Empieza a emitir en minutos

Sin contratos comerciales ni trámites lentos. Genera tus llaves de prueba al instante y valida tus primeros documentos UBL 2.1 hoy mismo.

✓ 5,000 facturas de prueba gratuitas•Sin tarjeta de crédito•Soporte directo