> ## 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.

# Criar contratos

> Contratos vinculam um ou mais planos a um cliente, definindo quando a cobrança começa, o ciclo de faturamento e as regras de reajuste.

> Um contrato é o vínculo formal entre um cliente e seus planos de cobrança. Ele define **quando** a cobrança começa, **como** os ciclos são organizados, **quem** gera o uso e **quais planos** são aplicados.

<Frame>
  <img src="https://mintcdn.com/aira-e93056c6/D0DI4R_7r28AeG1L/static/contract-list.png?fit=max&auto=format&n=D0DI4R_7r28AeG1L&q=85&s=5864a42d0e39995e3cb853d9c0a6523e" alt="Aira — Listagem de contratos" width="4062" height="2390" data-path="static/contract-list.png" />
</Frame>

<h2 id="o-que-e-um-contrato">
  O que é um contrato
</h2>

O contrato é a entidade que ativa o faturamento. Sem contrato, mesmo que existam eventos, recursos e planos configurados, nenhuma fatura será gerada. Um contrato pode conter **múltiplos planos** — por exemplo, um plano de requisições de API e outro de armazenamento, ambos cobrados na mesma fatura.

Ao ativar um contrato, a Aira automaticamente:

1. Cria o primeiro ciclo de cobrança
2. Começa a agregar eventos dos clientes no escopo
3. Ao final de cada ciclo, calcula e gera a fatura com os itens de todos os planos

<Note>
  Contratos só podem ser criados para clientes do tipo **Individual** ou **Organização**. Subsidiárias não podem ser titulares de contratos — elas contribuem com uso via escopos.
</Note>

<br />

## Criar um contrato

Todo contrato exige as seguintes configurações:

1. **Cliente** — o cliente que será faturado (Individual ou Organização)
2. **Planos** — um ou mais planos com as regras de cobrança
3. **Data de início** — quando o contrato entra em vigor
4. **Ciclo de cobrança** — frequência (semanal, mensal, anual) e âncora do ciclo
5. **Alocação** — conta de pagamento que receberá o valor das faturas
6. **Produto** — produto associado para identificação nos itens de fatura

Opcionalmente:

* **Data de término:** Quando o contrato encerra automaticamente
* **Data retroativa:** Para gerar faturas de períodos anteriores à data de início (apenas ciclos mensais)
* **Valor mínimo da fatura:** Valor mínimo garantido por fatura

<br />

<h2 id="configuracoes-para-organizacoes">
  Configurações para Organizações
</h2>

Quando o cliente é uma **Organização** (com subsidiárias), o contrato oferece configurações adicionais:

### Escopo de uso

Define quais subsidiárias geram eventos que contam para este contrato. Você pode selecionar individualmente quais subsidiárias participam.

A opção **incluir novas subsidiárias automaticamente** faz com que subsidiárias criadas no futuro sejam adicionadas ao escopo sem intervenção manual.

<Tip>
  Quando uma nova subsidiária é criada para uma organização, ela é automaticamente adicionada aos escopos de todos os contratos que têm essa opção habilitada.
</Tip>

<h3 id="split-de-alocacao">
  Split de alocação
</h3>

Para organizações, é possível dividir o valor da fatura entre múltiplas contas de pagamento por porcentagem (as porcentagens devem somar 100%). Isso é útil para cenários de revenue sharing entre diferentes entidades legais do grupo.

Para clientes individuais, a alocação é sempre 100% para uma única conta de pagamento.

<br />

<h2 id="configuracoes-avancadas">
  Configurações avançadas
</h2>

Dependendo do cenário, você pode habilitar configurações adicionais no contrato:

* **Índice de reajuste:** IGPM, IPCA ou customizado, para correção monetária automática em contratos de longo prazo. [Saiba mais →](/contratos/reajustes)
* **Política de impostos:** Regras de retenção de tributos aplicadas às faturas do contrato, selecionada na aba de configurações de faturamento. Obrigatória quando o módulo está habilitado no workspace. [Saiba mais →](/contratos/politica-de-impostos)
* **Gateway de pagamento:** Método de pagamento (PIX, Boleto, Bolepix) e dias para vencimento, para contratos com cobrança automática via Celcash
* **Campos personalizados:** Metadados adicionais para categorização interna

Essas configurações não são necessárias para a maioria dos contratos e podem ser adicionadas depois, mesmo em contratos já ativos.

<br />

<h2 id="duplicar-contratos">
  Duplicar contratos
</h2>

É possível duplicar um contrato existente pelo Dashboard. A duplicação cria uma cópia com todos os planos, configurações de cobrança e alocações — pronta para ser ajustada e ativada para outro cliente ou período.

<br />

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

* [Ciclo de vida](/contratos/ciclo-de-vida) — entenda os status de um contrato e as transições possíveis
* [Configuração de cobrança](/contratos/configuracao-de-cobranca) — configure períodos, âncoras e prorrata
* [Políticas de impostos](/contratos/politica-de-impostos) — configure retenções de tributos nas faturas
* [Reajustes](/contratos/reajustes) — aplique reajustes por IGPM, IPCA ou índice customizado
* [Versionamento de planos](/planos/versionamento) — como funciona o versionamento de planos entre contratos