Papéis, perfis e permissões#
Quem pode fazer o quê no ERPia, e como pedir o acesso certo. Para o dono, o gestor e quem administra usuários — e para quem está bloqueado por não ver uma tela.
Antes de começar — você precisa do direito Perfis e acessos para criar ou alterar perfis, e do direito Usuários para vincular perfis a pessoas. Sem eles, o caminho é pedir a quem tem.
Passo a passo#
- Descubra em qual escopo o acesso vive: retaguarda (gestão) ou frente de loja (PDV).
- Identifique a permissão da tarefa na tabela "Permissão → tela → o que libera" desta página.
- Crie ou ajuste o perfil com essa permissão, em Administração > Perfis e acessos.
- Vincule o perfil à pessoa em Administração > Usuários (retaguarda) ou Administração > Usuários do PDV (caixa).
- Se a tarefa envolve desconto no caixa, configure também o limite do perfil — a permissão sozinha não basta.
- Peça à pessoa que faça login novamente: o menu é montado a partir dos direitos lidos na sessão.
Os dois escopos de perfil#
Todo perfil pertence a um escopo, e um usuário pode ter vários perfis. Os direitos efetivos são a união dos perfis dele.
| Escopo | Onde vale | Para quem |
|---|---|---|
| Retaguarda (gestão) | navegador, todas as telas de menu | dono, gestor, financeiro, contador, suporte |
| Frente de loja (PDV) | o aplicativo do caixa | operador de caixa, fiscal de caixa, gerente de loja |
São cadastros separados: podem existir dois perfis com o mesmo nome, um em cada escopo. Isso é intencional — o "Gerente" da retaguarda e o "Gerente" da frente de loja são coisas diferentes.
Os perfis de sistema#
Toda empresa nasce com estes perfis. Eles são ponto de partida, não camisa de força: o gestor pode criar perfis próprios e ajustar os existentes.
Escopo Retaguarda#
| Perfil | Descrição no cadastro |
|---|---|
| Operador | Acesso ao PDV e operações de baixo risco |
| Gerente | Liberações locais, cancelamentos e descontos acima do limite do operador |
| Administrador | Acesso total à retaguarda, cadastros e configurações |
| Contador | Acesso fiscal, SPED e documentos fiscais |
Escopo Frente de loja (PDV)#
| Perfil | Descrição no cadastro |
|---|---|
| Operador | (herdado do cadastro original) — o operador de caixa |
| Supervisor | Caixa + cancelamentos e descontos acima do operador |
| Gerente (frente de loja) | Todas as rotinas do caixa |
| Administrador (frente de loja) | Acesso total ao caixa |
Papéis típicos e onde eles vivem#
Esta tabela é uma sugestão de desenho, não uma regra do produto: o que vale é o direito. Use a coluna "Perfil de partida" como ponto de começo e ajuste conforme a sua loja.
| Papel na loja | Onde opera | Perfil de partida | Direitos que costuma precisar |
|---|---|---|---|
| Dono / gestor | retaguarda | Administrador (retaguarda) | praticamente todos; em especial Lojas, Perfis e acessos, Usuários, Parâmetros |
| Gerente de loja | retaguarda + PDV | Gerente (retaguarda) + Gerente (frente de loja) | catálogo, preço, promoções, encartes, estoque, caixa e relatórios |
| Operador de caixa | PDV | Operador (frente de loja) | vender, abrir e fechar caixa, cancelar item, reimprimir |
| Fiscal de caixa / supervisor de frente | PDV | Supervisor (frente de loja) | tudo do operador + sangria, suprimento, despesa, devolução, desconto acima do operador |
| Estoquista | retaguarda | perfil próprio com direitos de estoque | conferência de recebimento, pedido de compra, inventário, transferência, locais |
| Financeiro | retaguarda | perfil próprio com direitos financeiros | caixa geral, contas a pagar e a receber, conciliação de cartões e bancária, formas de pagamento, balancete |
| Contador | retaguarda | Contador | SPED, SINTEGRA, exportação de XML, trabalho fiscal, decisões fiscais, balanço externo |
| Suporte / revenda | painel do operador | perfil de plataforma | criar cliente, atribuir plano, ativar módulo, gerar convite/reset, consultar saúde — não opera produto, fiscal, caixa, estoque ou financeiro do cliente |
| TI / responsável pelo fiscal | retaguarda | perfil próprio com Lojas | dados fiscais da loja, certificado A1, ambiente e série, CSC |
Para o suporte e a revenda, o caminho é explícito no produto: o painel do operador serve para tarefas de plataforma. Para operar o produto do cliente — fiscal, caixa, estoque, financeiro —, entra-se pela retaguarda do cliente com um usuário da empresa.
Permissão → tela → o que libera#
A referência gerada de telas lista o contrato desta candidata: 9 domínios, 93 entradas e 84 telas. São 76 itens principais, oito fluxos filhos, cinco atalhos e quatro aliases. Há 45 permissões principais e três alternativas, totalizando 48.
As alternativas são fiscal.nfce_eventos, fiscal.regra_fiscal_homologar e
retaguarda.parametro_consultar. Uma alternativa aceita pelo item libera sua navegação;
as ações da tela continuam sujeitas às respectivas permissões.
O manual usa a mesma fonte versionada que gera o menu. Consulte essa referência para verificar o título, o destino e as permissões de cada tela, inclusive os cinco fluxos da Direção da Empresa.
Permissões que existem e não são donas de uma tela#
Algumas permissões são de ação, não de menu. Elas não fazem um item aparecer; elas liberam um botão, uma aba ou um comando dentro de uma tela.
| Permissão | O que libera |
|---|---|
fiscal.nfce_eventos | as ações de evento da NFC-e (cancelamento, inutilização, andamento dos eventos) no Monitor NFC-e, como alternativa a fiscal.nfce_emitir |
fiscal.regra_fiscal_homologar | a homologação de regra fiscal em Governança fiscal, como alternativa a fiscal.regra_fiscal_adotar |
retaguarda.auditoria_ver | acesso à trilha de auditoria. Ela existe no catálogo de permissões, mas não é a permissão de nenhum item do menu: a leitura da auditoria hoje se alcança pela tela Parâmetros, pelo recorte Auditoria operacional |
fiscal.sintegra_operar | pré-validar e gerar o SINTEGRA. fiscal.sintegra_consultar só permite consultar: quem tem apenas o direito de consulta recebe a recusa explícita ao tentar pré-validar ou gerar |
Permissões do PDV (frente de loja)#
Estas permissões não aparecem no menu da retaguarda: elas controlam o que o operador pode fazer no caixa. São elas:
| Permissão | O que libera no caixa |
|---|---|
| Venda | vender |
| Desconto no item | aplicar desconto em um item |
| Desconto na venda | aplicar desconto no total da venda |
| Cancelamento de item | cancelar um item do cupom |
| Cancelamento de cupom | cancelar a venda inteira |
| Abertura de caixa | abrir o caixa, com o fundo de troco |
| Sangria | retirar dinheiro do caixa |
| Suprimento | reforçar o dinheiro do caixa |
| Recebimento não fiscal | registrar recebimento fora da venda |
| Pagamento de despesa | pagar uma despesa da loja pelo caixa |
| Fechamento de caixa | fechar o caixa |
| Devolução / troca | registrar devolução |
| Reimpressão de cupom | reimprimir comprovante |
| Modo treinamento | operar em modo treinamento |
| Configuração de periféricos | configurar impressora, balança e afins no terminal |
| Histórico local | consultar o histórico local do terminal |
| Autorizar (supervisor) | liberar uma ação que o operador logado não tem, apresentando código e PIN de quem tem |
A permissão Autorizar (supervisor) é especial: ela é o que permite a uma pessoa com o direito liberar uma ação para outra. Quem tem o direito pode liberar; quem não tem, pede liberação. O sistema registra quem autorizou e quem estava na tela, separadamente — autorizar e executar são atos diferentes.
Limite de desconto: o limite_permissao#
Ter o direito de dar desconto não significa poder dar qualquer desconto. Existe um teto, e ele é um atributo do perfil.
| O que é | Como funciona |
|---|---|
| Onde fica | no cadastro do perfil, na tabela limite_permissao, associado à permissão pdv.aplicar_desconto |
| Dimensões | valor máximo (R$) e percentual máximo (%), independentes |
| Quem resolve o teto efetivo | a união dos perfis do usuário. Se ele tem mais de um perfil, o maior limite vence |
| Perfil sem limite próprio | cai no default operacional da loja, definido no parâmetro Limites de desconto e ajuste no caixa |
| Ambos os tetos em zero | fail-closed: qualquer desconto positivo escala para autorização. Zero não significa "ilimitado" — ilimitado é representado por um número alto |
| Um teto zero e o outro preenchido | só a dimensão com teto constrange; um teto só percentual governa pelo percentual |
| Vale para quais ações | apenas desconto de item e desconto de venda. As outras ações têm o próprio direito, sem teto |
Os perfis de sistema Gerente e Administrador de frente de loja nascem com teto no máximo (999.999 e 100%), reproduzindo o comportamento anterior — mas agora como atributo configurável, não como nome de cargo. O perfil Operador é semeado com um limite próprio, e o gestor pode alterá-lo.
Campos e o que significam#
| Campo | O que é | Observação |
|---|---|---|
| Escopo | em qual superfície o perfil vale: Retaguarda (gestão) ou Frente de loja (PDV) | São cadastros separados; o mesmo nome pode existir nos dois. |
| Nome | o rótulo do perfil | Não autoriza nada. Dois perfis com o mesmo nome e direitos diferentes são possível fonte de confusão: prefira nomes que digam o que o perfil faz. |
| Descrição | o texto que explica o perfil | Aparece no cartão do perfil ao vincular a um usuário. |
| Permissões | a lista de direitos do perfil | O que efetivamente autoriza. |
| Loja (no vínculo) | a loja em que aquele perfil vale para aquela pessoa | Em branco significa todas as lojas. |
| Perfil travado | marca que impede editar e excluir o perfil | O perfil Administrador de retaguarda nasce travado. |
| Limite de desconto | o teto de desconto do perfil, em valor e percentual | Só se aplica à permissão de desconto. Ver a seção anterior. |
Resultado esperado#
- A pessoa entra na retaguarda e vê exatamente os domínios e telas cujas permissões ela tem.
- O operador de caixa entra pelo código e PIN e vê as funções que o perfil dele libera.
- Um desconto acima do teto do operador não é aplicado direto: a tela pede autorização de alguém com o direito e com teto suficiente.
- No registro da operação aparece quem autorizou e quem executou, quando houve liberação por terceiro.
Se algo der errado#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| O menu não mostra uma tela que o colega vê | Falta a permissão no seu perfil, ou o seu perfil é de outro escopo | Peça a permissão. Compare os perfis em Perfis e acessos. |
| "seu perfil permite consultar, mas não pré-validar o SINTEGRA" | Você tem fiscal.sintegra_consultar e não tem fiscal.sintegra_operar | Peça o direito de operar SINTEGRA, ou use apenas a consulta. |
| "seu perfil permite consultar, mas não gerar o SINTEGRA" | Mesma causa, na ação de gerar | Peça o direito de operar SINTEGRA. |
| O operador consegue dar desconto e não deveria | O perfil dele tem a permissão de desconto — o teto limita, mas não elimina | Reduza o teto do perfil a zero nas duas dimensões, ou remova a permissão de desconto. |
| O desconto do operador não respeita o limite que configurei | O limite foi alterado depois do login dele, ou outro perfil dele tem teto maior (a união aplica o maior) | Peça ao operador para entrar de novo no caixa. Confira todos os perfis dele. |
| "Código ou PIN de quem autoriza inválido." | Quem tentou autorizar não tem o direito, ou errou a credencial | Use alguém que tenha o direito Autorizar (supervisor) e o teto necessário. |
| Não consigo editar ou excluir um perfil | O perfil é travado | Perfis travados são protegidos pelo sistema. Crie um perfil novo em vez de alterar o protegido. |
| Criei o perfil certo, mas a pessoa continua sem acesso | O perfil não foi vinculado ao usuário, ou a sessão dela é anterior à mudança | Vincule o perfil em Usuários (retaguarda) ou Usuários do PDV (caixa) e peça novo login. |
| O operador não aparece na lista de quem pode entrar no caixa | Ele não está cadastrado como usuário do PDV | Usuários do PDV é um cadastro separado de Usuários. Cadastre-o lá. |
Como funciona por dentro#
- Os direitos efetivos são a união dos perfis. Um usuário com dois perfis tem a soma dos direitos dos dois, e o teto de desconto é o maior entre eles.
- O sistema não decide autorização pelo nome do cargo. Isso foi uma correção deliberada: antes, um
switchno código devolvia limite ilimitado para perfis chamados GERENTE e ADMINISTRADOR, e um perfil personalizado equivalente não ganhava o mesmo. Hoje o limite vem do cadastro do perfil. - O terminal decide offline. O PDV recebe o conjunto de permissões e os limites na carga de segurança e decide localmente. Um perfil desconhecido no terminal não herda permissões: ele cai em um perfil vazio, e toda operação sensível passa a exigir autorização. É fail-closed de propósito.
- A permissão é conferida no servidor. Esconder o item de menu é conveniência; quem barra é a autorização do servidor.
O que é de fábrica e o que a sua loja pode ter mudado#
| Ponto | Padrão de fábrica | Como fica diferente |
|---|---|---|
| Perfis existentes | a empresa nasce com os perfis de sistema listados acima, nos dois escopos | perfis criados pelo cliente não estão nesta página: veja em Administração › Perfis e acessos |
| Teto de desconto | o perfil sem limite próprio cai em R$ 5,00 e 5% (pdv.limites_operacionais) | o valor pode ser ajustado por perfil e por loja — 0 e 0 é falha fechada |
| Verificação em duas etapas | não exigida (seguranca.exigir_2fa nasce desligado) | ligada, quem não cadastrou o 2FA só acessa a tela de cadastro do próprio 2FA |
| Perfis fiscais | são outro cadastro, separado de perfil de acesso | existem quando a empresa é contribuinte; ficam em Fiscal › Perfis fiscais |
Os valores vigentes da sua loja ficam em Administração › Parâmetros; a tabela completa está em Parâmetros e valores padrão.
Histórico da contagem de domínios#
Em 13/10/2026, o manual corrigiu uma contagem antiga de domínios. As contagens daquela captura não representam esta candidata. A referência vigente está na seção de permissões acima e no inventário gerado a partir de .