Cada evento registra uma ação de consumo feita por um cliente — e é a partir deles que toda a cadeia de cobrança é calculada.
O que são eventos
Um evento é um registro que documenta uma ação de uso realizada por um cliente no seu produto. Pense nele como um recibo digital: ele registra quem usou, o que usou, quando usou e quanto usou. Exemplos do mundo real:Estrutura de um evento
Cada evento possui os seguintes campos:Para recursos monetários (valores em dinheiro), envie o valor em centavos — por exemplo,
R$ 1.200,50 deve ser enviado como 120050.Origem do evento
Cada evento registra automaticamente como foi criado:
Essa informação é útil para auditoria e rastreabilidade.
Recálculo de faturas
As faturas são recalculadas diariamente durante a madrugada com os eventos recebidos ao longo do dia. Depois que uma fatura é fechada, ela não é recalculada automaticamente — apenas por ação manual no Dashboard.Se você precisa corrigir eventos após o fechamento de uma fatura, é possível reabrir a fatura e recalcular os valores manualmente.
Próximos passos
- Enviar eventos — aprenda as diferentes formas de enviar eventos para a Aira
- Propriedades e idempotência — entenda como usar propriedades adicionais e prevenir duplicatas
- Recursos — veja como eventos são transformados em métricas de cobrança
- Licenças — para quantidades declaradas, como usuários ativos ou filiais, que não acumulam como eventos