Primeiro acesso à retaguarda#

Como entrar na retaguarda pela primeira vez, definir a sua senha, ligar a verificação em duas etapas e se orientar pelo menu. Para quem vai usar a retaguarda — dono, gestor, financeiro, contador.

Antes de começar — você precisa de duas coisas:

Um usuário cadastrado nesta empresa, com o seu e-mail, feito por alguém que tenha o direito de gerenciar usuários.
O link de acesso gerado para esse usuário, ou um convite recebido por e-mail. A senha não é criada por outra pessoa. Uma identidade nova cria a senha; uma identidade existente confirma a senha atual.

Passo a passo#

1Descobrir o endereço#

A retaguarda é servida pelo mesmo processo da API, na mesma porta. O endereço tem este formato:

http://<servidor-ou-localhost>:<porta>/retaguarda/

No computador da própria loja, o atalho que abre a retaguarda é o ABRIR_RETAGUARDA.bat: ele testa a API, corrige a porta registrada quando necessário e liga a API e a retaguarda se nada estiver no ar. Na instalação de produção, a porta padrão da API é 8090; no ambiente de desenvolvimento Windows, 8081 — se essa porta já estiver ocupada, o script escolhe uma livre entre 8090 e 8199.

Se você não sabe qual é o endereço na sua loja, pergunte a quem instalou. Não tente adivinhar a porta.

Abra o link recebido e confira o seu e-mail.
Se aparecer Nova senha, crie sua senha com pelo menos 8 caracteres.
Se aparecer Senha atual, informe a senha da identidade que você já usa.
Informe o segundo fator quando a tela solicitar.
Confirme o acesso à empresa indicada.

Um convite para outra empresa não redefine a senha de uma identidade existente. Para redefinir a senha, use o link específico gerado para recuperação de acesso. O link é uma credencial de uso único. Não o repasse. Se vencer, peça outro a quem gerencia o acesso.

Fonte: e , revisão b3dc478f3731.

3Entrar normalmente#

Abra a retaguarda e vá para a tela de login.
Informe e-mail e senha.
Se a sua conta tiver verificação em duas etapas ligada, informe também o código do aplicativo autenticador. A tela pede o código quando ele é obrigatório.
Se a sua conta tiver acesso a mais de uma empresa, a tela pede que você escolha a empresa antes de entrar. Cada empresa aparece com o nome e o CNPJ mascarado (a raiz do CNPJ é omitida e apenas a filial e o dígito verificador aparecem), para você reconhecer a empresa sem expor o número inteiro.
Escolha a empresa. A seleção tem prazo: se demorar, ela expira e você precisa entrar de novo.

4Configurar a verificação em duas etapas#

A empresa pode exigir o segundo fator. Consulte Papéis e permissões e siga a solicitação da tela.

A ativação é self-service: cada pessoa liga o 2FA da própria conta, ninguém faz por você.

Entre na retaguarda e abra o menu da sua conta.
Peça para iniciar a configuração do segundo fator.
A tela devolve um segredo e um QR Code. Leia o QR com o aplicativo autenticador, ou digite o segredo à mão se o seu aplicativo não tiver câmera.
Informe o primeiro código gerado pelo aplicativo para confirmar.
A confirmação devolve os códigos de recuperação. Eles aparecem uma única vez — o sistema guarda apenas o hash. Guarde-os fora do celular.

O preparo do segundo fator expira em 10 minutos. Se você demorar mais que isso entre abrir o QR e confirmar, o preparo vence e é preciso começar de novo.

Se a sua conta já tem 2FA e você quer trocar o aparelho, o sistema exige um código atual (do aplicativo ou um código de recuperação) antes de gerar um novo segredo. Isso impede que alguém que tenha pegado a sua sessão assuma o seu segundo fator. Se a sua tela não exibir o campo de código atual, não gere um segredo novo: acione quem administra os usuários — gerar por cima derruba o acesso de quem está usando o fator atual.

Para desligar o 2FA, também é preciso informar um código atual, do aplicativo ou de recuperação.

5Se você perdeu a senha#

Peça a quem administra os usuários um link de redefinição de senha, gerado no cartão Senha da retaguarda.
Abra esse link e defina a senha nova. Ele usa o caminho /redefinir. O convite de identidade em /retaguarda/login.html?convite=… tem outra função: vincular o acesso à empresa. Para uma identidade existente, esse convite exige a senha atual; ele não redefine a senha. O administrador envia o link por canal seguro e não precisa conhecer a sua senha.
Os links gerados antes continuam válidos até expirarem ou serem usados. Se você recebeu dois links, use o mais recente e ignore o outro.

Para acesso à Área da revenda, siga o guia da revenda. O administrador de uma empresa cliente não recupera o acesso de operador da revenda.

6Se você perdeu o 2FA#

Os códigos de recuperação são o caminho normal. Se você perdeu também os códigos, quem tem o direito de gerenciar usuários consegue resetar o 2FA do seu usuário. Depois do reset, você configura de novo, do zero.

7Trocar de empresa sem sair#

Se a sua conta tem acesso a mais de uma empresa, existe um seletor de empresa dentro da retaguarda. Ao escolher outra empresa, o sistema cria uma sessão nova na empresa de destino e encerra a sessão atual. Você não precisa fazer login de novo.

A troca de empresa só existe para contas com login por e-mail e senha. Contas que entram por outros caminhos não têm o que trocar ali.

O menu da retaguarda é organizado em nove domínios, nesta ordem:

Domínio	O que reúne
Visão geral	o que exige atenção agora, sem procurar em menu de ERP
Operação e PDV	catálogo, preço, campanha e os caixas da loja
Compras e estoque	entrada de nota, contagem, reposição e movimento entre lojas
Produção	ficha técnica, lote, rendimento e a fornada na hora certa
Financeiro	caixa, recebíveis, contas e o balancete do período
Gestão e análises	faturamento, margem, risco e o que os números pedem de decisão
Fiscal	emissão de documento fiscal e a regra tributária do produto
Contador	fechamento do mês: SPED, XML, decisões e governança fiscal
Administração	acesso, lojas, parâmetros, integrações e governança da IA

A tela Mapa das telas da retaguarda detalha cada domínio, tela a tela.

Para abrir uma tela, use o menu. O endereço de uma tela tem o formato tela/<identificador>, por exemplo tela/produtos ou tela/caixa-geral. Alguns itens de menu levam a um recorte da tela, com um filtro já aplicado — é o caso do atalho de auditoria, que abre Parâmetros já filtrado.

9Se um domínio ou uma tela não aparece#

O menu não é igual para todos. Ele é montado a partir dos direitos do seu perfil: um item só aparece se você tiver a permissão daquela tela.

Se falta um domínio inteiro, ou falta uma tela específica:

Confirme com quem administra os usuários qual é o seu perfil e quais permissões ele tem.
Peça a inclusão da permissão necessária. A lista de permissão → tela está em Papéis, perfis e permissões.
Não tente contornar abrindo o endereço da tela na mão: a autorização é do servidor, não do menu. O endereço abriria sem a tela.

Campos e o que significam#

Campo	O que é	Observação
E-mail	o identificador da sua conta na empresa	É o mesmo e-mail do cadastro do usuário na retaguarda.
Senha	a sua senha pessoal	Mínimo de 8 caracteres. Criada por você pelo link de acesso.
Código (2FA)	o código de 6 dígitos do aplicativo autenticador	Também aceita um código de recuperação. Só é pedido quando a conta tem 2FA.
Empresa	a empresa com que você vai trabalhar nesta sessão	Aparece só quando a sua conta tem acesso a mais de uma. O CNPJ vem mascarado.
Link de acesso	o endereço de uso único para o usuário definir a própria senha	Vale 7 dias. Quem tem o direito de gerenciar usuários gera na ficha do usuário.

Resultado esperado#

Você entra na retaguarda com e-mail e senha, vê o menu com os domínios do seu perfil, e — se ligou o 2FA — passa a informar o código do aplicativo a cada login. Na ficha da sua conta, a verificação em duas etapas aparece como ativa e o resumo de proteção da conta aparece como Proteção reforçada.

Se algo der errado#

Sintoma	Causa provável	O que fazer
"e-mail ou senha incorretos"	E-mail digitado diferente do cadastrado, ou senha errada. A mensagem é a mesma para os dois casos, de propósito	Confira o e-mail. Se estiver correto, peça um novo link de acesso.
"muitas tentativas de login; aguarde alguns instantes"	Limite de tentativas por endereço de rede atingido	Aguarde a janela passar e tente de novo. Não fique tentando: cada tentativa consome o limite. O padrão é 10 tentativas por 60 segundos, por IP.
"muitas tentativas agora; tente de novo em instantes"	O sistema está sob carga no processamento de credenciais	Aguarde e tente de novo. Se persistir por muitos minutos, é caso de suporte.
A tela pede o código de 2FA e eu não tenho o aplicativo	A conta tem 2FA ligado e você trocou ou perdeu o celular	Use um código de recuperação. Sem eles, peça a quem administra usuários para resetar o seu 2FA.
"codigo invalido; confira o horario do celular e o app autenticador"	Relógio do celular fora de sincronia, ou app errado	Ajuste a data e 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 estando com 2FA já ativo	Informe um código atual. Sem ele, peça reset a quem administra usuários.
"esta selecao expirou; entre novamente"	A escolha de empresa demorou demais	Faça o login de novo e escolha a empresa sem demora.
"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/revenda.
"usuario sem permissao para retaguarda"	O seu usuário não tem acesso à retaguarda nesta empresa	Confirme com quem administra usuários se o seu perfil tem acesso à retaguarda naquela empresa.
"convite invalido, expirado ou ja utilizado" / "Convite inválido, expirado ou já utilizado."	O link já foi usado, venceu (7 dias) ou foi substituído	Peça um link novo.
"usuario deste convite nao esta mais ativo na empresa"	O usuário foi inativado entre o convite e o aceite	Quem administra usuários precisa reativar o usuário e gerar um convite novo.
"senha invalida" ao aceitar um convite	A senha informada não confere com a credencial daquela conta	Verifique se você está usando a senha da conta certa. Se a conta exige 2FA, o código também é obrigatório.
"codigo de verificacao em duas etapas invalido"	Código do 2FA errado ou vencido	Gere um código novo.
O menu não mostra um domínio que deveria existir	Falta a permissão no seu perfil	Peça a permissão. Ver Papéis, perfis e permissões.
Não consigo trocar de empresa: a opção não aparece	A sua sessão não é de login por e-mail e senha	A troca de empresa só existe para contas com esse tipo de login.

Como funciona por dentro#

A autorização é do servidor, não do menu. O menu apenas não mostra o que você não pode abrir.
O sistema não trava a conta por tentativas erradas de senha; ele limita por endereço de rede. É 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 para derrubar o acesso dela).
O cadastro em que o seu 2FA vive depende de como a sua conta autentica. Se você ativou o 2FA e continua entrando só com senha, isso é um defeito, não uma configuração: registre pelo canal de chamado.

O que depende da sua instalação#

Ponto	Como funciona
Endereço de acesso (host e porta)	não é fixo: é o endereço do servidor da sua instalação, sempre com `/retaguarda/` no caminho. Quem opera a instalação informa o endereço exato
Campo Empresa no login	aparece só quando a conta tem vínculo com mais de uma empresa. Conta de uma empresa só não vê o campo — não é erro
Gestão do próprio 2FA	fica no painel da conta, aberto pelo cartão da conta no rodapé da barra lateral. O rótulo acompanha o nome do usuário logado. Se o seu perfil não dá acesso à conta, o caminho é pedir a quem administra usuários