
iDoklad для OpenCart — фактури з замовлень, оплати й dobropis (Чехія)
iDoklad для OpenCart 4.x, 3.x, 2.3 (Чехія): фактури з замовлень, IČO і DIČ на касі, PDF; Pro додає фактури за статусом, оплати в обидва боки, dobropis, журнал. Ліцензія назавжди.
- Сумісність
- OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · мови модуля: English, Čeština
- PHP
- 7.0 і новіший
- Версія
-
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3) - Ліцензія
- сайт + тестова копія, назавжди
- Тріал
- 7 днів, без картки, один на сайт
- Оновлено
- 15.11.2026
Що є в Free,
а що дає Pro
Безкоштовна версія працює без обмеження в часі. Pro додає решту функцій з таблиці.
Головне про модуль
Що отримують покупець і магазин
На касі в покупця зʼявляються необовʼязкові поля «Company ID / IČO» і «VAT number / DIČ».
Що в адмінці
Extensions → Extensions → Modules → iDoklad Invoices (CatCode): вкладки «Connection», «Buyer», «Invoice», «Automation», «Agendas» і «Pro».

Тріал стартує, коли ви попросите
Свіжий інстал — безкоштовна версія, нічого не вмикається само. Кнопка «Спробувати Pro 7 днів» → e-mail → ключ одразу у вікні і листом.

Один ключ — сайт і тестова копія
Переносите сайт — відв’яжіть ліцензію на старому домені й активуйте на новому самі. Тестова копія (staging., dev.) працює з тим самим ключем і місця сайту не займає. Для студій — ключі на 5, 25 сайтів або без обмежень.
Технічні вимоги
OpenCart 4.0.2.x–4.1.x, 3.0.x або 2.3.0.2; PHP 7.0+ для 2.3, розширення cURL.
Потрібна агенда iDoklad з доступом до API. Кожен магазин реєструє власний застосунок у Developer portal iDoklad і вставляє його Application ID разом з Client ID і Client Secret агенди; покрокова підказка є в налаштуваннях.
Вебхук iDoklad потрібен лише як додаток до перевірки за розкладом: власник магазину створює визначення вебхука у своєму застосунку Developer portal (адреса магазину й secret) і натискає «Save and subscribe the agenda». Без вебхука оплати повертаються перевіркою за розкладом.
Перевірка оплат іде порціями до 40 документів за один запит до списку фактур агенди, щоб вкластись у ліміти запитів API iDoklad. Оплата, яку iDoklad показав у списку із запізненням, підхоплюється наступним проходом.
Для OpenCart 4 перевірка й черга працюють через вбудований планувальник раз на годину; на 3.x і 2.3, а також для швидшої роботи, викликайте cron-URL з налаштувань на хостингу кожні 5 хвилин.
Фактура виставляється в агенді з її ставками ДПГ. Агенда, що не є платником ДПГ, отримує фактури без ДПГ незалежно від налаштувань.
Статус замовлення після оплати з iDoklad записується напряму, без листа покупцю й без подій ядра OpenCart.
Додаткову агенду або другу číselnou řadu в слотах Pro підключають власними Client ID і Secret; нумерацію серії модуль продовжує від останнього номера.
Історія версій
Для OpenCart 4.x, 3.x і 2.3: фактури з замовлень в iDoklad через API v3, контакти з IČO і DIČ, ставки ДПГ агенди, купон і доставка в сумі, поля IČO і DIČ на касі з перевіркою, číselná řada…
Разом з iDoklad купують


GLS CEE Shipping — модуль доставки для GLS в OpenCart: на адресу і в ParcelShop / ParcelLocker (MyGLS)

Знижки від суми та N+1 для OpenCart

Fakturoid для OpenCart 4.x — фактури зі сторінки замовлення
Повний опис модуля
iDoklad Invoices для OpenCart 4.x, 3.x і 2.3 створює чеські фактури в iDoklad із замовлень вашого магазину через API iDoklad v3. Одна кнопка «Create the invoice» у замовленні показує рядки з цінами з ДПГ і відправляє документ у вашу агенду iDoklad; покупець зберігається як контакт iDoklad з IČO і DIČ, а PDF фактури відкривається прямо із замовлення.
Що отримують покупець і магазин
На касі в покупця зʼявляються необовʼязкові поля «Company ID / IČO» і «VAT number / DIČ». Модуль перевіряє контрольну цифру IČO і форму DIČ для Чехії та Словаччини й показує помилку біля поля, а для покупця з іншої країни IČO не перевіряється. IČO і DIČ потрапляють у контакт і фактуру.
Фактура виходить мовою замовлення (чеською, якщо iDoklad цієї мови не має), у валюті замовлення з курсом iDoklad, з датою сплати за налаштуванням. PDF відкривається із замовлення; у Pro iDoklad може сам розсилати кожен документ листом за шаблоном вашої агенди.
Платежі, проведені в iDoklad, повертаються в замовлення автоматично: модуль перевіряє неоплачені фактури й zálohy за розкладом, а вебхук iDoklad працює додатково до цього. Статус змінюється один раз і ніколи не відкочується назад.
Що в адмінці
Extensions → Extensions → Modules → iDoklad Invoices (CatCode): вкладки «Connection», «Buyer», «Invoice», «Automation», «Agendas» і «Pro». Вставте Application ID із Developer portal iDoklad, Client ID і Client Secret вашої агенди та натисніть «Save and check the connection»: модуль покаже назву агенди, IČO, чи є вона платником ДПГ, і кількість číselných řad. Client ID і Secret зберігаються зашифрованими й більше не показуються.
На вкладці «Invoice» задаються мова документа, методи, що оплачуються пізніше (за замовчуванням cod і cheque), способи úhrady з вашої агенди, строк оплати в днях, режим ДПГ, одиниця виміру й примітка. Ставки ДПГ беруться з агенди (21, 12 і 0 %); купон враховується в ціні рядка, доставка й збори йдуть з залишковим податком, а сума звіряється із замовленням.
На сторінці замовлення зʼявляється панель «iDoklad invoice»: IČO і DIČ покупця (можна виправити вручну для цього замовлення), превʼю рядків і кнопка створення. Після створення панель показує номер, суму, статус «unpaid» або «paid» і кнопку PDF; у Pro — кнопки e-mail, dobropis і запис оплати. Якщо документ не вдалося створити, панель показує причину й кнопки «повторити» або «видалити рядок».
Вкладка «Automation» (Pro) дозволяє створювати фактуру за вибраними статусами, робити zálohovou fakturu для замовлень з оплатою пізніше, записувати оплату в iDoklad, виставляти dobropis за статусом і вмикати повернення оплат з iDoklad зі статусом «оплачено в iDoklad». Журнал з фільтрами, підсумками за період і CSV відкривається з налаштувань.
Як це працює, крок за кроком
- Зареєструйте безкоштовний акаунт розробника на developer.idoklad.cz і створіть застосунок типу Client Credentials: його Application ID потрібен модулю.
- В iDoklad відкрийте Settings, Applications, API і згенеруйте Client ID та Client Secret агенди. Користувач, що їх створив, має мати повні права в агенді.
- Встановіть архів для вашої версії OpenCart і встановіть модуль у розділі «Modules».
- Вставте три значення на вкладці «Connection» і натисніть «Save and check the connection».
- Оберіть číselnou řadu й способи úhrady на вкладках «Connection» та «Invoice».
- Відкрийте замовлення й натисніть «Create the invoice»: фактура зʼявиться в iDoklad, а PDF відкриється з замовлення.
- У Pro увімкніть автоматичні фактури, оплати, dobropis і повернення оплат з iDoklad.
Що під капотом
- API iDoklad v3: контакти, фактури, zálohové faktury, dobropisy, платежі, PDF, листи, вебхуки; токен OAuth (client credentials) кешується зашифрованим.
- Захист від дубля: якщо відповідь iDoklad загубилась, перед новою спробою документ шукається за референсом в описі; якщо iDoklad не може підтвердити, модуль зупиняється, а власник вирішує.
- Ціни рядків з ДПГ, ставки агенди, купон у ціні рядка, доставка й збори з залишковим податком, контроль суми із замовленням. Заокруглення агенди iDoklad у суму не входить.
- Контакт створюється або перевикористовується за IČO, email чи назвою; порожні необовʼязкові поля до iDoklad не надсилаються.
- Якщо iDoklad не відповів, документ іде в чергу з позначкою «Will try again» і причиною; помилки видно в замовленні й журналі.
- Вебхук приймає підписаний запит (HMAC за сирим тілом), повтор доставки не дає дубля, без Pro вебхук закритий.
- Після закінчення пробного періоду Pro-функції вимикаються, а безкоштовна частина працює далі.
- Інтерфейс англійською й чеською.
Встановлення
- OpenCart 4: Extensions → Installer, завантажте cc_idoklad.ocmod.zip, не перейменовуючи його.
- OpenCart 3.x: Extensions → Installer, завантажте cc_idoklad-oc3.ocmod.zip, потім Extensions → Modifications → Refresh.
- OpenCart 2.3: Extensions → Installer, завантажте cc_idoklad-oc23.ocmod.zip (потрібні налаштування FTP у System → Settings → FTP; інакше розпакуйте архів і залийте вміст теки upload/ у корінь магазину вручну), потім Extensions → Modifications → Refresh.
- Extensions → Modules → iDoklad Invoices (CatCode): встановіть і відкрийте налаштування.
- Вставте Application ID, Client ID і Client Secret та натисніть «Save and check the connection».
- Для Pro: вставте ключ ліцензії або запустіть пробний період на вкладці «Pro».
Питання
про модуль
Не знайшли відповідь? Напишіть у Telegram — відповімо протягом робочого дня.
Це офіційний модуль iDoklad?
Ні, це незалежна інтеграція через публічний API. iDoklad є торговою маркою свого власника.
Що потрібно від iDoklad?
Акаунт із агендою й доступом до API, безкоштовний акаунт розробника на developer.idoklad.cz для Application ID та Client ID з Client Secret агенди.
Фактура створюється сама?
У безкоштовній версії — однією кнопкою в замовленні. Автоматично за статусом замовлення — у Pro.
Чи зʼявляються оплати з iDoklad у замовленні?
Так, у Pro: оплати, зроблені в iDoklad, повертаються в замовлення автоматично за перевіркою за розкладом; вебхук iDoklad працює додатково до неї.
Що з агендою, яка не платник ДПГ?
Фактури виходять без ДПГ. Для платника ДПГ ставки 21, 12 і 0 % беруться з агенди.
Як працює IČO і DIČ на касі?
Модуль перевіряє контрольну цифру IČO і форму DIČ для Чехії та Словаччини, а для іншої країни не судить. Поля необовʼязкові.
Чи можна зробити dobropis?
Так, у Pro: dobropis на всю фактуру кнопкою в замовленні або за статусом.
Що буде, якщо iDoklad не відповів?
Документ іде в чергу й повторюється, а перед новою спробою модуль шукає вже створений документ за референсом, тож дубля не буде.
Які версії OpenCart підтримуються?
OpenCart 4.0.2.x–4.1.x, 3.0.x і 2.3.0.2: три окремі архіви в одному продукті.
Ліцензія назавжди?
Так, для OpenCart це одна оплата і ліцензія назавжди, на два сайти.
Що буде після пробного періоду?
Pro вимикається, безкоштовна частина працює далі.
Поки що жодного відгуку. Будьте першим.
Поки питань немає. Запитай — ми відповімо протягом 24 годин.
Не той варіант, що шукаєте?
Робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—




















