Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...


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

BATCH_PROCESS_AND_

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

Tip
Available

Deprecated from CRM.COM

R10

R17.0.0


spend_methodString

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

ONapply_if_best_award_is_provided

THROUGH_VOUCHER

Tip

Available from CRM.COM R10.0.0

Tip

Spend on voucher option available from CRM.COM R14.2.0

apply_on_top_of_other_applicable_offersBoolean

If

true

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

Tip
Available

Deprecated from CRM.COM

R10

R17.

1

0.0


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
terms_and_conditionsString

The terms and conditions for the retrieved reward offer

Tip

Available from CRM.COM R15.0.0


award_amountNumberThe awarded amount provided by the reward offer. An awarded amount can be specified in all reward offers classifications. Either an awarded amount, award percentage or award percentage on awarded purchases is returned per reward offer.
award_percentageNumber

The award percentage of the financial transaction amount that triggered the award. Either an awarded amount, award percentage or award percentage on awarded purchases is returned per reward offer. An offer's awarded percentage can only be specified in the offer is classified as: UTILISE_FREE_CAPACITY, INCREASE_REVENUE_TRANSACTION_BASED, INCREASE_REVENUE_PRODUCT_BASED, REWARD_LOYALTY_TRANSACTION_AMOUNT_BASED and

REWARD_LOYALTY_TRANSACTION_ITEM_QUANTITY_BASED Tip

 REWARD_LOYALTY_TRANSACTION_ITEM_QUANTITY_BASED

is available from CRM.COM R12.0.0number_of_awarded_participantsNumber

The number of the participants to be awarded within the period provided through lottery_award_period parameter. Available only if the reward offer is classified as LOTTERY

Tip

Available from CRM.COM R14.2.0

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.

TipAvailable from CRM.COM R14.2.0

award_percentage_on_previous_awardsAward Percentage on Previous Awards Object

The award percentage on awards submitted within a specific period of time. Award percentage on previous awards can be specified in all reward offers classifications.

Tip

Available from CRM.COM R10.

1

0.0

reward


award_
scheme
currency
Reward Scheme
Currency Object

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

reward_scheme
of the retrieved reward offertype
Reward
Offer Type
Scheme ObjectThe
type information
reward scheme of the retrieved reward offer
categoryReward Offer Category ObjectThe category information
of the retrieved reward offerreward_offer_validityReward Offer Validity ObjectThe validity settings of the retrieved reward offerreward_award_validityReward Award Validity ObjectThe award validity settings
of the retrieved reward offer
's awarded amount
owned_by_groupGroup object

The group that is owning the reward

offer privacy_levelPrivacy level objectThe privacy level of the reward offerlog_informationLog Information ObjectThe log information related with the retrieved reward offermarketing_informationReward Offer Marketing Information ObjectThe reward offer's marketing information

offer 

Tip
Available

Deprecated from CRM.COM

R12.2.0voucher_typeVoucher Type Object

The type of the voucher that will be issued if the reward offer's awarded amount will be instantly spent through a voucher

Tip

Available from CRM.COM R14.2.0

award_percentage_on_key_performance_indicator_valuesSet of Award Percentage on Key Performance Indicator Values ObjectsThe award percentage that will be applied, based on the value of each specified key performance indicator, as measured through financial statement customer events. This award option is applicable only if the reward offer is classified as REWARD_FINANCIAL_STATEMENTS

R18.0.0 (replaced with owned_by_business_unit)


owned_by_business_unitBusiness Unit Object

The business unit that is owning the accounts receivable

Tip

Available from CRM.COM

R11

R18.0.0

award


marketing_
conditions_set
information
Set of
Reward Offer
Award Conditions objects
Marketing Information Object

The reward offer's

award conditions that should be met in order for the rewards participant to benefit from the reward offerspend_conditions_setSet of Reward Offer Spend Conditions objectsThe reward offer's conditions based on which the rewards participant is allowed to spend the awarded amount

marketing information

log_informationLog Information ObjectThe log information related with the retrieved reward offer

Anchor
reward offer referred objects
reward offer referred objects
Referred Objects Response Data Include Pagelottery_condition_creation_period_shortlottery_condition_creation_period_short

Include Page
currency_short
currency_short

Include Page
reward_offer_award_percentage_on_previous_awards_shortreward_offer_award_percentage_on_previous_awards_short
Include Page
reward_scheme_short
reward_scheme_short

Include Page
reward_offer_typeaward_shortrewardpercentage_offeron_type_short
Include Page
reward_offer_categorykey_performance_indicator_values_short
reward_offer_category_short
Include Page
reward_offer_validity_shortreward_offer_validityaward_percentage_on_key_performance_indicator_values_short

Include Page
reward_offer_awardcategory_validity_short
reward_offer_awardcategory_validity_short

Include Page
group_short
group_short

Include Page
privacybusiness_levelunit_shortprivacy_level_short
Include Page
log_information_shortlog_informationbusiness_unit_short

Include Page
reward_offer_marketing_information
reward_offer_marketing_information

Include Page
voucherlog_typeinformation_shortvoucher_type_short
Include Page
reward_offer_award_percentage_on_key_performance_indicator_values_short
reward_offer_award_percentage_on_key_performance_indicator_values_short
Include Page
reward_offer_award_conditions_shortreward_offer_award_conditions_short
Include Page
reward_offer_spend_conditions_shortreward_offer_spend_conditionslog_information_short