> ## 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 Matcher
> As APIs do Matcher retornam um objeto problem do RFC 9457, com um código estável, o status HTTP e um detalhamento, para você diagnosticar problemas e encaminhá-los à equipe certa.
### Formato do erro
```json JSON theme={null}
{
"title": "",
"status": 400,
"detail": "",
"code": ""
}
```
### Definições dos campos
* **`title`** – Um breve resumo, legível por humanos, do problema.
* **`status`** – O código de status HTTP.
* **`detail`** – Orientação detalhada para ajudar você a resolver o erro.
* **`code`** – Um código de produto estável que identifica o erro de forma exclusiva (por exemplo, `MTCH-0001`). Útil para tratamento programático e solicitações de suporte.
* **`errors`** – *(opcional)* Uma lista com detalhes de validação em nível de campo.
Essa estrutura garante que você sempre receba orientações práticas quando algo não sai como esperado.
### Detalhes de erro em nível de campo
Para problemas específicos de campos individuais, um array `errors` fornece contexto adicional.
Exemplos:
```json Example 1 theme={null}
{
"title": "Bad Request",
"status": 400,
"detail": "The request body is invalid or malformed. Please verify the JSON format and try again.",
"code": "MTCH-0001",
"errors": [
{ "location": "body.context_id", "message": "context_id is a required field" }
]
}
```
```json Example 2 theme={null}
{
"title": "Not Found",
"status": 404,
"detail": "The requested resource does not exist. Please verify the ID and try again.",
"code": "MTCH-0005"
}
```
## Erros gerais
***
Esses erros se aplicam a todos os endpoints da API do Matcher.
**400**
| `code` | `title` | `detail` |
| ----------- | ------------------- | ---------------------------------------------------------------------------------------------------- |
| `MTCH-0001` | Requisição Inválida | O corpo da requisição é inválido ou malformado. Verifique o formato da requisição e tente novamente. |
| `MTCH-0011` | Requisição Inválida | A requisição falhou. Verifique a requisição e tente novamente. |
| `MTCH-0013` | Requisição Inválida | O ID do contexto é inválido. Verifique o formato do ID e tente novamente. |
**401**
| `code` | `title` | `detail` |
| ----------- | -------------- | ------------------------------------------------------------------------------------ |
| `MTCH-0003` | Não Autorizado | A requisição não pôde ser autenticada. Verifique suas credenciais e tente novamente. |
**402**
| `code` | `title` | `detail` |
| ----------- | -------------------- | ------------------------------------------------------------------------------------------ |
| `MTCH-0020` | Pagamento Necessário | A cota de uso configurada foi excedida. Entre em contato com o administrador da sua conta. |
**403**
| `code` | `title` | `detail` |
| ----------- | -------- | ------------------------------------------------------------------------------------------- |
| `MTCH-0004` | Proibido | Você não tem permissão para executar esta ação. Verifique seu nível de acesso. |
| `MTCH-0012` | Proibido | O contexto de conciliação não está ativo. Ative o contexto antes de executar esta operação. |
| `MTCH-0021` | Proibido | O faturamento está suspenso. Entre em contato com um administrador para restaurar o acesso. |
**404**
| `code` | `title` | `detail` |
| ----------- | -------------- | ------------------------------------------------------------------ |
| `MTCH-0005` | Não Encontrado | O recurso solicitado não existe. Verifique o ID e tente novamente. |
**409**
| `code` | `title` | `detail` |
| ----------- | -------- | ----------------------------------------------------------------------------------------- |
| `MTCH-0007` | Conflito | A requisição está em conflito com o estado atual do recurso. Verifique e tente novamente. |
**413**
| `code` | `title` | `detail` |
| ----------- | ----------------------------------- | --------------------------------------------------------------------------------------------------- |
| `MTCH-0010` | Entidade da Requisição Muito Grande | O arquivo enviado excede o tamanho máximo permitido. Reduza o tamanho do arquivo e tente novamente. |
**422**
| `code` | `title` | `detail` |
| ----------- | ------------------------ | -------------------------------------------------------------------------------------------------------------- |
| `MTCH-0006` | Entidade Não Processável | A requisição estava bem formada, mas não pôde ser processada. Verifique os dados informados e tente novamente. |
**429**
| `code` | `title` | `detail` |
| ----------- | ------------------ | -------------------------------------------------------------------------------- |
| `MTCH-0009` | Muitas Requisições | O limite de taxa de requisições foi excedido. Aguarde antes de tentar novamente. |
**500**
| `code` | `title` | `detail` |
| ----------- | ------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| `MTCH-0002` | Erro Interno do Servidor | Ocorreu um erro inesperado. Tente novamente mais tarde ou entre em contato com o suporte se o problema persistir. |
**503**
| `code` | `title` | `detail` |
| ----------- | -------------------- | ----------------------------------------------------------------------------------------- |
| `MTCH-0008` | Serviço Indisponível | Um serviço necessário está temporariamente indisponível. Tente novamente mais tarde. |
| `MTCH-0019` | Serviço Indisponível | O armazenamento de objetos está temporariamente indisponível. Tente novamente mais tarde. |
## Erros de configuração
***
O Matcher retorna esses erros para um problema na configuração de conciliação (contextos, fontes, mapas de campo, regras de correspondência, regras de tarifa, agendamentos).
**400**
| `code` | `title` | `detail` |
| ----------- | ------------------- | ---------------------------------------------------------------------------- |
| `MTCH-0109` | Requisição Inválida | Um nome de contexto é obrigatório. Informe um nome válido e tente novamente. |
**404**
| `code` | `title` | `detail` |
| ----------- | -------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `MTCH-0110` | Não Encontrado | O contexto especificado não foi encontrado. Verifique o ID do contexto e tente novamente. |
| `MTCH-0111` | Não Encontrado | A fonte especificada não foi encontrada. Verifique o ID da fonte e tente novamente. |
| `MTCH-0112` | Não Encontrado | O mapa de campo especificado não foi encontrado. Verifique o ID do mapa de campo e tente novamente. |
| `MTCH-0113` | Não Encontrado | A regra de correspondência especificada não foi encontrada. Verifique o ID da regra de correspondência e tente novamente. |
| `MTCH-0114` | Não Encontrado | A regra de tarifa especificada não foi encontrada. Verifique o ID da regra de tarifa e tente novamente. |
| `MTCH-0115` | Não Encontrado | O agendamento de tarifa especificado não foi encontrado. Verifique o ID do agendamento de tarifa e tente novamente. |
| `MTCH-0116` | Não Encontrado | O agendamento especificado não foi encontrado. Verifique o ID do agendamento e tente novamente. |
**409**
| `code` | `title` | `detail` |
| ----------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MTCH-0101` | Conflito | Já existe um contexto com esse nome. Escolha um nome diferente e tente novamente. |
| `MTCH-0102` | Conflito | Já existe um recurso com essa prioridade. Escolha um valor de prioridade diferente e tente novamente. |
| `MTCH-0103` | Conflito | O recurso está em um estado inválido para esta operação. Verifique o estado atual e tente novamente. |
| `MTCH-0104` | Conflito | O contexto foi arquivado. Use um contexto ativo para esta operação. |
| `MTCH-0105` | Conflito | Este recurso não pode ser excluído porque tem um mapa de campo associado. Remova o mapa de campo primeiro. |
| `MTCH-0106` | Conflito | Este recurso não pode ser excluído porque tem recursos dependentes. Remova os recursos dependentes primeiro. |
| `MTCH-0107` | Conflito | Já existe um recurso com essa prioridade. Escolha um valor de prioridade diferente. |
| `MTCH-0108` | Conflito | O agendamento de tarifa está em uso no momento e não pode ser modificado ou excluído. |
| `MTCH-0117` | Conflito | Este recurso não pode ser excluído porque tem transações associadas. Remova as transações primeiro. |
| `MTCH-0118` | Conflito | Esta regra de correspondência não pode ser excluída porque um grupo de correspondência confirmado que ela criou ainda tem uma exceção associada. Altere a configuração da regra em vez disso. |
## Erros de descoberta
***
O Matcher retorna esses erros para a descoberta de fontes de dados e o gerenciamento de conexões. A descoberta depende do mecanismo de extração embutido do Matcher. Veja [Discovery](/pt/products/matcher/integrations/matcher-discovery) para saber como funciona.
**400**
| `code` | `title` | `detail` |
| ----------- | ------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `MTCH-0204` | Requisição Inválida | A requisição de extração é inválida. Verifique os parâmetros e tente novamente. |
| `MTCH-0208` | Requisição Inválida | O tipo de conector especificado não está registrado neste deploy. Verifique o tipo de conector e tente novamente. |
**404**
| `code` | `title` | `detail` |
| ----------- | -------------- | ----------------------------------------------------------------------------------------- |
| `MTCH-0201` | Não Encontrado | A conexão especificada não foi encontrada. Verifique o ID da conexão e tente novamente. |
| `MTCH-0202` | Não Encontrado | A extração especificada não foi encontrada. Verifique o ID da extração e tente novamente. |
**409**
| `code` | `title` | `detail` |
| ----------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `MTCH-0205` | Conflito | Uma atualização de descoberta já está em andamento. Aguarde a conclusão antes de iniciar uma nova. |
| `MTCH-0209` | Conflito | A conexão foi encerrada localmente, mas a exclusão não pôde ser confirmada no sistema externo. Verifique se ela ainda está ativa lá. |
**422**
| `code` | `title` | `detail` |
| ----------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| `MTCH-0210` | Entidade Não Processável | O Matcher ainda não pode executar testes de conectividade para este fornecedor de agregador; nenhum teste foi executado e nada mudou. |
**503**
| `code` | `title` | `detail` |
| ----------- | -------------------- | ------------------------------------------------------------------------------------------------- |
| `MTCH-0203` | Serviço Indisponível | O serviço Fetcher está temporariamente indisponível. Tente novamente mais tarde. |
| `MTCH-0206` | Serviço Indisponível | Os dados do conector para o dia solicitado ainda não foram validados. Tente novamente mais tarde. |
| `MTCH-0207` | Serviço Indisponível | O relatório do conector não foi concluído dentro do tempo previsto. Tente novamente mais tarde. |
## Erros de ingestão
***
O Matcher retorna esses erros para o envio e o processamento de arquivos de transação.
**400**
| `code` | `title` | `detail` |
| ----------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `MTCH-0303` | Requisição Inválida | O formato do arquivo é obrigatório. Especifique o formato e tente novamente. |
| `MTCH-0304` | Requisição Inválida | O arquivo enviado está vazio. Forneça um arquivo não vazio e tente novamente. |
| `MTCH-0307` | Requisição Inválida | O arquivo estava bem formado, mas não continha elementos de registro para ingestão. Verifique o conteúdo do arquivo e tente novamente. |
| `MTCH-0308` | Requisição Inválida | O esquema do arquivo enviado não é compatível. Verifique a estrutura do arquivo e tente novamente. |
| `MTCH-0317` | Requisição Inválida | Uma amostra de mapeamento é obrigatória. Forneça uma amostra e tente novamente. |
| `MTCH-0322` | Requisição Inválida | O corpo do documento está vazio. Forneça um documento não vazio e tente novamente. |
**403**
| `code` | `title` | `detail` |
| ----------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
| `MTCH-0319` | Proibido | A extração de documentos não está habilitada para este tenant. Entre em contato com o suporte para ativar o recurso. |
**404**
| `code` | `title` | `detail` |
| ----------- | -------------- | --------------------------------------------------------------------------------------------------------------- |
| `MTCH-0301` | Não Encontrado | A fonte de ingestão especificada não foi encontrada. Verifique o ID da fonte e tente novamente. |
| `MTCH-0302` | Não Encontrado | O mapa de campo de ingestão especificado não foi encontrado. Verifique o ID do mapa de campo e tente novamente. |
| `MTCH-0306` | Não Encontrado | O job de ingestão especificado não foi encontrado. Verifique o ID do job e tente novamente. |
**408**
| `code` | `title` | `detail` |
| ----------- | -------------------------- | ------------------------------------------------------------------------------------------------ |
| `MTCH-0311` | Tempo Limite da Requisição | O envio parou porque nenhum dado foi recebido dentro do tempo permitido. Tente enviar novamente. |
**409**
| `code` | `title` | `detail` |
| ----------- | -------- | ------------------------------------------------------------------------------------------------- |
| `MTCH-0305` | Conflito | O job de ingestão está em um estado inválido para esta operação. Verifique o estado atual. |
| `MTCH-0324` | Conflito | A revisão de extração não está mais pendente e não pode ser modificada. Verifique o estado atual. |
**422**
| `code` | `title` | `detail` |
| ----------- | ------------------------ | ------------------------------------------------------------------------------------------------------------ |
| `MTCH-0309` | Entidade Não Processável | O job de ingestão excedeu o limite configurado de taxa de erro. Revise os dados de origem e tente novamente. |
| `MTCH-0310` | Entidade Não Processável | A configuração da fonte é inválida. Corrija a configuração da fonte e tente enviar novamente. |
| `MTCH-0312` | Entidade Não Processável | O mapa de campo da fonte é inválido. Corrija o mapa de campo e tente enviar novamente. |
| `MTCH-0321` | Entidade Não Processável | Nenhum candidato a transação pôde ser extraído do documento. Verifique o documento e tente novamente. |
**503**
| `code` | `title` | `detail` |
| ----------- | -------------------- | -------------------------------------------------------------------------------------------------- |
| `MTCH-0313` | Serviço Indisponível | A busca e ingestão automática não está habilitada neste deploy. Envie o arquivo manualmente. |
| `MTCH-0314` | Serviço Indisponível | Não foi possível acessar ou ler o transporte externo. Tente novamente mais tarde. |
| `MTCH-0315` | Serviço Indisponível | A proposta de mapeamento não está habilitada neste deploy. Configure o mapa de campo manualmente. |
| `MTCH-0316` | Serviço Indisponível | O assistente de mapeamento está indisponível. Configure um mapa de campo manualmente. |
| `MTCH-0318` | Serviço Indisponível | A extração de documentos não está habilitada neste deploy. Faça a ingestão do arquivo manualmente. |
| `MTCH-0320` | Serviço Indisponível | O extrator de documentos está indisponível. Faça a ingestão do arquivo manualmente. |
| `MTCH-0323` | Serviço Indisponível | A revisão de extração não está habilitada neste deploy. Tente novamente mais tarde. |
## Erros de correspondência
***
O Matcher retorna esses erros para o processo de correspondência da conciliação.
**400**
| `code` | `title` | `detail` |
| ----------- | ------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `MTCH-0401` | Requisição Inválida | Nenhuma fonte está configurada para este contexto. Configure pelo menos uma fonte antes de rodar uma correspondência. |
| `MTCH-0402` | Requisição Inválida | São necessárias pelo menos duas fontes para a correspondência. Configure fontes adicionais. |
| `MTCH-0403` | Requisição Inválida | Cada fonte deve ter um lado definido. Especifique o lado da fonte e tente novamente. |
| `MTCH-0404` | Requisição Inválida | A configuração de topologia um-para-um é inválida. Verifique a configuração da fonte. |
| `MTCH-0405` | Requisição Inválida | A configuração de topologia um-para-muitos é inválida. Verifique a configuração da fonte. |
**403**
| `code` | `title` | `detail` |
| ----------- | -------- | ---------------------------------------------------------------------------------------------------------------- |
| `MTCH-0409` | Proibido | A sugestão de regras não está habilitada para este tenant. Entre em contato com o suporte para ativar o recurso. |
**409**
| `code` | `title` | `detail` |
| ----------- | -------- | --------------------------------------------------------------------------------------------- |
| `MTCH-0408` | Conflito | Uma execução de correspondência já está em andamento para este contexto. Aguarde a conclusão. |
| `MTCH-0413` | Conflito | A sugestão não está mais pendente e não pode ser modificada. Verifique o estado atual. |
**422**
| `code` | `title` | `detail` |
| ----------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| `MTCH-0406` | Entidade Não Processável | As regras de tarifa são obrigatórias, mas não estão configuradas. Adicione regras de tarifa antes de rodar uma correspondência. |
| `MTCH-0407` | Entidade Não Processável | As regras de tarifa estão configuradas incorretamente. Revise as configurações das regras de tarifa e tente novamente. |
| `MTCH-0412` | Entidade Não Processável | A sugestão aprovada falhou na validação. Revise a sugestão e tente novamente. |
**503**
| `code` | `title` | `detail` |
| ----------- | -------------------- | ----------------------------------------------------------------------------------------------------- |
| `MTCH-0410` | Serviço Indisponível | A sugestão de regras não está habilitada neste deploy. Crie as regras de correspondência manualmente. |
| `MTCH-0411` | Serviço Indisponível | O assistente de regras está indisponível. Crie as regras de correspondência manualmente. |
## Erros de exceção
***
O Matcher retorna esses erros para o tratamento de exceções, disputas e processamento de callbacks.
**404**
| `code` | `title` | `detail` |
| ----------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `MTCH-0501` | Não Encontrado | A exceção especificada não foi encontrada. Verifique o ID da exceção e tente novamente. |
| `MTCH-0502` | Não Encontrado | A disputa especificada não foi encontrada. Verifique o ID da disputa e tente novamente. |
| `MTCH-0507` | Não Encontrado | O comentário especificado não foi encontrado. Verifique o ID do comentário e tente novamente. |
| `MTCH-0512` | Não Encontrado | A resolução foi aplicada, mas o Matcher não conseguiu confirmar o registro atualizado da exceção. Recarregue a exceção para ver o estado atual. |
**409**
| `code` | `title` | `detail` |
| ----------- | -------- | --------------------------------------------------------------------------------------------------- |
| `MTCH-0504` | Conflito | Um callback para esta exceção já está sendo processado. Aguarde a conclusão. |
| `MTCH-0505` | Conflito | O callback encontrou um erro temporário e pode ser tentado novamente. Tente a requisição novamente. |
| `MTCH-0510` | Conflito | Uma liquidação já está em andamento nesta divergência. Tente novamente após a conclusão. |
| `MTCH-0511` | Conflito | Esta exceção já está resolvida, então nenhum comentário adicional pode ser incluído. |
**422**
| `code` | `title` | `detail` |
| ----------- | ------------------------ | ------------------------------------------------------------------------------------ |
| `MTCH-0503` | Entidade Não Processável | A exceção está em um estado inválido para esta operação. Verifique o estado atual. |
| `MTCH-0508` | Entidade Não Processável | O tipo de destino do despacho não é compatível. Verifique a configuração do destino. |
| `MTCH-0509` | Entidade Não Processável | O conector de despacho não está configurado. Configure o conector e tente novamente. |
**502**
| `code` | `title` | `detail` |
| ----------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MTCH-0513` | Gateway Inválido | O sistema de destino rejeitou o despacho, então nenhum registro de destino foi criado. Verifique as credenciais do conector e o projeto ou fila de destino antes de despachar novamente. |
| `MTCH-0514` | Gateway Inválido | Não foi possível confirmar o despacho, então um registro de destino pode já existir. Verifique o destino antes de despachar novamente. |
**429**
| `code` | `title` | `detail` |
| ----------- | ------------------ | ------------------------------------------------------------------------------ |
| `MTCH-0506` | Muitas Requisições | O limite de taxa de callbacks foi excedido. Aguarde antes de tentar novamente. |
## Erros de governança
***
O Matcher retorna esses erros para operações de trilha de auditoria e governança.
**404**
| `code` | `title` | `detail` |
| ----------- | -------------- | --------------------------------------------------------------------------------------------------------------- |
| `MTCH-0601` | Não Encontrado | A trilha de auditoria especificada não foi encontrada. Verifique o ID da trilha de auditoria e tente novamente. |
| `MTCH-0602` | Não Encontrado | O mapeamento de ator especificado não foi encontrado. Verifique o ID do mapeamento de ator e tente novamente. |
| `MTCH-0603` | Não Encontrado | O arquivo morto especificado não foi encontrado. Verifique o ID do arquivo morto e tente novamente. |
## Erros de relatórios
***
O Matcher retorna esses erros para operações de exportação de relatórios.
**400**
| `code` | `title` | `detail` |
| ----------- | ------------------- | --------------------------------------------------------------------------------------- |
| `MTCH-0705` | Requisição Inválida | O formato de exportação especificado é inválido. Verifique o formato e tente novamente. |
**404**
| `code` | `title` | `detail` |
| ----------- | -------------- | --------------------------------------------------------------------------------------------- |
| `MTCH-0701` | Não Encontrado | O job de exportação especificado não foi encontrado. Verifique o ID do job e tente novamente. |
**409**
| `code` | `title` | `detail` |
| ----------- | -------- | ------------------------------------------------------------------------------------ |
| `MTCH-0703` | Conflito | A exportação ainda não está pronta para download. Aguarde a conclusão da exportação. |
**410**
| `code` | `title` | `detail` |
| ----------- | -------- | ----------------------------------------------------------------------------------------- |
| `MTCH-0704` | Removido | A exportação expirou e não está mais disponível. Crie uma nova solicitação de exportação. |
**503**
| `code` | `title` | `detail` |
| ----------- | -------------------- | ----------------------------------------------------------------------------------------------------- |
| `MTCH-0702` | Serviço Indisponível | O worker de exportação está desabilitado no momento. Entre em contato com o suporte para habilitá-lo. |
Erros de idempotência
***
O Matcher retorna esses erros para um problema no tratamento da chave de idempotência.
**400**
| `code` | `title` | `detail` |
| ----------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MTCH-0015` | Requisição Inválida | A chave de idempotência deve conter de 1 a 128 letras, dígitos, hifens, sublinhados ou dois-pontos; nenhuma requisição foi processada. Uma chave vazia também é rejeitada. |
**409**
| `code` | `title` | `detail` |
| ----------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MTCH-0018` | Conflito | Uma requisição com esta chave de idempotência já está sendo processada. Aguarde a conclusão e tente novamente com a mesma chave; a requisição original ainda pode ser bem-sucedida. |
**500**
| `code` | `title` | `detail` |
| ----------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MTCH-0016` | Erro Interno do Servidor | Ocorreu um erro inesperado. |
| `MTCH-0017` | Erro Interno do Servidor | O processamento de idempotência está temporariamente indisponível; tente a mesma requisição novamente mais tarde, com a mesma chave de idempotência. Se a falha persistir, peça a um administrador para verificar o armazenamento de idempotência. |