Новий параметр InsuranceCurrencyCode для відправлень

Endpoint: POST / PUT v.1.0/shipments

Ми спростили процес декларування оціночної вартості (insuranceCost) для міжнародних відправлень.

Що нового?

Раніше значення insuranceCost потрібно було обов'язково вказувати у валюті країни відправника. Це означало, що клієнти, які відправляють з Європи чи інших регіонів, мали самостійно конвертувати оголошену вартість перед створенням запиту.

Тепер у масиві parcels доступний новий опціональний параметр insuranceCurrencyCode. Він дозволяє вказати валюту оціночної вартості напряму — а наша система виконає конвертацію автоматично.

Як це працює:

• Якщо insuranceCurrencyCode не передано — все працює як раніше. Система очікує insuranceCost у валюті країни відправника.
• Якщо insuranceCurrencyCode передано — система автоматично конвертує оголошену вартість у валюту країни відправника за актуальним курсом. Жодних додаткових кроків з вашого боку.

Переваги:

• Не потрібно реалізовувати логіку конвертації валют на своєму боці.
• Декларуйте вартість у валюті, яка є зручною для вашого бізнесу (EUR, USD, CZK тощо).
• Менше помилок інтеграції через невідповідність валют.

Приклад:

Відправлення з Молдови (MD) з оціночною вартістю у доларах США:

{
  "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
      }
    ]
  }
}

У цьому прикладі система автоматично конвертує 25.50 USD у молдавський лей (MDL) перед обробкою. Клієнту не потрібно знати чи розраховувати обмінний курс.

Примітка: Якщо insuranceCurrencyCode використовується, усі об'єкти в масиві parcels повинні містити однаковий код валюти.