Skip to main content
Aria Knowledge Central

update_contact_m Guide

Updates contact information for Aria accounts or Billing Groups.

API Specification: update_contact_m
Required Fields:
  • <client_no>
  • <auth_key>
  • <acct_no>
  • <contact_ind>

Error Codes

Error Code/Description Associated Inputs

1001: unexpected error


 

1002: no data found


 
 

1004: authentication error

Associated Inputs: auth_key, client_id, 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


 

1016: invalid input, acct_no: (acct_no) is not a valid long, assignment_directive: (assignment_directive) is not a valid long, “billing_group_no: (billing_group_no) is not a valid long, threshold_billing_rule_no: (threshold_billing_rule_no) is not a valid long

Associated Inputs: alt_service_no_to_apply, assignment_directive, auto_skip_to_next_bill_date, client_billing_group_id, custom_rate_service_no/custom_rate_client_service_id, plan_instance_no, plan_instance_service_no, client_plan_instance_id, client_plan_instance_service_id, plan_instance_no, plan_instance_service_no, client_plan_instance_id, client_plan_instance_service_id, plan_instance_service_no, eligible_plan_no, eligible_service_no, email, force_master_bill_date_reset, fulfillment_only, include_master_plans, include_supp_plans, include_billing_groups, include_payment_methods, include_master_plans, include_supp_plans, include_billing_groups, include_payment_methods, invoice_no, length_months, end_date, limit, limit_records, modify_directive, contract_plan_instances_update, modify_directive, contract_plan_instances_update, offset, percent_amount, percent_eval_plan_instance_no, client_percent_eval_plan_instance_id, percent_eval_service_no, client_percent_eval_service_id, phone_ext, work_phone_ext, plan_unit_inst_status_cd, plan_units, reason_code, start_date, end_date, start_date, end_date, status_cd, acct_no, assignment_directive, billing_group_no, threshold_billing_rule_no

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

  • For the get_order_m API, this is the error code returned when the user passes an invalid order value for the <status_filter_cd> input which is other than the allowed values (0/null, 1, 2, 3, 4 and 5).
  • For the bulk_cancel_order_m API, invalid input can occur with the <order_status_directive> argument. Allowed values are 0, 1, 2, 3, 4/null, 5 and 6.
  • For the get_acct_coupon_details_m API, invalid input can occur with the <include_all_active> input parameter (values are 0, 1 or NULL).

Alternate Message Output

1016: username cannot be longer than 30 characters
1016: first_name cannot be longer than 30 characters
1016: last_name cannot be longer than 30 characters

Associated APIs: create_user_m, update_user_m

Associated Inputs: username, first_name, last_name


 

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.


 

5017: invalid iso country code

Associated Inputs country, bank_country_cd, bill_country


 

5018: account in uneditable status

Additional Comments: If the account is in an archived state, edit is not allowed.


 

6021: Invalid state_prov entered

Associated Inputs: bill_state_prov, state_prov, stmt_state_prov, bill_state_prov


 

25020: Illegal characters entered

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


 

26009: Invalid contact Type Indicator

Associated Input: contact_ind


 

26010: Invalid billing group number

Associated Inputs: billing_group_no


 

26011: Missing billing group identifier

Associated Inputs: billing_group_no, client_billing_group_id

Additional Comments: Billing group is required for contact type 2, 3, and 4.


 

Additional Guidance

Input Fields
Field Name: Notes:
<contact_ind>

When selecting Option 1, the service destination contact is also updated. Also for Option 1, other objects linked to this account contact will also be mapped to the updated contact. For Option 5, other objects linked to this account contact will be retained with the old contact. Specifically, "other objects" above refers to "payment method, billing group statement, and service destination".

Allowable Values
Values Description
1 Account Contact - Other objects linked to this account contact will also be mapped to the updated contact. Here, "other objects" refers specifically to payment method, billing group statement, and service destination.
2 Primary Billing Contact - Primary payment method’s contact of a given billing group.
3 Secondary Billing Contact - Refers to backup payment method’s contact of a given billing group.
4 Statement Contact - Statement contact of a given billing group.
5 Account Contact Only - Other objects linked to this account contact will be retained with the old contact. Here, "other objects" refers specifically to payment method, billing group statement, and service destination.
  • Was this article helpful?