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:
|
|||||||||||||
| 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:
|
||||||||||||
| 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:
|
|||||||||||||
| 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:
|
|||||||||||||
| initial_plan_status_cd | int | No |
Default status used when master plan is initially assigned on an account. Allowed values:
|
|||||||||||||
| 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:
|
|||||||||||||
| 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:
|
|||||||||||||
| 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:
|
|||||||||||||
| 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:
|
|||||||||||||
| schedule | object | Yes |
The schedule associated with this method. |
|||||||||||||
| service | object | Yes |
The service associated with this method. |
|||||||||||||
| resource | object | No |
The resource associated with this method. |
|||||||||||||
| 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 |
|||||||||||||
| 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:
|
||||||||||||
| 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. |
|||||||||||||
| 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:
|
||||||||||||
| plan_instance_status_cd | int | 2 | No |
Default status used when master plan is initially assigned on an account. Allowed values:
|
||||||||||||
| 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 |
|||||||||||||
| 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. |
|||||||||||||
| nso_incl_list_scope | int | 1 | No |
Scope of additional NSO as part of inclusion list Allowed values:
|
||||||||||||
| 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. |
|||||||||||||
| 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:
|
||||||||||||
| nso_items_array | object | No |
Non-Subscription Offerings that are bundled with the plan. |
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:
|
|||||||
| notice_balance_type | string | No |
Notice Balance type. Acceptable values are MTD, PTD. Parameter is case insensitive Allowed values:
|
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. |
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:
|
|||||||||||||||||
| 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:
|
|||||||||||||||||
| 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:
|
|||||||||||||||||
| 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:
|
|||||||||||||||||
| 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 |
|||||||||||||||||
| tier | object | No |
The tier associated with this method. |
|||||||||||||||||
| fulfillment_based_ind | int | 1 | No |
Indicates if the service is “Fulfillment Based” or not. Allowed values:
|
||||||||||||||||
| 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:
|
||||||||||||||||
| 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:
|
||||||||||||||||
| 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:
|
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:
|
|||||||
| 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:
|
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:
|
|||||||
| include_default | int | No |
Determines if this child plan should be added to the purchase plan list in the UI. Allowed values:
|
|||||||
| 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:
|
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:
|
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. |
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:
|
||||||||
| nso_items_price_override | object | No |
The nso_items_price_override associated with this method. |
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 |