The "Currency Preferences for Orders Import" setting in the eCommerce Hub's Shopify integration allows you to control how multi-currency Sales Orders from Shopify are processed when importing into Unleashed. You can choose to import orders in either your shop's base currency or the customer's payment currency.
Important: Multi-currency functionality is only available when using the "Create an order and a customer based on each Shopify order" option. It cannot be used with the "Use a single customer for all Shopify orders" setting.
Set up currency preferences
To configure how multi-currency orders import from Shopify:
From the main menu, go to the eCommerce Hub > Shopify.
Select "Configure" for your Shopify store.
In the Configuration tab, "Order Import Options" section, ensure "Create an order and a customer based on each Shopify order" is selected.
In the "Currency Preferences for Orders Import" section, choose one of the following options:
Use Shop Currency (Orders will be imported in your Shop currency).
Use Payment Currency (Orders will be imported in the currency which they were paid for via Shopify Markets).
Scroll to the bottom and click Save Configuration.
Currency Preferences explained
Use Shop Currency
Best for: Businesses that prefer to manage all orders in a single currency for simplified accounting and reporting.
When this option is selected, all imported Sales Orders will appear in Unleashed using your Shopify store's base currency, regardless of what currency the customer paid in. Shopify automatically handles the currency conversion using its own exchange rates.
Use Payment Currency
Best for: Businesses that need to track sales in multiple currencies for detailed financial reporting or compliance purposes.
When this option is selected, orders import into Unleashed in the same currency the customer used for payment through Shopify Markets.
📌 Note: The payment currency must already exist as a Currency Rate in Unleashed before the order can import successfully.
Next steps
After configuring your currency preferences, test the setup by placing a test order in a different currency (if using Payment Currency option) to ensure orders import correctly. Monitor your Connection Log for any import issues and verify that currency rates are up to date in Unleashed.
Resolving currency errors
If you encounter currency-related import errors on your Shopify Orders, you may see a message like: "Cannot import order '#1077': Customer 'MULTI0 CURRENCY0' exists in Unleashed with 'MYR' currency but order is with 'NZD' currency."
This error occurs when there's a mismatch between the customer's existing currency in Unleashed and the order's currency from Shopify.
To resolve this error:
Locate the existing customer record in Unleashed.
Remove the Shopify contact's email address from the customer's Contacts tab.
Create a new customer in Unleashed, using the correct currency for the order.
Ensure the new customer's contact email matches the Shopify Order's customer email exactly.
Contact Unleashed Support to request customer mapping deletion and cleanup, providing the relevant customer and order details.
Once Support confirms the cleanup is complete, manually attempt to import the order.
Future orders from this customer will automatically sync to the corrected customer record