Exchange Rates

Exchange Rates #

An Exchange Rate defines the value of a Foreign Currency in terms of of the Reporting Currency. Rates can either be used for Foreign Currency Transactions or for closing Foreign Currency denominated Accounts at the end of the Reporting Period. Each Exchange Rate must have an associated (Foreign) Currency Resource and a date from which it its valid (will be used in transactions). While the end date at which the Resource is no longer valid is not required, Exchange Rates periods for the same Currency Resource cannot overlap.

Properties #

Direct Properties #

RateFloatThe value of the Foreign Currency in terms of the Reporting Currency
Valid FromDateThe date from which the Resource applies
Valid ToDateThe date after which the Resource is no longer valid

Indirect Properties #

CurrencyDictionaryThe Foreign Currency Resource associated with the Exchange Rate

Basics #

To record an Exchange Rate, you need to provide the Foreign Currency Resource id, the rate and the valid from date.

Request #

curl --location --request POST '' \
    --header "Authorization: Bearer <bearer_token>" \
    --data-raw '{
        "currency_id": 1,
        "valid_from": "2022-07-20",
        "rate": 1.5
import requests

url = ""
body = {
    "currency_id": 1,
    "valid_from": "2022-07-20",
    "rate": 1.5
headers = {"Authorization": "Bearer <bearer_token>"}

response = requests.request("POST", url, headers=headers, json=body)

var request = require('request');
var options = {
    'method': 'POST',
    'url': '',
    'headers': {'Authorization': 'Bearer <bearer_token>'},
    'body': '{
        "currency_id": 1,
        "valid_from": "2022-07-20",
        "rate": 1.5
request(options, function (error, response) {
    if (error) throw new Error(error);
$client = new Client();
$body = '{
    "currency_id": 1,
    "valid_from": "2022-07-20",
    "rate": 1.5
$request = new Request('POST', '', 
    [headers' => ['Authorization' => 'Bearer <bearer_token>']], 
$res = $client->sendAsync($request)->wait();
echo $res->getBody();
var client = new RestClient("");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
var body = "{
    \"currency_id\": \"1\",
    \"valid_from\": \"2022-07-20\",
    \"rate\": \"1.5\" 
request.AddParameter("text/plain", body,  ParameterType.RequestBody);
request.AddHeader("Authorization", "Bearer " + <bearer_token>);
IRestResponse response = client.Execute(request);

Response #

    "status": "success",
    "message": "ExchangeRate: 100.00 for Euro (EUR) from 2022-07-20 created successfully",
        "resource": {
        "valid_from": "2022-07-20T00:00:00.000000Z",
        "currency_id": 2,
        "rate": 100,
        "entity_id": 1,
        "id": 4,
        "currency": {
            "uuid": "7b87e7e9-0e23-44aa-9694-ba9ccfc0091b",
            "id": 2,
            "user_id": 1,
            "name": "Euro",
            "currency_code": "EUR"

Errors #

Below are the Errors that are returned by the Exchange Rate Resource.

Detail CodeNameDefinition
100Orphaned ItemsCannot recycle the Exchange Rate Resource because it has dependent Resources
101Missing EntityThe Exchange Rate Resource requires an existing Entity because it is used for calculating Forex differences between Transactions and these must be associated with an Entity Resource
102Overlapping Exchange RatesTo eliminate ambiguity in reporting, only one Exchange Rate Resource can be valid at a given point in time such that all Transactions recorded for the currency during the period all have the same rate