Skip to main content
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.

Organização

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.

Subsidiária

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.
O tipo do cliente é imutável — uma vez criado como Individual, Subsidiária ou Organização, não pode ser alterado.

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)

Como funciona na prática

Uso consolidado via escopos

Ao criar um contrato 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.
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.

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.

Visão centralizada

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.
Aira — Aba de subsidiárias de uma Organização

Criar uma subsidiária

  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

Próximos passos