# 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 1. Abra **Segurança › Grupos de Empresas**. 2. Clique em **Cadastrar**. Abre a janela *Novo grupo de empresas*, com duas abas: **Geral** e **Empresas**. 3. Na aba **Geral**, preencha os campos (detalhe na tabela abaixo). 4. 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. 5. De volta ao formulário, confira o contador no rodapé da aba Empresas — ele deve mostrar quantas empresas você trouxe. 6. 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*.