CatCode Shipping with Ukrposhta for WooCommerce integrates the official Ukrposhta (\u0423\u043a\u0440\u043f\u043e\u0448\u0442\u0430) API into your store:<\/p>\n\n
\/domestic\/delivery-price<\/code>); a configurable flat rate is used as fallback. Optional free shipping over a threshold.<\/li>\n- Encrypted credentials<\/strong> \u2014 the Bearer key is stored obfuscated at rest.<\/li>\n<\/ul>\n\n
To fetch the address classifier and the tariff you need a Ukrposhta eCom Bearer<\/strong> (issued by your Ukrposhta manager after signing the eCom contract). Enter it under WooCommerce \u2192 Settings \u2192 Shipping \u2192 Ukrposhta<\/strong>.<\/p>\n\nShipment (barcode \/ \u0422\u0422\u041d) creation, sticker printing and cash-on-delivery ship in a later update, once verified end-to-end against a live contract.<\/p>\n\n
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.<\/p>\n\n
External services<\/h3>\n\n
This plugin connects to the official Ukrposhta eCom API so the store can show real\npost offices and real delivery prices at checkout. Nothing is sent anywhere else.<\/p>\n\n
Ukrposhta eCom API and Address Classifier<\/strong> (https:\/\/www.ukrposhta.ua, or\nhttps:\/\/dev.ukrposhta.ua when the Sandbox option is enabled).<\/p>\n\n\n- When: while a customer is choosing a post office at checkout, and whenever the\ndelivery price for a cart has to be quoted.<\/li>\n
- What is sent for the address lookup: the region, the city name being typed and\nthe chosen city id. No customer name, e-mail, phone or order data.<\/li>\n
- What is sent for the price quote: the sender post index from the settings, the\nchosen post office index, the total weight and dimensions of the cart, and -\nonly when you enable them - the order total as the declared value and the\ncash-on-delivery amount.<\/li>\n
- Authentication: the eCom Bearer key you enter in the plugin settings.<\/li>\n
- Terms of service: https:\/\/www.ukrposhta.ua\/ua\/informatsiia-pro-poslugu<\/li>\n
- Privacy policy: https:\/\/www.ukrposhta.ua\/ua\/polityka-konfidentsiinosti<\/li>\n<\/ul>\n\n
Using this plugin therefore means the store agrees to Ukrposhta's terms; the key\nis issued by Ukrposhta after an eCom contract is signed.<\/p>\n\n\n
\n- Upload the plugin to
\/wp-content\/plugins\/<\/code> and activate it.<\/li>\n- Go to WooCommerce \u2192 Settings \u2192 Shipping, add the Ukrposhta<\/strong> method to a shipping zone.<\/li>\n
- Enter your eCom Bearer and sender postcode. Save.<\/li>\n
- Enable the method. The office picker appears on the checkout.<\/li>\n<\/ol>\n\n\n
\nDo I need a Ukrposhta contract?<\/h3><\/dt>\nYes. The Address Classifier and tariff both require a Bearer issued by Ukrposhta after signing the eCom contract.<\/p><\/dd>\n
Does it support the block checkout?<\/h3><\/dt>\nThe office picker targets the classic checkout. Order meta is also captured on the Store API (block) checkout path.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.2.7<\/h4>\n\n\n- 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.<\/li>\n
- Changed: while the full version is active, this copy switches itself off instead of loading next to it (no more PHP warnings).<\/li>\n<\/ul>\n\n
1.2.6<\/h4>\n\n\n- Fixed: uninstalling the plugin now also removes its settings (woocommerce_ukrposhta_settings, including the API tokens) and the city search cache.<\/li>\n<\/ul>\n\n
1.2.5<\/h4>\n\n\n- 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.<\/li>\n<\/ul>\n\n
1.2.4<\/h4>\n\n\n- 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.<\/li>\n<\/ul>\n\n
1.2.3<\/h4>\n\n\n- 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.<\/li>\n
- 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.<\/li>\n
- Switching from Ukrposhta to another method puts the shopper's own address back into the fields instead of the office.<\/li>\n<\/ul>\n\n
1.2.2<\/h4>\n\n\n- 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<\/code> inputs that the block checkout does not have, wrote the address into classic #shipping_*<\/code> field ids, and re-mounted only on jQuery's updated_checkout<\/code>, which the block checkout never fires. All four now handle both checkouts.<\/li>\n- 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.<\/li>\n
- The script is also enqueued when the Checkout block sits on a page other than the one configured as the WooCommerce checkout page.<\/li>\n<\/ul>\n\n
1.2.1<\/h4>\n\n\n- 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.<\/li>\n<\/ul>\n\n
1.2.0<\/h4>\n\n\n- International shipments: the rate for a destination outside Ukraine is calculated from the country and the parcel weight (no post office involved).<\/li>\n
- 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.<\/li>\n<\/ul>\n\n
1.1.1<\/h4>\n\n\n- Source strings are now English with a bundled Ukrainian translation, so the plugin can be translated into any language.<\/li>\n
- Checkout widget labels are translatable too - they used to be hard-coded in JavaScript.<\/li>\n<\/ul>\n\n
1.1.0<\/h4>\n\n\n- Fixed: the delivery price no longer sticks to the first quote \u2014 changing the post office (or the payment method) now re-rates the cart.<\/li>\n
- 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.<\/li>\n
- Added: order screen box with the chosen city, post office and post index \u2014 the meta was stored but invisible to the shop manager.<\/li>\n
- Added: the chosen post office is shown on the thank-you page, in the customer account and in order e-mails.<\/li>\n
- Added: the checkout refuses to go through with Ukrposhta selected but no post office chosen.<\/li>\n
- Added: declared value is now optional \u2014 turn it off to quote a cheaper tariff without insurance.<\/li>\n
- Added: city search falls back to transliteration, so \"Drohobych\" finds \u0414\u0440\u043e\u0433\u043e\u0431\u0438\u0447.<\/li>\n
- Fixed: the picker no longer renders on the \"order received\" page and stays hidden until Ukrposhta is the selected shipping method.<\/li>\n
- Fixed: the office cache compared local time against the database clock in UTC.<\/li>\n
- Fixed: the tariff request never returned a price - measurements have to be sent inside
parcels<\/code>, 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.<\/li>\n- Fixed: switching the payment method now refreshes the delivery price instead of leaving a stale one on screen.<\/li>\n
- Added: the picker restores the chosen office after a page reload.<\/li>\n<\/ul>\n\n
1.0.1<\/h4>\n\n\n- Works on hosts without the mbstring extension - city search and parcel description no longer fail silently.<\/li>\n
- Lowered requirements to WordPress 5.6 \/ WooCommerce 6.0 \/ PHP 7.4.<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- Initial release \u2014 checkout post-office picker and live tariff.<\/li>\n<\/ul>","raw_excerpt":"Ukrposhta (\u0423\u043a\u0440\u043f\u043e\u0448\u0442\u0430) shipping for WooCommerce \u2014 post office picker at checkout and live delivery tariff.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/358753","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=358753"}],"author":[{"embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/catcodestudio"}],"wp:attachment":[{"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=358753"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=358753"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=358753"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=358753"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=358753"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=358753"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}