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

Get in touch
OpenCart

iDoklad for OpenCart: invoices from orders, payments and credit notes (Czech Republic)

iDoklad for OpenCart 4.x, 3.x, 2.3 (Czech Republic): invoices from orders, IČO and DIČ at the checkout, PDF; Pro adds invoices by status, payments both ways, credit notes, a 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 · module languages: English, Čeština
PHP
7.0 or newer
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
15.11.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
Agenda connection (Application ID, Client ID, Client Secret) with the agenda name and IČO ✔ ✔
IČO and DIČ fields at the checkout with a check digit test (CZ/SK) ✔ ✔
Invoice from an order with one button, a row preview and the VAT rates of the agenda ✔ ✔
iDoklad contact created or reused, language and currency of the order ✔ ✔
PDF of the invoice from the order ✔ ✔
Duplicate protection and retry after a lost answer, error log in the order ✔ ✔
Číselná řada and payment methods from the agenda ✔ ✔
Agendas and číselné řady one up to 3 slots
Invoice at an order status — ✔
Proforma for orders paid later and the invoice from it — ✔
Payment recorded in iDoklad: at the checkout, at a status, by a button — ✔
Payments from iDoklad come back into the order automatically (by the schedule, webhook in addition) — ✔
Credit note for the whole invoice by a button or at a status — ✔
E-mail from iDoklad to the buyer — ✔
Bulk invoicing — ✔
Journal with filters, totals and CSV — ✔
EU without VAT with členění DPH, export, OSS — ✔

What it looks like

IČO and DIČ at the checkout
The fields «Company ID / IČO» and «VAT number / DIČ» at the checkout: a wrong IČO stops with an error next to the field.
The «Invoice» tab
Document language, payment methods, payment term, VAT mode, unit and the note of the invoice.
Invoice preview in the order
The iDoklad panel in the order: the IČO and DIČ of the buyer, rows with prices including VAT, the total and the «Create the invoice» button.

Key points

What the buyer and the store get

At the checkout the buyer sees the optional fields «Company ID / IČO» and «VAT number / DIČ».

What is in the admin

Extensions → Extensions → Modules → iDoklad Invoices (CatCode): tabs «Connection», «Buyer», «Invoice», «Automation», «Agendas» 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; PHP 7.0+ for 2.3, the cURL extension.
  • An iDoklad agenda with API access is required. Each store registers its own application in the iDoklad Developer portal and pastes its Application ID together with the Client ID and Client Secret of the agenda; a step-by-step hint is in the settings.
  • The iDoklad webhook is only an addition to the check by the schedule: the store owner creates the webhook definition in their own Developer portal application (the store address and a secret) and presses «Save and subscribe the agenda». Without the webhook, payments come back through the check by the schedule.
  • The payment check goes in portions of up to 40 documents per request to the invoice list of the agenda, to stay inside the request limits of the iDoklad API. A payment that iDoklad showed in its list late is picked up by the next pass.
  • On OpenCart 4 the check and the queue run through the built-in scheduler once an hour; on 3.x and 2.3, and for a faster run, call the cron URL from the settings on your hosting every 5 minutes.
  • The invoice is made in the agenda with its VAT rates. An agenda that is not a VAT payer gets invoices without VAT whatever the settings are.
  • The order status after a payment from iDoklad is written directly, without an e-mail to the buyer and without OpenCart core events.
  • An additional agenda or a second číselná řada in the Pro slots is connected with its own Client ID and Secret; the module continues the numbering of the series from the last number.

Version history

v1.0.0 Current 15.11.2026

For OpenCart 4.x, 3.x and 2.3: invoices from orders in iDoklad through API v3, contacts with IČO and DIČ, the VAT rates of the agenda, coupon and shipping in the total, IČO and DIČ fields…

Frequently bought with iDoklad

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

Full module description

iDoklad Invoices for OpenCart 4.x, 3.x and 2.3 creates Czech invoices in iDoklad from the orders of your store through the iDoklad API v3. One «Create the invoice» button in the order shows the rows with prices including VAT and sends the document to your iDoklad agenda; the buyer is saved as an iDoklad contact with IČO and DIČ, and the PDF of the invoice opens right from the order.

What the buyer and the store get

At the checkout the buyer sees the optional fields «Company ID / IČO» and «VAT number / DIČ». The module tests the check digit of the IČO and the form of the DIČ for the Czech Republic and Slovakia and shows an error next to the field; for a buyer from another country the IČO is not judged. The IČO and DIČ go into the contact and the invoice.

The invoice comes in the language of the order (Czech when iDoklad does not have it), in the currency of the order with the rate of iDoklad, with the due date from the settings. The PDF opens from the order; in Pro iDoklad can e-mail each document itself with the template of your agenda.

Payments made in iDoklad come back into the order automatically: the module checks unpaid invoices and proformas by the schedule, and the iDoklad webhook works in addition to that. The status changes once and never goes back.

What is in the admin

Extensions → Extensions → Modules → iDoklad Invoices (CatCode): tabs «Connection», «Buyer», «Invoice», «Automation», «Agendas» and «Pro». Paste the Application ID from the iDoklad Developer portal, the Client ID and the Client Secret of your agenda and press «Save and check the connection»: the module shows the name of the agenda, the IČO, whether it is a VAT payer, and the number of numbering series. The Client ID and Secret are stored encrypted and never shown again.

The «Invoice» tab sets the document language, the methods paid later (cod and cheque by default), the payment methods (způsob úhrady) of your agenda, the payment term in days, the VAT mode, the unit and the note. VAT rates come from the agenda (21, 12 and 0 %); a coupon goes into the row price, shipping and fees carry the remaining tax, and the total is compared with the order.

The order page gets an «iDoklad invoice» panel: the IČO and DIČ of the buyer (editable by hand for this order), the preview of the rows and the create button. After that the panel shows the number, the total, the status «unpaid» or «paid» and a PDF button; in Pro also e-mail, credit note and record payment buttons. When a document cannot be created, the panel shows the reason and the buttons to retry or to delete the row.

The «Automation» tab (Pro) creates the invoice at chosen statuses, makes a proforma for orders paid later, records the payment in iDoklad, makes a credit note at a status and turns on payments from iDoklad with the order status «paid in iDoklad». The journal with filters, totals for a period and CSV opens from the settings.

How it works, step by step

  1. Register a free developer account at developer.idoklad.cz and create an application of the type Client Credentials: its Application ID is needed by the module.
  2. In iDoklad open Settings, Applications, API and generate the Client ID and Client Secret of the agenda. The user who generated them must have full rights in the agenda.
  3. Install the archive for your OpenCart version and install the module in the «Modules» section.
  4. Paste the three values on the «Connection» tab and press «Save and check the connection».
  5. Choose the číselná řada and the payment methods on the «Connection» and «Invoice» tabs.
  6. Open an order and press «Create the invoice»: the invoice appears in iDoklad and the PDF opens from the order.
  7. In Pro turn on automatic invoices, payments, credit notes and payments from iDoklad.

Under the hood

  • iDoklad API v3: contacts, invoices, proformas, credit notes, payments, PDF, mails, webhooks; the OAuth token (client credentials) is cached encrypted.
  • Duplicate protection: if the answer of iDoklad is lost, the document is looked up by the reference in its description before a new try; when iDoklad cannot confirm, the module stops and the owner decides.
  • Row prices with VAT, the VAT rates of the agenda, a coupon in the row price, shipping and fees with the remaining tax, and a total check against the order. The rounding of the iDoklad agenda is not part of the sum.
  • A contact is created or reused by IČO, e-mail or name; empty optional fields are not sent to iDoklad.
  • When iDoklad does not answer, the document goes into a queue marked «Will try again» with the reason; errors are visible in the order and in the journal.
  • The webhook accepts a signed request (HMAC over the raw body), a repeated delivery makes no duplicate, and without Pro the webhook is closed.
  • After the trial ends the Pro functions switch off and the free part keeps working.
  • The interface is in English and Czech.

Installation

  1. OpenCart 4: Extensions → Installer, upload cc_idoklad.ocmod.zip without renaming it.
  2. OpenCart 3.x: Extensions → Installer, upload cc_idoklad-oc3.ocmod.zip, then Extensions → Modifications → Refresh.
  3. OpenCart 2.3: Extensions → Installer, upload cc_idoklad-oc23.ocmod.zip (FTP settings in System → Settings → FTP are required; otherwise unpack the archive and upload the contents of the upload/ folder to the store root by hand), then Extensions → Modifications → Refresh.
  4. Extensions → Modules → iDoklad Invoices (CatCode): install it and open the settings.
  5. Paste the Application ID, Client ID and Client Secret and press «Save and check the connection».
  6. For Pro: paste the licence 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 an official iDoklad module?

No, it is an independent integration through the public API. iDoklad is a trademark of its owner.

What do I need from iDoklad?

An account with an agenda and API access, and a free developer account at developer.idoklad.cz for the Application ID, plus the Client ID and Client Secret of the agenda.

Is the invoice created automatically?

In the free version with one button in the order. Automatically by order status in Pro.

Do payments made in iDoklad show up in the order?

Yes, in Pro: payments made in iDoklad come back into the order automatically through the check by the schedule; the iDoklad webhook works in addition to it.

What about an agenda that is not a VAT payer?

Invoices come without VAT. For a VAT payer the rates 21, 12 and 0 % come from the agenda.

How do IČO and DIČ work at the checkout?

The module tests the check digit of the IČO and the form of the DIČ for the Czech Republic and Slovakia, and does not judge another country. The fields are optional.

Can I make a credit note?

Yes, in Pro: a credit note for the whole invoice by a button in the order or at a status.

What if iDoklad does not answer?

The document goes into a queue and is retried, and before a new try the module looks for an already created document by the reference, so there is no duplicate.

Which OpenCart versions are supported?

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, 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