Чорний листопад: −35% на всі модулі до 30 листопада Чорний листопад: −35% до 30 листопада Обрати модуль

Зв'язатись
OpenCart

Holded для OpenCart — рахунки-фактури із замовлень, кредит-ноти, NIF/CIF і склад (Іспанія)

Holded для OpenCart 4.x, 3.x, 2.3 (Іспанія): рахунки зі сторінки замовлення безкоштовно, у Pro — за статусом, кредит-ноти, оплати, склад, журнал. Ліцензія назавжди.

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
Або всі 509 Pro-модулів з All Access — 3 244 грн / рік

Що є в Free,
а що дає Pro

Безкоштовна версія працює без обмеження в часі. Pro додає решту функцій з таблиці.

Функція Free Pro
Підключення Holded ключем API з перевіркою прав, ключ зашифрований ✔ ✔
Відповідність ставок ПДВ податкам Holded, автопідстановка єдиного податку зі ставкою ✔ ✔
Рахунок зі сторінки замовлення вручну: контакт за e-mail, рядки, знижка у %, доставка, адреса доставки ✔ ✔
Сума Holded читається назад і порівнюється із замовленням, PDF і рядок в історії замовлення ✔ ✔
Мова документа, SKU або модель як код рядка, внутрішня примітка ✔ ✔
Втрачена відповідь: пошук документа в Holded перед повтором, без другого рахунку ✔ ✔
Інтерфейс англійською й іспанською ✔ ✔
Рахунок автоматично за статусом замовлення — ✔
Затвердження в Holded і серії нумерації для рахунків і кредит-нот — ✔
NIF/CIF покупця з поля чекауту або з замовлення, контакт за NIF — ✔
Кредит-нота на весь рахунок кнопкою чи за статусом — ✔
Оплата на банківський рахунок Holded за способом оплати — ✔
E-mail із Holded покупцю автоматично й кнопкою — ✔
Склад за SKU зі складом Holded: зміни в обидва боки, без перезапису — ✔
Окремий ключ Holded для кожного магазину OpenCart — ✔
Журнал, масове виписування, повтор усіх зупинених, підсумки за місяцями — ✔

Як це виглядає

Блок Holded в замовленні
Блок «Holded» на сторінці замовлення: контакт, рядки з податками Holded, підсумок і кнопка створення рахунку.
Налаштування рахунка Holded
Вкладка «Invoice»: відповідність ставок ПДВ податкам Holded, мова документа, код товару, затвердження й серії (Pro).
Автоматизація Holded
Вкладка «Automation» (Pro): статуси для рахунка й кредит-ноти, e-mail з Holded, оплати на банківські рахунки.

Головне про модуль

Що отримує продавець

На сторінці замовлення зʼявляється блок «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 не чіпаються.
  • Магазини з окремим ключем: податки зіставляються лише за відсотком, береться серія за замовчуванням, платежі й склад ведуться тільки для основного акаунта.
  • Кредит-нота виписується лише на весь рахунок, часткових повернень нема.

Історія версій

v1.0.0 Поточна листопад 2026

Перший випуск для OpenCart 4.x, 3.x і 2.3.

Разом з Holded купують

All Access Потрібно більше? Усі модулі (509) однією ліцензією, нові додаються самі. 3 244 грн Детальніше →

Повний опис модуля

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

Як це працює, крок за кроком

  1. Встановіть архів для вашої версії OpenCart і встановіть модуль у Extensions → Modules.
  2. У Holded відкрийте Configuración → Desarrolladores → Credenciales, натисніть «Agregar API Token», оберіть «Por áreas», дайте права зі списку на вкладці «Connection» і скопіюйте токен (його показують один раз).
  3. На вкладці «Connection» вставте ключ і натисніть «Save and test the connection».
  4. На вкладці «Invoice» перевірте відповідність ставок ПДВ податкам Holded, мову документа й код товару.
  5. Відкрийте замовлення, перевірте рядки й суму та натисніть «Create the invoice in Holded».
  6. Для 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.
  • Інтерфейс англійською й іспанською, документ — мовою замовлення.

Як встановити

  1. 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/ копіюється в корінь магазину).
  2. Для 3.x і 2.3: Extensions → Modifications → Refresh.
  3. Extensions → Modules → Holded Invoices: встановіть і відкрийте налаштування.
  4. На вкладці «Connection» вставте ключ API й натисніть «Save and test the connection».
  5. Для Pro: введіть ключ або запустіть пробний період на вкладці «Licence».

Питання
про модуль

Не знайшли відповідь? Напишіть у Telegram — відповімо протягом робочого дня.

@catcode_support Налаштування, сумісність, активація
Це офіційний модуль 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 вимкнеться, рахунки в черзі за статусом зупиняться з причиною, а безкоштовна частина продовжить працювати.

Не той варіант, що шукаєте?

Робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.

Замовити кастомний модуль