Nubefact Invoicing for WooCommerce — boleta and factura for SUNAT from the order

Nubefact Invoicing passes a WooCommerce order to your Nubefact account, which prepares a boleta or factura for SUNAT. The buyer picks the document and enters a DNI or RUC at checkout, and you issue the document with a button in the order.

This plugin has never issued a real document. First issue a few documents in your own Nubefact demo account.

The plugin makes no promise of compliance with Peruvian law and is not accounting or tax advice. Check series, IGV and document types with your accountant.

What the buyer sees

At checkout the buyer picks a boleta with a DNI, carnet de extranjería or passport, or a factura with a RUC. A wrong RUC stops the order with plain text at classic checkout. At block checkout a field sees only one number, so the issue step does the full check.

After issue, the PDF link appears in the customer account and e-mail.

What the admin gets

In the settings you enter the route, token and series, and choose the IGV rate and exchange rates. The order has a Nubefact box: issue, SUNAT status, links to PDF, XML and CDR. If Nubefact refuses, the reason stays in the box and note, and the next try uses the same number.

In Pro a document issues by itself at the chosen status, a refund becomes a credit note, a document can be voided and issue can start from the orders list.

How it works, step by step

1. In Nubefact you enable the API and take the route and token.
2. You enter them in the plugin with the series.
3. The buyer picks the document at checkout.
4. You press issue, or Pro does it by itself.
5. Nubefact passes the document to SUNAT.
6. The buyer sees the PDF link.

Under the hood

• The plugin sends data only to nubefact.com and pse.pe addresses.
• A document number is reserved under a lock, so two requests never share one.
• After a failure the document is looked up by number, not issued twice.
• Only ordinary sales with IGV, exonerado or inafecto are covered.
• The plugin does not do detracciones, percepciones, free transfers, exports or waybills.
• The total is built from lines, so some shops may see a difference of a cent.

How to install

1. Plugins → Add New → Upload Plugin: pick the zip and activate.
2. WooCommerce → Nubefact: enter the route and token from the API section in Nubefact.
3. Fill in factura and boleta series and press the connection test.
4. Issue a few documents in the Nubefact demo mode.
5. For Pro: paste the key or start the 7-day trial.

The module is not on wordpress.org yet: the free version and Pro are one archive from this page. Without a key it works as the free version.