get_all_acct_contracts_m
Summary
| API Name | get_all_acct_contracts_m |
|---|---|
| Class | account_services_m |
| Update Version | 6.39 |
Description
This API returns an array of contracts associated with the given account, as well as contract details. You can optionally filter by contract status.
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 |
||||||||
| filter_status_code | long | 1 | No |
The filter_status_code is the Aria code used to filter account contract for Inactive or Active (0 or 1). Value of "null" returns account contracts without filtering by status, and is the default. Allowed values:
|
||||||||
| exclude_terminated_plan_inst | string | 5 | No |
This indicator determines if terminated plan instances should be excluded from the return. If True is passed, the API shall exclude (not return) any plan instances that have a status of Terminated. Allowed values:
|
||||||||
| locale_no | long | 30 | No |
Aria-assigned Locale identifier. This value is unique across all Aria-managed accounts. Alternative field: locale_name |
||||||||
| locale_name | string | 100 | No |
Name of the locale. Alternative field: locale_no |
||||||||
| contract_limit | long | 30 | No |
Limits the number of records returned in the all_acct_contracts_m array. Min of 1 and Max 999. If no value is specified all possible records will be returned. |
||||||||
| contract_offset | long | 30 | No |
The number of records to skip in the all_acct_contracts_m array. Min of 0 with no maximum value. If no value specified the default is 0. |
||||||||
| plan_instance_no | long | No |
Unique plan instance number for each assigned plan instance. |
|||||||||
| client_plan_instance_id | string | 100 | No |
Unique client-defined ID for each assigned plan instance. |
||||||||
| include_contract_billing_installment | long | 1 | No |
This parameter is ignored when 'Enable Contract Billing Installment' client parameter is set to false and the API won't return contract billing values. If the client parameter is set to true and this parameter is set to 1, the API will return contract billing values(invoiced_contract_period, invoiced_billing_cycle, remaining_contract_period, and remaining_billing_cycle) in contract_plan_instance_info. Allowed values:
|
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. |
|
| all_acct_contracts_m | object | No | ||
| acct_locale_no | long | 30 | No |
Note: This field is deprecated. Aria no longer supports acct_locale_no. |
| acct_locale_name | string | 100 | No |
Name of the account level locale. |
| acct_locale_no_2 | long | 30 | No |
Aria-assigned unique identifier of the locale used for translations. This value is unique across all Aria-managed accounts. |
| total_contract_count | long | 30 | No |
Returns a total count of the number of contracts. |
| filtered_contract_count | long | 30 | No |
Returns a count of the number of contracts based on the filtered status code selection. |
all_acct_contracts_m.contract_plan_instance_info.contract_rollover_custom_rate_info fields
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| custom_rate_plan_instance_no | long | 22 | No |
Plan instance for which the custom rates will be used at the completion of the contract. |
| custom_rate_client_plan_instance_id | string | 22 | No |
Client-defined ID of the plan instance for which the custom rates will be used at the completion of the contract. |
| custom_rate_service_no | long | 22 | No |
Service number for the new custom rate |
| custom_client_rate_service_id | string | 22 | No |
Unique client-defined identifier for the custom rate service number. |
| custom_rate_seq_no | string | 22 | No |
Sequence number for this line of the rate schedule. |
| custom_rate_from_unit | string | 22 | No |
Tiered pricing, "FROM" unit. |
| custom_rate_to_unit | string | 22 | No |
Tiered pricing, "TO" unit. |
| custom_rate_per_unit | string | 22 | No |
Rate to charge per unit on this tier. |
all_acct_contracts_m.contract_plan_instance_info fields
| Name | Type | Length | Required | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| plan_instance_no | long | 22 | No |
The unique numberic identifier of the plan instance.. |
||||||||||
| plan_name | string | No |
The name of the plan this line represents |
|||||||||||
| client_plan_instance_id | string | 100 | No |
Unique client-defined ID for each assigned master plan. |
||||||||||
| plan_instance_status_cd | long | 8 | No |
The status code of the plan instance associated with this account. Allowed values:
|
||||||||||
| plan_instance_status_label | string | 32 | No |
This is the status for each plan instance associated with the contract. (ex: Active, Terminated etc.). |
||||||||||
| invoiced_contract_period | long | 8 | No |
The number of full months of the contract period that have already been billed. If last month is not a whole month, it is considered as one month. |
||||||||||
| invoiced_billing_cycle | long | 8 | No |
The number of full billing cycles that have been invoiced and that cover a portion or the whole period of the contract. |
||||||||||
| remaining_contract_period | long | 8 | No |
The remaining number of full months of the contract yet to be billed. If last month is not a whole month, it is considerd as one month. |
||||||||||
| remaining_billing_cycle | long | 8 | No |
A projected number of full billing cycles to be billed that would cover the remaining period of the contract. |
||||||||||
| rollover_plan_no | long | 22 | No |
Note that if the target rollover plan has a surcharge that has already been associated with this account, when the plan rollover occurs at the completion of this contract, the surcharge for this plan may be ignored (depending on the client parameter determining whether duplicate surcharges are permitted). The surcharge at the account level will remain in effect. |
||||||||||
| rollover_client_plan_id | string | 22 | No |
Note that if the target rollover plan has a surcharge that has already been associated with this account, when the plan rollover occurs at the completion of this contract, the surcharge for this plan may be ignored (depending on the client parameter determining whether duplicate surcharges are permitted). The surcharge at the account level will remain in effect. |
||||||||||
| rollover_rate_sched_no | long | 22 | No |
Pre-defined rate schedule to be used as the rollover rate schedule at the completion of the contract |
||||||||||
| rollover_client_rate_sched_id | string | 22 | No |
Client-defined ID of the pre-defined rate schedule to be used as the rollover rate schedule at the completion of the contract |
||||||||||
| contract_rollover_custom_rate_info | object | No |
all_acct_contracts_m fields
| Name | Type | Length | Required | Description | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| contract_no | long | No |
Aria-assigned unique contract identifier. |
|||||||||||||||
| client_contract_id | string | 100 | No |
Client assigned unique contract identifier |
||||||||||||||
| contract_scope | string | No |
Specifies the scope of plan subscription coverage enforced by the contract. |
|||||||||||||||
| type_no | long | No |
The type of contract end action to be enforced by this contract. Allowed values:
|
|||||||||||||||
| length_months | long | No |
Note: This field is deprecated. Aria no longer supports length_months. |
|||||||||||||||
| cancel_fee | double | No |
Fee to be charged if the plan instance is cancelled by the account holder. For a multi-plan contract, this will be applicable only when the last remaining plan instance is cancelled prior to the contract's end date. |
|||||||||||||||
| create_comments | string | No |
CSR or API-provided comments provided at time of contract creation. |
|||||||||||||||
| update_comments | string | No |
Comments provided at time of last contract update. |
|||||||||||||||
| create_date | string | 14 | No |
The date the contract was created. |
||||||||||||||
| update_date | string | 14 | No |
The date the contract was last modified. |
||||||||||||||
| start_date | string | 14 | No |
Specifies contract start date. The date is in the format yyyy-mm-dd. |
||||||||||||||
| end_date | string | 14 | No |
Contract end date. |
||||||||||||||
| status_code | long | No |
Status code of this contract. Allowed values:
|
|||||||||||||||
| contract_plan_instance_info | object | No | ||||||||||||||||
| duration_type | long | 1 | No |
Indicator which determines whether the contract duration in length is based on months, weeks or days. Allowed values:
|
||||||||||||||
| duration_length | long | No |
The contract duration in length that the given contract will be in effect from the start date. |
|||||||||||||||
| renewal_duration_type | long | 1 | No |
Indicator which determines whether the contract renewal duration in length is based on months, weeks or days. Allowed values:
|
||||||||||||||
| renewal_duration_length | long | No |
The contract renewal duration in length that the given contract will be in effect from the renewal start date. |
|||||||||||||||
| renewal_end_date | string | No |
Date on which the renewal contract ends. Date format is YYYY-MM-DD. For the new contract type '9-Renew contract with different duration', it is mandatory to pass the either the renewal_end_date or the renewal_duration_type and renewal_duration_length. If both are passed, renewal_duration_length will take the precedence over the renewal_end_date. |