# Currency code

Source: https://developer.avalara.com/avatax-for-vat/opi0372484079842/

# Currency code

Learn about the required currency code element and its usage in transactions.

**Element type:** Required

**Endpoints/models used:** [CreateTransactionModel](https://developer.avalara.com/api-reference/avatax/rest/v2/models/CreateTransactionModel/)

Your integration must allow users to specify the three-character ISO 4217 currency code for a transaction. You can add a `currencyCode` at the document level only. If a user specifies this, and this is different than the currency the tax liability needs to be reported in, then they must also provide an `exchangeRateCurrencyCode` and an `exchangeRate` for conversion to the reporting country.

**Example**

```
{
  "type": "PurchaseInvoice",
  "date": "2024-07-24",
  "companyCode": "CRUSH",
  "customerCode": "userMP",
  "code": "userMP",
  "isSellerImporterOfRecord": false,
  "businessIdentificationNo": "ATU12233456",
  "currencyCode":"EUR",
  "exchangeRate": 0.85,
  "exchangeRateCurrencyCode": "GBP",
  "exchangeRateEffectiveDate": "2024-07-24",
  ...
}
```