
Holded для OpenCart — рахунки-фактури із замовлень, кредит-ноти, NIF/CIF і склад (Іспанія)
Holded для OpenCart 4.x, 3.x, 2.3 (Іспанія): рахунки зі сторінки замовлення безкоштовно, у Pro — за статусом, кредит-ноти, оплати, склад, журнал. Ліцензія назавжди.
- Сумісність
- OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · мова інтерфейсу: English, Español
- Версія
-
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3) - Ліцензія
- сайт + тестова копія, назавжди
- Тріал
- 7 днів, без картки, один на сайт
- Оновлено
- листопад 2026
Що є в Free,
а що дає Pro
Безкоштовна версія працює без обмеження в часі. Pro додає решту функцій з таблиці.
Головне про модуль
Що отримує продавець
На сторінці замовлення зʼявляється блок «Holded»: контакт (за e-mail покупця, знайдений або створений), таблиця рядків з кодом товару, кількістю, ціною без податку, знижкою й податком Holded та підсумок замовлення.
Що в адмінці
Extensions → Extensions → Modules → Holded Invoices: сім вкладок «Connection», «Invoice», «Buyer», «Automation», «Stock», «Stores» і «Licence».

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

Один ключ — сайт і тестова копія
Переносите сайт — відв’яжіть ліцензію на старому домені й активуйте на новому самі. Тестова копія (staging., dev.) працює з тим самим ключем і місця сайту не займає. Для студій — ключі на 5, 25 сайтів або без обмежень.
Технічні вимоги
OpenCart 4.0.2.x–4.1.x, 3.0.x або 2.3.0.2; розширення cURL; адреса магазину за https.
Акаунт Holded і ключ API з правами зі списку вище.
Затверджений у Holded рахунок остаточний. Затвердження вимкнене за замовчуванням: документи лишаються чернетками, і ви перевіряєте їх у Holded. Як Holded передає затверджений рахунок у VeriFactu, налаштовується в Holded: модуль цього не змінює, а серію, позначену в Holded як виключену з VeriFactu, показує біля вибору серії.
Holded лічить виклики API за місяць на акаунт: рахунок коштує 2–4 виклики, кожен крок Pro (затвердження, читання, e-mail, платіж, рух складу по рядку) ще один. Списки податків, серій і складів зберігаються годину, щоб економити виклики; залишок викликів модуль читає із заголовка відповіді Holded.
Якщо в магазині ще працює інший конектор Holded, документи за тими самими замовленнями можуть задвоїтися.
Склад: залишок, чия зміна не підтвердилася відповіддю Holded, повторно не надсилається (рядок називає SKU для перевірки); перший раз, коли товар зіставлено, кількість у OpenCart стає кількістю з Holded; товари з варіантами в Holded не чіпаються.
Магазини з окремим ключем: податки зіставляються лише за відсотком, береться серія за замовчуванням, платежі й склад ведуться тільки для основного акаунта.
Кредит-нота виписується лише на весь рахунок, часткових повернень нема.
Історія версій
Перший випуск для OpenCart 4.x, 3.x і 2.3.
Разом з Holded купують


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

Billin Invoices для OpenCart — рахунки й чеки Billin (TS Facturas) із замовлень

Кинуті кошики для OpenCart 2.3, 3.x і 4.x
Повний опис модуля
Holded Invoices для OpenCart 4.x, 3.x і 2.3 створює рахунки-фактури в іспанському сервісі Holded прямо із замовлень магазину: кнопка на сторінці замовлення знаходить або створює покупця як контакт Holded, передає рядки замовлення з вашими ставками IVA, читає назад суму документа, порівнює її із замовленням і дає PDF.
Що потрібно від Holded. Акаунт Holded і ключ API, створений у Configuración → Desarrolladores → Credenciales («Agregar API Token», права «Por áreas»). Права для Free: Ventas → Facturas (Full), Ventas → Configuración de facturación (Leer), Contabilidad → Impuestos (Leer), Contactos → Contactos (Full); для Pro ще Contabilidad → Bancos (Leer), Inventario → Productos (Full) і Inventario → Almacenes (Leer). Сам Holded оплачується за вашим тарифом: модуль не додає плати за документи.
Що отримує продавець
На сторінці замовлення зʼявляється блок «Holded»: контакт (за e-mail покупця, знайдений або створений), таблиця рядків з кодом товару, кількістю, ціною без податку, знижкою й податком Holded та підсумок замовлення. Кнопка «Create the invoice in Holded» створює документ; далі в блоці видно тип, номер, суму, статус і кнопки PDF та E-mail (Pro).
Holded створює документ чернеткою, а номер серії (наприклад F260086) зʼявляється після затвердження. У Free чернетку ви перевіряєте й затверджуєте в Holded; у Pro можна вмикати затвердження одразу після створення або натискати «Approve» у замовленні. Купон іде знижкою рядка, доставка — окремим рядком. Модуль читає суму назад із Holded і порівнює із замовленням: якщо вони різні, у примітці видно обидві суми.
Що в адмінці
Extensions → Extensions → Modules → Holded Invoices: сім вкладок «Connection», «Invoice», «Buyer», «Automation», «Stock», «Stores» і «Licence». На першій ви вставляєте ключ API й натискаєте «Save and test the connection»: модуль перевіряє кожне право, яке читає, називає відсутні й показує, скільки ставок ПДВ зіставлено з податками Holded. Ключ зберігається зашифрованим.
На вкладці «Invoice» кожна ставка ПДВ магазину (0, 21, 10 %…) зіставляється з податком продажу Holded: «Automatic» бере єдиний активний податок із такою ставкою, а якщо їх нема або кілька, рахунок зупиняється й називає ставку, яку треба обрати. Там само мова документа (мова замовлення, а коли її нема в Holded — іспанська), код товару (SKU або модель) і внутрішня примітка, яку бачить лише ваша команда в Holded. На вкладці «Buyer» описано, як покупець стає контактом Holded.
Вкладки «Automation», «Stock» і «Stores» — для Pro. Без ключа вони відкриваються з поясненням і вимкненими полями, збережені Pro-значення не показуються.
Pro створює рахунки сам: коли замовлення досягає одного з обраних вами статусів (наприклад «Processing»). Кредит-нота на весь рахунок створюється кнопкою або за статусом повернення («Refunded»): номер рахунку записується в її описі, так вона посилається на рахунок. Платіж реєструється на банківський рахунок Holded свого способу оплати: одразу для оплаченого онлайн замовлення або за обраним статусом для накладеного платежу чи переказу. Holded може сам надіслати затверджений документ покупцю з вашого шаблону листа. NIF/CIF береться з поля покупця на чекауті або вводиться в замовленні, а контакт шукається за ним.
Склад: товари зіставляються за SKU або моделлю, а Holded і OpenCart отримують зміни одне одного, а не перезаписують залишок. Продаж зменшує залишок на обраному складі Holded, кредит-нота повертає його, а те, що змінилося в Holded, додається до кількості в OpenCart. Магазини OpenCart можуть мати окремий ключ Holded. Журнал «Holded invoices» у меню Sales показує кожен документ зі статусом, фільтри, підсумки за місяцями, «Queue invoices» для масового виписування за номерами замовлень і «Retry all stopped».
Як це працює, крок за кроком
- Встановіть архів для вашої версії OpenCart і встановіть модуль у Extensions → Modules.
- У Holded відкрийте Configuración → Desarrolladores → Credenciales, натисніть «Agregar API Token», оберіть «Por áreas», дайте права зі списку на вкладці «Connection» і скопіюйте токен (його показують один раз).
- На вкладці «Connection» вставте ключ і натисніть «Save and test the connection».
- На вкладці «Invoice» перевірте відповідність ставок ПДВ податкам Holded, мову документа й код товару.
- Відкрийте замовлення, перевірте рядки й суму та натисніть «Create the invoice in Holded».
- Для Pro: ключ або пробний період на вкладці «Licence», далі «Automation», «Stock» і «Stores».
Що під капотом
- Holded API v2 (api.holded.com): ключ у заголовку Authorization, JSON; контакти, податки, серії нумерації, рахунки, кредит-ноти, затвердження, платежі, надсилання e-mail, PDF, банківські рахунки, склади й товари. Ключ зберігається зашифрованим.
- Рядки, знижки, купон, доставка й податки передаються окремо, а підсумок Holded читається назад і порівнюється із замовленням. Суми Holded, які приходять іспанськими десятковими (28,05), модуль читає правильно. Податок із зіставлення мусить бути активним податком продажу акаунта: Holded приймає невідомий податок без помилки й рахує 0 %, тому модуль не створює такий рахунок і називає ставку.
- Фонова робота (повтор після тимчасових збоїв, рахунки за статусом, масові дії, склад) іде з планувальника OpenCart 4 щогодини й з відкриттів сторінок; серверний cron за адресою з вкладки «Automation» пришвидшує її.
- Виклик, на який Holded не відповів, не створює дубля: перед повтором модуль шукає документ у Holded за описом «OpenCart order #N» у вікні дат. Таймаут виклику 8 секунд (PDF — 20), помилки полів відповіді 422 показуються словами, а відповідь 429 чекає час із Retry-After.
- Інтерфейс англійською й іспанською, документ — мовою замовлення.
Як встановити
- Extensions → Installer: завантажте архів для вашої версії, не перейменовуючи файл (OpenCart 4 — cc_holded.ocmod.zip, 3.x — cc_holded-oc3.ocmod.zip, 2.3 — cc_holded-oc23.ocmod.zip; для 2.3 вміст теки upload/ копіюється в корінь магазину).
- Для 3.x і 2.3: Extensions → Modifications → Refresh.
- Extensions → Modules → Holded Invoices: встановіть і відкрийте налаштування.
- На вкладці «Connection» вставте ключ API й натисніть «Save and test the connection».
- Для Pro: введіть ключ або запустіть пробний період на вкладці «Licence».
Питання
про модуль
Не знайшли відповідь? Напишіть у Telegram — відповімо протягом робочого дня.
Це офіційний модуль Holded?
Ні, це незалежна інтеграція з Holded від CatCode. Holded — торгова марка її власника.
Що потрібно, щоб почати?
Акаунт Holded і ключ API з правами зі списку на вкладці «Connection».
Чому рахунок без номера?
Holded створює документ чернеткою, а номер серії зʼявляється після затвердження. У Free ви затверджуєте рахунок у Holded, у Pro — кнопкою «Approve» у замовленні або автоматично, якщо ввімкнули затвердження.
Чи можна видалити виписаний документ?
Чернетку можна змінити в Holded. Затверджений рахунок остаточний: його виправляє кредит-нота (Pro: кнопка в замовленні або статус повернення).
Як кредит-нота повʼязана з рахунком?
Модуль записує номер рахунку в описі кредит-ноти. Кредит-нота виписується на весь рахунок, часткових повернень нема.
Що, коли ставці ПДВ не відповідає жоден податок Holded?
Рахунок не створюється, а повідомлення називає ставку, для якої треба обрати податок на вкладці «Invoice».
Що, коли Holded не відповів?
Модуль ставить рядок на повтор і перед ним шукає документ у Holded за описом замовлення, тож другого рахунку не буде.
Чи можна виписувати рахунки масово?
Так, у Pro: «Queue invoices» приймає номери замовлень і діапазони (до 500), «Retry all stopped» повторює зупинені.
Які версії OpenCart?
OpenCart 4.0.2.x–4.1.x, 3.0.x і 2.3.0.2: три окремі архіви в одному товарі.
Ліцензія назавжди?
Так, для OpenCart одна оплата і ліцензія назавжди, на два сайти.
Що буде після пробного періоду?
Pro вимкнеться, рахунки в черзі за статусом зупиняться з причиною, а безкоштовна частина продовжить працювати.
Поки що жодного відгуку. Будьте першим.
Поки питань немає. Запитай — ми відповімо протягом 24 годин.
Не той варіант, що шукаєте?
Робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—




















