Acesso a várias empresas

Módulo Geral

Uma mesma pessoa pode operar mais de uma empresa e alternar entre elas pelo seletor no alto da tela. Em cada empresa ela vê o sistema como um gerente daquela empresa vê — com a nomenclatura, os menus e os recursos daquele ramo, e nada além.

📍 Como usar

Seletor de empresa no cabeçalho, ao lado do seu nome.

O seletor aparece só para quem tem acesso a mais de uma empresa. Com uma empresa só, não há o que escolher e ele fica oculto.

Sempre há uma empresa selecionada — não existe a opção "Todas as empresas", nem para o administrador. Ao entrar, o sistema abre na última empresa que você usou, em qualquer aparelho (a escolha fica guardada no servidor). Se ela não existir mais ou você perdeu o acesso, abre na primeira empresa a que você tem acesso. Quem ainda não tem empresa nenhuma vai para o cadastro da empresa, como antes.

Trocar de empresa muda a tela inteira

A troca não é só um filtro de dados. Ela troca:

Os menus: uma borracharia mostra Veículos e Boxes; um restaurante mostra Comandas e Cozinha (KDS), e nenhum dos dois mostra o do outro.
Os nomes: a mesma tela se chama Ordens de serviço na oficina, Comandas no restaurante e Vendas na loja.
Os recursos: se a empresa não contratou um módulo, ele não aparece — nem no menu, nem digitando o endereço.
As permissões: cada empresa tem os próprios papéis, e a permissão que vale é a do papel daquela empresa.

Só uma empresa fica ativa por vez. Tudo o que você lança — atendimento, pagamento, despesa, nota — entra na empresa que está selecionada no cabeçalho. Confira o seletor antes de lançar.

Vale inclusive para o administrador. Nenhuma tela pede a empresa separadamente: a empresa do cabeçalho é sempre a da operação. Para trabalhar em outra, troque no cabeçalho primeiro — o sistema recusa a operação em vez de gravar na empresa errada.

Admin x gerente de várias empresas

São dois acessos amplos, e não o mesmo acesso em dois tamanhos. Confundir os dois é o erro mais comum aqui — quem quer "ver tudo como gerente" quer a segunda coluna:

Aspecto	Admin da plataforma	Gerente de várias empresas
Para quem é	Equipe do SyncCore, que dá suporte a qualquer cliente	Pessoa da operação que cuida de mais de uma empresa do mesmo grupo
Como o acesso é registrado	usuarios.papel = admin (não precisa de vínculo)	usuarios.papel = gerente + uma linha em usuario_empresas por empresa
Menus que aparecem	TODOS, em qualquer empresa — ignora os recursos contratados	Só os recursos daquela empresa, e só os do ramo dela
Selecionar "Todas as empresas"	Não (desde 03/10/2026) — escolhe na lista de todas, mas sempre uma	Não — sempre uma empresa por vez
Empresa em que entra	A última usada; se ela sumiu ou foi desativada, a primeira empresa ativa por nome	A última usada; se perdeu o acesso, a primeira da lista (dono primeiro, depois nome)
Lê dado de empresa que não é dele	Sim, por desenho (é quem dá suporte)	Não. Fora de usuario_empresas, a resposta é 403
Papéis e permissões que valem	Nenhum: passa por cima de todos	O papel "Gerente" daquela empresa, com as permissões dela

Por que as duas existem

Porque servem a perguntas diferentes. O admin existe para dar suporte: ele precisa abrir qualquer tela de qualquer cliente, inclusive uma que o cliente não contratou, para entender o que está acontecendo. Se ele passasse pela trava de recursos, não conseguiria diagnosticar nada.

O gerente de várias empresas existe para operar. Ele não quer ver a tela de cozinha na barbearia nem a de veículos na padaria — quer abrir cada empresa e encontrar o que aquela empresa usa. É o acesso certo para o sócio, o cônjuge e o gerente de grupo.

Não use Admin para dar acesso a todas as empresas a alguém da operação. O papel Admin passa por cima da lista de recursos de cada empresa: a pessoa veria em toda empresa todas as telas do sistema, inclusive as que aquela empresa não contratou e as que não fazem sentido no ramo dela.

Como dar acesso a mais empresas

Pela tela: Configurações → Usuários, abra a pessoa e adicione as empresas. Cada vínculo recebe um papel daquela empresa — normalmente "Gerente".

Para muitas empresas de uma vez, há um comando que faz o mesmo trabalho:

node scripts/criar-usuario-multiempresa.js \
  --nome "Nome da pessoa" \
  --email pessoa@exemplo.com \
  --empresas todas

Cria a pessoa como gerente e a vincula a todas as empresas ativas, cada uma com o papel "Gerente" daquela empresa.
Sem --senha, gera uma senha provisória e a mostra uma vez no resumo. A troca de senha no primeiro acesso já vem obrigatória.
Rodar de novo não duplica nada: atualiza os acessos. A lista informada em --empresas passa a ser a lista completa — acesso fora dela é desativado.
Ele imprime o banco de destino antes de escrever, e recusa banco remoto sem --confirmar.

Se alguma empresa aparecer no resumo marcada como "sem papel de sistema Gerente", o acesso àquela empresa fica com permissões genéricas em vez das permissões dela. Isso acontece em empresas antigas que nasceram antes dos papéis padrão; peça ao suporte para aplicar os papéis de sistema e rode o comando de novo.

Isolamento entre empresas

Ter acesso a várias empresas não mistura os dados delas. Cada consulta é filtrada pela empresa selecionada, e o acesso a uma empresa fora da lista de vínculos é recusado — não adianta trocar o número no endereço.

Cliente, produto, atendimento e nota de uma empresa não aparecem na outra.
Relatório e fluxo de caixa mostram só a empresa ativa. Não existe consolidado de várias empresas para quem não é admin.
O caixa é por empresa e por pessoa: abrir o turno numa empresa não abre na outra.

Dica: a mesma pessoa pode ter papéis diferentes em empresas diferentes — Gerente numa, Caixa em outra. O papel é do vínculo, não da pessoa.