Meest Пошта для WooCommerce — відділення й поштомати в чекауті

Як подивитись у себе

Плагін працює з вашим договором Meest: логін, пароль і contractID до openAPI видає менеджер Meest. Безкоштовна частина працює без обмежень одразу після активації. Pro є 7 днів безкоштовно, без картки: ключ видається в один клік із налаштувань.

Як це виглядає для покупця

Покупець обирає «Meest Пошта» серед способів доставки — і замість адреси заповнює два поля: місто й відділення. Місто шукається з перших літер, у списку відділень видно адресу, поштомати йдуть у тому ж списку.

Після вибору відділення плагін сам заповнює адресні поля замовлення, а «Адресу», «Місто» та «Індекс» ховає, щоб покупець не писав їх удруге. Без обраного відділення замовлення не пройде: на класичному чекауті буде помилка валідації, на блоковому — зрозуміле повідомлення від Store API.

Працюють обидва чекаути WooCommerce — класичний шорткод і новий блоковий. Віджет з’являється тільки тоді, коли обрано Meest, а після перемикання на інший метод адресні поля повертаються на місце.

Вартість доставки — або фіксована, яку ви задали, або живий тариф Meest під обране відділення. Можна ввімкнути безкоштовну доставку від суми замовлення.

Що отримує адмін

Налаштування живуть там, де їх шукають: WooCommerce → Налаштування → Доставка → «Meest Пошта». Логін, пароль і contractID, кнопка «Перевірити доступ», місто й відділення відправника, тестовий тариф, поведінка в чекауті та ліцензія — на одному екрані. Пароль API зберігається зашифрованим.

На екрані замовлення (HPOS і класичний) з’являється блок «Meest Пошта»: створити посилку, побачити номер і штрихкод, скасувати її, оновити статус. Результат автостворення посилки на статусі пишеться нотаткою до замовлення, тож історія не губиться.

Окремий журнал — WooCommerce → «Meest shipments»: усі посилки магазину з номером, одержувачем, статусом, накладеним платежем і тарифом, з кнопками створення, скасування й оновлення статусів.

Адреса відділення потрапляє в адресу доставки замовлення, тому її видно і в листі покупцеві, і в кабінеті, і в будь-якому плагіні, який читає адресу замовлення.

Як це працює крок за кроком

1. Вводите логін, пароль і contractID з договору Meest, тиснете «Перевірити доступ» — плагін логіниться і перевіряє, що довідник відповідає.

2. Обираєте місто й відділення відправника, заповнюєте ім’я і телефон — їх Meest друкує на наліпці. Тут же можна порахувати тестовий тариф до будь-якого відділення.

3. Додаєте «Meest Пошта» у зону доставки — і метод з’являється в чекауті.

4. Покупець обирає місто й відділення, бачить вартість і оформлює замовлення. У замовленні лишаються мета-поля з відділенням, а в журналі з’являється рядок.

5. Посилку створюєте кнопкою в замовленні чи в журналі, або вмикаєте автостворення на потрібному статусі. Meest повертає номер і штрихкод; поки посилка не рушила, її можна скасувати. Статуси оновлюються кнопкою, а в Pro — щогодини за WP-Cron.

Що під капотом

Метод доставки — звичайний WC_Shipping_Method, тому зони, класи доставки й «безкоштовно від суми» працюють штатно. Довідник міст і відділень зберігається у власних таблицях плагіна, тож чекаут не ходить до Meest на кожне натискання клавіші й не падає, коли API перевізника мовчить.

Блоковий чекаут підтримано нативно: віджет реєструється як блок-інтеграція, а перевірка відділення висить на woocommerce_store_api_checkout_update_order_from_request, тому замовлення без відділення не створиться навіть в обхід інтерфейсу.

Пароль API шифрується (AES-256-CBC + HMAC), а не лежить відкритим текстом. Суми, що йдуть у Meest, беруться в гривні: якщо замовлення в іншій валюті, плагін чесно відмовиться створювати посилку й скаже про це, а для мультивалютних магазинів є фільтр mewc_order_amount_uah.

Як встановити

1. Плагіни → Додати новий → Завантажити плагін → zip із цієї сторінки → «Встановити» → «Активувати».

2. WooCommerce → Налаштування → Доставка → «Meest Пошта»: логін, пароль, contractID → «Перевірити доступ».

3. Оберіть місто й відділення відправника, заповніть ім’я і телефон, збережіть.

4. Додайте «Meest Пошта» у потрібну зону доставки — метод одразу з’явиться в чекауті.

5. За потреби ввімкніть автостворення посилки на статусі замовлення й перевірте, що WP-Cron на сайті працює (для Pro-автостатусів).