Use this article to install the Ordway Connector for Salesforce, connect it to Ordway, and configure permissions, page layouts, settings, products, plans, and the Plan Picker.
Contents
- Package Installation and Connection in Salesforce
- Settings
- Connect to Salesforce in Ordway
- Object and Field Mappings
- Ordway Product & Plan Configuration
- Configuring Salesforce and Ordway Products to link to Plans in Salesforce
- Pull Ordway Plans into Salesforce on Demand
- Plan Picker Field Configuration
Package Installation & Connection in Salesforce
After you install the latest package from AppExchange or the link below, complete the configuration steps in this article.
Set User Permissions
- In Salesforce, go to Setup > Administration > Users > Users.
- Select each user who needs access to the Ordway package.
- Click Permission Set Assignments > Edit Assignments. The following permission sets are available:
- Ordway CPQ - User: Includes access to all features in the Ordway application except the Ordway Settings page.
- Ordway CPQ - Admin: Includes access to all features in the Ordway application, including the Ordway Settings page. The Ordway Settings page includes the Ordway Connection, Settings, Object Field Mappings, and Bulk Sync Jobs sections.
- Ordway CPQ - Multi-Entity: A permission set only for configuring multi-entity settings. It does not apply to instances that don’t use the multi-entity feature in Ordway.
- Assign the appropriate permission set to each user, and then click Save.
Assign and Configure Ordway Page Layouts - Opportunity
-
Navigate to Setup > Object Manager > Opportunity. The Opportunity page is displayed.
-
Click Page Layouts > Page Layout Assignment. The Page Layout Assignment page is displayed.
-
Click Edit Assignment.
- For the relevant user roles and record type(s), select the Ordway Opportunity Layout from the Page Layout To Use list.
- Click Save.
-
Return to the Opportunity object main page and click Lightning Record Pages.
- The Ordway Opportunity Record Page displays in the list. Perform one of the following:
- Set and activate this page as the default.
- Configure the Opportunity Record Page to add Ordway custom components to the page.
Use a different Opportunity Record Page
If you do not wish to use the Ordway Opportunity Record Page and instead wish to use a different Opportunity Record Page, follow these steps to add Ordway components.
1. Click Opportunity Record Page or any custom Opportunity Record Page to configure it and click Edit.
2. Select Ordway Plan Picker from Custom Components and drag the component to the layout from the list of Components and click Save.
Assign and Configure Ordway Page Layouts - Opportunity Product
- In Object Manager, select Opportunity Product. The Opportunity Product page is displayed.
- Click Page Layout Assignment. The Page Layout Assignment page is displayed.
- Click Edit Assignment.
- Assign Ordway Opportunity Product Layout to relevant user roles and record type(s) and click Save.
Configure Discount Field
To make the Discount field appear in the Plan Picker:
-
Go to Setup > Object Manager > Opportunity Product > Fields & Relationships.
- Click Discount.
-
Click Set Field-Level Security.
- Check the roles that need the field to be visible (Example: System Administrator).
- Click Save.
Connect to Ordway from Salesforce
- Open the App Launcher:
- Scroll down to and click on Ordway Settings.
-
On the Ordway Settings page, Ordway Connection. The Ordway Connection page displayed.
- Enter email address, company name, and token. This information must exactly match the Ordway setup. To find the token value in Ordway, navigate to Setup > Users, and then click the username. Copy the token from the User profile.
- For live integrations, select Production as the Ordway environment to be connected.
To change the connected user account, see Change Connected User Account for Salesforce to Ordway Connection in the Salesforce Resources article.
Settings
The Automation view is only available to users with the Ordway CPQ-Admin permission set.
Account and Contact Settings
Automatically Sync Account Updates to Ordway
When set to Yes, updates to Accounts that have Ordway Customer IDs sync to Ordway automatically. When set to No, no updates made to Account records in Salesforce sync to Ordway.
Automatically Sync Contact Updates to Ordway
When set to Yes, updates to Contacts whose Accounts have Ordway Customer IDs sync to Ordway automatically. When set to No, no updates made to Contact records in Salesforce sync to Ordway.
Note: The Sync to Ordway checkbox field on the Contact object lets you choose whether an individual contact record syncs to Ordway. The checkbox and the Automatically Sync Contact Updates to Ordway setting work together:
| Sync to Ordway checkbox | Automatically Sync Contact Updates to Ordway | Result |
|---|---|---|
| True | Yes | Changes to the Contact record sync to Ordway. |
| True | No | No records sync to Ordway. |
| False | Yes | The Contact record does not sync to Ordway. |
| False | No | No records sync to Ordway. |
Opportunity Settings
Automatically Update Opportunity Record When Related Ordway Contract Record is Updated
When set to Yes, Opportunity records update when related Ordway Contracts are updated during a bulk sync of subscriptions from Ordway. When set to No, Opportunity records are not updated during a bulk sync.
Map Opportunity Type to Opportunity Record Type
If Opportunity record types are enabled in your org, use this setting to map each Opportunity record type to an Opportunity Type (change or renewal opportunity type).
Contract Settings
Automatically create an Ordway Contract record at a specific Opportunity stage?
When set to Yes, automation is enabled and you can select an Opportunity stage. When an Opportunity reaches the selected stage, an Ordway Contract is created automatically.
Automatically sync Ordway Contracts to Ordway
When set to Yes, automation of syncing is enabled. When enabled, creating or changing an Ordway Contract automatically syncs it to Ordway.
To set up a schedule for syncing contracts to Ordway, see section on Bulk Sync Ordway Contracts.
Automatically sync Ordway Contracts from Ordway
Determines whether changes to contracts in Ordway sync back to Salesforce automatically. When set to Yes, any change in Ordway updates contracts in Salesforce. When set to No, users manually update changes from Ordway to Salesforce.
Plan Picker Settings
Select Pricebook
Determines the pricebook used with the Plan Picker. Opportunity Products in the selected pricebook must be linked to products in Ordway for Ordway products to appear in the Plan Picker.
When you select a pricebook, it is associated with the Opportunity by default. When you select None, you must select a pricebook to assign to each new Opportunity when you create it.
Use Ordway Price
Set this option to Yes to retrieve prices from Ordway into Salesforce when you use the Plan Picker.
Use Ordway pricing calculation to set Opportunity Product Sales Price and Total Price
Set this option to Yes to let Ordway calculate recurring pricing for Opportunity Products. This allows the Total Price and Amount fields to calculate accurately.
Ordway uses the following calculation for Sales Price:
- Sales Price = Ordway List Price × Number of Periods
- Number of Periods = Contract Term ÷ Billing Period
Note: For this calculation, Evergreen contract terms are treated as 12-month terms.
When set to No, Ordway displays the effective price and contract value in unique fields on the Opportunity Product.
Connect to Salesforce in Ordway
- Ordway, navigate to Menu > Setup > Integrations. The Integrations page is displayed.
- Locate Salesforce.
-
Click Connect next to Salesforce and supply your Salesforce login credentials. When already logged in, Ordway will automatically log you in after you allow Ordway CPQ access.
-
Once connected, the following screen displays:
- In the Salesforce app version drop-down, select Version 2, and then click Change to view the Object and Field Mappings in Ordway. Default mappings are already set, so no initial configuration is needed.
Object and Field Mappings
Between Salesforce and Ordway
The object and field mappings in Ordway link objects in Salesforce to objects in Ordway. Mappings are set by default, so no additional configuration is necessary. You can update any mapping to accommodate specific use cases.
Mapping Salesforce to Ordway
Mapping Ordway to Salesforce
Screenshots of the default mappings can be found in the Salesforce Resources article.
Between Objects in Salesforce
In Salesforce, the object and field mappings are set by default so no additional configuration needs to be done. The mappings can be accessed by going to the Ordway Settings > Ordway Field Mappings tab. This view is only available to Ordway CPQ Admin users.
See details of the mappings in the Salesforce Resources article.
Ordway Product and Plan Configuration
Beginning with v3.0, Ordway Products and Plans can be created in Salesforce.
Create an Ordway Product in Salesforce
-
In Salesforce, click New Product in the Product Objects page.
- Mark the product as Active and set the Ordway Product field to true.
-
Add Product to a Pricebook.
- Click Ordway Product.
- Update or add any additional details, such as SKU, description, and taxable.
- To sync the Ordway Product to Ordway, click Sync to Ordway.
- To view the synced Product in Ordway, click View in Ordway.
Create or Update a Product in Ordway
If you update a linked Product or create a new Product in Ordway, the changes sync to Salesforce when the webhook for Products is turned on.
Create an Ordway Plan
- Go to Ordway Plans, and then click New.
- Enter the Plan Name and mark the Plan as Active.
- Within the Plan, add a charge by clicking New on Ordway Charges.
- Fill in all required information and other details.
- In the Additional Information section, select the Product to associate with this Plan.
- Add additional charges if needed.
- After you set up the Ordway Plan, click Sync to Ordway to sync the Plan to Ordway.
- To view the synced Plan in Ordway, click View in Ordway.
Create or Update a Plan in Ordway (webhook)
If you update a linked Plan or create a new Plan in Ordway, the changes sync to Salesforce when the webhook for Plans is turned on.
Create a Volume or Tiered Charge
- For the charge Pricing Model, select Volume or Tiered.
- Click the charge. In the Ordway Charge Tiers section, click New to set pricing tiers.
- In the Ordway Charge Tiers view, you can add new rows, delete existing rows, update the list price, and select the price type (per unit or flat fee).
Import Existing Products and Plans from Ordway
For Products and Plans already created in Ordway, use Bulk Sync Jobs to import them into Salesforce directly. Salesforce creates these records and then sets the Salesforce ID automatically on the corresponding records in Ordway.
Configure Salesforce and Ordway Products to Link to Plans in Salesforce (Package v4.6.2 or Earlier)
For orgs on package v4.6.2 or earlier, each Product in Ordway must have a value in the salesforce_id field for Products and Plans to appear in the Plan Picker in Salesforce. This value is the Salesforce Product ID.
-
For each Product in Salesforce, copy the Salesforce Product ID.
-
Example of Salesforce Product ID:
- Paste the Salesforce Product ID into the salesforce_id field of the corresponding Product in Ordway.
- After the Products are configured, pull the Ordway Plans into Salesforce by following the steps in Pull Ordway Plans into Salesforce on Demand.
Pull Ordway Plans into Salesforce on Demand
- In Salesforce, go to Ordway Settings > Sync Jobs.
-
In the Object drop-down, select Plans, and then click Sync from Ordway.
To sync Plans on a schedule, see instructions in the Salesforce Resources article.
Plan Picker Field Configuration
Beginning with package v3.0, you can configure Plan Picker settings in Ordway Settings when the Plan Picker v2.0 feature is enabled.
Important: Once enabled, Plan Picker v2.0 cannot be disabled. Plan Picker v2.0 is compatible with Plan Picker v1.0 data, but Plan Picker v1.0 is not compatible with Plan Picker v2.0.
When you install package v3.0 in a new organization, rather than upgrading from a previous package version, Plan Picker v2.0 is enabled automatically.
Before you enable Plan Picker v2.0, do the following:
- Import Products. Importing products automatically creates records in the Ordway Product objects and associates them with the Product2 record.
- Import Plans without applying any filters. All plans are imported in both v1 format (all charges stored in JSON on the plan object) and v2 format (charges stored in their own object).
- Configure the Plan Picker. Configure any custom fields used in field sets on the Plan Picker tab of the Ordway Settings page.
Plan Picker v2.0 Features
On the Plan Picker tab of the Ordway Settings page in Salesforce, you can order, show or hide, and make Plan Picker fields editable. These settings apply to the Plan Picker for Opportunity Products and Quote Line Items.
- The All Plans tab lists all available plans that you can select and add to the Opportunity.
- The Selected Plans tab displays the plans you selected and added to the Opportunity. You can modify and save fields on this tab.
Comments
0 comments
Please sign in to leave a comment.