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



 

Home > Aria Crescendo core api > get_acct_coupon_details_m

get_acct_coupon_details_m

This API provides detailed information including credit templates, discount rules, and discount bundles for coupons that are assigned to an account or a master plan instance.

For information on error messages generated by this API, see get_acct_coupon_details_m error messages.

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.
  acct_no long 22 Aria-assigned account identifier. This value is unique across all Aria-managed accounts. If passed, only the coupons assigned to this account will be returned.
  OR      
  client_acct_id string 50 Client-defined account identifier.
  master_plan_instance_no long 22 The Master Subscription plan instance number.
  OR      
  client_master_plan_instance_id string 100 Client-defined Master plan Subscription plan instance ID.
  coupon_cd string 30 If passed, only the details for the coupon specified will be returned.
  locale_no long 22 Aria-assigned unique identifier of the locale used for translations. This value must be unique across all Aria clients.
  OR      
  locale_name string 50 Name of the locale.
  alt_caller_id string 30 Person or process that submitted the API call. This can be someone's user ID, or the name of an application.
  optional_transaction_qualifiers array   Array of additional values you can associate with this API call.
  qualifier_name string 100 Name of the field you want to associate with this API call.
  qualifier_value string 100 Corresponding value of the field you want to associate with this API call.
 

Output Arguments

Field Name Field Type Description
error_code long Aria-assigned error identifier. 0 indicates no error.
error_msg string Description of any error that occurred. "OK" if there was no error.
coupons_detail hash  
out_acct_no long Aria-assigned account identifier. This value is unique across all Aria-managed accounts. If passed, only the coupons assigned to this account will be returned.
out_client_acct_id string This is the client-assigned identifier for the account.
out_master_plan_instance_no long The Master Subscription plan instance number.
out_client_master_plan_instance_id string  
out_coupon_cd string The unique coupon ID
coupon_scope long Specifies the coupon application.   Allowable Values
description string A long description of the coupon
start_date string Beginning effective date for this coupon
exp_date string Final effective date (expiration date) for this coupon
max_uses long Number of times a coupon can be used
total_uses long The number of times this coupon has been used
currency_cd string The currency this coupon applies to
recur_discount_flat_amt double A recurring discount amount expressed as a flat currency amount discount
one_time_discount_flat_amt double A one-time discount amount expressed as a flat currency amount discount
recur_discount_pct double A recurring discount amount expressed as a percentage of the charges
one_time_discount_pct double A one-time discount amount expressed as a percentage of the charges
status_ind long Whether or not the coupon is active
group_no long Aria-assigned group number
client_group_id string Specifies Client-defined ID for coupon group
group_name string Specified coupon group name
group_description string Specifies group description
group_precedence long Specifies the precedence of the coupon group
credit_templates hash The credit templates mapped to this coupon
credit_template_no long The unique ID of this credit template
template_name string The name of this credit template
flat_amount double An indiscriminate flat discount for this credit template
percent_amount double An indiscriminate percentage discount for this credit template
percent_eval_plan_no long The plan number which is being discounted if this credit template is percentage based
percent_eval_service_no long The service number which is being discounted if this credit template is percentage based
currency_cd string The currency code to which this credit template applies
eligible_plan_no long The plan number which must be present for this credit template to apply
eligible_service_no long The service number which must be present for this credit template to apply
alt_service_no_2_apply long The alternate service number to use on the eventual invoice for this credit
num_credits_required long Number of times a credit will be created from this template
credit_interval_months long How long in between applications of this credit
eligible_service_types hash A list of eligible service types
eligible_service_types string Service type code for which the credit is applicable.   Allowable Values
discount_rules hash  
rule_no long The unique ID of this discount rule
client_rule_id string Client-defined name or ID for this discount rule
rule_name string The name of this discount rule
scope_no long The applicability of this discount rule
description string The long description of this discount rule
flat_percent_ind string Whether or not this is a flat discount or a percentage based one   Allowable Values
currency_cd string The currency code to which this discount rule applies
amount double The amount of discount, which is either a flat amount or a percentage, based on the value of flat_percent_ind
inline_offset_ind string Whether or not this discount is applied inline or as its own line
duration_type_ind string Indicates whether this discount rule expires after a specific duration, or after a number of uses
max_applicable_months long How many months this discount rule will apply
max_applications_per_acct long The maximum number of times a single account can use this discount rule
ext_description string A user-friendly public facing description
alt_service_no_2_apply long The alternate service number to use on the eventual invoice for this discount rule
discount_bundle_no hash If this rule is part of multiple discount bundles, they are all listed here
bundle_no long The unique ID of the discount bundle
discount_bundles hash All of the bundles to which this coupon belongs
bundle_no long The unique ID of the discount bundle
client_bundle_id string Client-defined discount bundle ID
bundle_name string The name of the discount bundle
description string The long description of the discount bundle
acct_locale_no long Aria-assigned unique identifier of the locale used for translations. This value is unique across all Aria-managed accounts. DEPRECATED
acct_locale_no_2 long Aria-assigned unique identifier of the locale used for translations. This value is unique across all Aria-managed accounts.
acct_locale_name string Name of the account level locale.
 
 
 
Last modified

Tags

This page has no custom tags.

Classifications

This page has no classifications.