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

Bulgaria Couriers: Econt & Speedy для OpenCart — модуль доставки для магазинов в Болгарии на OpenCart 4, 3 и 2.3. Два крупнейших курьера страны в одном расширении: Econt с офисами и Еконтоматами и Speedy с офисами и автоматами APT. Покупатель выбирает доставку на адрес, в офис или в автомат прямо на чекауте, а менеджер создает товарителницу, печатает этикетку и видит статус пратки в карточке заказа, не открывая кабинеты курьеров. Для WooCommerce есть отдельная версия — Bulgaria Couriers для WooCommerce — отдельный плагин с теми же курьерами.

Что нужно от вас. Бизнес-аккаунт у каждого курьера, которого включаете: Econt — пользователь и пароль e-Econt; Speedy — пользователь и пароль Web API. Честно о проверке: Econt проверен вживую на официальной тестовой среде Econt (demo.econt.com); Speedy — по официальной документации Web API на тестовом сервере, потому что публичной тестовой среды у Speedy нет, а тестовый доступ он дает только клиентам. Попробуйте на своем аккаунте Speedy в 7-дневном триале Pro — если курьер ответит иначе, чем в документации, исправим оперативно.

Как это выглядит для покупателя

Покупатель видит методы обоих курьеров, которых вы включили, с ценами. Выбрал доставку в офис — под методом появляется панель: список начинается с офисов его города, поиск идет кириллицей и латиницей по городу, улице или названию офиса («Sofia» находит «София»). Переключился на доставку на адрес — панель исчезает, а его адрес остается своим: модуль не пишет адрес офиса в поля покупателя. У каждого курьера свой выбранный офис, поэтому переключение между Econt и Speedy ничего не путает.

Попробуете оформить доставку в офис, не выбрав его, — сервер откажет с пояснением («Please choose the Econt office or Econtomat.»). В OpenCart 4 это шаг оплаты и подтверждения, в OpenCart 3 и 2.3 — уже шаг доставки. Пока офиса нет, блок подтверждения заказа на странице придерживается с пометкой, что не хватает офиса. Офис, выбранный раньше, никогда не попадет в заказ с другим способом доставки. Для офиса Speedy, который не принимает оплат, модуль отклонит наложенный платеж.

Что получает админ

Настройки — Расширения → Расширения → Доставка → Bulgaria Couriers (Econt, Speedy). Там вкладки методов, двух курьеров, «Shipments», «Automation» и «Licence».

• Четыре метода в одном расширении доставки: Econt на адрес, Econt в офис или Еконтомат, Speedy на адрес, Speedy в офис или автомат. Показываются только для адресов в Болгарии (и, по желанию, только в выбранной геозоне).
• Цена метода — фиксированная в основной валюте магазина, бесплатно от суммы товаров, купон с бесплатной доставкой работает как всегда, лимит веса на метод.
• Валюта. Тарифы курьеров и наложенный платеж — в евро (для старого аккаунта в левах — BGN). Если в магазине нет этой валюты, страница настроек предупредит: без нее суммы берутся 1:1.

• Офисы курьеров в вашей базе. Кнопка «Download offices» загружает офисы и автоматы каждого курьера, дальше они обновляются ежедневно кроном. Покупатель ищет офис в вашей базе, а не ждет API курьера.
• «Save and check the connection» проверяет аккаунт: для Econt подтягивает адрес отправителя из профиля e-Econt, для Speedy — объекты договора и услуги.
• Пароли хранятся в базе зашифрованными и не попадают в HTML страницы настроек.
• Телефон. Обоим курьерам нужен телефон покупателя. OpenCart 4 по умолчанию его не спрашивает — модуль об этом предупреждает и одним кликом включает «Telephone display» и «Telephone required».

• Панель Bulgaria Couriers в карточке заказа: вес, количество пакетов (больше одного — в Pro), наложенный платеж для способов оплаты, которые вы отметили, обявена стойност, преглед преди плащане, создание товарителницы.
• PDF-этикетка (Speedy — A4 или A6, Econt — его собственный PDF), обновление статуса и аннулирование — кнопками в той же панели.
• Сменить офис вручную, если покупатель попросил, — по коду офиса.
• Товарителница для любого заказа: даже если покупатель выбрал другую доставку, курьера выбираете в панели.
• Заказ без телефона получает в панели поле телефона: он записывается в заказ вместе с товарителницей.
• Покупателю — письмо с номером товарителницы и ссылкой на трекинг курьера, а в его аккаунте — строка в истории заказа.

• Список товарителниц в меню «Продажи»: заказы с курьером, офисом и состоянием пратки.
• Pro: массовые действия — создать товарителницы для отмеченных заказов, распечатать все этикетки вместе (один PDF или ZIP), обновить статусы.
• Pro: автоматизация — товарителница создается сама, когда заказ переходит в выбранный статус; статусы сверяются ежечасно, изменения пишутся в историю заказа, а доставленный заказ может получить выбранный статус.

Как это работает — шаг за шагом

1. Настройка. Аккаунты нужных курьеров, «Save and check the connection», загрузка офисов, затем включение методов и цен на вкладке «Delivery methods».
2. Чекаут. Покупатель с адресом в Болгарии видит методы включенных курьеров. Для офиса — выбирает офис в панели; с Pro цена доставки берется из тарифа курьера и пересчитывается после выбора офиса и способа оплаты (наложенный платеж).
3. Проверка на сервере. Для метода доставки в офис оформление без офиса не проходит. Для офиса Speedy без оплат не пройдет и заказ с наложенным платежом.
4. Заказ. Офис пишется в заказ на сервере, только если метод доставки именно в офис этого курьера: адрес доставки заказа становится адресом офиса, область — областью офиса. Адресная книга покупателя остается его.
5. Товарителница. Менеджер создает ее в карточке заказа (с Pro — автоматически на выбранный статус или массово из списка), печатает этикетку. Покупатель получает письмо с трекингом.
6. Статус. Кнопка «Refresh status» спрашивает курьера; с Pro статусы синхронизируются ежечасно — кроном OpenCart 4 или cron-адресом из настроек.
7. Аннулирование. Товарителница, которую курьер еще не забрал, аннулируется из карточки заказа.

Что под капотом

• Офис — только на сервере. JavaScript пикера не читает и не пишет поля адреса покупателя. Офис идет в сессию отдельно для каждого курьера (только код, данные — из таблицы модуля), а в заказ — только если метод доставки именно в офис этого курьера; иначе привязка стирается.
• Проверка без офиса в OpenCart 4 стоит на сохранении способа оплаты и на подтверждении; в OpenCart 3 — на событиях шагов доставки, оплаты и подтверждения; в OpenCart 2.3 — те же шаги через модификацию (install.xml), которую модуль регистрирует сам.
• Живой тариф без сюрпризов (Pro). Курьер ответил нулем, ошибкой или не успел за несколько секунд — метод показывает вашу фиксированную цену, а не «бесплатно». Цена в списке методов — та же, что пойдет в заказ.
• Одна библиотека на три сборки, код совместим с PHP 7.0. Собственные таблицы офисов, привязок заказов, товарителниц и служебных данных.
• Пароли — AES-256-CBC с HMAC, без XOR.
• Pro-гейт без «кирпича»: когда триал закончился, останавливаются только Pro-функции, доставка и товарителницы работают дальше.
• Деинсталляция снимает события и задания крона; таблицы модуля и копия настроек остаются для повторной установки.

Как установить

1. OpenCart 4: Расширения → Установщик → загрузите cc_bgcourier.ocmod.zip (имя архива не меняйте) и нажмите «Установить». OpenCart 3: Расширения → Установщик → cc_bgcourier-oc3.ocmod.zip, затем Расширения → Модификации → «Обновить». OpenCart 2.3: залейте содержимое папки upload/ из cc_bgcourier-oc2.ocmod.zip в корень магазина (FTP или файловый менеджер хостинга) — Установщик 2.3 без настроенного FTP файлы не копирует.
2. Расширения → Расширения → Доставка → Bulgaria Couriers (Econt, Speedy) → «Установить», затем «Редактировать».
3. OpenCart 2.3: Расширения → Модификации → «Обновить». Модуль регистрирует свою модификацию сам, а страница настроек показывает желтое напоминание, пока «Обновить» не нажато — без этого проверка офиса на чекауте не работает.
4. Заполните аккаунт каждого курьера, которого включаете, нажмите «Save and check the connection» и «Download offices».
5. На вкладке «Delivery methods» включите нужные методы и поставьте цены, порог бесплатной доставки и лимит веса.
6. Оформите тестовый заказ в офис и создайте товарителницу из карточки заказа.
7. Для Pro: вставьте лицензионный ключ из письма после оплаты или нажмите «Try Pro free for 7 days» на вкладке «Licence». Для OpenCart 3 и 2.3 добавьте cron-адрес с вкладки «Automation» в cron хостинга, раз в час.