# Organization

Uma entidade jurídica com identidade, estrutura e relações comerciais próprias.

Tabela de origem: Organizations em Core Record Types (`schema:Organization`). Uma Organization é uma entidade jurídica com razão social, forma jurídica, setor e identificadores próprios. Ser cliente, fornecedor ou parceiro é uma relação, nunca uma coluna aqui.

## Regras e relacionamentos

Legal Name* é calculado de Alternate Name* e Suffix, o sufixo do termo vinculado em Entity Type. Entity Type, Industry e Scoped Terms vinculam [Classification Term](/pt-br/systems/core/classification-term); Primary Address e Registered Agent Address vinculam [Address](/pt-br/systems/core/address). Branches vincula [Branch](/pt-br/systems/core/branch): um local desta entidade, não uma segunda organização. Departments, Teams e Positions são as unidades e cargos que a empresa mantém. Business Relationships (Subject) e (Counterparty) vinculam linhas de [Business Relationship](/pt-br/systems/core/business-relationship) nas duas direções. Operated By Group marca empresas que o próprio grupo opera; não concede acesso. Campaigns (Accountable) é o inverso da organização responsável em Campaign.

## Ciclo de vida e verificações

Status usa Draft, Proposed, Active, On Hold, Archived e Superseded. Proposed é o guarda-corpo para organizações nascidas no CRM, que pode criar organizações no Core pelo seu mirror bidirecional: a chave de duplicidade é o site ou domínio em Website°. Record health é a fração de oito campos preenchidos; Health check lista os que faltam.

## Campos da origem

Nomes, tipos, opções e vínculos são os configurados em Core Record Types. O significado é a primeira linha da descrição de cada campo no Airtable. As opções descrevem configuração; não provam que uma regra seja aplicada em outro lugar.

### Valores registrados

| Campo | Tipo | Significado | Opções, vínculo ou cálculo |
| --- | --- | --- | --- |
| Alternate Name* | Texto | Guarda o nome comercial público usado pela empresa. | Valor informado. |
| Logo | Anexos | Guarda o logotipo usado para esta empresa em interfaces e documentos. | Valor informado. |
| External Identifier | Texto longo | Guarda identificadores dados à empresa por outros órgãos, um por linha. | Valor informado. |
| Status | Seleção única | Guarda a fase de vida desta empresa. | Draft, Proposed, Active, On Hold, Archived, Superseded |
| Operated By Group | Caixa de seleção | Indica que o grupo opera esta empresa, com workspace de ferramentas, departamentos e equipes próprios. | Valor informado. |
| Website° | URL | Sem descrição no Airtable. | Valor informado. |
| Notes | Texto formatado | Sem descrição no Airtable. | Valor informado. |

### Vínculos

| Campo | Tipo | Significado | Opções, vínculo ou cálculo |
| --- | --- | --- | --- |
| Business Relationships (Subject) | Vínculos | Vincula as relações em que esta empresa é o sujeito. | → [Business Relationship](/pt-br/systems/core/business-relationship) · um registro |
| Business Relationships (Counterparty) | Vínculos | Vincula as relações em que esta empresa é o outro lado. | → [Business Relationship](/pt-br/systems/core/business-relationship) · um registro |
| Primary Address | Vínculos | Vincula o endereço onde esta empresa opera principalmente. | → [Address](/pt-br/systems/core/address) · vários registros |
| Scoped Terms | Vínculos | Vincula cada termo de classificação mantido para esta empresa. | → [Classification Term](/pt-br/systems/core/classification-term) · vários registros |
| Entity Type | Vínculos | Vincula a forma jurídica sob a qual esta empresa foi constituída, do catálogo compartilhado. | → [Classification Term](/pt-br/systems/core/classification-term) · vários registros |
| Industry | Vínculos | Vincula o setor e o nicho em que esta empresa atua, do catálogo compartilhado. | → [Classification Term](/pt-br/systems/core/classification-term) · vários registros |
| Branches | Vínculos | Vincula cada filial, escritório ou local desta empresa. | → [Branch](/pt-br/systems/core/branch) · vários registros |
| Memberships | Vínculos | Vincula cada membership existente nesta empresa. | → [Membership](/pt-br/systems/core/membership) · vários registros |
| Departments | Vínculos | Vincula cada departamento que esta empresa mantém. | → [Department](/pt-br/systems/core/department) · vários registros |
| Teams | Vínculos | Vincula cada equipe que esta empresa mantém. | → [Team](/pt-br/systems/core/team) · vários registros |
| Positions | Vínculos | Vincula cada cargo ligado diretamente a esta empresa. | → [Position](/pt-br/systems/core/position) · vários registros |
| Registered Agent Address | Vínculos | Vincula o endereço onde o agente registrado desta empresa recebe notificações legais. | → [Address](/pt-br/systems/core/address) · vários registros |
| Tag | Vínculos | Sem descrição no Airtable. | → [Tag](/pt-br/systems/core/tag) · vários registros |
| Campaigns (Accountable) | Vínculos | Vincula as campanhas associadas a este responsável. | → [Campaign](/pt-br/systems/core/campaign) · vários registros |

### Calculados

| Campo | Tipo | Significado | Opções, vínculo ou cálculo |
| --- | --- | --- | --- |
| Legal Name* | Fórmula | Mostra a razão social registrada da empresa, montada do nome alternativo e do sufixo societário. | Fórmula abaixo. |
| Suffix | Lookup | Mostra o sufixo legal do tipo societário desta empresa, lido do catálogo compartilhado. | Lookup de Alternate Name por Entity Type |
| Record health | Fórmula | Mostra a completude dos dados principais desta empresa, como a fração de oito campos-chave preenchidos. | Fórmula abaixo. |
| Health check | Fórmula | Diz em palavras o que falta nos dados principais desta empresa, ou mostra ✅ quando nada falta. | Fórmula abaixo. |

### Gerados pelo Airtable

| Campo | Tipo | Significado | Opções, vínculo ou cálculo |
| --- | --- | --- | --- |
| Created by | Criado por | Valor de sistema do Airtable. | Valor de sistema do Airtable. |
| Created at | Data de criação | Valor de sistema do Airtable. | Valor de sistema do Airtable. |
| Last modified by | Última alteração por | Valor de sistema do Airtable. | Valor de sistema do Airtable. |
| Last Modified | Data da última alteração | Valor de sistema do Airtable. | Valor de sistema do Airtable. |

## Fórmulas atuais

Os IDs de campo aparecem como os nomes atuais dos campos.

### Legal Name*

```text
IF(
  {Suffix},
  IF(
    LEFT(TRIM(ARRAYJOIN({Suffix}, "")), 1) = ",",
    {Alternate Name*} & ARRAYJOIN({Suffix}, ""),
    {Alternate Name*} & " " & ARRAYJOIN({Suffix}, "")
  ),
  {Alternate Name*}
)
```

### Record health

```text
SUM(
IF({Alternate Name*},1,0),
IF(COUNTA({Entity Type})>0,1,0),
IF(COUNTA({Industry})>0,1,0),
IF({Website°},1,0),
IF({External Identifier},1,0),
IF(COUNTA({Logo})>0,1,0),
IF(COUNTA({Primary Address})>0,1,0),
IF({Status},1,0)
)/8
```

### Health check

```text
IF(
  AND(
    {Alternate Name*},
    COUNTA({Entity Type})>0,
    COUNTA({Industry})>0,
    {Website°},
    {External Identifier},
    COUNTA({Logo})>0,
    COUNTA({Primary Address})>0,
    {Status}
  ),
  "✅",
  "Missing: " & REGEX_REPLACE(
    CONCATENATE(
      IF({Alternate Name*}, "", "Alternate Name, "),
      IF(COUNTA({Entity Type})>0, "", "Entity Type, "),
      IF(COUNTA({Industry})>0, "", "Industry, "),
      IF({Website°}, "", "Website, "),
      IF({External Identifier}, "", "External Identifier, "),
      IF(COUNTA({Logo})>0, "", "Logo, "),
      IF(COUNTA({Primary Address})>0, "", "Primary Address, "),
      IF({Status}, "", "Status, ")
    ),
    ", $", ""
  )
)
```

## Exemplo (fictício)

Example Roofing LLC é cadastrada com Alternate Name* "Example Roofing", Entity Type LLC e Industry Roofing; Legal Name* mostra "Example Roofing LLC". O escritório principal é uma linha de Address e o segundo local é uma Branch, não outra Organization.

## Uso por outros sistemas

Direção do sync e view de origem só estão confirmadas onde a observação diz; veja [Arquitetura e responsabilidades](/pt-br/systems/core/architecture).

| Sistema | Tabela local | Observação |
| --- | --- | --- |
| KPIs & OKRs | [Organization (mirror)](/pt-br/systems/kpis-okrs/entity-organization-mirror) | — |
| CRM | [Companies](/pt-br/systems/crm/entity-companies) | bidirecional, exceção do CRM à regra do Core |
| Tooling and Access | [Organization (mirror)](/pt-br/systems/tooling/entity-organization) | — |
| Communication | [Organization (mirror)](/pt-br/systems/communication/entity-organization) | — |
| Systems Central | [Organization (mirror)](/pt-br/systems/systems-central/entity-organization) | — |
| Products & Services | [Organization (mirror)](/pt-br/systems/products/entity-organization) | — |

[Corrigir registros compartilhados](/pt-br/systems/core/maintain-shared-records) · [Todas as entidades](/pt-br/systems/core/entities)