CONTABILIDAD

Nubefact: cómo conectarlo a tu tienda o tu sistema

Por Jorge Chang, el

Nubefact: cómo conectarlo a tu tienda o tu sistema

Síguenos en:

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.

Despega con nosotros

Solicita un diagnóstico gratuito y descubre el potencial de tus ideas

Preguntas frecuentes

¿Nubefact te sirve si no tienes un sistema de ventas?
Nubefact te sirve aunque no tengas un sistema de ventas: para ese caso, su sitio propone Nubefact Online, donde generas cada comprobante en línea.
¿Nubefact envía el comprobante al correo de tu cliente?
Nubefact envía el comprobante al correo de tu cliente si así lo indicas en el JSON o el TXT que le mandas, según su manual. Para eso, tu tienda debe pedir el correo al comprar.
¿Qué datos de la venta necesita Nubefact para emitir el comprobante?
Nubefact necesita, según su manual, datos del cliente, de cada producto y del comprobante. Entre otros, pide el tipo y el número de documento del cliente y su nombre o razón social, y de cada producto la descripción, la cantidad, los valores con y sin IGV y el tipo de IGV. La lista completa está en el manual, y los tipos de documento y de IGV los defines con tu contador. En Impulsa Studio podemos pedir los datos del cliente en el proceso de pago de tu tienda online.
Impulsa logo

Hablemos

WhatsApp logo933262820

Síguenos

Instagram logoLinkedIn logoTiktok logo

Copyright © 2024 Impulsa Todos los derechos reservados

Política de PrivacidadTérminos y Condiciones