applicable_reward_offer_complete

Name

Type

Description

id

String

The ID of the retrieved reward offer

number

String

The number of the retrieved reward offer

nameStringThe name of the retrieved reward offer
alternative_codeStringThe alternative code of the retrieved reward offer
descriptionStringThe description of the retrieved reward offer
classificationString

The reward offer classification, which can be one of the following:

  • UTILISE_FREE_CAPACITY
  • INCREASE_REVENUE_TRANSACTION_BASED
  • INCREASE_REVENUE_PRODUCT_BASED
  • REWARD_LOYALTY_TRANSACTION_AMOUNT_BASED
  • REWARD_LOYALTY_TRANSACTION_NUMBER_BASED
  • REWARD_LOYALTY_TRANSACTION_ITEM_QUANTITY_BASED
  • REWARD_SIGN_UPS
  • REWARD_REFERRALS
  • REWARD_PERSONAL_DATA_COMPLETENESS
  • REWARD_ACHIEVEMENTS
  • REWARD_FINANCIAL_STATEMENTS
  • REWARD_SUBSCRIPTION_MATURITY
  • JUST_MONEY
  • LOTTERY
  • XTH_TRANSACTION_WINS
evaluation_methodString

The method that will be used to evaluate the offers which can be BATCH_PROCESS or INTERACTIVELY

award_scopeString

The award scope that defines if the award provided by the reward offer should be applied per transaction or per transaction item, which can be APPLY_AWARD_PER_TRANSACTION or APPLY_AWARD_PER_TRANSACTION_ITEM

spend_methodString

The method that will be used to spend the offers which can be SPEND_ON_REQUEST, SPEND_INSTANTLY, SPEND_INSTANTLY_THROUGH_VOUCHER

apply_on_top_of_other_applicable_offersBoolean

If false then the reward offer will be applicable only if the provided award is the best award among other reward offers that might be applicable. If true then it will be applied irrespective of any other applicable reward offers

life_cycle_state

String

The life cycle state of the retrieved lead which can be EFFECTIVE or NOT EFFECTIVE

latest_effective_dateDateThe latest effective date of the retrieved reward offer
latest_evaluation_dateDateThe latest date that the reward offer was evaluated. This is applicable only for reward offers with evaluation method equal to BATCH
offer_valid_fromDateThe date that the reward offer became valid
offer_valid_toDateThe date that the reward offer expires
award_valid_fromDateThe date that the award will become valid
award_valid_toDateThe date that the award will expire
award_currencyCurrency Object

The currency in which the Reward Offer's award will be provided which can either be in system or the alternative currency.

reward_schemeReward Scheme ObjectThe reward scheme of the retrieved reward offer
categoryReward Offer Category ObjectThe category information of the retrieved reward offer
owned_by_groupGroup object

The group that is owning the reward offer 

Deprecated from CRM.COM R18.0.0 (replaced with owned_by_business_unit)

owned_by_business_unitBusiness Unit Object

The business unit that is owning the reward offer

Available from CRM.COM R18.0.0

marketing_informationReward Offer Marketing Information Object

The reward offer's marketing information

log_informationLog Information ObjectThe log information related with the retrieved reward offer

Referred Objects Response Data

 currency object response data

Name

Type

Description

id

String

The ID of the retrieved currency

code

String

The code of the retrieved currency

prefix_symbolStringThe prefix symbol for the specified currency

suffix_symbol

StringThe suffix symbol for the specified currency
life_cycle_stateString

The life cycle state for the specified currency, which can be EFFECTIVE or NOT EFFECTIVE

Available from CRM.COM R14.0.0

integer_part_nameStringThe integer part name for the specified currency
decimal_part_nameStringThe decimal part name for the specified currency

 reward scheme object response data

Name

Type

Description

id

String

The ID of the retrieved reward scheme

name

String

The name of the retrieved reward scheme

alternative_code

String

The alternative code of the retrieved reward scheme

descriptionStringA description of the retrieved reward scheme
life_cycle_stateStringThe life cycle state of the reward scheme which can be EFFECTIVE or NOT_EFFECTIVE

 reward_offer_category data object
NameType Description
idStringThe ID of the retrieved reward offer category
nameStringThe Name of the retrieved reward offer category
codeStringThe Code of the retrieved reward offer category
descriptionStringThe Description of the retrieved reward offer category
parent_idString

The id of the retrieved category's parent category

 group object response data

Name

Type

Description

id

String

The ID of the retrieved group

name

String

The name of the retrieved group

community_name

String

The name of the community that the retrieved group belongs to

alternative_code

String

The alternative code of the retrieved group

unified_codeString

The unified code of the retrieved group

Available from CRM.COM R16.2.2

description

String

The description of the retrieved group

 reward offer marketing information object response data

Name

Type

Description

long_descriptionStringThe offer's long description
short_descriptionStringThe offer's short description
no_awards_status_textString

The text that should appear to inform the participant that he has not been awarded yet.

Deprecated from CRM.COM R17.0.0

times_awarded_status_textString

The text that should appear to inform the participant that the number displayed is the times he has been awarded.

Deprecated from CRM.COM R17.0.0

average_weekly_awarded_amount_textString

The text that should appear to inform the participant that the amount displayed is the average weekly awarded amount.

Deprecated from CRM.COM R17.0.0

offer_imageReward Offer Image ObjectThe reward large (standard) offer image
offer_small_imageReward Offer Image ObjectThe reward small offer image
offer_backgroundReward Offer Background Object

The reward offer background which can be an image or a color

Deprecated from CRM.COM R17.0.0

offer_stamp_imageReward Offer Stamp Image Object

The reward offer stamp image

Available from CRM.COM R15.0.0

Deprecated from CRM.COM R17.0.0

Referred Objects Response Data

 Reward offer Marketing Information Image Object

Name

Type

Description

file_nameStringThe name of the file.
file_content_urlStringThe url that can be used to access the actual content of the file.
file_mime_typeStringThe mime type of the attached file
file_alt_textStringThe alternative text of the attached file, if the file is an image

 Reward scheme Marketing Information Background Object

Name

Type

Description

file_nameStringThe name of the file.
file_content_urlStringThe url that can be used to access the actual content of the file.
file_mime_typeStringThe mime type of the attached file
file_alt_textStringThe alternative text of the attached file, if the file is an image
colorStringThe hexadecimal value of the color that will be used as a background

 Reward offer Marketing Information Stamp Image Object

Name

Type

Description

file_nameStringThe name of the file.
file_content_urlStringThe url that can be used to access the actual content of the file.
file_mime_typeStringThe mime type of the attached file
file_alt_textStringThe alternative text of the attached file, if the file is an image

 log_information object response data

Name

Type

Description

created_date

Date

The date that the retrieved record was created

updated_date

Date

The last date that the retrieved record was updated

created_by_unit

Unit Object

The unit that created the retrieved record

From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled

Deprecated from CRM.COM R18.0.0

created_by_business_unit

Unit Object

The unit that created the retrieved record

From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled

Available from CRM.COM R18.0.0

created_by_user

User Object

The user that created the retrieved record

From CRM.COM R14.1.0 and onward, person_name and email attributes will be returned as empty, if the related legacy compatibility setting is disabled

updated_by_unit

Unit Object

The last unit that updated the retrieved record

From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled

Deprecated from CRM.COM R18.0.0

updated_by_business_unit

Unit Object

The last unit that updated the retrieved record

Available from CRM.COM R18.0.0

updated_by_user

User Object

The last user that updated the retrieved record

From CRM.COM R14.1.0 and onward, person_name and email attributes will be returned as empty, if the related legacy compatibility setting is disabled

Referred Objects Response Data

 unit object response data

Name

Type

Description

id

String

The ID of the retrieved unit

name

String

The name of the retrieved unit

group_name

String

The name of the group that the retrieved unit belongs to

community_name

String

The name of the community that the retrieved unit belongs to

alternative_code

String

The alternative code of the retrieved unit

description

String

The description of the retrieved unit

 business unit object response data

Name

Type

Description

id

String

The ID of the retrieved business unit

name

String

The name of the retrieved business unit

codeStringThe code of the retrieved business unit
unified_codeString

The unified code of the retrieved business unit

description

String

The description of the retrieved business unit

parent_business_unit_nameStringThe name of the parent business unit that the retrieved business unit belongs to

 user object response data

Name

Type

Description

id

String

The ID of the retrieved user

username

String

The user name of the retrieved user

person_name

String

The full name of the retrieved user

email

String

The email of the retrieved user

 business unit object response data

Name

Type

Description

id

String

The ID of the retrieved business unit

name

String

The name of the retrieved business unit

codeStringThe code of the retrieved business unit
unified_codeString

The unified code of the retrieved business unit

description

String

The description of the retrieved business unit

parent_business_unit_nameStringThe name of the parent business unit that the retrieved business unit belongs to