InvoiceXpress for OpenCart 4.x — fatura from the order page

InvoiceXpress Invoices links OpenCart to the Portuguese invoicing service InvoiceXpress. On the order page a panel shows the buyer, the lines and the total, and a button makes the document: a draft first, then the total is compared with the order, and only then it is finalised. The ATCUD and PDF come back to the order.

What the buyer sees

At checkout the buyer can enter a NIF. A wrong check digit stops the form with a message next to the field. An empty field passes, and a buyer from another country is not checked. Nothing else changes at checkout.

What the admin gets

The order page gets a panel with the buyer, the lines and the total. A button makes the document, and the panel shows the number, the ATCUD and a PDF button. An InvoiceXpress refusal, for example an unregistered series, shows in words on screen, next to buttons to retry or remove an unfinished attempt. All documents are in a separate list in the Sales menu.

How it works, step by step

1. Copy the account name and API key to the settings.
2. Press the check: the module reads series and rates.
3. Create the NIF field with a button.
4. Pick the document type and series.
5. On the order page look at the total and make the document.

Under the hood

• Access keys are stored encrypted, also in the copy of the settings.
• A second press or a retry after a lost answer makes no second document.
• Documents live in the module’s own tables. Removing the module leaves them alone, so an update loses no history.
• A service error does not break the order page: it shows plain words and retry buttons.
• If the draft total differs from the order, the document stays a draft and the panel says so.
• A coupon goes as a percent on the line. This is a conclusion from an example in the documentation, so check the first document with a coupon.
• The documentation has no webhooks: the paid status comes by a scheduled check.

How to install

1. Extensions → Installer: upload the archive for your version and keep the file name.
2. Extensions → Modules → InvoiceXpress Invoices → install button → Edit.
3. Connection tab: the account name, the key and the check.
4. Buyer tab: create the NIF field.
5. Document tab: type, series, due days, IVA exemption, together with your accountant.
6. For Pro: paste the key or start the 7-day trial.