Apply charge definition lookup to subscriptions
This task explains how to apply charge definition lookup to subscriptions through the UI, ensuring accurate pricing based on attribute-based pricing.
Charge definition lookup is supported in API and UI. This article demonstrates how to apply charge definition lookup to subscriptions through UI. If you subscribe to the product rate plan through API as usual after defining the price lookup formula , the charge definition lookup is automatically processed. For more information, see Overview of Attribute-based Pricing .
The charge definition lookup is only available when the Attribute-based Pricing feature is enabled in the Orders Harmonization and Orders tenants.
By supporting this function, you can view the actual price of a charge based on the matching charge definition when subscribing this charge to a subscription through the Create Subscription or Add Product order action.
A price lookup formula must be created for a product rate plan charge in the product catalog to enable the charge definition lookup. The charge definitions are looked up based on attributes or custom fields defined in the formula. A successful charge definition lookup is based on the following rule: the values of the attributes or custom fields in the subscription and account during the Create Subscription or Add Product order action exactly match those values in charge definitions.
In this article, only one subscription custom field is used as a simple example to demonstrate how looking up charge definition works. For complex use cases using multiple fields for lookup, see Price lookup in Attribute-based Pricing .
To enable charge definition lookup, perform the following steps:
-
Add a custom field on the subscription object. For more information, see Manage custom fields
.
In this example, you created the
soldToRegion
custom field and the corresponding
API Name
value
soldToRegion__c
for looking up charge definitions during the order action. You configured two values
InRegion
and
Overseas
for this custom field.
-
For the charge, create the charge definitions
and price lookup formula
in the
Charge Amount
section of the charge in the product catalog.
In this example, the following two charge definitions are defined for the charge.
The formula is as follows:
Note: To avoid lookup failures caused by formula syntax errors, you are recommended to copy our formula example and replace
soldToRegion__cwith your custom field API Name . For more information, see Price lookup in Attribute-based Pricing .lookup("soldToRegion__c" = fieldLookup("subscription", "soldToRegion__c")) - When you add a product rate plan during the order action, you can identify whether the lookup succeeds or fails.
-
The following picture indicates a successful lookup. Since you specified the custom field value in this subscription as InRegion and the charge definition CD-00001210 has the same custom field value, this charge definition is successfully looked up based on the error-free formula. In this case, you can perform one of the following steps:
-
Update the subscription rate plan charge price in the Price field.
-
Click the link of the product charge definition number to view and update the product charge definition. If you update the List price field in the product charge definition, the subscription rate plan charge price in the Price field will not be synchronized during the order action.
-
Click the attribute list icon to check based on which custom field in the formula the lookup is processed. In this example,
"subscription", "#soldToRegion__c"is displayed in the attribute list.
-
-
The following picture indicates a failed lookup. Identify and resolve the issue by yourself or contact your product catalog manager.
-