Grupos de Permissões
Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026 Não disponível em: GaxWeb 4.6 Onde fica: menu Segurança › Grupos de Permissões
O que é
Um Grupo de Permissões define o que um usuário pode fazer dentro do GaxWeb: se pode apenas consultar documentos, se pode exportar XML, se pode manifestar uma NF-e, se pode cadastrar empresas.
Ele é o par do Grupo de Empresas: um diz quais empresas o usuário enxerga, o outro diz o que ele pode fazer nelas. Os dois se combinam no cadastro do usuário, em Administração › Usuários.
A lógica é montar o grupo uma vez e reaproveitar. Em vez de configurar permissão a permissão para cada colaborador novo, você cria grupos como "Consulta apenas" ou "Operação fiscal" e vincula a pessoa ao grupo certo.
A lista de grupos
| Coluna | O que mostra |
|---|---|
| Situação | Se o grupo está ativo. |
| ID | Número interno. |
| Nome / Descrição | Identificação do grupo. |
| Visibilidade | 👁️ Pública (todo o perfil pode usar) ou Local. |
| Usuários | 👥 Quantos usuários usam este grupo. |
| Criação | Quando foi criado. |
| Perfil | A qual perfil pertence. |
Filtro no cabeçalho para ID, Nome e Descrição. No painel da direita há ainda o filtro Visibilidade (Pública · Local).
👥 A coluna Usuários mostra o alcance da mudança. Antes de alterar um grupo, veja quantas pessoas dependem dele: a alteração vale para todas de uma vez.
Como criar um grupo de permissões
- Abra Segurança › Grupos de Permissões.
- Clique em Cadastrar. Abre a janela Novo grupo de permissões, com as abas Geral e Permissões.
- Na aba Geral, preencha Nome, Descrição, Visibilidade e Situação.
- Vá à aba Permissões e defina cada item (explicado abaixo).
- Clique em Salvar.
Assim como nos Grupos de Empresas, a janela não fecha ao salvar — ela passa a mostrar "Editando <nome> (ID nn)". Isso significa que salvou. Não clique em Salvar de novo.
Campos da aba Geral
| Campo | Obrigatório | O que informar |
|---|---|---|
| Perfil | Sim (já vem preenchido) | O perfil dono do grupo. |
| Nome | Sim | Nome do conjunto de permissões. Ex.: Consulta apenas. |
| Descrição | Não | Para que serve o grupo. Ex.: Vê documentos, não exporta e não manifesta. |
| Visibilidade | Sim | Local ou Pública (veja abaixo). |
| Situação | Sim | Mesma lista de situações dos demais cadastros. Só os Ativos aparecem na lista por padrão. |
Visibilidade: Local ou Pública
São as duas únicas opções. Na dúvida, use Local — é o mais restrito e o que atende ao caso normal, em que o grupo serve apenas ao seu próprio perfil.
A aba Permissões: os três estados
Cada permissão tem três botões, e é isso que confunde à primeira vista:
| Estado | O que faz |
|---|---|
| Sim | Libera explicitamente. |
| Sistema | Não decide nada aqui — vale o padrão do sistema. É como o item já vem. |
| Não | Bloqueia explicitamente. |
Deixar em Sistema não é o mesmo que deixar em Não. "Sistema" significa "não tenho opinião, siga o padrão"; "Não" significa "proíba". Quando você quer garantir que alguém não faça algo, marque Não — não basta deixar como veio.
As permissões são organizadas em árvore: o item de cima é o módulo, e abaixo dele ficam as ações. Há um campo Filtrar permissões... no topo, útil porque a árvore é longa.
O que um usuário comum já pode, sem nenhum grupo
O estado Sistema usa um padrão que o GaxWeb já traz. Vale conhecer, porque explica o que a pessoa consegue fazer antes de você criar qualquer grupo:
| Área | Padrão do sistema |
|---|---|
| Administração (usuários, empresas, certificados, etiquetas) | 🔴 Bloqueado |
| Aplicativos (GaxUP, GaxDown, Relatórios) | 🔴 Bloqueado |
| Documentos fiscais | 🟢 Liberado, com ressalvas abaixo |
Dentro de Documentos, o padrão é mais fino do que parece:
| Permissão | Padrão | Na prática |
|---|---|---|
| Visualizar o documento | 🟢 Sim | Vê a nota e os Detalhes. |
| Ver o XML na tela | 🔴 Não | Não abre a aba XML. |
| Exportar PDF (botão direito) | 🟢 Sim | Baixa a DANFE avulsa. |
| Exportar XML (botão direito) | 🟢 Sim | Baixa o XML avulso. |
| Exportação em lote (zip) | 🔴 Não | Não exporta vários de uma vez. |
| Excel | 🔴 Não | Não exporta a lista. |
| Etiquetas | 🔴 Não | Não aplica marcadores. |
| Manifestação | 🔴 Não | Não manifesta. |
| Consultar webservice | 🔴 Não | Não força consulta à Sefaz. |
🤔 Um detalhe que confunde: o usuário comum baixa o XML pelo botão direito, mas não consegue vê-lo na tela. São duas permissões diferentes — XML (visualizar) e Exportar XML (baixar). Se alguém diz "consigo baixar mas não consigo abrir", é isso, e não um defeito.
💡 Por isso o Grupo de Permissões existe: para liberar o que o padrão bloqueia — exportação em lote, Excel, etiquetas e manifestação são as liberações mais pedidas.
O que dá para controlar
Administração
| Módulo | Ações disponíveis |
|---|---|
| Usuários | Edição (cadastrar ou editar), Excel |
| Empresas | Edição, Etiquetas, Excel |
| Certificados | Edição, Etiquetas, Excel |
| Etiquetas | Edição, Excel |
Documentos fiscais
Todos os tipos de documento têm o mesmo conjunto básico:
| Ação | O que libera |
|---|---|
| Visualizar | Ver o documento |
| Detalhes | Ver os detalhes do documento |
| XML | Ver o XML do documento |
| Exportação | Exportar os documentos selecionados em zip |
| Etiquetas | Modificar etiquetas do registro |
| Excel | Exportar o resultado para Excel |
| Ações → Exportar PDF | Exportar o documento em PDF |
| Ações → Exportar XML | Exportar o documento em XML |
Tipos cobertos: NF-e (55), NFC-e (65), NFS-e (nacional), CT-e (57), CT-e OS (67) e Exportação.
A NF-e tem duas permissões que nenhum outro documento tem — e são as mais sensíveis do sistema:
- Manifestação — Manifestação do destinatário, subdividida em Ciência da operação, Confirmação da operação, Desconhecimento da operação e Cancelamento da realizada.
- Consultar webservice — Forçar consulta na Sefaz.
Manifestação é declaração enviada à Sefaz em nome da empresa. Vale conceder essas quatro só a quem de fato responde por isso, e deixar as demais pessoas em Não — e não apenas em "Sistema".
Aplicativos
| Módulo | Ações |
|---|---|
| GaxUP (Gaxweb Uploader) | Edição (cadastrar ou editar terminais), Excel |
| GaxDown (Gaxweb Downloader) | Edição, Excel |
| Relatórios customizados | Excel |
O que não é controlado aqui
A árvore de permissões não cobre os menus Segurança nem Monitores. O acesso a essas áreas não se configura por Grupo de Permissões.
A tela por partes
As telas de Administração seguem o mesmo desenho das listas de documentos, com um ícone a mais.
Os ícones do canto superior direito
| Ícone | O que faz |
|---|---|
| 📗 Exportar resultado para Excel | Baixa em Excel o que está na tela, com os filtros aplicados. |
| 🔄 Recarregar toda a tabela | Busca os dados de novo no servidor. |
| ☷ Exibir/Ocultar colunas | Escolhe quais colunas aparecem. Resolve "essa coluna sumiu". |
| 🧹 Vacuum (compactar tabela) | Compacta a tabela no banco. Só existe nas telas de Administração. |
| ☰ Mais filtros | Abre e fecha o painel Outros filtros, à direita. |
🧹 Tela bagunçada? Há também Reiniciar storage local. O GaxWeb guarda no seu navegador a largura e a ordem das colunas; se a tela ficou torta ou uma coluna sumiu e não volta, esse botão devolve o padrão. Mexe só no seu navegador, não altera dado nenhum.
Reload, Registros e páginas
No topo: Reload (Desativado · 15s · 30s · 60s) atualiza a lista sozinha, e Registros (10 · 50 · 100 · 500 · 1000) define quantas linhas por página. As páginas ficam no rodapé.
⚠️ A seleção por caixinha vale só na página aberta. Marcou itens e virou a página? A marcação anterior se perde. Aumente Registros antes de marcar.
A lista rola para o lado
As colunas passam da largura da tela. Role para a direita antes de concluir que uma informação não existe — ou esconda as colunas que não usa.
Como filtrar
1. Filtro por coluna — a caixinha abaixo do título. Nem toda coluna tem. 2. Painel "Outros filtros" — à direita, pelo ícone ☰. 3. Ordenação — clique no título da coluna.
Os três se somam.
🔍 "Sumiu da lista". O painel já vem com Situação = 1:Ativo: registros inativos ficam ocultos por padrão. Clique no X ao lado do campo Situação para ver todos. É a causa nº 1 de "meu cadastro desapareceu".
O painel tem duas seções
Repare que Situação aparece duas vezes: uma na seção do Perfil e outra na do registro que você está vendo. São filtros diferentes — o primeiro restringe pelo perfil, o segundo pelo próprio cadastro.
Abrir, editar e o histórico
Botão direito sobre a linha:
| Ação | O que faz |
|---|---|
| Editar | Abre o cadastro. |
| Alterações | 🕓 Mostra quem mudou o quê, e quando. Existe em toda a Administração e só aparece aqui. |
| Recarregar item | Atualiza só aquela linha. |
⏱️ "Quem alterou isso?" — use Alterações. É o histórico do registro, e resolve discussão sem precisar abrir chamado.
🖱️ Duplo clique não faz nada. Para abrir, use o botão direito → Editar.
Ao salvar, a janela não fecha
Ela passa a se chamar "Editando <nome> (ID nn)" e continua aberta. Se apareceu o ID no título, gravou. Pode fechar.
Perguntas frequentes
Qual a diferença entre "Não" e "Sistema"? "Sistema" segue o padrão e pode mudar conforme a configuração do ambiente; "Não" proíbe de forma explícita. Para bloquear com segurança, use Não.
Preciso liberar item por item? Não. Marque no nível do módulo (por exemplo, "NFe") para valer no conjunto, e use os itens de baixo só quando quiser abrir uma exceção.
Criei o grupo mas o usuário continua sem acesso. Verifique se o grupo está vinculado ao usuário em Administração › Usuários, no campo Grupo de permissões — criar o grupo não o aplica a ninguém automaticamente. Confira também se o grupo está com Situação Ativo.
Meu grupo sumiu da lista. O painel Outros filtros já vem com Situação = 1:Ativo. Se você mudou a situação do grupo, ele deixa de aparecer. Limpe o filtro no X ao lado do campo.