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.
O que é um contrato
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:- Cria o primeiro ciclo de cobrança
- Começa a agregar eventos dos clientes no escopo
- Ao final de cada ciclo, calcula e gera a fatura com os itens de todos os planos
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.
Criar um contrato
Todo contrato exige as seguintes configurações:- Cliente — o cliente que será faturado (Individual ou Organização)
- Planos — um ou mais planos com as regras de cobrança
- Data de início — quando o contrato entra em vigor
- Ciclo de cobrança — frequência (semanal, mensal, anual) e âncora do ciclo
- Alocação — conta de pagamento que receberá o valor das faturas
- Produto — produto associado para identificação nos itens de fatura
- 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
Configurações para Organizações
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.Split de alocação
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.Configurações avançadas
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 →
- 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
Duplicar contratos
É 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.Próximos passos
- Ciclo de vida — entenda os status de um contrato e as transições possíveis
- Configuração de cobrança — configure períodos, âncoras e prorrata
- Reajustes — aplique reajustes por IGPM, IPCA ou índice customizado
- Versionamento de planos — como funciona o versionamento de planos entre contratos