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


GLS CEE Shipping — a shipping module for GLS in OpenCart: home delivery and ParcelShop / ParcelLocker (MyGLS)

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

Fakturoid for OpenCart 4.x — invoices from the order page
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
- 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.
- 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.
- Install the archive for your OpenCart version and install the module in the «Modules» section.
- Paste the three values on the «Connection» tab and press «Save and check the connection».
- Choose the číselná řada and the payment methods on the «Connection» and «Invoice» tabs.
- Open an order and press «Create the invoice»: the invoice appears in iDoklad and the PDF opens from the order.
- 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
- OpenCart 4: Extensions → Installer, upload cc_idoklad.ocmod.zip without renaming it.
- OpenCart 3.x: Extensions → Installer, upload cc_idoklad-oc3.ocmod.zip, then Extensions → Modifications → Refresh.
- 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.
- Extensions → Modules → iDoklad Invoices (CatCode): install it and open the settings.
- Paste the Application ID, Client ID and Client Secret and press «Save and check the connection».
- 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.
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.
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.




















