Changes and updates in the Nova Post API
We are constantly developing API methods and adding new features. On this page, you can find out about the latest updates.
- New Method for Determining Customs Duty Payment Eligibility for International Express Shipments from Ukraine
For international shipping from Ukraine
A new method has been introduced that allows users to check whether the sender in Ukraine is eligible to pay customs duties for a shipment to a specific destination country. Upon request, customers receive the following information:- Eligibility confirmation: whether the sender can pay customs duties for the shipment to the specified destination country;
- Maximum value threshold: the maximum shipment value (in the destination country's currency) for which a customs duty payer can be designated. If this threshold is exceeded, the recipient always becomes the payer.
- New Parameter Added to Determine Customs Duty Payer for International Express Waybills
To facilitate the creation and updating of International Express Waybills (IEW) from Ukraine via the Client API, a new parameter has been introduced to specify the party responsible for customs duty payments.
Available parameter values:- ThirdPerson
- Sender
- Recipient
The option for the sender to pay customs duties depends on the destination country's regulations. A dedicated method has been provided to check if someone other than the recipient can pay customs duties in a specific country, and to determine the maximum shipment value (in the destination currency) for which the sender is eligible to pay.
- Mandatory Requirement: If the destination country allows the sender to pay duties, providing this parameter is mandatory when creating or updating a waybill.
- Default Behavior: If the parameter is not provided, the Client API will default the payer to the Recipient.
- Value Threshold: If the total shipment value exceeds the maximum threshold allowed for sender payment, the Recipient will automatically be designated as the payer.
- Shipping Calculator Updates
International Shipping from Ukraine
Customs Duty Calculation by Payer
Customs duties may vary depending on the payer’s country. A new field has been added to the shipping calculator, allowing you to specify the payer: the receiver, the sender, or a third party. The duty amount will now be calculated based on the selected party responsible for the payment.
Streamlined Tax Calculation Parameters
We have removed redundant parameters to simplify tax calculation. Tax details and the total value field are now conveniently located within a single block.
- Ability to specify the invoice currency when creating or updating an international waybill
Users can now specify the currency for each item in an invoice when exporting goods from Ukraine abroad. This allows customs documents to be correctly generated in accordance with the actual currency of sale. If the currency is not specified, UAH is used by default.
- Real-time shipment status updates are now available
A new Webhook feature has been added, allowing you to:
- 1
- 2POST /tracking-push/subscribers
Create a new subscription and receive tracking notifications. There are different types of subscriptions, such as individual or corporate, and they are necessary for customers who want to receive real-time updates on the status of their shipment. - 3PUT /tracking-push/subscribers/{id}
Update existing subscription details such as callback URL, activation status, event types, etc. This is necessary to change subscription settings for customers who want to control how they receive tracking notifications. - 4DELETE /tracking-push/subscribers/{id}
Delete the subscription specified by its unique identifier. Deletion is irreversible and should be used with caution. - 5POST /tracking-push/subscribers/{id}/numbers
Add shipment numbers to an existing subscription specified by its unique identifier. The numbers are required to track specific shipments associated with the subscription. - 6POST /tracking-push/subscribers/test-webhook
Check Webhook functionality. At least one active subscription is required for a successful response.
- Setting up cash on delivery when creating an international invoice
Available destinations:
- Poland → Ukraine
- Romania → Moldova (in test mode)
In the future, there are plans to expand the service to other countries and delivery destinations: both for shipments between countries and for domestic shipments within Europe.
To activate the “Pay on Delivery” service for your customers, please contact your personal manager.


