Black November: −35% on all modules until 30 November Black November: −35% until 30 November Choose a module

Get in touch
OpenCart

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.

Pro · lifetime licence Staging copies are included. The more sites, the cheaper each one
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
Or all 509 Pro modules with All Access — 3 244 UAH / year ≈ €66

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.

Feature Free Pro
Moloni connection: Developer ID, Client Secret, login, company choice, the password is not stored ✔ ✔
NIF field and a check of the Portuguese NIF at the checkout ✔ ✔
A document by hand from the order page: FR, FT, FS with a preview of rows and total ✔ ✔
The customer and products are found or created in Moloni ✔ ✔
Draft, total check and closing (or drafts-only mode) ✔ ✔
PDF from Moloni and the document number in the order history ✔ ✔
Manual Retry, Remove and Read again ✔ ✔
VAT rates of the mainland, Madeira and the Azores, exemption codes ✔ ✔
Interface in English and Portuguese ✔ ✔
Documents made automatically by order status — ✔
Credit notes by button or by status — ✔
Bulk documents for past orders, retry of every stopped one — ✔
Journal of documents and a CSV report — ✔
Products and customers sent to Moloni in the background — ✔
A separate Moloni company for each store — ✔
Exemptions for EU B2B and exports — ✔
Automatic retries when Moloni fails — ✔

What it looks like

The Moloni box in an order
The “Moloni document” box on the order page: type, number, total, status and PDF.
Moloni connection
The “Connection” tab: Developer ID, Client Secret, the Moloni login and the company choice.
Moloni document settings
The “Document” tab: document type, series, payment method, closing mode, fiscal zone, VAT and exemption.

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

v1.0.0 Current November 2026

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

All Access Need more? All modules (509) under one licence, new ones are added automatically. 3 244 UAH≈ €66 Learn more →

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

  1. Install the archive for your OpenCart version and install the module in Extensions → Modules.
  2. 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.
  3. 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.
  4. On “Buyer” create the NIF field and switch its check on; on “Document” choose the document type, the series and the payment method.
  5. For the first orders switch “Close the documents” off: the documents stay as drafts in Moloni.
  6. 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

  1. 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).
  2. For 3.x and 2.3: Extensions → Modifications → Refresh.
  3. Extensions → Modules → Moloni Invoices: install it and open the settings.
  4. On the “Connection” tab enter the Developer ID, the Client Secret, the Moloni login and the password and press “Save and connect”.
  5. For the first orders switch closing off on the “Document” tab.
  6. 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.

@catcode_support Setup, compatibility, activation
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.

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