Eng
Selecting the currency for the invoice
integration
Methods

Creating shipments

Selecting the currency for an invoice when creating or updating an international waybill from Ukraine

You can specify the currency for each item using the invoice.items.currency parameter.

Terms of Use

  • If the invoice.items.currency parameter is not passed, it is assumed by default that all invoice.items.cost values are specified in hryvnia (UAH).
  • If the invoice.items.currency parameter is used, the cost of items (values in invoice.items.cost) is specified in the selected currency.
  • For correct transmission of invoice.items.currency, all invoice items must have the same currency.
  • When the invoice.items.currency parameter is transmitted, the Nova Post API automatically converts to UAH, EUR, USD, and GBP to calculate the invoice value of the items in the invoice.
  • If the currency of the items matches the currency of the destination country (for example, USD → USA, EUR → EU, GBP → UK), the conversion is not performed.

Examples of queries

  • Without 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 // Value in hryvnia (UAH), currency not specified
    }
    ]
    }
    }

All API values are considered to be in UAH, then automatically converted into the currency of the destination country: EU → EUR, UK → GBP, USA → USD.

  • With 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", //--> New currency parameter
            "amount": 1,
            "cost": 25.1 //--> value in currency above
          }
        ]
      }
    }

In this case, items.cost = USD, since items.currency is transferred.

If the destination country is the United States, the cost of the item is already in the currency of the destination country and conversion of the invoice value is not required. The total value of all items.cost provided in the request will be taken into account for the invoice.