| Tip |
|---|
Available from CRM.COM R5.0.0 |
GET additive_discounts/applied_additive_discounts/show
This method returns information related with an applied additive discount. A single applied additive discount is returned by each call
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
(mandatory)
...
Applied Additive Discount identifier
The identifier of the applied additive discount that should be returned as a result. The allowed applied additive discount 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
...
Examples
| Expand |
|---|
|
HTTP Method: GET Request: Response: | Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
|
{
"status":
{
"message": null,
"description": null,
"code": "OK"
},
"data":
{
"udf_float_1": 10,
"udf_float_2": 20,
"udf_float_3": 30,
"number": "AD001",
"udf_float_4": 40,
"udf_string_1": "user field 1",
"udf_string_2": "user field 2",
"udf_string_3": "user field 3",
"udf_string_4": "user field 4",
"udf_string_5": "user field 5",
"udf_string_6": "user field 6",
"udf_string_7": "user field 7",
"udf_string_8": "user field 8",
"discount_amount": 60,
"id": "063D4E324333E4A6263EC0868BF04521",
"subscription": null,
"applied_additive_discount_definition":
{
"life_cycle_state": "EFFECTIVE",
"classification": "SUBSCRIPTIONS",
"type": "AUTO_APPLY",
"name": "Lucia test 3",
"id": "35346B2FB563CD998DF9DFF00949CD7C",
"alternative_code": "lt3"
},
"from_date": null,
"udf_date_1": "2015-02-19T13:32:46",
"udf_date_2": "2015-02-19T13:32:46",
"udf_date_3": "2015-02-19T13:32:46",
"udf_date_4": "2015-02-19T13:32:46",
"log_information":
{
"updated_date": "2015-02-19T13:32:46",
"created_by_unit":
{
"community_name": "Main Community",
"group_name": "Developers Group",
"name": "Developers Unit",
"id": "C4370788B2630BC8A99E8C7397406C09",
"description": null,
"alternative_code": null
},
"created_date": "2015-02-19T13:32:46",
"updated_by_unit":
{
"community_name": "Main Community",
"group_name": "Main Group",
"name": "Admin Unit",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"description": "r1",
"alternative_code": "MG"
},
"created_by_user":
{
"person_name": "Meri",
"username": "Meri",
"id": "573150C4CE1882B98D3D65DB9390D851",
"email": null
},
"updated_by_user":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1",
"email": null
}
},
"to_date": null,
"job":
{
"accounts_receivable":
{
"account_owner":
{
"last_name": "Ioannou24",
"life_cycle_state": "FINANCIAL",
"middle_name": null,
"company_profile": null,
"title": null,
"type": "PERSON",
"first_name": "Marios",
"name": "Marios Ioannou24",
"id": "45DF853DDDF180FA38D022BF5A4606EA",
"company_name": null,
"demographics":
{
"gender": null,
"passport_issued_by_country": null,
"passport_number": null,
"social_security_number": null,
"country_of_residence":
{
"name": "UNITED KINGDOM",
"id": "126"
},
"industry_sector": null,
"date_of_birth":
{
"month": null,
"day": null,
"year": null
},
"name_day":
{
"month": null,
"day": null
},
"id_number": null,
"id_issued_by_country": null,
"industry": null
}
},
"life_cycle_state": "ACTIVE",
"number": "197",
"name": "mar24",
"id": "7002997067CF50C8605542A4968EE5C0"
},
"life_cycle_state": "COMPLETED",
"number": "13",
"id": "37B285CE1C9874D60B7F26B9E06EF95C",
"description": "test desc1"
}
}
} |
|
GET additive_discounts/applied_additive_discounts/list
This method returns information related with applied additive discounts. Multiple applied additive discounts are returned by each call
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
(semi-optional)
...
Additive Discount Definition identifier
The identifier of the additive discount definition related with the applied additive that should be returned as a result. The allowed additive discount definition identifier fields are the following:
...
(semi-optional)
...
Accounts Receivable identifier
The identifier of the accounts receivable related with the applied additive discount that should be returned as a result. The allowed accounts receivable identifier fields are the following:
...
(semi-optional)
...
Subscription identifier
The identifier of the subscription related with the applied additive discount that should be returned as a result. The allowed subscription identifier fields are the following:
...
job_identifier
(semi-optional)
...
The identifier of the job related with the applied additive discount that should be returned as a result. The allowed job identifier fields are the following:
...
additive_discount_definition_classification
(semi-optional)
...
additive_discount_definition_type
(semi-optional)
...
from_date
(optional)
...
to_date
(optional)
...
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. More than one semi-optional parameter can be specified.
Response Data
...
Examples
| Expand |
|---|
|
HTTP Method: GET Request: Response: | Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
|
{
"status":
{
"message": null,
"description": null,
"code": "OK"
},
"data":
[
{
"number": "AD001",
"id": "063D4E324333E4A6263EC0868BF04521",
"job":
{
"accounts_receivable":
{
"account_owner":
{
"last_name": "Ioannou24",
"life_cycle_state": "FINANCIAL",
"middle_name": null,
"company_profile": null,
"title": null,
"type": "PERSON",
"first_name": "Marios",
"name": "Marios Ioannou24",
"id": "45DF853DDDF180FA38D022BF5A4606EA",
"company_name": null,
"demographics":
{
"gender": null,
"passport_issued_by_country": null,
"passport_number": null,
"social_security_number": null,
"country_of_residence":
{
"name": "UNITED KINGDOM",
"id": "126"
},
"industry_sector": null,
"date_of_birth":
{
"month": null,
"day": null,
"year": null
},
"name_day":
{
"month": null,
"day": null
},
"id_number": null,
"id_issued_by_country": null,
"industry": null
}
},
"life_cycle_state": "ACTIVE",
"number": "197",
"name": "mar24",
"id": "7002997067CF50C8605542A4968EE5C0"
},
"life_cycle_state": "COMPLETED",
"number": "13",
"id": "37B285CE1C9874D60B7F26B9E06EF95C",
"description": "test desc1"
}
}
]
} |
|
GET additive_discounts/ad_hoc_discounts/show
This method returns information related with an ad hoc discount. A single ad hoc discount is returned by each call
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
(mandatory)
...
Ad hoc discount identifier
The identifier of the ad hoc discount that should be returned as a result. The allowed ad hoc discount 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
...
Examples
| Expand |
|---|
|
HTTP Method: GET Request: Response: | Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
|
{
"status":
{
"message": null,
"description": null,
"code": "OK"
},
"data":
{
"cancelled_by": null,
"effective_date": "2014-07-11T12:20:47",
"udf_float_1": null,
"products_set":
[
{
"id": "81C527EC9134BE1272BD1E1534DBAEB6",
"product":
{
"product_type":
{
"physical_good_type": "TRACEABLE",
"service_type": null,
"used_for_provisioning": true,
"composition_method": "FLAT",
"classification": "PHYSICALGOODS",
"name": "Decoders",
"id": "B4A1396AE3D1384B304A0FEB22F7BA50",
"description": "Decoders",
"alternative_code": "D"
},
"id": "A2B00E27070BEB1B1273733260A45ACC",
"description": "Athina STB",
"code": "Athina STB",
"alternative_code": "A-STB"
}
},
{
"id": "20F5F79CE3061B00615EF69273493201",
"product":
{
"product_type":
{
"physical_good_type": null,
"service_type": "TERMED",
"used_for_provisioning": false,
"composition_method": "FIXEDBUNDLE",
"classification": "SERVICES",
"name": "Fixed Bundle",
"id": "AF80230C21FDBD38C3D24777BE9CA333",
"description": null,
"alternative_code": "Fixed Bundle"
},
"id": "468733DA92F19F0F9208F9B91A93E243",
"description": null,
"code": "Viasat ",
"alternative_code": "Viasat"
}
}
],
"udf_float_2": null,
"udf_float_3": null,
"number": "AH001",
"udf_float_4": null,
"udf_string_1": null,
"udf_string_2": null,
"cancelled_on": null,
"udf_string_3": null,
"udf_string_4": null,
"udf_string_5": null,
"udf_string_6": null,
"udf_string_7": null,
"udf_string_8": null,
"discount_amount": null,
"discount_percentage": 12,
"id": "789FBA44C27D1DA69AB3652E0F5575E7",
"approval_method": "MANUAL",
"subscription":
{
"accounts_receivable":
{
"account_owner":
{
"last_name": "Pickman",
"life_cycle_state": "FINANCIAL",
"middle_name": "Lie",
"company_profile": null,
"title": "Mrs",
"type": "PERSON",
"first_name": "Jessie",
"name": "Jessie Pickman",
"id": "2F3CDD2FDA4BD2832DED9FD71A6FAFBF",
"company_name": null,
"demographics":
{
"gender": "FEMALE",
"passport_issued_by_country":
{
"name": "UNITED STATES",
"id": "127"
},
"passport_number": "2234567",
"social_security_number": "765656",
"country_of_residence":
{
"name": "UNITED STATES",
"id": "127"
},
"industry_sector":
{
"name": "GOVERNMENTAL",
"id": "A9BDEBD4D8FAEDB0BACE40C041156D12",
"alternative_code": "GOV"
},
"date_of_birth":
{
"month": 5,
"day": 3,
"year": 1980
},
"name_day":
{
"month": 7,
"day": 11
},
"id_number": "11232345",
"id_issued_by_country":
{
"name": "UNITED STATES",
"id": "127"
},
"industry":
{
"name": "Industry1",
"id": "31BC2070C79EAE5455BFAD41599C5190",
"code": "In"
}
}
},
"life_cycle_state": "ACTIVE",
"number": "101",
"name": "PickmanAcc",
"id": "16DC87AEB2F308C82ED30D379787F0B6"
},
"life_cycle_state": "DRAFT",
"number": "S60136",
"type":
{
"name": "London",
"id": "3100B0D56E7C7EADF073C34BCE1E42AF",
"description": "For Subscribers residing in London
",
"alternative_code": "LND"
},
"id": "5F2B1F786E804DBC7B16C5F14B679E07"
},
"additive_discount_definition":
{
"life_cycle_state": "EFFECTIVE",
"classification": "SUBSCRIPTIONS",
"type": "AUTO_APPLY",
"name": "Lucia test 3",
"id": "35346B2FB563CD998DF9DFF00949CD7C",
"alternative_code": "lt3"
},
"approved_by":
{
"person_name": "Meri",
"username": "Meri",
"id": "573150C4CE1882B98D3D65DB9390D851",
"email": null
},
"applied_on": null,
"approved_on": "2014-07-11T12:20:47",
"udf_date_1": null,
"udf_date_2": null,
"udf_date_3": null,
"udf_date_4": null,
"log_information":
{
"updated_date": "2015-02-20T11:20:51",
"created_by_unit":
{
"community_name": "Main Community",
"group_name": "Developers Group",
"name": "Developers Unit",
"id": "C4370788B2630BC8A99E8C7397406C09",
"description": null,
"alternative_code": null
},
"created_date": "2014-07-11T12:20:47",
"updated_by_unit":
{
"community_name": "Main Community",
"group_name": "Main Group",
"name": "Admin Unit",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"description": "r1",
"alternative_code": "MG"
},
"created_by_user":
{
"person_name": "Meri",
"username": "Meri",
"id": "573150C4CE1882B98D3D65DB9390D851",
"email": null
},
"updated_by_user":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1",
"email": null
}
},
"provided_by":
{
"person_name": "Meri",
"username": "Meri",
"id": "573150C4CE1882B98D3D65DB9390D851",
"email": null
},
"life_cycle_state": "APPROVED",
"provided_on": "2014-07-11T12:20:47",
"applied": true,
"job": null,
"expiration_date": "2015-02-20T11:20:51"
}
}
|
|
GET additive_discounts/ad_hoc_discounts/list
This method returns information related with ad hoc discounts. Multiple ad hoc discounts are returned by each call
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
(semi-optional)
...
Additive Discount Definition identifier
The identifier of the additive discount definition related with the ad hoc discounts that should be returned as a result. Only additive discount definitions of type Ad Hoc can be specified.The allowed additive discount definition identifier fields are the following:
...
(semi-optional)
...
Subscription identifier
The identifier of the subscription related with the ad hoc discounts that should be returned as a result. The allowed subscription identifier fields are the following:
...
job_identifier
(semi-optional)
...
The identifier of the job related with the ad hoc discounts that should be returned as a result. The allowed job identifier fields are the following:
...
provided_by_identifier
(semi-optional)
...
The identifier of the user that provided the ad hoc discounts that should be returned as a result. The allowed user identifier fields are the following:
...
approved_by_identifier
(semi-optional)
...
The identifier of the user that approved the ad hoc discounts that should be returned as a result. The allowed user identifier fields are the following:
...
cancelled_by_identifier
(semi-optional)
...
The identifier of the user that cancelled the ad hoc discounts that should be returned as a result. The allowed user identifier fields are the following:
...
life_cycle_state
(semi-optional)
...
applied
(optional)
...
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. More than one semi-optional parameters can be specified at the same time
Response Data
...
Examples
| Expand |
|---|
|
HTTP Method: GET Request: Response: | Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
|
{
"status":
{
"message": null,
"description": null,
"code": "OK"
},
"data":
[
{
"products_set":
[
{
"id": "20F5F79CE3061B00615EF69273493201",
"product":
{
"product_type":
{
"physical_good_type": null,
"service_type": "TERMED",
"used_for_provisioning": false,
"composition_method": "FIXEDBUNDLE",
"classification": "SERVICES",
"name": "Fixed Bundle",
"id": "AF80230C21FDBD38C3D24777BE9CA333",
"description": null,
"alternative_code": "Fixed Bundle"
},
"id": "468733DA92F19F0F9208F9B91A93E243",
"description": null,
"code": "Viasat ",
"alternative_code": "Viasat"
}
},
{
"id": "81C527EC9134BE1272BD1E1534DBAEB6",
"product":
{
"product_type":
{
"physical_good_type": "TRACEABLE",
"service_type": null,
"used_for_provisioning": true,
"composition_method": "FLAT",
"classification": "PHYSICALGOODS",
"name": "Decoders",
"id": "B4A1396AE3D1384B304A0FEB22F7BA50",
"description": "Decoders",
"alternative_code": "D"
},
"id": "A2B00E27070BEB1B1273733260A45ACC",
"description": "Athina STB",
"code": "Athina STB",
"alternative_code": "A-STB"
}
}
],
"number": "AH001",
"id": "789FBA44C27D1DA69AB3652E0F5575E7"
}
]
} |
|
POST additive_discounts/ad_hoc_discounts/create
This method creates an ad hoc discount that can be applied on a specific subscription or job. A single ad hoc discount can be created by each call.
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
additive_discount_definition_identifier
(mandatory)
...
Additive Discount Definition identifier
The identifier of the additive discount definition that will be applied. Only additive discount definitions of type Ad Hoc can be specified, considering that they can be applied on the specified subscription or job, and by the specified user.The allowed additive discount definition identifier fields are the following:
...
subscription_identifier
(mandatory on conditions)
...
Subscription identifier
The identifier of the subscription on which the ad hoc discount will be applied on. This information is mandatory unless a job is specified. In that case it is not allowed to specified a subscription as well. The allowed subscription identifier fields are the following:
...
job_identifier
(mandatory on conditions)
...
The identifier of the job on which the ad hoc discount will be applied on. This information is mandatory unless a subscription is specified. In that case it is not allowed to specified a job as well. The allowed job identifier fields are the following:
...
discount_amount
(mandatory and applicable on conditions)
...
The discount amount that will be applied.
This information is applicable and mandatory if the additive discount definition is set up to provide a range of discount based on amount
...
discount_percentage
(mandatory and applicable on conditions)
...
The discount percentage that will be applied.
This information is applicable and mandatory if the additive discount definition is set up to provide a range of discount based on percentage
...
effective_date
(optional)
...
expiration_date
(optional)
...
provided_by_identifier
(optional)
...
provided_on
(optional)
...
udf_string_1
(optional)
...
User Defined Field of type String
...
udf_string_2
(optional)
...
User Defined Field of type String
...
udf_string_3
(optional)
...
User Defined Field of type String
...
udf_string_4
(optional)
...
User Defined Field of type String
...
udf_string_5
(optional)
...
User Defined Field of type String
...
udf_string_6
(optional)
...
User Defined Field of type String
...
udf_string_7
(optional)
...
User Defined Field of type String
...
udf_string_8
(optional)
...
User Defined Field of type String
...
udf_float_1
(optional)
...
Float
...
User Defined Field of type Float
...
udf_float_2
(optional)
...
Float
...
User Defined Field of type Float
...
udf_float_3
(optional)
...
Float
...
User Defined Field of type Float
...
udf_float_4
(optional)
...
Float
...
User Defined Field of type Float
...
udf_date_1
(optional)
...
Date
...
User Defined Field of type Date
...
udf_date_2
(optional)
...
Date
...
User Defined Field of type Date
...
udf_date_3
(optional)
...
Date
...
User Defined Field of type Date
...
udf_date_4
(optional)
...
Date
...
User Defined Field of type Date
...
discount_free_period
(mandatory and applicable on conditions)
...
The free period that will be provided, measured in days, weeks, months or years.
This information is applicable and mandatory if the additive discount definition is set up to provide a range of discount based on free period.
...
products_set
(optional)
...
Restrictions
- It is mandatory to specify one of the semi-optional parameters.
Response Data
...
Examples
| Expand |
|---|
|
HTTP Method: POST Request: Body: | Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
| {
"token":"43584180E9AB4A2C930F2E5EA53A2E0B",
"additive_discount_definition_identifier":{"name":"Lucia Test 4"},
"subscription_identifier":{"number":"S60310"},
"discount_free_period":
{
"time_period_value":8,
"time_period_uot":"DAYS"
},
"effective_date":"2015-09-03T12:49:59",
"udf_string_1":"udf string 1",
"udf_string_2":"udf string 2",
"udf_string_3":"udf string 3",
"udf_string_4":"udf string 4",
"udf_string_5":"udf string 5",
"udf_string_6":"udf string 6",
"udf_string_7":"udf string 7",
"udf_string_8":"udf string 8",
"udf_float_1":10,
"udf_float_2":20,
"udf_float_3":30,
"udf_float_4":40,
"udf_float_5":50,
"udf_float_6":60,
"udf_float_7":70,
"udf_float_8":80,
"udf_date_1":"2014-05-05T15:49:59",
"udf_date_2":"2014-06-05T15:49:59",
"udf_date_3":"2014-07-05T15:49:59",
"udf_date_4":"2014-08-05T15:49:59",
"products_set":[
{
"action":"add",
"product_identifier":{"code":"P1"}
},
{
"action":"add",
"product_identifier":{"code":"P2"}
}
]
} |
Response: | Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
| {
"status":
{
"message": null,
"description": null,
"code": "OK"
},
"data":
{
"cancelled_by": null,
"effective_date": "2015-09-03T12:49:59",
"udf_float_1": 10,
"products_set":
[
{
"id": "9B4EB64979BF4C10AAC882112BE3CA09",
"product":
{
"product_type":
{
"physical_good_type": null,
"service_type": "TERMED",
"used_for_provisioning": true,
"composition_method": "FLAT",
"classification": "SERVICES",
"name": "Subscription Packages",
"id": "BC954969D3172372D498D3BB2BA590A0",
"description": "Subscription main packages",
"alternative_code": "SP"
},
"id": "5C2DCFDD743632AC57AE8147B6EE665E",
"description": null,
"code": "P1",
"alternative_code": "P1"
}
},
{
"id": "603B866C8D96416DB998197973AF5751",
"product":
{
"product_type":
{
"physical_good_type": null,
"service_type": "TERMED",
"used_for_provisioning": true,
"composition_method": "FLAT",
"classification": "SERVICES",
"name": "Subscription Packages",
"id": "BC954969D3172372D498D3BB2BA590A0",
"description": "Subscription main packages",
"alternative_code": "SP"
},
"id": "B1E02AFD27BD8D28762873E9EF4880DE",
"description": null,
"code": "P2",
"alternative_code": "P2"
}
}
],
"udf_float_2": 20,
"udf_float_3": 30,
"number": "25",
"udf_float_4": 40,
"udf_string_1": "udf string 1",
"udf_string_2": "udf string 2",
"cancelled_on": null,
"udf_string_3": "udf string 3",
"udf_string_4": "udf string 4",
"udf_string_5": "udf string 5",
"udf_string_6": "udf string 6",
"udf_string_7": "udf string 7",
"udf_string_8": "udf string 8",
"discount_amount": null,
"discount_percentage": null,
"id": "A1B073FED79642F2956E0F3F5C50EB7A",
"approval_method": "MANUAL",
"subscription":
{
"accounts_receivable":
{
"account_owner":
{
"last_name": "Ioannou78",
"life_cycle_state": "FINANCIAL",
"middle_name": null,
"company_profile": null,
"title": null,
"type": "PERSON",
"first_name": "Marios",
"name": "Marios Ioannou78",
"id": "2CAAE984123646F2999935E6BB0D1A90",
"company_name": null,
"demographics":
{
"gender": null,
"passport_issued_by_country": null,
"passport_number": null,
"social_security_number": null,
"country_of_residence":
{
"name": "UNITED KINGDOM",
"id": "126"
},
"industry_sector": null,
"date_of_birth":
{
"month": null,
"day": null,
"year": null
},
"name_day":
{
"month": null,
"day": null
},
"id_number": null,
"id_issued_by_country": null,
"industry": null
}
},
"life_cycle_state": "ACTIVE",
"number": "558",
"name": "mar78",
"id": "C14A88EF0C434BA886755D8B4DCEE2F2"
},
"life_cycle_state": "EFFECTIVE",
"number": "S60310",
"type":
{
"name": "Normal Subscription",
"id": "6BB2B984CC9309775D06650C7493A836",
"description": null,
"alternative_code": "ST"
},
"id": "35656546C7504EEA821A592E69E3C86F"
},
"additive_discount_definition":
{
"life_cycle_state": "EFFECTIVE",
"classification": "SUBSCRIPTIONS",
"type": "AD_HOC",
"name": "Lucia Test 4 ",
"id": "CBAE3930253AB31856D28BF34023E44E",
"alternative_code": "lt4"
},
"approved_by": null,
"applied_on": null,
"approved_on": null,
"udf_date_1": "2014-05-05T15:49:59",
"udf_date_2": "2014-06-05T15:49:59",
"udf_date_3": "2014-07-05T15:49:59",
"udf_date_4": "2014-08-05T15:49:59",
"log_information":
{
"updated_date": "2015-03-09T14:26:48",
"created_by_unit":
{
"community_name": "Main Community",
"group_name": "Main Group",
"name": "Admin Unit",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"description": "r1",
"alternative_code": "MG"
},
"created_date": "2015-03-09T14:26:26",
"updated_by_unit":
{
"community_name": "Main Community",
"group_name": "Main Group",
"name": "Admin Unit",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"description": "r1",
"alternative_code": "MG"
},
"created_by_user":
{
"person_name": "Marios Lannister",
"username": "mpadministrator",
"id": "1"
},
"updated_by_user":
{
"person_name": "Marios Lannister",
"username": "mpadministrator",
"id": "1"
}
},
"provided_by":
{
"person_name": "Marios Lannister",
"username": "mpadministrator",
"id": "1"
},
"life_cycle_state": "PENDING_APPROVAL",
"discount_free_period":
{
"time_period_value": 8,
"time_period_uot": "DAYS"
},
"provided_on": "2015-03-09T14:26:34",
"applied": false,
"job": null,
"expiration_date": null
}
} |
|
POST additive_discounts/ad_hoc_discounts/update
This method updated an ad hoc discount, which is in a pending approval life cycle state. A single ad hoc discount can be updated by each call. Fields which are not specified are not updated at all. Fields which are specified as null will be set as null.
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
ad_hoc_discount_identifier
(mandatory)
...
Ad hoc discount identifier
The identifier of the ad hoc discount that will be updated. Only ad hoc discounts in a pending life cycle state can be specified.The allowed ad hoc discount identifier fields are the following:
...
discount_amount
(optional and applicable on conditions)
...
The discount amount that will be applied.
This information is applicable and mandatory if the additive discount definition is set up to provide a range of discount based on amount
...
discount_percentage
(optional and applicable on conditions)
...
The discount percentage that will be applied.
This information is applicable and mandatory if the additive discount definition is set up to provide a range of discount based on percentage
...
effective_date
(optional)
...
expiration_date
(optional)
...
provided_by_identifier
(optional)
...
provided_on
(optional)
...
udf_string_1
(optional)
...
User Defined Field of type String
...
udf_string_2
(optional)
...
User Defined Field of type String
...
udf_string_3
(optional)
...
User Defined Field of type String
...
udf_string_4
(optional)
...
User Defined Field of type String
...
udf_string_5
(optional)
...
User Defined Field of type String
...
udf_string_6
(optional)
...
User Defined Field of type String
...
udf_string_7
(optional)
...
User Defined Field of type String
...
udf_string_8
(optional)
...
User Defined Field of type String
...
udf_float_1
(optional)
...
Float
...
User Defined Field of type Float
...
udf_float_2
(optional)
...
Float
...
User Defined Field of type Float
...
udf_float_3
(optional)
...
Float
...
User Defined Field of type Float
...
udf_float_4
(optional)
...
Float
...
User Defined Field of type Float
...
udf_date_1
(optional)
...
Date
...
User Defined Field of type Date
...
udf_date_2
(optional)
...
Date
...
User Defined Field of type Date
...
udf_date_3
(optional)
...
Date
...
User Defined Field of type Date
...
udf_date_4
(optional)
...
Date
...
User Defined Field of type Date
...
discount_free_period
(optional and applicable on conditions)
...
The free period that will be provided, measured in days, weeks, months or years.
This information is applicable and mandatory if the additive discount definition is set up to provide a range of discount based on free period.
...
products_set
(optional)
...
The products that the discount will be applied on, considering that they are allowed by the specified subscription or job and the specified additive discount definition. If not specified then the discount will be applicable on any products that will be billed
...
Restrictions
- It is mandatory to specify one of the semi-optional parameters.
Response Data
...
Examples
| Expand |
|---|
|
HTTP Method: POST Request: Body: | Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
| {
"token":"0EAFCF4BAF264A24BBA2A7FAC17CD6F8",
"ad_hoc_discount_identifier":{"number":"24"},
"udf_string_1":"udf string 1",
"udf_string_2":"udf string 2",
"udf_string_3":"udf string 3",
"udf_string_4":"udf string 4",
"udf_string_5":"udf string 5",
"udf_string_6":"udf string 6",
"udf_string_7":"udf string 7",
"udf_string_8":"udf string 8",
"udf_float_1":10,
"udf_float_2":20,
"udf_float_3":30,
"udf_float_4":40,
"udf_float_5":50,
"udf_float_6":60,
"udf_float_7":70,
"udf_float_8":80,
"udf_date_1":"2014-05-05T15:49:59",
"udf_date_2":"2014-06-05T15:49:59",
"udf_date_3":"2014-07-05T15:49:59",
"udf_date_4":"2014-08-05T15:49:59",
"products_set":[
{
"action":"remove",
"ad_hoc_discount_product_identifier":{"product_identifier":{"code":"P2"}}
},
{
"action":"add",
"product_identifier":{"code":"P1"}
}
]
} |
Response: | Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
| {
"status":
{
"message": null,
"description": null,
"code": "OK"
},
"data":
{
"cancelled_by": null,
"effective_date": "2015-03-09T12:30:05",
"udf_float_1": 10,
"products_set":
[
{
"id": "FB7A4973B35C4B0E82E9CF7D400D7086",
"product":
{
"product_type":
{
"physical_good_type": null,
"service_type": "TERMED",
"used_for_provisioning": true,
"composition_method": "FLAT",
"classification": "SERVICES",
"name": "Subscription Packages",
"id": "BC954969D3172372D498D3BB2BA590A0",
"description": "Subscription main packages",
"alternative_code": "SP"
},
"id": "5C2DCFDD743632AC57AE8147B6EE665E",
"description": null,
"code": "P1",
"alternative_code": "P1"
}
}
],
"udf_float_2": 20,
"udf_float_3": 30,
"number": "24",
"udf_float_4": 40,
"udf_string_1": "udf string 1",
"udf_string_2": "udf string 2",
"cancelled_on": null,
"udf_string_3": "udf string 3",
"udf_string_4": "udf string 4",
"udf_string_5": "udf string 5",
"udf_string_6": "udf string 6",
"udf_string_7": "udf string 7",
"udf_string_8": "udf string 8",
"discount_amount": null,
"discount_percentage": null,
"id": "ACC659665C1B4FE6B3DA01C597798D3B",
"approval_method": "MANUAL",
"subscription":
{
"accounts_receivable":
{
"account_owner":
{
"last_name": "Ioannou78",
"life_cycle_state": "FINANCIAL",
"middle_name": null,
"company_profile": null,
"title": null,
"type": "PERSON",
"first_name": "Marios",
"name": "Marios Ioannou78",
"id": "2CAAE984123646F2999935E6BB0D1A90",
"company_name": null,
"demographics":
{
"gender": null,
"passport_issued_by_country": null,
"passport_number": null,
"social_security_number": null,
"country_of_residence":
{
"name": "UNITED KINGDOM",
"id": "126"
},
"industry_sector": null,
"date_of_birth":
{
"month": null,
"day": null,
"year": null
},
"name_day":
{
"month": null,
"day": null
},
"id_number": null,
"id_issued_by_country": null,
"industry": null
}
},
"life_cycle_state": "ACTIVE",
"number": "558",
"name": "mar78",
"id": "C14A88EF0C434BA886755D8B4DCEE2F2"
},
"life_cycle_state": "EFFECTIVE",
"number": "S60310",
"type":
{
"name": "Normal Subscription",
"id": "6BB2B984CC9309775D06650C7493A836",
"description": null,
"alternative_code": "ST"
},
"id": "35656546C7504EEA821A592E69E3C86F"
},
"additive_discount_definition":
{
"life_cycle_state": "EFFECTIVE",
"classification": "SUBSCRIPTIONS",
"type": "AD_HOC",
"name": "Lucia Test 4 ",
"id": "CBAE3930253AB31856D28BF34023E44E",
"alternative_code": "lt4"
},
"approved_by": null,
"applied_on": null,
"approved_on": null,
"udf_date_1": "2014-05-05T15:49:59",
"udf_date_2": "2014-06-05T15:49:59",
"udf_date_3": "2014-07-05T15:49:59",
"udf_date_4": "2014-08-05T15:49:59",
"log_information":
{
"updated_date": "2015-03-09T13:01:49",
"created_by_unit":
{
"community_name": "Main Community",
"group_name": "Main Group",
"name": "Admin Unit",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"description": "r1",
"alternative_code": "MG"
},
"created_date": "2015-03-09T12:29:57",
"updated_by_unit":
{
"community_name": "Main Community",
"group_name": "Main Group",
"name": "Admin Unit",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"description": "r1",
"alternative_code": "MG"
},
"created_by_user":
{
"person_name": "mpadministrator",
"username": "mpadministrator",
"id": "1"
},
"updated_by_user":
{
"person_name": "Marios Lannister",
"username": "mpadministrator",
"id": "1"
}
},
"provided_by":
{
"person_name": "mpadministrator",
"username": "mpadministrator",
"id": "1"
},
"life_cycle_state": "PENDING_APPROVAL",
"discount_free_period":
{
"time_period_value": 8,
"time_period_uot": "DAYS"
},
"provided_on": "2015-03-09T12:30:07",
"applied": false,
"job": null,
"expiration_date": null
}
} |
|
POST additive_discounts/ad_hoc_discounts/approve
This method approves an ad hoc discount, which is in a pending approval life cycle state. A single ad hoc discount can be approved by each call.
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
ad_hoc_discount_identifier
(mandatory)
...
Ad Hoc Discount identifier
The identifier of the ad hoc discount that will be approved. Only ad hoc discounts in a pending approval life cycle state can be specified. The allowed ad hoc discount identifier fields are the following:
...
approved_by_identifier
(optional)
...
approved_on
(optional)
...
Restrictions
- It is mandatory to specify one of the semi-optional parameters.
Response Data
...
Examples
| Expand |
|---|
|
HTTP Method: POST Request: Body: | Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
| {
"token":"8EF60E0F870C4D06A67359D705885CBE",
"ad_hoc_discount_identifier":{"number":"20"},
"approved_by_identifier":{ "username" : "mpadministrator" },
"approved_on" : "2015-03-09T10:58:39"
} |
Response: | Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
| {
"status":
{
"message": null,
"description": null,
"code": "OK"
},
"data":
{
"cancelled_by": null,
"effective_date": "2015-03-09T10:50:18",
"udf_float_1": null,
"products_set":
[
{
"id": "522C84F80F23463892AC0214FEF60B91",
"product":
{
"product_type":
{
"physical_good_type": null,
"service_type": "TERMED",
"used_for_provisioning": true,
"composition_method": "FLAT",
"classification": "SERVICES",
"name": "Subscription Packages",
"id": "BC954969D3172372D498D3BB2BA590A0",
"description": "Subscription main packages",
"alternative_code": "SP"
},
"id": "5C2DCFDD743632AC57AE8147B6EE665E",
"description": null,
"code": "P1",
"alternative_code": "P1"
}
},
{
"id": "7FD301CDE8FA49D7B34F9DBFF74370EE",
"product":
{
"product_type":
{
"physical_good_type": null,
"service_type": "TERMED",
"used_for_provisioning": true,
"composition_method": "FLAT",
"classification": "SERVICES",
"name": "Subscription Packages",
"id": "BC954969D3172372D498D3BB2BA590A0",
"description": "Subscription main packages",
"alternative_code": "SP"
},
"id": "B1E02AFD27BD8D28762873E9EF4880DE",
"description": null,
"code": "P2",
"alternative_code": "P2"
}
}
],
"udf_float_2": null,
"udf_float_3": null,
"number": "20",
"udf_float_4": null,
"udf_string_1": null,
"udf_string_2": null,
"cancelled_on": null,
"udf_string_3": null,
"udf_string_4": null,
"udf_string_5": null,
"udf_string_6": null,
"udf_string_7": null,
"udf_string_8": null,
"discount_amount": null,
"discount_percentage": null,
"id": "F8BD6501D24141578ED17549D8890DBD",
"approval_method": "MANUAL",
"subscription":
{
"accounts_receivable":
{
"account_owner":
{
"last_name": "Ioannou78",
"life_cycle_state": "FINANCIAL",
"middle_name": null,
"company_profile": null,
"title": null,
"type": "PERSON",
"first_name": "Marios",
"name": "Marios Ioannou78",
"id": "2CAAE984123646F2999935E6BB0D1A90",
"company_name": null,
"demographics":
{
"gender": null,
"passport_issued_by_country": null,
"passport_number": null,
"social_security_number": null,
"country_of_residence":
{
"name": "UNITED KINGDOM",
"id": "126"
},
"industry_sector": null,
"date_of_birth":
{
"month": null,
"day": null,
"year": null
},
"name_day":
{
"month": null,
"day": null
},
"id_number": null,
"id_issued_by_country": null,
"industry": null
}
},
"life_cycle_state": "ACTIVE",
"number": "558",
"name": "mar78",
"id": "C14A88EF0C434BA886755D8B4DCEE2F2"
},
"life_cycle_state": "EFFECTIVE",
"number": "S60310",
"type":
{
"name": "Normal Subscription",
"id": "6BB2B984CC9309775D06650C7493A836",
"description": null,
"alternative_code": "ST"
},
"id": "35656546C7504EEA821A592E69E3C86F"
},
"additive_discount_definition":
{
"life_cycle_state": "EFFECTIVE",
"classification": "SUBSCRIPTIONS",
"type": "AD_HOC",
"name": "Lucia Test 4 ",
"id": "CBAE3930253AB31856D28BF34023E44E",
"alternative_code": "lt4"
},
"approved_by":
{
"person_name": "Marios Lannister",
"username": "mpadministrator",
"id": "1",
"email": "mp@ministrator.com"
},
"applied_on": null,
"approved_on": "2015-03-09T10:58:39",
"udf_date_1": null,
"udf_date_2": null,
"udf_date_3": null,
"udf_date_4": null,
"log_information":
{
"updated_date": "2015-03-09T11:17:12",
"created_by_unit":
{
"community_name": "Main Community",
"group_name": "Main Group",
"name": "Admin Unit",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"description": "r1",
"alternative_code": "MG"
},
"created_date": "2015-03-09T10:50:05",
"updated_by_unit":
{
"community_name": "Main Community",
"group_name": "Main Group",
"name": "Admin Unit",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"description": "r1",
"alternative_code": "MG"
},
"created_by_user":
{
"person_name": "mpadministrator",
"username": "mpadministrator",
"id": "1"
},
"updated_by_user":
{
"person_name": "Marios Lannister",
"username": "mpadministrator",
"id": "1"
}
},
"provided_by":
{
"person_name": "mpadministrator",
"username": "mpadministrator",
"id": "1"
},
"life_cycle_state": "APPROVED",
"discount_free_period":
{
"time_period_value": 8,
"time_period_uot": "DAYS"
},
"provided_on": "2015-03-09T10:50:21",
"applied": false,
"job": null,
"expiration_date": null
}
} |
|
POST additive_discounts/ad_hoc_discounts/cancel
This method cancels an ad hoc discount, which is in a pending approval life cycle state or approved but not applied yet. A single ad hoc discount can be cancelled by each call.
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
ad_hoc_discount_identifier
(mandatory)
...
Ad Hoc Discount identifier
The identifier of the ad hoc discount that will be cancelled. Only ad hoc discounts in a pending approval life cycle state or approved but not applied can be specified. The allowed ad hoc discount identifier fields are the following:
...
cancelled_by_identifier
(optional)
...
cancelled_on
(optional)
...
Restrictions
- It is mandatory to specify one of the semi-optional parameters.
Response Data
...
Examples
| Expand |
|---|
|
HTTP Method: POST Request: Body: | Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
| {
"token":"4C5D6C83A5584D928FCBAA30DAA58E36",
"ad_hoc_discount_identifier":{"number":"21"},
"cancelled_by_identifier":{ "username" : "mpadministrator" },
"cancelled_on" : "2015-03-09T10:58:39"
} |
Response: | Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
| {
"status":
{
"message": null,
"description": null,
"code": "OK"
},
"data":
{
"cancelled_by":
{
"person_name": "Marios Lannister",
"username": "mpadministrator",
"id": "1",
"email": "mp@ministrator.com"
},
"effective_date": "2015-03-09T11:23:06",
"udf_float_1": 10,
"products_set":
[
{
"id": "221A5B9530464947AA22AB752B792BB6",
"product":
{
"product_type":
{
"physical_good_type": null,
"service_type": "TERMED",
"used_for_provisioning": true,
"composition_method": "FLAT",
"classification": "SERVICES",
"name": "Subscription services",
"id": "600438B64B0F05AB3D020C902674949F",
"description": "Subscription services",
"alternative_code": "SS"
},
"id": "DAD03F53603E48B419E48BFDD737B65C",
"description": "Add on for P1",
"code": "Add on Movies",
"alternative_code": "P111"
}
},
{
"id": "1820896845FA4CA2925ACC130FEC58F2",
"product":
{
"product_type":
{
"physical_good_type": null,
"service_type": "TERMED",
"used_for_provisioning": true,
"composition_method": "FLAT",
"classification": "SERVICES",
"name": "Subscription Packages",
"id": "BC954969D3172372D498D3BB2BA590A0",
"description": "Subscription main packages",
"alternative_code": "SP"
},
"id": "B1E02AFD27BD8D28762873E9EF4880DE",
"description": null,
"code": "P2",
"alternative_code": "P2"
}
},
{
"id": "B0883E6EEB2847A895974624CFFE761A",
"product":
{
"product_type":
{
"physical_good_type": null,
"service_type": "TERMED",
"used_for_provisioning": true,
"composition_method": "FLAT",
"classification": "SERVICES",
"name": "Subscription Packages",
"id": "BC954969D3172372D498D3BB2BA590A0",
"description": "Subscription main packages",
"alternative_code": "SP"
},
"id": "5C2DCFDD743632AC57AE8147B6EE665E",
"description": null,
"code": "P1",
"alternative_code": "P1"
}
},
{
"id": "F0ECF83C05C9421F816E8CD508DF509D",
"product":
{
"product_type":
{
"physical_good_type": null,
"service_type": "USAGE",
"used_for_provisioning": true,
"composition_method": "FLAT",
"classification": "SERVICES",
"name": "Usage Services",
"id": "219FBB8FBAA1433AB0A33446B61637F9",
"description": "A type which is used for usage services",
"alternative_code": "US"
},
"id": "3ECE39556C0CFCD7610F05063C189EF6",
"description": "Video On Demand Service",
"code": "Video On Demand Service",
"alternative_code": "VOD"
}
}
],
"udf_float_2": 20,
"udf_float_3": 30,
"number": "21",
"udf_float_4": 40,
"udf_string_1": "udf string 1",
"udf_string_2": "udf string 2",
"cancelled_on": "2015-03-09T10:58:39",
"udf_string_3": "udf string 3",
"udf_string_4": "udf string 4",
"udf_string_5": "udf string 5",
"udf_string_6": "udf string 6",
"udf_string_7": "udf string 7",
"udf_string_8": "udf string 8",
"discount_amount": null,
"discount_percentage": null,
"id": "051BC89877B94C88928D100925904EB2",
"approval_method": "MANUAL",
"subscription":
{
"accounts_receivable":
{
"account_owner":
{
"last_name": "Ioannou78",
"life_cycle_state": "FINANCIAL",
"middle_name": null,
"company_profile": null,
"title": null,
"type": "PERSON",
"first_name": "Marios",
"name": "Marios Ioannou78",
"id": "2CAAE984123646F2999935E6BB0D1A90",
"company_name": null,
"demographics":
{
"gender": null,
"passport_issued_by_country": null,
"passport_number": null,
"social_security_number": null,
"country_of_residence":
{
"name": "UNITED KINGDOM",
"id": "126"
},
"industry_sector": null,
"date_of_birth":
{
"month": null,
"day": null,
"year": null
},
"name_day":
{
"month": null,
"day": null
},
"id_number": null,
"id_issued_by_country": null,
"industry": null
}
},
"life_cycle_state": "ACTIVE",
"number": "558",
"name": "mar78",
"id": "C14A88EF0C434BA886755D8B4DCEE2F2"
},
"life_cycle_state": "EFFECTIVE",
"number": "S60310",
"type":
{
"name": "Normal Subscription",
"id": "6BB2B984CC9309775D06650C7493A836",
"description": null,
"alternative_code": "ST"
},
"id": "35656546C7504EEA821A592E69E3C86F"
},
"additive_discount_definition":
{
"life_cycle_state": "EFFECTIVE",
"classification": "SUBSCRIPTIONS",
"type": "AD_HOC",
"name": "Lucia Test 4 ",
"id": "CBAE3930253AB31856D28BF34023E44E",
"alternative_code": "lt4"
},
"approved_by": null,
"applied_on": null,
"approved_on": null,
"udf_date_1": "2014-05-05T15:49:59",
"udf_date_2": "2014-06-05T15:49:59",
"udf_date_3": "2014-07-05T15:49:59",
"udf_date_4": "2014-08-05T15:49:59",
"log_information":
{
"updated_date": "2015-03-09T12:22:53",
"created_by_unit":
{
"community_name": "Main Community",
"group_name": "Main Group",
"name": "Admin Unit",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"description": "r1",
"alternative_code": "MG"
},
"created_date": "2015-03-09T11:22:54",
"updated_by_unit":
{
"community_name": "Main Community",
"group_name": "Main Group",
"name": "Admin Unit",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"description": "r1",
"alternative_code": "MG"
},
"created_by_user":
{
"person_name": "mpadministrator",
"username": "mpadministrator",
"id": "1"
},
"updated_by_user":
{
"person_name": "Marios Lannister",
"username": "mpadministrator",
"id": "1"
}
},
"provided_by":
{
"person_name": "mpadministrator",
"username": "mpadministrator",
"id": "1"
},
"life_cycle_state": "CANCELLED",
"discount_free_period":
{
"time_period_value": 8,
"time_period_uot": "DAYS"
},
"provided_on": "2015-03-09T11:23:10",
"applied": false,
"job": null,
"expiration_date": null
}
} |
|
POST additive_discounts/auto_apply_disounts/get_applicable_discounts
This method returns a list of discounts that will automatically be applied on a subscription or a job having the specified characteristics. Multiple auto apply discounts are returned by each call
Resource URL
Parameters
Name | Type | Description |
token | String | The token retrieved from the login method |
accounts_receivable
(mandatory) | Accounts Receivable Object | Information related with the accounts receivable that will own the subscription or the job that could possibly be discounted |
subscription (semi-optional) | Subscriptions Object | Information related with the subscription that could possibly be discounted |
job (semi-optional) | Job Object | Information related with the job that could possibly be discounted |
buy_in_advance_request (optional) | Buy in Advance Request Object | Information related with buy in advance request that might be applicable on the subscription that could possible be discounted. This information is applicable only if a subscription is specified. | Tip |
|---|
Available from CRM.COM R6.0.0 |
|
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 semi-optional parameter can be specified.
Response Data
...
Examples
| Expand |
|---|
|
HTTP Method: POST Request: Body: | Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
| {
"token":"BC0919815F72418DBADA3F5F19C012F9",
"accounts_receivable":
{
"classification_identifier":{"name":"Employee"},
"presentment_preferences_set":
[
{"presentment_preference_identifier":{"name":"By Email"}},
{"presentment_preference_identifier":{"name":"By Post"}}
],
"payment_preferences_set":
[
{"payment_preference_identifier":{"name":"PayPal"}}
]
},
"subscription":
{
"type_identifier":{"name":"London"},
"owned_by_group_identifier": {"name":"Main Group"},
"billing_terms":
{
"billing_term_scheme_identifier":{"code":"MPBTS"},
"price_plan_identifier" : {"code":"ABPP"},
"billing_cycle_day":5,
"agreement_date": "2015-05-05T15:49:59",
"billing_frequency":"DAILY",
"binding_information":
{
"binding_period":"WEEK",
"start_date": "2015-06-05T15:49:59"
},
"concurrent_usage_based_pricing":
{
"concurrent_usage":10,
"rate_percentage":25
}
},
"services_set":
[
{
"service_identifier":{"code":"Bronze"}
},
{
"service_identifier":{"code":"Movies 2"}
}
]
}
} |
Response: | Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
| {
"status":
{
"message": null,
"description": null,
"code": "OK"
},
"data":
[
{
"discount_amount_UOT": null,
"to_date": "2016-03-11T00:00:00",
"from_date": "2015-04-06T00:00:00",
"free_period": null,
"discount_amount": null,
"discount_percentage": 25,
"additive_discount_definition":
{
"life_cycle_state": "EFFECTIVE",
"classification": "SUBSCRIPTIONS",
"type": "AUTO_APPLY",
"name": " Auto Apply TC 2_1",
"id": "B49A5B2D654B4E5F88DCD3DD8855BE63",
"alternative_code": "AAT2_1"
},
"product":
{
"product_type":
{
"physical_good_type": null,
"service_type": "TERMED",
"used_for_provisioning": true,
"composition_method": "FLAT",
"classification": "SERVICES",
"name": "Subscription services",
"id": "600438B64B0F05AB3D020C902674949F",
"description": "Subscription services",
"alternative_code": "SS"
},
"id": "90578F46460B7C4530BE801CFE5CB9A1",
"description": "Movies 2",
"code": "Movies 2",
"alternative_code": "m2"
},
"free_period_UOT": null
}
]
} |
|
POST additive_discounts/ad_hoc_disounts/get_available_discounts
This method returns a list of ad hoc discounts that are available for a subscription or a job having the specified characteristics. Ad hoc discounts are applied manually. Multiple ad hoc discounts are returned by each call
Resource URL
Parameters
Name | Type | Description |
token | String | The token retrieved from the login method |
accounts_receivable
(mandatory) | Accounts Receivable Object | Information related with the accounts receivable that will own the subscription or the job that could possibly be discounted |
subscription (semi-optional) | Subscriptions Object | Information related with the subscription that could possibly be discounted |
job (semi-optional) | Job Object | Information related with the job that could possibly be discounted |
buy_in_advance_request (optional) | Buy in Advance Request Object | Information related with buy in advance request that might be applicable on the subscription that could possible be discounted. This information is applicable only if a subscription is specified. | Tip |
|---|
Available from CRM.COM R6.0.0 |
|
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 semi-optional parameter can be specified.
Response Data
...
Examples
| Expand |
|---|
|
HTTP Method: POST
Request:
Body:
| Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
|
{
"token":"C224050D1AD945009263D65CE98AFE35",
"accounts_receivable":
{
"classification_identifier":{"name":"Employee"},
"presentment_preferences_set":
[
{"presentment_preference_identifier":{"name":"By Email"}},
{"presentment_preference_identifier":{"name":"By Post"}}
],
"payment_preferences_set":
[
{"payment_preference_identifier":{"name":"PayPal"}}
]
},
"subscription":
{
"type_identifier":{"name":"London"},
"owned_by_group_identifier": {"name":"Main Group"},
"billing_terms":
{
"billing_term_scheme_identifier":{"code":"ABTS"},
"price_plan_identifier" : {"code":"BPP0614"},
"billing_cycle_day":5,
"agreement_date": "2015-05-05T15:49:59",
"billing_frequency":"DAILY",
"binding_information":
{
"binding_period":"WEEK",
"start_date": "2015-06-05T15:49:59"
}
},
"services_set":
[
{
"service_identifier":{"code":"Bronze"}
},
{
"service_identifier":{"code":"Movies 2"}
}
]
}
} |
Response:
| Code Block |
|---|
| theme | Confluence |
|---|
| language | javascript |
|---|
| linenumbers | true |
|---|
|
{
"status":
{
"message": null,
"description": null,
"code": "OK"
},
"data":
[
{
"discount_amount_UOT": "YEARS",
"to_date": "2015-06-12T00:00:00",
"from_date": "2015-05-05T00:00:00",
"free_period": null,
"discount_amount": 50,
"discount_percentage": null,
"additive_discount_definition":
{
"life_cycle_state": "EFFECTIVE",
"classification": "SUBSCRIPTIONS",
"type": "AD_HOC",
"name": "Sub Test",
"id": "78309B32849D44C1B11DFE8A9796F9C7",
"alternative_code": "ST"
},
"product":
{
"product_type":
{
"physical_good_type": null,
"service_type": "TERMED",
"used_for_provisioning": true,
"composition_method": "FLAT",
"classification": "SERVICES",
"name": "Subscription Packages",
"id": "BC954969D3172372D498D3BB2BA590A0",
"description": "Subscription main packages",
"alternative_code": "SP"
},
"id": "CAD1E31269B76D7A65ACCE45B2E68DFD",
"description": "Bronze Premium Package",
"code": "Bronze",
"alternative_code": "BP"
},
"free_period_UOT": null
},
{
"discount_amount_UOT": "YEARS",
"to_date": "2015-06-12T00:00:00",
"from_date": "2015-05-05T00:00:00",
"free_period": null,
"discount_amount": 50,
"discount_percentage": null,
"additive_discount_definition":
{
"life_cycle_state": "EFFECTIVE",
"classification": "SUBSCRIPTIONS",
"type": "AD_HOC",
"name": "Sub Test",
"id": "78309B32849D44C1B11DFE8A9796F9C7",
"alternative_code": "ST"
},
"product":
{
"product_type":
{
"physical_good_type": null,
"service_type": "TERMED",
"used_for_provisioning": true,
"composition_method": "FLAT",
"classification": "SERVICES",
"name": "Subscription services",
"id": "600438B64B0F05AB3D020C902674949F",
"description": "Subscription services",
"alternative_code": "SS"
},
"id": "90578F46460B7C4530BE801CFE5CB9A1",
"description": "Movies 2",
"code": "Movies 2",
"alternative_code": "m2"
},
"free_period_UOT": null
}
]
}| Panel |
|---|
|
| Child pages (Children Display) |
|---|
|
|