Puestos extra

Para un producto cuyo plan incluye algunos puestos y cobra aparte los que pasen de ahí. El ejemplo es Equipo, con 5 puestos incluidos por 30 USD al mes, y «Puestos extra» a 5 USD por persona.

El modeloCopiar enlace

• Los puestos de un cliente se suman. Billete reparte entre los miembros los puestos de todas las suscripciones del cliente con acceso: 5 de Equipo más los que compre de Puestos extra. Por eso el complemento va en el mismo cliente, como una segunda suscripción.
• El complemento solo da puestos. Sin features, no cambia lo que el equipo puede usar: eso sigue saliendo de Equipo.
• Los dos necesitan límite. Un plan sin seats tiene puestos ilimitados, y si alguna suscripción da ilimitados, el cliente los tiene todos y el complemento no limita nada.

¿Te conviene un solo plan? Si cada puesto cuesta lo mismo y no hay un precio base, un único plan por puesto, como en planes de equipo, es más simple: una suscripción, un Cobro de renovación y una fecha. Con el complemento, cada suscripción renueva por su lado.

1. Crea los dos planesCopiar enlace

const team = await billete.plans.create({
  name: "Equipo",
  lookupKey: "equipo",
  currency: "USD",
  prices: [{ months: 1, amount: 3000 }],
  seats: { mode: "included", limit: 5 },
  gracePeriodDays: 3,
  suspensionDays: 30,
  features: { mensajes: 10000 },
});

const extraSeats = await billete.plans.create({
  name: "Puestos extra",
  lookupKey: "puestos-extra",
  currency: "USD",
  prices: [{ months: 1, amount: 500 }],
  seats: { mode: "per_seat", min: 1, max: 100 },
  gracePeriodDays: 3,
});

Dales los mismos ciclos y la misma gracia para que el equipo no pierda puestos antes que el resto del plan.

2. Vende puestos extraCopiar enlace

Ofrécelos solo a quien ya tiene Equipo, desde la pantalla del equipo. El cliente elige cuántos en el checkout:

const checkout = await billete.checkouts.create({
  plan: PLANS.extraSeats,
  months: 1,
  customer: org.id,
  successUrl: "https://tuapp.com/equipos/org_7?checkout={CHECKOUT_ID}",
});
return redirect(checkout.url);

customer es el externalId del cliente que ya existe. Sin quantity, el cliente elige entre el mínimo y el máximo del plan. Al pagar, sus puestos se suman en el acto y los miembros que esperaban puesto lo reciben.

Úsalo solo la primera vez. Si el equipo ya tiene Puestos extra en curso, otro checkout de ese plan responde subscription_exists al crearlo, sin cobrar nada: cambia esa suscripción (paso 3).

3. Agrega o quita puestosCopiar enlace

Desde aquí todo es un cambio sobre la suscripción de Puestos extra:

// 3 puestos más: paga solo lo que queda del periodo, en un checkout.
const result = await billete.subscriptions.changes.create(org.extraSeatsSubscriptionId, {
  quantity: 6,
  when: "now",
});
if (result.type === "checkout") return redirect(result.checkout.url);

// Menos puestos: desde la próxima renovación.
await billete.subscriptions.changes.create(org.extraSeatsSubscriptionId, {
  quantity: 2,
  when: "renewal",
});

Si la reducción deja menos puestos que miembros activos, falla con seats_in_use: quita antes a quien sobre, o envía disableExcessMembers: true para que se queden sin puesto. Para dejar solo los incluidos, cancela la suscripción de Puestos extra al final del periodo. El portal también deja cambiar los puestos de un plan por puesto.

4. Miembros y prioridadCopiar enlace

await billete.members.create(org.id, { externalId: admin.id, name: admin.name, priority: true });
await billete.members.create(org.id, { externalId: user.id, name: user.name });

Cuando faltan puestos, primero los conservan los miembros con priority y luego los más antiguos; los demás quedan con enabled: false, registrados, hasta que se liberen puestos. members.list(org.id) devuelve capacity (los puestos del cliente, null si son ilimitados) y enabledCount, para mostrar «7 de 8 puestos en uso».

5. Sigue las dos suscripcionesCopiar enlace

Puestos y respaldo · Miembros · Referencia de suscripciones