- Created by Former user, last modified by Sevia Kyriacou (Deactivated) on May 24, 2018
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 6 Next »
Available from CRM.COM R10.0.0
This method returns information related with a reward offer. A single reward offer is returned by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
| reward_offer_identifier (mandatory) | Reward Offer identifier | The identifier of the reward offer that should be returned as a result. The allowed reward offer identifier fields are the following:
| ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
|---|---|---|
id | String | The ID of the retrieved reward offer |
number | String | The number of the retrieved reward offer |
| name | String | The name of the retrieved reward offer |
| alternative_code | String | The alternative code of the retrieved reward offer |
| description | String | The description of the retrieved reward offer |
| classification | String | The reward offer classification, which can be one of the following:
|
| evaluation_method | String | The method that will be used to evaluate the offers which can be BATCH_PROCESS or INTERACTIVELY |
| award_scope | String | 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 Deprecated from CRM.COM R17.0.0 |
| spend_method | String | 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_offers | Boolean | 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 Deprecated from CRM.COM R17.0.0 |
life_cycle_state | String | The life cycle state of the retrieved lead which can be EFFECTIVE or NOT EFFECTIVE |
| latest_effective_date | Date | The latest effective date of the retrieved reward offer |
| latest_evaluation_date | Date | The latest date that the reward offer was evaluated. This is applicable only for reward offers with evaluation method equal to BATCH |
| terms_and_conditions | String | The terms and conditions for the retrieved reward offer Available from CRM.COM R15.0.0 |
| award_amount | Number | The 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_percentage | Number | 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 |
| award_percentage_on_previous_awards | Award 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. Available from CRM.COM R10.0.0 |
| award_currency | 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 | Reward Scheme Object | The reward scheme of the retrieved reward offer |
| category | Reward Offer Category Object | The category information of the retrieved reward offer |
| owned_by_group | Group 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_unit | Business Unit Object | The business unit that is owning the accounts receivable Available from CRM.COM R18.0.0 |
| marketing_information | Reward Offer Marketing Information Object | The reward offer's marketing information |
| log_information | Log Information Object | The 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_symbol | String | The prefix symbol for the specified currency |
suffix_symbol | String | The suffix symbol for the specified currency |
| life_cycle_state | String | The life cycle state for the specified currency, which can be EFFECTIVE or NOT EFFECTIVE Available from CRM.COM R14.0.0 |
| integer_part_name | String | The integer part name for the specified currency |
| decimal_part_name | String | The 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 |
| description | String | A description of the retrieved reward scheme |
| life_cycle_state | String | The life cycle state of the reward scheme which can be EFFECTIVE or NOT_EFFECTIVE |
award percentage on key performance indicator values response data
Name | Type | Description |
|---|---|---|
| percentage | Number | Defines the award percentage that should be applied on the value of the specified key performance indicator |
| key_performance_indicator | Key Performance Indicator Objects | The key performance indicator that will be awarded based on its value and the specified percentage |
key performance indicator object response data
Name | Type | Description |
|---|---|---|
id | String | The id of the retrieved customer event key performance indicator |
name | String | The name of the retrieved customer event key performance indicator |
alternative_code | String | The alternative code of the retrieved customer event key performance indicator |
reward_offer_category data object
| Name | Type | Description |
|---|---|---|
| id | String | The ID of the retrieved reward offer category |
| name | String | The Name of the retrieved reward offer category |
| code | String | The Code of the retrieved reward offer category |
| description | String | The Description of the retrieved reward offer category |
| parent_id | String | 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_code | String | The unified code of the retrieved group Available from CRM.COM R16.2.2 |
description | String | The description of the retrieved group |
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 |
| code | String | The code of the retrieved business unit |
| unified_code | String | The unified code of the retrieved business unit |
description | String | The description of the retrieved business unit |
| parent_business_unit_name | String | The name of the parent business unit that the retrieved business unit belongs to |
reward offer marketing information object response data
Name | Type | Description |
|---|---|---|
| long_description | String | The offer's long description |
| short_description | String | The offer's short description |
| no_awards_status_text | String | 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_text | String | 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_text | String | 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_image | Reward Offer Image Object | The reward large (standard) offer image |
| offer_small_image | Reward Offer Image Object | The reward small offer image |
| offer_background | Reward Offer Background Object | The reward offer background which can be an image or a color Deprecated from CRM.COM R17.0.0 |
| offer_stamp_image | Reward 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_name | String | The name of the file. |
| file_content_url | String | The url that can be used to access the actual content of the file. |
| file_mime_type | String | The mime type of the attached file |
| file_alt_text | String | The alternative text of the attached file, if the file is an image |
Reward scheme Marketing Information Background Object
Name | Type | Description |
|---|---|---|
| file_name | String | The name of the file. |
| file_content_url | String | The url that can be used to access the actual content of the file. |
| file_mime_type | String | The mime type of the attached file |
| file_alt_text | String | The alternative text of the attached file, if the file is an image |
| color | String | The hexadecimal value of the color that will be used as a background |
Reward offer Marketing Information Stamp Image Object
Name | Type | Description |
|---|---|---|
| file_name | String | The name of the file. |
| file_content_url | String | The url that can be used to access the actual content of the file. |
| file_mime_type | String | The mime type of the attached file |
| file_alt_text | String | The 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 |
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 | |
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 | |
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 | |
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 | |
Unit Object | The last unit that updated the retrieved record Available from CRM.COM R18.0.0 | |
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 |
| code | String | The code of the retrieved business unit |
| unified_code | String | The unified code of the retrieved business unit |
description | String | The description of the retrieved business unit |
| parent_business_unit_name | String | The 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 |
String | The email of the retrieved user |
Examples
Example 1
HTTP Method: GET
http://cyn1lnx004:9080/crmapi/rest/v2/reward_offers/show?token=62B858D0EE784763922A6A96439AF7D8&reward_offer_identifier=number=63
Request:
{{server}}/crmapi/rest/v2/reward_offers/show?token={{token}}&reward_offer_identifier=number=169
Response:
{
"data": {
"award_conditions_set": {
"financial_achievement_conditions": {
"financial_achievement_amount_range": {
"from_value": 5,
"to_value": 12
},
"number_of_awards": "ONLY_ONE_PER_PERIOD",
"number_of_awards_period": {
"time_period_uot": "WEEKS",
"time_period_value": 5
},
"all_achievements_should_exist": false,
"financial_achievement_classifications_set": [
{
"alternative_code": "FA2",
"name": "Financial Achievement 2",
"id": "7FD0A0BE5D684A3698BCEE2ACFC7F7AF"
},
{
"alternative_code": "FA",
"name": "Financial Achievement 1",
"id": "39031C33C1AC4FB79140B27D1614CD6A"
}
]
},
"location_conditions_set": null,
"period_conditions": null,
"product_conditions_set": [],
"segment_conditions_set": [],
"organisational_unit_conditions_set": [],
"payment_medium_conditions_set": {}
},
"alternative_code": "PTO",
"reward_offer_validity": {
"validity_options": "VALID_FROM_LATEST_EFFECTIVE_DATE"
},
"log_information": {
"created_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"updated_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"created_date": "2016-10-04T07:14:14",
"updated_date": "2016-10-07T12:12:42",
"updated_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": "dev@crm.com",
"username": "MPAdministrator"
},
"created_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": "dev@crm.com",
"username": "MPAdministrator"
}
},
"privacy_level": null,
"reward_scheme": {
"alternative_code": "PKRS",
"name": "PK Reward Scheme",
"description": null,
"id": "19A8546CACC3470898147EF0EAFE4CA2",
"life_cycle_state": "EFFECTIVE"
},
"owned_by_group": {
"alternative_code": "MG",
"community_name": "Community",
"name": "Main Group",
"description": "Main Group",
"id": "1"
},
"description": null,
"apply_if_best_award_is_provided": false,
"spend_method": null,
"life_cycle_state": "NOT_EFFECTIVE",
"spend_conditions_set": {
"time_conditions_set": {
"days_condition_set": [
[]
],
"hours_condition_set": []
},
"product_conditions_set": [],
"organisational_unit_conditions_set": [],
"allowed_spend_period_after_award": {
"time_period_uot": null,
"time_period_value": null
}
},
"type": {
"alternative_code": "FA",
"name": "Financial Achievments",
"description": null,
"id": "1F91CA50C16B494A86901861A4681127",
"classification": "REWARD_FINANCIAL_ACHIEVEMENTS"
},
"evaluation_method": "BATCH_PROCESS",
"latest_effective_date": null,
"reward_award_validity": {
"validity_options": "ALWAYS_VALID"
},
"number": "169",
"award_amount": 5,
"name": "PK Test Offer",
"id": "722E83DBC8224523BD156A9936C0C6E2",
"award_scope": null,
"category": null
},
"status": {
"code": "OK",
"description": "",
"message": ""
}
}
Example 2
HTTP Method: GET
Request:
{{server}}/crmapi/rest/v2/reward_offers/show?token={{token}}&reward_offer_identifier=number=46
Response:
{
"data": {
"award_conditions_set": {
"product_conditions_set": [],
"segment_conditions_set": [],
"organisational_unit_conditions_set": [],
"payment_medium_conditions_set": {
"payment_medium_type_condition_set": [
{
"name": "BANK TRANSDER PAYMENT",
"description": null,
"id": "EA7291BC11C846088456A771514642D9",
"altCode": "BTP"
},
{
"name": "CREDIT CARD",
"description": null,
"id": "68FAF1F833194091967F86B1AA352129",
"altCode": "CC"
}
],
"payment_medium_brand_condition_set": [
{
"name": "VISA",
"description": null,
"id": "02DEEA7F35B8413E9C017600653C1223",
"altCode": "V"
}
]
}
},
"alternative_code": "ovc",
"reward_offer_validity": {
"validity_options": "VALID_FROM_LATEST_EFFECTIVE_DATE"
},
"log_information": {
"created_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"updated_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"created_date": "2016-07-05T06:56:43",
"updated_date": "2016-07-05T06:58:41",
"updated_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": "dev@crm.com",
"username": "MPAdministrator"
},
"created_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": "dev@crm.com",
"username": "MPAdministrator"
}
},
"privacy_level": null,
"reward_scheme": {
"alternative_code": "MS",
"name": "Marketing Scheme",
"description": null,
"id": "6CAAD517743C4C179251282A5B2B58A6",
"life_cycle_state": "EFFECTIVE"
},
"owned_by_group": {
"alternative_code": "MG",
"community_name": "Community",
"name": "Main Group",
"description": "Main Group",
"id": "1"
},
"description": null,
"life_cycle_state": "EFFECTIVE",
"spend_conditions_set": {
"time_conditions_set": {
"days_condition_set": [
[]
],
"hours_condition_set": []
},
"product_conditions_set": [],
"organisational_unit_conditions_set": [],
"allowed_spend_period_after_award": {
"time_period_uot": null,
"time_period_value": null
}
},
"type": {
"alternative_code": "FA",
"name": "Financial Achievments",
"description": null,
"id": "1F91CA50C16B494A86901861A4681127",
"classification": "REWARD_FINANCIAL_ACHIEVEMENTS"
},
"evaluation_method": "BATCH_PROCESS_AND_INTERACTIVELY",
"latest_effective_date": "2016-07-05 06:58:41.0",
"reward_award_validity": {
"validity_options": "ALWAYS_VALID"
},
"number": "46",
"award_amount": 12,
"name": "offer that validates criteria",
"id": "C309CC842D274BB3BFF7C320005453B4",
"category": null
},
"status": {
"code": "OK",
"description": "",
"message": ""
}
}
Example 3
HTTP Method: GET
Request:
{{server}}/crmapi/rest/v2/reward_offers/show?token={{token}}&reward_offer_identifier=number=87
Response:
{
"data": {
"award_conditions_set": {
"segment_conditions_set": [
{
"segment": {
"number": "2",
"alternative_code": "EP",
"name": "Effective rewards participants",
"description": null,
"id": "9BCA8988077543B8B1A30D10DEE14440"
},
"option": "EXCLUDE"
}
],
"organisational_unit_conditions_set": [
{
"unit": null,
"group": {
"alternative_code": "EG",
"community_name": "Community",
"name": "External Group",
"description": null,
"id": "641C9485A25246B6B7FE20804E5A81A1"
}
}
],
"nameday_condition": "DURING_NAMEDAY_MONTH"
},
"alternative_code": "ERN",
"reward_offer_validity": {
"validity_options": "VALID_FROM_LATEST_EFFECTIVE_DATE"
},
"log_information": {
"created_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"updated_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"created_date": "2016-07-14T08:09:44",
"updated_date": "2016-07-14T09:33:10",
"updated_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": "dev@crm.com",
"username": "MPAdministrator"
},
"created_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": "dev@crm.com",
"username": "MPAdministrator"
}
},
"privacy_level": null,
"reward_scheme": {
"alternative_code": "MS",
"name": "Marketing Scheme",
"description": null,
"id": "6CAAD517743C4C179251282A5B2B58A6",
"life_cycle_state": "EFFECTIVE"
},
"owned_by_group": {
"alternative_code": "MG",
"community_name": "Community",
"name": "Main Group",
"description": "Main Group",
"id": "1"
},
"description": null,
"life_cycle_state": "EFFECTIVE",
"spend_conditions_set": {
"time_conditions_set": {
"days_condition_set": [
[]
],
"hours_condition_set": []
},
"product_conditions_set": [],
"organisational_unit_conditions_set": [],
"allowed_spend_period_after_award": {
"time_period_uot": null,
"time_period_value": null
}
},
"type": {
"alternative_code": "RON",
"name": "Reward On Nameday",
"description": null,
"id": "8702D2C8C1A04BC283126F944AF29D37",
"classification": "REWARD_ON_NAMEDAY"
},
"evaluation_method": "BATCH_PROCESS",
"latest_effective_date": "2016-07-14 08:10:24.0",
"reward_award_validity": {
"validity_options": "ALWAYS_VALID"
},
"number": "87",
"award_amount": 2.89,
"name": "ET Reward Nameday",
"id": "8B37E0EAF84C4FC7B8745318F0F6840E",
"category": null
},
"status": {
"code": "OK",
"description": "",
"message": ""
}
}
Example 4
HTTP Method: GET
Request:
{{server}}/crmapi/rest/v2/reward_offers/show?token={{token}}&reward_offer_identifier=number=48
Response:
{
"data": {
"award_conditions_set": {
"time_conditions_set": {
"days_condition_set": [
[
{
"day_of_week": "MONDAY"
},
{
"day_of_week": "TUESDAY"
},
{
"day_of_week": "WEDNESDAY"
},
{
"day_of_week": "THURSDAY"
},
{
"day_of_week": "FRIDAY"
},
{
"day_of_week": "SATURDAY"
},
{
"day_of_week": "SUNDAY"
}
]
],
"hours_condition_set": []
},
"transaction_condition": {},
"location_conditions_set": {
"location_set": [
{
"area": "Kaimakli",
"city": "",
"district": ""
},
{
"area": "",
"city": "Larnaca",
"district": "Livadia"
},
{
"area": "",
"city": "Nicosia",
"district": ""
}
]
},
"period_conditions": null,
"product_conditions_set": {
"product_set": []
},
"organisational_unit_conditions_set": []
},
"alternative_code": "UWNC",
"reward_offer_validity": {
"validity_options": "VALID_FROM_LATEST_EFFECTIVE_DATE"
},
"log_information": {
"created_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"updated_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"created_date": "2016-07-11T09:21:14",
"updated_date": "2016-07-15T06:05:34",
"updated_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": "dev@crm.com",
"username": "MPAdministrator"
},
"created_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": "dev@crm.com",
"username": "MPAdministrator"
}
},
"privacy_level": null,
"reward_scheme": {
"alternative_code": "MS",
"name": "Marketing Scheme",
"description": null,
"id": "6CAAD517743C4C179251282A5B2B58A6",
"life_cycle_state": "EFFECTIVE"
},
"owned_by_group": {
"alternative_code": "MG",
"community_name": "Community",
"name": "Main Group",
"description": "Main Group",
"id": "1"
},
"description": null,
"award_percentage": null,
"life_cycle_state": "EFFECTIVE",
"spend_conditions_set": {
"time_conditions_set": {
"days_condition_set": [
[]
],
"hours_condition_set": []
},
"product_conditions_set": [],
"organisational_unit_conditions_set": [],
"allowed_spend_period_after_award": {
"time_period_uot": null,
"time_period_value": null
}
},
"type": {
"alternative_code": "UFCE",
"name": "Utilise Free Capacity ET",
"description": null,
"id": "4B9AD34AA9334F3DB9F6668D1B0E0DB2",
"classification": "UTILISE_FREE_CAPACITY"
},
"evaluation_method": "BATCH_PROCESS_AND_INTERACTIVELY",
"latest_effective_date": "2016-07-14 09:46:20.0",
"reward_award_validity": {
"validity_options": "ALWAYS_VALID"
},
"number": "48",
"name": "ET Utilise Free Capacity",
"id": "EDC5AF03BD394966B326EE63985928B0",
"category": null
},
"status": {
"code": "OK",
"description": "",
"message": ""
}
}
Example 5
HTTP Method: GET
Request:
{{server}}/crmapi/rest/v2/reward_offers/show?token={{token}}&reward_offer_identifier=number=187
Response:
{
"data": {
"award_conditions_set": {
"location_conditions_set": {
"location_set": [
{
"area": "Aglantzia",
"city": "Nicosia",
"district": "Nicosia"
}
]
},
"period_conditions": {
"time_period_uot": "YEARS",
"time_period_value": 7
},
"financial_statement_conditions": {
"key_performance_indicator_conditions_set": [
{
"key_performance_indicator": {
"alternative_code": "ETKPI",
"name": "ET KPI",
"id": "123456id"
},
"product": {
"code": "Serendipity",
"product_type": {
"service_type": "USAGE",
"used_for_provisioning": true,
"alternative_code": "V",
"composition_method": "FLAT",
"name": "Usage Services",
"description": "Used for VOD , PPV, TELEPHONE CALLS ETC",
"id": "751C638AA3534B768408AAC4D73CF516",
"classification": "SERVICES",
"physical_good_type": null
},
"alternative_code": "S_1",
"description": "VOD: Serendipity ",
"id": "BD3ACEE7D6244DCAA375D0744DA75540"
},
"from_value": 2,
"to_value": 5
},
{
"key_performance_indicator": {
"alternative_code": "kpi_a",
"name": "key performance indicator A",
"id": "164DC042D50F462BB6B28E86AE2B6C8C"
},
"product": null,
"from_value": 3,
"to_value": null
}
],
"number_of_awards": "ONLY_ONE_PER_PERIOD",
"number_of_awards_period": {
"time_period_uot": "DAYS",
"time_period_value": 1
},
"financial_statement_classifications_set": [
{
"alternative_code": "6136",
"name": "Financial Statement",
"id": "DF940370AA0D4497AA33F1A89A842C62"
}
]
},
"segment_conditions_set": [
{
"segment": {
"number": "48",
"alternative_code": "ER",
"name": "ET RP",
"description": null,
"id": "C404D4AA9DCD4F08BB70899F6D98F278"
},
"option": "EXCLUDE"
},
{
"segment": {
"number": "20",
"alternative_code": "RPMT1MA",
"name": "Rewards Participants more than 1 month activated",
"description": null,
"id": "BDEBA651620047E782F99E4ABF544CF4"
},
"option": "INCLUDE"
}
],
"organisational_unit_conditions_set": [
{
"unit": null,
"group": {
"alternative_code": "EMG",
"community_name": "ET Merchant Group",
"name": "ET Merchant Group",
"description": null,
"id": "275FFB56605049E8B599F8B00AD55E02"
}
},
{
"unit": {
"alternative_code": "u1",
"group_name": "Main Group",
"community_name": "Community",
"name": "Unit1",
"description": null,
"id": "C03AB710D94843229A32198FA4096448"
},
"group": null
}
]
},
"alternative_code": "FSTC",
"reward_offer_validity": {
"validity_options": "VALID_FROM_LATEST_EFFECTIVE_DATE"
},
"log_information": {
"created_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"updated_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"created_date": "2016-10-13T11:26:18",
"updated_date": "2016-10-13T12:18:38",
"updated_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": "dev@crm.com",
"username": "MPAdministrator"
},
"created_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": "dev@crm.com",
"username": "MPAdministrator"
}
},
"privacy_level": null,
"reward_scheme": {
"alternative_code": "ES_1",
"name": "ET S11",
"description": null,
"id": "F475BE22923944858AA188FE0205C3FD",
"life_cycle_state": "EFFECTIVE"
},
"owned_by_group": {
"alternative_code": "MG",
"community_name": "Community",
"name": "Main Group",
"description": "Main Group",
"id": "1"
},
"description": null,
"apply_if_best_award_is_provided": false,
"spend_method": null,
"life_cycle_state": "EFFECTIVE",
"spend_conditions_set": {
"time_conditions_set": {
"days_condition_set": [
[
{
"day_of_week": "MONDAY"
},
{
"day_of_week": "FRIDAY"
}
]
],
"hours_condition_set": [
{
"from": 0,
"to": 16
}
]
},
"product_conditions_set": [
{
"product_family": null,
"product": null,
"product_type": {
"service_type": "TERMED",
"used_for_provisioning": true,
"alternative_code": "AO",
"composition_method": "FLAT",
"name": "Add-ons",
"description": "Additional products",
"id": "E2324486B2454B56B054ED8129E3A9C0",
"classification": "SERVICES",
"physical_good_type": null
}
},
{
"product_family": null,
"product": {
"code": "Serendipity",
"product_type": {
"service_type": "USAGE",
"used_for_provisioning": true,
"alternative_code": "V",
"composition_method": "FLAT",
"name": "Usage Services",
"description": "Used for VOD , PPV, TELEPHONE CALLS ETC",
"id": "751C638AA3534B768408AAC4D73CF516",
"classification": "SERVICES",
"physical_good_type": null
},
"alternative_code": "S_1",
"description": "VOD: Serendipity ",
"id": "BD3ACEE7D6244DCAA375D0744DA75540"
},
"product_type": null
},
{
"product_family": {
"code": "PKF",
"name": "PK_Family",
"description": null,
"id": "3E91CC57B69240FBB367C1BD534BF190"
},
"product": null,
"product_type": null
}
],
"organisational_unit_conditions_set": [
{
"unit": null,
"group": {
"alternative_code": "EMG",
"community_name": "ET Merchant Group",
"name": "ET Merchant Group",
"description": null,
"id": "275FFB56605049E8B599F8B00AD55E02"
}
},
{
"unit": {
"alternative_code": "u1",
"group_name": "Main Group",
"community_name": "Community",
"name": "Unit1",
"description": null,
"id": "C03AB710D94843229A32198FA4096448"
},
"group": null
}
],
"allowed_spend_period_after_award": {
"time_period_uot": "DAYS",
"time_period_value": 2
}
},
"type": {
"alternative_code": "FS",
"name": "Financial Statement",
"description": null,
"id": "CC6AAD68E5EA4CC7BF91D70C1028BFE4",
"classification": "REWARD_FINANCIAL_STATEMENTS"
},
"evaluation_method": "BATCH_PROCESS",
"latest_effective_date": "2016-10-13T11:31:16",
"reward_award_validity": {
"validity_options": "VALID_FOR_SPECIFIC_PERIOD",
"award_validity_period_duration": {
"time_period_uot": "DAYS",
"time_period_value": 3
}
},
"number": "187",
"award_percentage_on_key_performance_indicator_values": [
{
"key_performance_indicator": {
"alternative_code": "kpi_a",
"name": "key performance indicator A",
"id": "164DC042D50F462BB6B28E86AE2B6C8C"
},
"percentage": "5.30"
}
],
"name": "Financial Statement Template Copy",
"id": "377E2A0DA4FE4D30BD12063B8993E403",
"award_scope": null,
"category": null
},
"status": {
"code": "OK",
"description": "",
"message": ""
}
}
Example 6
HTTP Method: GET
Request:
{{server}}/crmapi/rest/v2/reward_offers/show?token={{token}}&reward_offer_identifier=number=226
Response:
{
"data": {
"award_conditions_set": {
"sign_up_condition": false,
"segment_conditions_set": [
{
"segment": {
"number": "54",
"alternative_code": "ZS",
"name": "Zoe Segment",
"description": null,
"id": "9AAEF16C6CA34CC9896FC5D3FB0BC2F6"
},
"option": "INCLUDE"
}
],
"organisational_unit_conditions_set": []
},
"alternative_code": "LO4",
"reward_offer_validity": {
"validity_options": "VALID_DURING_BIRTHDAY_PERIOD",
"valid_x_days_before_birthday_date": 19,
"valid_x_days_after_birthday_date": 11
},
"log_information": {
"created_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"updated_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"created_date": "2016-11-02T10:09:49",
"updated_date": "2016-11-03T13:46:12",
"updated_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": "dev@crm.com",
"username": "MPAdministrator"
},
"created_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": "dev@crm.com",
"username": "MPAdministrator"
}
},
"privacy_level": null,
"reward_scheme": {
"alternative_code": "LSVT",
"name": "Loukia Scheme For Validity Tesing - DO NOT USE",
"description": null,
"id": "BE9FC69C38C74098974E8C682C0DA1C3",
"life_cycle_state": "EFFECTIVE"
},
"owned_by_group": {
"alternative_code": "MG",
"community_name": "Community",
"name": "Main Group",
"description": "Main Group",
"id": "1"
},
"description": null,
"apply_if_best_award_is_provided": false,
"spend_method": "SPEND_ON_REQUEST",
"life_cycle_state": "EFFECTIVE",
"spend_conditions_set": {
"time_conditions_set": {
"days_condition_set": [
[]
],
"hours_condition_set": []
},
"product_conditions_set": [],
"organisational_unit_conditions_set": [],
"allowed_spend_period_after_award": {
"time_period_uot": null,
"time_period_value": null
}
},
"type": {
"alternative_code": "RS",
"name": "Reward Signups",
"description": null,
"id": "21B8D71630BD4FE6B504E63B7167549E",
"classification": "REWARD_SIGN_UPS"
},
"evaluation_method": "BATCH_PROCESS",
"latest_effective_date": "2016-11-02T10:10:50",
"reward_award_validity": {
"validity_options": "ALWAYS_VALID"
},
"number": "226",
"award_amount": 10,
"name": "Loukia Offer 4 - DO NOT EDIT",
"id": "B64B6789B6924B63891978396AFD0CC3",
"award_scope": "APPLY_AWARD_PER_TRANSACTION_ITEM",
"category": null
},
"status": {
"code": "OK",
"description": "",
"message": ""
}
}
Example 7
HTTP Method: GET
Request:
{{server}}/crmapi/rest/v2/reward_offers/show?token={{token}}&reward_offer_identifier=number=229
Response:
{
"data": {
"award_conditions_set": {
"sign_up_condition": false,
"segment_conditions_set": [],
"organisational_unit_conditions_set": []
},
"alternative_code": "LO7",
"reward_offer_validity": {
"validity_options": "VALID_DURING_RECURRING_PERIOD",
"validity_recurring_periods_set": [
{
"valid_to": {
"month": 1,
"day": 10
},
"valid_from": {
"month": 1,
"day": 1
},
"id": "26D1D902ADAB428BAEEB50A36021D099"
},
{
"valid_to": {
"month": 12,
"day": 31
},
"valid_from": {
"month": 12,
"day": 10
},
"id": "0630844543644EA485D9D9D04590A806"
},
{
"valid_to": {
"month": 8,
"day": 31
},
"valid_from": {
"month": 6,
"day": 1
},
"id": "378594D5883F4A37A95BCF21A06E4B42"
}
]
},
"log_information": {
"created_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"updated_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"created_date": "2016-11-02T10:15:58",
"updated_date": "2016-11-03T13:50:10",
"updated_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": "dev@crm.com",
"username": "MPAdministrator"
},
"created_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": "dev@crm.com",
"username": "MPAdministrator"
}
},
"privacy_level": null,
"reward_scheme": {
"alternative_code": "LSVT",
"name": "Loukia Scheme For Validity Tesing - DO NOT USE",
"description": null,
"id": "BE9FC69C38C74098974E8C682C0DA1C3",
"life_cycle_state": "EFFECTIVE"
},
"owned_by_group": {
"alternative_code": "MG",
"community_name": "Community",
"name": "Main Group",
"description": "Main Group",
"id": "1"
},
"description": null,
"apply_if_best_award_is_provided": false,
"spend_method": "SPEND_ON_REQUEST",
"life_cycle_state": "EFFECTIVE",
"spend_conditions_set": {
"time_conditions_set": {
"days_condition_set": [
[]
],
"hours_condition_set": []
},
"product_conditions_set": [],
"organisational_unit_conditions_set": [],
"allowed_spend_period_after_award": {
"time_period_uot": null,
"time_period_value": null
}
},
"type": {
"alternative_code": "RS",
"name": "Reward Signups",
"description": null,
"id": "21B8D71630BD4FE6B504E63B7167549E",
"classification": "REWARD_SIGN_UPS"
},
"evaluation_method": "BATCH_PROCESS",
"latest_effective_date": "2016-11-02T10:19:00",
"reward_award_validity": {
"validity_options": "ALWAYS_VALID"
},
"number": "229",
"award_amount": 10,
"name": "Loukia Offer 7 - DO NOT EDIT",
"id": "FB72F9FFC07F479B97E8DB624408A428",
"award_scope": "APPLY_AWARD_PER_TRANSACTION_ITEM",
"category": null
},
"status": {
"code": "OK",
"description": "",
"message": ""
}
}
Example 8
HTTP Method: GET
Request:
{{server}}/crmapi/rest/v2/reward_offers/show?token={{token}}&reward_offer_identifier=number=258
Response:
{
"data": {
"award_conditions_set": {
"transaction_condition": {
"transaction_period_range_period": {
"time_period_uot": "MONTHS",
"time_period_value": 6
},
"transaction_amount_from": 500
},
"location_conditions_set": null,
"product_conditions_set": [
{
"product_family": null,
"all_products_should_exist": true,
"product": null,
"product_type": {
"service_type": null,
"used_for_provisioning": false,
"alternative_code": "001",
"composition_method": "FLAT",
"name": "Equipment",
"description": null,
"id": "EQ",
"classification": "PHYSICALGOODS",
"physical_good_type": "NONTRACEABLE"
}
},
{
"product_family": null,
"all_products_should_exist": true,
"product": {
"code": "Smartcard",
"product_type": {
"service_type": null,
"used_for_provisioning": true,
"alternative_code": "S",
"composition_method": "FLAT",
"name": "SMARTCARD",
"description": "SMARTCARD",
"id": "D6BE0209EC0149989A89972CE889DF8B",
"classification": "PHYSICALGOODS",
"physical_good_type": "TRACEABLE"
},
"alternative_code": "SC1",
"description": "asd",
"id": "4F656ED5DAC44168B0805227881202CD"
},
"product_type": null
}
],
"segment_conditions_set": [],
"organisational_unit_conditions_set": null,
"payment_medium_conditions_set": {}
},
"alternative_code": "O1-DNC_1",
"reward_offer_validity": {
"validity_options": "VALID_FROM_LATEST_EFFECTIVE_DATE"
},
"log_information": {
"created_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"updated_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"created_date": "2017-06-08T17:07:45",
"updated_date": "2017-06-08T18:14:23",
"updated_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": null,
"username": "MPAdministrator"
},
"created_by_user": {
"person_name": "MPAdministrator",
"id": "1",
"email": null,
"username": "MPAdministrator"
}
},
"privacy_level": {
"number": "14",
"name": "PL Group A_Share_Low",
"id": "9DCEFDA9D56145978C265085CD146810",
"hierarchy_level": 1
},
"reward_scheme": {
"alternative_code": "PKRS",
"name": "PK Reward Scheme",
"description": null,
"id": "84E4934B64F64008965F9929FDE0CFB1",
"life_cycle_state": "EFFECTIVE"
},
"owned_by_group": {
"alternative_code": "MG",
"community_name": "Community",
"name": "Main Group",
"description": "Main Group",
"id": "1"
},
"description": "SB1 - Reward Loyalty, Transaction Amount Based offers",
"apply_if_best_award_is_provided": false,
"spend_method": null,
"life_cycle_state": "NOT_EFFECTIVE",
"spend_conditions_set": {
"time_conditions_set": {
"days_condition_set": [
[]
],
"hours_condition_set": []
},
"product_conditions_set": [],
"organisational_unit_conditions_set": [],
"allowed_spend_period_after_award": {
"time_period_uot": null,
"time_period_value": null
}
},
"type": {
"alternative_code": "RLTAB",
"name": "Reward Loyalty, Transaction Amount Based",
"description": null,
"id": "CCCEDDF8C646480F9636E31A335898E5",
"classification": "REWARD_LOYALTY_TRANSACTION_AMOUNT_BASED"
},
"evaluation_method": "BATCH_PROCESS",
"latest_effective_date": "2017-06-08T17:10:01",
"reward_award_validity": {
"validity_options": "ALWAYS_VALID"
},
"number": "258",
"award_amount": 5,
"name": "Offer 1B - DO NOT CHANGE",
"id": "019CD7764AE341F9B84FA37A8FA4D900",
"award_scope": null,
"category": null,
"marketing_information": {
"short_description": null,
"times_awarded_status_text": null,
"average_weekly_awarded_amount_text": null,
"long_description": null,
"no_awards_status_text": null,
"offer_image": {
"file_alt_text": null,
"file_content_url": null
},
"offer_background": {
"color": null,
"file_alt_text": null,
"file_mime_type": null
}
}
},
"status": {
"code": "OK",
"description": "",
"message": ""
}
}
Example 9
HTTP Method: GET
Request:
{{server}}/crmapi/rest/v2/reward_offers/show?token={{token}}&reward_offer_identifier=number=317
Response:
{
"data": {
"award_conditions_set": {
"transaction_condition": {
"lottery_transaction_conditions_set": [
{
"customer_event_classification": {
"alternative_code": "PC",
"name": "Purchase Classification",
"id": "437DED6938054AD5BEC61BB6AF2B1F65"
},
"customer_event_type": "PURCHASE",
"payment_medium_type": {
"name": "Cash",
"description": null,
"id": "747029733FFC41B7A154CAC06F9A2061",
"altCode": "C_1"
},
"maximum_number_customer_events": 200,
"payment_medium_brand": {
"name": "American Express",
"description": "American Express",
"id": "967A73782E6D460A88755093F5D103D6",
"altCode": "AE"
},
"minimum_total_amount": 1,
"minimum_number_customer_events": 1,
"maximum_total_amount": 1000
}
]
},
"segment_conditions_set": [],
"organisational_unit_conditions_set": null,
"lottery_conditions_set": [
{
"maximum_number_awards": 100,
"reward_offer": {
"number": "315",
"reward_scheme": {
"alternative_code": "MRS",
"name": "Marketing Rewards Scheme",
"description": "Marketing Rewards Scheme",
"id": "EA4DE150575B4ED0A07317BA647854E0",
"life_cycle_state": "EFFECTIVE"
},
"name": "ET-Utilise",
"description": null,
"id": "7671D8ED9BA64422BD2DD69DFA59A0EB",
"life_cycle_state": "EFFECTIVE",
"marketing_information_short_description": null
},
"minimum_number_awards": 1
}
]
},
"alternative_code": "L_1",
"reward_offer_validity": {
"validity_periods_set": [
{
"valid_to": null,
"valid_from": "2018-05-01T00:00:00",
"id": "BFB3D74AA1B746F5BB4EBA0BD9414233"
}
],
"validity_options": "VALID_FOR_SPECIFIC_PERIOD"
},
"log_information": {
"created_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"updated_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"created_date": "2018-05-11T15:40:20",
"updated_date": "2018-05-11T18:03:30",
"updated_by_user": {
"person_name": "CRM COM",
"id": "1",
"email": "test@crm.com",
"username": "MPAdministrator"
},
"created_by_user": {
"person_name": "CRM COM",
"id": "1",
"email": "test@crm.com",
"username": "MPAdministrator"
}
},
"privacy_level": {
"number": "14",
"name": "PL Group A_Share_Low",
"id": "9DCEFDA9D56145978C265085CD146810",
"hierarchy_level": 1
},
"reward_scheme": {
"alternative_code": "L",
"name": "Lottery",
"description": null,
"id": "5ACEDDEF3B034208B47C7BF9FDBEBEA9",
"life_cycle_state": "EFFECTIVE"
},
"owned_by_group": {
"alternative_code": "MG",
"community_name": "Community",
"name": "Main Group",
"description": "Main Group",
"id": "1"
},
"description": null,
"apply_if_best_award_is_provided": false,
"spend_method": "SPEND_INSTANTLY",
"life_cycle_state": "EFFECTIVE",
"spend_conditions_set": {
"time_conditions_set": {
"days_condition_set": [
[]
],
"hours_condition_set": []
},
"product_conditions_set": [],
"organisational_unit_conditions_set": [],
"allowed_spend_period_after_award": {
"time_period_uot": null,
"time_period_value": null
}
},
"type": {
"alternative_code": "LT",
"name": "Lottery Type",
"description": null,
"id": "2C04D6A7BFED45DA9395984232E88346",
"classification": "LOTTERY"
},
"evaluation_method": "BATCH_PROCESS",
"latest_effective_date": "2018-05-11T15:47:01",
"reward_award_validity": {
"validity_options": "ALWAYS_VALID"
},
"number": "317",
"award_amount": 20,
"name": "Lottery Pania",
"id": "DA7261DB31384C449E7CCA42F643AFD1",
"award_scope": "APPLY_AWARD_PER_TRANSACTION",
"category": null,
"marketing_information": {
"short_description": null,
"times_awarded_status_text": null,
"average_weekly_awarded_amount_text": null,
"long_description": null,
"no_awards_status_text": null,
"offer_image": {
"file_name": null,
"file_alt_text": null,
"file_content_url": null,
"file_mime_type": null
},
"offer_background": {
"color": null,
"file_name": null,
"file_alt_text": null,
"file_content_url": null,
"file_mime_type": null
}
}
},
"status": {
"code": "OK",
"description": "",
"message": ""
}
}
- No labels