Understand Agent Error Codes
Error Format Overview
Errors in the TMS and the agent are formatted as follows:
'[L/LS/S]-[module code]-[error code]'
Example: 'L_01_28'
Error Prefix Explanation
'L': Indicates a general error originating from the terminal.
'LS': Denotes a network-related error from the terminal.
'S': Represents a general error from the WizarView server.
Module code
This part of the error code specifies the module in the system where the error occurred. (Details of module codes should be listed here.)
01: Adapt agent parameter
02: Adapt device parameter
03: Adapt network parameter
04: Reset administrator password
05: Uninstall app from terminal
06: Update app
07: Update communication key
08: Upload app status
09: Upload app parameter status
10: Upload system event
11: Upload app which terminal has installed
12: Upload log
13: Terminal register
14: Upload error log when turn on terminal
15: Update firmware patch
16: Update Unionpay key
17: Upload app info
A: Administrator login
B: Administrator logout
C: Task when turn on terminal
D: Modify Administrator password
DT: Download App/firmware/parameter file
E: Mount SD Card
F: Collect system event
G: Tip message of install firmware
H: Install app
I: Install parameter file
J: Install firmware
Error code
The error code is a specific identifier for the type of error. (A list of common error codes should be provided here.)
For L
0: Network error
999: Unknown error
10: Install app error
11: Uninstall app error
12: Install parameter error
13: Install firmware error
14: Register address can not access
15: Input register address is same with the default register address
16: Communication key message parsing error
17: Can not identify the message from WizarView
18: Verify signature fail by certificate
19: Verify signature fail by communication key
20: HSM error, generate CSR fail
21: HSM error, encrypt data fail
22: Terminal has registered
23: File I/O error
24: Download app error
25: Operation running
26: File is not exist
27: Can not find the app
28: Return fail when call interface
29: The interface is not exist
30: Verify administrator password fail
31: Can not identify file format
32: Can not parse command from WizarView
33: Illegal message from WizarView
34: Customer serial number is null
35: Firmware has existed
36: Download module are working
37: Terminal does not register
38: System event monitor initialize fail
39: Public certificate lost from HSM
40: Encrypt fail from HSM
41: HSM does not initialize
42: SN is not exist
43: Mount SD card fail
44: Terminal initialize fail
45: Have not connected network
46: Download fail, unknown reason
47: Download fail, please check from terminal
48: Can not connect to WizarView
49: Terminal is initializing
50: No permission
-888: Parameter error
For S
0:Close reqAppList or Firmware version name don‘t match regex
2:Sn is null
3:Invalid csr
4:Xmpp password of login is empty
5:Communication cert lost
6:Communication cert changed
707:Sn does not exist
705:Communication cert lost
709:Verify signature fail by cert
710:Verify signature fail by key
8:Terminal has none certificate
11:Add openfire user fail or Add MQTT user fail
12:Not define register rule
13:No matched register rule
14:Generate cert error
15:Pinpad key changed
16:Pinpad key lost
17:Communication key lost
18:Not define signature type
20:Request not supported
25:Obtaining sn key
26:Sn Key and package name no changed
27:Terminal has no sn key.
28:Can not obtain sn key
29:No firmware is configured!
30:Add firmware patch task success
31:Patching task is added
32:Patch is already exists
33:Add patching task failed
34:Old firmware version does not exist
35:New firmware version does not exist
36:Execute external command failed
37:Upload patch to wizarview failed
38:Calculate patch failed
39:No matched terminal model
40:The NEW group lost
48:The firmware is already the latest version
50:certificate is not exist
51:request sig error
52:request sig failed whth unknown exception
53:Unknown pakcage name or label
54:The terminal kernel type isn't match with target firmware
55:The transfer code is not found
56:The transfer code is expired
57:The transfer code is invalid - User is locked
58:The transfer code is invalid - User is closed
59:The terminal model type isn''t match with target firmware.
60:The terminal lock rule is unchanged
61:The agent need upgrade
62:The terminal system customer type isn't match with target firmware
65:Regsiter message need signature
66:Invalid register certificate
67:Invalid register signature
68:Sig message error on server
70:Soft sim - no device with imei
71:Soft sim lack imei or flow param
72:Soft sim no order on device
73:No remote control service available
74:Firmware model not match
75:Softsim service error
80:Terminal not visible
81:The firmware patch is disabled
82:The firmware patch message version lost
83:Lost pakcage name
84:Lost app name
85:Invalid JSON data
86:Upload application log setting is not available
87:The upload application log request is missing parameters
1012:Terminal has binding with app
For LS
400: Bad request
403: Forbidden
404: Not found the resource
500: Internal server error
503: Bad gateway
504: Gateway timeout
Common error codes
List out the common error codes, their meanings. This part is crucial for users to understand what each error code signifies.
999
The terminal failed to register due to unknown reasons, please click Update Now.
L_12_33
Server message is illegal
L_13_06
Terminal certificate conflict
L_13_20
CSR failed to generate
L_15_13(29)
Update firmware patch failed because because the interface is not exist the API version needs update. BAD_API_VERSION = 29.
L_I_12(27)
Apk is not installed according to the package name. PACKAGE_OR_APPINFO_NOT_FOUND = 27.
L_I_13
Install Firmware failed because an unexpected exception. INSTALL_FIRMWARE_FAILED = 13.
L_I_13(29)
Install Firmware failed because the interface is not exist the API version needs update. BAD_API_VERSION = 29.
L_I_28
Install Firmware failed because returning fail when call interface. INVOKE_ADDITIONAL_API_FAILED = 28.
L_IA_10(-1)
Install apk failed because the package is already installed. INSTALL_FAILED_ALREADY_EXISTS = -1.
L_IA_10(-2)
The package archive file is invalid. INSTALL_FAILED_INVALID_APK = -2.
L_IA_10(-3)
Install apk failed because the URI passed in is invalid. INSTALL_FAILED_INVALID_URI = -3.
L_IA_10(-4)
Install apk failed because the package manager service found that the device didn't have enough storage space to install the app. INSTALL_FAILED_INSUFFICIENT_STORAGE = -4.
L_IA_10(-5)
Install apk failed because the package is already installed with the same name. INSTALL_FAILED_DUPLICATE_PACKAGE = -5.
L_IA_10(-6)
Install apk failed because the requested shared user does not exist. INSTALL_FAILED_NO_SHARED_USER = -6.
L_IA_10(-7)
Installed package has a different signature than the new package. INSTALL_FAILED_UPDATE_INCOMPATIBLE = -7.
L_IA_10(-8)
Install apk failed because the package is requested a shared user which is already installed on the device and does not have matching signature. INSTALL_FAILED_SHARED_USER_INCOMPATIBLE = -8.
L_IA_10(-9)
The new package uses a shared library that is not available. INSTALL_FAILED_MISSING_SHARED_LIBRARY = -9.
L_IA_10(-10)
Install apk failed because the package uses a shared library that is not available. INSTALL_FAILED_REPLACE_COULDNT_DELETE = -10.
L_IA_10(-11)
Install apk failed because the package failed while optimizing and validating its dex files, either because there was not enough storage or the validation failed. INSTALL_FAILED_DEXOPT = -11.
L_IA_10(-12)
Can't install because the current SDK version is older than that required by the package. INSTALL_FAILED_OLDER_SDK= -12.
L_IA_10(-13)
Can't install because provider name is already used by other apk. INSTALL_FAILED_CONFLICTING_PROVIDER= -13.
L_IA_10(-14)
Install apk failed because the package failed because the current SDK version is newer than that required by the package. INSTALL_FAILED_NEWER_SDK = -14.
L_IA_10(-15)
Install package failed because it is a test-only package. INSTALL_FAILED_TEST_ONLY = -15.
L_IA_10(-16)
Install apk failed because the package being installed contains native code, but none that is compatible with the the device's CPU_ABI. INSTALL_FAILED_CPU_ABI_INCOMPATIBLE = -16.
L_IA_10(-17)
Install apk failed because the package uses a feature that is not available. INSTALL_FAILED_MISSING_FEATURE = -17.
L_IA_10(-18)
Install apk failed because a secure container mount point couldn't be accessed on external media. INSTALL_FAILED_CONTAINER_ERROR = -18.
L_IA_10(-19)
Install apk failed because the package couldn't be installed in the specified install location. INSTALL_FAILED_INVALID_INSTALL_LOCATION = -19.
L_IA_10(-20)
Install apk failed because the media is not available. INSTALL_FAILED_MEDIA_UNAVAILABLE = -20.
L_IA_10(-21)
Install apk failed because the verification timed out. INSTALL_FAILED_VERIFICATION_TIMEOUT = -21.
L_IA_10(-22)
Install apk failed because the verification did not succeed. INSTALL_FAILED_VERIFICATION_FAILURE = -22.
L_IA_10(-23)
Install apk failed because the package changed from what the calling program expected. INSTALL_FAILED_PACKAGE_CHANGED = -23.
L_IA_10(-24)
Install apk failed because the package is assigned a different UID than it previously held. INSTALL_FAILED_UID_CHANGED = -24.
L_IA_10(-25)
Install apk failed because WizarView apk version is lower than terminal used apk version
L_IA_10(-26)
Install apk failed because the package has target SDK low enough to not support runtime permissions. INSTALL_FAILED_PERMISSION_MODEL_DOWNGRADE = -26.
L_IA_10(-100)
Install apk failed because the package does not end with the expected '.apk' extension. INSTALL_PARSE_FAILED_NOT_APK = -100.
L_IA_10(-101)
Install apk failed because the package is unable to retrieve the AndroidManifest.xml file. INSTALL_PARSE_FAILED_BAD_MANIFEST = -101.
L_IA_10(-102)
Install apk failed because the package encountered an unexpected exception. INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION = -102.
L_IA_10(-103)
Did not find any certificates in the .apk. INSTALL_PARSE_FAILED_NO_CERTIFICATES = -103. Maybe developer sign the apk with wrong signature format, e.g. Q2 does not support signature format v2.
L_IA_10(-104)
Inconsistent certificates on the files in the .apk. INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES = -104.
L_IA_10(-105)
Install apk failed because the package encountered a CertificateEncodingException in one of the files in the .apk. INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING = -105.
L_IA_10(-106)
Install apk failed because the package encountered a bad or missing package name in the manifest. INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME = -106.
L_IA_10(-107)
Install apk failed because the package encountered a bad shared user id name in the manifest. INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID = -107.
L_IA_10(-108)
Install apk failed because the package encountered some structural problem in the manifest. INSTALL_PARSE_FAILED_MANIFEST_MALFORMED = -108.
L_IA_10(-109)
Install apk failed because the package does not find any actionable tags (instrumentation or application) in the manifest. INSTALL_PARSE_FAILED_MANIFEST_EMPTY = -109.
L_IA_10(-110)
Install apk failed because the system failed to install the package because of system issues. INSTALL_FAILED_INTERNAL_ERROR = -110.
L_IA_10(-111)
Install apk failed because WizarView apk version is lower than terminal used apk version. INSTALL_FAILED_VERSION_DOWNGRADE = -111.
L_IA_10(-112)
Install apk failed because the package doesn't have a native library for terminal cpu architecture. INSTALL_FAILED_NO_MATCHING_ABIS = -112.
L_IA_10(-1000000)
Install apk failed because a reason undefined so far. INSTALL_FAILED_OTHER = -1000000. If agent version is lower than 5239, [L_IA_10(-112)] is included.
L_IA_13(66)
Firmware installation service execution failed. POSSYS_UNZIP_FAIL = 66.
LS_XX_49
Can't connect to wizarView due to network problem.
LS_13_0
WizarView server has unknown error.
L_DT_47
The terminal can not access download server, because of local network problem or download server is down.
Last updated