{"id":16,"date":"2023-12-15T21:43:11","date_gmt":"2023-12-15T21:43:11","guid":{"rendered":"https:\/\/www.mycompanylist.com\/blog\/?p=16"},"modified":"2025-07-01T01:42:06","modified_gmt":"2025-07-01T01:42:06","slug":"currency-exchange-rate-sync-installation-guide","status":"publish","type":"post","link":"https:\/\/www.mycompanylist.com\/blog\/salesforce-app\/currency-exchange-rate-sync-installation-guide\/","title":{"rendered":"Currency Exchange Rate Sync Installation Guide"},"content":{"rendered":"\n
Salesforce<\/font><\/div><\/div><\/div><\/foreignObject>Salesforce<\/text><\/switch><\/g>
api.mycompanylist.com<\/font><\/div><\/div><\/div><\/foreignObject>api.mycompanylist.com<\/text><\/switch><\/g>
Insert<\/font><\/div><\/div><\/div><\/foreignObject>Insert<\/text><\/switch><\/g>
Daily Scheduled Job \/ Bulk Backfill<\/font><\/div><\/div><\/div><\/foreignObject>Daily Scheduled Job \/ Bulk B…<\/text><\/switch><\/g>
Dated Conversion Rate Records<\/font><\/div><\/div><\/div><\/foreignObject>Dated Conversion Rate Reco…<\/text><\/switch><\/g>
Rest API<\/div><\/div><\/div><\/foreignObject>Rest API<\/text><\/switch><\/g>
Bulk Delete<\/font><\/div><\/div><\/div><\/foreignObject>Bulk Delete<\/text><\/switch><\/g>
Delete<\/div><\/div><\/div><\/foreignObject>Delete<\/text><\/switch><\/g><\/g>Text is not SVG – cannot display<\/text><\/a><\/switch><\/svg>\n\n\n\n

The ‘Currency Exchange Rate Sync’ App<\/a> runs a daily sync of currency conversion rate data to your Salesforce instance, creating DatedConversionRate<\/code> records for all of your enabled currencies. This is part of Salesforce’s Advanced Currency Management<\/a> feature, which makes reporting on the total Amount of Opportunities that closed at various times across various currencies seamless and accurate.<\/p>\n\n\n\n

The steps for installation are as follows:<\/h3>\n\n\n\n
    \n
  1. 1-Click Setup<\/a><\/li>\n\n\n\n
  2. Sources<\/a><\/li>\n\n\n\n
  3. Supported Currencies<\/a><\/li>\n\n\n\n
  4. Prerequisites<\/a><\/li>\n\n\n\n
  5. Installing the Package<\/a><\/li>\n\n\n\n
  6. Setting Permissions<\/a><\/li>\n\n\n\n
  7. Navigating to the App<\/a><\/li>\n\n\n\n
  8. Scheduling the Data Sync<\/a><\/li>\n\n\n\n
  9. Reporting<\/a><\/li>\n\n\n\n
  10. Possible Errors<\/a><\/li>\n\n\n\n
  11. Advanced Configuration<\/a><\/li>\n\n\n\n
  12. FAQs<\/a><\/li>\n\n\n\n
  13. Creating a Support Ticket<\/a><\/li>\n\n\n\n
  14. Changelog<\/a><\/li>\n<\/ol>\n\n\n\n

    1-Click Setup<\/h3>\n\n\n\n

    Most people will be happy with the 1 click setup. Go to the Currency Exchange Rate Sync Record page and click ‘Daily’ in the upper left. You can optionally do backfills and bulk deletes with a few more clicks.<\/p>\n\n\n\n

    Sources<\/h3>\n\n\n\n

    You have the ability to set which sources the exchange rate data is pulled from. The field takes a comma separated list of short source names. If you set the ‘Sources’ field to ‘imf’, you will only get exchange rate data from the International Monetary Fund. If you set the ‘Sources’ field to ‘imf,ecb’, you will get data from the International Monetary Fund, and the European Central Bank. Combining sources is sometimes necessary because not every source has every currency. More info on sources<\/a>. List of all sources<\/a>. The source that provides an exchange rate is a field in the API response body, which can be seen in HTTP Request Logs.<\/p>\n\n\n\n

    Supported Currencies<\/h3>\n\n\n\n

    The App supports 150 of the currencies supported by Salesforce<\/a>. More info on currencies<\/a>. List of all supported currencies<\/a>. There is over 20 years of historical data.<\/p>\n\n\n\n

    Prerequisites<\/h3>\n\n\n\n

    In order to install, you will need to check the box Activate Multiple Currencies<\/code> within 'Setup' -> 'Company Information'<\/code>. Note that once Multiple Currencies is enabled, it cannot be disabled. If you are enabling advanced currency management for the first time, take note of Considerations of Enabling Multiple Currencies<\/a> as well as About Advanced Currency Management<\/a>. As always, you are advised to work in a Sandbox before working in production.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Under 'Setup' -> 'Manage Currencies'<\/code>, be sure that 'Advanced Currency Management'<\/code> is enabled. This is the feature that allows different exchange rates at different dates as opposed to a single exchange rate for all time. Without it, Salesforce will not allow the insertion of DatedConversionRate<\/code> records.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Installing the Package<\/h3>\n\n\n\n

    Go to the AppExchange Page<\/a> and click ‘Get it Now’.<\/p>\n\n\n\n

    You should choose Install for Admins Only<\/code>. Otherwise, Salesforce will grant Create, View, Edit, Modify to both Custom Objects to all users. This means they will be able to see the App Configuration and the Logs and be able to make changes. The log records are not sensitive, but it is also not relevant to most Salesforce Users. There are two Permission Sets, Admin and a Read Only, which can be used for sharing permissions with non-Admin Users.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    To install, press the 'Install'<\/code> button. A popup will come checking that you are okay to send or receive data from 'api.mycompanylist.com'<\/code>. This is because the Package makes API calls to this host in order to pull in the latest exchange rate data. Note that connections are SSL\/TLS encrypted.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Check the box 'Yes, grant access to these third-party web sites'<\/code>, and press 'Continue'<\/code>. You should receive an email that the package was installed successfully. Press ‘Done<\/code>‘ to finish the installation.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Setting Permissions<\/h4>\n\n\n\n

    If the App is being run by a System Administrator, no assignment of Permission Sets is necessary. However, other users can be enabled to view and update the App configuration by assigning the following Permission Sets:<\/p>\n\n\n\n