Si tienes un sistema propio (ERP, e-commerce, punto de venta, app móvil) y quieres que genere facturas y boletas electrónicas sin que tus usuarios tengan que cambiar de pantalla, la solución es integrar una API de facturación electrónica.
En este artículo te explicamos cómo funciona el proceso de integración con QENTI, desde la autenticación hasta la emisión de tu primera factura vía API.
¿Por qué integrar en lugar de usar el portal?
Usar el portal web de QENTI directamente funciona bien para equipos pequeños que facturan manualmente. Pero si tu negocio tiene:
- Un e-commerce que necesita generar boleta automáticamente con cada compra
- Un ERP o sistema de gestión que ya registra las ventas
- Un punto de venta (POS) que opera en caja
- Una app móvil para vendedores de campo
…entonces la integración vía API es la solución correcta. El flujo queda 100% automatizado sin intervención humana.
Arquitectura de la integración
Tu sistema → API QENTI → PSE autorizado por SUNAT → SUNAT → CDR de vueltaTu sistema envía los datos de la factura (cliente, productos, montos) en formato JSON. QENTI los valida, genera el XML firmado, lo envía al PSE, recibe el CDR de SUNAT y te devuelve la respuesta con el estado del comprobante y los archivos PDF/XML.
Autenticación
La API de QENTI usa autenticación con token JWT (JSON Web Token): tu sistema se autentica, recibe un token y lo envía en cada llamada.
Qué puedes hacer con la API
- Emitir facturas, boletas, notas de crédito y de débito, guías de remisión, notas de venta y cotizaciones.
- Enviar el comprobante emitido al correo de tu cliente.
- Consultar un comprobante y su detalle.
- Consultar los datos de un cliente por su número de documento.
- Listar y buscar los productos de tu empresa.
- Comunicar la baja de un comprobante y consultar el libro de ventas.
Cómo pedir acceso
La API viene en el plan Corporativo. Al contratar te entregamos la documentación con las rutas y los ejemplos, y te acompañamos por WhatsApp durante la integración.
Solicita acceso a la API por WhatsApp o mira los detalles en la página de la API.
Checklist antes de ir a producción
- Certificado digital activo en tu cuenta de QENTI.
- Series de comprobantes configuradas para cada establecimiento.
- Manejo de errores en tu sistema: si SUNAT rechaza un comprobante, muestra el motivo a tu usuario.
- Pruebas con comprobantes reales de bajo monto antes de automatizar todo el flujo.
