Changes to the shipping cost and customs duties calculator for shipments to the United States
Changes to the customs duties calculation for shipments from Ukraine to the United States have been introduced at the request of customs authorities. Customs duties are now calculated not based on the total invoice value, but taking into account the UCGFEA (HS codes) of the invoice items, their quantity, and their value.
These changes apply to international shipments where the customs duties payer is the sender or a third party.
How does it work?
The client provides invoice item details in the request if they want to receive a calculation not only for the shipping cost but also for customs duties. Customs duties are calculated separately for each code.
Request
POST v.1.0/shipments/calculations
Applicable route
Shipments from Ukraine to the United States
Previous behavior
{
"payerType": "Sender",
"deliveryTypes": [
"standard",
"express"
],
"invoice": {
"incoterm": "DDP",
"currency": "USD",
"payerFeesCustoms": "Sender",
"cost": 125
},
"parcels": [
{
"cargoCategory": "parcel",
"insuranceCost": 125,
"rowNumber": 1,
"width": 500,
"length": 500,
"height": 500,
"actualWeight": 15000,
"volumetricWeight": 25000
}
],
"sender": {
"countryCode": "UA",
"divisionId": 4438
},
"recipient": {
"countryCode": "US",
"addressParts": {
"city": "Tucson",
"region": "AZ",
"postCode": "85730-4544",
"street": "4675 S Harrison Rd Unit 191",
"building": "1"
}
}
}The "economy" tariff is not available for shipments to the United States.
New behavior
New request fields
invoice.items
array[object]
Conditional
List of invoice items to be declared
invoice.items[].hsCode
string
Yes*
UCGFEA or HTSUS code for the United States
invoice.items[].amount
number
Yes*
Quantity of units for the invoice item
invoice.items[].cost
number
Yes*
Unit value of the invoice item in the invoice currency
General contract description https://api-portal.novapost.com/methods/methods/shipments/delivery-cost.
Response changes
The following new fields have been added to the response:
recipientPayerFeesCustomsCost- The value of this field indicates the amount of customs duties that the recipient will be required to pay if they are selected as the customs duties payer.senderPayerFeesCustomsCost- The value of this field indicates the amount of customs duties that the sender (third party) will be required to pay if they are selected as the customs duties payer.
These fields allow the sender or a third party to compare the customs duties amounts depending on who is selected as the customs duties payer. The service cost is returned in the currency of the shipment's origin country.
The total shipping cost excluding customs duties, including personal discounts, is returned in the cost field.
The total shipping cost including customs duties, excluding discounts, is returned in the price field.
Successful response
Error response (invalid HS code).
Last updated