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

Get in touch
OpenCart

TOConline for OpenCart — invoices from orders, credit notes, NIF and ATCUD (Portugal)

TOConline for OpenCart 4.x, 3.x, 2.3 (Portugal): documents from the order page and NIF at checkout free; Pro adds status rules, credit notes, AT and a journal. A licence for life.

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
TOConline OAuth connection: client id, secret, OAuth and API addresses, encrypted tokens ✔ ✔
NIF field and Portuguese NIF validation at checkout ✔ ✔
A document from the order page by hand: FR, FT, FS with a preview of rows and total ✔ ✔
VAT rates for mainland, Madeira and the Azores, exemption reasons M01-M99 ✔ ✔
Another currency with a rate to the euro, a coupon as a row discount, shipping as a service ✔ ✔
PDF, public link, ATCUD and document number in the order history ✔ ✔
Lost reply: lookup by reference before a retry, no second document ✔ ✔
English and Portuguese interface ✔ ✔
Document automatically by order status — ✔
Credit note for the whole invoice by button or by status — ✔
Communication to the AT automatically and by button — ✔
E-mail to the buyer from TOConline automatically and by button — ✔
Bulk issuing for orders without an invoice, retry of all stopped — ✔
Document journal, filters, totals and CSV export — ✔
Several TOConline companies (up to 3 additional) by store — ✔
Separate exemptions for EU companies and export — ✔

What it looks like

The TOConline box in an order
The “TOConline document” box on the order page: type, number, ATCUD, total, AT status, PDF and link.
TOConline document settings
The “Document” tab: document types, series, VAT region, VAT mode, exemptions, item code.
TOConline automation
The “Automation” tab (Pro): statuses for a document and a credit note, e-mail, AT, EU and export exemptions.

Key points

What the seller gets

The order page gets a “TOConline document” box: the buyer NIF (you can change it and save it for this order), rows with item code, quantity, price, discount and rate, and the total.

What’s in the admin

Extensions → Extensions → Modules → TOConline Invoices: six tabs, “Connection”, “Buyer”, “Document”, “Automation”, “Companies” 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 store address over https.
  • A TOConline account with a company and access to Dados API.
  • A document in TOConline is final once created: it cannot be voided, changed or deleted, and the only correction is a credit note (Pro). For the first orders check the rows and total in the order box before sending.
  • An unknown result (timeout, server error, unreadable reply) stops the document until you decide: the module first looks for the document in TOConline by the order reference and never sends a second one by itself.
  • A credit note is made for the whole invoice only; there are no partial refunds.
  • Stores tied to an additional company stop with an explanation without Pro and never go into the main company.
  • A 0% VAT row needs an exemption reason; without it the module sends nothing. An EU tax number is not checked in VIES, and the NIF only by check digit.

Version history

v1.0.0 Current November 2026

For OpenCart 4.x, 3.x and 2.3: TOConline invoice-receipts, invoices and simplified invoices from the order page, NIF at checkout with validation, ATCUD, PDF and public link, VAT rates for…

Frequently bought with TOConline

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

Full module description

TOConline Invoices for OpenCart 4.x, 3.x and 2.3 issues documents in the Portuguese TOConline service straight from store orders: a button on the order page creates an invoice-receipt (FR), an invoice (FT) or a simplified invoice (FS) in TOConline and shows the document number, ATCUD, PDF and public link.

What you need from TOConline. A TOConline account with a company; a company administrator opens Empresa → Configurações → Dados API, enters the integrator name and e-mail and receives a link (valid for 72 hours) with the client id, secret, OAuth address and API address. The service itself is paid in TOConline under your plan: the module adds no per-document fee.

What the seller gets

The order page gets a “TOConline document” box: the buyer NIF (you can change it and save it for this order), rows with item code, quantity, price, discount and rate, and the total. The button creates the document; the box then shows the type, number, ATCUD, total, AT status and the PDF and “Link” buttons.

An order paid at checkout gets an invoice-receipt (FR) or a simplified invoice (FS) of your choice; an order paid later (cash on delivery, cheque: you set the list of codes) gets an invoice (FT) with a payment term, 15 days by default. A coupon goes as a row discount, shipping as a service. The module compares the document total with the order total before sending and after it; a mismatch is shown in the note.

What’s in the admin

Extensions → Extensions → Modules → TOConline Invoices: six tabs, “Connection”, “Buyer”, “Document”, “Automation”, “Companies” and “Pro”. On the first one you enter the client id, secret, OAuth address and API address from the Dados API page and press “Save and check the connection”: the module runs OAuth, stores the tokens encrypted and shows how many document series it found.

On “Buyer” you turn on the NIF field at checkout and the Portuguese NIF check by check digit: a wrong number is rejected next to the field. On “Document” you set the document type for orders paid at checkout and paid later, the list of “pay later” methods, the payment term, the series prefix (the series must already exist in TOConline), the payment method code, the VAT region (mainland, Madeira, Azores), VAT as in the order, prices with VAT or without VAT, the exemption reason for 0% rows, the row type (Product or Service), the item code (model or SKU) and a note.

The “Automation” and “Companies” tabs are for Pro. Without a key they open with an explanation and disabled fields, breaking nothing.

Pro issues documents on its own: when an order reaches one of the statuses you pick (for example “Processing”), and creates a credit note for the whole invoice by button or at a refund status (“Refunded”). TOConline can e-mail the document to the buyer, and the module can pass it to the AT automatically or by button (the company Portal das Finanças login is needed; it is stored encrypted). Separate exemption reasons are set for EU companies and export.

The “TOConline documents” journal in the Sales menu shows each document with its status, ATCUD and AT status in words, filters by status, period and company, and period totals. “Orders without an invoice” gives bulk issuing for past orders, “Retry all stopped” repeats everything stopped, and “Download CSV” exports the journal. Up to three additional TOConline companies are tied to OpenCart stores.

How it works, step by step

  1. Install the archive for your OpenCart version and install the module in Extensions → Modules.
  2. In TOConline open Empresa → Configurações → Dados API, enter the integrator name and e-mail and copy the client id, secret, OAuth address and API address from the link you receive.
  3. On the “Connection” tab enter these values and press “Save and check the connection”.
  4. On “Buyer” turn on the NIF field; on “Document” pick the document type, series, VAT region and VAT mode.
  5. Open an order, check the rows and the total and press the button that creates the document.
  6. For Pro: a key or the trial on the “Pro” tab, then “Automation”.

Under the hood

  • TOConline Open API (api-docs.toconline.pt): OAuth authorization_code with token refresh; documents (commercial_sales_documents), PDF (url_for_print), public link, ATCUD, series, exemption reasons, sending to the AT and e-mail to the buyer. Tokens and the secret are stored encrypted.
  • The document total equals the order total: rows, a coupon as a row discount, shipping as a service and VAT are passed with exact values; the TOConline total is checked against the order.
  • Background work (retry after temporary failures, statuses, bulk actions) runs from the OpenCart 4 scheduler every hour and from page opens; a server cron at the address on the “Automation” tab every 5 minutes makes it faster.
  • A TOConline failure (5xx, not JSON, timeout, 429) creates no duplicate: a retry looks for the document by the order reference. One document is never issued twice.
  • The interface is in English and Portuguese; the document is in the order language.

How to install

  1. Extensions → Installer: upload the archive for your version without renaming it (OpenCart 4: cc_toconline.ocmod.zip, 3.x: cc_toconline-oc3.ocmod.zip, 2.3: cc_toconline-oc23.ocmod.zip; for 2.3 copy the contents of upload/ into the store root).
  2. For 3.x and 2.3: Extensions → Modifications → Refresh.
  3. Extensions → Modules → TOConline Invoices: install it and open the settings.
  4. On the “Connection” tab enter the data from the Dados API page and press “Save and check the connection”.
  5. For Pro: enter a key or start the trial on the “Pro” tab.

Selling on WooCommerce? There is a separate plugin for it: Invoices with TOConline for WooCommerce.

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 TOConline module?

No, it is an independent TOConline integration by CatCode. TOConline is a trademark of its owner.

What do I need to start?

A TOConline account with a company and the Empresa → Configurações → Dados API page: client id, secret, OAuth address and API address.

Can I delete an issued document?

No: a TOConline document is final once created. It is corrected with a credit note (Pro: a button in the order or a refund status).

What happens with a buyer without an NIF?

The document goes to a final consumer ("Consumidor final"). If an NIF is entered but its check digit is wrong, the buyer sees an error next to the field at checkout.

What if the order has 0% VAT?

Pick an exemption reason (M01-M99) in the settings. Without it the document is not issued and the module explains why.

What if TOConline did not answer?

The module stops the document and looks for it in TOConline by the order reference. If there is none, you decide: send again or remove. It never sends a second document by itself.

Can documents be issued in bulk?

Yes, in Pro: for orders without an invoice; "Retry all stopped" 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 for life?

Yes, for OpenCart it is one payment and a licence for life, for two sites.

What happens after the trial?

Pro turns off, documents queued by status stop with a reason, 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