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



















