> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useaira.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tipos e hierarquias

> Organize clientes em estruturas hierárquicas para cenários como holdings, subsidiárias e organizações com múltiplas unidades.

> A Aira suporta três tipos de clientes e permite organizar hierarquias de dois níveis (Organização → Subsidiárias) para refletir estruturas corporativas reais.

## Tipos de cliente

### Individual

O tipo padrão. Representa uma empresa ou pessoa que consome seu produto e é faturada diretamente. A maioria dos clientes será deste tipo.

**Quando usar:** cliente independente sem relação hierárquica com outros clientes.

<h3 id="organizacao">
  Organização
</h3>

Representa uma entidade guarda-chuva que agrupa subsidiárias. Organizações existem para consolidar a visão e o faturamento de seus membros.

**Quando usar:** holdings, grupos econômicos ou qualquer estrutura onde uma entidade central gerencia a relação comercial de múltiplas unidades.

<h3 id="subsidiaria">
  Subsidiária
</h3>

Representa uma unidade de negócio ou filial que pertence a uma Organização. Subsidiárias geram uso independente que pode ser consolidado na fatura da organização pai.

**Quando usar:** filiais, unidades regionais ou divisões de negócio que geram uso separado, mas cuja cobrança é consolidada na organização pai.

<Note>
  O tipo do cliente é **imutável** — uma vez criado como Individual, Subsidiária ou Organização, não pode ser alterado.
</Note>

<br />

## Hierarquias

A Aira suporta hierarquias de **dois níveis**: uma Organização no topo com Subsidiárias abaixo.

```
Organização (Grupo Alpha)
├── Subsidiária (Alpha Serviços SP)
├── Subsidiária (Alpha Serviços RJ)
└── Subsidiária (Alpha Pagamentos)
```

### Regras da hierarquia

* Apenas clientes do tipo **Subsidiária** podem ter um cliente pai
* O cliente pai **deve ser** do tipo **Organização**
* Uma Organização pode ter múltiplas Subsidiárias
* O vínculo pai/filho é **imutável** após a criação
* Subsidiárias não podem ser pais de outras subsidiárias (apenas dois níveis)

<br />

<h2 id="como-funciona-na-pratica">
  Como funciona na prática
</h2>

### Uso consolidado via escopos

Ao criar um [contrato](/contratos/criar-contratos) para uma Organização, você pode configurar o **escopo de uso** para incluir automaticamente os eventos de todas as subsidiárias. Isso gera uma única fatura que agrega o uso de todo o grupo.

<Tip>
  Ao criar uma nova subsidiária, ela é **automaticamente adicionada** aos escopos de uso dos contratos da organização pai. Não é necessário atualizar os contratos manualmente.
</Tip>

### Faturamento separado

Alternativamente, você pode criar contratos individuais para cada subsidiária, gerando faturas separadas por unidade. A escolha entre faturamento consolidado e separado é feita na configuração do contrato, não no tipo do cliente.

<h3 id="visao-centralizada">
  Visão centralizada
</h3>

No Dashboard, a tela de uma Organização exibe uma aba dedicada de **Subsidiárias** com a listagem de todas as unidades vinculadas, permitindo criar, editar e arquivar subsidiárias diretamente.

<Frame>
  <img src="https://mintcdn.com/aira-e93056c6/D0DI4R_7r28AeG1L/static/subsidiaries-list.png?fit=max&auto=format&n=D0DI4R_7r28AeG1L&q=85&s=8340a1ca187ecff2ee58b0b1cb875f89" alt="Aira — Aba de subsidiárias de uma Organização" width="4060" height="1694" data-path="static/subsidiaries-list.png" />
</Frame>

<br />

<h2 id="criar-uma-subsidiaria">
  Criar uma subsidiária
</h2>

<Tabs>
  <Tab title="Via Dashboard">
    1. Acesse o cliente pai (tipo Organização) no Dashboard
    2. Na aba **Subsidiárias**, clique em **Nova Subsidiária**
    3. Preencha:
       * **Nome** da subsidiária
       * **ID Externo** — identificador único no seu sistema
    4. Opcionalmente, cadastre uma **conta de pagamento** com os dados fiscais da subsidiária (razão social, CNPJ, endereço)
    5. Salve
  </Tab>

  <Tab title="Considerações">
    * Cada subsidiária mantém seu próprio ID externo para receber eventos
    * Subsidiárias podem ter suas próprias contas de pagamento (CNPJs diferentes do pai)
    * Ao **arquivar uma Organização**, todas as subsidiárias não arquivadas são arquivadas automaticamente
    * Subsidiárias **não podem ser excluídas permanentemente** — apenas arquivadas
    * Subsidiárias não podem ser usadas diretamente em alocações de contrato enquanto estiverem ativas

    <Note>
      O CNPJ da conta de pagamento de uma subsidiária deve ser único dentro do tenant. Se houver conflito, o sistema exibe um aviso com a opção de sobrescrever a validação.
    </Note>
  </Tab>
</Tabs>

<br />

<h2 id="proximos-passos">
  Próximos passos
</h2>

* [Criar clientes](/clientes/criar-clientes) — cadastre clientes e configure seus dados
* [Contratos](/contratos/criar-contratos) — vincule planos a clientes e configure escopos de uso
* [Portal do cliente](/clientes/portal-do-cliente) — disponibilize acesso às faturas e métricas