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 Пошта (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.