Bring-Your-Own-Rates (BYOR)

Exchange Rates

Some tax authorities require tax amounts to be reported in the local currency, even when the invoice is issued in another currency. eezi handles this conversion for you and gives you two ways to set the exchange rate:

  • Bring-Your-Own-Rate: you send the rate, and eezi uses it as is.
  • eezi Calculated Rate: you leave the rate out, and eezi determines it for you.

If the invoice is already in the local currency, no rate is needed.

Bring Your Own Rate

Send the rate in customInfo.exchangeRate and eezi applies it directly. This is the best option when:

  • Your ERP or accounting system has already applied a rate to the invoice
  • You need the e-invoice to match your financial records exactly
FieldDescription
customInfo.exchangeRate.fromThe invoice currency. Must match total.currency.
customInfo.exchangeRate.toThe local currency the tax amounts are reported in, for example AED.
customInfo.exchangeRate.rateThe number of units of the to currency for one unit of the from currency.
💡

For example, if 1 USD = 3.6725 AED, send 3.6725.

eezi Calculated Rate

If customInfo.exchangeRate is not provided, eezi determines the tax point date from the date fields on the submitted invoice and applies the exchange rate for that date. The date fields used and the rate source vary by country. See the country pages for details.

This means:

  • No manual rate entry is needed
  • The rate follows the tax point date, in line with local tax and eezi rules

How It Works

  1. Rate provided: eezi uses customInfo.exchangeRate.
  2. Rate not provided: eezi determines the tax point date and applies the exchange rate for that date.
  3. Conversion: eezi converts the tax amounts and includes them on the e-invoice in the local currency.

Example

An invoice issued in USD to a UAE buyer, with your own rate:

{
  "total": {
    "amount": 50,
    "currency": "USD"
  },
  "customInfo": {
    "from": "USD",
    "to": "AED",
    "exchangeRate": 3.6725
  }
}

With this rate, every USD 1.00 of tax is reported as AED 3.6725. For example, USD 50.00 of VAT is reported as AED 183.63 (50.00 × 3.6725).


Did this page help you?