How to Use a Custom Exchange Rate Source for Invoices and Booking Engine

🔁 Using a Custom Exchange Rate Source in Invoice Details

You can now select a custom source for exchange rates directly in the Invoice Details → Custom Currency section.

🔍 How to Enable and Access This Setting

To see and use this feature:

• Go to Invoice Details → Custom Currency
• Turn ON the Use custom currency toggle

⚠️ This feature is currently available only for SabeeApp accounts in Turkey and Hungary.

🌍 Default Exchange Rate Sources

Each country has a default exchange rate source, but you can choose a different one if needed:

🇭🇺 Hungarian SabeeApp Accounts

• Default: Hungarian National Bank (MNB)
• Available Options:
  • MNB
  • Floatrates (previous default)

🇹🇷 Turkish SabeeApp Accounts

• Default: Central Bank of the Republic of Turkey
• Available Options:
  • Turkish National Bank
  • Floatrates (previous default)

📝 Changing the source is optional. If you’re happy with Floatrates, no action is required.

‼️ When using the Turkish National Bank, we apply the bid (buy) rate, in line with Turkish legal requirements.

Exchange rates are updated daily, as soon as they are published and made available via the national bank’s API. No new rates are published on weekends or bank holidays.

📊 How Rates Are Displayed

In the Custom Currencies Table, rates follow this format:

1 [base currency] = [custom currency amount] ([rate date])

Example:

If your SabeeApp account’s currency is HUF, the source is MNB, and you’ve added EUR:

1 HUF = 0.00023245345 EUR (2025-06-20)

Base Currency by Source:

⚠️ In some cases (e.g. Turkish accounts with EUR as default currency), the table may display something like 1 TRY = 1. This is only a display issue – the system still uses the correct EUR–TRY rate in calculations.

Wherever exchange rates are used in the system, the selected source will now apply.

❗ Exception: For Hungarian accounts, invoicing always uses MNB, even if another source is selected.

🛟 Exchange Rate Fallback Logic

The system has built-in fallback handling if data from your chosen exchange rate source is missing or unavailable.

📅 If the selected date is in the past:

• If we already have the rate → we use it.
• If not:
  • We try to fetch it via API
  • If the API call succeeds → we use it.
  • If the API call fails → we fall back to Floatrates.

📅 If the selected date is today:

• If the rate is already published → we use it.
• If not yet published → we use the most recent available rate (e.g., from yesterday).

📅 If the selected date is in the future:

• We use the latest available rate from your chosen source (usually today’s).

Example – Past Date:

On June 20, the source is set to Turkish National Bank, and USD is a custom currency.

If an invoice is created for June 6, we fetch the TRY–USD rate for June 6 via API.

🧾 Exchange Rates in the Booking Engine

If a guest selects a currency in the Booking engine, and that currency is also configured in your Custom Currencies, the system will:

• Use your selected exchange rate source to convert values on the Booking Engine.

⚠️ If the selected source doesn’t support that currency, we’ll fall back to Floatrates for conversion.