> For the complete documentation index, see [llms.txt](https://portal-integracao.intelbras.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://portal-integracao.intelbras.com.br/catracas-ct-3000-2pb/parametros-retornados/parametros-retornados-em-requisicoes.md).

# Parâmetros Retornados em Requisições

#### Códigos de Erro em Requisições

{% hint style="warning" %}
Dispositivos em firmware mais recentes podem retornar os seguintes códigos de erros como resposta as requisições
{% endhint %}

| Código                                         | Decimal   | Descrição                                                                                                                                     |
| ---------------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| accessControlErrorInvalidCredential            | 286064897 | //Invalid credentials                                                                                                                         |
| accessControlErrorInvalidPassword              | 286064898 | //wrong password                                                                                                                              |
| accessControlErrorInvalidFingerprintData       | 286064899 | //The issued fingerprint data is wrong                                                                                                        |
| accessControlErrorInvalidFaceData              | 286064900 | //The issued face data is wrong                                                                                                               |
| accessControlErrorInvalidCardData              | 286064901 | //The issued card data is incorrect                                                                                                           |
| accessControlErrorInvalidUserData              | 286064902 | //The issued user data is wrong                                                                                                               |
| accessControlErrorGetSubServiceFailed          | 286064903 | //Failed to get capability set sub-service                                                                                                    |
| accessControlErrorGetServiceMethodsFailed      | 286064904 | //Failed to get service method                                                                                                                |
| accessControlErrorGetSubCapsFailed             | 286064905 | //Failed to get sub-capability set                                                                                                            |
| accessControlErrorExceedMaxCapacity            | 286064912 | //Exceeds the maximum capacity of the device                                                                                                  |
| accessControlErrorExceedMaxInsertRate          | 286064913 | //The maximum insertion speed allowed by the device has been reached                                                                          |
| accessControlErrorEraseFingerprintFailed       | 286064914 | //Fingerprint data purge failed when deleting users                                                                                           |
| accessControlErrorEraseFaceFailed              | 286064915 | //Face data purging fails when deleting users                                                                                                 |
| accessControlErrorEraseCardFailed              | 286064916 | // Card data purging fails when deleting users                                                                                                |
| accessControlErrorNoRecords                    | 286064917 | //record does not exist                                                                                                                       |
| accessControlErrorNoMoreRecords                | 286064918 | //no more records                                                                                                                             |
| accessControlErrorDuplicateRecord              | 286064918 | //The record already exists. The record already exists when the card or fingerprint data is issued.                                           |
| accessControlErrorExceedMaxFingerPrintsPerUser | 286064920 | //Exceeds the maximum number of fingerprints that an user can enroll                                                                          |
| accessControlErrorExceedMaxCardsPerUser        | 286064921 | //Exceeds the maximum number of cards that an user can enroll                                                                                 |
| accessControlErrorExtractFaceEigenvalueFailed  | 286064922 | //Failed to extract face feature value                                                                                                        |
| accessControlErrorMaxPhotoFileSizeExceeded     | 286064923 | //Maximum file size limit exceeded                                                                                                            |
| accessControlErrorMaxFacePhotosExceeded        | 286064924 | //Exceeded maximum number of face photos                                                                                                      |
| accessControlErrorRelevantUserNotFound         | 286064925 | //The User corresponding to the data does not exist                                                                                           |
| accessControlErrorPhotoAlreadyExist            | 286064926 | //Photo already exists                                                                                                                        |
| accessControlErrorInvalidPhotoFormat           | 286064927 | //The photo is in the wrong format, such as the wrong header of the jpg file                                                                  |
| accessControlErrorExceedMaxManagerUser         | 286064928 | //Exceeded maximum number of administrators                                                                                                   |
| accessControlErrorUserAlreadyExist             | 286064929 | //User already exists                                                                                                                         |
| accessControlErrorCardAlreadyExist             | 286064930 | //Card number already exists                                                                                                                  |
| accessControlErrorFingerprintAlreadyExist      | 286064931 | //Fingerprint already exists                                                                                                                  |
| accessControlErrorCitizenIDNoAlreadyExist      | 286064932 | //Citizen ID number already exists                                                                                                            |
| accessControlErrorFingerprintDownloadFail      | 286064933 | // Failed to download fingerprint through URL download method                                                                                 |
| accessControlErrorNotSupportNormalUser         | 286064934 | //Does not support issue ordinary users                                                                                                       |
| accessControlErrorAccountInUse                 | 286064935 | //Account is logging in                                                                                                                       |
| businessCommonErrorBadRequest                  | 268632321 | ///< The state machine of the device, in the C state, the device does not accept the service requests that are only available in the B state. |
| businessCommonErrorInvalidArgs                 | 268632322 | ///The parameter value, quantity, type, range, etc. do not meet the requirements                                                              |
| businessCommonErrorInProgress                  | 268632323 | ///The business is being processed, and repeated business requests are not accepted.                                                          |
| businessCommonErrorUnKnownError                | 268632324 | //An unknown error occurred during business processing                                                                                        |
| businessCommonErrorNoResource                  | 268632325 | // Insufficient resources during processing of business requests                                                                              |
| businessCommonErrorUnSupported                 | 268632326 | //This service is currently not supported                                                                                                     |
| businessCommonErrorTimeout                     | 268632327 | //Business processing timed out                                                                                                               |
| businessCommonErrorTooManyRequests             | 268632328 | //Too many business requests issued                                                                                                           |
| businessCommonErrorRequestedTooMuchData        | 268632329 | //Too much data was fetched for the device to process                                                                                         |
| businessCommonErrorBatchProcessError           | 268632336 | //An error occurred during the batch execution of the business                                                                                |
| businessCommonErrorOperationCancelled          | 268632337 | //For some reason, the business was canceled                                                                                                  |
| businessCommonErrorDeviceWarmUP                | 268632577 | //The device is not ready for business processing                                                                                             |
| businessCommonErrorDeviceInvalid               | 268632578 | //The device model is incorrect or due to customization, so that further processing cannot be performed                                       |
| businessCommonErrorDeviceUnavailable           | 268632579 | //Unable to get device status information                                                                                                     |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://portal-integracao.intelbras.com.br/catracas-ct-3000-2pb/parametros-retornados/parametros-retornados-em-requisicoes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
