GET accounts_receivable/get_remaining_usage_allowance
Available from CRM.COM R13.0.0
This method returns information related with an accounts receivable's remaining usage allowance. Information related to a single accounts receivable is returned by each call.
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
| accounts_receivable_identifier (mandatory) | Accounts receivable identifier | The identifier of the accounts receivable for which its remaining usage allowance should be returned as a result. The allowed accounts receivable 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 |
|---|---|---|
| remaining_rated_amount_per_day | Number | The accumulated remaining rated amount that the accounts receivable is allowed to use within a day |
| remaining_rated_amount_per_month | Number | The accumulated remaining rated amount that the accounts receivable is allowed to use within a month |
| remaining_rated_amount_per_transaction | Number | The accumulated remaining rated amount that the accounts receivable is allowed to use per transaction |
| remaining_usage_per_day | Number | The accumulated remaining usage amount that the accounts receivable is allowed to use within a day |
| remaining_usage_per_month | Number | The accumulated remaining usage amount that the accounts receivable is allowed to use within a month |
| remaining_usage_per_transaction | Number | The accumulated remaining usage amount that the accounts receivable is allowed to use per transaction |
| remaining_amount_until_usage_blocking | Number | The amount that the account owner can still spend until usage consumption is blocked due to exceeded credit limit.The amount depends on the accounts receivable's credit limit minus its balance, as well as on whether non-billed usage is taken into account during blocking. Available from CRM.COM R14.11.0 |
| unbilled_usage_amount | Number | The consumed usage for which the account owner is not billed yet during the current billing cycle Available from CRM.COM R14.11.0 |
| accounts_receivable | Accounts Receivable Object | The accounts receivable for which the remaining usage allowance is returned |
| remaining_usage_allowance_per_service | Set of Accounts Receivable Usage Allowance per Service | The remaining usage allowance per service, service product type and product family |
Referred Objects Response Data
Examples
HTTP Method: POST
Request:
Response:
{
"data": {
"remaining_rated_amount_per_day": "50",
"remaining_usage_per_day": null,
"remaining_usage_per_month": null,
"remaining_usage_allowance_per_service": [
{
"remaining_rated_amount_per_day": "50",
"service_family": null,
"service_type": null,
"remaining_usage_per_day": "3",
"service": {
"code": "Serendipity",
"product_type": {
"service_type": "USAGE",
"used_for_provisioning": true,
"alternative_code": "V",
"udr_type": {
"alternative_code": "V",
"name": "VOD",
"description": null,
"id": "B3CFC986221548279752B1ABC6F4C480"
},
"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"
},
"remaining_usage_per_month": null,
"remaining_rated_amount_per_transaction": "50",
"remaining_rated_amount_per_month": "150",
"remaining_usage_per_transaction": "1"
}
],
"remaining_rated_amount_per_transaction": null,
"remaining_rated_amount_per_month": "150",
"remaining_usage_per_transaction": null
},
"status": {
"code": "OK",
"description": "",
"message": ""
}
}
HTTP Method: POST
Request:
Response:
{
"data": {
"remaining_rated_amount_per_day": "50",
"remaining_usage_per_day": "250",
"remaining_usage_per_month": "994",
"remaining_usage_allowance_per_service": [
{
"remaining_rated_amount_per_day": "50",
"service_family": null,
"service_type": {
"service_type": "USAGE",
"used_for_provisioning": false,
"alternative_code": "USTA",
"udr_type": {
"alternative_code": "L",
"name": "Litres",
"description": null,
"id": "B1238270684F4457B6D8EBD4CA00963B"
},
"composition_method": "FLAT",
"name": "Usage Service Type A",
"description": null,
"id": "819661A2C34A4BBF9005E74387CD7A40",
"classification": "SERVICES",
"physical_good_type": null
},
"remaining_usage_per_day": "250",
"service": null,
"remaining_usage_per_month": "994",
"remaining_rated_amount_per_transaction": "0",
"remaining_rated_amount_per_month": "897",
"remaining_usage_per_transaction": "10"
}
],
"remaining_rated_amount_per_transaction": "0",
"remaining_rated_amount_per_month": "897",
"remaining_usage_per_transaction": "10"
},
"status": {
"code": "OK",
"description": "",
"message": ""
}
}