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

Get in touch
WooCommerce

Invoices with TOConline for WooCommerce — TOConline invoices from orders, NIF (Portugal)

A TOConline invoice from every WooCommerce order: the customer by NIF, VAT of the mainland, Madeira and the Azores, PDF; Pro adds documents by status, credit notes, the AT, a document list.

Download Free
Pro · one-year licence Staging copies are included. The more sites, the cheaper each one
Compatibility
WordPress 6.4+ · WooCommerce 8.6+ (HPOS, block checkout) · PHP 7.4+ · currency EUR · languages: English, Português (in Pro)
Licence
a site + a staging copy, annual
Trial
7 days, no card, one per site
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
OAuth connection: Client ID, Secret (encrypted), OAuth and API addresses ✔ ✔
"TOConline" box in the order: rows, VAT rates and total before sending ✔ ✔
One document per order: FR for orders paid at the checkout, FT or FS for orders paid later ✔ ✔
Customer by NIF: found in TOConline or created, a final consumer without NIF, check-digit test ✔ ✔
Document number in the order and its notes, PDF in one click ✔ ✔
Checks before sending: sum of rows, negative fee, 0% without an exemption reason ✔ ✔
VAT: from the order, prices with VAT or an exempt seller; mainland, Madeira, Azores; codes M01–M99 ✔ ✔
Series FR/FT/FS, payment term, means of payment, a note on the document ✔ ✔
No second document: look-up by reference after a lost answer ✔ ✔
Document made automatically at an order status, with a queue and retries — ✔
Bulk action "Create TOConline documents" — ✔
Credit notes for the whole order by button or at a status — ✔
Communication of documents to the AT through TOConline — ✔
E-mail of the document to the buyer from TOConline — ✔
Up to 3 extra TOConline companies — ✔
Document list, "Totals differ", CSV export of a period — ✔
Translations: Português (Portugal) — ✔
Updates from catcode.com.ua — ✔

What it looks like

The TOConline box in a WooCommerce order
The order screen: the rows, VAT rates and total that will go into the document, the NIF field and the “Create the document” button.
A created document
The TOConline box after creation: document type, number, total, status and the PDF button; in Pro, a credit note button for the whole order.
Document settings
WooCommerce → TOConline: document types for orders paid at the checkout and later, series, payment term, VAT mode, VAT region, exemption reason.

Key points

What happens to an order

The order gets a “TOConline” box: the rows that will go into the document, the VAT rate of each row, the total with VAT and a NIF field for this order.

Settings

WooCommerce → TOConline: enter the Client ID, Secret, OAuth address and API address from the TOConline e-mail and press “Check the connection and load the series”.

What Pro adds

Documents by status. Choose the statuses (for example “Completed”) and every order gets its document in the background, once.

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

  • WordPress 6.4+, WooCommerce 8.6+ (HPOS, block checkout), PHP 7.4+.
  • A TOConline company with an active invoicing (GC) plan and API access through the accountant.
  • Shop currency: euro (EUR); the shop address on https.

Version history

v1.0.0 Current

November 2026.

Frequently bought with Invoices 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

Invoices with TOConline for WooCommerce creates an invoice (FT), invoice-receipt (FR) or simplified invoice (FS) in the Portuguese service TOConline from a shop order. A button on the order screen creates the document, the customer is found in TOConline by NIF or created, and the document number and PDF stay with the order. The plugin uses the API of your own TOConline company and is made for shops in Portugal (mainland, Madeira, Azores).

What you need in TOConline. A TOConline company with an active invoicing (GC) plan and API access, which the company gets through its certified accountant (Contabilista Certificado). In TOConline: Empresa → Configurações → Dados API → add the integrator; an e-mail brings a link (valid for 72 hours) with the client id, secret, OAuth address and API address. The shop sells in euros (EUR).

What happens to an order

The order gets a “TOConline” box: the rows that will go into the document, the VAT rate of each row, the total with VAT and a NIF field for this order. An order paid at the checkout gets an invoice-receipt (FR) or a simplified invoice (FS), as you choose; an order paid later (bank transfer, cheque, cash on delivery) gets an invoice (FT) with a payment term.

A buyer with a NIF is found in TOConline by the NIF or created; without a NIF the document is made for a final consumer. The NIF comes from the order field (_billing_nif by default, the key can be changed) or is typed in for one order; the check digit is tested. Coupons are taken into the row prices, shipping and fees get their own rows. The document number is kept with the order and in its notes, and the PDF is one click away.

TOConline makes a document final the moment it is created, so the plugin checks the order before it sends anything: the rows add up to the order total, there is no negative fee, a 0% row has its exemption reason, no row carries two taxes. If a check fails, no document exists and the box shows the reason. A double click or a second tab cannot make a second document; when an answer from TOConline is lost, the next try first looks for the document by the reference WC-.

Settings

WooCommerce → TOConline: enter the Client ID, Secret, OAuth address and API address from the TOConline e-mail and press “Check the connection and load the series”. The plugin loads the document series and the VAT rates of the region. Below are the document types, series, payment term, VAT mode, region, the exemption reason for 0% rows, the means of payment, a note for the document and the NIF field.

VAT comes from the order (WooCommerce taxes), or prices already hold VAT at the rate you set, or the seller is exempt: then every row gets 0% and the chosen exemption reason. The access token (4 hours) and the refresh token (8 hours) are stored encrypted and renewed by themselves. The debug mode writes a WooCommerce log without secrets or tokens.

What Pro adds

Documents by status. Choose the statuses (for example “Completed”) and every order gets its document in the background, once. When TOConline does not answer, the document is tried again with a growing pause, up to eight times, and looked for by its reference before each retry. The bulk action “Create TOConline documents” in the orders list does the same for the selected orders.

Credit notes. A credit note (NC) for the whole order from a button in the order or at a status (for example “Refunded”), with its own series.

Communication to the AT. Each document is communicated to the Autoridade Tributária through TOConline: automatically right after it is made, or with a button. A Portal das Finanças sub-user for the communication of documents is needed; the password is stored encrypted.

E-mail to the buyer. TOConline sends the document to the buyer itself: automatically or with a button.

Up to three extra companies. Each has its own access details and series prefix; the company can be chosen in the order box. A credit note goes to the company of its document.

Document list. Every document of the shop with the filters “In progress”, “Stopped”, “Created”, “Totals differ”, “Credit notes”; stopped ones with their reason and Retry; “Totals differ” shows documents whose TOConline total differs from the order; the number of stopped ones in the menu; a CSV export of a period for your accountant.

Languages and updates. Interface: English and Português (Portugal); updates from catcode.com.ua.

Limits

  • A document in TOConline is final once created: it cannot be changed or deleted, and a mistake is corrected with a credit note. For the first orders, check the rows and the total in the order box.
  • A credit note covers the whole order; a partial refund is entered in TOConline.
  • Documents can be created only while the invoicing (GC) plan of the TOConline company is active.
  • The shop sells in euros (EUR).
  • A row with 0% VAT needs an exemption reason; without one the plugin sends nothing.
  • The VAT rate of another EU country (OSS) may be refused by TOConline in a Portuguese region: the reason is shown in the note.
  • A gift card or a store credit that changes the total outside the order rows stops the sending: the rows must add up to the order total.
  • After a lost answer, a retry waits a minute so that TOConline can finish the document, and only then looks for it.
  • Which document type, series and exemption are right for your shop is decided together with your accountant: the plugin gives no tax advice.

How it works, step by step

  1. Install and activate the plugin (WooCommerce must be active).
  2. In TOConline (Empresa → Configurações → Dados API) add the integrator and copy the client id, secret, OAuth and API addresses from the e-mail.
  3. In WooCommerce → TOConline enter them and press “Check the connection and load the series”.
  4. Choose the document types, series, VAT mode and region and save.
  5. Open an order, check the rows and the total and press “Create the document”.
  6. In Pro, switch on documents by status, credit notes, the AT and e-mail.

Under the hood

  • TOConline Open API (api-docs.toconline.pt): OAuth authorization_code with token refresh; requests leave your server only after the access details are saved and only for the actions you start or switch on.
  • The data TOConline needs for a document is sent: NIF, the buyer’s name or company and e-mail, billing address and country, the order rows with price and VAT rate, order number, dates and means of payment.
  • The secret, the tokens and the Portal das Finanças password (Pro) are stored encrypted and never printed in the browser.
  • Pro documents by status and retries run in the background through WP-Cron every 5 minutes.

How to install

  1. Plugins → Add New → Upload Plugin: choose the zip and activate.
  2. WooCommerce → TOConline: enter the details from the TOConline e-mail and press “Check the connection and load the series”.
  3. Choose the series, document types and VAT mode and save.
  4. For Pro: paste the licence key or start the trial in the “Licence” section of the same page.

Selling on OpenCart? There is a separate module for it: TOConline for OpenCart (4.x, 3.x, 2.3).

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 plugin?

No, it is an independent integration made by CatCode. TOConline is a trademark of its owner; the plugin is not affiliated with or endorsed by TOConline.

How do I get API access to TOConline?

Through your certified accountant (Contabilista Certificado): in TOConline, Empresa → Configurações → Dados API, the integrator is added and an e-mail brings a link with the client id, secret, OAuth address and API address.

Can a created document be deleted?

No: a document created through the API is final. A mistake is corrected with a credit note (Pro: a button in the order or a refund status). That is why the plugin checks the order before it sends anything.

What happens with a buyer without a NIF?

The document is made for a final consumer. If a NIF is entered but its check digit is wrong, no document is created and the box shows the reason.

What if TOConline does not answer?

The status says the document may have been made. The next try first looks for it by the order reference and keeps it if it is there. If the look-up is not possible, check TOConline yourself and press "It is not in TOConline".

Can documents be made automatically?

Yes, in Pro: at the order statuses you choose, in the background, with retries. By hand from the order box it works in the free version too.

Is the document communicated to the AT?

In Pro: through TOConline, automatically or with a button, with a Portal das Finanças sub-user.

What happens after the trial?

Pro switches off, the queue by status stops with a reason, and the free part keeps working: connection, a document from the order, NIF, VAT, PDF.

How many sites does a key cover?

One key covers two sites: the shop and a test copy.

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