
Bulgarian Posts Shipping для OpenCart — Български пощи: доставка у відділення чи на адресу, посилки й накладні із замовлення
Български пощи для OpenCart 4.x, 3.x, 2.3 (Болгарія): доставка у відділення з вибором на чекауті й на адресу, посилка й накладна А4 із замовлення; Pro додає ціну наживо, післяплату, автоматичні посилки, відстеження, міжнародні. Ліцензія назавжди.
- Сумісність
- OpenCart 4.0.2.0–4.1.x, 3.0.x, 2.3.0.2 · мова модуля: English, Български
- PHP
- 7.0 і новіший
- Версія
-
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3) - Ліцензія
- сайт + тестова копія, назавжди
- Тріал
- 7 днів, без картки, один на сайт
- Оновлено
- 15.11.2026
Що є в Free,
а що дає Pro
Безкоштовна версія працює без обмеження в часі. Pro додає решту функцій з таблиці.
Головне про модуль
Що отримує покупець і продавець
На чекауті з адресою в Болгарії зʼявляється група «Bulgarian Posts» з двома методами: «до відділення» і «на вашу адресу».
Що в адмінці
Extensions → Extensions → Shipping → Bulgarian Posts Shipping. Вкладки: «Delivery methods», «Connection and sender», «Parcels», «Automation», «Licence».

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

Один ключ — сайт і тестова копія
Переносите сайт — відв’яжіть ліцензію на старому домені й активуйте на новому самі. Тестова копія (staging., dev.) працює з тим самим ключем і місця сайту не займає. Для студій — ключі на 5, 25 сайтів або без обмежень.
Технічні вимоги
OpenCart 4.0.2.0–4.1.x, 3.0.x або 2.3.0.2; PHP 7.0+ для 2.3, розширення cURL і OpenSSL; для архіву з кількома накладними — розширення zip.
Для створення посилок і ціни наживо потрібен договір з Български пощи (contractGUID і portalUserGUID, їх надсилає компанія після договору для e-shop). Список відділень і міжнародна ціна GUID не потребують.
Ціни, післяплата й оголошена вартість у поштовій валюті: за замовчуванням євро (Болгарія в євро з 01.01.2026), лев лише для договору, що лишився в левах. Валюта має бути в System → Localisation → Currencies із актуальним курсом, інакше адмінка попереджає, а ціна наживо й сума післяплати не розраховуються.
Методи «до відділення» й «на адресу» показуються лише для адрес у Болгарії. Метод «до відділення» зʼявляється на чекауті після завантаження списку відділень.
Автоматична посилка (Pro) створюється у фоні одразу після того, як замовлення отримало вибраний статус, покупець на чекауті не чекає. Фонова робота йде через PHP-FPM або LiteSpeed; на Apache mod_php її виконує крон або кнопка в замовленні.
Крон: OpenCart 4 запускає щогодинні завдання сам, якщо налаштовано його планувальник; в OpenCart 3 і 2.3 (і без планувальника на OpenCart 4) відкривайте адресу крону з налаштувань щогодини: вона оновлює список відділень раз на добу й, у Pro, відстеження.
Один виклик до Български пощи обмежений за часом: посилка 20 секунд, сторінка замовлення й відстеження 8 секунд, ціна наживо на кроці чекауту 6 секунд. Якщо відповіді немає, посилка позначається «no answer yet», а при наступному відкритті замовлення модуль шукає її за номером замовлення, і другу посилку до цього не створює.
В OpenCart 3.0 і 2.3 після встановлення натисніть Extensions → Modifications → Refresh: перевірка вибору відділення на чекауті працює через модифікацію.
Інтерфейс модуля англійською й болгарською. Міжнародні посилки Interconnect не підтримують післяплату; Български пощи можуть брати окрему плату за опції (крихке, перевірка вмісту, SMS чи лист покупцю, оголошена вартість).
Історія версій
Для OpenCart 4.x, 3.x і 2.3: доставка Български пощи до відділення з вибором на чекауті й на адресу, фіксовані ціни, посилка з накладною А4 із замовлення, лист покупцеві з номером, список посилок.
Разом з Bulgarian Posts Shipping купують


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

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

eMAG Marketplace Connector для OpenCart — ціни, залишки й замовлення eMAG у вашому магазині
Повний опис модуля
Bulgarian Posts Shipping для OpenCart 4.x, 3.x і 2.3 підключає магазин до Български пощи (bgpost.bg). На чекауті покупець в Болгарії обирає доставку до поштового відділення зі зручним пошуком або на свою адресу, а зі сторінки замовлення ви створюєте посилку, друкуєте накладну А4 і даєте покупцеві номер для відстеження.
Що отримує покупець і продавець
На чекауті з адресою в Болгарії зʼявляється група «Bulgarian Posts» з двома методами: «до відділення» і «на вашу адресу». Для доставки у відділення покупець вводить місто, вулицю, назву відділення або поштовий індекс, кирилицею чи латиницею, обирає зі списку й за потреби змінює вибір. Без відділення оформлення не йде: покупець бачить підказку «Please choose the Bulgarian Posts office». Пошук іде по власній копії списку відділень (близько 2 800), яку модуль оновлює щодня, тож чекаут не чекає відповіді Български пощи. Працює на штатному чекауті й на CatCode One Page Checkout.
Ціна доставки — фіксована для кожного методу, з порогом «безкоштовно від» суми товарів і обмеженням ваги в кг; купон на безкоштовну доставку працює як завжди. У Pro ціну можна брати з тарифу Български пощи наживо: з відсотковою чи фіксованою націнкою й округленням. Якщо Български пощи не дали ціну за кілька секунд, чекаут бере фіксовану, а наступні дві хвилини не питає тариф знову, тож покупець не чекає.
У замовленні адресою доставки стає обране відділення, платіжна адреса покупця не змінюється. На сторінці замовлення в адмінці зʼявляється панель «Bulgarian Posts»: вага, телефон покупця (якщо його немає в замовленні), кнопка «Create the parcel». Модуль створює посилку, зберігає її номер, дає накладну PDF формату A4 і дозволяє видалити посилку до передачі. Покупець отримує листа з номером посилки й бачить його в історії замовлення в кабінеті. Для замовлення з післяплатою у безкоштовній версії посилка не створюється, з поясненням і посиланням на Pro, щоб гроші не лишилися несплаченими.
Що в адмінці
Extensions → Extensions → Shipping → Bulgarian Posts Shipping. Вкладки: «Delivery methods», «Connection and sender», «Parcels», «Automation», «Licence». На «Delivery methods» вмикаються методи «до відділення», «на адресу» та міжнародний (Pro), задаються назви на чекауті, фіксована ціна, «Free from», «Max kg», націнка й округлення, податковий клас і гео-зона. На «Connection and sender» вставте portalUserGUID і за потреби contractGUID із листа Български пощи (зберігаються зашифрованими й назад у форму не повертаються), натисніть «Save and check the connection» і «Download the post offices», вкажіть відправника, пошту чи забір кур’єром, поштову валюту.
Список посилок із фільтрами «All», «Without parcel», «On the way» відкривається кнопкою «Parcel list» у налаштуваннях і в меню Sales. Там же масові дії Pro: створити посилки, надрукувати накладні одним ZIP-архівом, оновити відстеження.
Як це працює, крок за кроком
- Укладіть з Български пощи договір для інтернет-магазинів (bgpost.bg → Business → E-shop integration): компанія надішле на пошту contractGUID і portalUserGUID.
- Встановіть модуль, відкрийте його налаштування, вставте GUID, натисніть «Save and check the connection», потім «Download the post offices».
- На «Delivery methods» увімкніть потрібні методи й задайте ціни; на «Connection and sender» вкажіть відправника й валюту.
- Покупець в Болгарії обирає на чекауті відділення чи адресу й оформлює замовлення.
- Відкрийте замовлення в адмінці, перевірте вагу й натисніть «Create the parcel»: посилка зʼявиться в Български пощи, а покупець отримає номер листом.
- Надрукуйте накладну А4 і передайте посилку у відділення (або увімкніть забір за адресою відправника).
- У Pro оберіть статус замовлення, після якого посилка створюється сама, і ввімкніть щогодинне відстеження: нові події Български пощи потрапляють в історію замовлення.
Що під капотом
- API Български пощи (api.bgpost.bg): номенклатура відділень, сесія порталу, номер замовлення, створення й видалення посилки, накладна, розрахунок ціни, відстеження, міжнародні посилки Interconnect.
- portalUserGUID і contractGUID зберігаються зашифрованими (AES-256-CBC з HMAC-SHA256), у налаштуваннях і журналі не показуються; усі запити йдуть по HTTPS.
- Власна копія списку відділень у таблиці БД, оновлюється щодня; пошук по місту, вулиці, назві й індексу кирилицею та латиницею.
- Посилки, відділення замовлень і службові значення — у власних таблицях БД модуля.
- Посилка із замовлення одна; повторне створення заборонено, поки не видалено попередню. Якщо відповідь Български пощи загубилась, посилку знайдено за номером замовлення, а не створено вдруге.
- Автоматична посилка стає в чергу й виконується одразу після відповіді покупцеві (fastcgi_finish_request або LiteSpeed), інакше кроном. Без Pro відкладена посилка не створюється, а в замовленні й журналі пишеться причина.
- Відстеження кожну подію пише в історію один раз, від старішої до новішої, і перестає опитувати завершене замовлення.
- У безкоштовній версії всі налаштування Pro замкнені, а підроблений запит не змінює збережених значень ліцензії, націнки, статусу автоматизації та інших полів Pro.
- Журнал cc_bgpost.log у system/storage/logs: помилки пишуться завжди, кожен виклик — після вмикання «Debug log».
Встановлення
- OpenCart 4: Extensions → Installer, завантажте cc_bgpost.ocmod.zip, не перейменовуючи його.
- OpenCart 3.x: Extensions → Installer, завантажте cc_bgpost-oc3.ocmod.zip, потім Extensions → Modifications → Refresh.
- OpenCart 2.3: Extensions → Installer, завантажте cc_bgpost-oc23.ocmod.zip (потрібні налаштування FTP у System → Settings → FTP; інакше розпакуйте архів і залийте вміст теки upload/ у корінь магазину вручну), потім Extensions → Modifications → Refresh.
- Extensions → Extensions → Shipping → Bulgarian Posts Shipping: встановіть і відкрийте налаштування.
- Вставте GUID із договору, натисніть «Save and check the connection» і «Download the post offices», увімкніть методи й збережіть.
- Для Pro: вставте ключ ліцензії або запустіть пробний період на вкладці «Licence».
Питання
про модуль
Не знайшли відповідь? Напишіть у Telegram — відповімо протягом робочого дня.
Це офіційний модуль Български пощи?
Ні, це незалежна інтеграція через API Български пощи. Назва й логотип Български пощи належать їхнім власникам.
Що потрібно від Български пощи?
Договір для інтернет-магазинів (bgpost.bg → Business → E-shop integration). Після нього компанія надсилає contractGUID і portalUserGUID: без portalUserGUID не створюються посилки й не працює ціна наживо. Вибір відділення на чекауті й список відділень від договору не залежать.
Коли створюється посилка?
Вручну кнопкою «Create the parcel» на сторінці замовлення. У Pro посилка створюється сама у фоні одразу після того, як замовлення отримало вибраний вами статус, а покупець на чекауті нічого не чекає.
Чи працює післяплата?
Так, у Pro: сума замовлення йде в посилку як наложен платеж. У безкоштовній версії посилка для замовлення з післяплатою не створюється, з поясненням, щоб гроші не лишилися несплаченими.
Як покупець дізнається номер посилки?
Листом із номером і посиланням на сторінку відстеження Български пощи й записом в історії замовлення в кабінеті. Номер вводиться на сторінці відстеження вручну.
Чи можна доставляти за кордон?
Так, у Pro: метод «international parcel» створює посилки Interconnect до країн, які Български пощи обслуговує, з ціною наживо. Посилка з післяплатою за кордон неможлива.
Чи працює безкоштовна версія без Pro?
Так: методи «до відділення» й «на адресу» з вашими цінами, вибір відділення, одна посилка із замовлення з накладною А4, видалення посилки, лист покупцеві з номером і список посилок.
Які версії OpenCart підтримуються?
OpenCart 4.0.2.0–4.1.x, 3.0.x і 2.3.0.2: три окремі архіви в одному продукті.
Ліцензія назавжди?
Так, для OpenCart це одна оплата і ліцензія назавжди, на два сайти.
Що буде після пробного періоду?
Pro вимикається, відкладені автоматичні посилки не створюються (причина пишеться в замовленні), безкоштовна частина працює далі.
Поки що жодного відгуку. Будьте першим.
Поки питань немає. Запитай — ми відповімо протягом 24 годин.
Не той варіант, що шукаєте?
Робимо кастомні модулі під WordPress, WooCommerce, OpenCart і Shopify. Розкажіть про задачу — підготуємо оцінку.
Замовити кастомний модуль
Купівля модуля
—



















