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
| Field | Description |
|---|---|
customInfo.exchangeRate.from | The invoice currency. Must match total.currency. |
customInfo.exchangeRate.to | The local currency the tax amounts are reported in, for example AED. |
customInfo.exchangeRate.rate | The 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
- Rate provided: eezi uses
customInfo.exchangeRate. - Rate not provided: eezi determines the tax point date and applies the exchange rate for that date.
- 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).
Updated 16 days ago