All pages
Powered by GitBook
1 of 1

Loading...

Create a file with currency reference rates

To set the reference rates for currencies, you must create a file containing the rates in JSON format. Below, you will find the file's structure, an explanation of its parameters, and a sample file with exchange rates for multiple currencies.

File structure

Here, you will find a JSON file structure.

File parameters

Below, you will find explanations about parameters in the currency reference rates file in JSON format.

  • baseCurrencyCode: The base currency code is the reporting currency, formatted as ISO 4217, e.g., EUR.

  • quoteCurrencyCode: The transaction currency other than reporting currency, formatted as ISO 4217, e.g., AUD.

  • quotationTime: The date the currency rate is between the reporting and transaction currency is applicable, formatted as ISO 8601 DateTime, e.g., 2024-12-05T12:30:00Z.

Sample file

A sample file with the reference rates for multiple currencies is below.

Sample file with all ECB quoted currencies
{
  "rates": [
    {
      "baseCurrencyCode": "EUR",
      "quoteCurrencyCode": "AUD",
      "quotationTime": "2024-12-05T12:30:00Z",
      "rateType": "REPORTING",
      "rateSource": "ECB",
      "rate": 1.6377
    }
  ],
  "skipConfirm": false
}

rateType: The parameter defining the rate purpose in the Tuum. The value in the current context must be REPORTING.

  • rateSource: The name or the identification of the entity that has defined the rate quote, e.g., ECB.

  • rate: The exchange rate of the reporting currency to the transaction currency.

  • skipConfirm: The boolean value indicates whether the uploaded exchange rates need confirmation. A value of true means confirmation is not required, while false means it is required.

  • {
      "rates": [
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "AUD",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 1.6377
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "BGN",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 1.9558
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "BRL",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 6.3219
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "CAD",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 1.4809
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "CHF",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 0.9305
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "CNY",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 7.6577
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "CZK",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 25.1460
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "DKK",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 7.4579
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "GBP",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 0.8280
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "HKD",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 8.2027
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "HUF",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 411.8000
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "IDR",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 16711.1700
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "ILS",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 3.7981
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "INR",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 89.2543
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "ISK",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 145.5000
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "JPY",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 158.5200
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "KRW",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 1494.6100
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "MXN",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 21.3860
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "MYR",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 4.6666
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "NOK",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 11.6600
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "NZD",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 1.7985
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "PHP",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 60.9460
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "PLN",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 4.2745
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "RON",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 4.9774
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "SEK",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 11.5095
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "SGD",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 1.4133
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "THB",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 35.9730
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "TRY",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 36.5975
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "USD",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 1.0540
        },
        {
          "baseCurrencyCode": "EUR",
          "quoteCurrencyCode": "ZAR",
          "quotationTime": "2024-12-05T12:30:00Z",
          "rateType": "REPORTING",
          "rateSource": "ECB",
          "rate": 19.0427
        }
      ],
      "skipConfirm": false
    }