Multi-empresa
Vários CNPJs, um só ERP.
Tenants, módulos habilitados e grupos de empresas — 4 áreas de governança multi-tenant alinhadas à API.
Tenants
tenant
Uma conta, várias empresas isoladas.
Cadastro de tenants com logo em S3, slug e associação de pessoas. Cada empresa opera com dados isolados — ideal para grupos, franquias e holdings com múltiplos CNPJs.
- CRUD de tenants com logo e slug
- Associação de pessoas por empresa
- Isolamento total de dados entre tenants
- Contexto multi-tenant (`TenantContext`)
- Configuração independente por empresa
Módulos habilitados
tenant
Ative apenas o que cada empresa precisa.
Catálogo de módulos do sistema com habilitação por tenant. `ModuleConfig` permite overrides por chave — cada filial pode ter parâmetros próprios sem afetar as demais.
- Catálogo global de módulos do sistema
- Módulos habilitados por tenant
- ModuleConfig com overrides por chave
- Permissões filtradas pelos módulos ativos
- Escalável para franquias e grupos
Grupos de empresas
tenantGroup
Compartilhe cadastros entre filiais do grupo.
Grupos de tenants para holdings e franquias: compartilhe entidades e localizações entre empresas do mesmo grupo, mantendo financeiro e fiscal isolados por CNPJ.
- CRUD de grupos e gestão de membros
- Owner do grupo com add/remove de tenants
- Compartilhamento de entidades (clientes/fornecedores)
- Localizações compartilhadas entre filiais
- Financeiro e fiscal isolados por tenant
- 1
Criar grupo
Holding ou franqueadora define o grupo.
- 2
Adicionar filiais
Tenants membros com papéis owner/member.
- 3
Compartilhar
Entidades e locais visíveis no grupo.
- 4
Operar
Cada CNPJ mantém financeiro e fiscal próprios.
Configuração por empresa
tenant
Parâmetros e overrides sem código.
Cada tenant configura módulos, séries fiscais, plano de contas e integrações de forma independente. Mudanças em uma filial não propagam para as demais do grupo.
- Overrides de configuração por chave
- Certificado digital e regime por tenant
- Integrações configuráveis por empresa
- Plano de contas e categorias isolados
- Logo e identidade visual por tenant
Dúvidas frequentes
Perguntas sobre multi-empresa
Quantas empresas posso ter na mesma conta?
Não há limite fixo na arquitetura multi-tenant. Cada tenant (CNPJ) opera isolado com módulos e configurações próprias. Grupos permitem compartilhar cadastros entre filiais selecionadas.
O financeiro de uma filial mistura com outra?
Não. O isolamento por tenant é total — lançamentos, títulos, NF-e e contabilidade são independentes por CNPJ. Grupos compartilham apenas entidades e localizações configuradas.
Como funcionam os grupos de tenants?
Um grupo reúne tenants de uma holding ou franqueadora. O owner adiciona/remove membros e define o que é compartilhado (clientes, fornecedores, locais). Cada membro mantém operação fiscal e financeira própria.
Posso habilitar módulos diferentes por empresa?
Sim. O catálogo de módulos é habilitado por tenant. Uma filial pode ter apenas financeiro e fiscal; outra pode incluir RH, projetos e BPO — conforme o contrato de cada CNPJ.
Escritórios contábeis usam multi-empresa?
Sim. Cada cliente do escritório pode ser um tenant com acesso via Portal do Contador. Veja em /para-contadores e /solucoes/bpo.