Create a Key Attribute

A key attribute defines a specific object field that the pricing engine uses as part of a condition record search key. Key attributes are the building blocks of key types. A key type combines multiple key attributes to define the exact combination of fields the engine uses to look up a condition record.

Required Editions

Available in: Lightning Experience

Available in: Enterprise and Unlimited Editions that have Consumer Goods Cloud enabled

User Permissions Needed
To create key attributes:

(CGCloud Business Admin

OR

CGCloud Retail Business Admin)

AND

Penny Perfect Pricing

Set up key attributes before creating key types.

The object you select determines which Salesforce fields are available as the attribute name in the next step:

  • Customer—Use for attributes that vary by account, such as customer tax code, customer group, or pricing-relevant customer classification.

  • Product—Use for attributes that vary by product, such as product tax classification, product category, or brand.

  • Order—Use for attributes from the current order header, such as order type, delivery date, or region code.

  • Auxiliary—Use for fields that don't belong to the standard Customer, Product, or Order objects. Useful for custom pricing context fields added via Add Custom Attributes to the Penny Perfect Pricing Context.

The attribute name is the specific Salesforce field that the pricing engine reads when evaluating a condition record lookup. For example, if you select Customer as the object and select Tax Code as the attribute name, the engine uses the tax code on the customer record to find the matching condition.

Note
Note Long text fields aren't supported as key attributes. Use fields with discrete values such as picklists, IDs, or short text.
Key Attribute Examples
Key Attribute Object Purpose
Customer ID Customer Identifies the account placing the order
Product ID Product Identifies the product SKU
Customer Tax Code Customer The customer's tax jurisdiction classification
Product Tax Classification Product The product's tax category
Region Code Order The geographic region of the order
Distribution Channel Auxiliary The channel through which the product is sold
  1. From App Launcher, find and select Key Attributes, and then click New.
  2. Enter a name.
  3. Select a sales org.
  4. Select an object to map the key attribute with:
    • Customer: Maps with customer fields.
    • Product: Maps with product fields.
    • Order: Maps with current order fields.
    • Auxiliary: Maps with fields other than customer, product, or current order.
  5. Select an attribute name.
  6. Enter a description.
  7. Save your changes.
  • Create a Custom Key Attribute
    Salesforce provides a few standard out-of-the-box key attributes such as customer, product, order, or customer sets. You can define key attributes that aren’t a part of the standard set of attributes by using custom key attributes. With custom key attributes, you can define a special or specific search key.