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>

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.

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

<client_no>, <auth_key>

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, 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

<client_no>, <acct_no>, <contact_ind>, <billing_group_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.

<birthdate>, <application_date>

5017: invalid iso country code

Associated Inputs country, bank_country_cd, bill_country

<country_cd>

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

<state_prov>

25020: Illegal characters entered

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

<auth_key>, <client_billing_group_id>, <first_name>, <middle_initial>, <last_name>, <company_name>, <address1>, <address2>, <address3>, <city>, <locality>, <state_prov>, <country_cd>, <postal_cd>, <phone>, <phone_ext>, <cell_phone>, <work_phone>, <work_phone_ext>, <fax>, <email>, <birthdate>, <client_acct_id>, <application_id>, <application_date>, <alt_caller_id>, <attach_qualifier_option>, <qualifier_name>, <qualifier_value>

26009: Invalid contact Type Indicator

Associated Input: contact_ind

<contact_ind>

26010: Invalid billing group number

Associated Inputs: billing_group_no

<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.

<billing_group_no>, <client_billing_group_id>
  • Was this article helpful?