Skip to main content
Aria Knowledge Central

create_advanced_service_credit_m Guide

This API creates service credit in advance on an account or master plan instance.

API Specification:

create_advanced_service_credit_m

Required Fields:
  • <client_no>
  • <auth_key>
  • <acct_no> or <client_acct_id>

Error Codes

Error Code/Description Associated Inputs

1001: unexpected error

 

1004: authentication error

Associated Inputs: auth_key, client_id, client_no

<auth_key>, <client_no>

1009: account does not exist, Account not found: AriaNo (acct_no), Account not found: Userid (userid), or Account not found: ClientId (client_acct_id)

Associated Inputs: acct_no, account_no, client_acct_id, user_id, userid, parent_acct_no

<acct_no>, <client_acct_id>

1016: invalid input

Additional Comments:  This error can be caused by the wrong type of input; for example, text in a numbers-only field, or specifying a value other than one of the documented allowable values.

<alt_service_no_to_apply>, <client_plan_instance_id>, <client_plan_instance_service_id>, <client_percent_eval_plan_instance_id>, <percent_eval_service_no>, <client_percent_eval_service_id>, <reason_code>, <acct_no>

1024: invalid date format

Associated Inputs: bill_birthdate, birthdate, degrade_date, initial_credit_date, invoice_line_reversing_date, service_fulfillment_date, queue_date, start_bill_date, end_bill_date, start_date, end_date, stmt_birthdate, bill_birthdate

Additional Comments: All date inputs must be in yyyy-mm-dd format.

<initial_credit_date>

1025: amount not positive

Associated Inputs: amount, percent_amount

Additional Comments: This error occurs when the percent amount is greater than 100.

<amount>, <percent_amount>

4008: invalid expiration date

Associated Inputs: alt_pay_method, cc_expire_mm, cc_expire_yyyy, credit_expiry_date, pay_method_type

Additional Comments: Dates must be in yyyy-mm-dd format. For update_payment_method_token_m, the date must be a future date.

<credit_expiry_date>

14035: Invalid client Plan id

Associated Inputs: client_plan_id, custom_rate_client_plan_instance_id

<client_plan_id>

14036: Invalid client service id

Associated Inputs: client_service_id, client_plan_instance_service_id, client_percent_eval_service_id, custom_rate_client_service_id

<client_service_id>, <client_plan_instance_service_id>, <client_percent_eval_service_id>

14041: Eligible Plan no/plan ID is required when Eligible service no/service ID is specified

Associated Inputs: eligible_plan_no, client_eligible_plan_id, eligible_service_no, client_eligible_service_id, plan_no, service_no, client_plan_id, client_service_id

<client_eligible_service_plan_ids>

14046: If you passed in an invalid plan_instance_no, this message will appear: "Invalid Plan instance number". If you passed in an invalid master_plan_instance_id, this message will appear: "Invalid master_plan_instance_id".

Associated Inputs: plan_instance_no, master_plan_instance_id, filter_plan_instance_no, percent_eval_plan_instance_no, client_plan_instance_id

Additional Comments: The plan_instance_no or master_plan_instance_id must belong to the account, or it is invalid. The percent_eval_plan_instance_no must belong to the account and also to the MPI given in input.

<percent_eval_plan_instance_no>, <client_plan_instance_id>

14047: If you passed in an invalid client_plan_instance_id, this message will appear: "Invalid client Plan instance identifier". If you passed in an invalid client_master_plan_instance_id , this message will appear: "Invalid client_master_plan_instance_id".

Associated Inputs: client_plan_instance_id, client_master_plan_instance_id, client_percent_eval_plan_instance_id

<client_plan_instance_id>

20014: invalid service type

 

20015: eligible service types must unique

Associated Input: eligible_service_type

<eligible_service_types>

20020: Credit expiration month is mandatory when expiration indicator is given as M.

Associated Inputs: credit_expiry_type_ind, credit_expiry_months

<credit_expiry_type_ind>, <credit_expiry_months>

20021: Invalid credit expiration Indicator.

Associated Input: credit_expiry_type

<credit_expiry_type_ind>

20022: Invalid credit expiration Indicator or frequency number.

Associated Inputs: credit_expiry_type_ind, frequency_interval_type

<credit_expiry_type_ind>, <frequency_interval_type>

20023: Invalid credit expiration date. Credit expiration date should be in future.

Associated Input: credit_expiry_date

<credit_expiry_date>

20024: Credit expiration date is mandatory when expiration indicator is given as D.

Associated Inputs: credit_expiry_type_ind, credit_expiry_date

<credit_expiry_type_ind>, <credit_expiry_date>

20025: The credit expiry month should be a positive integer.

Associated Input: credit_expiry_month

<credit_expiry_months>

20034: An unexpected value was entered in the service_code_option field. Please review this value and ensure it matches one of the allowable values.

Associated Input: service_code_option

<service_code_option>

20035: The service_code_option entered suggests handling that involves alt_service_no_to_apply or client_alt_service_id_to_apply. Please either update the service_code_option or include an input for alt_service_no_to_apply or client_alt_service_id_to_apply.

Associated Input: service_code_option, alt_service_no_to_apply, client_alt_service_id_to_apply

<service_code_option>, <alt_service_no_to_apply>, <client_alt_service_id_to_apply>

20036: The service_code_option entered suggests handling that does not involve alt_service_no_to_apply or client_alt_service_id_to_apply. Please update either the .service_code_option or remove the input from alt_service_no_to_apply or client_alt_service_id_to_apply

Associated Input: service_code_option, alt_service_no_to_apply, client_alt_service_id_to_apply

<service_code_option>, <alt_service_no_to_apply>, <client_alt_service_id_to_apply>

20037: The percent_eval_service_no input field only accepts recurring and recurring in arrears service types.

Associated Input: percent_eval_service_no

<percent_eval_service_no>

20038: Expiration date needs to be greater than application date of the last recurring service credit.

Associated Input: credit_expiry_date

<credit_expiry_date>

20039: Invalid frequency interval type.

Associated Input: frequency_interval_type

<frequency_interval_type>

20040: Credit expiry period cannot be more than 999 Days/Weeks/Months.

Associated Input: credit_expiry_period

<credit_expiry_period>

20041: Credit expiry period should be positive integer.

Associated Input: credit_expiry_period

<credit_expiry_period>

20042: Credit expiry period is required.

Associated Input: credit_expiry_period

<credit_expiry_period>

20043: Credit interval length is required.

Associated Input: frequency_interval_length

<frequency_interval_length>

20044: Credit interval length should be positive integer.

Associated Input: frequency_interval_length

<frequency_interval_length>

25020: Illegal characters entered

Associated Inputs: All character field inputs like firstname lastname, dunning_group_name, comments, etc.

All character field inputs like comments, etc.

Additional Guidance:

Input Fields
Field Name: Notes:
<reason_code>
Allowable values
Values Description
1 General Credit/Other
2 Inadequate Service Delivery
3 Billing / Pricing Issue
4 Service no longer desired
5 Customer Dissatisfaction
6 Installation Issue
9 Customer Return
11 System Testing
<eligible_service_types>
Allowable values
Values Description
RC Recurring Service
US Usage Service
TX Tax Service
AC Activation Service
MS (DEPRECATED) Miscellaneous Service
CN Cancellation Service
OR Order Based Service
MN Minimum Fee Service
RA Recurring Arrears Service
SC Surcharge Service
<credit_expiry_type_ind>

If you pass in a <credit_expiry_type_ind>, then <credit_expiry_period> is required.

Allowable values
Values Description
M Service credit expiration in months
W Service credit expiration in weeks
Y Service credit expiration in days
D Service credit expiration on specific date
<credit_expiry_months> You can pass in frequency_no,  credit_expiry_months or credit_expiry_date (based on credit_expiry_type_ind), and frequency_interval_type to create a recurring service credit with an expiration month/date. 
<credit_expiry_date>

You can pass in frequency_no,  credit_expiry_months or credit_expiry_date (based on credit_expiry_type_ind), and frequency_interval_type to create a recurring service credit with an expiration month/date.

The expiration date must be after the application date of the last service credit applied based on your specified frequency_no. Example: If you create a service credit to be applied in the next 2 months, the expiration date must be more than 2 months away.

<frequency_interval_type>

You can pass in <frequency_no>,  <credit_expiry_months>, or <credit_expiry_date> (based on <credit_expiry_type_ind>), and <frequency_interval_type> to create a recurring service credit with an expiration month/date.

If you pass 6 (weekly) or 7 (daily) into this field,  then you must also pass in a <frequency_interval_length>.

Allowable values
Values Description
1 Monthly
2 Bi-monthly
3 Quarterly
4 Semi-annually
5 Annually
6 Weekly
7 Daily
<credit_expiry_period>

To specify the credit expiration, pass a value into this field and the <credit_expiry_type_ind> field.

Example: If you pass Y (days) into the <credit_expiry_type_ind> field and 5 into the <credit_expiry_period> field, it means that the credit will expire 5 days after it is applied to an account.

  • This field is required if you passed in a <credit_expiry_type_ind>.
  • A specific date is not supported in this field. To specify the date on which a credit expires, use the <credit_expiry_date> field.
<frequency_interval_length>

Example: If you pass 4 into this field and 6 (weekly) into the <frequency_interval_type> field, then the service credit will be applied every 4 weeks.

This field is required if you passed 6 (weekly) or 7 (daily) into the <frequency_interval_type> field.

<service_code_option>
Allowable values
Values Description
  If no value is entered in this field, the universal service will be used unless a value is entered in the alt_service_no_to_apply or client_alt_service_id_to_apply field. Then the referenced service will be used instead.
0 Aria's universal service will be used to apply this service credit which excludes taxes.
1 The service associated with this service credit can be selected using the alt_service_no_to_apply or client_alt_service_id_to_apply input fields. Tax handling for the service credit will reflect the settings for the service selected.
2 The service associated with this service credit will match the charge line item. This will result in tax handling that matches the original charge.
  • Was this article helpful?