CatCode Shipping with Ukrposhta for WooCommerce

Ukrposhta Shipping for WooCommerce integrates the official Ukrposhta (Укрпошта) API into your store:

• Checkout picker — customers choose region → city → post office, backed by the official Ukrposhta Address Classifier. The selected post index is stored on the order.
• Live tariff — domestic delivery price is fetched from the Ukrposhta eCom API (/domestic/delivery-price); a configurable flat rate is used as fallback. Optional free shipping over a threshold.
• Encrypted credentials — the Bearer key is stored obfuscated at rest.

To fetch the address classifier and the tariff you need a Ukrposhta eCom Bearer (issued by your Ukrposhta manager after signing the eCom contract). Enter it under WooCommerce → Settings → Shipping → Ukrposhta. Shipment (barcode / ТТН) creation, sticker printing and cash-on-delivery ship in a later update, once verified end-to-end against a live contract. Ukrposhta is a third-party service. This plugin is an independent integration built by CatCode; it is not affiliated with, endorsed by or sponsored by Ukrposhta. Опис українською Плагін додає доставку Укрпоштою у WooCommerce: покупець обирає область, місто і відділення прямо на сторінці оформлення замовлення, а вартість доставки рахується наживо.

• Вибір відділення з офіційного Адресного класифікатора Укрпошти — область, місто, відділення; індекс зберігається в замовленні.
• Тариф по Україні через eCom API Укрпошти (/domestic/delivery-price), з фіксованою ставкою як запасним варіантом і безкоштовною доставкою від суми замовлення.
• Міжнародний тариф за країною і вагою.
• Довідники кешуються, тож оформлення замовлення не чекає на API.
• Bearer-ключ зберігається в зашифрованому вигляді.

Створення накладної (штрихкоду), друк наліпок і післяплата — в наступному оновленні, після живої перевірки на договорі. Укрпошта — сторонній сервіс. Цей плагін є незалежною інтеграцією від CatCode і не афілійований з Укрпоштою.

1.2.0

• International shipments: the rate for a destination outside Ukraine is calculated from the country and the parcel weight (no post office involved).
• Transport type, package type, content category and tariff currency are configurable; an unavailable country/package combination reports Ukrposhta's own reason to the log instead of quoting the domestic flat rate.

1.1.1

• Source strings are now English with a bundled Ukrainian translation, so the plugin can be translated into any language.
• Checkout widget labels are translatable too - they used to be hard-coded in JavaScript.

1.1.0

• Fixed: the delivery price no longer sticks to the first quote — changing the post office (or the payment method) now re-rates the cart.
• Fixed: cash-on-delivery commission was added to every order, including prepaid ones. It is now charged only for the payment methods you list as COD.
• Added: order screen box with the chosen city, post office and post index — the meta was stored but invisible to the shop manager.
• Added: the chosen post office is shown on the thank-you page, in the customer account and in order e-mails.
• Added: the checkout refuses to go through with Ukrposhta selected but no post office chosen.
• Added: declared value is now optional — turn it off to quote a cheaper tariff without insurance.
• Added: city search falls back to transliteration, so "Drohobych" finds Дрогобич.
• Fixed: the picker no longer renders on the "order received" page and stays hidden until Ukrposhta is the selected shipping method.
• Fixed: the office cache compared local time against the database clock in UTC.
• Fixed: the tariff request never returned a price - measurements have to be sent inside parcels, and a sender index starting with 0 (01001) was cast to a number and rejected. Every quote used to fall back to the flat rate.
• Fixed: switching the payment method now refreshes the delivery price instead of leaving a stale one on screen.
• Added: the picker restores the chosen office after a page reload.

1.0.1

• Works on hosts without the mbstring extension - city search and parcel description no longer fail silently.
• Lowered requirements to WordPress 5.6 / WooCommerce 6.0 / PHP 7.4.

1.0.0

• Initial release — checkout post-office picker and live tariff.