Planos evoluem com o tempo — preços mudam, métricas são ajustadas, faixas são redefinidas. O versionamento garante que essas mudanças não alterem retroativamente contratos que já estão ativos.
Como funciona
Quando um plano é adicionado a um contrato, a Aira cria uma instância independente daquele plano, capturando o estado atual (preços, métricas, faixas). A partir desse momento, o contrato possui sua própria cópia do plano:- Editar o plano original não afeta contratos existentes — cada um mantém a versão que foi contratada
- Personalizar o plano de um contrato não afeta outros contratos nem o plano original
- Múltiplos contratos podem usar versões diferentes do mesmo plano simultaneamente
Esse modelo elimina efeitos colaterais: atualizar a tabela de preços do plano “Starter” para novos clientes não altera o valor cobrado de quem já contratou.
Status do contrato
Quando um plano original é editado, os contratos que usam versões anteriores desse plano recebem um status na listagem de contratos:| Status do contrato | Significado | Causa |
|---|---|---|
| Desatualizado | O contrato usa versões antigas de um ou mais planos | Plano original foi editado após a criação do contrato |
| Sobrescrito | O contrato possui planos personalizados exclusivamente para ele | Equipe alterou preços/métricas para este cliente específico |
Cenários práticos
- Contrato desatualizado
- Contrato sobrescrito
Situação: a empresa atualiza o plano “Starter” de
R$ 0,01 para R$ 0,008 por requisição.O que acontece:- Contratos novos criados a partir de agora usam a versão atualizada (
R$ 0,008) - Contratos antigos continuam com
R$ 0,01— o contrato recebe o status Desatualizado - Nenhuma ação automática é tomada
- Manter o contrato como está (o cliente continua pagando
R$ 0,01) - Selecionar os contratos desatualizados na listagem e clicar em “Atualizar para última versão” — a atualização pode ser feita em lote para múltiplos contratos de uma vez
Ciclo de vida de uma versão
Contrato usa v1
Ao criar o contrato, uma instância da v1 é capturada. O contrato agora possui sua cópia independente.
Plano editado (v2)
A equipe altera preços ou métricas do plano original. Uma nova versão (v2) é criada.
Contratos antigos permanecem na v1
Contratos existentes continuam na v1 com status Desatualizado. Novos contratos usam a v2.
Deletar planos
Um plano só pode ser deletado se não estiver associado a nenhum contrato ativo. Planos com contratos vinculados devem ser desativados ou ter seus contratos encerrados primeiro.Próximos passos
- Criar planos — configure planos com métricas e precificação
- Criar contratos — vincule planos a clientes e entenda como instâncias funcionam