Qué se mide
La unidad de medida es el día de instancia activa. Para cada instancia en cobro, la API cuenta los días comprometidos en el ciclo, y el total del ciclo es la suma de esos días de todas sus instancias.- Una instancia activa todo el ciclo cuenta el ciclo completo.
- Una instancia que entra en cobro a mitad del ciclo compromete los días desde ahí hasta la renovación.
- Eliminar una instancia no reduce los días ya comprometidos. Vea Cómo funciona el cobro.
- Una instancia aún en prueba no entra en el conteo mientras esté en ese estado.
Resumen de cobro de la cuenta
GET /api/account/billing/summary
Devuelve el resumen del ciclo vigente de la cuenta. Autentique con el TokenAccount de la cuenta, o con el token global pasando ?account=<nombre-de-la-cuenta>.
200 OK
boolean
true cuando la cuenta es Enterprise. Si viene false, los demás campos no aparecen.integer
El crédito mensual (base) de su contrato, en centavos. Es el piso de la factura.
integer
El monto de uso ya comprometido en el ciclo, en centavos, proporcional a los días de instancia.
integer
La proyección del cobro del ciclo, en centavos: el mayor entre
baseCents y committedCents.integer
La suma de días de instancia en cobro en el ciclo.
integer
El pico de instancias simultáneas en cobro en el ciclo.
string
Inicio del ciclo vigente.
string
Fin del ciclo vigente.
string
Cuándo ocurre el próximo cobro (el fin del ciclo).
Antes de la primera renovación, la ventana del ciclo puede aún no estar completada, y el resumen muestra la
base como piso proyectado.Cobro por instancia en el listado
GET /api/instance/list ya trae, para cada instancia, un bloque billing con el estado de cobro. Aparece solo en llamadas con token de cuenta o global, nunca con token de instancia.
string
trial o billable.string | null
Cuándo termina la prueba.
null cuando la instancia ya está en cobro.string | null
Desde cuándo se cobra la instancia.
null mientras está en prueba.integer
Días que faltan de la prueba, redondeado hacia arriba.
0 fuera de la prueba.boolean
true cuando la instancia ya está en cobro.Seguimiento en tiempo real
Para reaccionar a cada cambio de estado, use los webhooks Enterprise. Avisan cuando una prueba comienza, cuando está por terminar y cuando una instancia pasa a cobro, lo que le permite reflejar ese estado en su propio panel.Siguiente
Extracto de uso
La factura con detalle del período, instancia por instancia.
Historial de conexiones
La línea de tiempo de cuándo estuvo conectado cada número.
Cómo funciona el cobro
Crédito, prueba y el modelo comprometido en detalle.
Webhooks Enterprise
Siga los cambios de estado en tiempo real.