> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Lista de erros do Midaz

> As APIs do Midaz retornam um objeto de erro estruturado, com um código estável, o status HTTP e uma mensagem, para você diagnosticar rapidamente problemas do ledger e corrigi-los.

A API do Midaz retorna erros como um objeto problem details do [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457), enviado com o tipo de conteúdo `application/problem+json`:

```json theme={null}
{
   "type": "https://errors.lerian.studio/v1/<error_code>",
   "title": "<error_title>",
   "status": <http_status>,
   "detail": "<error_message>",
   "code": "<error_code>"
}
```

**Definições dos campos**

* `type`: Uma URI que identifica o tipo do erro, construída como `https://errors.lerian.studio/v1/` seguida pelo código do erro.
* `title`: Um breve resumo do problema.
* `status`: O código de status HTTP da resposta.
* `detail`: Orientação detalhada para resolver o erro. A tabela abaixo lista esse conteúdo na coluna `message`.
* `code`: Um identificador único e estável para o erro.
* `entityType`: A entidade à qual o erro se refere (por exemplo, `Organization`). Presente apenas quando aplicável.

<Note>
  Para erros do lado do servidor (HTTP 5xx), `title` e `detail` são higienizados para valores genéricos, para que causas internas nunca vazem. Use `code` e `type` para identificar o erro.
</Note>

**Detalhes de erro em nível de campo**

Para problemas específicos de campos individuais, um array `errors` lista cada campo com seu problema.

Exemplos:

<CodeGroup>
  ```json Missing Required Fields theme={null}
  {
     "type": "https://errors.lerian.studio/v1/0009",
     "title": "Missing Fields in Request",
     "status": 400,
     "detail": "Your request is missing one or more required fields: [legalName]. Please refer to the documentation to ensure all necessary fields are included in your request.",
     "code": "0009",
     "entityType": "Organization",
     "errors": [
        { "location": "legalName", "message": "legalName is a required field" }
     ]
  }
  ```

  ```json Invalid Field Values theme={null}
  {
     "type": "https://errors.lerian.studio/v1/0047",
     "title": "Bad Request",
     "status": 400,
     "detail": "The server could not understand the request due to malformed syntax. Please check the listed fields and try again.",
     "code": "0047",
     "errors": [
        { "location": "legalName", "message": "legalName is a required field." },
        { "location": "parentOrganizationId", "message": "parentOrganizationId must be a valid UUID" }
     ]
  }
  ```

  ```json Unexpected Fields theme={null}
  {
     "type": "https://errors.lerian.studio/v1/0053",
     "title": "Unexpected Fields in the Request",
     "status": 400,
     "detail": "The request body contains more fields than expected. Please send only the allowed fields as per the documentation. The unexpected fields are listed in the fields object.",
     "code": "0053",
     "errors": [
        { "location": "unknownField", "message": "unexpected field", "value": "..." }
     ]
  }
  ```
</CodeGroup>

## Erros do Midaz

***

Consulte a tabela a seguir para os códigos de erro e suas descrições:

| `code` | `title`                                               | `message`                                                                                                                                                                                                                               |
| ------ | ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 0001   | Erro de Ledger Duplicado                              | Já existe um ledger com o nome especificado nesta divisão. Renomeie o ledger ou escolha uma divisão diferente.                                                                                                                          |
| 0002   | Conflito de Nome de Ledger                            | Já existe um ledger chamado \{\{name}} na sua organização. Renomeie o ledger ou, se quiser usar o mesmo nome, considere criar um novo ledger para uma divisão diferente.                                                                |
| 0003   | Nome ou Código de Ativo Duplicado                     | Já existe um ativo com o mesmo nome ou código no seu ledger. Modifique o nome ou o código do novo ativo.                                                                                                                                |
| 0004   | Exigência de Código em Maiúsculas                     | O código deve estar em maiúsculas. Verifique se o código está em formato maiúsculo e tente novamente.                                                                                                                                   |
| 0005   | Conformidade com o Padrão de Código de Moeda          | Ativos do tipo moeda devem estar em conformidade com o padrão ISO-4217. Use um código de moeda que siga as diretrizes ISO-4217.                                                                                                         |
| 0006   | Erro de Campo Não Modificável                         | Sua requisição inclui um campo que não pode ser modificado. Revise a requisição e tente novamente, removendo os campos não editáveis.                                                                                                   |
| 0007   | Entidade Não Encontrada                               | Nenhuma entidade foi encontrada para o ID informado. Use o ID correto da entidade que você está tentando gerenciar.                                                                                                                     |
| 0008   | Ação Não Permitida                                    | Esta ação não é permitida no ambiente atual. Entre em contato com um administrador se acredita que isso é um erro.                                                                                                                      |
| 0009   | Campos Ausentes na Requisição                         | Sua requisição está sem um ou mais campos obrigatórios. Consulte a documentação para garantir que todos os campos necessários estejam incluídos na requisição.                                                                          |
| 0010   | Tipo de Conta Imutável                                | O tipo de conta especificado não pode ser modificado. Verifique se o tipo de conta correto está sendo usado e tente novamente.                                                                                                          |
| 0011   | Erro de Tipo de Conta Inativo                         | O tipo de conta especificado não pode ser definido como INACTIVE. Verifique se o tipo de conta correto está sendo usado e tente novamente.                                                                                              |
| 0012   | Erro de Exclusão de Conta com Saldo                   | Uma conta ou subconta não pode ser excluída se tiver saldo remanescente. Transfira todo o saldo remanescente antes de tentar excluir.                                                                                                   |
| 0013   | Recurso Já Excluído                                   | O recurso que você está tentando excluir já foi excluído. Verifique se está usando o ID correto e tente novamente.                                                                                                                      |
| 0014   | ID de Segmento Inativo                                | O segmento com ID \{\{id}} está inativo no momento. Ative o segmento antes de continuar.                                                                                                                                                |
| 0015   | Erro de Nome de Segmento Duplicado                    | Já existe um segmento com o nome \{\{name}} para este ledger ID \{\{ledgerId}}. Tente novamente com um ledger ou nome diferente.                                                                                                        |
| 0017   | Erro de Formato de Script Inválido                    | O script fornecido na sua requisição é inválido ou está em um formato não suportado. Verifique o formato do script e tente novamente.                                                                                                   |
| 0018   | Erro de Fundos Insuficientes                          | A transação não pôde ser concluída por falta de fundos suficientes na conta. Adicione fundos suficientes à sua conta e tente novamente.                                                                                                 |
| 0019   | Erro de Inelegibilidade de Conta                      | Uma ou mais contas listadas na transação não são elegíveis para participar. Revise o status das contas e tente novamente.                                                                                                               |
| 0020   | Erro de Indisponibilidade de Alias                    | O alias \{\{alias}} já está em uso. Escolha um alias diferente e tente novamente.                                                                                                                                                       |
| 0021   | ID de Transação Pai Não Encontrado                    | O parentTransactionId \{\{parentTransactionId}} não corresponde a nenhuma transação existente. Revise o ID e tente novamente.                                                                                                           |
| 0022   | Erro de Campo Imutável                                | O campo \{\{field}} não pode ser modificado. Remova esse campo da sua requisição e tente novamente.                                                                                                                                     |
| 0023   | Restrição de Horário de Transação                     | Você apenas pode realizar outra transação usando \{\{assetCode}} de \{\{amount}} de \{\{source}} para \{\{destination}} depois de \{\{timestampUnlock}}. Aguarde até o horário especificado para tentar novamente.                      |
| 0024   | Restrição de Transação por Status da Conta            | Os status atuais das contas de origem e/ou destino não permitem transações. Altere o(s) status da(s) conta(s) e tente novamente.                                                                                                        |
| 0025   | Erro de Saldo de Conta Insuficiente                   | A conta \{\{accountId}} não tem saldo suficiente. Tente novamente com um valor menor ou igual ao saldo disponível.                                                                                                                      |
| 0026   | Restrição de Método de Transação                      | Transações envolvendo \{\{assetCode}} não são permitidas para a origem e/ou destino especificados. Tente novamente usando contas que permitam transações com \{\{assetCode}}.                                                           |
| 0027   | Erro de Código de Template de Transação Duplicado     | Já existe um template de transação com o código especificado no seu ledger. Use um código diferente e tente novamente.                                                                                                                  |
| 0028   | Erro de Par de Ativos Duplicado                       | Já existe um par para os ativos especificados. Atualize o registro existente em vez de criar um novo.                                                                                                                                   |
| 0029   | ID de Conta Pai Inválido                              | O ID de conta pai especificado não existe. Verifique se o ID está correto e envie a requisição novamente.                                                                                                                               |
| 0030   | Código de Ativo Incompatível                          | O ID de conta pai está associado a um código de ativo diferente do especificado. Verifique se o código de ativo corresponde à conta pai.                                                                                                |
| 0031   | Tipo de Chart Não Encontrado                          | O tipo de chart especificado não existe. Informe um tipo de chart válido e consulte a documentação.                                                                                                                                     |
| 0032   | Código de País Inválido                               | O código de país informado no campo 'address.country' não está em conformidade com o padrão ISO-3166 alpha-2. Informe um código de país alpha-2 válido.                                                                                 |
| 0033   | Formato de Código Inválido                            | O campo 'code' deve ser alfanumérico, em maiúsculas, e deve conter pelo menos uma letra. Informe um código válido.                                                                                                                      |
| 0034   | Código de Ativo Não Encontrado                        | O código de ativo informado não existe em nossos registros. Verifique o código de ativo e tente novamente.                                                                                                                              |
| 0035   | ID de Portfólio Não Encontrado                        | O ID de portfólio informado não existe em nossos registros. Verifique o ID de portfólio e tente novamente.                                                                                                                              |
| 0036   | ID de Segmento Não Encontrado                         | O ID de segmento informado não existe em nossos registros. Verifique o ID de segmento e tente novamente.                                                                                                                                |
| 0037   | ID de Ledger Não Encontrado                           | O ID de ledger informado não existe em nossos registros. Verifique o ID de ledger e tente novamente.                                                                                                                                    |
| 0038   | ID de Organização Não Encontrado                      | O ID de organização informado não existe em nossos registros. Verifique o ID de organização e tente novamente.                                                                                                                          |
| 0039   | ID de Organização Pai Não Encontrado                  | O ID de organização pai informado não existe em nossos registros. Verifique o ID de organização pai e tente novamente.                                                                                                                  |
| 0040   | Tipo Inválido                                         | O 'type' informado não é válido. Os tipos aceitos são currency, fiat, crypto, commodity ou others. Informe um tipo válido.                                                                                                              |
| 0041   | Token Ausente                                         | Um token válido deve ser informado no header da requisição. Inclua um token e tente novamente.                                                                                                                                          |
| 0042   | Token Inválido                                        | O token informado está expirado, inválido ou malformado. Informe um token válido e tente novamente.                                                                                                                                     |
| 0043   | Privilégios Insuficientes                             | Você não tem as permissões necessárias para realizar esta ação. Entre em contato com o seu administrador se acredita que isso é um erro.                                                                                                |
| 0044   | Erro de Aplicação de Permissão                        | O enforcer não está configurado corretamente. Entre em contato com o seu administrador se acredita que isso é um erro.                                                                                                                  |
| 0045   | Erro de Busca de Chaves JWK                           | Não foi possível buscar as chaves JWK na fonte. Verifique a configuração da variável de ambiente de origem e tente novamente.                                                                                                           |
| 0046   | Erro Interno do Servidor                              | O servidor encontrou um erro inesperado. Tente novamente mais tarde ou entre em contato com o suporte.                                                                                                                                  |
| 0047   | Requisição Inválida                                   | O servidor não conseguiu interpretar a requisição devido a uma sintaxe malformada. Verifique os campos listados e tente novamente.                                                                                                      |
| 0050   | Tamanho de Chave de Metadados Excedido                | A chave de metadados \{\{key}} excede o tamanho máximo permitido. Use uma chave mais curta.                                                                                                                                             |
| 0051   | Tamanho de Valor de Metadados Excedido                | O valor de metadados \{\{key}} excede o tamanho máximo permitido. Use um valor mais curto.                                                                                                                                              |
| 0052   | ID de Conta Não Encontrado                            | O ID de conta informado não existe em nossos registros. Verifique o ID de conta e tente novamente.                                                                                                                                      |
| 0053   | Campos Inesperados na Requisição                      | O corpo da requisição contém mais campos do que o esperado. Envie apenas os campos permitidos conforme a documentação. Os campos inesperados estão listados no objeto fields.                                                           |
| 0054   | IDs Não Encontrados para Contas                       | Nenhuma conta foi encontrada para os IDs informados. Verifique os IDs e tente novamente.                                                                                                                                                |
| 0055   | ID de Ativo Não Encontrado                            | O ID de ativo especificado não existe no ledger informado. Verifique o ID de ativo e tente novamente.                                                                                                                                   |
| 0056   | Nenhum Ativo Encontrado                               | Nenhum ativo foi encontrado para o ledger especificado. Crie um ativo ou verifique se o ledger existe.                                                                                                                                  |
| 0057   | Nenhum Segmento Encontrado                            | Nenhum segmento foi encontrado para o ledger especificado. Crie um segmento ou verifique se o ledger existe.                                                                                                                            |
| 0058   | Nenhum Portfólio Encontrado                           | Nenhum portfólio foi encontrado para o ledger especificado. Crie um portfólio ou verifique se o ledger existe.                                                                                                                          |
| 0059   | Nenhuma Organização Encontrada                        | Nenhuma organização foi encontrada na busca. Revise os critérios de busca e tente novamente.                                                                                                                                            |
| 0060   | Nenhum Ledger Encontrado                              | Nenhum ledger foi encontrado na busca. Revise os critérios de busca e tente novamente.                                                                                                                                                  |
| 0061   | Falha na Atualização de Saldo                         | Não foi possível atualizar o saldo para o ID de conta especificado. Verifique o ID de conta e tente novamente.                                                                                                                          |
| 0062   | Nenhum ID de Conta Informado                          | Nenhum ID de conta foi informado para a atualização de saldo. Informe IDs de conta válidos e tente novamente.                                                                                                                           |
| 0063   | Falha ao Recuperar Contas por Aliases                 | Não foi possível recuperar as contas usando os aliases especificados. Verifique se os aliases estão corretos e tente novamente.                                                                                                         |
| 0064   | Nenhuma Conta Encontrada                              | Nenhuma conta foi encontrada na busca. Revise os critérios de busca e tente novamente.                                                                                                                                                  |
| 0065   | Parâmetro de Path Inválido                            | O parâmetro de path \{\{parameter\_name}} informado não está no formato esperado. Verifique se o parâmetro segue o formato exigido e tente novamente.                                                                                   |
| 0066   | Tipo de Conta Inválido                                | O 'type' informado não é válido. Os tipos aceitos são: deposit, savings, loans, marketplace, cerditCard ou external. Informe um tipo válido.                                                                                            |
| 0067   | Aninhamento de Metadados Inválido                     | O objeto de metadados não pode conter valores aninhados. Verifique se o valor \{\{value}} não está aninhado e tente novamente.                                                                                                          |
| 0068   | ID de Operação Não Encontrado                         | O ID de operação informado não existe em nossos registros. Verifique o ID de operação e tente novamente.                                                                                                                                |
| 0069   | Nenhuma Operação Encontrada                           | Nenhuma operação foi encontrada para os parâmetros de busca informados. Ajuste os filtros e tente novamente.                                                                                                                            |
| 0070   | ID de Transação Não Encontrado                        | O ID de transação informado não existe em nossos registros. Verifique o ID de transação e tente novamente.                                                                                                                              |
| 0071   | Nenhuma Transação Encontrada                          | Nenhuma transação foi encontrada para os parâmetros de busca informados. Ajuste os filtros e tente novamente.                                                                                                                           |
| 0072   | Tipo de Transação Inválido                            | Apenas um tipo de transação (amount, share ou remaining) deve ser especificado para cada entrada. Revise os dados informados e tente novamente.                                                                                         |
| 0073   | Incompatibilidade de Valor da Transação               | Os valores da origem, do destino ou de ambos não correspondem ao valor de transação especificado. Verifique os valores e tente novamente.                                                                                               |
| 0074   | Modificação de Conta Externa Proibida                 | Contas do tipo 'external' não podem ser excluídas ou modificadas, pois são usadas para rastreabilidade com sistemas externos. Revise a requisição e garanta que as operações sejam realizadas apenas em contas internas.                |
| 0075   | Registro de Auditoria Não Recuperado                  | Não foi possível recuperar o registro para auditoria. Verifique se os dados enviados estão corretos e tente novamente.                                                                                                                  |
| 0076   | Registro da Árvore de Auditoria Não Encontrado        | O registro não existe na árvore de auditoria. Verifique se a árvore de auditoria está disponível e tente novamente.                                                                                                                     |
| 0077   | Erro de Formato de Data Inválido                      | O initialDate, o finalDate ou ambos estão em formato incorreto. Use o formato yyyy-mm-dd e tente novamente.                                                                                                                             |
| 0078   | Erro de Data Final Inválida                           | O finalDate não pode ser anterior ao initialDate. Verifique as datas e tente novamente.                                                                                                                                                 |
| 0079   | Erro de Intervalo de Datas Acima do Limite            | O intervalo entre 'initialDate' e 'finalDate' excede o limite permitido de \{\{limit}} meses. Ajuste as datas e tente novamente.                                                                                                        |
| 0080   | Limite de Paginação Excedido                          | O limite de paginação excede o máximo permitido de \{\{pageLimit}} itens por página. Verifique o limite e tente novamente.                                                                                                              |
| 0081   | Ordem de Classificação Inválida                       | O campo 'sort\_order' deve ser 'asc' ou 'desc'. Informe uma ordem de classificação válida e tente novamente.                                                                                                                            |
| 0082   | Parâmetro de Busca Inválido                           | Um ou mais parâmetros de busca estão em formato incorreto. Verifique os seguintes parâmetros '\{\{parameter}}' e garanta que atendam ao formato exigido antes de tentar novamente.                                                      |
| 0083   | Erro de Intervalo de Datas Inválido                   | Os campos 'initialDate' e 'finalDate' são obrigatórios e devem estar no formato 'yyyy-mm-dd'. Informe datas válidas e tente novamente.                                                                                                  |
| 0084   | Chave de Idempotência Duplicada                       | A chave de idempotência '\{\{key}}' já está em uso. Informe uma chave exclusiva e tente novamente.                                                                                                                                      |
| 0085   | Alias de Conta Não Encontrado                         | O Alias de conta informado não existe em nossos registros. Verifique o Alias de conta e tente novamente.                                                                                                                                |
| 0086   | Condição de corrida detectada                         | Uma condição de corrida foi detectada ao processar sua requisição. Tente novamente                                                                                                                                                      |
| 0087   | Reversão de transação já existe                       | A reversão da transação já existe. Tente novamente.                                                                                                                                                                                     |
| 0088   | Transação já é uma reversão                           | A transação já é uma reversão. Tente novamente                                                                                                                                                                                          |
| 0089   | Transação não pode ser revertida                      | A transação não pode ser revertida. Tente novamente                                                                                                                                                                                     |
| 0090   | Conta Ambígua na Transação                            | A transação não pode usar a mesma conta nas origens e nos destinos.                                                                                                                                                                     |
| 0091   | ID não pode ser usado como ID pai                     | O ID informado não pode ser usado como ID pai. Escolha um ID diferente.                                                                                                                                                                 |
| 0092   | Nenhum Saldo Encontrado                               | Nenhum saldo foi encontrado para os parâmetros de busca informados. Ajuste os filtros e tente novamente.                                                                                                                                |
| 0093   | Saldo Não Pode Ser Excluído                           | O saldo não pode ser excluído porque ainda tem fundos ou possui operações ativas.                                                                                                                                                       |
| 0094   | Corpo da Requisição Inválido                          | O corpo da requisição é inválido ou não pôde ser processado. Verifique a estrutura do JSON e os tipos de campo.                                                                                                                         |
| 0095   | Message Broker Indisponível                           | O servidor encontrou um erro inesperado ao conectar ao Message Broker. Tente novamente mais tarde ou entre em contato com o suporte.                                                                                                    |
| 0096   | Alias de Conta Inválido                               | O alias contém caracteres inválidos. Verifique o valor do alias e tente novamente.                                                                                                                                                      |
| 0097   | Erro de Overflow                                      | A requisição não pôde ser concluída devido a um overflow. Verifique os valores e tente novamente.                                                                                                                                       |
| 0098   | Transação Pendente Inválida                           | Contas externas não podem ser usadas em transações pendentes nas operações de origem. Verifique as contas e tente novamente.                                                                                                            |
| 0099   | Status de Transação Inválido                          | A transação não pode ser revertida porque o status não é APPROVED                                                                                                                                                                       |
| 0100   | Título de Rota de Operação Já Existe                  | Já existe uma rota de operação com o título especificado. Use um título diferente e tente novamente.                                                                                                                                    |
| 0101   | Rota de Operação Não Encontrada                       | A rota de operação informada não existe em nossos registros. Verifique a rota de operação e tente novamente.                                                                                                                            |
| 0102   | Nenhuma Rota de Operação Encontrada                   | Nenhuma rota de operação foi encontrada para os parâmetros de busca informados. Ajuste os filtros e tente novamente.                                                                                                                    |
| 0103   | Tipo de Rota de Operação Inválido                     | O tipo de rota de operação informado não é válido. Os tipos aceitos são 'source' ou 'destination'. Informe um tipo de operação válido.                                                                                                  |
| 0104   | Rotas de Operação Ausentes na Requisição              | Sua requisição deve incluir pelo menos uma rota de operação de cada tipo (debit e credit). Consulte a documentação para garantir que esses campos estejam devidamente preenchidos.                                                      |
| 0105   | Rota de Transação Não Encontrada                      | A rota de transação informada não existe em nossos registros. Verifique a rota de transação e tente novamente.                                                                                                                          |
| 0106   | Nenhuma Rota de Transação Encontrada                  | Nenhuma rota de transação foi encontrada para os parâmetros de busca informados. Ajuste os filtros e tente novamente.                                                                                                                   |
| 0107   | Rota de Operação Vinculada a Rotas de Transação       | A rota de operação não pode ser excluída porque está vinculada a uma ou mais rotas de transação. Remova a rota de operação de todas as rotas de transação antes de tentar excluí-la.                                                    |
| 0108   | Erro de Valor de Chave de Tipo de Conta Duplicado     | Já existe um tipo de conta com o valor de chave especificado para esta organização e ledger. Use um valor de chave diferente ou atualize o tipo de conta existente.                                                                     |
| 0109   | Erro de Tipo de Conta Não Encontrado                  | O tipo de conta que você está tentando acessar não existe ou foi removido.                                                                                                                                                              |
| 0110   | Nenhum Tipo de Conta Encontrado                       | Nenhum tipo de conta foi encontrado para o ledger especificado. Crie um tipo de conta ou verifique se o ledger existe.                                                                                                                  |
| 0111   | Tipo de Regra de Conta Inválido                       | O 'account.ruleType' informado não é válido. Os tipos aceitos são 'alias' ou 'account\_type'. Informe um tipo de regra válido.                                                                                                          |
| 0112   | Valor de Regra de Conta Inválido                      | O 'account.validIf' informado não é válido. Informe uma string para 'alias' ou um array de strings para 'account\_type'.                                                                                                                |
| 0113   | Regra de Conta Corrompida                             | Os dados da regra de conta na rota de operação são internamente inconsistentes (tipo de regra desconhecido ou valor validIf malformado). Isso indica um problema de integridade de dados. Verifique a configuração da rota de operação. |
| 0114   | Rota de Transação Não Informada                       | A rota de transação não foi informada. Informe a rota de transação para esta transação.                                                                                                                                                 |
| 0115   | ID de Rota de Transação Inválido                      | O ID de rota de transação informado não está em um formato UUID válido. Informe um UUID válido para a rota de transação.                                                                                                                |
| 0116   | Incompatibilidade de Contagem de Rota Contábil        | A contagem de rotas de operação não corresponde ao cache da rota de transação. Verifique a configuração das suas rotas.                                                                                                                 |
| 0117   | Rota Contábil Não Encontrada                          | O ID de rota de operação não foi encontrado no cache da rota de transação. Verifique a configuração da rota.                                                                                                                            |
| 0118   | Falha na Validação de Alias Contábil                  | O alias da operação não corresponde ao alias esperado definido na regra da rota contábil.                                                                                                                                               |
| 0119   | Falha na Validação de Tipo de Conta Contábil          | O tipo de conta não corresponde a nenhum dos tipos de conta esperados definidos na regra da rota contábil.                                                                                                                              |
| 0120   | Caracteres Inválidos                                  | O campo 'keyValue' contém caracteres inválidos. Use apenas letras, números, underscores e hifens.                                                                                                                                       |
| 0121   | Erro de Data Futura Inválida                          | O transactionDate não pode ser uma data futura. Informe uma data válida.                                                                                                                                                                |
| 0122   | Erro de Campo Inválido para Transação Pendente        | Transações pendentes não aceitam o campo transactionDate. Para continuar, remova-o da sua requisição.                                                                                                                                   |
| 0123   | Erro de Valor de Chave de Alias Duplicado             | Já existe um alias de conta com o valor de chave especificado para esta organização e ledger. Use um valor de chave diferente.                                                                                                          |
| 0124   | Criação de Saldo Adicional Não Permitida              | Saldos adicionais não são permitidos para o tipo de conta external.                                                                                                                                                                     |
| 0125   | Valor de Transação Inválido                           | Valores de transação negativos ou zero não são permitidos. O send\_value deve ser maior que zero.                                                                                                                                       |
| 0126   | Saldo Padrão Não Encontrado                           | O saldo padrão deve ser criado primeiro para esta conta.                                                                                                                                                                                |
| 0127   | Falha na Criação da Conta                             | Não foi possível criar a conta porque o saldo padrão não pôde ser criado. Tente novamente.                                                                                                                                              |
| 0128   | Falha no Cache de Backup da Transação                 | O servidor encontrou um erro inesperado ao adicionar a transação ao cache de backup. Tente novamente mais tarde ou entre em contato com o suporte.                                                                                      |
| 0129   | Falha na Serialização do Cache de Backup da Transação | O servidor encontrou um erro inesperado ao serializar a transação para o cache de backup. Tente novamente mais tarde ou entre em contato com o suporte.                                                                                 |
| 0131   | Erro de Formato de Data e Hora Inválido               | O parâmetro está em formato incorreto. Use o formato de data e hora correto e tente novamente.                                                                                                                                          |
| 0132   | Índice de Metadados Já Existe                         | Já existe um índice de metadados com a mesma chave para esta entidade. Use uma chave diferente da do índice existente.                                                                                                                  |
| 0133   | Índice de Metadados Não Encontrado                    | O índice de metadados especificado não existe. Verifique o nome do índice e tente novamente.                                                                                                                                            |
| 0134   | Formato de Chave de Metadados Inválido                | O formato da chave de metadados é inválido. As chaves devem começar com uma letra e conter apenas caracteres alfanuméricos e underscores.                                                                                               |
| 0135   | Limite de Índices de Metadados Excedido               | O número máximo de índices de metadados foi atingido para esta entidade. Exclua índices não utilizados antes de criar novos.                                                                                                            |
| 0136   | Falha na Criação do Índice de Metadados               | Não foi possível criar o índice de metadados. Tente novamente mais tarde ou entre em contato com o suporte.                                                                                                                             |
| 0137   | Exclusão de Índice de Metadados Proibida              | Índices do sistema não podem ser excluídos. Verifique se você está excluindo um índice de metadados personalizado.                                                                                                                      |
| 0138   | Nome de Entidade Inválido                             | O nome de entidade informado não é válido.                                                                                                                                                                                              |
| 0139   | Falha na Recuperação do Cache de Backup da Transação  | Não foi possível recuperar a transação da função interna do cache de backup. Verifique se a transação existe no cache antes de processar os saldos.                                                                                     |
| 0140   | Timestamp Inválido                                    | O timestamp informado é inválido. Timestamps não podem estar no futuro.                                                                                                                                                                 |
| 0141   | Nenhum Dado de Saldo na Data                          | Nenhum dado de saldo está disponível na data especificada.                                                                                                                                                                              |
| 0142   | Parâmetro de Busca Obrigatório Ausente                | O parâmetro de busca obrigatório está ausente na requisição.                                                                                                                                                                            |
| 0143   | Payload Muito Grande                                  | O payload da requisição excede o tamanho máximo permitido de 64KB.                                                                                                                                                                      |
| 0144   | Profundidade de Aninhamento JSON Excedida             | O payload JSON excede a profundidade máxima de aninhamento de 10 níveis. Simplifique a estrutura de dados.                                                                                                                              |
| 0145   | Quantidade de Chaves JSON Excedida                    | O payload JSON excede o número máximo de chaves permitido (100). Reduza o número de chaves no seu payload.                                                                                                                              |
| 0146   | Tenant Não Provisionado                               | O tenant não foi provisionado. Verifique se o tenant está configurado corretamente.                                                                                                                                                     |
| 0147   | Campo de Configurações Desconhecido                   | As configurações contêm um campo desconhecido. Apenas campos de configurações conhecidos são permitidos.                                                                                                                                |
| 0148   | Tipo de Campo de Configurações Inválido               | Um campo de configurações tem um tipo inválido. Verifique o tipo esperado para o campo.                                                                                                                                                 |
| 0149   | Campo de Configurações no Nível Raiz                  | Um campo de configurações deve estar aninhado sob a chave pai correta. Verifique a estrutura esperada.                                                                                                                                  |
| 0150   | Rota Não Bidirecional                                 | A rota de operação não permite transações bidirecionais. Apenas rotas com tipo de operação 'bidirectional' podem ser revertidas.                                                                                                        |
| 0151   | Contraparte Ausente                                   | A rota exige pelo menos uma operação de débito e uma de crédito (validação de contraparte).                                                                                                                                             |
| 0152   | Incompatibilidade de Direção da Rota                  | A direção da operação não é compatível com o tipo de operação da rota.                                                                                                                                                                  |
| 0153   | Nenhuma Origem para a Ação                            | A ação exige pelo menos uma rota de operação de origem. Adicione uma rota de origem para esta ação.                                                                                                                                     |
| 0154   | Nenhum Destino para a Ação                            | A ação exige pelo menos uma rota de operação de destino. Adicione uma rota de destino para esta ação.                                                                                                                                   |
| 0155   | Ação de Rota Inválida                                 | A ação não é uma ação de rota válida. Informe um valor de ação válido.                                                                                                                                                                  |
| 0157   | Nenhuma Rota para a Ação                              | Nenhuma rota foi encontrada para a ação. Configure rotas de operação para esta ação na rota de transação.                                                                                                                               |
| 0158   | Excesso de Rotas de Operação                          | O número de rotas de operação excede o máximo permitido. Reduza o número de rotas de operação e tente novamente.                                                                                                                        |
| 0159   | Serviço Suspenso                                      | O serviço está suspenso para este tenant.                                                                                                                                                                                               |
| 0160   | Tenant Não Encontrado                                 | O tenant especificado não foi encontrado.                                                                                                                                                                                               |
| 0161   | Serviço de Tenant Indisponível                        | O serviço de tenant está indisponível. Tente novamente mais tarde.                                                                                                                                                                      |
| 0162   | Cenário Não Permitido para a Direção                  | O cenário contábil não é permitido para a direção de operação especificada.                                                                                                                                                             |
| 0163   | Grupo de Reserva Incompleto                           | O grupo de reserva (hold, commit, cancel) deve estar completo.                                                                                                                                                                          |
| 0164   | Cenário Direto Obrigatório                            | O cenário direto é obrigatório quando outros cenários estão presentes.                                                                                                                                                                  |
| 0165   | Reversão Apenas Bidirecional                          | O cenário de reversão é permitido apenas para rotas de operação bidirecionais.                                                                                                                                                          |
| 0166   | Campo Obrigatório do Lançamento Contábil              | Um campo obrigatório está ausente no lançamento contábil.                                                                                                                                                                               |
| 0167   | Limite de Overdraft Excedido                          | A transação excederia o limite de overdraft configurado do saldo. Reduza o valor da transação ou aumente o limite de overdraft.                                                                                                         |
| 0168   | Operação Direta em Saldo Interno                      | Uma operação iniciada pelo usuário teve como alvo um saldo com escopo interno. Saldos internos (por exemplo, companheiros de overdraft) não podem ser operados diretamente.                                                             |
| 0169   | Exclusão de Saldo Interno                             | Uma requisição de exclusão teve como alvo um saldo com escopo interno. Saldos internos são gerenciados pelo sistema e não podem ser excluídos.                                                                                          |
| 0170   | Chave de Saldo Reservada                              | A chave de saldo informada é reservada para uso do sistema (por exemplo, `overdraft`). Escolha uma chave diferente.                                                                                                                     |
| 0171   | Direção de Saldo Inválida                             | A direção de saldo informada não é válida. Os valores aceitos são `credit` e `debit`.                                                                                                                                                   |
| 0172   | Configurações de Saldo Inválidas                      | O payload de configurações de saldo falhou na validação. Verifique se `overdraftLimit` está presente e positivo quando `overdraftLimitEnabled` é true, e ausente quando é false.                                                        |
| 0173   | Limite de Overdraft Abaixo do Uso                     | O novo limite de overdraft é menor que o uso atual de overdraft. Pague parte do overdraft ou defina um limite maior.                                                                                                                    |
| 0174   | Versão de Saldo Desatualizada                         | A versão do saldo na requisição não corresponde mais à versão atual. Outra transação alterou o saldo. Repita a operação.                                                                                                                |
| 0175   | Atualização de Saldo Interno                          | Uma requisição PATCH teve como alvo um saldo com escopo interno. Saldos internos são gerenciados pelo sistema e não podem ser modificados pela API pública.                                                                             |
| 0484   | Rota Não Encontrada                                   | A rota solicitada não existe. Verifique o método HTTP e o path e tente novamente.                                                                                                                                                       |
| 0485   | Método Não Permitido                                  | O método HTTP não é permitido para a rota solicitada. Verifique o método e tente novamente.                                                                                                                                             |
| 0497   | Campos de Header da Requisição Muito Grandes          | Os campos de header da requisição são muito grandes. Reduza o tamanho dos headers da requisição e tente novamente.                                                                                                                      |
