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. |
plan_no | long | 22 | Unique Aria-assigned plan number. Provide a value for this field to filter the list of plans returned. | |
OR | ||||
client_plan_id | string | 100 | Client-defined Plan ID for which to query available child plans | |
acct_no | long | 38 | Unique Aria-assigned account number. Provide a value for this field to filter the list of plans returned. | |
OR | ||||
client_acct_id | string | 50 | Client-defined account identifier. | |
promo_code | string | 30 | Provide a value for this field to filter the list of plans return. This code is provided during registration and generally provides access to a custom set of reduced-rate plans. | |
parent_plan_no | long | 22 | Unique Aria-assigned plan number. Provide a value for this field to filter the list of plans returned. | |
OR | ||||
client_parent_plan_id | string | 100 | Client-defined unique parent Plan ID | |
supp_field_names | string array | An array of client-defined product field names. Provide a value for this field to filter the list of plans returned. | ||
supp_field_values | string array | An array of client-defined product field values paired with the provided product field names above. Provide a value for this field to filter the list of plans returned. | ||
include_all_rate_schedules | string | 5 | If set to "true", will retrieve all of the rates and rate schedules associated with a particular plan. If left blank, will default to "false". Allowable Values | |
include_plan_hierarchy | string | 5 | You can use this input parameter to specify whether to retrieve the child plans associated with the returned plans or with the plan_no or parent_plan_no that you specified. If you set the include_plan_hierarchy parameter to true , then all of the child plans down to the bottom level of your plan hierarchy will be returned. Allowable Values | |
retrieve_bundled_nso | string | 5 | If set to "true", will retrieve all of the bundled inventory items associated with a particular plan. If left blank, will default to "false". Allowable Values | |
retrieve_included_nso | string | 5 | If set to "true", will retrieve all of the inventory items associated with a particular plan. If left blank, will default to "false". Allowable Values | |
locale_no | long | 22 | Aria-assigned unique identifier of the locale used for translations. This value must be unique across all Aria clients. | |
OR | ||||
locale_name | string | 50 | Name of the locale. | |
include_translations | string | 5 | Setting this flag as True will fetch the translated fields in all the locales defined. If not passed it defaults to False. Allowable Values |
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_plan_dtls | hash | A multidimensional array containing all client plans. |
![]() |
long | Aria-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. |
![]() |
double | Fee charged for early cancellations. |
![]() |
long | Number of months during which early cancellation fees would apply on plan cancellation. |
![]() |
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 | Default status for new accounts created on this plan. 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. |
![]() |
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. |
![]() |
string | Client assigned unique plan identifier |
![]() |
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. |
![]() |
string | Indicates whether to defer the pro-rated charges to the next anniversary date or to create a seperate invoice immediately. Allowable Values |
![]() |
string | 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). |
![]() |
string | 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 |
![]() |
long | Scope of additional NSO as part of inclusion list. Allowable Values |
![]() |
hash | A multidimensional array of Services for this plan |
![]() |
long | The services for this plan |
![]() |
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 |
![]() |
hash | Non-Subscription Offerings inclusion list that is in addition to NSOs that are bundled with the plan |
![]() |
long | Inventory item number |
![]() |
long | Inventory item status. Allowable Values |
![]() |
hash | A grouping of plans which can be used for plan assignment |
![]() |
long | The ID of this plan group |
![]() |
string | The name of this plan group |
![]() |
string | The long description of this plan group |
![]() |
string | Determines where the plan groups are made available Allowable Values |
![]() |
long | Whether or not this plan group is selectable Allowable Values |
![]() |
string | Client-defined ID for this plan group |
![]() |
hash | A grouping of plans based on promo code |
![]() |
long | The ID of this promotional plan set |
![]() |
string | The name of this promotional plan set |
![]() |
string | The long description of this promotional plan set |
![]() |
hash | The promo codes associated with this group of plans |
![]() |
string | The promo code itself |
![]() |
string | A long description of this promo code |
![]() |
string | Client-defined ID of this promotional plan set |
![]() |
hash | The plans which are mapped as parents of this plan |
![]() |
long | ID of the parent plan |
![]() |
string | Name of the parent plan |
![]() |
string | Client-defined unique parent Plan ID |
![]() |
hash | Supplemental object fields associated with this plan |
![]() |
long | Supplemental object field ID |
![]() |
string | Name of the supplemental field. This value is required if you want to assign supplemental fields. For example, if you have any accounts that are tax-exempt or international, you must set up corresponding account supplemental fields prior to your tax provider configuration. Create fields for the tax exemption number and for the VAT ID used by the tax provider. |
![]() |
string | Description of the supplemental object field |
![]() |
string | The value in this supplemental field on the plan |
![]() |
string | If true, this plan met the initial filtering criteria used to retrieve this list of plans. If false, this plan is a child plan (or other decendant) of a plan which met the initial criteria Allowable Values |
![]() |
hash | The plans which are mapped as children of this plan |
![]() |
long | Aria generated unique ID of the plan. |
![]() |
string | Client-defined unique ID for the plan. |
![]() |
long | Determines if this child plan must be purchased along with the parent plan. Allowable Values |
![]() |
string | Determines if this child plan must be added to the purchase plan list in the UI. Allowable Values |
![]() |
long | Determines the minimum number of units that must be purchased. |
![]() |
string | Determines the maximum number of units that can be purchased. |
![]() |
string | Determines the level at which the minimum and maximum values are enforced. Allowable Values |
![]() |
hash | Non-Subscription Offerings that are bundled with the plan. |
![]() |
long | Inventory item number that is bundled with the plan |
![]() |
long | Inventory item status. Allowable Values |
![]() |
string | Minimum NSO quantity needed during plan purchase |
![]() |
string | Maximum NSO quantity needed during plan purchase |
![]() |
long | Scope of bundled NSO during plan purchase. Allowable Values |
![]() |
hash | Overridden prices for NSO items. |
![]() |
long | The internal Id of the rate schedule (DEPRECATED; use list_rate_schedule_no) |
![]() |
string | Client assigned unique rate schedule number (DEPRECATED; use client_list_rate_schedule_id) |
![]() |
string | Currency code for Inventory item. |
![]() |
string | Overridden price for Inventory item for currencies. |
![]() |
long | Aria-assigned unique identifier for the rate schedule to be used as the list price for the NSO when purchased with this plan. |
![]() |
string | Client-defined unique identifier for the rate schedule to be used as the list price for the NSO when purchased with this plan. |
![]() |
string | Aria-assigned unique identifier for the rate schedule to be used as the bundle price for the NSO when purchased with this plan. |
![]() |
string | Client-defined unique identifier for the rate schedule to be used as the bundle price for the NSO when purchased with this plan. |
![]() |
hash | Non-Subscription Offerings that are bundled with the plan as part of NSO group |
![]() |
long | Inventory item number that is bundled with the plan |
![]() |
long | Inventory item status. Allowable Values |
![]() |
hash | Overridden prices for NSO items. |
![]() |
long | The internal Id of the rate schedule (DEPRECATED; use list_rate_schedule_no) |
![]() |
string | Client assigned unique rate schedule number (DEPRECATED; use client_list_rate_schedule_no) |
![]() |
string | Currency code for Inventory item. |
![]() |
string | Overridden price for Inventory item for currencies. |
![]() |
string | Aria-assigned unique identifier for the rate schedule to be used as the bundle price for the NSO when purchased with this plan. |
![]() |
string | Client-defined unique identifier for the rate schedule to be used as the bundle price for the NSO when purchased with this plan. |
![]() |
string | Minimum NSO quantity needed during plan purchase for the NSO group. |
![]() |
string | Maximum NSO quantity needed during plan purchase for the NSO group. |
![]() |
string | Scope of bundled NSO group during plan purchase. Allowable Values |
![]() |
hash | |
![]() |
long | Aria-assigned unique plan identifier |
![]() |
string | Name of the locale. |
![]() |
string | The short name of this plan. |
![]() |
string | The long description of this plan. |
![]() |
long | Aria-assigned unique identifier of the locale used for translations. This value must be unique across all Aria clients. |
![]() |
hash | |
![]() |
long | The unique ID for the service this line represents. |
![]() |
string | The name of the service this line represents. |
![]() |
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 |
![]() |
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 |
![]() |
string | Rate Tier Description |
![]() |
string | Rate Tier Description |
![]() |
string | The human-readable name of this usage type |
![]() |
string | The long description of this usage type |
![]() |
string | The display-level description of the units this usage represents. |
![]() |
hash | Supplemental object fields associated with this plan |
![]() |
long | Supplemental object field ID |
![]() |
string | Name of the supplemental field. This value is required if you want to assign supplemental fields. For example, if you have any accounts that are tax-exempt or international, you must set up corresponding account supplemental fields prior to your tax provider configuration. Create fields for the tax exemption number and for the VAT ID used by the tax provider. |
![]() |
string | Description of the supplemental object field |
![]() |
string | The value in this supplemental field on the plan |