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

Зв'язатись
OpenCart

inv.bg для OpenCart — фактури із замовлень, кредитні ноти й фактури фірмам (Болгарія)

Фактури inv.bg для OpenCart 4.x, 3.x, 2.3 (Болгарія): зі сторінки замовлення безкоштовно, у Pro — за статусом, фірмам, кредитні ноти, Н-18. Ліцензія назавжди.

Pro · ліцензія назавжди Тестові копії сайтів у ціні. Чим більше сайтів, тим дешевше кожен
Сумісність
OpenCart 4.0.2.x–4.1.x, 3.0.x, 2.3.0.2 · мова інтерфейсу: English, Български
Версія
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
Підключення довгостроковим API-токеном, перевірка зʼєднання, шифрований токен ✔ ✔
Фактура зі сторінки замовлення на фізичну особу, суми рівно як у замовленні ✔ ✔
PDF болгарською чи англійською, посилання з блоку замовлення ✔ ✔
Чернетки: фактура отримує номер, коли ви підтверджуєте її в inv.bg ✔ ✔
Спосіб оплати за кодом платіжного розширення, примітка й одиниця виміру ✔ ✔
Причина для рядків без ПДВ, валюта замовлення з курсом ✔ ✔
Інтерфейс англійською і болгарською ✔ ✔
Фактури за статусом замовлення вручну зі сторінки замовлення автоматично — Pro
Фактури фірмам: ЕИК, номер ДДС, МОЛ, перевірка VIES — ✔
Кредитні ноти кнопкою чи за статусом повернення — ✔
Позначка «оплачено» на чекауті чи за статусом — ✔
Номерні серії inv.bg і спосіб оплати на кожне розширення — ✔
Дані для Наредби Н-18 (номер е-магазину і тип оплати) — ✔
Лист покупцю від inv.bg з PDF чи посиланням — ✔
Журнал з масовим виписуванням і повтором зупиненого — ✔

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

Блок inv.bg у замовленні
Блок «inv.bg» на сторінці замовлення: покупець, рядки, підсумок і кнопка «Issue the invoice».
Налаштування фактури inv.bg
Вкладка «Invoice»: чернетки, спосіб оплати, мова PDF, причина для рядків без ПДВ, серії номерів і Н-18.
Фактури фірмам inv.bg
Вкладка «Companies» (Pro): поля ЕИК, номер ДДС і МОЛ та перевірка в VIES.

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

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

На сторінці замовлення зʼявляється блок «inv.bg»: покупець, чи це фізична особа, чи фірма, рядки з кількістю, сумою без ПДВ і ставкою, підсумок, спосіб оплати.

Що в адмінці

Extensions → Extensions → Modules → inv.bg Invoices: п’ять вкладок: «Connection», «Invoice», «Companies», «Automation» і «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.
  • Акаунт inv.bg з даними фірми і довгостроковим API-токеном.
  • Фактура — податковий документ: виписану фактуру не можна видалити, її сторнують кредитною нотою. Для перших замовлень увімкніть чернетки й перевірте документи в inv.bg.
  • Замовлення з подарунковим сертифікатом, фіксованим податком чи бальною знижкою, суму якого не можна розкласти на рядки, зупиняється з поясненням, а не виписується з розбіжністю.
  • Невідомий онлайн-метод оплати йде на фактурі як «Card»; за потреби задайте спосіб оплати на розширення в Pro.

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

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

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

Разом з inv.bg купують

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

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

inv.bg Invoices для OpenCart 4.x, 3.x і 2.3 виписує фактури в болгарському сервісі inv.bg прямо із замовлень магазину: кнопка «Issue the invoice» на сторінці замовлення створює податкову фактуру в акаунті inv.bg і показує її номер та PDF. Суми в фактурі — точно ті, що в замовленні.

Що потрібно від inv.bg. Акаунт inv.bg з даними фірми і довгостроковий API-токен (Налаштування → За фирмата → API достъп). Фактури й сам сервіс оплачуються в inv.bg за вашим тарифом: модуль не додає плати за документи.

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

На сторінці замовлення зʼявляється блок «inv.bg»: покупець, чи це фізична особа, чи фірма, рядки з кількістю, сумою без ПДВ і ставкою, підсумок, спосіб оплати. Кнопка «Issue the invoice» виписує документ; далі в блоці видно тип, номер, суму, статус і кнопки PDF та E-mail. Якщо замовлення вже має фактуру, друга не створюється.

Ставки ПДВ беруться з рядків замовлення (20 %, 9 %, доставка окремим рядком). Якщо в замовленні є рядки з 0 % ПДВ, модуль вимагає причину («чл. 113, ал. 9 от ЗДДС» або іншу) і без неї нічого не відправляє, пояснюючи чому. Для фірми з ЄС поза Болгарією причина окрема («чл. 21, ал. 2 от ЗДДС»).

Що в адмінці

Extensions → Extensions → Modules → inv.bg Invoices: п’ять вкладок: «Connection», «Invoice», «Companies», «Automation» і «Licence». На першій ви вставляєте API-токен (він зберігається зашифрованим і більше не показується) і натискаєте «Check the connection»: модуль показує назву вашої фірми в inv.bg.

На вкладці «Invoice» ви вмикаєте чернетки, вибираєте спосіб оплати (автоматично за кодом платіжного розширення: cod — накладений платіж, bank_transfer — банківський переказ, cheque, PayPal, Stripe, ePay, EasyPay, Revolut за назвою, решта — картка), мову PDF (болгарська для болгарських замовлень, англійська для решти), одиницю виміру, причину для рядків без ПДВ і примітку. У Pro тут же обираються номерні серії inv.bg для фактур і кредитних нот, спосіб оплати на кожне розширення й дані для Наредби Н-18.

Вкладка «Companies» (Pro) повʼязує фактури фірмам з полями клієнта: ЕИК (Булстат), номер ДДС і МОЛ. Кнопка «Create the fields» додає ці необовʼязкові поля в акаунт і чекаут. Замовлення з ЕИК чи номером ДДС стає фактурою фірмі: inv.bg знаходить клієнта за ЕИК або номером ДДС чи створює його. Номер ДДС перевіряється в VIES до виписування.

Pro виписує фактури самі: коли замовлення досягає одного з обраних вами статусів («Complete» чи інший). Фактуру можна позначити оплаченою на чекауті або за статусом, а кредитну ноту модуль створює кнопкою або коли замовлення потрапляє у статус повернення чи скасування. Документ може піти покупцю листом від inv.bg з PDF у вкладенні чи посиланням.

Журнал «inv.bg invoices» у меню Sales показує кожен документ зі статусом «Waiting», «Stopped» чи «Issued» і причиною зупинки словами: inv.bg не прийняв токен, номер ДДС не пройшов VIES, тариф не дозволяє. Поле «Invoices for many orders» приймає номери й діапазони («1001-1020, 1025», до 500 за раз), а «Retry all stopped» повторює все зупинене. Якщо відповідь inv.bg загубилася, повтор спершу шукає документ за позначкою замовлення, тож дубля не буде.

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

  1. Встановіть архів для вашої версії OpenCart і встановіть модуль у Extensions → Modules.
  2. В inv.bg створіть довгостроковий API-токен: Налаштування → За фирмата → API достъп.
  3. Вставте токен на вкладці «Connection» і натисніть «Check the connection»: зʼявиться назва вашої фірми.
  4. На вкладці «Invoice» увімкніть «Create invoices as drafts» для перших замовлень, вкажіть причину для рядків без ПДВ і мову PDF.
  5. Відкрийте замовлення, перевірте рядки й натисніть «Issue the invoice».
  6. Перевірте документ в inv.bg, а коли все збігається, вимкніть чернетки.

Що під капотом

  • inv.bg REST API v3 (api.inv.bg): довгостроковий токен, рахунки та кредитні ноти, клієнти, PDF, листи, курси валют, серії номерів. Токен шифрується; у журналі модуля помилки inv.bg показані повністю.
  • Сума фактури дорівнює сумі замовлення: рядки, знижки, доставка й ПДВ передаються з точними значеннями; валюта замовлення йде з курсом (євро й лев — за фіксованим курсом 1,95583, інші валюти — за курсом inv.bg).
  • Фактура виписується у фоні після сторінок магазину та планувальником OpenCart 4; для OpenCart 3 і 2.3 без cron документи йдуть із відкриттів сторінок, а за бажанням — із серверного cron за секретною адресою, яку показано у вкладці «Automation».
  • Збій inv.bg (429, 5xx, таймаут) ставить документ у «Waiting» і повторює пізніше, а відмова токена, тарифу чи даних зупиняє рядок із поясненням. Фактура одного замовлення не виписується двічі.
  • Перевірка номера ДДС іде через inv.bg у VIES. Якщо VIES відповідає довше 30 с, фактура йде з номером із замовлення без перевірки, а в журналі пишеться «VAT check failed».
  • Інтерфейс англійською і болгарською.

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

  1. Extensions → Installer: завантажте архів для вашої версії, не перейменовуючи файл (OpenCart 4 — cc_invbg.ocmod.zip, 3.x — cc_invbg-oc3.ocmod.zip, 2.3 — cc_invbg-oc23.ocmod.zip; для 2.3 вміст теки upload/ копіюється в корінь магазину).
  2. Для 3.x і 2.3: Extensions → Modifications → Refresh.
  3. Extensions → Modules → inv.bg Invoices: встановіть і відкрийте налаштування.
  4. На вкладці «Connection» вставте API-токен і натисніть «Check the connection».
  5. Для перших замовлень увімкніть чернетки на вкладці «Invoice».
  6. Для Pro: введіть ключ або запустіть пробний період на вкладці «Licence».

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

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

@catcode_support Налаштування, сумісність, активація
Це офіційний модуль inv.bg?

Ні, це незалежна інтеграція з inv.bg від CatCode. inv.bg — торгова марка її власника.

Що потрібно, щоб почати?

Акаунт inv.bg з даними фірми й довгостроковий API-токен з налаштувань фірми.

Чи можна видалити виписану фактуру?

Ні, це податковий документ. Помилкову фактуру сторнують кредитною нотою (Pro: кнопка в замовленні або статус повернення). Для перших замовлень ввімкніть чернетки.

Як виписати фактуру фірмі?

У Pro: ЕИК, номер ДДС і МОЛ беруться з полів клієнта (їх можна створити кнопкою) або вводяться вручну в замовленні; номер ДДС перевіряється у VIES.

Що, коли в замовленні 0 % ПДВ?

Вкажіть причину в налаштуваннях («чл. 113, ал. 9 от ЗДДС» або свою). Без причини фактура не виписується, а модуль пояснює чому.

Чи можна виписувати фактури масово?

Так, у Pro: журнал приймає номери й діапазони замовлень (до 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. Розкажіть про задачу — підготуємо оцінку.

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