This method creates a buy in advance request. A single buy in advance request can be created by each call.
Resource URL
Parameters
Name | Type | Description | ||||||||||
token | String | The token retrieved from the login method | ||||||||||
subscription_identifier (mandatory) | Subscription Identifier | The identifier of the subscription related with the buy in advance request. The allowed subscription identifier fields are the following:
| ||||||||||
duration (mandatory) | Number | The duration that is requested to be bough in advance | ||||||||||
unit_of_time (mandatory) | String | The unit of time that measures the specified duration. The supported values are DAYS, WEEKS, MONTHS or YEARS | ||||||||||
description (optional) | String | A description of the retrieved buy in advance request | ||||||||||
billing_effective_date (optional) | Date | The billing effective date of the buy in advance request, that determines the earliest date that the request can be picked up by the billing engine. If not specified then it is automatically set to the date that the request is submitted | ||||||||||
udf_string_1 | String | User Defined Field of type String | ||||||||||
udf_string_2 | String | User Defined Field of type String | ||||||||||
udf_string_3 | String | User Defined Field of type String | ||||||||||
udf_string_4 | String | User Defined Field of type String | ||||||||||
udf_string_5 | String | User Defined Field of type String | ||||||||||
udf_string_6 | String | User Defined Field of type String | ||||||||||
udf_string_7 | String | User Defined Field of type String | ||||||||||
udf_string_8 | String | User Defined Field of type String | ||||||||||
udf_float_1 | Float | User Defined Field of type Float | ||||||||||
udf_float_2 | Float | User Defined Field of type Float | ||||||||||
udf_float_3 | Float | User Defined Field of type Float | ||||||||||
udf_float_4 | Float | User Defined Field of type Float | ||||||||||
udf_date_1 | Date | User Defined Field of type Date | ||||||||||
udf_date_2 | Date | User Defined Field of type Date | ||||||||||
udf_date_3 | Date | User Defined Field of type Date | ||||||||||
udf_date_4 | Date | User Defined Field of type Date | ||||||||||
(optional) | Set of Buy in advance request services | A set of services which are bough in advance through this request. Applicable only for prepaid subscriptions and only for such subscriptions' pre-rated services Available from CRM.COM R12.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 of those parameters is allowed to be specified.
Referred Parameter Objects Data
Response Data
Name | Type | Description | |
---|---|---|---|
id | String | The ID of the retrieved buy in advance request | |
number | String | The number of the retrieved buy in advance request | |
duration | Number | The duration that was bough in advance | |
unit_of_time | String | The unit of time that measures the specified duration. The supported values are DAYS, WEEKS, MONTHS or YEARS | |
description | String | A description of the retrieved buy in advance request | |
life_cycle_state | String | The life cycle state of the retrieved buy in advance request. Supported values are EFFECTIVE and CANCELLED | |
billing_state | String | The state of the retrieved buy in advance request in relation to billing. It is calculated dynamically and determines if the specific buy in advance request was already rated or not. The supported values are RATED and NOT_RATED | |
billing_effective_date | Date | The billing effective date of the retrieved buy in advance request, that determines the earliest date that the request can be picked up by the billing engine. | |
rating_state | String | The rating state of the buy in advance request. The supported values are PENDING or COMPLETED Available from CRM.COM R9.0.0 | |
udf_string_1 | String | User Defined Field of type String | |
udf_string_2 | String | User Defined Field of type String | |
udf_string_3 | String | User Defined Field of type String | |
udf_string_4 | String | User Defined Field of type String | |
udf_string_5 | String | User Defined Field of type String | |
udf_string_6 | String | User Defined Field of type String | |
udf_string_7 | String | User Defined Field of type String | |
udf_string_8 | String | User Defined Field of type String | |
udf_float_1 | Float | User Defined Field of type Float | |
udf_float_2 | Float | User Defined Field of type Float | |
udf_float_3 | Float | User Defined Field of type Float | |
udf_float_4 | Float | User Defined Field of type Float | |
udf_date_1 | Date | User Defined Field of type Date | |
udf_date_2 | Date | User Defined Field of type Date | |
udf_date_3 | Date | User Defined Field of type Date | |
udf_date_4 | Date | User Defined Field of type Date | |
subscription | Subscription Object | The subscription that is affected by the retrieved buy in advance request | |
log_information | Log Information Object | The log information of the retrieved buy in advance request | |
services_set | Set of Buy in advance services | A Set of services bought in advance through this request. Applicable only for pre-rated services of prepaid subscriptions. Available from CRM.COM R12.0.0 |
Referred Objects Response Data