Skip to main content
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

Não faça match exato de string para tratar erro. As mensagens mudam sem aviso e algumas concatenam várias falhas numa só. Use o code para a lógica e a message para log e exibição.

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 respondem 403 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

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