Saltar al contenido principal

Cambios de Ítems de la Suscripción

Además de los cambios de plan (upgrade/downgrade), Facturación Automática soporta cambios en los ítems individuales de una suscripción — modificar cantidades, agregar add-ons, cambiar un producto suelto o un ítem metered sin necesidad de cambiar el plan principal. La pantalla /dashboard/subscription-changes agrupa el historial de estos cambios y la configuración predeterminada de proration.

Pestaña Historial​

Muestra todos los cambios de ítems registrados en la organización. Cada fila corresponde a un registro de SubscriptionItemChange y muestra:

  • ID de la suscripción afectada
  • Status: pending, scheduled, completed, canceled o failed
  • Timing: immediate (se aplica ahora) o end_of_period (se aplica en el próximo ciclo)
  • Cambios: ítems agregados, eliminados o modificados (con cantidad y precio)
  • Crédito generado (proration_credit) y cobro generado (proration_charge)
  • Fecha efectiva y fecha de creación

Los cambios completed ya fueron procesados; los scheduled esperan a que el worker de renovación los ejecute en el cambio de ciclo.

Pestaña Configuración​

Define el comportamiento predeterminado cuando un ítem se agrega, se elimina o cambia de cantidad:

  • Permitir aumento de cantidad y permitir reducción — controla quién puede cambiar qué.
  • Timing predeterminado — cuándo se aplica el cambio (inmediato o al final del período).
  • Método de proration — full_proration, partial_proration o no_proration.
  • Crédito en reducción — si genera saldo en la cuenta del cliente al reducir la cantidad.
  • Reembolso en reducción — si devuelve el valor vía gateway en lugar de generar crédito.

La configuración se resuelve por organización y puede sobrescribirse con reglas específicas al momento del cambio vía API.

Diferencia entre cambio de ítems y cambio de plan​

EscenarioPantalla
Cambiar de Starter a GrowthCambio de Plan
Agregar 10 usuarios extra al plan actualCambios de Ítems
Cambiar el add-on Email Premium por SMS PremiumCambios de Ítems
Reducir la cantidad de licencias al final del cicloCambios de Ítems

Ambos flujos generan proration cuando corresponde, y ambos disparan eventos y webhooks (subscription.updated, subscription_item.changed).

Captura de pantalla​

Historial y configuración de cambios de ítems de suscripción