Changes and updates in the Nova Post API

For tracking international and domestic shipments

The list of statuses for the FullTracking and BasicTracking methods has been expanded. This allows for more detailed information on shipment movement, particularly during customs clearance and warehouse storage stages.

What has changed:

• Transparency of customs processes: statuses have been added to detail document waiting times, data verification, and customs decisions.
• Exception management: codes have been introduced for delays, packaging damage, or import bans.
• Unification: the same list of statuses is now available in both full and basic tracking.
  

The full list of codes and their descriptions is available in the documentation.

For domestic shipments (MD–MD)

The ability to arrange return delivery of goods and signed documents for clients within Moldova has been implemented.

Available scenarios:

• Return of goods (ExpBackwardGoods): initiating return delivery based on the forward shipment.
• Return of documents (ExpBackwardCreditDoc): a service for legal entities that allows receiving signed documents as a separate shipment.
  

Important restrictions:

• The Recipient is always the payer for the return delivery of documents (cashless payment).
• The service is unavailable for PUDO and parcel lockers delivery types.

Technical information

The Create Shipment and Update Shipment Document methods have been updated. New service parameters and request examples for the Moldova domestic market have been added.

For creating shipments with a list of goods

The logic for weight verification when generating international and domestic waybills with an invoice has been updated. This ensures accurate calculations and prevents errors during customs clearance.

• The total actual weight of all items in the invoice must exactly match the total actual weight of the entire shipment.
• The weight parameter is now mandatory for each product item.
  

In the Create Shipment method, the description of the actualWeight parameter within the invoice.items block has been updated. If the invoice block is passed, the parameter is mandatory for each item.

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.

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.

Technical information regarding updates to shipping rate calculation methods for shipments from Ukraine

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.

A new Webhook feature has been added, allowing you to:

1. 1
   GET /tracking-push/subscribers
   
   Get a list of all subscriptions associated with the client
2. 2
   POST /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.
3. 3
   PUT /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.
4. 4
   DELETE /tracking-push/subscribers/{id}
   
   Delete the subscription specified by its unique identifier. Deletion is irreversible and should be used with caution.
5. 5
   POST /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.
6. 6
   POST /tracking-push/subscribers/test-webhook
   
   Check Webhook functionality. At least one active subscription is required for a successful response.

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.