Ukrposhta — выбор отделения и тариф для WooCommerce

Ukrposhta Shipping for WooCommerce — плагин доставки Укрпочтой для магазинов на WooCommerce. Покупатель выбирает отделение прямо в чекауте по цепочке область → город → отделение, а стоимость доставки считается вживую через официальный eCom API Укрпочты. Данные берутся из официального Адресного классификатора, поэтому список отделений всегда актуален, а выбранный почтовый индекс сохраняется в заказе.

Плагин полностью бесплатный. Код открытый — репозиторий на GitHub (catcodestudio/woocommerce-ukrposhta-shipping), лицензия GPLv2.

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

После выбора метода «Укрпочта» в чекауте появляется виджет: покупатель выбирает область, потом город, потом конкретное отделение. Как только отделение выбрано — плагин запрашивает тариф в eCom API (с учётом веса корзины и индексов отправителя и получателя) и показывает реальную стоимость доставки. Акцентный цвет виджета настраивается под дизайн темы.

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

Метод добавляется в зону доставки WooCommerce, а креденшелы глобальные — один Bearer на весь магазин, независимо от количества зон. В настройках: тестовая среда (sandbox dev.ukrposhta.ua), тип услуги (Стандарт или Express), тариф по умолчанию на случай недоступности API и порог бесплатной доставки от суммы заказа. Выбранное покупателем отделение видно прямо в заказе — отдельный блок «Укрпочта» с городом, отделением и индексом, а также строкой в письмах и на странице благодарности.

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

1. Админ вводит Bearer eCom и индекс отправителя, добавляет метод «Укрпочта» в зону доставки.
2. Покупатель в чекауте выбирает доставку Укрпочтой — появляется пикер область → город → отделение на базе официального Адресного классификатора.
3. Плагин считает вес корзины и запрашивает тариф через эндпоинт /domestic/delivery-price; если API недоступен — подставляется фиксированная ставка из настроек.
4. Если покупатель выбрал наложенный платёж, в тариф добавляется комиссия Укрпочты за него — и исчезает, как только он переключится на предоплату.
5. Если сумма заказа превышает заданный порог — доставка становится бесплатной.
6. Покупатель оформляет заказ — выбранный почтовый индекс отделения сохраняется в заказе и доступен админу для отправления.

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

• Bearer-ключ хранится зашифрованным (at-rest), в форме настроек обратно в открытом виде не показывается.
• Справочник отделений кешируется в отдельной таблице upwc_offices, список областей — в транзиенте: чекаут не дёргает API Укрпочты при каждом открытии.
• Совместимость с HPOS (custom order tables) задекларирована официально; мета заказа снимается и на классическом чекауте, и на Store API (блочном) пути.
• Тариф учитывает вес товаров в корзине, объявленную ценность (по желанию) и комиссию за наложенный платёж — но только для тех способов оплаты, которые вы отметили как наложенный платёж.
• Выбранное отделение входит в пакет доставки WooCommerce, поэтому смена отделения или способа оплаты пересчитывает тариф, а не показывает закешированный.
• Поиск города понимает латиницу: «Drohobych» находит Дрогобыч.
• Translation-ready: текстовый домен и все строки готовы к переводу.

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

1. Скачайте ukrposhta-shipping-for-woocommerce-1.2.7.zip и установите через «Плагины → Добавить новый → Загрузить плагин».
2. Активируйте плагин — таблица кеша отделений создастся автоматически.
3. Перейдите в WooCommerce → Настройки → Доставка и добавьте метод «Укрпочта» в нужную зону.
4. Введите Bearer eCom и индекс отправителя, сохраните.
5. Включите метод — пикер отделения появится в чекауте.