CatCode Shipping with Ukrposhta for WooCommerce

CatCode Shipping with Ukrposhta 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.

1.2.7

• Fixed: while the full version from catcode.com.ua is installed, deleting this copy keeps the shared settings and the post office table, so the full version goes on working with them. Without the full version, deleting still removes everything.
• Changed: while the full version is active, this copy switches itself off instead of loading next to it (no more PHP warnings).

1.2.6

• Fixed: uninstalling the plugin now also removes its settings (woocommerce_ukrposhta_settings, including the API tokens) and the city search cache.

1.2.5

• Fixed: a guest who creates an account at checkout (or on the order confirmation page) no longer gets the post office as the new account's address.

1.2.4

• Fixed: after an Ukrposhta order WooCommerce saved the post office as the logged-in shopper's billing and shipping address (block and classic checkout), so the next checkout offered the office instead of the shopper's own address. The order still gets the office; the account keeps the shopper's address.

1.2.3

• Fixed: an office picked earlier no longer leaks into an order shipped by another method (courier, Nova Poshta) - such orders used to show an "Ukrposhta post office" row in the e-mails and on the order screen.
• Fixed: on the block checkout, when the only available rate was another method, the picker still opened and wrote the office into the address fields; the chosen rate is now read from the cart. The international rate no longer opens the post-office picker either.
• Switching from Ukrposhta to another method puts the shopper's own address back into the fields instead of the office.

1.2.2

• The post-office picker now works on the block-based Checkout (the "Checkout" block), where it did not appear at all: the customer chose "Ukrposhta" and had no way to pick a region, a city or an office. The widget mounted only into a container the classic checkout prints, read the chosen rate from classic shipping_method inputs that the block checkout does not have, wrote the address into classic #shipping_* field ids, and re-mounted only on jQuery's updated_checkout, which the block checkout never fires. All four now handle both checkouts.
• A block checkout order can no longer be placed with the Ukrposhta rate and no post office - the same check the classic checkout already had now also runs on the Store API path.
• The script is also enqueued when the Checkout block sits on a page other than the one configured as the WooCommerce checkout page.

1.2.1

• Security: stored API keys are now encrypted with AES-256 (OpenSSL) instead of the old XOR obfuscation, which some hosting antivirus scanners flagged and deleted. Keys saved by earlier versions keep working.

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.