# How do Exchange Rates work in the system?

In XoroERP system, you will have one home currency. This is the currency in which you will file your Tax Return. On top of that home currency, multiple foreign currencies are available to handle transactions with vendors/customers dealing in various currencies. To manage this, you can add the exchange rates for these foreign currencies using the "**Add Exchange Rate**" module.

Once a foreign currency is added here you have the option of creating accounts and transactions with that currency. In addition, every 4 hours the exchange rate for foreign currencies is updated from a live 3rd party API integration so that you will always have the latest rate.

When you open a module, for instance, the Sales Order module, and select a foreign customer the exchange rate field will automatically populate with the system rate (the system rate is shown above on the “Add Exchange Rate” module).

### Adding Exchange Rate

You can add an exchange rate for any currency you plan to use for transactions. To add the exchange rate, you will begin by specifying the currency and then adding the current exchange rate in the system. After that, the rates will be automatically updated in the system.

{% hint style="info" %}
To add the exchange rate, go to **Menu > Utilities > Exchange Rate > Add Exchange Rate**
{% endhint %}

In the Exchange Rates module, the home currency or base currency is displayed at the top.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2F6EXDmXWhrwaB71MA98u6%2Fimage.png?alt=media&#x26;token=3eeb39c7-7080-434a-94b8-6aa9bdbfe0af" alt=""><figcaption></figcaption></figure>

#### Add Exchange Rate Fields

<table><thead><tr><th width="177">Field</th><th>Description</th></tr></thead><tbody><tr><td>Select Currency</td><td>Select the currency for which you want to add the exchange rate from this dropdown option.</td></tr><tr><td>Rate</td><td>Enter the current value of the selected currency compared to your base currency.</td></tr></tbody></table>

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FFpIoalzSD2pZV3SE8AeG%2Fimage.png?alt=media&#x26;token=6cc0ac8d-71b9-497c-9fcf-31e1d8a36c90" alt=""><figcaption></figcaption></figure>

After entering the details, click on "Add/Update".

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2Fk0PMpgfcDlROkuEw3fd7%2Fimage.png?alt=media&#x26;token=686b4fa3-d7b7-4a5e-9b04-07a53ba2a116" alt=""><figcaption></figcaption></figure>

The currency will be added to the section below, and now you can make transactions in the foreign currency.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FgtJoNgUfEwGlAKVGC1JM%2Fimage.png?alt=media&#x26;token=1237105d-b53c-4312-af40-c15682600e68" alt=""><figcaption></figcaption></figure>

### **Updating Exchange Rate manually**

The exchange rate will be updated automatically in the system. However, you have the option to update the exchange rate manually. An app config, "**Update Exchange Rate Manually**" is available to facilitate this.&#x20;

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FcyWokUFRkjV5HU2h80yN%2Fimage.png?alt=media&#x26;token=e58be7a9-af72-4ac3-ba1f-7d242b66fdac" alt=""><figcaption></figcaption></figure>

Turn on this app config to enable editing the exchange rate manually.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FWxMVrcJviO3PYBm3O3tW%2Fimage.png?alt=media&#x26;token=3873155f-8903-4ade-a9f9-a48e0b8ca552" alt=""><figcaption></figcaption></figure>

You may edit this rate (up to 5 decimal digits) if necessary for that particular transaction/order. If you do you will be prompted with a message similar to this:

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2F0YqDxIwdO8nu0BAJR5rM%2Fimage.png?alt=media&#x26;token=2712cb8a-e6b9-44f4-8eca-dbeb11b878b3" alt=""><figcaption></figcaption></figure>

This is essentially asking if you want the rate that you entered to become the new system-wide rate. Click OK if you do, otherwise, click Cancel if you don’t. If you click OK then anyone creating transactions/orders with that currency will by default retrieve your entered rate. Also, remember that your rate will be overwritten anyways within 4 hours.

### Restricting exchange rate modification

You have the option to disable editing of the exchange rate on sales or purchase orders. There is an App Config, "**Disable exchange rate modification**" to disable changing/editing the Exchange rate on Sales Order and Purchase Order.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FpEDo08IV1qyk4qtNEo0I%2Fimage.png?alt=media&#x26;token=b6fd67b3-e094-4e38-93ce-06426432a65f" alt=""><figcaption></figcaption></figure>

Click on the pencil icon, and select the module for which you want to disable the modification of the exchange rate.

Exchange rate modification will be disabled for the selected module. If "Sales" is selected then all sales modules will not allow users to update the exchange rates.

The setting will have an impact on the following modules under SO:

* Estimate
* Sales order
* Invoice
* Sales receipt
* Credit memo
* Invoice credit memo
* Refund receipt

The same is the case if "Purchase" is selected. The setting will have an impact on the following modules under PO:

* Purchase order
* Item receipt
* Bill Vendor credit
* Vendor prepayment

***Note: The Page Default setting will override the setting defined under the App Config.*** <br>

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FfoRrrPfTmQx14B12teWe%2Fimage.png?alt=media&#x26;token=412bbadb-1257-4194-a86e-e75a7d4cbfb5" alt=""><figcaption></figcaption></figure>
