
inv.bg для OpenCart — фактури із замовлень, кредитні ноти й фактури фірмам (Болгарія)
Фактури inv.bg для OpenCart 4.x, 3.x, 2.3 (Болгарія): зі сторінки замовлення безкоштовно, у Pro — за статусом, фірмам, кредитні ноти, Н-18. Ліцензія назавжди.
- Сумісність
- 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
Що є в Free,
а що дає Pro
Безкоштовна версія працює без обмеження в часі. Pro додає решту функцій з таблиці.
Головне про модуль
Що отримує продавець
На сторінці замовлення зʼявляється блок «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.
Історія версій
Перший випуск для OpenCart 4.x, 3.x і 2.3.
Разом з inv.bg купують


Bulgaria Couriers: Econt & Speedy для OpenCart — доставка на адресу, в офіс і в автомат

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

eMAG Marketplace Connector для OpenCart — ціни, залишки й замовлення eMAG у вашому магазині
Повний опис модуля
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 загубилася, повтор спершу шукає документ за позначкою замовлення, тож дубля не буде.
Як це працює, крок за кроком
- Встановіть архів для вашої версії OpenCart і встановіть модуль у Extensions → Modules.
- В inv.bg створіть довгостроковий API-токен: Налаштування → За фирмата → API достъп.
- Вставте токен на вкладці «Connection» і натисніть «Check the connection»: зʼявиться назва вашої фірми.
- На вкладці «Invoice» увімкніть «Create invoices as drafts» для перших замовлень, вкажіть причину для рядків без ПДВ і мову PDF.
- Відкрийте замовлення, перевірте рядки й натисніть «Issue the invoice».
- Перевірте документ в 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».
- Інтерфейс англійською і болгарською.
Як встановити
- 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/ копіюється в корінь магазину).
- Для 3.x і 2.3: Extensions → Modifications → Refresh.
- Extensions → Modules → inv.bg Invoices: встановіть і відкрийте налаштування.
- На вкладці «Connection» вставте API-токен і натисніть «Check the connection».
- Для перших замовлень увімкніть чернетки на вкладці «Invoice».
- Для Pro: введіть ключ або запустіть пробний період на вкладці «Licence».
Питання
про модуль
Не знайшли відповідь? Напишіть у Telegram — відповімо протягом робочого дня.
Це офіційний модуль 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 вимкнеться, а безкоштовна частина продовжить працювати.
Поки що жодного відгуку. Будьте першим.
Поки питань немає. Запитай — ми відповімо протягом 24 годин.
Не той варіант, що шукаєте?
Робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—




















