Ir para o conteúdo
clabor Manual do ERPia

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

  1. Abra Administração > Usuários.
  2. Clique em Incluir usuário.
  3. 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).
  4. Marque as Lojas com acesso — o usuário só vê dados das lojas marcadas.
  5. 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.
  6. Deixe Usuário ativo ligado.
  7. Salve o usuário.
  8. 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.
  9. 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

CampoO que éObservação
Nome completo *Identificação da pessoa no sistema—
E-mail de acessoLogin e destino do link de senha—
Código do operador (caixa)Matrícula usada no PDVPrecisa ser único na empresa
TelefoneContatoNão entra em nenhum login
Usuário ativoLiga/desliga o acessoInativo 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 fazerUm usuário pode ter perfil de retaguarda, de frente de loja, ou os dois
PIN do caixaLibera o terminal e autoriza operações no PDVObrigatório ao criar; pode repetir entre usuários
QR Code de login no PDVCrachá para entrar no caixa sem digitarPrecisa ser único; em branco, o sistema gera
Foto do usuárioImagem do cadastroPNG/JPG/WebP
Proteção da contaResumo do estado real de 2FA, PIN e QRAparece 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

SintomaCausa provávelO que fazer
“Este QR Code de login já está em uso por outro usuário desta empresa”Crachá duplicadoTroque 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 duplicadaUse outro código
“usuário inativo — reative antes de gerar o convite”A pessoa foi inativadaReative o usuário e gere o convite de novo
A pessoa não vê nenhuma telaPerfis vazios ou sem as rotinasRevise o perfil em Perfis e acessos e os perfis no cadastro dela
A pessoa vê dados de loja erradaLojas com acesso marcadas a maisAjuste 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.

  1. Abra Administração > Usuários do PDV.
  2. Clique em Incluir usuário do PDV.
  3. Informe Nome, Código (matrícula), o PIN do caixa (4 dígitos) e a Loja.
  4. Marque o Papel (perfil) — Gerente, Supervisor, Operador de caixa etc. É o papel que define o que a pessoa pode fazer no caixa.
  5. Preencha o QR Code de login se a loja usa crachá.
  6. Deixe Ativo ligado e salve.

Campos e o que significam

CampoO 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 terminalLogin do caixa é código + PIN
LojaLoja em que ele opera—
Papel (perfil) *Rotinas liberadas no caixaVem dos perfis de Frente de loja
QR Code de loginCrachá—
AtivoLiga/desligaInativo 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

SintomaCausa provávelO que fazer
O operador não aparece na lista de Sem PINJá tem PIN cadastradoConfira o chip Sem PIN para achar quem falta
O operador não consegue autorizar uma operaçãoO papel dele não tem a rotinaAjuste o perfil, na aba Frente de loja de Perfis e acessos
O operador entrou na loja erradaCampo Loja do cadastroCorrija 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).

  1. Abra Administração > Perfis e acessos.
  2. Escolha a aba: Retaguarda ou Frente de loja.
  3. Clique em Incluir perfil.
  4. Dê um Nome e uma Descrição (a descrição ajuda quem for auditar depois).
  5. Confirme o Cadastro (o escopo: retaguarda ou frente de loja).
  6. Marque as Rotinas liberadas — as permissões estão agrupadas por módulo.
  7. Salve.

Campos e o que significam

CampoO que éObservação
Nome *Nome do perfil—
DescriçãoPara que serve o perfil—
Cadastro *Escopo do perfilRetaguarda ou Frente de loja
Rotinas liberadasPermissões marcadasAgrupadas 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

SintomaCausa provávelO que fazer
“dê um nome ao perfil”Salvou sem nomePreencha Nome
A rotina que eu quero não apareceEla é do outro escopoTroque a aba (Retaguarda × Frente de loja)
Usuário continua sem acesso depois de marcar a rotinaPerfil não foi atribuído a eleAbra o usuário e marque o perfil
Não consigo editar o perfil AdministradorO 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.

  1. Abra Administração > Lojas.
  2. Clique em Nova loja.
  3. Informe Código, Tipo (Matriz ou Filial), Razão social e, se houver, Nome fantasia.
  4. 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.
  5. Escolha o Regime tributário: Simples Nacional, Lucro Presumido ou Lucro Real.
  6. 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).
  7. Defina o Limite de caixas desta loja (0 = ilimitado) e envie o Logo da loja se quiser.
  8. Marque Loja ativa (em operação) e salve.
  9. 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.
  10. Se a loja vai emitir documento fiscal, instale o certificado na aba Certificado.
  11. Abra a aba NFE/NFCe da ficha e configure a emissão (veja abaixo).

Campos e o que significam

CampoO que éObservação
Código *Código interno da loja—
TipoMatriz ou Filial—
Razão social *Nome jurídico da lojaComo consta no CNPJ
Nome fantasiaNome de operaçãoAté 60 caracteres
Matriz vinculadaMatriz da filial—
Espelhar preços deLoja de origem dos preçosSó na criação
Regime tributário *Regime inicial da lojaDepois da declaração, mantido pela aba Fiscal
CNPJ, Inscrição estadual, UF, Município, Cód. município (IBGE)Identidade fiscalUsados no documento fiscal
Logradouro, Número, Bairro, CEPEndereço—
Limite de caixas desta lojaQuantos PDVs a loja pode ter0 = ilimitado; distribua os caixas do plano
Logo da lojaImagem da lojaPNG/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.

  1. Abra a ficha da loja em Administração > Lojas.
  2. Abra a aba Fiscal.
  3. Informe Regime federal e CRT, conforme a declaração do contador.
  4. Preencha Vale a partir de com a data de vigência. O sistema não aceita data futura.
  5. Se houver regime estadual especial, informe código, ato concessório e início da vigência. Informe o fim quando houver.
  6. Responda às cinco perguntas sobre emissão B2B, venda interestadual, escrituração, operações industriais e Imposto Seletivo.
  7. Escolha Pratica, Não pratica ou Pendente (ainda não informado) em cada pergunta.
  8. Clique em Salvar declaração fiscal.
  9. 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#

CampoO que éObservação
AmbienteHomologaçã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 lojaA 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 offlineAutoriza emitir sem SEFAZ—
ID token CSC / CSCCredenciais do CSCSó 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

SintomaCausa provávelO que fazer
Não consigo espelhar preço de outra lojaO campo só vale na criaçãoCrie a loja novamente ou ajuste os preços pela Precificação
O caixa emite com série erradaA série da NFC-e é do PDV, não da lojaAjuste o PDV, não a loja
NFC-e rejeitada por credenciaisCSC ausente/incorreto (só NFC-e)Preencha ID token CSC e CSC
A loja não aparece para o usuárioLoja não marcada em Lojas com acessoAjuste no cadastro do usuário

Como instalar ou trocar o certificado A1#

  1. Abra a ficha da loja em Administração > Lojas.
  2. Vá para a aba Certificado.
  3. Envie o arquivo Certificado A1 (.pfx / .p12).
  4. Informe a Senha do certificado — ela só é necessária para enviar ou trocar o A1.
  5. 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.

  1. Abra Administração > Parâmetros.
  2. Filtre por Módulo, Risco ou Escopo, ou busque por código, impacto ou descrição.
  3. Abra o parâmetro.
  4. Leia o impacto e o risco.
  5. Altere o valor.
  6. Se o risco for alto, escreva o motivo — sem motivo a alteração não passa, e o motivo vai para o histórico.
  7. 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

SintomaCausa provávelO 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 altoMotivo em branco ou curtoEscreva o motivo da decisão
Não encontro o parâmetroFiltro de módulo/escopo ativoLimpe 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.

  1. Abra o parâmetro em Administração > Parâmetros.
  2. No seletor de loja da ficha, escolha a loja que terá valor próprio (deixar no valor padrão significa “todas as lojas”).
  3. Informe o valor e o motivo, e salve.
  4. Confira o bloco Valores por loja: ele lista cada loja com valor próprio e o valor resumido.
  5. 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#

  1. Abra Administração > Parâmetros.
  2. Clique no chip Histórico de alterações (o alias Auditoria operacional leva ao mesmo recorte pelo endereço tela/parametros?filtro=auditoria).
  3. Busque por parâmetro, usuário ou período.
  4. 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.