⚡ Para Creadores de Software POS & Apps Gastronómicas

API REST de Facturación DIAN & INC para Softwares POS y Restaurantes

La infraestructura de timbrado ultra-rápida para directores de tecnología y desarrolladores de sistemas POS gastronómicos. Emite facturas electrónicas con cálculo automático del Impuesto Nacional al Consumo (INC 8%), desglose legal de propinas (Ley 1935) y timbrado en < 180ms para no frenar la atención en caja.

✓ JSON limpio para INC 8% y Propinas • ✓ Emisión masiva en horas pico (< 180ms) • ✓ Multi-Tenant para todos tus locales o clientes
8% INC
Cálculo Nativo en Payload JSON
< 180ms
Timbrado en Horas Pico sin Bloqueos
Multi-Tenant
Cientos de Restaurantes en 1 Cuenta
UBL 2.1
XML y PDF DIAN Generados al Instante
💻 PAYLOAD DE EJEMPLO

Un Solo JSON Limpio para Toda la Comanda

Tu sistema POS envía los ítems de la mesa, el cálculo del INC (8%) y la propina. JCFlow construye el XML UBL 2.1 firmado con XAdES-BES, calcula el CUFE y transmite a la DIAN.

POST /v1/api/facturacion — Payload Gastronómico
// Emisión instantánea para software de restaurante con INC 8% y Propina voluntaria
{
  "tipo_documento": "FE",
  "prefijo": "POS",
  "cliente": {
    "tipo_documento_id": 3,
    "numero_documento": "1098765432",
    "razon_social": "Comensal Mesa 4",
    "email": "comensal@email.com"
  },
  "lineas": [
    {
      "descripcion": "Corte New York Steak 350g",
      "cantidad": 2,
      "precio_unitario": 65000,
      "impuestos": [{ "codigo": "04", "tarifa": 8.00 }] // INC 8% DIAN
    }
  ],
  "cargos": [
    { "concepto": "Propina Voluntaria Ley 1935", "monto": 13000, "es_propina": true }
  ],
  "metodos_pago": [{ "medio_pago_id": 48, "monto": 143000 }]
}

Diseñado para Desarrolladores de Sistemas POS Gastronómicos

Tu equipo se enfoca en comandas de cocina, inventarios y atención en mesa. JCFlow asume el 100% de la complejidad criptográfica, firmas digitales y conexión con la DIAN.

Impuesto Nacional al Consumo (INC 8%)

Estructuración automática del tributo '04' en el XML UBL 2.1 para restaurantes y bares según el Estatuto Tributario Art. 512-1, sin conflictos con el régimen de IVA.

Tributo DIAN 04 Nativo

Manejo Legal de Propinas (Ley 1935)

Desglosa el porcentaje de propina voluntaria sugerida (10%) sin alterar la base gravable del INC ni causar descuadres tributarios en el cálculo del total.

Cumplimiento Ley 1935

Arquitectura Multi-Tenant para tus Restaurantes

Registra a cada cliente de restaurante como un sub-emisor independiente vía API. Administra resoluciones, certificados .p12 y prefijos de caja con total aislamiento.

Multi-Tenant REST

Alta Velocidad en Horas Pico (Bun / Node)

En los picos de servicio de viernes y sábado tu POS no puede congelar la cuenta. Nuestra arquitectura no bloqueante procesa colas de emisión en < 180ms con 99.98% uptime.

Latencia < 180ms

Webhooks Asíncronos e Impresión en Caja

Recibe webhooks HTTP instantáneos con el CUFE, código QR y URL del PDF para disparar la impresión directa en impresoras térmicas de 80mm o 58mm en caja.

Webhooks en Tiempo Real

Envío al Comensal por WhatsApp o Email

Despacha el PDF oficial y XML por WhatsApp o correo sin que tu POS tenga que implementar servidores SMTP ni pasarelas de mensajería complejas.

WhatsApp API Integrada

Preguntas Frecuentes para Equipos de Desarrollo POS

Aclaraciones técnicas sobre la integración de la API REST de JCFlow.

¿Cómo gestiona la API el cálculo del Impuesto Nacional al Consumo (INC) frente al IVA?
JCFlow procesa de forma nativa el código de tributo "04" (INC) según el Anexo Técnico 1.8 de la DIAN. Puedes emitir ítems con INC del 8%, ítems exentos o mezclar con IVA si el establecimiento vende mercancías gravadas, calculando automáticamente bases imponibles independientes en el XML UBL 2.1.
¿Cómo se gestiona el multi-tenant para los clientes de mi software POS?
Puedes registrar a cada establecimiento como un tenant secundario mediante endpoints de aprovisionamiento REST. Cada tenant dispone de su propio certificado digital (.p12), resoluciones de facturación autorizadas por la DIAN y prefijos por punto de venta.
¿Qué sucede si la DIAN experimenta intermitencias en horas pico de servicio?
La API de JCFlow incluye circuit-breakers y colas de contingencia automáticas con Redis. Si la DIAN presenta fallas temporales, el comprobante se almacena con estado de contingencia fiscal y se retransmite automáticamente cuando los servidores gubernamentales restablezcan servicio.
¿Puedo conectar la API a comanderas táctiles o sistemas de escritorio heredados?
Sí. Al ser una API REST estándar sobre HTTPS y JSON, puedes integrarla desde cualquier tecnología: Electron, C# .NET, Java, Python, PHP, Flutter, React Native o arquitecturas web tradicionales.
🤝 SOFTWARE FINAL RECOMENDADO

¿Eres dueño de un restaurante o bar y buscas un software listo para usar?

JCFlow es la API para desarrolladores y software houses. Si lo que necesitas es un sistema de punto de venta ya implementado con comandas y mesas:

Conoce Jeloda (jeloda.com), el software gastronómico y POS todo-en-uno para restaurantes, gastrobares y cafeterías, impulsado con la infraestructura de facturación electrónica DIAN e INC de JCFlow.

Potencia tu software POS con facturación DIAN e INC en minutos

Crea tu cuenta de desarrollador, obtén tus API keys en Sandbox y empieza a timbrar comprobantes gastronómicos de prueba de inmediato.

¿Dudas con la DIAN? Habla con un asesor en WhatsApp