Use this API to return a list of all plan, (including services, rate schedule details, and supplemental fields), available for assignment on a particular account. Available plans mean any master plans to create a new master plan instance(s), and any child plans (supplemental plans) of a master or supplemental plan that are available for assignment on the plan instances referred to as parent_plan_instance_no in the output array for this API.
For error messages generated by this API, see get_avail_plans_for_acct_all_m Error Messages.
Req | Field Name | Field Type | Max Length | Description | |
---|---|---|---|---|---|
client_no | long | 22 | Aria-assigned unique identifier indicating the Aria client providing service to this account. | ||
auth_key | string | 32 | Aria-assigned unique key to be passed with each method call for authenticating the validity of the requestor. | ||
acct_no | long | 22 | Aria-assigned account identifier. This value is unique across all Aria-managed accounts. | ||
OR | |||||
client_acct_id | string | 50 | Client-defined account identifier. | ||
plan_instance_no | long | 22 | The unique identifier of the plan instance (can be either a master or supplemental plan) under which a new plan can be assigned. If NULL, retrieves any child plans (including services, and default rate schedules) available for assignment associated with an account's master plan instance(s), along with returning All available master plans (including services, and default rate schedules) available for assignment. | ||
OR | |||||
client_plan_instance_id | string | 100 |
|
||
promo_cd | string | 30 | Limits the list of master plans available for assignment based on the associated promo code. | ||
include_full_plan_hierarchy_plans | string | 5 | Use this input parameter to additionally return plans available for assignment to all the supplemental plan instances in the hierarchy (i.e. child supplemental plan instances, grandchild supplemental plan instances, etc,) of the given plan_instance_no / client_plan_instance_id. This input is ignored if plan_instance_no / client_plan_instance_id is not passed. Allowable Values | ||
include_rs_summary | string | 5 | If set to "true", will retrieve summary level rate schedule information for all the rate schedules that are associated with a particular plan. If left blank, will default to "false". Allowable Values | ||
locale_no | long | 22 | Aria-assigned Locale identifier. This value is unique across all Aria-managed accounts. | ||
OR | |||||
locale_name | string | 100 | Name of the locale. | ||
alt_caller_id | string | 30 | Person or process that submitted the API call. This can be someone's user ID, or the name of an application. | ||
optional_transaction_qualifiers | array | Array of additional values you can associate with this API call. | |||
![]() |
string | 100 | Name of the field you want to associate with this API call. | ||
![]() |
string | 100 | Corresponding value of the field you want to associate with this API call. |
Field Name | Field Type | Description |
---|---|---|
error_code | long | Aria-assigned error identifier. 0 indicates no error. |
error_msg | string | Description of any error that occurred. "OK" if there was no error. |
all_client_plans_services | hash | |
![]() |
long | This references the master / supplemental plan instance to which this supplemental plan can be assigned to. If the current record's plan is a master plan, this field will be empty as the master plan will be assigned at the account level. |
![]() |
string | This references the master / supplemental plan's client-defined plan instance identifier to which this supplemental plan can be assigned to. If the current record's plan is a master plan, this field will be empty as the master plan will be assigned at the account level. |
![]() |
long | Aria-assigned unique plan identifier |
![]() |
string | Client assigned unique plan identifier |
![]() |
string | Plan Name |
![]() |
string | Text description of this plan |
![]() |
long | Indicates whether or not this plan is a supplemental plan. Allowable Values |
![]() |
long | Indicates whether or not this plan is billable. This applies to Master Plans only. Supplemental Plans inherit this property from their associated Master Plans. Allowable Values |
![]() |
long | Indicates whether or not the plan is marked as "displayable". 0 means not displayable. 1 means displayable. Allowable Values |
![]() |
long | Number of months in which the account will change from the current plan to the pre-defined rollover plan. |
![]() |
long | Pre-defined plan to which the account will change based on the defined rollover_months value; the rollover record is created when an account is placed on a plan with a defined rollover plan. |
![]() |
string | Pre-defined client rollover plan ID to which the account will change based on the defined rollover_months value; the rollover record is created when an account is placed on a plan with a defined client rollover plan ID. |
![]() |
double | Fee charged for early cancellations. |
![]() |
long | Number of months during which early cancellation fees would apply on plan cancellation. This field is only applicable for master plans. |
![]() |
long | Pre-defined period in days in which an account will degrade to Suspended status (-1) if action is not taken such as a plan or status change. |
![]() |
long | The status code to assert for the new account. Allowable Values |
![]() |
long | Status used for the master plan instance at the completion of the rollover period. Allowable Values |
![]() |
long | Number of days in which an account will change from the initial status code to the pre-defined rollover status code. |
![]() |
long | Initial free months. |
![]() |
long | Plan to assign when an account on this plan is suspended. |
![]() |
string | Client-defined Plan identifier to assign when an account on this plan is suspended. |
![]() |
long | Default notification method given to an account that is assigned to this plan. Allowable Values |
![]() |
long | Indicates whether or not this plan is prepaid Allowable Values |
![]() |
string | The 3-character ISO-compliant currency code in lowercase for monetary values used in the context of this API method. |
![]() |
long | Duration of the plan rollover period (used in conjunction with rollover_plan_uom_cd). |
![]() |
long | Units associated with the duration of the plan rollover period (used in conjunction with rollover_plan_duration). Allowable Values |
![]() |
long | Duration of the initial free period (used in conjunction with init_free_period_uom_cd). |
![]() |
long | Units associated with the duration of the initial free period (used in conjunction with init_free_period_duration). Allowable Values |
![]() |
long | Default status used when master plan is initially assigned on an account. Allowable Values |
![]() |
long | Duration of the plan status rollover period, after which the initial plan status on the master plan instance will change to the pre-defined rollover plan status (used in conjuction with rollover_plan_status_uom_cd). |
![]() |
long | Units associated with the duration of the plan status rollover period after which the initial plan status on the master plan instance will change to the pre-defined rollover plan status. (used in conjunction with rollover_plan_status_duration). Allowable Values |
![]() |
long | Status used for the master plan instance at the completion of the plan status rollover period. Allowable Values |
![]() |
hash | A multidimensional array of Services for this plan |
![]() |
long | Aria assigned service number. |
![]() |
string | Description of this service |
![]() |
long | Indicates whether or not this service is a recurring service Allowable Values |
![]() |
long | Indicates whether or not this service is a usage-based service Allowable Values |
![]() |
long | The usage type supported by this usage based service |
![]() |
long | Indicates whether or not this service is taxable Allowable Values |
![]() |
long | Indicates whether or not this service is a tax-based service Allowable Values |
![]() |
long | Indicates whether or not this service is an arrears-based service Allowable Values |
![]() |
long | Indicates whether or not this service is a setup-based service Allowable Values |
![]() |
long | Indicates whether or not this service is a miscellaneous service Allowable Values |
![]() |
long | Indicates whether or not this service is a donation-based service Allowable Values |
![]() |
long | Indicates whether or not this service is an order-based service Allowable Values |
![]() |
long | Indicates whether or not this service is a cancellation- based service Allowable Values |
![]() |
string | Chart of accounts ID |
![]() |
string | This field is deprecated in favor of coa_id |
![]() |
string | The client-defined override for coa_id |
![]() |
long | Indicates if this service is displayable or not Allowable Values |
![]() |
long | The Tiered Pricing Rule Allowable Values |
![]() |
long | Indicates whether or not this service is a minimum fee. Allowable Values |
![]() |
string | The client-defined Service ID for this plan. |
![]() |
string | Denotes which usage type to record. |
![]() |
hash | |
![]() |
string | The machine-readable name of this field |
![]() |
string | The human-readable name of this field |
![]() |
long | The sort order of this field |
![]() |
string | The value stored in this field |
![]() |
long | Indicates if the service is Fulfillment Based or not. |
![]() |
long | The Aria-assigned unique identifier for the origin location for the service. |
![]() |
string | The client-defined location identifier for the origin location for the service. |
![]() |
string | The name of the origin location for the service. |
![]() |
string | Company name of the service location. |
![]() |
string | First address line of the service location. |
![]() |
string | Second address line of the service location. If you want to delete existing data in this field, leaving it blank, you must enter a '~' in this field. |
![]() |
string | Third address line of the service location. |
![]() |
string | City of the service location. |
![]() |
string | Locality of the service location. |
![]() |
string | State or Province of the service location. The official postal-service codes for all United States, Australia and Canada states, provinces, and territories. This field does not support states, provinces or territories from other countries. Use the locality field for other countries. |
![]() |
string | Country of the location contact. The ISO-compliant 2-character country code abbreviation in uppercase. |
![]() |
string | Postal/Zip code for the service location address. |
![]() |
hash | Represents the rates for the default rate schedule for the default currency for the plan |
![]() |
long | Sequential number in the rate schedule for dertermining tiers |
![]() |
double | Tiered Units (from) This value represents the start of a tiered range of values. |
![]() |
double | Tiered Units (to) This value represents the end of the range for a single tier of values. |
![]() |
double | The cost per unit of this service over the time period the plan is billed for |
![]() |
double | The future cost per unit of this service over the time period the plan is billed for |
![]() |
double | If the plan interval is more than one month, this field will rate per unit per month |
![]() |
string | Client assigned unique rate schedule number |
![]() |
string | Rate Tier Description |
![]() |
hash | All rates for all rate schedules and currencies for this plan |
![]() |
long | Rate schedule number |
![]() |
string | Client assigned unique rate schedule number |
![]() |
long | Indicates whether future rates are captured or not. Allowable Values |
![]() |
string | Future Change Date of the rates. |
![]() |
long | Aria internal ID of follow-up default rate schedule |
![]() |
string | Client-defined ID of followup rate schedule |
![]() |
hash | Represents the rates for the default rate schedule for the default currency for the plan |
![]() |
long | Sequential number in the rate schedule for dertermining tiers |
![]() |
double | Tiered Units (from) This value represents the start of a tiered range of values. |
![]() |
double | Tiered Units (to) This value represents the end of the range for a single tier of values. |
![]() |
double | The cost per unit of this service over the time period the plan is billed for |
![]() |
double | The future cost per unit of this service over the time period the plan is billed for |
![]() |
double | If the plan interval is more than one month, this field will rate per unit per month |
![]() |
string | Client assigned unique rate schedule number |
![]() |
string | Rate Tier Description |
![]() |
string | The human-readable name of this usage type |
![]() |
string | The long description of this usage type |
![]() |
string | Client-assigned identifier for the type of usage being recorded. |
![]() |
string | The display-level description of the units this usage represents. |
![]() |
long | Indicates whether or not this usage-based service is rated on a daily basis. Allowable Values |
![]() |
long |
Indicator that states whether a taxable service is tax-inclusive or tax-exclusive. Allowable Values |
![]() |
hash | An array of the rate schedules for the requested plan |
![]() |
long | The ID of this rate schedule |
![]() |
string | Client assigned unique rate schedule number |
![]() |
string | The name of this rate schedule |
![]() |
string | The currency this rate schedule is linked to |
![]() |
long | Number of months between billing cycles for recurring |
![]() |
long | Number of months between billing cycles for usage |
![]() |
long | Period type for billing cycles for recurring. Allowable Values |
![]() |
long | Period type for billing cycles for usage. Allowable Values |
![]() |
long | If true, this is the default rate schedule for the default currency Allowable Values |
![]() |
long | If true, this is the default rate schedule for the specified currency Allowable Values |
![]() |
long | Determines whether the rate schedule is displayable Allowable Values |
![]() |
string | Start date of rate schedule |
![]() |
string | End date of rate schedule |
![]() |
long | Aria internal ID of follow-up default rate schedule |
![]() |
string | Client-defined ID of followup rate schedule |
![]() |
long | Pre-defined plan to be used as the rollover plan at the completion of the contract. |
![]() |
string | Client-defined ID of the pre-defined plan to be used as the rollover plan at the completion of a contract. |
![]() |
hash | |
![]() |
long | Current rate schedule for which the rollover rate schedule will be used at the completion of the contract |
![]() |
string | Client-defined ID of the current rate schedule for which the rollover rate schedule will be used at the completion of the contract |
![]() |
long | Pre-defined rate schedule to be used as the rollover rate schedule at the completion of the contract |
![]() |
string | Client-defined ID of the pre-defined rate schedule to be used as the rollover rate schedule at the completion of the contract |
acct_locale_no | long | Aria-assigned unique identifier of the locale used for translations. This value is unique across all Aria-managed accounts. |
acct_locale_name | string | Name of the account level locale. |