Comprobantes electrónicos desde la caja
En un punto de venta cada segundo cuenta. La API responde de inmediato, procesa el comprobante en segundo plano y entrega la representación impresa en formato de ticket.
Lo que resuelve
Pensada para: Fabricantes de software POS y cadenas con cajas propias en tiendas, restaurantes, farmacias o ferreterías.
- La fila no espera
- La emisión es asíncrona: la caja recibe un 202 con el e-NCF asignado y puede seguir cobrando mientras el comprobante se firma y se envía.
- Internet inestable
- Si la conexión se corta a mitad de una venta, la caja reintenta con la misma Idempotency-Key y obtiene el comprobante original, sin duplicados.
- Muchas cajas a la vez
- La secuencia fiscal se asigna de forma atómica en el servidor, de modo que dos terminales nunca reciben el mismo número.
Cómo queda el flujo
-
La caja cierra la venta
El POS arma el JSON del comprobante con los artículos y el medio de pago.
-
Envía y sigue cobrando
POST /v1/documents devuelve 202 con el identificador y el e-NCF.
-
Imprime el ticket
GET /v1/documents/{id}/pdf?format=pos entrega la representación impresa de 80 mm con el código QR.
-
Concilia al cierre
El listado de documentos y los webhooks permiten confirmar el estado fiscal de las ventas del día.
Operaciones que vas a usar
-
POST
/v1/documentsEmitir la factura de consumo o de crédito fiscal
-
GET
/v1/documents/{id}/pdf?format=posDescargar el ticket de 80 mm
-
GET
/v1/documents/{id}/statusVerificar el estado antes de reimprimir
Comprobantes habituales
- E32 Factura de Consumo Electrónica
- E31 Factura de Crédito Fiscal Electrónica
- E34 Nota de Crédito Electrónica
Preguntas frecuentes
¿Qué pasa si la DGII no responde?
El comprobante pasa a contingencia y se reenvía automáticamente. Tu sistema recibe los eventos contingency.started y contingency.ended.
¿Sirve para POS de escritorio?
Sí. Basta con poder hacer solicitudes HTTPS con JSON; no se requiere un lenguaje ni un sistema operativo en particular.
Otras soluciones
- Integración para ERP Equipos de TI de empresas con ERP propio o adaptado, y consultoras que implementan ERP para terceros.
- Integración para comercio electrónico Tiendas en línea con plataforma propia y agencias que desarrollan comercio electrónico para sus clientes.
- Para proveedores de software Empresas de software contable, administrativo, de inventario o vertical que atienden a múltiples clientes.
Conversemos sobre tu integración
Cuéntanos qué sistema quieres conectar y te orientamos sobre el alcance, los pasos y los tiempos.