=== Nova Post Global International Shipping for WooCommerce ===
Contributors: catcodestudio
Tags: woocommerce, shipping, nova post, international shipping, ukraine
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Nova Post Global international shipping rates in the WooCommerce cart, calculated live from the weight and size of the order.

== Description ==

Ukrainian shops that ship abroad with Nova Post Global usually quote international delivery by hand: the customer places the order, the manager checks the NPG calculator and writes back with a price. This plugin puts that price straight into the checkout.

It adds a "Nova Post Global" shipping method to your WooCommerce zones. For every destination outside Ukraine it asks the Nova Post Global rate API (`IEW/publicCalculateCost`) for the price of the cart and shows it like any other shipping rate. Countries and weights the tariff does not cover simply do not get the method.

= Free features =

* Live Nova Post Global rate for the cart, by destination country, actual weight and dimensions.
* Global Delivery Econom (service 28) by default; another service code can be set.
* The cart is priced as one box: total weight, total volume, the longest item as the longest side.
* Defaults for products with empty weight or dimensions; weight and size units are converted from the shop's own.
* Rates are cached, so checkout refreshes do not call the API again for the same cart.
* A flat fallback price, or hiding the method, when the NPG gateway does not answer.
* Stores in another currency: a UAH exchange rate setting.
* "Test connection" button that prices a 1 kg parcel to a country of your choice and explains NPG error codes.
* Classic and block checkout, HPOS.

= Pro features =

* Heavy orders are split into several pieces within NPG limits (68 kg actual weight per piece, and by paid weight when NPG answers CALC005) instead of disappearing from the checkout.
* Markup: a percentage and a fixed amount.
* Free international shipping above an order total.
* Delivery to a Nova Post branch abroad as well as to the door.

A fresh install is simply the free tier. The 7-day Pro trial starts only when you click "Try Pro for 7 days".

= Requirements =

* A Nova Post Global API login and password, issued by Nova Post Global for your company. The regular Nova Poshta (Ukraine) API key does not work for international rates.
* The hosting must allow outgoing connections to port 8243.
* WooCommerce 7.0+, PHP 7.4+.

== Installation ==

1. Upload and activate the plugin.
2. WooCommerce → Nova Post Global: enter the API login and password, save, press "Test connection".
3. WooCommerce → Settings → Shipping: add "Nova Post Global" to the zones that cover the countries you ship to.

== Frequently Asked Questions ==

= Can I use my Nova Poshta API key? =

No. International rates come from a separate Nova Post Global API with its own login and password. Ask your Nova Post Global manager for API access.

= Why does the method not appear for some countries? =

Nova Post Global answered that the service does not cover that country (CALC004) or that the weight is outside the tariff (CALC005). Pro splits heavy orders into pieces; CALC004 cannot be fixed by the plugin.

= What happens if the NPG API is down? =

By default the method is hidden. You can show a flat price instead in the settings.

== Changelog ==

= 1.0.0 =
* Initial release.
