Skip to main content
Aria Knowledge Central

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:

Value Description
0 Inactive
1 Active
Null Do not filter by status (default)
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:

Value Description
False Plan instances with Terminated status will be returned. (default)
True No plan instances with Terminated status will be returned.
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:

Value Description
0 do not return contract billing values(default)
1 return contract billing 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

See fields below

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:

Value Description
1 Active
2 Active Pending
3 Terminate Pending
-1 Terminated
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

See fields below

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:

Value Description
2 Continue existing service without contract
3 Renew existing contract automatically
6 Terminate service and billing
7 Terminate service and billing and prorate final invoice
8 Rollover to a different plan/rate/custom rates (applicable only for multi-plan contracts)
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:

Value Description
-3 Contract no longer in scope, usually due to mid-contract plan change on account.
-2 Terminated. Contract cancelled by client or system.
-1 Cancelled. Contract cancelled by end user.
0 Contract completed and renewed. New contract record refers to this contract record.
1 In Effect. Contract is currently active.
99 Completed. Contract is completed, no renewal.
contract_plan_instance_info object   No

See fields below

duration_type long 1 No

Indicator which determines whether the contract duration in length is based on months, weeks or days.

Allowed values:

Value Description
1 Days
2 Weeks
3 Months (default)
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:

Value Description
1 Days
2 Weeks
3 Months (default)
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.

TOP
  • Was this article helpful?