edit_plan_m
Summary
| API Name | edit_plan_m |
|---|---|
| Class | administration_services_m |
| Update Version | 5.6 |
Description
Edit 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_no | long | 100 | Yes |
Specifies Plan Number Alternative required field: client_plan_id |
||||||||||||
| plan_name | string | 100 | No |
Specifies Plan Name. For edit_directives 1 and 2 plan_name is mandatory. Translatable. |
||||||||||||
| plan_description | string | 3000 | No |
Specifies plan description. Translatable. |
||||||||||||
| client_plan_id | string | 100 | Yes |
Client defined unique identifier Alternative required field: plan_no |
||||||||||||
| 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 | 100 | 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 | No |
Specifies Plan Type. Valid values are [ 'Master Recurring Plan', 'Master Pre-paid Plan', 'Master Free Plan', 'Supplemental Recurring Plan', 'Supplemental Free Plan']. Allowed values:
|
|||||||||||||
| active | int | 1 | No |
Specifies Plan Status.Valid values are "1" or "0" 1 - Active 0 - Inactive. Allowed values:
|
||||||||||||
| currency | string | 3 | No |
Specifies the currency code. For edit_directives 1 and 2 currency is mandatory |
||||||||||||
| 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 |
||||||||||||
| 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. Rollover information is required for Pre-paid plans 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 |
||||||||||||
| allow_child_accts | int | 3 | No |
Specifies whether a plan can have child accounts or not. Valid values are "1" or "0" 1 - Yes 0 - No. The parameter has been depreciated. Value will be overrided to 1 |
||||||||||||
| 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.Apply cancellation is set when the plan is created and cannot be modified except for the min terms(months) 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 | int | 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 | No |
For edit_directives 1 schedule is mandatory |
|||||||||||||
| service | object | No |
For edit_directives 1 service is mandatory |
|||||||||||||
| resource | object | No |
The resource associated with this method. |
|||||||||||||
| arc_service_no | long | 100 | 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. This field is required only if the associated product fields are marked as required |
|||||||||||||
| 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 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 |
||||||||||||
| proration_invoice_timing_cd | string | 1 | 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 |
|||||||||||||
| edit_directives | int | No |
A directive that indicates the action to be taken. This new parameter applies to the child_plans, parent_plans, exclusion_plans, plan_group, schedule, service, template_no, rollover_plan_no, dunning_plan_no, notification_template_group_no, supplemental_obj_field in the API Allowed values:
|
|||||||||||||
| 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. |
|||||||||||||
| service_change | object | No |
Mandatory when editing a plan that is in-use i.e. assigned to an account |
|||||||||||||
| locale_name | string | 32 | No |
Name of the locale to which the translations belong. Alternative field: locale_no |
||||||||||||
| locale_no | long | 38 | No |
Aria-assigned unique identifier of the locale used for translations. Alternative field: locale_name |
schedule fields
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| schedule_no | long | 20 | No |
Specifies the schedule number whose details is going to be edited. This can be nullable for new services.REST input arrays should passed in the following format: schedule[0][schedule_no]=1212121&schedule[1][schedule_no]=4234232 etc where schedule[0] specifies first schedule and schedule[1] specifies the second schedule and so on Alternative field: client_rate_schedule_id |
| client_rate_schedule_id | string | 100 | No |
Client defined unique id Alternative field: schedule_no |
| 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 | 100 | 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 |
| is_default | int | 1 | No |
Specifies which currency should be the default as the user can add the same currency multiple times. Accepted values are 1(default) and 0 |
| recurring_billing_interval | int | 100 | No |
If a null/no value is provided then recurring_billing_interval should default to 1, i.e., monthly interval. Recurring Billing Interval [ can be either of 1, 3, 6 or 12, |
| 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, i.e., monthly interval. Usage Billing Interval [ can be either of 1, 3, 6 or 12, |
| 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.REST input arrays should be passed in the Following format: service[0][tier][0][from]=1&service[0][tier][1][from]=1 etc. where 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.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][description]=Custom description&service[0][tier][1][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 |
||||||||||||||||
| 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. |
||||||||||||||||
| client_service_id | string | 100 | No |
Client defined unique id Alternative field: service_no |
||||||||||||||||
| service_type | string | Yes |
Specifies the service type. Valid values : 'Activation', 'Recurring', 'Cancellation', 'Minimum Fee' and 'Usage-Based' REST input arrays should passed in the following format: service[0][service_type]=Recurring&service[1][service_type]=... 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.valid values are: 'Flat Rate' and '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. Valid values are: 'Standard', 'Volume Discount' and 'Flat Rate Per Tier'.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. Valid values: 0 and 1.It is mandatory for Usage-Based services.REST input arrays should be passed in the following format: service[0][high_water]=1&service[1][high_water]=0 Allowed values:
|
|||||||||||||||||
| billing_option | int | 3 | No |
Specifies the two advanced billing options. This is only given for Usage-Based services only. Valid values: '1' => pool items, '2' =>usage tier multiplier and '0' for none. If you do no provide this information it will default to none. REST input arrays should passed in the following format: service[0][billing_option]=1&service[1][billing_option]=2 |
||||||||||||||||
| threshold | int | 9 | No |
Specifies the pool threshold. This is mandatory only if you choose ervice[0][billing_option]=1. This is only given for Usage-Based services only. If you do not provide any value it will default to 0. REST input arrays should passed in the following format: service[0][threshold]=123&service[1][threshold]=42 |
||||||||||||||||
| 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. |
||||||||||||||||
| usage_threshold | object | No |
Threshold units at the usage type level |
|||||||||||||||||
| tier | object | No |
Tier is required for edit_directives 1 for the provided services |
|||||||||||||||||
| 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 | 1 | No |
Determines if this child plan must be purchased along with the parent plan. Allowed values:
|
||||||
| include_default | int | 1 | 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 |
A directive that indicates the action to be taken 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. Mandatory if override_price is specified 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. Mandatory if override_price is specified 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. |
||||||||
| 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. |
service_change fields
| Name | Type | Length | Required | Description | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| subscription_type | string | 1 | Yes |
Type of subscription on which the service changes are applicable. Allowable values are - ‘N' for New subscription and 'E’ for existing subscription Allowed values:
|
||||||
| effective_date | string | No |
Date on which the service change will be effective on the given subscription_type. Either the effective_date or the effective_directive is mandatory. |
|||||||
| effective_directive | string | 1 | No |
A directive that indicates when the service changes are effective on the given subscription_type. Either the effective_date or the effective_directive is mandatory. Allowed values:
|
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 |