Cargos por asiento

Un cargo por asiento cobra un precio unitario por una cantidad que Relvo resuelve sola al facturar, a partir de altas y bajas registradas durante el período. Es lo correcto para usuarios activos, licencias, puestos o workspaces: nadie tiene que acordarse de actualizar la cantidad cada mes.

Las tres piezas

Pieza	Qué es	Dónde vive
Métrica de asiento	El tipo de puesto que se cuenta: Admin, Editor, Viewer	Definida dentro de un contrato
Evento de asiento	Un alta o una baja, con su fecha de vigencia	Ingresado por API, manual o CSV
Cargo por asiento	El precio unitario y su cadencia	Un cargo más de una fase

§

La métrica de asiento pertenece al contrato

A diferencia de una métrica de cobro por consumo, que es un objeto de catálogo reutilizable, una métrica de asiento se define dentro de un contrato y su código es único ahí. Los asientos de Acme no se cuentan junto con los de otro cliente.

Eventos de asiento

Cada evento declara un tipo de cambio (added o removed), una cantidad positiva y una fecha de vigencia: el día en que el cambio empieza a valer comercialmente, que no tiene por qué ser el día en que se registró.

Los eventos son inmutables y llevan clave de idempotencia: reenviar el mismo alta no duplica asientos. Si un evento fue un error, se cancela; no se edita.

Cómo se resuelve la cantidad

La estrategia disponible es foto al cierre (snapshot_end):

asientos = (altas con vigencia ≤ fin del período)
         − (bajas con vigencia ≤ fin del período)

No hay filtro por inicio de período: se cuenta toda la historia del contrato hasta la fecha de corte. Un asiento dado de alta en marzo sigue contando en agosto sin necesidad de re-declararlo.

!

Se cobra la foto, no el promedio

Un asiento que existió veinte días y se dio de baja antes del cierre no se cobra en ese período con esta estrategia. Si tu contrato necesita cobrar puestos por tiempo de permanencia, eso no es un cargo por asiento: es consumo, y se modela con una métrica de cobro.

Configuración del cargo

Opción	Regla
Modelo de precio	Siempre estándar: precio unitario × asientos resueltos
Cadencia	Cualquier intervalo recurrente. Nunca un cargo único
Anticipado / vencido	Anticipado por defecto
Cantidad mínima	Entero ≥ 1, opcional. Se cobra ese piso aunque haya menos asientos
Prorrateo	Opcional, incompatible con cobro anticipado

!

Prorrateo y anticipado no conviven

Prorratear significa cobrar proporción de un período que ya transcurrió; cobrar por adelantado significa cobrar un período que aún no ocurre. Relvo rechaza la combinación al crear el cargo, en vez de dejar que produzca un monto ambiguo en la primera factura.

Ejemplo

Acme, licencias Admin

Cargo: USD 20 por asiento Admin, mensual, anticipado, mínimo 5.

Fecha de vigencia	Evento	Acumulado
1 mar	+3 Admin	3
12 abr	+4 Admin	7
20 may	−2 Admin	5
28 may	+1 Admin	6

Cierre de mayo: 6 asientos activos → 6 × USD 20 = USD 120,00.

En marzo hubo 3 asientos, por debajo del mínimo de 5: se cobran 5 × USD 20 = USD 100,00.

Cuándo no usar asientos

• El cliente paga por uso real, no por puestos disponibles → métrica de cobro por consumo.
• La cantidad es fija y negociada por contrato → cargo fijo con cantidad autorizada, sin métrica.
• Hay que cobrar altas y bajas prorrateadas al día → consumo con agregación por tiempo.

RelacionadoCargos y pricingCargos fijos, por consumo y de una vez.RelacionadoUso y métricas de cobroCuando lo que se cobra es uso, no puestos.RelacionadoContratos y fasesDónde vive la métrica de asiento.