Fakturoid for OpenCart 4.x — invoices from the order page

Fakturoid Invoices links OpenCart to the Czech invoicing service Fakturoid. On the order page a panel shows the buyer, the lines and the total, and a button makes the invoice in your Fakturoid account.

What the buyer sees

At checkout a company buyer can enter an IČO and a DIČ. A wrong IČO check digit or DIČ shape stops the form with a message next to the field. Empty fields pass, and the number of 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. The numbers can be corrected right there. A button makes the invoice, and the panel shows its number and a link. A Fakturoid refusal, for example when no bank account is set up, shows in words on screen, next to buttons to retry or remove an unfinished attempt. All invoices are in a separate list in the Sales menu.

How it works, step by step

1. Copy the account slug, Client ID and Secret to the settings and add a contact e-mail.
2. Press the check: the module reads the company, number formats and bank accounts.
3. Create the IČO and DIČ fields with a button.
4. On the order page look at the total and make the invoice.
5. The number and a link appear in the panel.

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.
• Fakturoid asks for a contact e-mail in every request: it comes from the settings.
• A coupon goes as a separate line with a minus. The documentation neither forbids nor describes this, so check the first invoice with a coupon.
• The webhook accepts only the address with the secret key.

How to install

1. Extensions → Installer: upload the archive for your version and keep the file name.
2. Extensions → Modules → Fakturoid Invoices → install button → Edit.
3. Connection tab: the login data and the check.
4. Buyer tab: create the IČO and DIČ fields.
5. Invoice tab: number format, bank account, due days, VAT mode, together with your accountant.
6. For Pro: paste the key or start the 7-day trial.