Skip to main content
Aria Knowledge Central

edit_plan_m Guide

Edit a service plan for specified client.

API Specification:

edit_plan_m

Required Fields:
  • <client_no>
  • <auth_key>
  • <plan_no> or <client_plan_id>
  • <schedule> (array)
    • <schedule_name>
    • <currency_cd>
    • <is_default>
  • <service> (array)
    • <service_type>
    • <tier> (array)
      • <schedule> (array)
        • <amount>

Additional Guidance

Input Fields 
Field Name Notes
<plan_type>
Allowable Values
Values Description
Master Recurring Plan This type creates a Master Recurring Plan
Master Pre-paid Plan This type creates a Master Pre-paid Plan
Master Free Plan This type creates a Master Free Plan
Supplemental Recurring Plan This type creates a Supplemental Recurring Plan
Supplemental Free Plan This type creates a Supplemental Free Plan
<active>
Allowable Values
Values Description
0 Inactive
1 Active
<rollover_plan_uom_cd>
Allowable Values
Values Description
1 Day
2 Week
3 Month
4 Quarter
5 Year
<init_free_period_uom_cd>
Allowable Values
Values Description
1 Day
2 Week
3 Month
4 Quarter
5 Year
<rollover_plan_status_uom_cd>
Allowable Values
Values Description
1 Day
2 Week
3 Month
4 Quarter
5 Year
<apply_cancellation>
Allowable Values
Values Description
Yes If set as Yes, minimum cancellation service can be added
No If set as No, minimum cancellation service cannot be added
<apply_minimum_fee>
Allowable Values
Values Description
Yes If set as Yes, minimum fee service can be added
No If set as No, minimum fee service cannot be added
<how_to_apply_min_fee>
Allowable Values
Values Description
0 All Invoices
1 After first invoice
<is_default>
Allowable Values
Values Description
1, true/TRUE/t, yes/y Yes, this currency is the default.
0, false/FALSE/f, no/n No, this currency is not the default. 
<future_rate>
Allowable Values
Values Description
1, true/TRUE/t, yes/y Yes, future rates are supported..
0, false/FALSE/f, no/n No, future rates are not supported.
<service_type>
Allowable Values
Values Description
Usage Based Creates a Usage Based service
Recurring Creates a Recurring service
Activation Creates a Activation service
Order-Based Creates a Order-Based service
Cancellation Creates a Cancellation service
Minimum Fee Creates a Minimum Fee service
Recurring Arrears Creates a Recurring Arrears service
<rate_type>
Allowable Values
Values Description
Flat Rate Applies Flat Rate type pricing to the rate schedule
Tiered Pricing Applies Tiered Pricing to the rate schedule
<pricing_rule>
Allowable Values
Values Description
Standard Standard Pricing
Volume Discount Volume Discount Pricing
Flat Rate Per Tier Flat Rate Per Tier Pricing
<high_water>
Allowable Values
Values Description
1 Enables high water indicator for the particular service
0 Doesn't enable high water indicator for the particular service
<tax_inclusive_ind>
Allowable Values
Values Description
0, false/FALSE/f, no/n No, applied rate does not include taxes.
1, true/TRUE/t, yes/y Yes, applied rate includes taxes.
<notice_dest_type>
Allowable Values
Values Description
S Master Plan Instance level threshold
C Client level threshold
<notice_balance_type>
Allowable Values
Values Description
MTD Month-To-Date balance type
PTD Period-To-Date balance type
<values>
Allowable Values
Values Description
1 1
2 2
3 3
4 4
<fulfillment_based_ind>
Allowable Values
Values Description
0 Not a fulfillment based service
1 Fulfillment based service
<usage_rating_time_ind>
Allowable Values
Values Description
0 Refers to the setting you have on client parameter "Automatically Rate Un-rated Usage Records at Load Time"
1 At Loading Time
2 At Invoicing Time
<usage_record_rating_level_ind>
Allowable Values
Values Description
0 Aggregated Records
1  Individual Records
<usage_record_taxation_level_ind>
Allowable Values
Values Description
0 Aggregated Records
1  Individual Records
<expire_on_paid_through>
Allowable Values
Values Description
0 No
1 Yes
<reset_on_update>
Allowable Values
Values Description
0 No
1 Yes
<is_mandatory>
Allowable Values
Values Description
0 Non Mandatory
1 Mandatory
<include_default>
Allowable Values
Values Description
0 No
1 Yes
<enforcement_level>
Allowable Values
Values Description
0 For each parent plan unit or Instance individually (default)
1 In aggregate across all units and instances of this parent plan on the Account
<proration_invoice_timing_cd>
Allowable Values
Values Description
I Immediate
A Next anniversary date
<plan_instance_status_cd>
Allowable Values
Values Description
1 Active
61 Active Non Billable
41 Active trial
31 Installation Pending
<field_category_directive>
Allowable Values
Values Description
1 Adds a field_category to the plan
2 Deletes the field_category from the plan
<edit_directives>
Allowable Values
Values Description
1 Delete data that is not passed in the request (default)
2 Insert or update data passed but DO NOT delete data not passed
3 Delete everything that is passed.
<nso_incl_list_scope>
Allowable Values
Values Description
0 All non-restricted inventory items (default).
1 Existing bundled and non-restricted inventory items.
2 Existing bundled inventory items only.
3 Selected and non-restricted inventory items.
4 Selected specific inventory items.
<nso_group_item_scope>
Allowable Values
Values Description
U Up to Plan Units (default).
M Match Plan Units.
A Any Units.
<item_scope>
Allowable Values
Values Description
U Up to Plan Units (default).
M Match Plan Units.
A Any Units.
<subscription_type>
Allowable Values
Values Description
N New Subscription
E Existing Subscription
<effective_directive>
Allowable Values
Values Description
N Effective Prior to Next Batch Billing Run
A On Account Billing Anniversary Date

Error Codes

Error Code/Description Associated Inputs

1001: unexpected error

 

1010: missing required parameters, Missing input: (object-name) is required with assignment_directive ($AriaNo)

Associated Inputs: all required inputs, typically one of the following: custom_rate_per_unit, custom_rate_seq_no, status_cd, dunning_state, userid, acct_no, client_acct_id, assignment_directive, billing_group_no, client_billing_group_id, threshold_billing_rule_no, client_threshold_billing_rule_id

Alternate Message Output

1010: username is required
1010: first name is required
1010: last name is required
1010: email is required
1010: roles are required

Associated APIs: create_user_m, get_user_details_m, delete_user_m, update_user_m

Associated Inputs: username, first_name, last_name, email, role_no

<plan_no> or <client_plan_id>

1016: invalid input, acct_no: (acct_no) is not a valid long, assignment_directive: (assignment_directive) is not a valid long, “billing_group_no: (billing_group_no) is not a valid long, threshold_billing_rule_no: (threshold_billing_rule_no) is not a valid long

Associated Inputs: alt_service_no_to_apply, assignment_directive, auto_skip_to_next_bill_date, client_billing_group_id, custom_rate_service_no/custom_rate_client_service_id, plan_instance_no, plan_instance_service_no, client_plan_instance_id, client_plan_instance_service_id, plan_instance_no, plan_instance_service_no, client_plan_instance_id, client_plan_instance_service_id, plan_instance_service_no, eligible_plan_no, eligible_service_no, email, force_master_bill_date_reset, fulfillment_only, include_master_plans, include_supp_plans, include_billing_groups, include_payment_methods, include_master_plans, include_supp_plans, include_billing_groups, include_payment_methods, invoice_no, length_months, end_date, limit, limit_records, modify_directive, contract_plan_instances_update, modify_directive, contract_plan_instances_update, offset, percent_amount, percent_eval_plan_instance_no, client_percent_eval_plan_instance_id, percent_eval_service_no, client_percent_eval_service_id, phone_ext, work_phone_ext, plan_unit_inst_status_cd, plan_units, reason_code, start_date, end_date, start_date, end_date, status_cd, acct_no, assignment_directive, billing_group_no, threshold_billing_rule_no

Additional Comments:  This error can be caused by the wrong type of input, for example, text in a numbers-only field, an  or specifying a value other than one of the documented allowable values.

  • For the get_order_m API, this is the error code returned when the user passes an invalid order value for the <status_filter_cd> input which is other than the allowed values (0/null, 1, 2, 3, 4 and 5).
  • For the bulk_cancel_order_m API, invalid input can occur with the <order_status_directive> argument. Allowed values are 0, 1, 2, 3, 4/null, 5 and 6.
  • For the get_acct_coupon_details_m API, invalid input can occur with the <include_all_active> input parameter (values are 0, 1 or NULL).

Alternate Message Output

1016: username cannot be longer than 30 characters
1016: first_name cannot be longer than 30 characters
1016: last_name cannot be longer than 30 characters

Associated APIs: create_user_m, update_user_m

Associated Inputs: username, first_name, last_name

<plan_no> or <client_plan_id>, <plan_instance_status_cd>,<fulfillment_based_ind>

1024: invalid date format

Associated Inputs: bill_birthdate, birthdate, degrade_date, initial_credit_date, invoice_line_reversing_date, service_fulfillment_date, queue_date, start_bill_date, end_bill_date, start_date, end_date, stmt_birthdate, bill_birthdate

Additional Comments: All date inputs must be in yyyy-mm-dd format.

<available_start_dt>, <available_to_dt>, <future_change_dt>, <effective_date>

  • Was this article helpful?