Skip to main content
Aria Knowledge Central

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:

Value Description
True  
False  
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:

Value Description
True Discarded usage records will be included
False Discarded usage records will not be included
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:

Value Description
+ The associated "_delta_amount" is OVER the associated "_threshold_amount".
- The associated "_delta_amount" is UNDER the associated "_threshold_amount".
= The associated "_delta_amount" is EQUAL TO the associated "_threshold_amount".
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:

Value Description
+ The associated "_delta_amount" is OVER the associated "_threshold_amount".
- The associated "_delta_amount" is UNDER the associated "_threshold_amount".
= The associated "_delta_amount" is EQUAL TO the associated "_threshold_amount".
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:

Value Description
+ The associated "_delta_amount" is OVER the associated "_threshold_amount".
- The associated "_delta_amount" is UNDER the associated "_threshold_amount".
= The associated "_delta_amount" is EQUAL TO the associated "_threshold_amount".
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:

Value Description
+ The associated "_delta_amount" is OVER the associated "_threshold_amount".
- The associated "_delta_amount" is UNDER the associated "_threshold_amount".
= The associated "_delta_amount" is EQUAL TO the associated "_threshold_amount".
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:

Value Description
+ The associated "_delta_amount" is OVER the associated "_threshold_amount".
- The associated "_delta_amount" is UNDER the associated "_threshold_amount".
= The associated "_delta_amount" is EQUAL TO the associated "_threshold_amount".
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

See fields below

unit_threshold_details object   No

See fields below

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

See fields below

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:

Value Description
1 Client calculated taxes provided as input to Aria.
2 Aria calculated taxes using Aria's internal tax method.
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:

Value Description
0 Usage amount is Tax Exclusive.
1 Usage amount is Tax Inclusive.

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:

Value Description
+ The associated "_delta_amount" is OVER the associated "threshold_value".
- The associated "_delta_amount" is UNDER the associated "threshold_value".
= The associated "_delta_amount" is EQUAL TO the associated "threshold_value".

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:

Value Description
A It represents threshold destination type is Account.
C It represents threshold destination type is Client
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:

Value Description
MTD It represents threshold balance type is MTD.
PTD It represents threshold balance type is PTD.
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

See fields below

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:

Value Description
0 Federal
1 State / Province
2 County
3 City
4 Unincorporated Area
5 District
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:

Value Description
0/ null Tax record has not been excluded from billing.
1 Tax record has been excluded from billing.
TOP
  • Was this article helpful?