Cadastros e acessos da retaguarda#
Quem entra, o que cada pessoa pode fazer, qual é a loja e quais regras do sistema estão ligadas. Esta página cobre Usuários, Usuários do PDV, Perfis e acessos, Lojas, Parâmetros, o certificado A1, o convite de senha, o 2FA, os valores por loja e a auditoria.
Antes de começar — para tudo nesta página você precisa da permissão indicada em cada tarefa
(retaguarda.usuario_gerenciar, retaguarda.perfil_gerenciar, retaguarda.loja_gerenciar,
retaguarda.parametro_gerenciar). Sem ela, o item de menu nem aparece.
Como cadastrar um usuário da retaguarda#
Usuário da retaguarda é quem entra no navegador: gestor, financeiro, contador, comprador. Ele ocupa licença; o operador de caixa, não (veja Usuários do PDV).
- Abra Administração > Usuários.
- Clique em Incluir usuário.
- Preencha Nome completo, E-mail de acesso (por onde a pessoa entra e recebe o link de senha), Código do operador (caixa) (a matrícula que identifica a venda no PDV) e Telefone (contato, não entra em login).
- Marque as Lojas com acesso — o usuário só vê dados das lojas marcadas.
- Marque os Perfis. É o perfil que define o que a pessoa pode fazer; havendo mais de um perfil, a permissão dela é a união de todos.
- Deixe Usuário ativo ligado.
- Salve o usuário.
- No cartão Senha da retaguarda, gere o link de acesso e envie por canal seguro. Esse cartão gera um link
/redefinir, para a pessoa definir ou redefinir a senha com 8 caracteres ou mais. Ele é diferente do convite de identidade, que vincula a pessoa à empresa e exige a senha atual quando a identidade já existe. - Se o caixa for operado por essa pessoa, informe o PIN do caixa (4 dígitos) e, se for usar crachá, o QR Code de login no PDV.
Campos e o que significam
| Campo | O que é | Observação |
|---|---|---|
| Nome completo * | Identificação da pessoa no sistema | — |
| E-mail de acesso | Login e destino do link de senha | — |
| Código do operador (caixa) | Matrícula usada no PDV | Precisa ser único na empresa |
| Telefone | Contato | Não entra em nenhum login |
| Usuário ativo | Liga/desliga o acesso | Inativo não entra na retaguarda nem no caixa |
| Lojas com acesso * | Recorte de dados que a pessoa vê | O usuário só vê dados das lojas marcadas |
| Perfis * | O que a pessoa pode fazer | Um usuário pode ter perfil de retaguarda, de frente de loja, ou os dois |
| PIN do caixa | Libera o terminal e autoriza operações no PDV | Obrigatório ao criar; pode repetir entre usuários |
| QR Code de login no PDV | Crachá para entrar no caixa sem digitar | Precisa ser único; em branco, o sistema gera |
| Foto do usuário | Imagem do cadastro | PNG/JPG/WebP |
| Proteção da conta | Resumo do estado real de 2FA, PIN e QR | Aparece depois de salvar |
Resultado esperado — o usuário aparece na lista, com o selo de ativo, as lojas e os perfis marcados, e o cartão de senha mostrando o link de acesso pronto para copiar.
Se algo der errado
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| “Este QR Code de login já está em uso por outro usuário desta empresa” | Crachá duplicado | Troque o QR; o PIN pode repetir, o QR não |
| “Este código de operador já está em uso por outro usuário desta empresa” | Matrícula duplicada | Use outro código |
| “usuário inativo — reative antes de gerar o convite” | A pessoa foi inativada | Reative o usuário e gere o convite de novo |
| A pessoa não vê nenhuma tela | Perfis vazios ou sem as rotinas | Revise o perfil em Perfis e acessos e os perfis no cadastro dela |
| A pessoa vê dados de loja errada | Lojas com acesso marcadas a mais | Ajuste a marcação de lojas |
Segurança, 2FA e biometria#
- 2FA (verificação em duas etapas) só é ativado pelo próprio dono da conta: no cartão Verificação em duas etapas (2FA) da ficha, quem é o dono abre o painel self-service (o QR code só ele escaneia). Se você estiver vendo a ficha de outra pessoa, o mesmo botão serve para resetar o 2FA dela — recuperação de lockout: a pessoa volta a entrar só com senha e pode reativar quando quiser. No próprio menu da conta (canto inferior esquerdo), o painel de 2FA também abre.
- Reconhecimento facial — o cartão aparece na ficha; matricular e revogar biometria são permissões separadas (
retaguarda.biometria_matricular,retaguarda.biometria_revogar). - Últimos acessos — cartão de atividade da conta, para conferência.
Como cadastrar um usuário do PDV#
Usuário do PDV é quem opera a frente de loja. Ele não consome licença da retaguarda.
- Abra Administração > Usuários do PDV.
- Clique em Incluir usuário do PDV.
- Informe Nome, Código (matrícula), o PIN do caixa (4 dígitos) e a Loja.
- Marque o Papel (perfil) — Gerente, Supervisor, Operador de caixa etc. É o papel que define o que a pessoa pode fazer no caixa.
- Preencha o QR Code de login se a loja usa crachá.
- Deixe Ativo ligado e salve.
Campos e o que significam
| Campo | O que é | Observação |
|---|---|---|
| Nome * | Identificação do operador | — |
| Código (matrícula) * | Identifica o operador no PDV | — |
| PIN do caixa (4 dígitos) | Senha curta do terminal | Login do caixa é código + PIN |
| Loja | Loja em que ele opera | — |
| Papel (perfil) * | Rotinas liberadas no caixa | Vem dos perfis de Frente de loja |
| QR Code de login | Crachá | — |
| Ativo | Liga/desliga | Inativo não entra no caixa |
Resultado esperado — o operador aparece na lista na aba Ativos e consegue entrar no caixa com código + PIN.
Se algo der errado
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| O operador não aparece na lista de Sem PIN | Já tem PIN cadastrado | Confira o chip Sem PIN para achar quem falta |
| O operador não consegue autorizar uma operação | O papel dele não tem a rotina | Ajuste o perfil, na aba Frente de loja de Perfis e acessos |
| O operador entrou na loja errada | Campo Loja do cadastro | Corrija a loja do usuário do PDV |
Como criar um perfil de acesso#
Perfil é o conjunto de rotinas liberadas. Existem dois cadastros, em abas separadas na mesma tela: Retaguarda (gestão) e Frente de loja (caixa).
- Abra Administração > Perfis e acessos.
- Escolha a aba: Retaguarda ou Frente de loja.
- Clique em Incluir perfil.
- Dê um Nome e uma Descrição (a descrição ajuda quem for auditar depois).
- Confirme o Cadastro (o escopo: retaguarda ou frente de loja).
- Marque as Rotinas liberadas — as permissões estão agrupadas por módulo.
- Salve.
Campos e o que significam
| Campo | O que é | Observação |
|---|---|---|
| Nome * | Nome do perfil | — |
| Descrição | Para que serve o perfil | — |
| Cadastro * | Escopo do perfil | Retaguarda ou Frente de loja |
| Rotinas liberadas | Permissões marcadas | Agrupadas por módulo; a lista da aba só mostra rotinas do escopo |
Resultado esperado — o perfil aparece na aba escolhida e pode ser atribuído a usuários em Usuários (Retaguarda) ou Usuários do PDV (Frente de loja).
Se algo der errado
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| “dê um nome ao perfil” | Salvou sem nome | Preencha Nome |
| A rotina que eu quero não aparece | Ela é do outro escopo | Troque a aba (Retaguarda × Frente de loja) |
| Usuário continua sem acesso depois de marcar a rotina | Perfil não foi atribuído a ele | Abra o usuário e marque o perfil |
| Não consigo editar o perfil Administrador | O perfil Administrador é travado de propósito — o servidor recusa com O perfil Administrador é travado: não pode ser editado nem excluído. | Para dar direitos diferentes, crie um perfil próprio |
Como cadastrar uma loja#
Cada loja é um estabelecimento (matriz ou filial) com identidade fiscal própria.
- Abra Administração > Lojas.
- Clique em Nova loja.
- Informe Código, Tipo (Matriz ou Filial), Razão social e, se houver, Nome fantasia.
- Se for filial, escolha a Matriz vinculada; se quiser herdar preços de outra loja, escolha Espelhar preços de — atenção: esse campo só vale na criação.
- Escolha o Regime tributário: Simples Nacional, Lucro Presumido ou Lucro Real.
- Preencha a identidade fiscal: CNPJ, Inscrição estadual, UF, Município, Cód. município (IBGE) e o endereço (Logradouro, Número, Bairro, CEP).
- Defina o Limite de caixas desta loja (0 = ilimitado) e envie o Logo da loja se quiser.
- Marque Loja ativa (em operação) e salve.
- Abra a aba Fiscal e salve a declaração de regime, CRT, vigência e operações da loja, com a orientação do contador.
- Se a loja vai emitir documento fiscal, instale o certificado na aba Certificado.
- Abra a aba NFE/NFCe da ficha e configure a emissão (veja abaixo).
Campos e o que significam
| Campo | O que é | Observação |
|---|---|---|
| Código * | Código interno da loja | — |
| Tipo | Matriz ou Filial | — |
| Razão social * | Nome jurídico da loja | Como consta no CNPJ |
| Nome fantasia | Nome de operação | Até 60 caracteres |
| Matriz vinculada | Matriz da filial | — |
| Espelhar preços de | Loja de origem dos preços | Só na criação |
| Regime tributário * | Regime inicial da loja | Depois da declaração, mantido pela aba Fiscal |
| CNPJ, Inscrição estadual, UF, Município, Cód. município (IBGE) | Identidade fiscal | Usados no documento fiscal |
| Logradouro, Número, Bairro, CEP | Endereço | — |
| Limite de caixas desta loja | Quantos PDVs a loja pode ter | 0 = ilimitado; distribua os caixas do plano |
| Logo da loja | Imagem da loja | PNG/JPG/WebP |
| Loja ativa (em operação) | Liga/desliga a loja | — |
Como preencher a aba Fiscal da loja#
Para salvar esta aba, você precisa da permissão fiscal.configuracao, além do acesso ao cadastro da loja.
- Abra a ficha da loja em Administração > Lojas.
- Abra a aba Fiscal.
- Informe Regime federal e CRT, conforme a declaração do contador.
- Preencha Vale a partir de com a data de vigência. O sistema não aceita data futura.
- Se houver regime estadual especial, informe código, ato concessório e início da vigência. Informe o fim quando houver.
- Responda às cinco perguntas sobre emissão B2B, venda interestadual, escrituração, operações industriais e Imposto Seletivo.
- Escolha Pratica, Não pratica ou Pendente (ainda não informado) em cada pergunta.
- Clique em Salvar declaração fiscal.
- Reabra a aba e confira os valores e a mensagem de situação.
Simples Nacional usa CRT 1 ou 2; MEI usa 4; Lucro Presumido e Lucro Real usam 3. Não escolha o enquadramento por suposição. Uma capacidade Pendente não equivale a Não pratica.
Veja a explicação de todos os campos e avisos da aba Fiscal. Declarar um regime especial não aplica sozinho seu efeito aos itens: isso depende de exceção fiscal homologada.
Aba NFE/NFCe#
| Campo | O que é | Observação |
|---|---|---|
| Ambiente | Homologação (teste) ou Produção (valendo) | o ambiente vigente aparece no cadastro fiscal da loja; emitir em ambiente errado é falta grave — confirme antes |
| Fuso horário fiscal * | Fuso usado na emissão | — |
| Série NF-e (modelo 55) | Série da NF-e da loja | A série da NFC-e é de cada PDV, definida no cadastro do caixa |
| Prazo contingência (h) | Prazo de envio do documento emitido em contingência | — |
| Permite contingência offline | Autoriza emitir sem SEFAZ | — |
| ID token CSC / CSC | Credenciais do CSC | Só para NFC-e; não são usados na NF-e |
Resultado esperado — a loja aparece na lista com o tipo e o regime corretos, e passa a ser selecionável nos filtros das outras telas.
Se algo der errado
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Não consigo espelhar preço de outra loja | O campo só vale na criação | Crie a loja novamente ou ajuste os preços pela Precificação |
| O caixa emite com série errada | A série da NFC-e é do PDV, não da loja | Ajuste o PDV, não a loja |
| NFC-e rejeitada por credenciais | CSC ausente/incorreto (só NFC-e) | Preencha ID token CSC e CSC |
| A loja não aparece para o usuário | Loja não marcada em Lojas com acesso | Ajuste no cadastro do usuário |
Como instalar ou trocar o certificado A1#
- Abra a ficha da loja em Administração > Lojas.
- Vá para a aba Certificado.
- Envie o arquivo Certificado A1 (.pfx / .p12).
- Informe a Senha do certificado — ela só é necessária para enviar ou trocar o A1.
- Salve.
Como mudar um parâmetro#
Parâmetro é uma regra que muda o comportamento do sistema. Cada um informa risco e impacto antes de você mexer.
- Abra Administração > Parâmetros.
- Filtre por Módulo, Risco ou Escopo, ou busque por código, impacto ou descrição.
- Abra o parâmetro.
- Leia o impacto e o risco.
- Altere o valor.
- Se o risco for alto, escreva o motivo — sem motivo a alteração não passa, e o motivo vai para o histórico.
- Salve.
Resultado esperado — o parâmetro aparece com o novo valor e a mudança entra em Histórico de alterações com quem, quando e por quê.
Se algo der errado
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| “parâmetro não encontrado” | Registro saiu da lista (recarregue a tela) | Atualize e abra de novo |
| Não consigo salvar um parâmetro de risco alto | Motivo em branco ou curto | Escreva o motivo da decisão |
| Não encontro o parâmetro | Filtro de módulo/escopo ativo | Limpe os filtros ou troque o Escopo |
Como dar um valor diferente por loja (override)#
Parâmetros com suporte por loja aceitam valor próprio. Isso inclui parâmetros da Frente de loja e caixa.tolerancia_conferencia.
Confira o bloco Valores por loja da ficha antes de editar.
- Abra o parâmetro em Administração > Parâmetros.
- No seletor de loja da ficha, escolha a loja que terá valor próprio (deixar no valor padrão significa “todas as lojas”).
- Informe o valor e o motivo, e salve.
- Confira o bloco Valores por loja: ele lista cada loja com valor próprio e o valor resumido.
- Para desfazer, use Remover valor desta loja no bloco — o valor volta a seguir o padrão.
Na lista, a linha do parâmetro mostra quantas lojas têm valor próprio; o valor base aparece como linha própria.
Resultado esperado — a loja passa a operar com o valor próprio, e as demais continuam no padrão.
Como conferir a auditoria de parâmetros#
- Abra Administração > Parâmetros.
- Clique no chip Histórico de alterações (o alias Auditoria operacional leva ao mesmo recorte pelo endereço
tela/parametros?filtro=auditoria). - Busque por parâmetro, usuário ou período.
- Leia cada linha: quem mudou, o quê e quando.
Resultado esperado — você vê a trilha das alterações. A trilha é só leitura: não se edita nem se apaga histórico.