What "foreign currency" means here
Every Xero organisation has a base currency (also called the home currency) that was set when the organisation was created. Any invoice in a different currency is a foreign currency invoice from Xero's point of view.
When you connect a folder to a Xero organisation, Datamolino captures the organisation's base currency and uses it as the folder default. Documents are exported in whichever currency was captured during data extraction (or set in the document detail). If that currency matches the base currency, no special setup is needed. If it does not, the currency has to be enabled in Xero first.
Tip: If you only ever process invoices in your base currency, you can skip this article. It applies only when you have documents in other currencies.
Enable the currency in Xero (one-off setup)
Foreign currencies must be added to your Xero organisation before any document in that currency can be exported. This is a Xero-side step done once per currency.
Log in to Xero, open Settings, and click Currencies.
👉 Do I need a special Xero plan?
Multi-currency support depends on your Xero subscription. On plans that do not include multi-currency, Xero only accepts invoices in the organisation's base currency - any other currency is rejected at export time. If you cannot add a new currency in Settings, check your Xero plan.
How Datamolino sends the currency to Xero
Datamolino reads the currency from the document during data extraction. You can see and change it in the document detail before export. The currency that the document is set to is what gets sent to Xero.
If the document's currency field is blank, Datamolino falls back to the folder's coding defaults. The folder default itself was captured from the Xero organisation when the folder was connected, so by default it matches your Xero base currency.
👉 Where do I check or change the document's currency?
Open the document and look in the supplier / coding section of the document detail. The currency dropdown sits alongside the other coding fields. Change it there if extraction picked up the wrong currency.
👉 What if I always work in one foreign currency?
You can set that currency as the folder default through Folder Menu > Accounting & Automation >Integration. Documents will then export in that currency unless overridden on the document.
What can go wrong on export
Most foreign currency export problems trace back to one of two causes:
The currency is not enabled in Xero. The export fails and Datamolino shows the Xero-side error. Add the missing currency in Xero (Settings > Currencies) and try the export again.
The Xero plan does not support multi-currency. Xero rejects any invoice that is not in the base currency. Either upgrade the Xero plan, or change the document's currency to the base currency before exporting.
For other export errors, see Xero export statuses and Connect or disconnect a folder from Xero.


