Встановлення курсу обміну валюти

Запит

URI: /api/v2/currency-exchange/set-exchange-rate?api_token={api_token}

Метод дозволяє встановити курс обміну валюти.

Запит виконується методом POST з тілом запиту у JSON форматі.

⚠️ Запит повинен містити заголовки Accept: application/json та Content-Type: application/json

Параметри URI

Метод дозволяє передати в рядку запиту наступні параметри:

Ім'я	Тип	Обов'язковий	Опис
api_token	string	Так	Токен авторизації, згенерований в особистому кабінеті

Параметри запиту

Ім'я	Тип	Обов'язковий	Опис
num_fiscal	integer	Так	Фіскальний номер каси
rates	list[object]	Так	Містить перелік валют, для яких необхідно встановити курс обміну
rates.code	string	Так	Цифровий код валюти
rates.symbol	string	Так	Літерний код валюти
rates.name	float	Так	Назва валюти
rates.sell_rate	float	Так	Курс продажу валюти
rates.buy_rate	float	Так	Курс купівлі валюти
rates.regulator	float	Так	Курс НБУ

💡 Коди валют можна переглянути у довіднику

Приклад запиту

Запит: /api/v2/currency-exchange/set-exchange-rate?api_token=42b5eaccba739f08***e7fe157eba8bf

{
    "num_fiscal": "num_fiscal",
    "rates": [
        {
            "code": 978,
            "symbol": "EUR",
            "name": "Євро",
            "sell_rate": 27.9,
            "buy_rate": 27.5,
            "regulator": 27.45
        }
    ]
}

Параметри відповіді

Ім'я	Тип	Опис
key	string
code	string	Цифровий код валюти
symbol	string	Літерний код валюти
name	string	Назва валюти
sell_rate	float	Курс продажу валюти
buy_rate	float	Курс купівлі валюти
regulator	float	Курс НБУ
created_at	string	Дата і час створення валюти

Приклад успішної відповіді

200 OK

Відповідь: /api/v2/currency-exchange/set-exchange-rate?api_token=42b5eaccba739f08***e7fe157eba8bf

[
    {
        "key": "6d45a45f-888a-4a88-9ec9-c486a5cfb9ca",
        "code": "978",
        "symbol": "EUR",
        "name": "Євро",
        "sell_rate": 27.88,
        "buy_rate": 27.45,
        "regulator": 27.45,
        "created_at": "2021-03-05 15:58:45"
    },
    {
        "key": "9c6fd466-60d6-478e-9161-1a02e40613dc",
        "code": "870",
        "symbol": "USD",
        "name": "Долар",
        "sell_rate": 27.33,
        "buy_rate": 27.21,
        "regulator": 27.31,
        "created_at": "2021-03-05 15:58:45"
    },
    {
        "key": "510089a2-2bfc-42e3-8a02-cfb9bffa5889",
        "code": "980",
        "symbol": "UAH",
        "name": "Гривня",
        "sell_rate": 1,
        "buy_rate": 1,
        "regulator": 1,
        "created_at": "2021-03-05 15:58:45"
    }
]

порада

Postman колекція (Встановлення курсу обміну валюти): https://documenter.getpostman.com/view/12128952/TWDanvq5#4d059806-8669-4abd-9ba8-2e8c5e971cbb