
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. Расскажите о задаче — подготовим оценку.
Заказать кастомный модуль
Покупка модуля
—
Оплата списывается в гривне, ваш банк пересчитает её в вашу валюту. Цена в евро ориентировочная.




















