Grupos de Empresas

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 Empresas

O que é

Um Grupo de Empresas reúne várias empresas sob um mesmo nome, para que o acesso possa ser concedido ao grupo inteiro de uma vez em vez de empresa por empresa.

O uso típico é o escritório de contabilidade que atende dezenas de clientes e precisa que cada colaborador enxergue apenas a carteira dele. Em vez de vincular o colaborador a cada empresa, você cria um grupo com a carteira e vincula o usuário ao grupo. Quando uma empresa entra ou sai da carteira, você altera o grupo — e o acesso de todos os usuários daquele grupo acompanha.

Antes de começar

As empresas que farão parte do grupo já precisam estar cadastradas em Administração › Empresas. A tela de grupo apenas seleciona empresas existentes; ela não cadastra empresa nova.

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.
Empresas	🏢 Quantas empresas o grupo tem.
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.

📊 As duas colunas de contagem contam a história: um grupo com Empresas em zero não libera nada; um grupo com Usuários em zero não está sendo usado por ninguém — e talvez possa ser desativado.

Como criar um grupo

Abra Segurança › Grupos de Empresas.
Clique em Cadastrar. Abre a janela Novo grupo de empresas, com duas abas: Geral e Empresas.
Na aba Geral, preencha os campos (detalhe na tabela abaixo).
Vá até a aba Empresas e clique em Selecionar. Abre a janela Selecione as empresas: busque por CPF/CNPJ, Razão Social ou município, marque as empresas desejadas e clique em Selecionar para confirmar.
De volta ao formulário, confira o contador no rodapé da aba Empresas — ele deve mostrar quantas empresas você trouxe.
Clique em Salvar.

Atenção — o erro mais comum: um grupo não pode ser salvo sem nenhuma empresa. Se você preencher só a aba Geral e clicar em Salvar, o sistema recusa. A mensagem que reclama da falta de empresas aparece no canto superior direito da tela, enquanto seus olhos estão na aba Geral — por isso muita gente não vê o aviso e acha que o botão Salvar travou. Antes de salvar, confira se a aba Empresas mostra pelo menos 1 item.

O que acontece depois de salvar

Aparece a mensagem "Atualizado com sucesso" no canto superior direito e a janela continua aberta — só que agora com o título "Editando <nome do grupo> (ID nn)", já com o número do grupo criado.

Como a janela não fecha sozinha, é comum achar que não salvou e clicar em Salvar de novo. Não é preciso. Se o título mudou para "Editando..." e apareceu o ID, o grupo já foi criado. Feche a janela e confira na lista.

O campo Perfil fica esmaecido depois de salvo — ele não pode ser alterado depois que o grupo existe.

Campos da aba Geral

Campo	Obrigatório	O que informar
Perfil	Sim (já vem preenchido)	O perfil dono do grupo. Vem preenchido com o seu. Não é editável depois de salvar.
Nome	Sim	Nome curto do grupo, como ele aparecerá nas listas. Ex.: `Carteira Zona Sul`.
Descrição	Não	Texto livre para explicar o critério do grupo. Ex.: `Clientes atendidos pela equipe da filial`.
Situação	Sim	Estado do grupo. Veja a tabela de situações abaixo.
Limite de empresas	Sim	Número inteiro. Teto de empresas que o grupo aceita. Aceita apenas números — não use ponto, vírgula ou texto.

Valores de Situação

Situação	O que significa
1: Ativo	Grupo em uso normal. É o único que aparece na lista por padrão.
2: Inativo	Grupo desativado, guardado para consulta.
3: Bloqueado	Grupo impedido de ser usado.
4: Suspenso	Uso interrompido temporariamente.
5: Excluído	Grupo removido do uso. O registro continua na base — a exclusão é lógica, não apagamento.
6: Limitado	Grupo em uso com restrição.

Se um grupo "sumiu", provavelmente é isto. O painel Outros filtros, à direita, já vem com Situação = 1:Ativo preenchido. Qualquer grupo que não esteja Ativo simplesmente não aparece na lista — e a tela não avisa que há um filtro aplicado. Para ver todos, limpe o campo Situação nesse painel, clicando no X ao lado dele.

Na prática, o que muda o dia a dia é Ativo × qualquer outra coisa: só os Ativos aparecem e valem. A diferença fina entre Inativo, Bloqueado, Suspenso e Limitado não altera o que você precisa fazer — se quer o grupo funcionando, deixe-o Ativo.

Aba Empresas

Elemento	Para que serve
Selecionar	Abre a janela de busca e traz empresas para o grupo.
Remover	Tira do grupo a empresa marcada. Fica esmaecido enquanto nada está marcado.
Campo de busca	Localiza por CPF/CNPJ, Razão Social ou município.
Contador de itens	No rodapé da aba, mostra quantas empresas o grupo tem. Se marcar 0 item(ns), o Salvar vai recusar.

Na janela Selecione as empresas também há filtros por Perfil, Situação, Status e Etiqueta, úteis quando a lista de empresas é grande.

Mensagens de erro e o que fazer

Estas são as mensagens exatas do sistema:

Mensagem	O que fazer
`nome: O campo nome é obrigatório.`	Preencha Nome, na aba Geral.
`situacao_id: O campo situacao id selecionado é inválido.`	Escolha uma opção em Situação. Deixar em branco não é aceito.
`max_empresas: O campo max empresas deve ser um número inteiro.`	Refere-se a Limite de empresas. Informe só números.
`empresas: O campo empresas é obrigatório.`	Vá à aba Empresas e adicione ao menos uma.

As mensagens usam o nome interno do campo, e não o rótulo que aparece na tela. A tabela acima faz a tradução: max_empresas é o Limite de empresas e situacao_id é a Situação.

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

Uma empresa pode estar em mais de um grupo? Sim. Uma empresa já vinculada a um grupo continua aparecendo na busca e pode ser adicionada a outros. (Confirmado em teste: a mesma empresa foi vinculada a dois grupos distintos, e os dois passaram a contá-la.)

Salvei e a janela não fechou. Salvei ou não? Salvou. Veja se o título mudou para "Editando <nome> (ID nn)" — o ID só existe depois de gravado. Feche a janela e confirme na lista.

O que acontece com os usuários quando removo uma empresa do grupo? A confirmar — não testado.

Qual a diferença entre Grupo de Empresas e Grupo de Permissões? O Grupo de Empresas define quais empresas o usuário enxerga. O Grupo de Permissões define o que ele pode fazer. Os dois se combinam no cadastro do usuário, em Administração › Usuários, nos campos Grupo de empresas e Grupo de permissões.