Changes to the Delivery Cost Calculator in Europe

Due to customs legislation requirements, the calculation of customs duties is changing for certain European countries (countries where Nova Post operates) for shipments from Ukraine:

• Austria
• Belgium
• United Kingdom
• Estonia
• Spain
• Italy
• Latvia
• Lithuania
• Netherlands
• Germany
• Poland
• Romania
• Slovakia
• Hungary
• France
• Czech Republic

For the specified countries, customs duties are calculated taking into account unique UCGFEA (HS codes) in the invoice, the export reason, the VAT rate for the recipient's country, and whether the sender has an IOSS code (a special electronic identifier and system in the EU that allows VAT to be paid when selling and importing goods worth up to EUR 150 directly through a marketplace). The customs duty also depends on whether the recipient is an individual or a legal entity.

How does it work?

For the correct calculation of customs duties in cases where the client wants to pay the customs duties themselves (as the sender or as a third party), the client passes the invoice item data in the request body to the calculator, specifies the reason, and adds the IOSS code in the sender information block — in the same way as when creating an MEN.

Request

POST v.1.0/shipments/calculations

Previous behavior

{
  "payerType": "ThirdPerson",
  "payerContractNumber": "1111111",
  "deliveryTypes": [
    "standard"
  ],
  "invoice": {
    "incoterm": "DDP",
    "currency": "EUR",
    "payerFeesCustoms": "Sender",
    "cost": 100
  },
  "parcels": [
    {
      "cargoCategory": "parcel",
      "insuranceCost": 100,
      "rowNumber": 1,
      "width": 500,
      "length": 500,
      "height": 500,
      "actualWeight": 1000,
      "volumetricWeight": 25000
    }
  ],
  "sender": {
    "countryCode": "UA",
    "divisionId": 4438,
    "divisionNumber": "-"
  },
  "recipient": {
    "countryCode": "CZ",
    "divisionId": 1834946,
    "addressParts": {}
  }
}

New behavior

{
  "payerType": "ThirdPerson",
  "payerContractNumber": "1111111",
  "deliveryTypes": [
    "standard"
  ],
  "invoice": {
    "incoterm": "DDP",
    "currency": "EUR",
    "payerFeesCustoms": "ThirdPerson",
    "cost": 125,
     // new fields that affect the calculation//
    "exportReason": "Selling", 
    "items": [
            {
                "hsCode": "4411149200",
                "amount": 5,
                "cost": 25
            }
      ]
    // ---- //
  },
  "parcels": [
    {
      "cargoCategory": "parcel",
      "insuranceCost": 125,
      "rowNumber": 1,
      "width": 500,
      "length": 500,
      "height": 500,
      "actualWeight": 1000,
      "volumetricWeight": 25000
    }
  ],
  "sender": {
    "companyTin": "11111",
    "countryCode": "UA",
    "divisionId": 4438,
    "divisionNumber": "-",
    "ioss": null // new field that affects the calculation
  },
  "recipient": {
    "companyTin": "111111", // new field that affects the calculation
    "countryCode": "CZ",
    "divisionId": 1834946,
    "addressParts": {}
  }
}

Fields added to the request or affecting the calculation

Field	Type	Required	Possible values / Description
exportReason	string · enum	Optional	ForPersonalPurposes Selling Repair Return Other
payerFeesCustoms	string · enum	Optional	Sender Recipient ThirdPerson
invoice.items	array[object]	Optional	List of invoice items to be declared
invoice.items[].hsCode	string	Yes*	UCGFEA code or HS code for Europe
invoice.items[].amount	number	Yes*	Number of units of the invoice item
invoice.items[].cost	number	Yes*	Cost per item in the invoice currency
sender.ioss	string · max: 12	Optional	Sender's IOSS code
recipient.companyTin	string · max: 20	Optional	National company registration number

General contract description: Розрахунок вартості доставки | API Docs | NovaPost

Please note that failure to provide data on the codes or a value for the exportReason field may result in an incorrect calculation that differs from the actual calculation after the MEN is created.

Customs duties in the response are separated into the following fields:

• recipientPayerFeesCustomsCost - The value of this field shows the amount of customs duties that the recipient will have to pay if they are selected as the payer of customs duties.
• senderPayerFeesCustomsCost - The value of this field shows the amount of customs duties that the sender (third party) will pay if they are selected as the payer of customs duties.

These fields allow the sender or third party to compare the amounts of customs duties depending on who is selected as the payer of customs duties. The service cost is returned in the currency of the country from which the parcel is sent.

The total delivery cost excluding customs duties and including personal discounts is displayed in the cost field.

The total delivery cost including customs duties and excluding discounts is displayed in the price field.