Meest Почта для OpenCart 2.3, 3.x и 4.x — отделения и почтоматы в чекауте

Как посмотреть у себя

Модуль работает с вашим договором Meest: логин, пароль и contractID к openAPI выдаёт менеджер Meest. Бесплатная часть работает без ограничений сразу после установки. Pro можно попробовать 7 дней без карты: ключ выдаётся в один клик из самой админки.

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

В чекауте покупатель выбирает доставку Meest — и вместо «улица, дом, квартира» видит два поля: город и отделение. Город ищется с первых букв по справочнику Meest, в списке отделений видно адрес, а почтоматы идут там же, что и отделения.

Как только отделение выбрано, модуль сам подставляет его адрес в поля заказа, а лишние «Адрес», «Город» и «Индекс» прячет, чтобы покупатель не заполнял их дважды. Если отделение не выбрано, шаг «Способ доставки» не пропустит заказ дальше и покажет понятную ошибку — заказов с пустым адресом не будет.

Стоимость доставки видна сразу: либо фиксированная, которую вы задали, либо живой тариф Meest под выбранное отделение. Тариф считается в гривне и конвертируется в валюту магазина, поэтому мультивалютные витрины показывают правильную сумму.

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

Все настройки — на одной странице расширения, разложены по вкладкам: доступ к API и поведение в чекауте, отправитель, посылки, вид виджета, лицензия и адрес для крона.

Пароль API хранится в базе в зашифрованном виде, а не открытым текстом. Кнопка «Проверить доступ» логинится в Meest и сразу говорит, принимает ли перевозчик ваши данные; «Обновить справочник городов» тянет справочник в локальный кеш, чтобы чекаут не зависел от того, как сейчас чувствует себя API.

Журнал отправлений живёт в «Продажах»: заказ, номер посылки, получатель, куда, статус, наложенный платёж, тариф и дата. Оттуда же создаётся и отменяется посылка и обновляются статусы.

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

1. Вы вводите логин, пароль и contractID из договора Meest и нажимаете «Проверить доступ». Модуль логинится, получает токен и сам обновляет его, пока тот не протух.

2. Выбираете город и отделение отправителя — с него уйдут посылки, а имя и телефон отправителя Meest печатает на наклейке.

3. Покупатель в чекауте выбирает город и отделение. Модуль подставляет адрес в заказ и показывает стоимость — фиксированную или посчитанную через /calculate.

4. После заказа строка появляется в журнале отправлений. Посылку вы создаёте кнопкой или включаете автосоздание на нужном статусе — «В обработке», «Отправлено», как удобнее.

5. Meest возвращает номер посылки и штрихкод. Пока посылка не поехала, её можно отменить из той же таблицы; статусы обновляются кнопкой, а в Pro — сами по крону.

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

Общая библиотека на все три ветки OpenCart: клиент openAPI с автопродлением токена, кеш справочника городов и отделений в собственных таблицах, шифрование пароля, лицензия, сборщик посылки и виджет чекаута. Поэтому поведение на 2.3, 3.x и 4.x одинаковое, а не «как получилось на каждой версии».

Файлы ядра не патчатся: на 4.x и 3.x модуль работает через события OpenCart, на 2.3 — через ocmod, потому что события на контроллере чекаута там не срабатывают. Виджет встраивается в штатную форму адреса и пишет в скрытые поля ядра, поэтому чужие модули доставки и оплаты остаются на месте.

Суммы, которые уходят в Meest — объявленная стоимость, содержимое посылки и наложенный платёж — конвертируются в гривну, даже если витрина работает в долларах или евро. Адреса и названия товаров экранируются, поэтому отделение с тегами в названии не ломает страницу.

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

OpenCart 4.x: Расширения → Установка расширений → «Загрузить» → выберите cc_meest.ocmod.zip → в списке нажмите «+». Дальше Расширения → Расширения → Доставка → «Meest Poshta (CatCode)» → «Установить», затем «Редактировать».

OpenCart 3.x: так же через Extensions → Installer сборкой cc_meest-oc3.ocmod.zip, затем Extensions → Extensions → Shipping → Install → Edit.

OpenCart 2.3: штатный установщик 2.3 работает только по FTP, поэтому содержимое папки upload/ из сборки cc_meest-oc2.ocmod.zip заливается в корень магазина вручную. После этого обязательно Extensions → Modifications → Refresh, иначе виджет в чекауте не появится.

После установки добавьте адрес из вкладки «Крон» в планировщик хостинга раз в час: он обновляет справочник городов и проверяет лицензию, а в Pro ещё и статусы посылок. На OpenCart 4 то же самое делает встроенный Cron Jobs.