Faturas são o resultado final do processo de faturamento. Elas são geradas automaticamente ao final de cada ciclo de cobrança, com base no uso real do cliente e nas regras do plano.
Como faturas são geradas
Ao final de cada ciclo de cobrança de um contrato, a Aira executa o seguinte fluxo:1
Agregação de eventos
Os recursos do plano agregam todos os eventos do cliente dentro do período do ciclo (soma, último valor ou únicos).
2
Aplicação de precificação
Os modelos de preço do plano são aplicados sobre os valores agregados — calculando cada item de linha individualmente.
3
Cálculo de totais
Mensalidade fixa, uso variável, descontos e franquia mínima são combinados para calcular o total da fatura.
4
Geração da fatura
A fatura é criada com status Aberta, pronta para revisão ou emissão automática.
Itens de linha
Cada fatura contém itens de linha que detalham a composição do valor:
Itens de linha são agrupados por recurso e podem conter sub-itens com o detalhamento por faixa de preço. Em sub-itens de faixa percentual, o percentual é informado em
basisPoints (até 10000 = 100%).
Itens de linha na API
Nas respostas de fatura da API pública, cada item de linha traz o camposcope, que identifica o que está sendo cobrado:
O campo
metadata de cada item está sempre presente e detalha a precificação aplicada: é preenchido para itens usage_based, minimum_commitment e contract_minimum_commitment — com formato variando por type — e vem null para os demais, como itens fixed, credit_purchase e encargos de impostos.
Faturas manuais
Além das faturas automáticas geradas por ciclos de cobrança, é possível criar faturas manuais pelo Dashboard ou via API para cobranças avulsas, ajustes ou cenários fora do fluxo padrão.Próximos passos
- Ciclo de vida da fatura — entenda os status e transições
- Descontos e alocações — aplique descontos e divida faturas
- Documentos fiscais — sincronização de NFSe via ERP e geração de PDFs
- Licenças — cobre quantidades reportadas, como usuários ativos ou filiais