Resumo: as mensagens desta página foram extraídas do código dos serviços e, quando marcadas como verificadas, de chamadas reais à API. Elas vêm em português e são o texto exato que chega no campo
message.Formato
Autenticação
Repare na assimetria: client id errado dá 400, secret errado dá 401. Se você trata só 401 como “credencial inválida”, o caso do id errado escapa.
Permissão
Módulo não contratado
A rota existe, mas a sua organização não tem o módulo. A resposta depende do módulo: alguns respondem403 com o nome do módulo, outros respondem 404, como se a rota não existisse. Nos dois casos, não repita: é configuração de conta. Ver Módulos e capacidades.
Relatório
Exportação
As rotas de exportação respondem
202 Accepted, não 200. Ver Exportar Relatório.Política de crédito
Esteira
Erros da execução de esteiras e de propostas estão nas páginas de Esteiras e de Propostas.
Comitê de Crédito IA
Detalhes do padrão de retry em Convocar Comitê.
Webhook
Autorização de SCR (opt-in)
Erros de servidor
Boas práticas
Trate pelo código, não pela mensagem
Trate pelo código, não pela mensagem
As mensagens são texto de UI e mudam. Erros de validação concatenam várias falhas numa string só, então match exato quebra fácil.
Separe transitório de definitivo
Separe transitório de definitivo
400 de “ainda não finalizou” pede retry com backoff; 400 de “não habilitado” não muda com o tempo. A tabela do comitê marca isso na coluna Repetir.404 nem sempre é 'não existe'
404 nem sempre é 'não existe'
Relatório de outra organização também devolve
404, de propósito, para não vazar a existência de dados de terceiros. Se você tem certeza de que o ID existe, confira o token usado.Erro de seção não derruba o relatório
Erro de seção não derruba o relatório
Uma fonte que falha registra o problema em
errors daquela seção e o relatório segue. Verifique esse campo antes de assumir que o dado simplesmente não existe.
