---
schema_version: "1"
id: 7a6eab1dafe7855390800ab015b330c61aee2a3e8de28fc17394eb1f621f0148
title: cgcloud__Promotion_Reward__c
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/retail_api/sforce_api_objects_cgcloud__promotion_reward__c.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_objects_cgcloud__promotion_reward__c.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 1449eb5210060665003d5b6c0cc8efb0b6cd5884f854bc87f003fe6762bfccdd
description: This object stores the details of rewards that are assigned to a reward group. This object is available in API version 54.0 and later.
---
# cgcloud\_\_Promotion\_Reward\_\_c

This object stores the details of rewards that are assigned to a reward group. This object is available in API version 54.0 and later.

## Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), undelete(), update(), upsert()

## Fields

### Name

- **Type**: string
- **Properties**: Autonumber, Defaulted on create, Filter, idLookup, Sort
- **Description**: Unique identification of the record.

### cgcloud\_\_Automatically\_Granted\_\_c

- **Type**: boolean
- **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update
- **Description**: Defines whether the rewards must be automatically granted.
- **Default value**: false

### cgcloud\_\_Boolean\_Value\_\_c

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- **Description**: Value to compare with an output parameter.
- **Possible values**:
    - false—False
    - true—True

### cgcloud\_\_Classification\_\_c

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- **Description**: Classification of either Free Item Reward or Special Rewards.
- **Possible values**:
    - C1
    - C2
    - C3
    - C4
    - C5

### cgcloud\_\_Count\_Products\_\_c

- **Type**: double
- **Properties**: Filter, Nillable, Sort
- **Description**: Count of Promotion\_Reward\_Product\_\_c records.
    
    This is a calculated field.

### cgcloud\_\_Date\_Value\_\_c

- **Type**: date
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Value to compare with an output parameter.

### cgcloud\_\_Default\_Value\_\_c

- **Type**: double
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: Default value depending on Condition\_Type.

### cgcloud\_\_Description\_Language\_1\_\_c

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Stores the description of language 1.

### cgcloud\_\_Description\_Language\_2\_\_c

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Stores the description of language 2.

### cgcloud\_\_Description\_Language\_3\_\_c

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Stores the description of language 3.

### cgcloud\_\_Description\_Language\_4\_\_c

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Stores the description of language 4.

### cgcloud\_\_Description\_\_c

- **Type**: string
- **Properties**: Filter, Nillable, Sort
- **Description**: Description based on the user-specified language.
    
    This is a calculated field.
- **Formula**:
    
    CASE($User.cgcloud\_\_Language\_Postfix\_\_c,
    
    "Language1", cgcloud\_\_Description\_Language\_1\_\_c,
    
    "Language2", BLANKVALUE(cgcloud\_\_Description\_Language\_2\_\_c,cgcloud\_\_Description\_Language\_1\_\_c),
    
    "Language3", BLANKVALUE(cgcloud\_\_Description\_Language\_3\_\_c,cgcloud\_\_Description\_Language\_1\_\_c),
    
    "Language4", BLANKVALUE(cgcloud\_\_Description\_Language\_4\_\_c,cgcloud\_\_Description\_Language\_1\_\_c),cgcloud\_\_Description\_Language\_1\_\_c)

### cgcloud\_\_Free\_Item\_\_c

- **Type**: boolean
- **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update
- **Description**: Defines a reward as free item-relevant.
- **Default value**: false

### cgcloud\_\_Hurdle\_\_c

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Reference to Hurdle. Indicates whether a specific hurdle condition resolution is to be done for rewards values.
    
    This is a relationship field.
- **Relationship Name**: cgcloud\_\_Hurdle\_\_r
- **Relationship Type**: Lookup
- **Refers To**: cgcloud\_\_Promotion\_Hurdle\_\_c

### cgcloud\_\_Included\_\_c

- **Type**: boolean
- **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update
- **Description**: Define whether the reward is to be included on pricing calculations in the context of selectable promotion.
- **Default value**: true

### cgcloud\_\_Numeric\_Value\_\_c

- **Type**: double
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: Value to compare with an output parameter.

### cgcloud\_\_Pricing\_Condition\_Template\_\_c

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Reference to the pricing condition template.
    
    This is a relationship field.
- **Relationship Name**: cgcloud\_\_Pricing\_Condition\_Template\_\_r
- **Relationship Type**: Lookup
- **Refers To**: cgcloud\_\_CP\_Pricing\_Condition\_Template\_\_c

### cgcloud\_\_Promotion\_Reward\_Group\_\_c

- **Type**: reference
- **Properties**: Create, Filter, Group, Sort
- **Description**: Master-Detail to the Reward Group to which the Reward belongs.
    
    This is a relationship field.
- **Relationship Name**: cgcloud\_\_Promotion\_Reward\_Group\_\_r
- **Relationship Type**: Master-detail
- **Refers To**: cgcloud\_\_Promotion\_Reward\_Group\_\_c (the master object)

### cgcloud\_\_Reward\_Type\_\_c

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- **Description**: Defines the type of reward.
- **Possible values**:
    - AmountPerUnit—Amount Per Unit
    - FlatRate—Flat Rate
    - FreeItem—Free Item
    - PercentageDiscount—Percentage Discount
    - Special
    - SpecialBasePrice—Special Base Price

### cgcloud\_\_Sort\_Unique\_\_c

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Defines the uniqueness of the sort value.

### cgcloud\_\_Sort\_\_c

- **Type**: double
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: Sort order of the displayable rewards records.

### cgcloud\_\_SubGroup\_\_c

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Defines the subgroup to which the rewards belongs.

### cgcloud\_\_Text\_Value\_\_c

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Value to compare with an output parameter.

### cgcloud\_\_Title\_Language\_1\_\_c

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Stores the title of language 1.

### cgcloud\_\_Title\_Language\_2\_\_c

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Stores the title of language 2.

### cgcloud\_\_Title\_Language\_3\_\_c

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Stores the title of language 3.

### cgcloud\_\_Title\_Language\_4\_\_c

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Stores the title of language 4.

### cgcloud\_\_Title\_\_c

- **Type**: string
- **Properties**: Filter, Nillable, Sort
- **Description**: Localizable title of the Reward Group. Reference to the title based on the user-specified language.
    
    This is a calculated field.
- **Formula**:
    
    CASE($User.cgcloud\_\_Language\_Postfix\_\_c,
    
    "Language1", cgcloud\_\_Title\_Language\_1\_\_c,
    
    "Language2", BLANKVALUE(cgcloud\_\_Title\_Language\_2\_\_c,cgcloud\_\_Title\_Language\_1\_\_c),
    
    "Language3", BLANKVALUE(cgcloud\_\_Title\_Language\_3\_\_c,cgcloud\_\_Title\_Language\_1\_\_c),
    
    "Language4", BLANKVALUE(cgcloud\_\_Title\_Language\_4\_\_c,cgcloud\_\_Title\_Language\_1\_\_c),
    
    cgcloud\_\_Title\_Language\_1\_\_c)

### cgcloud\_\_User\_Exit\_\_c

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Defines a Reward as a Special Reward.

## Associated Objects

### Associated Objects

This object has these associated objects. If the API version isn’t specified, they are available in the same API versions as this object. Otherwise, they e available in the specified API version and later.

- **[cgcloud\_\_Promotion\_Reward\_\_cChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.")**: Change events are available for the object.
- **[cgcloud\_\_Promotion\_Reward\_\_cFeed](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.")**: Feed tracking is available for the object.
- **[cgcloud\_\_Promotion\_Reward\_\_cHistory](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.")**: History is available for the tracked fields of the object.
- **[cgcloud\_\_Promotion\_Reward\_\_cOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_associated_objects_ownersharingrule.htm "StandardObjectNameOwnerSharingRule is the model for all owner sharing rule objects associated with standard objects. These objects represent a rule for sharing a standard object with users other than the owner.")**: Sharing rules are available for the object.
- **[cgcloud\_\_Promotion\_Reward\_\_cShare](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.")**: Sharing is available for the object.