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-автостатусов).