Acesso e permissões — solução de problemas#
Não consigo entrar, esqueci a senha, perdi o 2FA, o menu não mostra a tela, usuário sem permissão, convite que não chegou. Para qualquer usuário da retaguarda, e para quem administra usuários.
Antes de começar — a autorização do ERPia é do servidor, não do menu. Esconder um item de menu é conveniência; quem barra é a autorização. Isso significa que "abrir o endereço da tela na mão" não resolve falta de permissão — e é por isso que esta página não sugere esse caminho.
Passo a passo#
- Identifique o seu sintoma na tabela abaixo.
- Execute a ação segura primeiro.
- Se a ação exigir um acesso que você não tem, a linha diz quem faz.
- Se você não é quem administra usuários, o caminho normal é encaminhar — não tentar contornar.
Sintomas e ações#
Não consigo entrar#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| "e-mail ou senha incorretos" | E-mail diferente do cadastrado, ou senha errada. A mensagem é a mesma para os dois casos, de propósito | Confira o e-mail. Se estiver certo, peça um novo link de acesso a quem administra usuários. |
| "muitas tentativas de login; aguarde alguns instantes" | Limite de tentativas por endereço de rede atingido | Aguarde a janela passar. O padrão é 10 tentativas por 60 segundos. Não fique tentando: cada tentativa consome o limite. |
| "muitas tentativas agora; tente de novo em instantes" | O processamento de credenciais está sob carga | Aguarde e tente de novo. Se durar muitos minutos, escale. |
| "usuario sem permissao para retaguarda" | O seu usuário não tem acesso à retaguarda naquela empresa | Confirme com quem administra usuários se o seu perfil tem acesso à retaguarda na empresa certa. Se você tem acesso a várias empresas, confirme que escolheu a empresa certa. |
| "limite de acessos simultaneos do plano atingido; feche uma sessao aberta em outro dispositivo" | O plano tem um teto de sessões simultâneas e ele foi atingido | Feche a sessão em outro navegador ou dispositivo. Se não houver outra sessão sua, é caso de suporte ou revenda. |
| A tela de login não carrega ou dá erro de rede | A API ou a retaguarda não estão no ar para este computador | Este é um problema de instalação, não de credencial. Acione quem opera a instalação. |
| Entro, mas caio de volta no login | A sessão não está sendo mantida no navegador | Verifique se o navegador está bloqueando armazenamento local e cookies. Tente uma janela anônima para isolar. Se persistir, escale. |
O bloqueio de login é por endereço de rede, não por conta. É uma decisão deliberada: travar só por conta transformaria o bloqueio em arma contra a própria pessoa — bastaria errar a senha de alguém repetidamente para derrubar o acesso dela.
Esqueci a senha#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Esqueci a senha | — | Peça a quem administra usuários que gere um novo link de acesso na sua ficha. O mesmo link serve para primeiro acesso e para redefinição. |
| Recebi dois links e não sei qual usar | Você pediu duas vezes | Use o mais recente. Os links anteriores continuam válidos até expirarem ou serem usados, então o mais novo funciona. |
| O link diz "Convite inválido, expirado ou já utilizado." | Link já usado, vencido (7 dias) ou substituído | Peça um link novo. |
| O link abre e eu defino a senha, mas não aceita | A senha tem menos de 8 caracteres | A senha da retaguarda exige 8 caracteres ou mais. |
| Não sei qual é a minha senha e ninguém consegue me dizer | Isso é o esperado: ninguém, nem o administrador, conhece a sua senha | A senha é criada pelo próprio usuário. Use o link de acesso. |
Perdi o 2FA#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Troquei de celular e não tenho mais o aplicativo | A conta tem verificação em duas etapas ligada | Use um código de recuperação. Eles foram mostrados uma única vez, quando você ativou o 2FA. |
| Perdi os códigos de recuperação também | — | Quem tem o direito Usuários faz o reset do 2FA do seu usuário. Depois disso, você configura de novo, do zero. |
| "codigo invalido; confira o horario do celular e o app autenticador" | Relógio do celular fora de sincronia, ou aplicativo errado | Ajuste a data e a hora do celular para automático e gere um código novo. |
| "o enrollment do segundo fator expirou; comece de novo" | Passaram-se mais de 10 minutos entre abrir o QR e confirmar | Reinicie a configuração do 2FA. |
| "para trocar o segundo fator de uma conta que ja tem 2FA, informe um codigo atual do app ou de recuperacao" | Você pediu um segredo novo com o 2FA já ativo | Informe um código atual. Isso existe para impedir que alguém com a sua sessão assuma o seu 2FA. Sem código, peça reset. |
| "codigo invalido; informe um codigo atual do app ou de recuperacao" ao tentar desligar | Mesma exigência, na ação de desabilitar | Informe um código atual, do aplicativo ou de recuperação. |
| "codigo_2fa obrigatorio" ao entrar | A conta tem 2FA e o código não foi informado | Informe o código do aplicativo ou um código de recuperação. |
| Não quero usar 2FA | Você pode desligar, informando um código atual | Desligar reduz a proteção da conta. Em empresas que exigem 2FA por parâmetro, a exigência continua valendo — reative. |
O menu não mostra a tela#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Falta um domínio inteiro no meu menu | Falta a permissão das telas daquele domínio no seu perfil | Peça a permissão. Veja a tabela permissão → tela em Papéis, perfis e permissões. |
| Falta uma tela específica, mas o domínio aparece | Falta só aquela permissão | Idem. Consulte a permissão da tela na mesma tabela. |
| Um colega com o mesmo cargo vê mais telas que eu | O acesso é por direito, não por cargo: os perfis de vocês são diferentes | Compare os perfis em Administração > Perfis e acessos com quem administra usuários. |
| Não encontro Certificado A1 nem Homologação NFC-e no menu | São apelidos ocultos: existem para manter links antigos funcionando, não para publicar uma segunda entrada | O caminho é a tela de origem: Lojas (aba Certificado) e Monitor NFC-e. Ver o mapa em Mapa das telas da retaguarda. |
| A tela aparece no menu mas não abre | Falta permissão de dados no contexto atual | "Esta operacao nao esta liberada para o contexto atual." Confirme a loja e o perfil selecionados. Se estiverem corretos, peça liberação ao administrador. |
| Vejo o item e o sistema recusa a ação | A permissão da tela é diferente da permissão da ação | Há permissões de ação que não são donas de item de menu — por exemplo, a de operar SINTEGRA em relação à de consultar. Peça o direito da ação. |
| Meu menu mudou depois que alguém mexeu no perfil | O menu é montado a partir dos direitos lidos na sessão | Saia e entre de novo: a sessão nova lê os direitos atuais. |
Usuário sem permissão#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| "Use um usuario com permissao para esta rotina ou solicite liberacao ao gerente/administrador." | Falta o direito da rotina no perfil | Peça a permissão a quem administra perfis. |
| "PERMISSAO_INSUFICIENTE" ao tentar uma etapa fiscal ou de SPED | Rotina fiscal e de SPED exige administrador ou contador | Peça ao administrador ou ao contador da empresa. Não é ajuste de tela. |
| O operador de caixa não consegue uma ação e o gerente consegue | Diferença de direito entre os perfis de frente de loja | Peça a quem administra perfis, ou use a autorização por supervisor. |
| "Código ou PIN de quem autoriza inválido." | Quem tentou autorizar não tem o direito Autorizar (supervisor) | Use alguém que tenha esse direito. |
| O desconto do operador não passa do limite, mesmo tendo a permissão | Ter o direito de desconto não basta: existe o teto do perfil | Ajuste o teto do perfil, ou peça autorização a quem tem teto maior. Ver Papéis, perfis e permissões. |
| Não consigo editar um perfil | O perfil é travado | Perfis travados são protegidos pelo sistema. Crie um perfil novo em vez de alterar o protegido. |
O convite não chegou#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| O usuário diz que não recebeu o convite | O convite pode ter sido gerado e não enviado — o sistema entrega o link, e o envio é por conta de quem convida | Copie o link na ficha do usuário (Copiar link) e envie por canal seguro. |
| Não sei qual link enviar | Você gerou vários | Os links anteriores continuam válidos até expirarem ou serem usados. Envie o mais recente. |
| O link foi para o e-mail errado | O e-mail não confere com o cadastro | Corrija o e-mail na ficha do usuário e gere um link novo. |
| O usuário não tem e-mail cadastrado | O e-mail é opcional no cadastro | Você ainda pode gerar o link e enviar por outro canal, por exemplo WhatsApp. |
| O convite foi recusado como "usuario deste convite nao esta mais ativo na empresa" | O usuário foi inativado entre o convite e o aceite | Reative o usuário e gere um convite novo. |
| O convite de identidade pede um código de 2FA que a pessoa não tem | A conta da empresa tem segundo fator e a identidade global ainda não | A mensagem traz um sinalizador próprio para a tela distinguir isto de "senha errada". Oriente a pessoa a ligar a verificação em duas etapas na conta e aceitar de novo. |
| O usuário é novo e não sabe o que fazer | Falta orientação | Envie Primeiro acesso à retaguarda junto com o link. |
Campos e o que significam#
| Campo | O que é | Observação |
|---|---|---|
| o identificador da conta na empresa | É o mesmo do cadastro do usuário. É opcional no cadastro — sem ele, o link sai por outro canal. | |
| Senha | a senha pessoal da retaguarda | 8 caracteres ou mais. Criada pelo próprio usuário. |
| Código (2FA) | o código do aplicativo autenticador | Também aceita código de recuperação. |
| Link de acesso | o endereço de uso único para definir a senha | Vale 7 dias. Gerado na ficha do usuário. |
| Verificação em duas etapas | o estado do 2FA da conta | Ativa ou não configurada. A ativação é do próprio usuário. |
| Último acesso | quando a pessoa entrou pela última vez na retaguarda | "nunca" é uma resposta legítima. |
| Último acesso pelo caixa | quando a pessoa entrou pela última vez no PDV | Separado do acesso à retaguarda. |
| Ativo | se o usuário pode entrar | Usuário inativo não aceita convite. |
Resultado esperado#
- O usuário entra com e-mail e senha (e o código de 2FA, quando a conta tem).
- O menu mostra exatamente os domínios e as telas cujas permissões o perfil dele tem.
- A ficha do usuário mostra Último acesso preenchido depois do primeiro login.
- Um convite novo foi gerado e enviado quando o anterior venceu ou foi usado.
Se algo der errado#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Fiz a ação segura e continua igual | A causa é outra | Escale com a mensagem exata e o horário. Ver Como abrir um chamado. |
| Não tenho acesso à tela que resolveria o problema | Falta permissão — e é justamente o seu problema | Encaminhe para quem tem. Esta página diz quem faz em cada linha. |
| O sistema mostra "sessão expirada" | A sessão venceu por inatividade | Entre de novo. Se acontecer com frequência fora do normal, escale. |
| A pessoa insiste que a senha está certa e o sistema recusa | Pode ser o e-mail da empresa errada, ou o teclado/caps lock | Confirme o e-mail cadastrado e teste em outro navegador. Persistindo, gere link novo. |
| O 2FA foi resetado e a pessoa não consegue ativar | O preparo expira em 10 minutos | Refaça a configuração do zero, confirmando dentro da janela. |
Como funciona por dentro#
- A sessão é validada no servidor, com revogação. Trocar de empresa, por exemplo, cria a sessão nova e encerra a antiga — não é apenas uma troca de contexto no navegador.
- O 2FA vive no cadastro certo. Uma conta migrada autentica pelo login global e valida o código contra o cadastro de identidade; contas ainda não migradas usam o cadastro antigo. Quando isso está errado, o sintoma é exatamente "ativei o 2FA e o sistema continua pedindo só a senha" — e isso é defeito, não configuração.
- O limite de login é por IP, em memória. Num cluster com várias instâncias, cada uma limita localmente.
- O menu é derivado. A permissão não é declarada no menu: ela é derivada da especificação da tela. Por isso não existe "dar permissão de menu" separada de "dar permissão de tela".
O que é de fábrica e o que a sua empresa pode ter mudado#
| Ponto | Padrão de fábrica | Como fica diferente |
|---|---|---|
| Verificação em duas etapas na retaguarda | não exigida (seguranca.exigir_2fa nasce desligado). Quem só opera o caixa (PIN ou QR) não é afetado em nenhum caso | ligada, quem ainda não cadastrou o 2FA entra mas só usa a tela de cadastro do próprio 2FA até concluir |
| Endereço da tela de login | depende da instalação: é o host e a porta do servidor do cliente, com /retaguarda/ no caminho | quem opera a instalação informa o endereço |
| Perfis fiscais | cadastro separado de perfil de acesso; existir ou não depende da empresa ser contribuinte | em Administração › Perfis e acessos você vê os perfis de acesso; perfis fiscais ficam em Fiscal › Perfis fiscais |
| Painel da conta (2FA e troca de empresa) | aberto pelo cartão da conta no rodapé da barra lateral; rótulo varia com o nome do usuário | — |
Onde aprofundar#
- Primeiros passos da loja na retaguarda: Primeiros passos da loja.
- Cadastro de usuários, perfis e lojas: Cadastros.
- Mapa completo das telas e das permissões de cada uma: Mapa das telas da retaguarda, Papéis, perfis e permissões.
- Instalar e ativar um caixa: Instalar e atualizar o PDV.