Uso y Consumo
La pantalla /dashboard/usage consolida el consumo medido (metered) de todos los clientes de la organización: eventos de API, mensajes enviados, transacciones procesadas, almacenamiento — cualquier métrica que el catálogo defina como "uso" y que se cobre por consumo.
Vista consolidada
La tabla principal agrupa el consumo por producto y por cuenta de cobro, con:
- Producto (con unidad de medida — llamadas, eventos, mensajes, GB)
- Cliente / cuenta de cobro
- Cantidad en el período
- Último evento registrado — con tiempo relativo
- Valor estimado — proyección del cobro para la próxima factura
Filtros
- Rango de fechas — por defecto, desde el inicio del mes actual hasta hoy.
- Cliente — combobox de cuentas de cobro.
- Mostrar ceros — alterna si las cuentas sin consumo aparecen en la lista.
De dónde vienen los datos
Los eventos de uso llegan por:
- API de Usage Records —
POST /v1/subscription_items/{id}/usage_records(patrón tipo Stripe). - Worker
usage-sync— se ejecuta cada hora y agrega contadores externos cuando está configurado. - Importación CSV — para cargas por lote, vía Importaciones.
Cada registro de uso se vincula a un SubscriptionItem con producto metered. En el cambio de ciclo, el worker invoice-generation materializa el consumo del período en una línea de factura.
Limpieza
Los operadores con permiso pueden poner en cero los registros de uso de un cliente (útil en casos de prueba). La acción queda registrada en Auditoría.
Captura de pantalla
