Title: CatCode Shipping with Ukrposhta for WooCommerce
Author: CatCode
Published: <strong>August 25, 2026</strong>
Last modified: August 30, 2026

---

Search plugins

![](https://ps.w.org/catcode-shipping-with-ukrposhta-for-woocommerce/assets/banner-
772x250.png?rev=3664632)

![](https://ps.w.org/catcode-shipping-with-ukrposhta-for-woocommerce/assets/icon-
256x256.png?rev=3664632)

# CatCode Shipping with Ukrposhta for WooCommerce

 By [CatCode](https://profiles.wordpress.org/catcodestudio/)

[Download](https://downloads.wordpress.org/plugin/catcode-shipping-with-ukrposhta-for-woocommerce.1.2.0.zip)

 * [Details](https://wordpress.org/plugins/catcode-shipping-with-ukrposhta-for-woocommerce/#description)
 * [Reviews](https://wordpress.org/plugins/catcode-shipping-with-ukrposhta-for-woocommerce/#reviews)
 *  [Installation](https://wordpress.org/plugins/catcode-shipping-with-ukrposhta-for-woocommerce/#installation)
 * [Development](https://wordpress.org/plugins/catcode-shipping-with-ukrposhta-for-woocommerce/#developers)

 [Support](https://wordpress.org/support/plugin/catcode-shipping-with-ukrposhta-for-woocommerce/)

## Description

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 і не
афілійований з Укрпоштою.

### External services

This plugin connects to the official Ukrposhta eCom API so the store can show real

post offices and real delivery prices at checkout. Nothing is sent anywhere else.

**Ukrposhta eCom API and Address Classifier** (https://www.ukrposhta.ua, or
 https://
dev.ukrposhta.ua when the Sandbox option is enabled).

 * When: while a customer is choosing a post office at checkout, and whenever the
   
   delivery price for a cart has to be quoted.
 * What is sent for the address lookup: the region, the city name being typed and
   
   the chosen city id. No customer name, e-mail, phone or order data.
 * What is sent for the price quote: the sender post index from the settings, the
   
   chosen post office index, the total weight and dimensions of the cart, and – 
   only when you enable them – the order total as the declared value and the cash-
   on-delivery amount.
 * Authentication: the eCom Bearer key you enter in the plugin settings.
 * Terms of service: https://www.ukrposhta.ua/ua/informatsiia-pro-poslugu
 * Privacy policy: https://www.ukrposhta.ua/ua/polityka-konfidentsiinosti

Using this plugin therefore means the store agrees to Ukrposhta’s terms; the key

is issued by Ukrposhta after an eCom contract is signed.

## Screenshots

[⌊The Ukrposhta method and the post office picker in the WooCommerce checkout.⌉⌊
The Ukrposhta method and the post office picker in the WooCommerce checkout.⌉[

The Ukrposhta method and the post office picker in the WooCommerce checkout.

[⌊Region, city and post office selected — the index is stored on the order.⌉⌊Region,
city and post office selected — the index is stored on the order.⌉[

Region, city and post office selected — the index is stored on the order.

[⌊Plugin settings: eCom Bearer, sender postcode, fallback rate and free shipping
threshold.⌉⌊Plugin settings: eCom Bearer, sender postcode, fallback rate and free
shipping threshold.⌉[

Plugin settings: eCom Bearer, sender postcode, fallback rate and free shipping threshold.

[⌊The chosen post office on the order screen in the admin.⌉⌊The chosen post office
on the order screen in the admin.⌉[

The chosen post office on the order screen in the admin.

## Installation

 1. Upload the plugin to `/wp-content/plugins/` and activate it.
 2. Go to WooCommerce  Settings  Shipping, add the **Ukrposhta** method to a shipping
    zone.
 3. Enter your eCom Bearer and sender postcode. Save.
 4. Enable the method. The office picker appears on the checkout.

## FAQ

### Do I need a Ukrposhta contract?

Yes. The Address Classifier and tariff both require a Bearer issued by Ukrposhta
after signing the eCom contract.

### Does it support the block checkout?

The office picker targets the classic checkout. Order meta is also captured on the
Store API (block) checkout path.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“CatCode Shipping with Ukrposhta for WooCommerce” is open source software. The following
people have contributed to this plugin.

Contributors

 *   [ CatCode ](https://profiles.wordpress.org/catcodestudio/)

[Translate “CatCode Shipping with Ukrposhta for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/catcode-shipping-with-ukrposhta-for-woocommerce)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/catcode-shipping-with-ukrposhta-for-woocommerce/),
check out the [SVN repository](https://plugins.svn.wordpress.org/catcode-shipping-with-ukrposhta-for-woocommerce/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/catcode-shipping-with-ukrposhta-for-woocommerce/)
by [RSS](https://plugins.trac.wordpress.org/log/catcode-shipping-with-ukrposhta-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 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.

## Meta

 *  Version **1.2.0**
 *  Last updated **1 day ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.6 or higher **
 *  Tested up to **7.1**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [Відділення](https://wordpress.org/plugins/tags/%d0%b2%d1%96%d0%b4%d0%b4%d1%96%d0%bb%d0%b5%d0%bd%d0%bd%d1%8f/)
   [доставка](https://wordpress.org/plugins/tags/%d0%b4%d0%be%d1%81%d1%82%d0%b0%d0%b2%d0%ba%d0%b0/)
   [укрпошта](https://wordpress.org/plugins/tags/%d1%83%d0%ba%d1%80%d0%bf%d0%be%d1%88%d1%82%d0%b0/)
 *  [Advanced View](https://wordpress.org/plugins/catcode-shipping-with-ukrposhta-for-woocommerce/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/catcode-shipping-with-ukrposhta-for-woocommerce/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/catcode-shipping-with-ukrposhta-for-woocommerce/reviews/)

## Contributors

 *   [ CatCode ](https://profiles.wordpress.org/catcodestudio/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/catcode-shipping-with-ukrposhta-for-woocommerce/)