Lista de erros do Matcher

Formato do erro

{
   "title": "<error_title>",
   "status": 400,
   "detail": "<error_detail>",
   "code": "<error_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:

{
  "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" }
  ]
}

{
  "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 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.

​Formato do erro

​Definições dos campos

​Detalhes de erro em nível de campo

​Erros gerais

​Erros de configuração

​Erros de descoberta

​Erros de ingestão

​Erros de correspondência

​Erros de exceção

​Erros de governança

​Erros de relatórios

​Erros de idempotência

Formato do erro

Definições dos campos

Detalhes de erro em nível de campo

Erros gerais

Erros de configuração

Erros de descoberta

Erros de ingestão

Erros de correspondência

Erros de exceção

Erros de governança

Erros de relatórios

Erros de idempotência