Códigos de erro (IT-NNNN) — lista completa
Todo erro do sistema agora carrega um código no formato IT-NNNN (ex: IT-3001). Ele aparece no fim da mensagem de erro — por exemplo: "Dados inválidos (IT-3001)". Ao abrir um chamado, informe esse código: ele diz exatamente que tipo de erro aconteceu e acelera muito o atendimento.
Como ler o código
O número é organizado por faixa:
- 1000 — login e sessão
- 2000 — permissões
- 3000 — dados/entrada inválidos
- 4000 — não encontrado
- 5000 — conflito / regra de negócio
- 6000 — limites (excesso de tentativas/requisições)
- 7000 — integrações externas (Facebook, IA, etc.)
- 8000 — banco de dados / infraestrutura
- 9000 — erro interno (inesperado)
Lista completa
| Código | O que significa | O que fazer |
|---|---|---|
| IT-1001 | Usuário ou senha inválidos | Confira login, senha e licença |
| IT-1002 | Sessão expirada | Faça login novamente |
| IT-1003 | Sessão substituída por novo login | Você entrou em outro dispositivo; faça login de novo |
| IT-1004 | Acesso temporariamente bloqueado | Muitas tentativas; aguarde o tempo indicado |
| IT-1005 | Sistema bloqueado por pendência financeira | O administrador deve regularizar o pagamento |
| IT-1006 | Link de acesso (SSO) inválido ou expirado | Volte ao CRM antigo e clique de novo no botão |
| IT-1007 | Não autenticado | Faça login novamente |
| IT-2001 | Sem permissão para esta ação | Peça a um administrador para habilitar a permissão (Permissões) |
| IT-2002 | Sem permissão para ver leads | Peça para habilitar "Ver seus leads" |
| IT-2003 | Corretor inativo ou não cadastrado | O administrador deve ativar/cadastrar o corretor |
| IT-3001 | Dados inválidos | Revise os campos enviados |
| IT-3002 | Arquivo grande demais | O limite é 25 MB por arquivo; reduza o tamanho |
| IT-3003 | Formato de arquivo não suportado | Use JPG ou PNG |
| IT-4001 | Recurso não encontrado | Recarregue a página |
| IT-4002 | Link expirado ou inválido | Gere um link novo |
| IT-5001 | Conflito de reserva | Já existe reserva nesse período; escolha outro |
| IT-5003 | Registro duplicado | Já existe um registro com esses dados |
| IT-6001 | Muitas requisições | Reduza o ritmo e tente de novo em instantes |
| IT-6002 | Verificação de segurança necessária | Resolva o desafio "não sou robô" |
| IT-7000 | Serviço externo indisponível | Tente novamente em instantes |
| IT-7001 | Erro na integração com o Facebook/Meta | Reconecte a conta do Facebook |
| IT-7002 | Falha ao encaminhar lead | Tente reenviar; se persistir, acione o suporte |
| IT-7005 | Erro na IA | Tente de novo; se persistir, verifique a chave de IA |
| IT-8001 | Banco de dados indisponível | Instabilidade momentânea; tente de novo |
| IT-8002 | A consulta demorou demais | Tente de novo; se persistir, acione o suporte |
| IT-8003 | Sistema sobrecarregado | Muitos acessos agora; tente em instantes |
| IT-8004 | Erro ao consultar dados | Acione o suporte com o código e o horário |
| IT-9000 | Erro interno (inesperado) | Acione o suporte com o código, a tela e o horário |
Importante: se a tela mostrar "ref:" seguido de um conjunto de letras/números (ex:
ref: a1b2c3), esse é um código técnico do momento (do navegador), que muda a cada versão. Ele também serve ao suporte — informe junto. Os códigos IT-NNNN são os estáveis.
Perguntas frequentes
Onde vejo o código? No fim da mensagem de erro, entre parênteses (ex: "... (IT-2001)").
Preciso decorar os códigos? Não — só informe o que aparecer ao abrir o chamado. Esta página serve de consulta para você e para o suporte.
Para o time técnico: esta lista espelha o catálogo do backend em
imobtotal-app/src/common/errors/error-codes.ts(ERROR_CATALOG). Ao adicionar/alterar um código lá, atualize aqui.