Error Codes
Response Structure
All APIs return a unified response structure. Business errors are identified by info.code:
{
"errorCode": 1,
"info": {
"code": "error.50001",
"description": "Site not found"
},
"body": null,
"successful": false
}
| Field | Description |
|---|---|
| errorCode | 0: success; 1: failure |
| info.code | Error code in the format error.<number> |
| info.description | Error description |
| successful | Whether the request succeeded |
Error Code Categories
Different error code segments are assigned according to the business:
| Category | Description |
|---|---|
| Device | Device offline, permissions, incorrect device type, etc. |
| Business | Defined according to different businesses |
Device
| Code | Description | Notes |
|---|---|---|
| error.70006 | Device not online | Device is offline |
| error.70007 | You do not have permission for this device | No permission to query/operate the device |
| error.70011 | The serial number and the check code do not match | SN and check code do not match |
Business
Account
| Code | Description | Notes |
|---|---|---|
| error.45001 | Account or current password is invalid | Incorrect account name or current password |
| error.45002 | New password does not meet the password policy | New password does not meet the password policy |
| error.45003 | New password must be different from current password | New password must be different from current password |
| error.45004 | Too many password reset attempts. Please try again after 24 hours. | Too many password reset attempts; try again after 24 hours |
| error.40019 | topic not access | Topic does not exist or no access permission |
Device Control
| Code | Description | Notes |
|---|---|---|
| error.46101 | Not a storage inverter | Not an energy-storage inverter |
| error.46102 | No battery connected | No battery connected to the inverter |
| error.46103 | Invalid control code | Invalid control code parameter |
Control Result Query
| Code | Description | Notes |
|---|---|---|
| error.42003 | Record not found | Record does not exist |
EV Charger
| Code | Description | Notes |
|---|---|---|
| error.47101 | Current control mode: independent operation. This command is supported only in inverter control mode | The charger is in standalone running mode; charging modes cannot be delivered |
| error.47102 | Charge mode not allowed in current state | The charger is not in standby; switching the charging mode is not allowed |
| error.47103 | Charging is active. Exit the current charge mode first | Charging is in progress; exit the current charging mode first |
| error.47104 | Invalid charge mode | Invalid chargeMode parameter; only FAST, GREEN, SCHEDULE are supported |
| error.47301 | Time group configuration is incomplete | Incomplete time group configuration |
| error.47302 | Invalid time group 1 start time | Invalid time group 1 start time |
| error.47303 | Time groups overlap | Time groups overlap |
| error.47304 | Invalid time group charge mode | Invalid time group charging mode; only FAST or GREEN is supported |
| error.47306 | Invalid time group ID | Invalid timeGroupId; only 1 and 2 are supported |
| error.47307 | Duplicate time group ID | Duplicate timeGroupId |
| error.47308 | Invalid time group 1 end time | Invalid time group 1 end time |
| error.47309 | Invalid time group 2 start time | Invalid time group 2 start time |
| error.47310 | Invalid time group 2 end time | Invalid time group 2 end time |
| error.47311 | No EV charger connected to the inverter | No EV charger is connected to the target inverter |
| error.47312 | Invalid time group enable flag | Invalid enable value; only 0 or 1 are supported |
| error.47313 | Incomplete optional time group configuration | Incomplete optional fields for a disabled time group |
| error.47701 | Current control mode: inverter control. This command is supported only in independent operation mode | The charger is under inverter control; this command is supported only in standalone running mode |
| error.47702 | Independent charging not allowed in current state | The charger is not in standby; starting charging is not allowed |
| error.47703 | Stop current charging first | The charger is already charging; stop the current charging first |