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 for coupon_scope:
Values |
Description |
0 |
Account |
1 |
Master Plan Instance |
2 |
Account and Master Plan Instance |
|
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 |
coupon_assignment_no |
long |
Specifies the coupon assignment ID |
coupon_assignment_reason_cd |
long |
Specifies the coupon assignment reason code |
coupon_assignment_effective_date |
string |
Specifies the coupon effective date |
coupon_assignment_comments |
string |
Specifies the coupon assignment comments |
coupon_assignment_date |
string |
Specifies the coupon assignment date |
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 for eligible_service_types:
Values |
Description |
RC |
Recurring Service |
US |
Usage Service |
TX |
Tax Service |
AC |
Activation Service |
MS |
Miscellaneous Service |
CN |
Cancellation Service |
OR |
Order Based Service |
MN |
Minimum Fee Service |
|
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 for flat_percent_ind:
Values |
Description |
P |
Indicates this is a percentage-based discount |
F |
Indicates that this is a flat currency amount discount |
|
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_rule_period_type |
hash |
Specifies the duration type.
Allowable values for discount_rule_period_type:
Values |
Description |
1 |
Days |
2 |
Weeks |
3 |
Months |
|
max_application_period |
hash |
Number of periods for which this discount rule is valid after the corresponding coupon is assigned to an account.
Example: If the <discount_rule_period_type> is weeks (2) and the <max_application_period> is 3, it means that the discount rule is valid for 3 weeks after the corresponding coupon is assigned to an account.
|
total_discount_uses |
long |
This displays the total uses of a discount rule applied to a specific master plan instance or a specific account OR a master plan instance AND account depending on how the coupon is applied. |
remaining_discount_uses |
long |
This displays the number of remaining coupon uses for the specified account and/or master plan instance under the discount array details for both discount rule/bundle or credit-template-based coupons. |
scope_overridden |
string |
Specifies Y/N if coupon scope is overridden. |
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. |