> For the complete documentation index, see [llms.txt](https://support.ordereazi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.ordereazi.com/sales-features/settings/organization-setup/exchange-rate-management.md).

# Exchange Rate Management

Exchange Rate Management allows you to configure fixed exchange rates in OrderEazi Central. When configured, these rates are used instead of live rates from external providers, giving you full control

### 🧾 What are Configured Exchange Rates?

OrderEazi Central uses exchange rates when working with multiple currencies - for example, when converting product costs or selling prices between a client's currency and your own.

By default, exchange rates are fetched automatically from a live exchange rate provider (FastForex). Configured exchange rates let you override this behavior by storing your own rates directly in OrderEazi.

Each configured exchange rate consists of:

* A source currency (ISO 4217 code, e.g. `USD`)
* A destination currency (ISO 4217 code, e.g. `ZAR`)
* A fixed rate

### ⚙️ How It Works

When OrderEazi needs an exchange rate for a currency conversion, it follows a simple fallback process:

1. **Configured rates** - OrderEazi first checks for a configured exchange rate matching the source and destination currencies
2. **Live rates** - If no configured rate exists, a live rate is fetched from FastForex

This means configured rates always take priority. If you've set a rate for USD to ZAR, that rate will be used everywhere in the system - regardless of what the live provider returns. This can be configured on a per-project basis.

Configured rates can be kept up to date automatically through an integration with your accounting system, or they can be managed through a custom integration. This gives you the benefit of fixed, predictable rates that align with your business while still keeping them current.

### 🔄 Importing Exchange Rates

Exchange rates can be imported into OrderEazi automatically rather than being managed manually.

If your linked accounting system supports exchange rates, OrderEazi can import them on a scheduled basis. This keeps your configured rates aligned with the rates in your accounting system without any manual effort.

For more advanced scenarios, custom integrations can be built to import exchange rates from other external systems. These integrations push rates into OrderEazi in bulk, ensuring your configured rates stay up to date.

> Speak to your OrderEazi representative if you'd like to set up automatic exchange rate imports from your accounting system or another external source.

### 💡 Why Use Configured Exchange Rates?

Configured exchange rates are particularly useful for:

* Locking in a known rate for quoting or invoicing purposes
* Matching rates from your accounting or ERP system exactly
* Avoiding fluctuations from live exchange rate providers
* Ensuring consistency across all projects using the same currency pair
* Supporting automated rate synchronization from external systems

### ✅ Summary

Exchange Rate Management gives you control over how currency conversions are handled in OrderEazi:

* Configure fixed rates that override live exchange rate lookups
* Import rates automatically from your linked accounting system
* Build custom integrations to keep rates synchronized with external sources
* Configured rates always take priority over live providers

This ensures your projects reflect the exchange rates that matter to your business.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://support.ordereazi.com/sales-features/settings/organization-setup/exchange-rate-management.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.