Skip to main content
Aria Knowledge Central

edit_rate_schedule_on_plan_m

Use this API to edit an existing rate schedule on a plan.  If a rate schedule has two services, and the user wants to edit just one, they can just past pass in the tiers for that service. The tiers on the second service will not be edited or deleted. 

Input Arguments

 
Req Field Name Field Type Max Length Description
required-icon.png client_no long 22 Aria-assigned unique identifier indicating the Aria client providing service to the account.
required-icon.png auth_key string 32 Aria-assigned unique key to be passed with each method call for authenticating the validity of the requestor.
  schedule_no long   Schedule number of the rate schedule to be edited.
  OR      
required-icon.png client_rate_schedule_id string 100 Client-defined unique rate schedule number.
required-icon.png schedule_name string 100

Name of the schedule to be edited.

required-icon.png is_default boolean 1

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.

  brd_arrow.gifrecurring_billing_interval int 100 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, <custom months="months" no.="no." of="of"> ) 1 – Monthly, 3 – Quarterly, 6 - Semi-Annually, 12 – Annually, Custom - <No. of months>
  brd_arrow.gifrecurring_billing_period_type int 100 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
  brd_arrow.gifusage_billing_interval int 100 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, <custom months="months" no.="no." of="of"> ) 1 – Monthly, 3 – Quarterly, 6 - Semi-Annually, 12 – Annually, Custom - <No. of months>
  brd_arrow.gifusage_billing_period_type int 100 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
  brd_arrow.gifavailable_from_dt string 10 Date from which the rate schedule will be available for the assignment. The date format must be yyyy-mm-dd
  brd_arrow.gifavailable_to_dt string 10 Date after which the rate schedule will not be available for the assignment. The date format must be yyyy-mm-dd
  brd_arrow.giffuture_rate boolean 1 Indicator whether future rates should be supported or not.
  brd_arrow.giffuture_change_dt string 10 Date after which the future rates should be assigned. The date format must be yyyy-mm-dd
  brd_arrow.giffollowup_rs_no long 100 Aria internal id of follow-up default rate schedule.
  OR      
  brd_arrow.gifclient_followup_rs_id string 100 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.
  service array    
required-icon.png brd_arrow.gifservice_no long 100 Aria-assigned service number.
  OR      
required-icon.png brd_arrow.gifclient_service_id string 100 Client-defined unique identifier.
  brd_arrow.giftier array    
    brd_arrow.giffrom int 10 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][from]=1&service[0][tier][1][from]=1 etc. Index [tier][0] specifies the first tier of the schedule and [tier][1] specifies the second tier of the schedule and so on.

    brd_arrow.gifto int 10

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][to]=3&service[0][tier][1][to]=7 etc. Index [tier][0] specifies the first tier of the schedule and [tier][1]specifies the second tier of the schedule and so on.

   brd_arrow.gifdescription string 50

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][description]=Custom description&service[0][tier][0][description]=custom description etc. Index[tier][0] specifies the first tier of the rate schedule and [tier][1] specifies the second tier of the schedule and so on.

required-icon.png  brd_arrow.gifamount float 11

Tiered Pricing Rule that specifies rate per unit.

REST input arrays should be passed in the following format:

service[0][tier][0][amount]=3&service[0][tier][1][amount]=4 etc where [tier][0][amount]specifies price from first tier and [tier][1][amount] specifies price for second tier and so on.

   brd_arrow.giffuture_amount float 11

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][future_amount]=3&service[0][tier][1][future_amount]=4 etc.

Output Arguments

 
Field Name Field Type Description
error_code long Aria-assigned error identifier. 0 indicates no error
error_msg string Textual description of any error that occurred. "OK" if there was no error.
rate_schedule hash  
brd_arrow.gif schedule_no int

Schedule number of the rate schedule edited.

brd_arrow.gif client_rate_schedule_id string Client defined unique id.
  • Was this article helpful?