New insuranceCurrencyCode parameter for shipments

Endpoint: POST / PUT v.1.0/shipments

We've made it easier to declare the insurance value (insuranceCost) for international shipments.

What's new?

Previously, insuranceCost had to be provided strictly in the currency of the sender's country. This meant that clients shipping from Europe or other regions had to manually convert the declared value before submitting the request.

Now, a new optional parameter insuranceCurrencyCode is available in the parcels array. It allows you to specify the currency of the declared value directly — and our system will handle the conversion automatically.

How it works:

• If insuranceCurrencyCode is not provided — everything works as before. The system expects insuranceCost in the sender's country currency.
• If insuranceCurrencyCode is provided — the system automatically converts the declared value to the sender's country currency using the current exchange rate. No extra steps required on your side.

Benefits:

• No need to implement currency conversion logic on your side.
• Declare values in the currency that is natural for your business (EUR, USD, CZK, etc.).
• Fewer integration errors caused by currency mismatches.

Example:

Shipment from Moldova (MD) with insurance value declared in US Dollars:

{
  "parcels": [
    {
      "cargoCategory": "parcel",
      "parcelDescription": "Electronics accessories",
      "insuranceCost": 25.50,
      "insuranceCurrencyCode": "USD",
      "rowNumber": 1,
      "width": 300,
      "length": 400,
      "height": 150,
      "actualWeight": 1500
    }
  ],
  "invoice": {
    "incoterm": "DAP",
    "currency": "USD",
    "exportReason": "Selling",
    "cost": 25.50,
    "items": [
      {
        "id": "1",
        "hsCode": "85177900",
        "name": "Phone case",
        "nameEng": "Phone case",
        "material": "plastic",
        "materialEng": "plastic",
        "measurementCode": "pieces",
        "amount": 1,
        "cost": 25.50,
        "actualWeight": 1500
      }
    ]
  }
}

In this example, the system will automatically convert 25.50 USD to Moldovan Leu (MDL) before processing. The client does not need to know or calculate the exchange rate.

Note: If insuranceCurrencyCode is used, all parcels in the request must specify the same currency code.

---