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

Зв'язатись
OpenCart

Bulgarian Posts Shipping для OpenCart — Български пощи: доставка у відділення чи на адресу, посилки й накладні із замовлення

Български пощи для OpenCart 4.x, 3.x, 2.3 (Болгарія): доставка у відділення з вибором на чекауті й на адресу, посилка й накладна А4 із замовлення; Pro додає ціну наживо, післяплату, автоматичні посилки, відстеження, міжнародні. Ліцензія назавжди.

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

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

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

Функція Free Pro
Метод «до відділення» Български пощи з вибором на чекауті: пошук по місту, вулиці, назві й індексу кирилицею та латиницею ✔ ✔
Метод «на адресу» по Болгарії ✔ ✔
Фіксована ціна, «безкоштовно від» суми, ліміт ваги, податковий клас, гео-зона ✔ ✔
Посилка із замовлення в один клік і накладна А4, видалення посилки до здачі ✔ ✔
Лист покупцеві з номером посилки й запис в історії замовлення ✔ ✔
Список посилок з фільтрами в адмінці ✔ ✔
Ціна наживо з тарифу Български пощи з націнкою й округленням — ✔
Післяплата (наложен платеж) у посилці — ✔
Автоматичне створення посилки за статусом замовлення — ✔
Масові посилки й накладні одним ZIP — ✔
Відстеження щогодини: нові події в історії замовлення — ✔
Міжнародні посилки Interconnect з ціною наживо — ✔

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

Вибір відділення на чекауті
Покупець обрав відділення Български пощи в списку: назва, поштовий індекс, адреса й кнопка «Change».
Методи доставки Bulgarian Posts
Вкладка «Delivery methods»: методи «до відділення», «на адресу» й міжнародний (Pro), назви на чекауті, ціни, «Free from», ліміт ваги, націнка й округлення.

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

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

На чекауті з адресою в Болгарії зʼявляється група «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 чи лист покупцю, оголошена вартість).

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

v1.0.0 Поточна 15.11.2026

Для OpenCart 4.x, 3.x і 2.3: доставка Български пощи до відділення з вибором на чекауті й на адресу, фіксовані ціни, посилка з накладною А4 із замовлення, лист покупцеві з номером, список посилок.

Разом з Bulgarian Posts Shipping купують

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

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

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-архівом, оновити відстеження.

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

  1. Укладіть з Български пощи договір для інтернет-магазинів (bgpost.bg → Business → E-shop integration): компанія надішле на пошту contractGUID і portalUserGUID.
  2. Встановіть модуль, відкрийте його налаштування, вставте GUID, натисніть «Save and check the connection», потім «Download the post offices».
  3. На «Delivery methods» увімкніть потрібні методи й задайте ціни; на «Connection and sender» вкажіть відправника й валюту.
  4. Покупець в Болгарії обирає на чекауті відділення чи адресу й оформлює замовлення.
  5. Відкрийте замовлення в адмінці, перевірте вагу й натисніть «Create the parcel»: посилка зʼявиться в Български пощи, а покупець отримає номер листом.
  6. Надрукуйте накладну А4 і передайте посилку у відділення (або увімкніть забір за адресою відправника).
  7. У 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».

Встановлення

  1. OpenCart 4: Extensions → Installer, завантажте cc_bgpost.ocmod.zip, не перейменовуючи його.
  2. OpenCart 3.x: Extensions → Installer, завантажте cc_bgpost-oc3.ocmod.zip, потім Extensions → Modifications → Refresh.
  3. OpenCart 2.3: Extensions → Installer, завантажте cc_bgpost-oc23.ocmod.zip (потрібні налаштування FTP у System → Settings → FTP; інакше розпакуйте архів і залийте вміст теки upload/ у корінь магазину вручну), потім Extensions → Modifications → Refresh.
  4. Extensions → Extensions → Shipping → Bulgarian Posts Shipping: встановіть і відкрийте налаштування.
  5. Вставте GUID із договору, натисніть «Save and check the connection» і «Download the post offices», увімкніть методи й збережіть.
  6. Для Pro: вставте ключ ліцензії або запустіть пробний період на вкладці «Licence».

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

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

@catcode_support Налаштування, сумісність, активація
Це офіційний модуль Български пощи?

Ні, це незалежна інтеграція через 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 вимикається, відкладені автоматичні посилки не створюються (причина пишеться в замовленні), безкоштовна частина працює далі.

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

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

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