Skip to main content
Aria Knowledge Central

create_new_plan_m

Summary

API Name create_new_plan_m
Class administration_services_m
Update Version 5.6

Description

Creates a service plan for specified client

Inputs

Name Type Length Required Description
client_no long 12 Yes

Aria-assigned unique identifier indicating the Aria client providing service to this account.

auth_key string 32 Yes

Aria-assigned unique key to be passed with each method call for authenticating the validity of the requestor.

plan_name string 100 Yes

Specifies Plan Name. Translatable.

plan_description string 3000 No

Specifies plan description. Translatable.

client_plan_id string 100 No

Client defined unique identifier

plan_group int 3 No

Plan Group Number.REST input arrays should be passed in the following format: plan_group[]=2&plan_group[]=3&plan_group[]=4

Alternative field: plan_group_id

plan_group_id string   No

Plan Group Id Number.REST input arrays should be passed in the following format: plan_group_id[]=2&plan_group_id[]=3&plan_group_id[]=4

Alternative field: plan_group

plan_type string   Yes

Specifies Plan Type. Valid values are [ 'Master Recurring Plan', 'Master Pre-paid Plan', 'Master Free Plan', 'Supplemental Recurring Plan', 'Supplemental Free Plan']

Allowed values:

Value Description
Master Recurring Plan Master Recurring Plan
Master Pre-paid Plan Master Pre-paid Plan
Master Free Plan Master Free Plan
Supplemental Recurring Plan Supplemental Recurring Plan
Supplemental Free Plan Supplemental Free Plan
currency string 3 Yes

Specifies the currency code of plan

active int 1 Yes

Specifies if inventory item is active or inactive. Valid values are: 0 - Inactive and 1 - Active

Allowed values:

Value Description
0 Inactive
1 Active
rollover_plan_duration int   No

Duration of the plan rollover period (used in conjunction with rollover_plan_uom_cd).

rollover_plan_uom_cd int   No

Units associated with the duration of the plan rollover period (used in conjunction with rollover_plan_duration).

Allowed values:

Value Description
1 Day
2 Week
3 Month
4 Quarter
5 Year
rollover_plan_no long 100 No

Rollover Plan number

Alternative field: rollover_client_plan_id

rollover_client_plan_id string 100 No

Client defined unique identifier

Alternative field: rollover_plan_no

init_free_period_duration int   No

Duration of the initial free period (used in conjunction with init_free_period_uom_cd).

init_free_period_uom_cd int   No

Units associated with the duration of the initial free period (used in conjunction with init_free_period_duration).

Allowed values:

Value Description
1 Day
2 Week
3 Month
4 Quarter
5 Year
initial_plan_status_cd int   No

Default status used when master plan is initially assigned on an account.

Allowed values:

Value Description
1 Active
31 Pending Installation
32 Pending Activation
41 Trial
61 Active Non-Billable
rollover_plan_status_duration int   No

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).

rollover_plan_status_uom_cd int   No

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).

Allowed values:

Value Description
1 Day
2 Week
3 Month
4 Quarter
5 Year
rollover_plan_status_cd int   No

Status used for the master plan instance at the completion of the plan status rollover period.

dunning_plan_no long 100 No

Specifies dunning plan associated with this plan

Alternative field: dunning_client_plan_id

dunning_client_plan_id string 100 No

Client defined unique identifier

Alternative field: dunning_plan_no

template_no long 8 No

Specifies invoice template class associated with master plan

Alternative field: client_email_template_id

client_email_template_id string 100 No

Client defined unique identifier.

Alternative field: template_no

apply_cancellation string   No

Specifies whether to apply cancellation or not. Valid values: Yes or No. If marked as 'Yes' then should also provide at least one cancellation service

Allowed values:

Value Description
True If set as Yes, minimum cancellation service can be added
False If set as No, minimum cancellation service cannot be added
plan_cancel_min_month int 4 No

Specifies the minimum term months for cancellation service

apply_minimum_fee string   No

Specifies whether to apply minimum fee or not. Valid values: Yes or No. If marked as 'Yes' then should also provide at least one minimum fee service.

Allowed values:

Value Description
True If set as Yes, minimum fee service can be added
False If set as No, minimum fee service cannot be added
how_to_apply_min_fee string   No

Specifies when to apply min fee. Valid values are 0 which means 'All Invoices' and 1 which means 'After first invoice'.

Allowed values:

Value Description
0 All Invoices
1 After first invoice
schedule object   Yes

The schedule associated with this method.

See fields below

service object   Yes

The service associated with this method.

See fields below

resource object   No

The resource associated with this method.

See fields below

arc_service_no long   No

Specifies one of the recurring service for the plan to which the resource is being applied

parent_plans int 12 No

Specifies the parent plans to associate with. This is only applicable for supplemental plans.REST input arrays should be passed in the following format: parent_plans[]=1002&parent_plan[]=1003&parent_plan[]=1004&...

Alternative field: parent_client_plan_ids

parent_client_plan_ids string 100 No

Specifies the parent plans to associate with. This is only applicable for supplemental plans.REST input arrays should be passed in the following format: parent_client_plan_ids[]=1002&parent_client_plan_ids[]=1003&parent_client_plan_ids[]=1004&...

Alternative field: parent_plans

exclusion_plans int 12 No

Specifies the exclusion plans. This is only applicable for supplemental plans. REST input arrays should be passed in the following format: exclusion_plans[]=2&exclusion_plans[]=3&exclusion_plans[]=4&...

supplemental_obj_field object   No

Specifies the supplemental object fields to be added for this usage type

See fields below

template_ind int 1 No

This flag is used to create a plan template. Value of 1 creates the plan as a template. Value of 0 (default) creates a regular plan.

Allowed values:

Value Description
0 Doesn't create a plan as a template
1 Creates a plan as a template
child_plans string   No

If the Plan has child plans, they can be passed in this array. Child plans must be created prior to their use here. Input arrays should be passed in the following format: child_plans[]. New parameter - eligible_child_plans has been added with more fields. This parameter would be deprecate soon.

eligible_child_plans object   No

If the Plan has child plans, they can be passed in this array. Child plans must be created prior to their use here.

See fields below

notification_template_group_no long   No

This field is used to associate an existing notification template group to the plan.

credit_note_template_no long   No

This field is used to associate an existing credit note template to the plan.

credit_memo_template_no long   No

This field is used to associate an existing credit memo template to the plan.

rebill_template_no long   No

This field is used to associate an existing rebill template to the plan.

surcharge_no long 12 No

Specifies the surcharge to associate with this plan. REST input arrays should be passed in the following format: surcharge_no[0]=1002&surcharge_no[1]=1003 nullable: true

Alternative field: client_surcharge_id

client_surcharge_id string 100 No

Specifies the client defined id for surcharge to associate with this plan.REST input arrays should be passed in the following format: client_surcharge_id[]=1002&client_surcharge_id[]=1003

Alternative field: surcharge_no

is_advanced_usage_pricing string 1 No

Indicates if the plan is configured for Advanced Usage Pricing

proration_invoice_timing_cd string 5 No

Determines whether to create a separate invoice for prorated charges immediately, or defer to the next anniversary date.

Allowed values:

Value Description
I Immediate
A Next anniversary date
plan_instance_status_cd int 2 No

Default status used when master plan is initially assigned on an account.

Allowed values:

Value Description
1 Active
31 Pending Installation
32 Pending Activation
41 Trial
61 Active Non-Billable
assign_field_categories object   No

An array of either field_category_no OR field_category_name. field_category_name will take precedence if both the values are passed

See fields below

contract_rollover_plan_no long 100 No

Pre-defined plan to be used as the rollover plan at the completion of the contract

Alternative field: contract_rollover_client_plan_id

contract_rollover_client_plan_id string 100 No

Client-defined id of the pre-defined plan to be used as the rollover plan at the completion of a contract

Alternative field: contract_rollover_plan_no

contract_rollover_rate_sched object   No

The contract_rollover_rate_sched associated with this method.

See fields below

nso_incl_list_scope int 1 No

Scope of additional NSO as part of inclusion list

Allowed values:

Value 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_incl_list_array int 37 No

Specifies the Inventory item number. Mandatory inside array for nso_incl_list_scope is 3 or 4.

nso_group_array object   No

Non-Subscription Offerings that are part of NSO group and is bundled with the plan.

See fields below

nso_group_min_qty string 100 No

Minimum NSO quantity needed per NSO group during plan purchase. This value should be null when NSO scope is Exact Plan Units.

nso_group_max_qty string 100 No

Maximum NSO quantity needed for NSO group during plan purchase. This value should be null when NSO scope is Exact Plan Units or Up to Plan Units.

nso_group_item_scope string 1 No

Scope of bundled NSO group during plan purchase. Mandatory if item_no is specified otherwise optional.

Allowed values:

Value Description
U Up to Plan Units (default).
M Match Plan Units.
A Any Units.
nso_items_array object   No

Non-Subscription Offerings that are bundled with the plan.

See fields below

schedule fields

Name Type Length Required Description
schedule_name string 100 Yes

Name for the schedules to be created. REST input arrays should passed in the following format: schedule[0][schedule_name]=firstSchedule&schedule[1][schedule_name]= secondSchedule etc where schedule[0] specifies first schedule and schedule[1] specifies the second schedule and so on. Translatable.

currency_cd string 3 Yes

Currency for the schedules to be created. REST input arrays should passed in the following format: schedule[0][currency_cd]=usd&schedule[1][currency_cd]=gbp

client_rate_schedule_id string 100 No

Client defined unique id

is_default int 1 No

This flag denotes if this rate schedule is the default one for this plan. One and only one rate schedule can be marked as default. The value of 1 is defaulted for the first rate schedule denoting it is the default. For subsequent rate schedules, the default is set to 0.

recurring_billing_interval int 100 No

If a null/no value is provided then recurring_billing_interval should default to 1.

recurring_billing_period_type int 100 No

If a null/no value is provided then recurring_billing_period_type should default to 3, i.e. monthly period type. Recurring Billing Period Type [ can be either of 1, 2, 3 ] 1 – Daily, 2 – Weekly, 3 - Monthly

usage_billing_interval int 100 No

If null/no value is provided then usage_billing_interval should default to 1.

usage_billing_period_type int 100 No

If a null/no value is provided then usage_billing_period_type should default to 3, i.e. monthly period type. Usage Billing Period Type [ can be either of 1, 2, 3 ] 1 – Daily, 2 – Weekly, 3 - Monthly

available_from_dt string 10 No

Date from which the rate schedule will be available for the assignment. The date format must be yyyy-mm-dd

available_to_dt string 10 No

Date after which the rate schedule will not be available for the assignment. The date format must be yyyy-mm-dd

future_rate boolean 1 No

Indicator whether future rates should be supported or not

future_change_dt string 10 No

Date after which the future rates should be assigned. The date format must be yyyy-mm-dd

followup_rs_no long 100 No

Aria internal id of follow-up default rate schedule

Alternative field: client_followup_rs_id

client_followup_rs_id string 100 No

Client defined id of followup rate schedule. One of the values, i.e., either followup_rs_no or client_followup_rs_id should be provided if a followup rate schedule information should be provided.

Alternative field: followup_rs_no

service.usage_threshold fields

Name Type Length Required Description
notice_dest_type string   No

Notice Destination type. Acceptable values are S, C. Parameter is case insensitive.

Allowed values:

Value Description
S Master Plan Instance level threshold
C Client level threshold
notice_balance_type string   No

Notice Balance type. Acceptable values are MTD, PTD. Parameter is case insensitive

Allowed values:

Value Description
MTD Month-To-Date balance type
PTD Period-To-Date balance type

service.tier.schedule fields

Name Type Length Required Description
from int 10 No

Tiered Pricing Rule that specifies from units at schedule level. This will override the rate tier's from units at service level. REST input arrays should be passed in the following format: service[0][tier][0][schedule][0][from]=1&service[0][tier][0] [schedule][1][from]=1 etc. Index [tier][0][schedule][0] specifies the first tier of first schedule and [tier][0][schedule][1] specifies the first tier of second schedule and so on.

to int 10 No

Tiered Pricing Rule that specifies to units at schedule level. This will override the rate tier's to units at service level. To indicate no upper limit, value should be left blank. REST input arrays should be passed in the following format: service[0][tier][0][schedule][0][to]=3&service[0][tier][0][schedule][1][to]=7 etc. Index [tier][0][schedule][0] specifies the first tier of first schedule and [tier][0][schedule][1] specifies the first tier of second schedule and so on.

description string 50 No

This field is used to display custom rate tier description. This will override the rate tier's description at service level. REST input arrays should be passed in the following format: service[0][tier][0][schedule][0][description]=Custom description &service[0][tier][0][schedule][1][description]=custom description etc. Index [tier][0][schedule][0] specifies the first tier of first schedule and [tier][0][schedule][1] specifies the first tier of second schedule and so on.

amount float 11 Yes

Tiered Pricing Rule that specifies rate per unit.REST input arrays should be passed in the following format: service[0][tier][0][schedule][0][amount]=3&service[0][tier][0][ schedule][1] [amount]=4 etc where [schedule][0][amount] specifies price from first schedule and [schedule][1][amount] specifies price for second schedule and so on.

future_amount float 11 No

Future Rate Per Unit for the tier. future_amount should be specified only if future_rate=1 and future_change_dt is specified. REST input arrays should be passed in the following format: service[0][tier][0][schedule][0][future_amount]=3&service[0][tier][0][schedule][1] [future_amount]=4 etc

service.tier fields

Name Type Length Required Description
from int 10 No

Tiered Pricing Rule that specifies from units. This field cannot be null if rate_type = "Tiered Pricing".REST input arrays should be passed in the following format: service[0][tier][0][from]=1&service[0][tier][1][from]=1 etc. Index [tier][0] specifies the first tier and [tier][1] specifies the second tier and so on.

to int 10 No

Tiered Pricing Rule that specifies to units. This field cannot be null if rate_type = "Tiered Pricing". To indicate no upper limit, value should be left blank.REST input arrays should be passed in the following format: service[0][tier][0][to]=3&service[0][tier][1][to]=7 etc. Index [tier][0] specifies the first tier and [tier][1] specifies the second tier and so on.

description string 50 No

This field is used to display custom rate tier description. REST input arrays should be passed in the following format: service[0][tier][0][schedule][0][description]=Custom description&service[0][tier][1][schedule][0][description]=custom description etc. Index [tier][0] specifies the first tier and [tier][1] specifies the second tier and so on. Translatable.

schedule object   No

The schedule associated with this method.

See fields below

service fields

Name Type Length Required Description
service_no long 100 No

Existing service to be associated with the plan. To create a new service, leave this field blank. REST input arrays should be passed in the following format: service[0][service_no]=125&service[1][service_no]=102 etc where service[0] specifies the first service and service[1] specifies the second service

Alternative field: client_service_id

client_service_id string 100 No

Client defined unique id

Alternative field: service_no

name string 100 No

Name of the new service to be associated with the plan. This field cannot be null if service_no is null. REST input arrays should be passed in the following format: service[0][name]=test. Translatable.

service_type string   Yes

Specifies Service types. Valid values are: "Usage Based", "Recurring", "Activation"

Allowed values:

Value Description
Usage Based Usage Based
Recurring Recurring
Activation Activation
Order-Based Order-Based
Cancellation Cancellation
Minimum Fee Minimum Fee
Recurring Arrears Recurring Arrears
gl_cd string 30 No

Specifies the chart of account code of the new service. REST input arrays should be passed in the following format: service[0][gl_cd]=gl123

taxable_ind int 1 No

Indicates If The service has tax associated with it [can be 0 or 1]; 1 indicates taxable and 0 indicates non taxable.REST input arrays should be passed in the following format: service[0][taxable_ind]=1

tax_group string 1 No

Specifies the tax group associated with the new service. This field cannot be null if taxable_ind is not null.REST input arrays should be passed in the following format: service[0][tax_group]=4

usage_type int 38 No

Specifies usage type associated with the new service. Applicable only if service_type is "Usage-Based". This field cannot be null if service_no is null and service_type is "Usage-Based".REST input arrays should be passed in the following format: service[0][usage_type]=1232&

commodity_cd string 20 No

Commodity Code

rate_type string   No

Specifies the rate type of the service.If service_type = "Recurring", valid values are: 'Flat Rate' and 'Tiered Pricing'. This field cannot be null if service_no is null. If service_no is not null, rate_type of the service will be updated.If service_type = "Activation" or "Cancellation", value is defaulted to "Flat Rate" If service_type = "Usage-Based", value is defaulted to "Tiered Pricing".REST input arrays should be passed in the following format: service[0][rate_type]=Flat Rate&service[1][rate_type]=...

Allowed values:

Value Description
Flat Rate Applies Flat Rate type pricing to the rate schedule
Tiered Pricing Applies Tiered Pricing to the rate schedule
pricing_rule string   No

Specifies the pricing rule of the service. Valid values are: 'Standard', 'Volume Discount' and 'Flat Rate Per Tier'. This field cannot be null if service_no is null and rate_type set to "Tiered Pricing". If service_no is not null and rate_type = "Tiered Pricing", pricing_rule of the service will be updated. REST input arrays should be passed in the following format. service[0][pricing_rule]=Standard&...

Allowed values:

Value Description
Standard Standard
Volume Discount Volume Discount
Flat Rate Per Tier Flat Rate Per Tier
high_water int   No

Specifies the high water indicator of the service if service_type = "Usage-Based". Valid values: 0 and 1. Default value is 0. If service_no is not null, high_water indicator of the service will be updated. REST input arrays should be passed in the following format: service[0][high_water]=0&service[1][high_water]=1&...

Allowed values:

Value Description
Yes Yes
No No
tax_inclusive_ind int 1 No

This flag denotes if a rate is inclusive of the taxes. Value of 1 means tax inclusive rates and a value of 0 (default) means tax exclusive rates.

billing_option int 3 No

This attribute is not in use. It is just a placeholder.

threshold int 9 No

This attribute is not in use. It is just a placeholder.

usage_threshold object   No

Threshold units at the usage type level

See fields below

tier object   No

The tier associated with this method.

See fields below

fulfillment_based_ind int 1 No

Indicates if the service is “Fulfillment Based” or not.

Allowed values:

Value Description
0 Not a fulfillment based service
1 Fulfillment based service
usage_rating_time_ind int 1 No

Rating Time Indicator governs the time when usage is rated: during invoicing process or during usage loading to the platform.

Allowed values:

Value Description
0 Refers to the setting you have on client parameter "Automatically Rate Un-rated Usage Records at Load Time".
2 At Invoicing Time
1 At Loading Time
usage_record_rating_level_ind int 1 No

Indicates whether the usage rating to be done at individual record level or aggregated records level.

Allowed values:

Value Description
0 Aggregated Records
1 Individual Records
usage_record_taxation_level_ind int 1 No

Indicates whether the usage taxation to be done at individual record level or aggregated records level.

Allowed values:

Value Description
0 Aggregated Records
1 Individual Records

resource fields

Name Type Length Required Description
resource_no long   No

Specifies the resource no of the resource to be added to a plan. REST input arrays should passed in the following format: resource[0][resource_no]=123&resource[1][resource_no]=232 etc where resource[0] specifies first resource and resource[1] specifies the second resource and so on.

resource_name string 100 No

Specifies the name of the resource to be created and assigned to this plan. REST input arrays should passed in the following format: resource[0][resource_name]=resource1&resource[1][resource_name]=test&...

resource_description string   No

Specifies the description of the resource to be created and assigned to this plan.REST input arrays should passed in the following format: resource[0][resource_description]=resource1&...

flat_threshold int 11 No

Specifies the name of the resource to be created and assigned to this plan. REST input arrays should passed in the following format: resource[0][flat_threshold]=11&resource[1][flat_threshold]=3&...

resource_units int 11 No

Specifies the number of units of the resource to be allocated.REST input arrays should passed in the following format: resource[0][resource_units]=23&resource[1][resource_units]=4&...

expire_on_paid_through string   No

Specifies whether or not the resource will expire on paid through date. REST input arrays should passed in the following format: resource[0][expire_on_paid_through]=1&resource[1][expire_on_paid_through]=0&...

Allowed values:

Value Description
0 False
1 True
additional_days int 11 No

Specifies the number of days added to the paid_through_date if expire_on_paid_through is set if not then to the date when the plan is paid on. REST input arrays should passed in the following format: resource[0][additional_days]=2&resource[1][additional_days]=3&...

reset_on_update string   No

Resets the number of units after each paid through date.REST input arrays should passed in the following format: resource[0][reset_on_update]=1&resource[1][reset_on_update]=0&...

Allowed values:

Value Description
0 False
1 True

supplemental_obj_field fields

Name Type Length Required Description
field_no long 100 No

the field no

Alternative field: field_name

field_name string 100 No

the field name

Alternative field: field_no

field_value string   No

the field value

eligible_child_plans fields

Name Type Length Required Description
plan_no long   No

Aria generated unique of the plan

Alternative field: client_plan_id

client_plan_id string   No

Client defined unique id for the plan

Alternative field: plan_no

is_mandatory int   No

Determines if this child plan must be purchased along with the parent plan.

Allowed values:

Value Description
0 Non Mandatory
1 Mandatory
include_default int   No

Determines if this child plan should be added to the purchase plan list in the UI.

Allowed values:

Value Description
0 No
1 Yes
min_units int 2 No

Determines the minimum number of units that must be purchased.

max_units int 2 No

Determines the maximum number of units that can be purchased.

enforcement_level int 1 No

Determines the level at which the minimum and maximum values are enforced

Allowed values:

Value 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

assign_field_categories fields

Name Type Length Required Description
field_category_no long 100 No

This field is used as Primary id for field category number

Alternative field: field_category_name

field_category_name string 100 No

This field is used as client defined ID

Alternative field: field_category_no

field_category_directive int 1 No

Specifies the field category directive. 1 to add and 2 to remove an field category

Allowed values:

Value Description
1 Adds a field_category to the plan
2 Deletes the field_category from the plan anniversary date

contract_rollover_rate_sched fields

Name Type Length Required Description
current_rate_sched_no long 100 No

Current rate schedule for which the rollover rate schedule is being defined

Alternative field: current_client_rate_sched_id

current_client_rate_sched_id string 100 No

Client-defined id of the current rate schedule for which the rollover rate schedule is being defined

Alternative field: current_rate_sched_no

rollover_rate_sched_no long 100 No

Pre-defined rate schedule to be used as the rollover rate schedule at the completion of the contract

Alternative field: rollover_client_rate_sched_id

rollover_client_rate_sched_id string 100 No

Client-defined id of the pre-defined rate schedule to be used as the rollover rate schedule at the completion of the contract

Alternative field: rollover_rate_sched_no

nso_group_array.nso_group_price_override fields

Name Type Length Required Description
rate_schedule_no long 100 No

The internal Id of the plan rate schedule for which the NSO price is being defined.

Alternative field: client_rate_schedule_id

client_rate_schedule_id string 100 No

Client-defined id of the plan rate schedule for which the NSO price is being defined.

Alternative field: rate_schedule_no

override_price string 100 No

Specifies the overridden price for Inventory item for currencies. If there is no override price defined for NSO then list price is considered during plan assignment.

Note: This field was deprecated in version 28.

bundle_nso_rate_schedule_no long 100 No

Aria-assigned unique identifier for the rate schedule to be used as the bundle price for the NSO when purchased with this plan.

Alternative field: bundle_client_nso_rate_schedule_id

bundle_client_nso_rate_schedule_id string 100 No

Client-defined unique identifier for the rate schedule to be used as the bundle price for the NSO when purchased with this plan. If neither is specified, the default rate schedule for currency matching that of the account will be used.

Alternative field: bundle_nso_rate_schedule_no

nso_group_array fields

Name Type Length Required Description
item_no long 100 No

Specifies the Inventory item number for adding into NSO group.

nso_group_price_override object   No

The nso_group_price_override associated with this method.

See fields below

nso_items_array.nso_items_price_override fields

Name Type Length Required Description
rate_schedule_no long 100 No

The internal Id of the plan rate schedule for which the NSO price is being defined.

Alternative field: client_rate_schedule_id

client_rate_schedule_id string 100 No

Client-defined id of the plan rate schedule for which the NSO price is being defined.

Alternative field: rate_schedule_no

override_price string 100 No

Specifies the overridden price for Inventory item for currencies. If there is no override price defined for NSO then list price is considered during plan assignment.

Note: This field was deprecated in version 28.

bundle_nso_rate_schedule_no long 100 No

Aria-assigned unique identifier for the rate schedule to be used as the bundle price for the NSO when purchased with this plan.

Alternative field: bundle_client_nso_rate_schedule_id

bundle_client_nso_rate_schedule_id string 100 No

Client-defined unique identifier for the rate schedule to be used as the bundle price for the NSO when purchased with this plan. If neither is specified, the default rate schedule for currency matching that of the account will be used.

Alternative field: bundle_nso_rate_schedule_no

nso_items_array fields

Name Type Length Required Description
item_no long 100 No

Specifies the Inventory Item number for adding into NSO bundle.

nso_item_min_qty string 100 No

Minimum NSO quantity needed during plan purchase. This value should be null when NSO scope is Match Plan Units.

nso_item_max_qty string 100 No

Maximum NSO quantity needed during plan purchase. This value should be null when NSO scope is Match Plan Units or Up to Plan Units.

item_scope string 1 No

Scope of bundled NSO during plan purchase. Mandatory if item_no is specified otherwise optional.

Allowed values:

Value Description
U Up to Plan Units (default).
M Match Plan Units.
A Any Units.
nso_items_price_override object   No

The nso_items_price_override associated with this method.

See fields below

Outputs

Name Type Length Required Description
error_code long   No

Aria-assigned error identifier. 0 indicates no error

error_msg string   No

Textual description of any error that occurred. "OK" if there was no error.

plan_no long 100 No

Plan Number

TOP
  • Was this article helpful?