
Moloni for OpenCart — invoices from orders, credit notes and the NIF at checkout (Portugal)
Moloni for OpenCart 4.x, 3.x, 2.3 (Portugal): documents from the order page and the NIF at the checkout for free, in Pro — by status, credit notes, journal. Lifetime licence.
- Compatibility
- OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · interface language: English, Português
- Version
-
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3) - Licence
- a site + a staging copy, lifetime
- Trial
- 7 days, no card, one per site
- Updated
- November 2026
What Free has,
and what Pro adds
The free version works with no time limit. Pro adds the rest of the features in the table.
Key points
What the merchant gets
The order page gets a “Moloni document” box: the buyer’s NIF (you can change it and save it for this order), the rows with reference, quantity, price without VAT, discount and rate, and the total with VAT.
What the admin gets
Extensions → Extensions → Modules → Moloni Invoices has six tabs: “Connection”, “Buyer”, “Document”, “Automation”, “Catalogue” and “Pro”.

The trial starts when you ask
A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy
Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.
Technical requirements
OpenCart 4.0.2.x–4.1.x, 3.0.x or 2.3.0.2; the cURL extension.
A Moloni account with a company and API switched on (Developer ID and Chave Secreta).
A closed document is a tax document, it is communicated to the AT and it is final: it is corrected with a credit note. For the first orders switch closing off and check the drafts in Moloni.
Documents are issued in euro only: an order in another currency stops with an explanation and the document is made in Moloni by hand.
A VAT rate or a series missing in the Moloni company stops the document with an explanation. A gift voucher and a fixed fee without a rate also stop with an explanation instead of being issued with a difference.
A row with 0 % VAT needs an exemption code; without one the module sends nothing.
Version history
For OpenCart 4.x, 3.x and 2.3: Moloni invoice-receipts, invoices and simplified invoices from the order page, the NIF at the checkout with a check, the customer and products in Moloni, a…
Frequently bought with Moloni


Cart Discounts (Amount-Based and N+1) for OpenCart

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

TOConline for OpenCart — invoices from orders, credit notes, NIF and ATCUD (Portugal)
Full module description
Moloni Invoices for OpenCart 4.x, 3.x and 2.3 issues documents in the Portuguese service Moloni straight from your orders: the “Make the document” button on the order page creates an invoice-receipt (FR), an invoice (FT) or a simplified invoice (FS) in Moloni, finds or creates the customer and the products, and shows the document number with its PDF.
What you need from Moloni. A Moloni account with a company, API access switched on (Configurações → Developers → “Ativar API”) and your Developer ID. The service itself is paid to Moloni under your plan: the module adds no fee per document.
What the merchant gets
The order page gets a “Moloni document” box: the buyer’s NIF (you can change it and save it for this order), the rows with reference, quantity, price without VAT, discount and rate, and the total with VAT. The “Make the document” button issues the document; the box then shows the type, number, total, status and a PDF button. A buyer without a NIF gets the document as “Consumidor final” (NIF 999999990).
An order paid at the checkout gets an invoice-receipt (FR) or a simplified invoice (FS), as you choose; an order paid later (cash on delivery, cheque — you set the list of codes) gets an invoice (FT) with a due date, 15 days by default. The module first saves a draft, compares its total with the total of the order and only then closes the document; if the totals differ, the draft is removed and the reason is written to the order history.
What the admin gets
Extensions → Extensions → Modules → Moloni Invoices has six tabs: “Connection”, “Buyer”, “Document”, “Automation”, “Catalogue” and “Pro”. On the first one you enter the Developer ID, the Client Secret, the Moloni login and the password and press “Save and connect”: the password goes to Moloni once and is not stored, the Client Secret is stored encrypted. If the login reaches several companies you choose the right one; every shop uses the Developer ID and the key of its own Moloni account.
On “Buyer” you switch on the NIF field at the checkout (the “Create the field” button) and the check of the Portuguese NIF: a number with a wrong check digit is refused next to the field, while buyers outside Portugal and an empty field are not checked. On “Document” you set the document type for orders paid at the checkout, the series, the payment method, the unit of new products, the closing mode (switch “Close the documents” off to keep documents as drafts in Moloni), the days to pay an invoice, the fiscal zone (mainland, Madeira, Azores), VAT “as in the order”, with one rate or without VAT, the exemption reason for 0 % rows, the product reference and a note on the document.
The “Catalogue” tab (Pro) has the buttons “Send the products to Moloni” and “Send the customers to Moloni”, which send products and customers in the background a few at a time: a product is matched by its reference, a customer by NIF or e-mail, and what Moloni already has is left as it is.
Pro issues documents by itself: when an order reaches one of the statuses you chose (for example “Processing”), and creates a credit note by the button on the order page or when the order reaches a refund status (“Refunded”). A credit note takes back the whole closed document. For buyers in other EU countries with a tax number and for buyers outside the EU you set separate exemption codes, and each OpenCart store can have its own Moloni company.
The “Moloni documents” journal in the Sales menu shows every document as “Waiting”, “Stopped”, “Closed” or “Removed”, with the reason for a stop in words: the VAT rate is missing in the Moloni company, the order is not in euro, Moloni did not give the rows for a credit note. “Documents for past orders” issues documents by status and period (up to 200 at a time), “Retry every stopped one” repeats everything stopped, and “CSV report” exports the journal. If an answer from Moloni is lost, the retry looks for the document by the order mark first, so there is no duplicate.
How it works, step by step
- Install the archive for your OpenCart version and install the module in Extensions → Modules.
- In Moloni open Configurações → Developers → “Configuração de conta e API”, tick “Ativar API”, enter a Developer ID and the response address (the address of your shop will do) and press “Atualizar”: Moloni shows the Chave Secreta.
- On the “Connection” tab enter the Developer ID, the Client Secret, the Moloni login and the password, press “Save and connect” and choose the company.
- On “Buyer” create the NIF field and switch its check on; on “Document” choose the document type, the series and the payment method.
- For the first orders switch “Close the documents” off: the documents stay as drafts in Moloni.
- Open an order, check the rows and press “Make the document”; when everything matches, switch closing on.
Under the hood
- Moloni API (moloni.pt/dev): sign-in with the Developer ID, the Client Secret and the owner’s login; customers, products, documents (invoice-receipts, invoices, simplified invoices, credit notes), PDF and the company’s reference lists. Tokens are stored encrypted and the Moloni password is not stored anywhere.
- The document total equals the order total: rows, a coupon as a percentage discount, shipping as a service and VAT are passed with exact values; the draft is compared with the order before closing.
- Moloni needs its access renewed: the module does it by itself once an hour from the OpenCart 4 scheduler and from page opens, and on OpenCart 3 and 2.3 also from a server cron on the secret address shown on the “Automation” tab. If a shop stays silent with no visits for a long time, the settings offer to connect again.
- A Moloni failure (5xx, a reply that is not JSON, a timeout) creates no duplicate: the retry looks for the document by the order mark. The same document is never issued twice.
- The NIF check uses the check digit, with no request to outside registers; an EU tax number is not checked in VIES either.
- The interface is in English and Portuguese, the documents are in the language of the order.
How to install
- Extensions → Installer: upload the archive for your version without renaming the file (OpenCart 4 — cc_moloni.ocmod.zip, 3.x — cc_moloni-oc3.ocmod.zip, 2.3 — cc_moloni-oc23.ocmod.zip; for 2.3 the contents of the upload/ folder are copied into the shop root).
- For 3.x and 2.3: Extensions → Modifications → Refresh.
- Extensions → Modules → Moloni Invoices: install it and open the settings.
- On the “Connection” tab enter the Developer ID, the Client Secret, the Moloni login and the password and press “Save and connect”.
- For the first orders switch closing off on the “Document” tab.
- For Pro: enter a key or start the trial on the “Pro” tab.
Questions
about the module
Didn't find the answer? Message us on Telegram and we'll reply within a business day.
Is this the official Moloni module?
No, it is an independent integration with Moloni by CatCode. Moloni is a trademark of its owner.
What do I need to start?
A Moloni account with a company and “Ativar API” switched on, with your Developer ID and Chave Secreta.
Can I delete an issued document?
A closed document is final and is corrected with a credit note (Pro: the button on the order or the refund status). The module can remove a draft (“Remove”). For the first orders switch closing off.
What happens with a buyer who gives no NIF?
The document goes to “Consumidor final” (NIF 999999990). If a NIF is typed but is wrong, the buyer sees an error next to the field at the checkout.
What if an order has 0 % VAT?
Choose an exemption code in the settings. Without one no document is issued and the module explains why.
Can I issue documents in bulk?
Yes, in Pro: by status and period, up to 200 at a time; “Retry every stopped one” repeats the stopped ones.
Which OpenCart versions?
OpenCart 4.0.2.x–4.1.x, 3.0.x and 2.3.0.2: three separate archives in one product.
Is the licence lifetime?
Yes, for OpenCart it is one payment and a lifetime licence, for two sites.
What happens after the trial?
Pro switches off and the free part keeps working.
No reviews yet. Be the first.
No questions yet. Ask one — we answer within 24 hours.
Not quite what you are looking for?
We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.
Order a custom module
Buying the module
—
Charged in UAH; your bank converts it to your currency. EUR price is approximate.




















