Multicurrency in Deal Manager
  • 04 Apr 2024
  • 2 Minutes to read
  • Dark
    Light

Multicurrency in Deal Manager

  • Dark
    Light

Article summary

In Deal Manager implementations, the common contract or agreement multicurrency requirements often contradict the basic Salesforce multiple currencies capabilties in the following ways:

  • The Account that you attach to the agreement controls the agreement currency and the agreement lines. Most currency fields are displayed in the currency of the agreement. The currency of the agreement does not depend on the user's settings and the user cannot change it.
  • You can configure different currency fields on the same header and/or agreement lines to display in different currencies and also configure their conversion. For example, you can configure the prices on the line to display in the customers currency, but the total expected line revenue and margin can be configured to display in the currency of the organization that gives the pricing.
  • If you change the currency of the agreement or the line, then all fields tied to that currency must be recalculated.
Values not in the record's currency

Deal Manager can calculate currency fields into a currency different than the record's currency.

  • These values will not display with a currency symbol.
  • These values will be displayed and stored as a standard decimal value.
  • The user must know the value's currency or the currency must be incorporated into the label of the field/column.

The Deal Manager capabilities that enable the multicurrency feature

  • A ZCloud entity that holds currency conversion rates between different currencies. This entity must be synchronized with the Salesforce conversion table if Deal Manager uses the Salesforce multiple currencies feature.
  • The Zilliant formulas that recalculate metrics and other values as the user makes the edits.
  • A common data model for storing price lists, cost lists, and guidance with a currency.
  • A common API that retrieves price lists, cost lists, and guidance in the record's currency. If needed, Zilliant formulas use these APIs to calculate additional metrics.

Examples of the Deal Manager multicurrency configuration options

Note

Users cannot change the currency of the agreement header, lines, or sublines​.

  • For the Line Items list:

    • Currency symbol turned on in the Deal Manager component

      1.Currency symbol ON in Line Items.png

    • ISO code turned on in the Deal Manager component

      2.ISO code ON.png

    • User currency turned on in the Deal Manager component

      3.User currency ON.png

  • For the Edit lines modal:

    • Currency symbol turned on in the Deal Manager component

      4.Edit Lines.Currency symbol ON.png

    • ISO code turned on in the Deal Manager component

      5.Edit Lines.ISO symbol ON.png

    • User currency turned on in the Deal Manager component

      6.Edit Lines.User currency ON.png

Configure the multicurrency display parameters

Tip

These parameters are common for the Line Items component and the Edit Lines modal. For example, if set to TRUE on the Line Items component, the parameters are activated for the Edit Lines modal, and vice versa.

  1. Select Setup in the top right corner of the component's list, then select Edit Page​.
  2. In the Lightning App Builder, select the component's tab.
  3. Select the Line Items component in its placement on the Lighting record page.
  4. In the properties panel, select the following checkboxes:
    • Show currency symbol instead of ISO code—Applies only to orgs where the multicurrency feature is enabled.

      • If set to TRUE, any currency value displayed will have a currency symbol that is the correct symbol per other criteria in this story.
      • If set to FALSE, any currency value displayed will have a currency ISO code that is the correct ISO code per the criteria in this story.
    • Enable currency conversion for records not in user's currency—When multicurrency is enabled and there are more than two active currencies in the org, the format of the currency fields will be as indicated in the table below. In this example, USD is the user currency and AUS is an active alternative currency.

      7.Table.png


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.