get_unbilled_usage_summary_m
Summary
| API Name | get_unbilled_usage_summary_m |
|---|---|
| Class | account_services_m |
| Update Version | 57 |
Description
Returns all information related to summary value of unbilled usage on the account.
Inputs
| Name | Type | Length | Required | Description | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| client_no | long | 22 | Yes |
Aria-assigned unique identifier indicating the Aria client providing service to this account. |
||||||
| auth_key | string | 32 | Yes |
Aria-assigned unique key for authenticating the validity of the requestor. This key is passed with each method call. |
||||||
| acct_no | long | 22 | Yes |
Aria-assigned account identifier. This value is unique across all Aria-managed accounts. Alternative required field: client_acct_id |
||||||
| client_acct_id | string | 50 | Yes |
Client-defined account identifier. Alternative required field: acct_no |
||||||
| master_plan_instance_id | long | 22 | No |
The Master Subscription plan instance number. |
||||||
| client_master_plan_instance_id | string | 100 | No |
Client-defined Master plan Subscription plan instance ID. |
||||||
| usage_details_flag | string | 5 | No |
Flag when false will suppress the unbilled usage detail records. |
||||||
| include_all_usage_unit_thresholds | string | 5 | No |
Flag decides whether to return values of all plans/usage types or not. Allowed values:
|
||||||
| plan_no | long | 22 | No |
The unique plan identifier. Alternative field: plan_instance_no or client_plan_instance_id |
||||||
| usage_type_no | long | 22 | No |
The Aria-assigned usage type number to set the threshold unit amount per specific usage type. Alternative field: usage_type_cd |
||||||
| usage_type_cd | string | 22 | No |
Client-assigned identifier for the type to set the threshold unit amount per specific usage type. Either this field OR "usage_type_no" must be passed into the API to denote which usage type to set the threshold unit. Alternative field: usage_type_no |
||||||
| retrieve_excluded_usage | string | 5 | No |
Use this field to include usage records that have been permanently excluded from billing Allowed values:
|
||||||
| locale_no | long | 30 | No |
Aria-assigned unique identifier of the locale used for translations. This value must be unique across all Aria clients. Alternative field: locale_name |
||||||
| locale_name | string | 100 | No |
Name of the locale. Alternative field: locale_no |
||||||
| plan_instance_no | long | 22 | No |
The Aria defined unique identifier of the plan instance (can be either a master or supplemental plan). Alternative field: plan_no or client_plan_instance_id |
||||||
| client_plan_instance_id | string | 100 | No |
The client-defined identifier of the plan instance (can be either a master or supplemental plan) Alternative field: plan_no or plan_instance_no |
Outputs
| Name | Type | Length | Required | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| error_code | long | No |
Aria-assigned error identifier. 0 indicates no error. |
|||||||||
| error_msg | string | No |
Description of any error that occurred. "OK" if there was no error. |
|||||||||
| currency_cd | string | No |
The 3-character ISO-compliant currency code in lowercase for monetary values used in the context of this API method. |
|||||||||
| currency_name | string | No |
Human-readable currency name, in English. |
|||||||||
| acct_no | long | 22 | No |
Aria-assigned account identifier. This value is unique across all Aria-managed accounts. |
||||||||
| client_acct_id | string | 50 | No |
Client-defined account identifier. |
||||||||
| master_plan_instance_id | long | 22 | No |
The Master Subscription plan instance number. |
||||||||
| client_master_plan_instance_id | string | 100 | No |
Client-defined Master plan Subscription plan instance ID. |
||||||||
| mpi_mtd_threshold_amount | double | No |
The month-to-date threshold amount which, when crossed over or under by the account's running month-to-date unbilled usage balance, triggers an email notification of such to the account holder (if client is configured for such notices). |
|||||||||
| mpi_ptd_threshold_amount | double | No |
The billing-period-to-date threshold amount which, when crossed over or under by the account's running billing-period-to-date unbilled usage balance, triggers an email notification of such to the account holder (if client is configured for such notices). |
|||||||||
| client_mtd_threshold_amount | double | No |
The month-to-date threshold amount which, when crossed over or under by the account's running month-to-date unbilled usage balance, triggers provisioning event notification of such to the client (if client is configured for receipt of such events). |
|||||||||
| client_ptd_threshold_amount | double | No |
The billing-period-to-date threshold amount which, when crossed over or under by the account's running billing-period-to-date unbilled usage balance, triggers provisioning event notification of such to the client (if client is configured for receipt of such events). |
|||||||||
| mtd_balance_amount | double | No |
The account's current month-to-date unbilled usage currency value. |
|||||||||
| ptd_balance_amount | double | No |
The account's current billing-period-to-date unbilled usage currency value. |
|||||||||
| mpi_mtd_delta_sign | string | 1 | No |
A symbolic indicator as to whether the value in parameter "mpi_mtd_delta_amount" is above, below, or equal to its associated threshold value. Allowed values:
|
||||||||
| mpi_mtd_delta_amount | double | No |
A symbolic indicator as to whether the value in parameter "mpi_mtd_delta_amount" is above, below, or equal to its associated threshold value. |
|||||||||
| mpi_ptd_delta_sign | string | 1 | No |
A symbolic indicator as to whether the value in parameter "mpi_ptd_delta_amount" is above, below, or equal to its associated threshold value. Allowed values:
|
||||||||
| mpi_ptd_delta_amount | double | No |
A symbolic indicator as to whether the value in parameter "mpi_mtd_delta_amount" is above, below, or equal to its associated threshold. |
|||||||||
| client_mtd_delta_sign | string | 1 | No |
A symbolic indicator as to whether the value in parameter "client_mtd_delta_amount" is above, below, or equal to its associated threshold value. Allowed values:
|
||||||||
| client_mtd_delta_amount | double | No |
The threshold amount of usage minus the unbilled amount of usage. Used in conjunction with the delta sign, which indicates if the value is above, below, or equal to the client's threshold amount for the month to date. |
|||||||||
| client_ptd_delta_sign | string | 1 | No |
A symbolic indicator as to whether the value in parameter "client_mtd_delta_amount" is above, below, or equal to its associated threshold value. Allowed values:
|
||||||||
| client_ptd_delta_amount | double | No |
The threshold amount of usage minus the unbilled amount of usage. Used in conjunction with the delta sign, which indicates if the value is above, below, or equal to the client's threshold amount for the period to date. |
|||||||||
| unapp_svc_credit_bal_amount | double | No |
The account's current unapplied usage currency value. |
|||||||||
| unapp_svc_credit_delta_sign | string | 1 | No |
A symbolic indicator as to whether the value in parameter "unapp_svc_credit_delta_amount" is above, below, or equal to its initial value. Allowed values:
|
||||||||
| unapp_svc_credit_delta_amount | double | No |
The amount of usage minus the amount of the service credit. Used in conjunction with the delta sign, which indicates if the value is above, below, or equal to the amount of the unapplied service credit. |
|||||||||
| unbilled_usage_rec | object | No | ||||||||||
| unit_threshold_details | object | No | ||||||||||
| acct_locale_no | long | 30 | No |
Aria-assigned unique identifier of the locale used for translations. This value is unique across all Aria-managed accounts. |
||||||||
| acct_locale_name | string | 100 | No |
Name of the account level locale. |
||||||||
| usage_record_tax_details | object | No |
Array of usage tax details |
unbilled_usage_rec fields
| Name | Type | Length | Required | Description | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| plan_instance_id | long | 22 | No |
The Subscription plan instance number. |
||||||
| usage_type_no | long | No |
Aria-assigned unique identifier representing the type of usage that is being recorded. |
|||||||
| usage_type_description | string | No |
The name of this usage type used on all reports, account statements, etc., E.g. International Call Minutes |
|||||||
| usage_date | string | No |
The date on which the given usage was incurred. |
|||||||
| units | double | No |
The number of units incurred by the account holder. |
|||||||
| specific_record_charge_amount | double | No |
The rated monetary charge this record will be billed as |
|||||||
| pre_rated_rate | double | No |
Rate entered while recording usage |
|||||||
| recorded_units | double | No |
The number of units recorded by the account holder. |
|||||||
| usage_parent_rec_no | long | No |
Aria-assigned usage parent record identifier. |
|||||||
| usage_type_code | string | No |
The usage type code of this record |
|||||||
| exclude_reason_cd | long | No |
The reason why this usage record has been excluded from billing |
|||||||
| usage_rec_no | long | No |
Aria-assigned usage record identifier. |
|||||||
| client_plan_instance_id | string | 100 | No |
The client-defined identifier of the plan instance (can be either a master or supplemental plan). |
||||||
| usage_record_pre_taxed_ind | long | No |
Flag to differentiate Client calculated and Aria calculated taxes. Allowed values:
|
|||||||
| usage_record_tax_inclusive_ind | long | No |
This flag denotes if a rate is inclusive of the taxes. Value of 1 means tax inclusive rates and a value of 0 (default) means tax exclusive rates. Allowed values:
|
unit_threshold_details.threshold_levels fields
| Name | Type | Length | Required | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| level_no | long | No |
Returns the threshold level for the threshold_units |
|||||||||
| threshold_value | double | No |
Returns the threshold value against the level_no |
|||||||||
| delta_usage_units_bal | double | No |
Returns the delta usge units balance. |
|||||||||
| delta_usage_units_sign | string | No |
A symbolic indicator as to whether the value in parameter "delta_usage_units_bal" is above, below, or equal to its associated threshold value. Allowed values:
|
unit_threshold_details fields
| Name | Type | Length | Required | Description | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| plan_no | long | 22 | No |
Returns the number of plan no. |
||||||
| usage_type_no | long | No |
Returns the number of usage type. |
|||||||
| threshold_dest_type | string | 1 | No |
Returns a string representing the threshold destination type either Account A or Client C. Allowed values:
|
||||||
| threshold_balance_type | string | 3 | No |
Returns a string representing the threshold balance type either month-to-date or billing-period-to-date. Allowed values:
|
||||||
| threshold_units | double | No |
Returns the number of threshold units. |
|||||||
| usage_units_measured | double | No |
Returns the number of usage units measured. |
|||||||
| plan_instance_no | long | 22 | No |
The Aria defined unique identifier of the plan instance (can be either a master or supplemental plan). |
||||||
| client_plan_instance_id | string | 100 | No |
The client-defined identifier of the plan instance (can be either a master or supplemental plan). |
||||||
| usage_type_cd | string | 100 | No |
Client-assigned identifier for the type of usage being recorded. |
||||||
| threshold_levels | object | No |
usage_record_tax_details fields
| Name | Type | Length | Required | Description | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| usage_rec_no | long | No |
Aria-assigned usage record identifier. |
|||||||||||||||
| tax_detail_line_no | long | No |
Line number associated with each tax detail record. |
|||||||||||||||
| tax_amount | double | No |
Amount of tax applied for the given tax type. |
|||||||||||||||
| tax_rate | double | No |
Rate at which tax is calculated for the tax type used by the tax engine. |
|||||||||||||||
| taxable_amount | double | No |
Taxable amount of the tax type returned by the tax engine. |
|||||||||||||||
| tax_jurisdiction_name | string | No |
Jurisdiction name returned by the tax engine. |
|||||||||||||||
| tax_authority_level | long | No |
Tax jurisdiction code Allowed values:
|
|||||||||||||||
| tax_type_id | string | No |
Identifier of the tax type returned by the tax engine. |
|||||||||||||||
| tax_type_desc | string | No |
Description of the tax type returned by the tax engine. |
|||||||||||||||
| tax_category | string | No |
Category of the tax type returned by the tax engine. |
|||||||||||||||
| tax_summary | string | No |
Summary text returned by the tax engine. |
|||||||||||||||
| is_excluded | long | No |
Specifies whether or not this tax record is included for invoicing. Allowed values:
|