ERROR MESSAGES =============================== All error messages showing in NCheck server configuration window, control panel, clients and API are showing in this chapter. In NCheck, all error messages are identified using error code as mentioned in :ref:`Error code` section and error messages have been divided in to 3 basic error types as mentioned in :ref:`Error types` section. Refer :ref:`Error messages list` section for all available error messages .. _Ref34119774: Error code ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Error code is a 4 digits unique number specified to identify error messages. Refer :ref:`Error types` section for more details about error codes for each error type. .. _Ref34119786: Error types ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The following error types available across NCheck server and clients. .. _Ref34120060: Communication errors ----------------------------------------------------------- Error showing in connection failures of NCheck server and clients. Error code format of the communication message is 1XXX. .. _Ref34120072: Application errors --------------------------------------------------------- NCheck server and clients specific errors are known as application errors. Error code format of the application errors is 2XXX. .. _Ref34203009: Validation errors -------------------------------------------------------- All input data from NCheck control panel and clients are validating before send to the server. It will ask to review and correct the inappropriate data with certain error messages. Error code format of the validation errors is 4XXX. Unidentified errors -------------------------------------- Errors other than :ref:`Communication errors` and :ref:`Application errors` are known as unidentified errors. Error code format of the unidentified errors is 4XXX. Common error messages ---------------------------------------- Errors could be appeared in any operation of NCheck control panel/clients are known as common errors. The error code of common error message is X9XX. .. _Ref38104916: Error messages list ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. list-table:: Error messages list of server and clients :widths: 1165 4230 3621 * - Error code - Error message - Description * - 1001 - Could not connect with MYSQL/MSSQL {server url}: {port} server. - This message may appear if the entered database server is not reachable/offline. Contact NCheck support for more detail. * - 1002 - Could not connect with the email server {host name}: {port}. - Email server may offline or not reachable. * - 1003 - Unable to connect with the FTP server {server name} - The FTP server is not reachable. * - 1901 - Unable to connect with the NCheck server {server URL} - This message may appear, if #. The Server has stopped #. The server is not reachable by clients in cloud or on-premises mode. * - - - * - 2001 - Trial license has expired. - After the 30-day trial period you must obtain a valid license. * - 2002 - License cannot be obtained - The license cannot be obtained if #. The license is not valid #. The internet is not available with the device to verify the license with the licensing server. Refer :ref:`License` section for more details or contact NCheck support . * - 2003 - The license is already in use. - This message may appear if the license file is already in use with another device. In this situation you may #. Deactivate the license in the current device from the `neurotechnology web site `_. #. Purchase valid license from the `web site `_. * - 2004 - The license limit has exceeded. Please contact the administrator/ NCheck support for more details - This message appears if the number of available licenses in the multiple license file/license dongle has exceeded. * - 2005 - No valid NCheck license has found. - The selected file, license code or dongle has no valid license. * - 2006 - Invalid SSL certificate file. - The selected SSL file should be a valid file with system certificate and private key. * - 2007 - Invalid key store password or SSL key alias. - The key store password or SSL key alias of the selected SSL certificate is invalid. * - 2008 - Invalid port number. Please select the valid port. - The selected port is not available. * - 2009 - Port is used by another application. - The added port should not be used by another application to user with NCheck server. * - 2010 - Invalid SQLite database or password. Please recheck the database file or password. - This message may appear for the selected SQLite database, if #. Selected SQLite database file is not a database file #. Database password is incorrect. * - 2011 - SQLite database migration has failed with the following errors. #. Error 1 #. Error 2 - SQLite database migration has been designed to migrate old databases to be compatible with installed NCheck server. Certain migration rules have been applied in each version. In case of migration failure, it will show the associate error messages with version. Please contact the NCheck for more details. * - 2012 - {database name} could not be found. - The database name is not available in the MYSQL/MSSQL server. * - 2013 - Invalid MYSQL/MSSQL username and password. - This message may appear if, #. Entered username has not existed #. Username or Password is incorrect. #. Entered user does not have administrator privileges. * - 2014 - Data restore has failed. Invalid backup file. - To restore backup, the backup file should be available with all data as mentioned in :ref:`Restore database` section. * - 2015 - Data restore has failed. Could not decrypt the file with the given password. - The backup decrypt password is incorrect. Please try with the correct password again. * - 2017 - Could not connect with the email server {host}: {port}. Invalid username or password. - This message may appear for the email server if #. The username has not existed #. Incorrect username and password * - 2018 - Invalid username or password. - This message may appear if #. The username has not existed Contact the administrator or NCheck support for more details. #. Incorrect password Reset the password if you don not remember the password. * - 2019 - Could not find the user associated with {email address} email address. - This message may appear if the NCheck could not be able to find the user associated with the email when reset password. Contact the Administrator for more details. * - 2020 - Selected file is not a valid image file. - All image files must be valid images file with allowed image extensions. * - 2021 - Employee code already exists. - Employee code could not be duplicated. * - 2022 - Barcode ID is already available for different user - Barcode id could not be duplicated with barcode id of another user. * - 2023 - RFID is already available for different user - RFID could not be duplicated with barcode id of another user. * - 2024 - Could not enroll selected face/finger/iris image. - This error may appear if, #. The :ref:`Enrollment threshold` has not satisfied #. The face/fingerprint image has not satisfied the :ref:`Face confidence` / :ref:`Face quality` / :ref:`Fingerprint quality` . Please contact NCheck support form more details. * - 2025 - Capture face with enough lighting - The face image should be clear enough for extraction. If the captured image is not clear this message will appear. * - 2026 - The biometric image has already been enrolled for another user - A biometric image could not be * - 2027 - User group code already exists. - The user group code could not be duplicated. * - 2028 - The shift name has already existed. - Shift names could not be duplicated. * - 2029 - The roster name has already existed. - Roster name could not be duplicated. * - 2030 - The holiday name has already existed for the selected date. - Could not add same holiday for the same date. * - 2031 - You already have applied for the leave(s) for start date – end date. - Multiple leaves could not be added on the same day. * - 2032 - Could not exceed the available number of leaves for {leave type name} leave type. - Cannot exceed the number of available leaves in each leave type when add leaves. Refer :ref:`Configure leave type` section to change number of leaves in each leave type or :ref:`Configure leave type` section to change the leaves for user. Users, Contact administrator for more details. * - 2033 - A roster item already existed on {date} with {shift name} shift and {user group name} user group. - A roster item cannot be duplicated with date, shift name and user group name. * - 2034 - {user 1, user 2….} user(s) have been added as additional staff for the {shift name} shift on {date}. - Cannot duplicate user as additional staff for the selected shift and date. * - 2035 - Failed to email registration token. - This message may appear if, #. The :ref:`Email notification settings` has not been configured. #. No email is available for the user * - 2036 - The name of a peripheral configuration has already existed. - The peripheral name could not be duplicated. * - 2037 - Could not record events. The device has been blocked - Clocked devices are not allowed for enrolling biometrics and record events. This message appeared when the devices is blocked. Refer block/unblock device as mentioned in :ref:`Device detail view` section for more details. * - 2038 - Could not enroll events. The device has been blocked - * - 2039 - Could not capture barcode. The device has been blocked - * - 2040 - Could not capture RFID. The device has been blocked - * - 2041 - The API has been blocked - This message appears when the API is blocked. Refer block/unblock device as mentioned in :ref:`Device detail view` section for more details * - 2042 - Could not record events. The user has been blocked - Blocked users are not allowed to record attendances. Refer :ref:`Block/unblock` section for more details of block/unblock users. * - 2043 - Could not record the event. Check-in time has restricted - Event cannot record when the check-in time is not in the check-in restricted interval. Please refer :ref:`Add/edit shift` section for more details. * - 2044 - Could not record the event. Check-out time has restricted - Event cannot record when the check-out time is not in the check-out restricted interval. Please refer :ref:`Add/edit shift` section for more details. * - 2045 - Could not email reports for the recipients - This message may appear if the :ref:`Email notification settings` has not configured. * - 2046 - Invalid FTP file path - This message appears if the selected FTP path does not exist. * - 2047 - Invalid FTP username or password - This message may appear if, #. Username does not exist for the given FTP #. Incorrect password * - 2048 - Biometric re-extraction has failed on following images. #. {images list} - This error may appear if, #. The :ref:`Enrollment threshold` has not satisfied #. The face/fingerprint image has not satisfied the :ref:`Face confidence` / :ref:`Face quality` / :ref:`Fingerprint quality` . Please contact support for more details. * - 2049 - Your current subscription has blocked. Please settle the outstanding amount and try again. - You are not allowed to change the plan without paying outstanding amount of the current plan. * - 2050 - Customer has blocked. Please contact support. - The customer can be blocked, if #. If the credit period of the subscription has passed. Please pay the outstanding amount to enable the account. If the customer account has been blocked by NCheck system administrator. Please contact NCheck support for more details. * - 2051 - Failed to register with the NCheck server {server URL} - Make sure that the server is running. * - 2052 - Failed to register with the registration code - Make sure that the registration code is correct. Delete the existing registration code and generate new one in case you cannot register. * - 2053 - The registration token has already been used. Please generate new registration code or contact administrator. - The registration token can be used to register a single device. * - 2054 - Could not discover the NCheck server URL. - The server discovery button of the clients in on-premises mode is working if the server and clients are operating within the same local area network. Otherwise, this message will be shown. * - 2055 - Device has not registered. Please register for the device first. - The device should be enrolled before record attendances. Please refer :ref:`Register clients` section for more details. * - 2056 - The location is restricted. You are not allowed record attendance from this location - User is not allowed to record attendances in restricted locations. Refer :ref:`Location restrictions` section for more details. * - 2057 - You have already checked-in/checked-out. Please try again in {number of seconds} seconds. - NCheck clients are not allowed to record events in certain time interval defined by the administrator to avoid duplicates events. * - 2058 - Attendances time has been restricted. Please contact the administrator for more details. - The attendance time is restricted if #. No Valid shift is available for the event #. Overtime restriction has been added Please contact the administrator for more details. Standalone users please contact NCheck support. * - 2059 - No match was found. Please make sure that face/fingerprint/iris templates have been enrolled before record attendance. - The biometric used to record events does not match with the enrolled biometrics in the server. Please contact administrator to enroll your face to record attendances. Standalone users please contact NCheck support. * - 2060 - Failed to identify the face/fingerprint/iris. Please try again. - This message appears in case of face extraction in the server side. Please contact the administrator if you receive this message continuously. Standalone users please contact NCheck support. * - 2061 - Data restore has failed. Invalid backup file. - To restore data successfully, any file(s) or key value pairs in backup file(s) should not be altered. Otherwise, data restore can fail. Refer :ref:`Backup data` section for more details. * - 2062 - Data import failed. Invalid password. - The password must be correct to import the file. * - 2063 - Data import failed. The selected file could not be imported. - The CSV files guidelines must be fulfilled as mentioned in :ref:`Import and Export information` to import data successfully. * - 2064 - Could not record attendances. Invalid user id input. - Attendances may fail if the employee id/barcode/RFID does not match users. * - 2065 - Could not record attendances. The peripherals are not ready. Please try again. - NCheck Admin client may require time to initialize/refresh all connected peripherals. * - 2066 - Invalid password. Check the password again. - The message could appear when trying to sign in the client’s standalone/offline control panel. * - 2067 - User not allowed to Check-in while on Restricted Leave! - User check-ins can be limited for the user group premises. If the check-in count is greater than the maximum occupancy for group premises, check-in will be restricted. Refer :ref:`Maximum occupancy for group premises` setting for more details. * - - - * - 3001 - Mobile/telephone numbers are not valid for the selected country/region. Please recheck again. - The telephone/mobile number should be followed the certain format according to the selected country/region. * - 3002 - Email address is not valid. - The email address should be followed the correct format. * - 3003 - Password does not match. - Password and confirmation password should be equal. * - 3004 - Password must contain at least 6 characters with one number. - Every password has defined in NCheck control panel and clients must contain 6 characters and one digit for enhance the security. * - 3005 - Barcode scanner could not be found. - This message may appear if #. The connected barcode scanner is not compatible with the device #. No barcode scanner has connected with the device Refer :ref:`Id peripherals` section for more details. * - 3006 - RFID scanner Could not be found - This message may appear if #. The connected RFID scanner is not compatible with the device #. No RFID scanner has connected with the device Refer :ref:`Id peripherals` section for more details. * - 3007 - The camera could not be found. - This message may appear if #. The connected camera is not compatible with NCheck #. No camera has connected with the device. Refer :ref:`Face` section form more details. * - 3008 - Fingerprint scanner could not be found - This message may appear if, #. The connected fingerprint scanner is not compatible with NCheck #. No fingerprint scanner has connected with the device. Refer :ref:`Fingerprint` section for more details. * - 3009 - Iris scanner could not be found - This message may appear if, #. The connected Iris scanner is not compatible with NCheck #. No Iris scanner has connected with the device. Refer :ref:`Iris` section for more details * - 3010 - Could not record overtime. Overtime should not be greater than the max overtime hours. - Overtime hours could not exceed the max overtime hours. * - 3011 - Only 5 decimal places are allowed in latitude and longitude values. - For latitude and longitude values, 5 decimal places accuracy is allowed. Round the values if it exceeds the 5 decimal places. * - 3012 - The current password is incorrect - To change the password of the clients standalone control panel, the correct current password should be given. * - - - * - - - * - - - * - 4001 - Unidentified errors occurred during data backup. Please contact administrator or NCheck support for more details. - This message could appear when unidentified error occurred within the system. Contact administrator or NCheck support for more details. * - 4002 - Unidentified errors occurred during data restore. Please contact administrator or NCheck support for more details. - * - 4003 - Unidentified errors occurred during data import. Please contact administrator or NCheck support for more details. - This message could appear when unidentified error occurred in the system. Contact administrator or NCheck support for more details. * - 4004 - Unidentified errors occurred during data export. Please contact administrator or NCheck support for more details. -