POST additive_discounts/ad_hoc_discounts/get_available_discounts
- Former user (Deleted)
- p_demou (Deactivated)
- Georgia Kountouri
This method returns a list of ad hoc discounts that are available to be applied on subscriptions or jobs 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 (semi-optional) | Accounts Receivable Object | Characteristics related with the accounts receivable that will own the subscription or the job that could possibly be discounted Up to CRM.COM R14 accounts receivable was a mandatory |
(semi-optional) | Subscriptions Object | Characteristics related to subscriptions that could possibly be discounted. |
(semi-optional) | Job Object | Characteristics related to jobs that could possibly be discounted. |
(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. Not available from CRM.COM R15.0.0 |
(optional) | Products Object | The product the discount is for. Available from CRM.COM R15.0.0 |
date (optional) | Date | The date for which you want to see the available discounts for. Applicable from CRM.COM R15.0.0 |
from_date (optional) | Date | The date from which the termed service discount will be applied from. Applicable only for termed services Applicable from CRM.COM R15.0.0 |
to_date (optional) | Date | The date up to which the termed service discount will be applied to Applicable only for termed services Applicable from CRM.COM R15.0.0 |
usage_amount (optional) | Float | The usage amount of the usage service. Applicable only for usage services Applicable from CRM.COM R15.0.0 |
usage_zone (optional) | String | The usage zone the usage service belongs to. Applicable only for usage services Applicable from CRM.COM R15.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 |
Referred Parameters Objects Data
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one semi-optional parameter can be specified.
Response Data
Name | Type | Description |
|---|---|---|
| discount_option | String | The type of discount which will be applied, which can be one of the following
Available from CRM.COM R15.0.0 |
| discount_amount | Number | The discount amount that will be applied, if the additive discount definition is set up to provide a range of discount based on amount. |
| discount_percentage | Number | The discount percentage that will be applied, if the additive discount definition is set up to provide a range of discount based on percentage Available from CRM.COM R15.0.0 |
| discount_free_usage | Number | The free usage discount that will be applied, if the additive discount definition is set up to provide a range of discount based on usage. The UOM depends on the UOM of the usage service being discounted Available from CRM.COM R15.0.0 |
| from_date | Date | The date that the ad hoc additive discount will be applicable from |
| to_date | Date | The date that the ad hoc additive discount will be applicable to |
| allowed_discount_amount_range | Allowed discount amount range | The allowed discount amount range that could be applied. Available from CRM.COM R14.2.0 |
| for | For Object | The discounted period every time the discount is given when the Discount Option is Percentage per Period or Amount per Period. The possible options are the following:
Available from CRM.COM R15.0.0 |
| renew | Renew Object | How often the discount is renewed (provided again) when the Discount Option is Percentage per Period or Amount per Period which can have one of the following options:
Available from CRM.COM R15.0.0 |
| currency | Currency Object | The currency in which the discount amount is returned Available from CRM.COM R14.2.0 |
| additive_discount_definition | Additive Discount Definition Object | The ad hoc additive discount definition that will be applied |
| product | Product Object | The product that will be discounted by the specified ad hoc additive discount definition |
Referred Objects Response Data
Examples
HTTP Method: POST
Request:
Body:
{
"token":"{{token}}",
"subscription":
{
"type_identifier":{"name":"Normal"},
"owned_by_group_identifier": {"name":"Main Group"},
"billing_terms":
{
"billing_term_scheme_identifier":{"code":"Normal Billing Scheme"},
"price_plan_identifier" : {"code":"BPPT"},
"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"}
}
]
},
"product":{"product_identifier":{"code":"Bronze"}}
}
Response:
{
"data": [
{
"product": {
"code": "Bronze",
"product_type": {
"meter_reading_type": null,
"service_type": "TERMED",
"used_for_provisioning": true,
"alternative_code": "Main Packages",
"udr_type": null,
"composition_method": "FLAT",
"name": "Main Packages",
"description": null,
"id": "E186E293AAAB49EE86A729540A4287FE",
"classification": "SERVICES",
"physical_good_type": null
},
"alternative_code": "B",
"description": "Bronze",
"id": "F50CC52934BD4F119B6E18E215A4FC55",
"priority_level": null
},
"discount_option": "PERCENTAGE",
"from_date": "2015-05-05T00:00:00",
"to_date": null,
"discount_amount": null,
"additive_discount_definition": {
"alternative_code": "PS7",
"name": "Pricing SB 7",
"id": "F965D86276EC419DA53B154D3BA82CE4",
"life_cycle_state": "EFFECTIVE",
"classification": "GENERAL",
"type": "AD_HOC"
},
"for": null,
"currency": {
"suffix_symbol": null,
"prefix_symbol": "€",
"decimal_part_name": null,
"code": "EUR",
"integer_part_name": null,
"id": "2",
"life_cycle_state": "EFFECTIVE"
},
"discount_percentage": 50,
"renew": null,
"discount_free_usage": null
}
],
"status": {
"code": "OK",
"description": "",
"message": ""
}
}