Search the Aria Knowledgebase for
User Documentation, APIs, SDKs, and more!



 

Home > Aria6 admintools api > edit_rate_schedule_on_plan

edit_rate_schedule_on_plan

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
client_no long 22 Aria-assigned unique identifier indicating the Aria client providing service to the account.
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      
client_rate_schedule_id string 100 Client-defined unique rate schedule number.
schedule_name string 100

Name of the schedule to be edited.

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.

  ►available_from_dt string 10 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 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 Indicator whether future rates should be supported or not.
  ►future_change_dt string 10 Date after which the future rates should be assigned. The date format must be yyyy-mm-dd
  ►followup_rs_no long 100 Aria internal id of follow-up default rate schedule.
  OR      
  ►client_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    
►service_no long 100 Aria-assigned service number.
  OR      
►client_service_id string 100 Client-defined unique identifier.
  ►tier array    
    ►from 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.

    ►to 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.

   ►description 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.

 ►amount 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.

   ►future_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  
 schedule_no int

Schedule number of the rate schedule edited.

 client_rate_schedule_id string Client defined unique id.
 
 
 
Last modified

Tags

This page has no custom tags.

Classifications

This page has no classifications.