Sets the status of a specified account and optionally indicates the number of days or date in the future on which the status change should go into effect.
This call can also reset the billing dates on the status change date for accounts changing from a non-billable to a billable status; or for accounts changing from a non-provisioned to provisioned status. This billing dates reset occurs for all plan instances on the account.
When the status is set to "archived," sensitive billing data are cleared. When the status is set to "deactivated," all plan instances on the account are set to "terminated."
| API Specification: |
update_acct_status_m |
| Required Fields: |
- <client_no>
- <auth_key>
- <acct_no> or <client_acct_id>
- <status_cd>
|
Error Codes
| Error Code/Description |
Associated Inputs |
|
|
|
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
|
|
5002: invalid account status code
Associated Inputs: status_cd
|
|
25020: Illegal characters entered
Associated Inputs: All character field inputs like firstname lastname, dunning_group_name, comments, etc.
|
|
5045: Status Code is mandatory
Associated Input: status_cd
|
|
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.
|
|
Additional Guidance
Input Fields
| Field Name |
Notes |
| <status_cd> |
Allowable Values
| Values |
Description |
| 0 |
DEACTIVATED |
| 1 |
ACTIVE |
| 32 |
REGISTERED PENDING ACTIVATION |
| 51 |
TEMPORARY SERVICE BAN |
| 99 |
PERMANENT |
| -99 |
ARCHIVED |
|
| <force_bill_date_reset> |
Allowable Values
| Values |
Description |
| |
Reset the billing dates when the status changes from non-provisionable to provisionable depending on client parameter 'RESET_DATES_ON_REPROVISIONED_STATUS' setting. |
| 0 |
Do not reset the billing dates regardless of client parameter setting. |
| 1 |
Reset the billing anniversary date to coincide with the status change date. |
| 2 |
Reset the billing anniversary date to coincide with the current anniversary date. |
|
| <alt_do_dunning> |
Allowable Values
| Values |
Description |
| true |
true |
| false |
false |
|
