This API Gets the hierarchy of plans for a given client. It Provides the ability to filter the results to return the catalog hierarchy by promo code, parent plan number, client parent plan ID. Each filter can be used independently or in combination to provide control on reading the catalog. The intent of this API is to give a developer more control on reading the plan hierarchy.
Error Codes:
| Error Code/Description |
Associated Inputs |
|
|
|
1004: authentication error
Associated Inputs: auth_key, client_id, client_no
|
<auth_key>, <client_no> |
1033: a parameter that represents a true or false value contains invalid input
Associated Inputs: alt_collect_on_approve, alt_send_statement_on_approve, cancel_orders_on_discard, cascade_action, do_auto_discard, do_collect, change_status_after_coll, reset_dates_after_status, disable_existing_on_update, do_write, exclude_terminated_plan_inst, include_all_rate_schedules, include_plan_hierarchy, retrieve_bundled_nso, retrieve_included_nso, include_translations, include_inactive_items, include_invoice_activity_eligibility, include_rs_summary, include_translations, include_service_supp_fields/include_product_fields/, include_plan_instance_fields/include_plan_services/, include_surcharges, include_void_transactions, include_voided, invoice_unbilled_usage, is_unlinked_refund, record_cc_on_auth_failure, retrieve_excluded_usage, send_email, usage_pooling, do_write
|
<include_plan_hierarchy> |
1066: Locale name does not exist in the system.
Associated Inputs: locale_name
|
<locale_name> |
1067: Locale no does not exist in the system.
Associated Inputs: locale_no, master_plan_instance_no
|
<locale_name> |
5067: limit must be between 1 and 999.
Associated Input: limit, record_limit, contract_limit
|
<limit> |
5068: offset must be greater than or equal to zero.
Associated Input: offset, contract_offset
|
<offset> |
Additional Guidance:
Input Fields
| Field Name: |
Notes: |
| <limit> |
If no value specified, the default is 100.
Example: If you have 100 plans and you pass 50 into this field, Aria will return your first 50 plans ordered by <plan_no>. You can also identify which specific plans to return by passing a value into the <offset> field as described below.
|
| <offset> |
If no value specified the default is 0.
Example: If you have 100 plans and you pass 30 into the <limit> field and 50 into the <offset> field, Aria will return 30 plans - plans 51 to 80, ordered by <plan_no>.
Note: If you want to retrieve more than 999 plans, you will need to call this API more than once, with a different <offset> value each time (to skip previously-returned plans).
|
| <include_plan_hierarchy> |
Allowable values
| Values |
Description |
| true |
true |
| false (Default) |
|
| <include_parent_plan_list> |
Allowable values
| Values |
Description |
| true (Default) |
true (Default) |
| false |
false |
|
| <include_child_plans_list> |
Allowable values
| Values |
Description |
| true (Default) |
true (Default) |
| false |
false |
|
| <include_total_count> |
Allowable values
| Values |
Description |
| true |
true |
| false (Default) |
false (Default) |
|
Output Fields
| Field Name |
Notes |
| <supp_plan_ind> |
Allowable values
| Values |
Description |
| 0 |
Plan is NOT a Supplemental Plan |
| 1 |
Plan is a Supplemental Plan |
|
