Чёрный ноябрь: −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 грн / год ≈ 66 €

Что есть во 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 грн≈ 66 € Подробнее →

Полное описание модуля

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. Расскажите о задаче — подготовим оценку.

Заказать кастомный модуль