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

 

Home > Aria Crescendo admintools api > update_coupon_m

update_coupon_m

Update an existing coupon

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 this account.
auth_key string 32 Aria-assigned unique key to be passed with each method call for authenticating the validity of the requestor.
coupon_cd string 30 Specifies Coupon Code
coupon_desc string 200 Specifies Coupon description. Translatable
  coupon_msg string 300 Specifies Coupon Message. Translatable.
  status_ind int 1 Specifies Coupon status   Allowable Values
  no_of_uses long 8 Specifies number of uses after which coupon get expires. Related to coupon expiry detail.
  start_date string   Specifies start date. The date is in the format "yyyy-mm-dd". Related to coupon expiry detail.
  end_date string   Specifies end date. The date is in the format "yyyy-mm-dd". Related to coupon expiry detail.
  template array    
credit_template_name string 300 Recurring credit template name. If both an existing template name and a new template name is provided, the new template name will be used to create a new template.
  client_credit_template_id string 100 Client defined unique id
  eligible_plan_no int 8 Eligible service plan number. If eligible_plan_no is present then eligible_service_no is also set and vice-versa. This means that coupon can only be applied against a specific type of charge. But If both values are null then it means that coupon can be applied against any change.
  OR      
  eligible_client_plan_id string 100 Specifies Client defined unique id
  eligible_service_no int 12 Eligible service number
  OR      
  eligible_client_service_id string 100 Specifies Client defined unique id
  eligible_service_types string array 2  
discount_type int 1 Specifies discount type. Valid values are [1 or 2] 1 - Indicates flat rate 2 - Indicates percentage
discount_amt float 12 Specifies discount amount. If discount_type is set to 1, then this range of valid values of this parameter is > 0 to 9999, but if it's set to "2" then its range is > 0 to 100.
  no_of_credits int 2 This parameter is related to information about generation frequency. i.e. Number of credits If this value is set along with time_between_credits, then it means that generation frequency is multiple.
  credit_interval_months int 3 Time interval between credits in months
  percentage_plan_no int 8 Specifies Percentage plan number. This value is only set if discount_type is 2 i.e. discount type is Percentage
  OR      
  percentage_client_plan_id string 100 Specifies Client defined unique id
  percentage_service_no int 12 Specifies Percentage service number. This value is only set if discount_type is 2 i.e. discount type is Percentage
  OR      
  percentage_client_service_id string 100 Specifies Client defined unique id
  alt_service_no int 12 Specifies Alternative service number. If this value is null, then for coupon can be Service code to use is standard
  OR      
  alt_client_service_id string 100 Specifies Client defined unique id
  currency_cd string 3 Specifies the currency code of Template
  existing_template array    
  template_no int 12 Specifies existing templates to be associated with the coupon. REST input arrays should passed in the following format: existing_template[0][template_no]=1243& existing_template[1][template_no]=1002 etc.
  OR      
  template_id string 100 Specifies client defined unique identifiers for existing templates to be associated with the coupon. REST input arrays should passed in the following format: existing_template[0][template_id]=1243& existing_template[1][template_id]=1002 etc.
  discount_rule array    
label string 30 Specifies Discount Rule Name. Translatable.
rule_id string 30 Specifies client rule id for Discount Rule
description string 300 Specifies description for the Discount Rule. Translatable.
ext_description string 300 Specifies description that can be added to invoice/statment and is visible to account holder. Translatable.
flat_percent_ind string 1 Specifies whether the discount is going to be flat or percentage based.   Allowable Values
amount float 12 Specifies the amount of discount.
currency string 3 Specifies the currency code of the rule
duration_type_ind string 1 Specifies the duration type. Valid values are [ U, M] for uses and months   Allowable Values
  max_applicable_months int 8 Specifies the duration of the discount in months.
  max_applications_per_acct int 8 Specifies the number of times the discount can be applied.
inline_offset_ind string 1 Specifies how the discount will be displayed in the invoice.Valid values are [I, O]
discount_behavior_type_ind string 1 Specifies the discount scope for a discount rule.Valid values are [G, N]
  service_code_to_use int 1 Specifies which service code to use. Valid values are [0,1] where 0 uses the same service as the 'charge' line item and 1 uses a specific service
  alt_service_no_2_apply int 12 Specifies the specific service code to use.
  OR      
  alt_service_id_2_apply string 100 Client defined unique identifier
  applicable_trans_scope string 1 Specifies whether the discount is applied to each or all transactions.   Allowable Values
scope_no int 2 Specifies the charges eligible for the discount.   Allowable Values
  plans array    
  plan_no int 12 Specifies the plan that are eligible for the discount. This is mandatory for scope 11 and 13.REST input arrays should be passed in the following format: plans[0][plan_no]=1002&plans[1][plan_no]=1003 etc
  OR      
  client_plan_id string 100 Specifies the plan that are eligible for the discount. This is mandatory for scope 11 and 13.REST input arrays should be passed in the following format: plans[0][client_plan_id]=1002&plans[0][client_plan_id]=1003 etc
  service array    
  service_no int 12 Specifies the services that are eligible for the discount. This is mandatory for scope 12 and 13. REST input arrays should be passed in the following format: For scope 12 service[0][service_no]=1002&service[1][service_no]=1003 For scope 13 service[0][service_no][0]=10002&service[0][service_no][1]=1001&service[1][service_no][0]=100&service[1][service_no][1]=103
  OR      
  client_service_id string 100 Specifies the services that are eligible for the discount. This is mandatory for scope 12 and 13. REST input arrays should be passed in the following format: For scope 12 service[0][client_service_id]=1002&service[1][client_service_id]=1003 For scope 13 service[0][client_service_id][0]=10002
  item array    
  item_no int 12 Specifies the inventory items that are eligible for the discount. This is mandatory for scope 31. REST input arrays should be passed in the following format: item[0][item_no]=1002&item[1][item_no]=103
  OR      
  client_item_id string 100 Specifies the inventory items that are eligible for the discount. This is mandatory for scope 31. REST input arrays should be passed in the following format: item[0][client_item_id]=1002&item[1][client_item_id]=103
  use_all_or_nth_subs_rule string 5 Specifies whether to apply discount when 'all' the plans are under the account or 'some' of the plans are are under the account.   Allowable Values
  existing_discount_rule array    
  rule_no int 12 Specifies existing rules to be associated with the coupon. REST input arrays should passed in the following format: existing_discount_rule[0][rule_no]=1243& existing_discount_rule[1][rule_no]=1002 etc.
  OR      
  rule_id string 100 Specifies client defined unique identifiers for existing rules to be associated with the coupon. REST input arrays should passed in the following format: existing_discount_rule[0][rule_id]=1243& existing_discount_rule[1][rule_id]=1002 etc.
  discount_bundle array    
bundle_name string 300 Specifies the name for the discount bundle.
bundle_id string 30 Specifies bundle id for discount Bundle
bundle_description string 300 Specifies description for the discount Bundle
allow_overlap_ind string 1 Specifies if the rules in the bundle can overlap or not.   Allowable Values
  rules array    
  rule_no int 12 Specifies the rules to be grouped in this bundle. REST input arrays should be passed in the following format: rules[1][rule_no]=1002&rules[2][rule_no]=103
  OR      
  rule_id string 100 Specifies the rules to be grouped in this bundle. REST input arrays should be passed in the following format: rules[1][rule_id]=1002&rules[2][rule_id]=103
  existing_discount_bundle array    
  bundle_no int 12 Specifies existing bundles to be associated with the coupon. REST input arrays should passed in the following format: existing_discount_bundle[0][bundle_no]=1243& existing_discount_bundle[1][bundle_no]=1002 etc.
  OR      
  bundle_id string 100 Specifies existing bundles to be associated with the coupon. REST input arrays should passed in the following format: existing_discount_bundle[0][bundle_id]=1243& existing_discount_bundle[1][bundle_id]=1002 etc.
  coupon_scope int 1 Specifies the coupon application. The parameter is required for EOM Clients The value will be ignored if the coupon has been used already   Allowable Values
  locale_no int 38 Locale number to which the translations belong.
  OR      
  locale_name string 32 Name of the locale to which the translations belong.

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.
coupon_cd string Coupon code

You must to post a comment.
Last modified
13:02, 2 Mar 2017

Tags

This page has no custom tags.

Classifications

This page has no classifications.