Укр
Вибір валюти для інвойсу
integration
Методи

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

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

Ви можете вказати валюту для кожної позиції, використовуючи параметр 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.