## Visão geral

O módulo de **Empresas & Relacionamentos** transforma organizações em entidades de primeira classe
na plataforma. Cada empresa reúne identidade fiscal (CPF/CNPJ, EIN, VAT), múltiplos domínios,
endereço, responsável e estágio no ciclo de vida — e conecta tudo o que acontece ao redor dela:
contatos com **papéis** (Responsável financeiro, Aluno, Corretor…), conversas, negócios do CRM e
uma visão 360 com indicadores agregados.

A **Visão geral** soma somente os registros vinculados diretamente à empresa: contatos,
conversas, negócios, tarefas, contratos, pedidos, cobranças, assinaturas, reuniões e follow-ups.
Isso evita misturar dados sem relação. Matriz e filiais continuam navegáveis na aba
**Hierarquia**, cada uma com seus próprios números.

Ele foi desenhado para qualquer nicho: escolas (responsável ⟷ aluno), contabilidades
(contador ⟷ cliente), imobiliárias (fiador ⟷ afiançado), clínicas (responsável ⟷ paciente),
agências e operações B2B com estrutura **matriz/filial**.

## Pré-requisitos

- O módulo é opcional e chega desativado; um administrador precisa habilitá-lo para a conta.
- Permissão de administração para configurar tipos de relacionamento e as opções do módulo.
- Contatos já cadastrados para vincular às empresas (a importação de contatos ajuda aqui).

## Passo a passo

1. Com o módulo habilitado, abra **Empresas** no menu lateral.
2. Clique em **Nova empresa** e informe ao menos o **nome**. Escolha o tipo (pessoa física ou
   jurídica), o país e o **documento fiscal** — CPF e CNPJ são validados com dígitos verificadores,
   e o valor fica visível para a equipe (mascarado apenas se um papel de acesso mandar).
3. Preencha as **inscrições fiscais** (estadual e municipal) quando a empresa emitir nota — os
   campos ficam logo abaixo do documento.
4. Informe os **domínios** da empresa (o primeiro é o principal). Com a associação automática
   ativa, novos contatos com e-mail corporativo daquele domínio são vinculados sozinhos.
5. Escolha o **responsável** (o agente dono da conta), o **porte** e o **fuso horário** — os três
   são listas fechadas, então filtros e segmentos encontram exatamente o mesmo valor que você
   escolheu aqui.
6. Preencha o **endereço** completo: digite o CEP e os demais campos são preenchidos sozinhos;
   ajuste número e complemento. O endereço inteiro (logradouro, número, complemento, bairro,
   cidade, UF e CEP) aparece na **Visão geral** e é o mesmo que as cobranças PJ usam.
7. Na aba **Contatos** da empresa, vincule pessoas com **papel** e **cargo**; marque uma empresa
   como **principal** de cada contato.
8. Na aba **Relacionamentos**, conecte contatos e empresas com tipos que têm rótulo e inverso
   (ex.: "Responsável" ⟷ "Dependente"). Aplique um **preset de nicho** em Configurações para
   começar com o vocabulário certo.
9. Para grupos empresariais, defina a **matriz** no campo de hierarquia da filial — a árvore
   aparece na aba **Hierarquia**.
10. Use **Carregar demonstração** nas configurações para criar 10 empresas variadas e conectadas,
   com 20 contatos e exemplos nativos de negócios, tarefas, pedidos, pagamentos, contratos,
   reuniões, conversas e follow-ups. A remoção da demonstração apaga apenas esses dados marcados.

## Configurações & opções

- **Tipos de relacionamento**: catálogo próprio da conta, com rótulo, inverso e categoria; presets
  idempotentes para escola, contabilidade, imobiliária, clínica, agência e B2B.
- **Associação automática por domínio**: liga/desliga a associação de contatos por e-mail
  corporativo (domínios gratuitos como gmail.com são ignorados; vínculos manuais nunca são
  sobrescritos).
- **Atributos personalizados**: crie campos próprios de empresa em Configurações → Atributos
  Personalizados, na aba **Empresas**. Eles aparecem e são editáveis no cartão **Atributos
  personalizados** da Visão geral da empresa.
- **Estágios do ciclo de vida**: use o campo de estágio (lead, cliente…) para filtrar a lista e
  montar segmentos.
- **Relacionamentos**: o botão **Adicionar relacionamento** aceita outra empresa ou um contato;
  cada item abre o cadastro correspondente para continuar a análise.
- **Visão 360**: os cartões resumem cada módulo e preservam os vínculos para abrir o registro de
  origem, sem duplicar informações.
- **Importação e exportação**: a exportação traz o endereço em colunas separadas
  (`address_zip_code`, `address_street_name`, …), as inscrições e os domínios — o mesmo formato que
  a importação lê. Um arquivo exportado volta pela importação sem perder campos. A única exceção
  deliberada é o documento fiscal: ele sai sempre mascarado e a importação recusa valores
  mascarados, para o CPF/CNPJ nunca trafegar em claro numa planilha.

## Casos de uso

- **Escola**: a organização é o colégio; pais entram como "Responsável financeiro" dos alunos e a
  recepção enxerga a família inteira antes de responder.
- **Contabilidade**: cada cliente PJ é uma empresa com CNPJ validado; o contador acompanha
  conversas e cobranças da carteira por empresa.
- **Grupo empresarial**: matriz e filiais em hierarquia, com a visão 360 consolidando conversas e
  negócios de cada unidade.

## Dicas, limites e boas práticas

- O documento fiscal fica preenchido no formulário depois de salvo, pronto para corrigir. Ele só
  aparece mascarado se a regra de campo `tax_id` do papel de acesso mandar.
- A hierarquia rejeita ciclos (uma filial não pode ser matriz da própria matriz).
- Cada contato tem **uma** empresa principal; os demais vínculos continuam valendo para busca e
  relacionamentos.
- Automações, macros e fluxos funcionam com empresas: além de **Definir a empresa do contato** e
  **Definir estágio da empresa**, existem **Definir campo da empresa** (documento, endereço,
  e-mail, telefone, fuso, inscrições…) e **Definir atributo personalizado da empresa**. Assim, um
  fluxo que coletou o CNPJ ou o CEP grava direto na ficha.
- As condições e os segmentos agora alcançam e-mail, telefone, site, fuso, esquema do documento e
  os campos de endereço (cidade, UF, bairro, logradouro, CEP) — dá para perguntar "empresas de SP
  sem e-mail cadastrado".
- Nas mensagens, campanhas, follow-ups e fluxos, use as variáveis de empresa:
  `{{organization.address}}` (endereço completo), `{{organization.address_city}}`,
  `{{organization.state_registration}}` e as demais. Nos **contratos** essas variáveis ainda não
  existem: o modelo de contrato resolve `contact.*`, `crm_item.*`, `conversation.*`, `account.*` e
  `company.*` (a sua empresa emissora) — use uma variável manual para dados da empresa contratante.

## Solução de problemas

- **Não vejo o menu Empresas**: o módulo está desativado para a conta — peça a um administrador.
- **Documento recusado**: o valor não passou na validação (dígitos verificadores de CPF/CNPJ ou
  formato de EIN/VAT). Confira o número e o país selecionado.
- **Contato não foi associado sozinho**: verifique se a associação automática está ativa, se o
  domínio do e-mail é corporativo e se o contato já não tinha vínculo manual.
- **Não consigo excluir um tipo de relacionamento**: ele está em uso por relacionamentos
  existentes; remova-os primeiro.
- **CEP, logradouro, número ou UF apareciam vazios ao editar**: era uma falha corrigida — o
  formulário não lia essas quatro chaves e, ao salvar, gravava os campos em branco por cima do que
  estava guardado. Hoje o formulário carrega o endereço inteiro e uma gravação parcial nunca apaga
  um campo que não foi enviado. Se algum endereço foi perdido antes da correção, basta preencher
  de novo.
- **Vejo CPF/CNPJ, CEP, Logradouro, Cidade… entre os atributos do contato**: são os sete campos
  antigos de pagamento, hoje substituídos pelos campos fiscais e de endereço nativos do contato.
  Um administrador pode aposentá-los com
  `rake "organizations:cleanup_legacy_payment_attributes[<id_da_conta>,apply]"` — a tarefa migra
  os valores para os campos nativos e remove só as definições; nenhum dado é apagado.

## Veja também

- [Contatos: importação e segmentos](/hc/ajuda/articles/contacts-crm-contatos-import-segmentos-pt-br)
- [Atributos personalizados](/hc/ajuda/articles/contacts-crm-atributos-personalizados-pt-br)
- [CRM: pipelines e negócios](/hc/ajuda/articles/contacts-crm-crm-pipelines-kanban-negocios-pt-br)