Pricing and Charge Attributes

Overview

Oracle CPQ supports canonical Pricing and Charge Attributes in the CPQ pricing module. Pricing Attributes are mapped to specific attributes from Commerce, Parts, or Configuration. CPQ provides several standard Pricing Attributes with predefined mapping for frequently used attributes (e.g. Configuration Quantity, Commerce Quantity, Pricing Segment, and Account). Customers can also add their own custom Pricing and Charge Attributes. Pricing Attributes can be used to define conditions and functions for Price Models and Pricing Rules. The Price Models and Pricing Rules will be invoked based on the values from the Pricing Attributes and will automatically populate the price values referenced in conditions and functions.

Oracle CPQ 24D combined Charge Attributes with Pricing Attributes into a single module in the Pricing Portal. Refer to Charge Attributes for releases prior to Oracle CPQ 24D. The "Charge" type Pricing Entity identifies Charge Attributes inside the Pricing Attributes module. The Pricing Attributes module supports all previous Charge Attribute fields and functionality.

Pricing Attribute Pages

ClosedPricing Attributes List Page - This list page allows administrators to view the pricing attributes Pricing Entity (Header or Line), Name, Variable Name, Data Type, and Type without opening individual Pricing Attributes details. The array type attributes are appropriately labeled in the Data Type column on the Pricing Attributes list page.

Pricing Attributes list page

Item Description

1

Navigate to Pricing Portal.

2

Click Actions to Add new custom Pricing Attributes, Reorder custom charge attributes, or to Manage Columns for the Pricing Attributes list.

Note: Only custom Charge type Pricing Attributes can be reordered.

3

Enter search criteria to filter Pricing Attributes results, which remain persistent while navigating within Pricing Attributes.

4

Sort Pricing Attributes using the Pricing Entity, Name, Variable Name, Data Type, or Type column headers.

5

Edit an existing Price Attribute by clicking on the appropriate Name link or click on the line ellipsis and selecting Edit.

6

Edit or Delete a Pricing Attribute by clicking on the line ellipsis and selecting the appropriate action.


ClosedPricing Attribute Page - This page allows administrators to manage Pricing Attributes. This section describes fields for Header and Line type Pricing Attributes. See Charge Type Pricing Attribute Page for more information about charge-related fields.

Pricing Atribute page

Item Description

1

Navigate to the Pricing Attributes list page.

2

Navigate to Next or Previous pricing attribute in the pricing attributes list or filtered pricing attributes search results list.

3

Data Type: Boolean, Currency, String, Decimal, Date, or Integer.

4

Pricing Entity: Header, Line, or Charge

5

In/Out: Identifies if an attribute is a Pricing Engine input, output, internal, or external. Each Pricing Attribute can have only one of the following values:

  • Input – This option defines attribute values that are used as inputs to pricing calculations.

  • Output – This option defines attribute values that will be written as outputs from pricing into Commerce.

  • Internal - This option defines attributes that are used only inside the Pricing Engine. For example, a customer segment attribute can be used internally within the Pricing Engine to determine pricing. It could be used in matrix-based pricing, pricing rule conditions, price model conditions, or BML scripts, but never be written into an output attribute.

  • External – This value is automatically set for Charge Set Attributes that are currently calculated by CPQ Quoting but will in future be calculated by Pricing Engine. For now these attributes form part of the schema definition for Charge Set attributes in CPQ Commerce. This value cannot be selected when created new custom Pricing Attributes.

The In/Out parameter can be set to Input, Output, or Internal for new custom Pricing Attributes. Charge Attributes are automatically set to Output.

6

Type: Custom or Standard

7

Status: Active or Inactive

8

Edit the pricing attributes Name, Lookup, Default Value, or Description.

7

Mapped Data Sources

8

Click Edit to add, reorder, and delete attribute mappings. Click Manage Columns to manage displayed columns.


ClosedCharge Type Pricing Attribute Page - This page allows administrators to manage Pricing Attributes. This section describes fields for Charge type Pricing Attributes.

Charge Type Pricing Attribute

Item Description

1

Navigate to the Pricing Attributes list page.

2

Navigate to Next or Previous pricing attribute in the pricing attribute list or filtered pricing attribute search results list.

3

A Lookup associates a Pricing Lookup to a String type attribute.

4

The Data Type: Boolean, Currency, Date, Decimal, Integer, String, or Text Area.

5

The Default Value for specified for Boolean, Date, Decimal, Integer, or String data types.

When a Lookup is selected, you can select a default value from values defined in Pricing Lookups.

6

Pricing Entity: Header, Line, or Charge

7

In/Out: Identifies if an attribute is a Pricing Engine input, output, internal, or external. Each Pricing Attribute can have only one of the following values:
  • Input – This option defines attribute values that are used as inputs to pricing calculations.

  • Output – This option defines attribute values that will be written as outputs from pricing into Commerce.

  • Internal - This option defines attributes that are used only inside the Pricing Engine. For example, a customer segment attribute can be used internally within the Pricing Engine to determine pricing. It could be used in matrix-based pricing, pricing rule conditions, price model conditions, or BML scripts, but never be written into an output attribute.

  • External – This value is automatically set for Charge Set Attributes that are currently calculated by CPQ Quoting but will in future be calculated by Pricing Engine. For now these attributes form part of the schema definition for Charge Set attributes in CPQ Commerce. This value cannot be selected when created new custom Pricing Attributes.

The In/Out parameter can be set to Input, Output, or Internal for new custom Pricing Attributes. Charge Attributes are automatically set to Output.

8

Type indicates if the Charge Attribute is standard of custom.

9

Status indicates if the Charge Attribute is active of inactive.

10

Click Edit to modify editable charge attribute fields. The fields that are editable are dependent on the charge attribute Type and Data Type.

11

Visibility identifies if the charge attribute is visible in other CPQ modules.

  • Administration: CPQ administrator UIs, for example, Pricing Portal, Product Launch
    Administration must be visible to display an attribute in Price Model > Pricing Data.

  • Runtime: Buy-side UIs, for example, quoting & configuration buy-side.

12

Selected Value: Key, Required, or Negotiable.

13

Click Edit to add, reorder, and delete attribute mappings. Click Manage Columns to manage displayed columns.

14

Mapped Data Sources


Standard Pricing Attributes

CPQ provides the following standard Pricing Attributes with predefined mapping for frequently used attributes. Standard Pricing Attributes and mappings cannot be deleted or inactivated.

ClosedView Standard Pricing Attributes

Pricing Attribute Enhancements

 

Administration

ClosedAdd a Custom Pricing Attribute

Complete the following steps to create a Pricing Attribute.

  1. Navigate to Admin > Pricing Portal > Pricing Attributes.

  2. Select Add form the Actions drop-down.

    1. Select the Pricing Entity option.

      • Header - Select this option for transaction level attributes.

      • Line - Select this option for transaction line item attributes.

      • Charge – Select this option for charge attributes, refer to Add a Custom Charge Attribute.

    2. Select the In/Out type. The In/Out parameter can be set to Input, Output, or Internal for new custom Pricing Attributes.

      Each Pricing Attribute can have only one of the following values:

      • Input – This option defines attribute values that are used as inputs to pricing calculations.

      • Output – This option defines attribute values that will be written as outputs from pricing into Commerce.

      • Internal - This option defines attributes that are used only inside the Pricing Engine. For example, a customer segment attribute can be used internally within the Pricing Engine to determine pricing. It could be used in matrix-based pricing, pricing rule conditions, price model conditions, or BML scripts, but never be written into an output attribute..

    3. Enter a Name.

    4. Enter the Variable Name.

    5. Select the Data Type: Boolean, Currency, String, Decimal, Date, or Integer.

    6. Select the Array Type option, if applicable.

      • Enable this option for Array attributes.

      • Disable this option for Non-Array attributes.

    7. Select a Lookup to associate a Pricing Lookup to a String type attribute, if applicable.

      • This field is only available for string data types.

      • Refer to Pricing Lookups for more information.

    8. (optional) Select or enter a Default Value.

      • The default value cannot be specified for currency or text area data types.

      • Only True or False values can be selected for Boolean data types.

      • When a Lookup is selected, you can select a default value from values defined in Pricing Lookups.

    9. (optional) Enter a Description.

    10. Click Create.

  3. Complete the following items to map a pricing attribute to a Commerce, Configuration, or Parts attribute.

    1. Select Edit from the Actions drop-down.

    2. Click Add.

    3. Select the Data Source from the drop-down menu.

    4. Select the appropriate attribute from the Source Attribute Name drop-down menu.

      • The Source Attribute Variable Name and Path will auto-populate.

      • To reorder mapping attributes, click in the Order field and enter the desired order number.

      • To delete an attribute mapping, click the ellipsis at the end of the line and select Delete.

    5. Repeat 3b – 3d to add and map additional attributes.

      Note: Contextual data sources can be enabled for Pricing Attributes that have attribute mappings to two or more different types of Data Sources (e.g. a Configuration model and a Commerce process). Refer to Enable Apply context-dependent data source in Pricing Attribute Mapping.

  4. Click Update or Save.


ClosedAdd a Custom Charge Attribute

Complete the following steps create a custom Charge Attribute in the Pricing Engine.

  1. Navigate to Admin > Pricing Portal > Pricing Attributes.

  2. Select Add form the Actions drop-down.

    1. Select the Charge Pricing Entity option.

      Refer to Add a Custom Pricing Attribute for Header and Line attributes.

    2. The In/Out type is automatically set to Output for Charge type Pricing Attributes.

      Each Charge type Pricing Attribute can have only one of the following values:

      • Output – This option defines attribute values that will be written as outputs from pricing into Commerce.

      • External – This value is automatically set for Charge Set Attributes that are currently calculated by CPQ Quoting but will in future be calculated by Pricing Engine. For now these attributes form part of the schema definition for Charge Set attributes in CPQ Commerce. This value cannot be selected when created new custom Pricing Attributes.

    3. Enter a Name.

    4. Enter the Variable Name.

    5. Select the Data Type: Boolean, Currency, String, Decimal, Date, Integer, or Text Area.

    6. Select a Lookup to associate a Pricing Lookup to a String type attribute, if applicable.

      • This field is only available for string data types.

      • Refer to Pricing Lookups for more information.

    7. (optional) Select or enter a Default Value.

      • The default value cannot be specified for currency or text area data types.

      • Only True or False values can be selected for Boolean data types.

      • When a Lookup is selected, you can select a default value from values defined in Pricing Lookups.

    8. The Visibility field identifies if the charge attribute is visible in other CPQ modules. This field is automatically populated. Visibility options can be deleted, but this field cannot be empty. You can click inside the Visibility field to reselect modules.

      • Administration: CPQ administrator UIs, for example, Pricing Portal, Product Workbench

        Administration must be visible to display an attribute in Price Model > Pricing Data.

      • Runtime: Buy-side UIs, for example, quoting & configuration buy-side.

    9. Check Required to make this field mandatory.

    10. Check Negotiable to allow modification of this attribute at runtime.

    11. (optional) Enter a Description.

    12. Click Create.

  3. Complete the following items to map a pricing attribute to a Commerce attribute.

    1. Select Edit from the Actions drop-down.

    2. Click Add.

    3. Select the Data Source from the drop-down menu.

    4. Select the appropriate attribute from the Source Attribute Name drop-down menu.

      • The Source Attribute Variable Name and Path will auto-populate.

      • To reorder mapping attributes, click in the Order field and enter the desired order number.

      • To delete an attribute mapping, click the ellipsis at the end of the line and select Delete.

    5. Repeat 3b – 3d to add and map additional attributes.

      Note: Contextual data sources can be enabled for Pricing Attributes that have attribute mappings to two or more different types of Data Sources (e.g. a Configuration model and a Commerce process). Refer to Enable Apply context-dependent data source in Pricing Attribute Mapping.

  4. Click Update or Save.


ClosedSynchronize Charge Array Set

Complete the following steps to synchronize the Transaction Line Charge Array Set with the pricing charge schema, which is comprised of standard and extensible custom charge attributes. If the Transaction Line Charge Array Set doesn’t exist, it will be created when the Synchronize Charge Array Set action is invoked.

  1. Navigate to Admin > Process Definition.
  2. Select Documents from the applicable process Navigation drop-down menu, and then click List.
  3. Select Attributes from the Transaction Line Navigation drop-down menu, and then click List.
  4. Click Synchronize Charge Array Set at the bottom of the Attribute List page.

Notes:

  • If the Transaction Line Charge Array Set doesn’t exist, it will be created when the Synchronize Charge Array Set action is invoked.
  • Refer to Sub-Document Attribute Sets > Charge Array Set for more information about the Transaction Line Charge Array Set.

ClosedEnable Apply context-dependent data source in Pricing Attribute Mapping

Complete the following steps to enable Apply context-dependent data source in Pricing Attribute Mapping in the Pricing Engine.

Note: This setting is only applicable when a Pricing Attribute has attribute mappings to two or more different types of Data Sources (e.g. a Configuration model and a Commerce process).

  1. Navigate to Admin > Pricing Portal > Pricing Options.

  2. Click Edit.

  3. Set the Apply context-dependent data source in Pricing Attribute Mapping option to On.

  4. Click Update.


ClosedPricing Engine Quantity Attribute

The standard Pricing Engine Quantity attribute supports the Volume Pricing and Tier Pricing price models. This pricing attribute can't be deleted, but it can have new mappings added and its mappings can be reordered. This Quantity pricing attribute is used to determine which pricing tier applies when executing the dynamic pricing types that are quantity-driven (i.e. Tiered Pricing, Volume Pricing price models). If the value of the attribute is missing when the mappings are evaluated at runtime, a quantity of 1 is used.

Pricing Engine Quantity Attribute


ClosedReorder Mapped Pricing Attributes

Complete the following steps to reorder mapped pricing attributes.

  1. Navigate to the Admin page.

  2. Click Pricing Portal in the Products section.

  3. Click on the Pricing Attributes card.
  4. Click the appropriate Attribute Name link.

  5. Click the Attribute Mapping Edit button.

  6. To reorder mapping attributes, click in the Order field and enter the desired order number.

    Reorder attribute mappings

  7. Click Update to save the new attribute mapping order.


 

Notes

Caution: A header Pricing Attribute should not be mapped to a Configuration attribute, unless pricing is executed only for recommended items in Configuration. In all other scenarios, the Pricing Attribute can have an invalid value during runtime execution, for example at quoting, or for BOM items in Configuration. If you'd like to map to a Configuration attribute, consider using a line Pricing Attribute instead.

Notes:

  • By default, CPQ Pricing Engine uses a standard natural key for the Charge object including Price Type, Charge Type, and Price Period.

  • Mapping a Text Area type Charge Attribute to a Commerce Text attribute may cause truncated data.

  • Oracle Order Management requires that each Charge for an item has a unique combination of Price Type and Charge Type. If you are integrating Oracle CPQ with Oracle Order Management you will need to define a different Charge Type to distinguish Charges with the same Price Type but different Price Periods.

  • The maximum number of custom Pricing/Charge Attributes is 75. Submit a Service Request (SR) on My Oracle Support to change the maximum number.

 

Related Topics

Related Topics Link IconSee Also