Antes de começar a usar a Aira, é importante entender como as peças se encaixam. Esta página apresenta os conceitos centrais que formam a base de todo o sistema de faturamento.
Visão geral da arquitetura
A Aira opera em um fluxo linear: dados de uso dos seus clientes entram como eventos, são transformados em métricas por meio de recursos, precificados por planos (que pertencem a produtos), vinculados a contratos e, ao final de cada ciclo, geram faturas automaticamente.Entidades centrais
Clientes
Clientes são as empresas ou pessoas que consomem seu produto e serão cobradas pela Aira. Cada cliente possui um ID externo (definido por você) que conecta o cliente no seu sistema ao cliente na Aira. Clientes podem ser organizados em hierarquias (pai/filho) para cenários como holdings com subsidiárias. Saiba mais sobre Clientes →Eventos
Eventos são registros de uso gerados pelos seus clientes. Cada evento captura quem usou (ID do cliente), o que usou (nome do evento), quando usou (timestamp) e quanto usou (valor). Eventos são a matéria-prima do faturamento — sem eles, não há como calcular consumo. Saiba mais sobre Eventos →Recursos
Recursos transformam eventos brutos em métricas de cobrança. Eles definem quais eventos participam do cálculo (via filtros) e como serão agregados (soma, último do período ou valores únicos). Um mesmo evento pode alimentar múltiplos recursos com filtros diferentes. Saiba mais sobre Recursos →Produtos
Produtos são agrupadores de planos. Eles representam o que a sua empresa vende — uma plataforma, um serviço, uma solução. Cada plano pertence a um produto, o que permite organizar sua oferta comercial em categorias claras.Planos
Planos definem as regras de cobrança: mensalidade fixa, franquia mínima e métricas baseadas em uso. Cada métrica associa um recurso a um modelo de precificação (por unidade, pacote, fixo ou percentual) com faixas de preço. Planos são versionados por contrato — editar o plano original não afeta contratos existentes, e é possível personalizar preços para clientes específicos sem efeitos colaterais. Saiba mais sobre Planos →Contratos
Contratos vinculam um ou mais planos a um cliente. Eles definem quando a cobrança começa e termina, o ciclo de faturamento (mensal, trimestral, anual), quais clientes geram uso (escopo) e como reajustes são aplicados. Cada plano dentro do contrato é uma instância independente — quando o plano original é editado, o contrato recebe o status Desatualizado; quando personalizado para este cliente, o status Sobrescrito. Saiba mais sobre Contratos →Ciclos de Cobrança
Ciclos de cobrança são os períodos dentro de um contrato em que o uso é acumulado e cobrado. Por exemplo, um contrato mensal gera um ciclo por mês. Ao final de cada ciclo, a Aira calcula o uso, aplica as regras de precificação e gera uma fatura. Saiba mais sobre Ciclos de Cobrança →Faturas
Faturas são o resultado final do processo de faturamento. Elas contêm itens de linha detalhados mostrando o consumo por recurso, preços aplicados, descontos e totais. Faturas passam por um ciclo de vida: Aberta → Em Revisão → Emitida → Sincronizada → Paga ou Vencida. A Aira sincroniza documentos fiscais (NFSe) via ERP e rastreia pagamentos automaticamente. Saiba mais sobre Faturas →Pagamentos
A Aira rastreia pagamentos associados a faturas. Os métodos suportados incluem PIX, Boleto e Bolepix, integrados via gateways de pagamento (Celcash, Omie). Pagamentos podem ser registrados automaticamente por integrações ou manualmente pela equipe financeira. Saiba mais sobre Pagamentos →Entidades Legais
Entidades legais representam as empresas (CNPJs) envolvidas no faturamento — tanto a que emite a fatura quanto a que recebe. Cada contrato possui uma conta de cobrança (quem emite) e uma conta de pagamento (quem recebe), ambas vinculadas a entidades legais. São necessárias para a sincronização de documentos fiscais (NFSe) via ERP.Créditos
Créditos são saldos pré-pagos que podem ser aplicados automaticamente a faturas. Funcionam como um pool que é consumido conforme o uso é gerado, reduzindo o valor a pagar. Créditos podem ter data de expiração e são rastreados com histórico completo de transações. Saiba mais sobre Créditos →Como as entidades se conectam
- Fluxo de Faturamento
- Exemplo Prático
O fluxo principal da Aira segue esta sequência:
Seu produto gera uso
Sua aplicação envia eventos para a Aira toda vez que um cliente consome um recurso (ex: requisição de API, armazenamento, transação).
Recursos agregam o uso
Os recursos filtram e agregam os eventos relevantes para cada métrica de cobrança dentro do período do ciclo.
Planos aplicam preços
As regras de precificação do plano são aplicadas sobre o valor agregado — por unidade, pacote, fixo ou percentual, com faixas progressivas ou únicas.
Faturas são geradas
Ao final do ciclo, a Aira gera uma fatura com itens de linha detalhados, aplica descontos e franquias mínimas, e calcula o total.
Cenários de uso
A Aira é flexível o suficiente para atender diversos modelos de negócio:SaaS com cobrança por uso
Cobre por requisições de API, usuários ativos, armazenamento ou qualquer métrica mensurável.
Fintechs e meios de pagamento
Cobre comissões percentuais sobre volume transacionado usando recursos monetários e precificação por basis points.
Plataformas de IA
Cobre por tokens processados, minutos de inferência ou chamadas de modelo com faixas de preço progressivas.
Marketplaces e intermediários
Cobre taxas sobre GMV com split de faturas entre diferentes entidades e subsidiárias.
Próximos passos
Primeiros Passos
Pronto para começar? Siga o guia de primeiros passos para enviar seu primeiro evento e ver a Aira em ação.