Gestão de Empresas

Resumo

Empresas (companies) são entidades de negócio que agrupam usuários dentro de um tenant. O vínculo a uma empresa é opcional para usuários - clientes individuais podem existir com company_id = NULL. Este módulo permite cadastrar, editar, vincular usuários e manter dados fiscais e comerciais da empresa.

Para quem é (papel/role)

• super-admin - vê todas as empresas de todos os tenants.
• tenant-admin - vê apenas empresas do próprio tenant.

O que você pode fazer

Cadastro

• Criar empresa: razão social, nome fantasia, documento fiscal (CNPJ), e-mail, telefone.
• Editar empresa: atualização dos dados cadastrais e metadados.
• Excluir empresa: remoção controlada respeitando histórico financeiro.
• Listar empresas: filtros por tenant, status, data de criação.

Vínculos

• Associar usuários a uma empresa via Gestão de Usuários.
• Assinaturas e faturas podem ser emitidas no CNPJ da empresa.

Como acessar

1. /admin.
2. Settings → Empresas ou /admin/settings/companies.
3. Clique em Nova para criar ou selecione uma empresa para editar.

Tutoriais

Cadastrar uma empresa B2B

1. Acesse /admin/settings/companies/create.
2. Preencha CNPJ, razão social, nome fantasia e contatos.
3. Selecione o tenant ao qual a empresa pertence.
4. Salve e, em seguida, vincule os usuários em Gestão de Usuários.

Transferir usuários entre empresas

1. Abra o usuário em /admin/settings/users/{id}/edit.
2. Altere o campo empresa para a nova.
3. Salve. Assinaturas continuam vinculadas à empresa original salvo indicação contrária.

Integrações

• Usuários - usuários podem ter company_id ou não (gestao-de-usuarios.md).
• Billing - faturas podem ser emitidas para a empresa.
• Compliance - dados fiscais da empresa entram em relatórios LGPD de terceiros (compliance-lgpd.md).
• Eventos: company.created, company.updated, company.deleted.

Perguntas frequentes

Preciso criar empresa para todo cliente? Não. Usuário sem empresa (B2C) é suportado oficialmente.

Uma empresa pode estar em mais de um tenant? Não. Isolamento multi-tenant exige que a empresa pertença a exatamente um tenant.

Posso emitir nota fiscal para empresa? A emissão depende do plugin fiscal configurado e do gateway/provedor escolhido.

Qual diferença entre empresa e tenant? Tenant é o revendedor/whitelabel da plataforma. Empresa é um cliente B2B dentro de um tenant.

Posso ter vários administradores por empresa? Sim, basta atribuir um role apropriado aos usuários vinculados.

Excluir empresa apaga os usuários? Não. Os usuários continuam existindo, apenas sem vínculo de empresa.

Limitações, políticas e avisos

• CNPJ deve ser único por tenant.
• Dados fiscais são sensíveis e entram em relatórios de compliance.
• Exclusão de empresa é irreversível - verifique assinaturas e faturas ativas antes.

Relacionados

• users-management.md
• tenants-whitelabel-management.md
• billing-gateways.md
• compliance-lgpd.md