Вибір валюти для інвойсу при створенні або оновленні міжнародної накладної з України

Ви можете вказати валюту для кожної позиції, використовуючи параметр invoice.items.currency.

Правила використання

Якщо параметр invoice.items.currency не переданий, по замовчуванню вважається, що всі значення invoice.items.cost вказані в гривнях (UAH).
Якщо параметр invoice.items.currency використано, вартість позицій (значення в invoice.items.cost) вказується у вибраній валюті.
Для коректної передачі invoice.items.currency усі позиції інвойсу повинні мати однакову валюту.
При передачі параметра invoice.items.currency API Nova Post автоматично виконує конвертацію у UAH, EUR, USD та GBP для розрахунку фактурної вартості позицій у інвойсі.
Якщо валюта позицій збігається з валютою країни призначення (наприклад, USD → США, EUR → ЄС, GBP → Велика Британія) – конвертація не виконується.

Приклади запитів

Без invoice.items.currency
{
"invoice": {
"incoterm": "DDP",
"currencyCode": "USD",
"exportReason": "Selling",
"totalCost": 1036.22,
"totalCostEur": 21.41,
"items": [
{
"hsCode": "4909004000",
"name": "Весільний декор/підставка",
"nameEng": "Wedding Decor/coaster",
"material": "Фанера",
"materialEng": "Plywood",
"actualWeight": 170,
"measurementCode": "pieces",
"amount": 1,
"cost": 1036.22 // Значення в гривні (UAH), currency не вказаний
}
]
}
}

Усі значення API вважає вказаними в UAH, далі автоматично відбувається конвертація у валюту країни призначення: ЄС → EUR, Велика Британія → GBP, США → USD.

З invoice.items.currency
{
  "invoice": {
    "incoterm": "DDP",
    "currencyCode": "USD",
    "exportReason": "Selling",
    "totalCost": 1036.22,
    "totalCostEur": 21.41,
    "items": [
      {
        "hsCode": "4909004000",
        "name": "Весільний декор/підставка",
        "nameEng": "Wedding Decor/coaster",
        "material": "Фанера",
        "materialEng": "Plywood",
        "actualWeight": 170,
        "measurementCode": "pieces",
        "currency": "USD", //--> Новий параметр валюти
        "amount": 1,
        "cost": 25.1 //--> значення у валюті вище
      }
    ]
  }
}

У цьому випадку items.cost = USD, оскільки передано items.currency.

Якщо цільова країна доставки – США, то вартість позиції уже у валюті країни призначення та конвертація фактурної вартості не потрібна, для інвойсу буде враховано надане в запиті сумарне значення усіх items.cost.

Створення відправлень

Вибір валюти для інвойсу при створенні або оновленні міжнародної накладної з України

Правила використання

Приклади запитів

Без invoice.items.currency

З invoice.items.currency