This section describes how to map Salesforce fields that require special handling when synchronizing Subscription data from Salesforce to Ordway.
Contents
- Bill To Parent Customer ID
- Prerequisites
- Configure the Salesforce Lookup Field
- Map the Custom Field to Ordway
- How the Parent Customer ID Is Resolved
- Parent Customer Hierarchy Validation
- Verify the Mapping
Bill To Parent Customer ID
Ordway supports billing Subscription charges to a parent Customer instead of the Customer associated with the Subscription.
This is useful when a customer belongs to a parent-child account hierarchy and Subscription charges need to be billed to a specific parent Customer.
The Salesforce Ordway Contract object can use a custom Account lookup field to identify the billable parent. When the Subscription is synchronized to Ordway, the integration resolves the selected Salesforce Account to its corresponding Ordway Customer ID and populates the Ordway Bill To Parent Customer ID field.
Note: If you need this mapping, your implementation team can add the required custom Account lookup field to the Salesforce Ordway Contract object.
Prerequisites
Before configuring the mapping, ensure that:
- The Salesforce integration is connected to Ordway.
- The Salesforce Account representing the parent Customer exists in Salesforce.
- The Salesforce Account is synchronized with its corresponding Ordway Customer.
- A custom Account lookup field for the billable parent is available on the Salesforce Ordway Contract object. The installed Ordway Salesforce package does not include this field; your implementation team can add it if needed.
- You have permission to configure Salesforce-to-Ordway field mappings in Ordway.
Configure the Salesforce Lookup Field
The Billable Parent Customer lookup field is not included in the installed Ordway Salesforce package. Your implementation team can add it as a custom field on the Ordway Contract object.
Use the following configuration when adding the field, or share these requirements with your implementation team:
- In Salesforce, navigate to Setup > Object Manager.
- Open the Ordway Contract object.
- Create a new custom field with the field type Lookup Relationship.
- Select Account as the related object.
- Configure the field label as Billable Customer.
- Save the field and make it available on the Ordway Contract page layout.
The lookup field allows users to select a Salesforce Account representing the parent Customer.
Map the Custom Field to Ordway
After the custom lookup field is available, map it to the corresponding Ordway Subscription field.
- In Ordway, navigate to Setup > Integrations > Salesforce.
- Select the To Ordway tab. This tab contains the Salesforce-to-Ordway mapping configuration.
- Locate the Subscriptions mapping.
- Open the Subscription mapping configuration.
- In the Salesforce Object dropdown, select Ordway Contract.
- Locate the Salesforce Billable Parent Customer lookup field.
Map the fields as follows:
| Ordway field | Salesforce field |
| Bill To Parent Customer ID | Billable Parent Customer |
- Click SAVE to save the mapping.
How the Parent Customer ID Is Resolved
The Salesforce Billable Customer lookup field stores a reference to a Salesforce Account. It does not directly store the Ordway Customer ID.
During Subscription synchronization, Ordway resolves the Salesforce Account reference to its corresponding Ordway Customer ID and uses that ID to populate the Subscription's Bill To Parent Customer ID field.
Important: Salesforce Account IDs and Ordway Customer IDs are different identifiers. Ordway must resolve the Salesforce Account reference to the corresponding Ordway Customer ID before passing it to the Subscription API.
Parent Customer Hierarchy Validation
The selected Billable Parent Customer must belong to the same parent-child account hierarchy as the Subscription's Customer.
Ordway validates this relationship during synchronization. You cannot select an unrelated Customer as the Billable Parent Customer.
For example, consider the following account hierarchy:
For a Subscription belonging to Customer C5, the following Customers are valid Billable Parent Customer selections:
| Customer | Relationship to C5 | Valid selection |
| C4 | Direct parent | Yes |
| C2 | Higher-level parent | Yes |
| C1 | Top-level parent | Yes |
| C3 | Customer in a separate branch of the hierarchy | No |
| C6 | Unrelated standalone Customer | No |
Key Takeaways
- The Billable Parent Customer must belong to the same parent-child account hierarchy as the Subscription's Customer.
- You can select the direct parent or any higher-level parent in the hierarchy.
- You cannot select a customer from a different branch of the hierarchy.
- You cannot select an unrelated standalone Customer.
- Ordway validates the parent-child relationship during Subscription synchronization.
- If an unrelated Customer is provided as the Bill To Parent Customer ID, Ordway rejects the Subscription request and returns an Invalid Customer error.
Verify the Mapping
After configuring the mapping, synchronize a Subscription from Salesforce to Ordway.
- Open the Salesforce Ordway Contract record.
- Select the required parent Account in the Billable Parent Customer lookup field.
- Save the record and allow the Subscription synchronization to complete.
- In Ordway, open the corresponding Subscription.
- Locate the Billable Parent Customer field.
- Verify that it displays the intended parent Customer.
The Subscription should reference the corresponding Ordway Customer, not the Salesforce Account ID.
Result
Once the mapping is configured, Salesforce can provide the Billable Parent Customer for a Subscription during synchronization.
Ordway resolves the Salesforce Account reference to the corresponding Ordway Customer ID and populates the Subscription's Bill To Parent Customer ID field.
This allows Subscription charges to be billed to the selected Customer in the account hierarchy, while maintaining the existing parent-child Customer relationships in Ordway.
Related Topics
- Parent-Child Accounts – Understand how parent and child Customer relationships are maintained between Salesforce and Ordway.
- Add Custom Fields – Learn how to create and map custom fields between Salesforce and Ordway.
- Connect to Ordway from Salesforce – Configure the Salesforce connection required for synchronization.
- Connect to Salesforce in Ordway – Set up the Salesforce integration from Ordway.
- Assign & Configure Ordway Page Layouts – Opportunity – Understand how to configure Ordway fields and components on Salesforce record pages.
Comments
0 comments
Please sign in to leave a comment.