Qué es Nubefact, cómo usar su API en tu tienda o sistema, qué defines antes, qué alternativas hay y cómo te ayudamos en Impulsa Studio a conectarlo.
¿Qué es Nubefact y a qué negocios les sirve?
Si tu tienda online o tu sistema de ventas ya registra cada pedido, Nubefact puede convertirlo en una boleta o una factura electrónica sin que nadie lo vuelva a digitar: tu sistema le envía la venta, y Nubefact genera el comprobante y lo manda a la SUNAT.
Ese puente se programa en tu tienda o en tu sistema, no en Nubefact, y en Impulsa Studio podemos construirlo como una integración más.
Nubefact es un servicio de facturación electrónica con el que un negocio en el Perú emite facturas, boletas, notas de crédito y de débito y guías de remisión. Figura en los padrones de operadores (OSE) y de proveedores (PSE) de servicios electrónicos que publica la SUNAT, y la orientación de la SUNAT define al OSE como quien realiza la comprobación informática de que el comprobante cumple las condiciones de emisión.
Le sirve sobre todo al negocio que ya vende con un sistema: Nubefact indica que, si tienes un software de ventas o un ERP propio o de terceros, puedes seguir usándolo e integrarlo con su API REST. Si ese sistema es de un tercero, Nubefact recuerda que quien integra necesita acceso a su código o a su base de datos.
¿Cómo funciona la API de Nubefact con tu tienda o tu sistema?
La API de Nubefact funciona con tu tienda o tu sistema a partir de un archivo JSON o TXT por cada venta: con él, Nubefact genera el XML y el PDF, envía el XML a la SUNAT y almacena la CDR, que nuestra guía de términos de facturación electrónica en Perú describe como el documento de la SUNAT que valida la aceptación o el rechazo del comprobante. Su página de integración resume lo que necesitas: una ruta, un token y el archivo con los datos.
- Credenciales: Cada cuenta tiene una ruta propia y uno o varios tokens.
- Envío: Según el manual de integración JSON de Nubefact, tu sistema hace un POST a esa ruta, con el token en la cabecera Authorization y el JSON en el cuerpo.
- Respuesta: Según el manual, llega de inmediato, con enlaces al PDF, al XML y a la CDR, un campo que dice si la SUNAT aceptó el comprobante y la descripción del error cuando lo hay.
En una tienda importa también el momento del envío: como explicamos en comprobante automático en cada cobro, el comprobante se dispara cuando la pasarela confirma el pago aprobado, no antes.
¿Qué decides con tu contador antes de integrar Nubefact?
Antes de integrar Nubefact decides con tu contador las reglas de cada comprobante. Algunos puntos los fija el manual de Nubefact y otros, tu negocio:
- Series y correlativos: La serie tiene cuatro caracteres y empieza con F en las facturas o con B en las boletas, y lo mismo en sus notas. El número es correlativo, sin ceros a la izquierda, y el manual indica empezar en 1; si ya emites con otro sistema, confirma la numeración con tu contador.
- Anulaciones: Con la API anulas un comprobante indicando un motivo, mediante una comunicación de baja. La orientación de la SUNAT limita la baja a ciertos casos, como el comprobante que aún no se entregó al cliente, y le fija un plazo. Confirma con tu contador cuándo corresponde una baja y cuándo una nota de crédito.
- Notas de crédito: Modifican un comprobante ya comunicado, según el manual. Define qué evento de tu tienda las genera, como una devolución.
- Pruebas: El manual menciona una cuenta de demostración y, antes de pasar a producción, pide generar desde tu sistema algunos documentos de una lista.
- Archivos: Tu sistema guarda el XML y la CDR, además del PDF, como recomendamos al explicar qué debe incluir tu sistema de ventas e inventario.
¿Cómo haces una consulta en Nubefact cuando falla el envío?
Haces una consulta en Nubefact con la operación consultar_comprobante, que te da el estado de una factura, una boleta o una nota; consultar_anulacion hace lo mismo con las anulaciones. Úsala cuando la respuesta no llega o llega con error; el manual no describe qué hacer si se corta la conexión, así que te sugerimos estos pasos:
- Lee el código de error: El manual distingue, entre otros, el token incorrecto (10), el formato inválido (20), el documento que ya existe (23) y el que no existe o no se envió (24).
- Consulta antes de reenviar: Sin respuesta, consulta por tipo de comprobante, serie y número. Si el comprobante existe, revisa si la SUNAT lo aceptó y guarda sus archivos; si no existe, reenvíalo con el mismo número.
- Evita los duplicados: Una pasarela puede repetir el aviso de un pago. Tu sistema debe reconocer que esa venta ya tiene comprobante.
¿Qué alternativas a Nubefact tienes para emitir tus comprobantes?
Las alternativas a Nubefact son el portal de la SUNAT, otro proveedor o tu propio sistema. La SUNAT permite emitir facturas desde su portal con tu Clave SOL, y su orientación aclara que esa emisión es gratuita, aunque llenas cada comprobante tú mismo. También puedes trabajar con otro proveedor de servicios electrónicos o evaluar con tu contador la emisión directa desde tu propio sistema, sin un proveedor, dentro de lo que la SUNAT llama SEE desde los sistemas del contribuyente.
Cuál de estas opciones te corresponde, entre SEE-SOL, un PSE o un OSE, lo confirmas con tu contador.
¿Cómo te ayuda Impulsa Studio a conectar Nubefact con tu tienda o tu sistema?
Con las reglas de tus comprobantes definidas por tu contador, en Impulsa Studio podemos programar la conexión de tu tienda o tu sistema con Nubefact, desde el envío de cada venta aprobada hasta la consulta antes de reenviar y las notas de crédito. Puede ser una tienda online o un sistema web que desarrollemos o uno que ya uses, siempre que su plataforma permita integrar una API externa o se pueda acceder a su código o a su base de datos.
Escríbenos por WhatsApp y cuéntanos qué tienda o sistema quieres conectar con Nubefact.




