Skip to main content

Uso e Consumo

A tela /dashboard/usage consolida o consumo medido (metered) de todos os clientes da organização: eventos de API, mensagens enviadas, transações processadas, armazenamento — qualquer métrica que o catálogo defina como "uso" e que seja cobrada por consumo.

Visão consolidada​

A tabela principal agrupa o consumo por produto e por conta de cobrança, com:

  • Produto (com unidade de medida — chamadas, eventos, mensagens, GB)
  • Cliente / conta de cobrança
  • Quantidade no período
  • Último evento registrado — com tempo relativo
  • Valor estimado — projeção de cobrança para a próxima fatura

Filtros​

  • Intervalo de datas — padrão do início do mês atual até hoje.
  • Cliente — combobox de contas de cobrança.
  • Mostrar zeros — alterna se contas sem consumo aparecem na lista.

De onde vêm os dados​

Eventos de uso chegam por:

  1. API de Usage Records — POST /v1/subscription_items/{id}/usage_records (padrão Stripe-like).
  2. Worker usage-sync — executado a cada hora, agrega contadores externos quando configurado.
  3. Importação CSV — para cargas batch, via Importações.

Cada registro de uso é vinculado a um SubscriptionItem com produto metered. Na virada do ciclo, o worker invoice-generation materializa o consumo do período em uma linha de fatura.

Limpeza​

Operadores com permissão podem zerar registros de uso de um cliente (útil em casos de teste). A ação fica registrada em Auditoria.

Captura de tela​

Painel de uso consolidado com consumo por produto e cliente