> ## Documentation Index > Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt > Use this file to discover all available pages before exploring further. # Referencia de configuración de las mejoras de suscripción Esta página recoge las reglas detalladas del asistente de configuración de Mejoras de suscripción: cómo se calculan los precios, cómo se comportan las opciones de momento y de descuento, el disparador de elegibilidad y por qué el producto de la oferta es un marcador de posición. Para la guía paso a paso, consulta [Configurar las mejoras de suscripción](/es/aftersell/subscription-upgrades-setup).
## Estados de verificación de la clave de API
En el Paso 1, **Test API key** valida tu token con tu proveedor: comprueba que se autentica, que tiene todos los permisos (scopes) necesarios y que pertenece a tu tienda. El resultado muestra uno de dos estados: * **Marca verde, "API key verified".** El token se autenticó, tiene todos los permisos necesarios y pertenece a tu tienda. **Continue** queda habilitado. * **Icono rojo de cancelación.** La comprobación no salió bien. El mensaje junto al icono indica cuál de dos cosas ocurrió: tu proveedor **rechazó** el token (revocado o sin los permisos necesarios, y el mensaje indica el problema concreto), o Aftersell **no pudo completar la comprobación** ("Could not verify the API key. Please try again."), que es una llamada fallida y no un token incorrecto. Corrige el token si fue rechazado; de lo contrario, simplemente vuelve a probar. No existe un tercer estado más suave, y un resultado de "no se pudo verificar" se ve exactamente igual que un rechazo, así que lee el mensaje en lugar de fijarte solo en el icono. **Continue** permanece deshabilitado hasta que la comprobación salga en verde. Editar el proveedor o el token borra el resultado anterior, así que vuelve a probar después de cualquier cambio. Esta barrera existe para evitar fallos en las mejoras de suscripción que, de otro modo, solo se detectarían después de cobrar al cliente.
## El disparador de elegibilidad: Variant on subscription
El asistente configura automáticamente un único disparador por ti; no necesitas configurarlo a mano: | Disparador | Configuración | | - | - | | **Variant on subscription** | Configúralo con tu variante elegible (objetivo). Se activa solo cuando esa variante está en el pedido **en una línea de suscripción**. | Todos los disparadores habilitados usan lógica AND: deben cumplirse todas las condiciones para que se muestre el embudo. Puedes añadir disparadores opcionales adicionales en el paso **Triggers** del editor de embudos (agrupados en una sección desplegable **Additional triggers** que muestra un recuento y se abre automáticamente cuando hay disparadores opcionales configurados). **No lo sustituyas por un disparador de Product más un disparador de Subscription.** Esa combinación antigua son dos condiciones independientes, por lo que un pedido que contenga tu producto disparador como compra *única* junto a un artículo de suscripción *no relacionado* cumple ambas: el embudo se activa y luego la mejora falla porque no hay una suscripción coincidente que cambiar. **Variant on subscription** es una única condición que no puede separarse de esa forma, y el asistente migra automáticamente los embudos antiguos que usan esa combinación. Sin un disparador específico de producto, un embudo puede mostrarse a clientes que no tienen el producto de suscripción elegible en su pedido. Eso desperdicia impresiones y produce una modificación de suscripción que falla en silencio: el producto de la oferta se añade al pedido, pero no se cambia ninguna suscripción en Recharge, Skio o Loop. Si **Show this funnel for all customers** está habilitado, anula todos los demás disparadores y el embudo se activa en todos los checkouts. No se recomienda para embudos de mejora de suscripción.
## Qué precio muestra el Recurring subtotal
El **Recurring subtotal** de la oferta le dice al cliente lo que costará su próxima renovación. El producto del que se toma ese precio depende del tipo de mejora: | Tipo de mejora | El precio proviene de | | - | - | | Change delivery or billing frequency | El producto **disparador** | | Replace with a different subscription product | El producto de **reemplazo** | | Both, change frequency and replace subscription product | El producto de **reemplazo** | | Add another subscribable item to subscription | El artículo **añadido** | Esta es la fuente de confusión más común. Una mejora solo de frecuencia mantiene el mismo producto por diseño, por lo que su subtotal recurrente solo puede mostrar el precio del producto disparador, sea cual sea la frecuencia que configures. Si esperabas ver ahí el precio de otro producto, lo más probable es que quieras **Both, change frequency and replace subscription product**. La cantidad usada se toma de **Override subscription quantity**, que solo aparece en los tipos de reemplazo. En una mejora solo de frecuencia siempre es 1.
## Momento de la mejora
De forma predeterminada, una mejora entra en vigor a partir del **próximo ciclo de facturación** del cliente, manteniendo su fecha de renovación existente. Si la opción de momento está habilitada para tu tienda, aparece una casilla debajo de los campos de frecuencia: > **My fulfillment provider ships the upgraded item on the current order** Marcarla inicia el nuevo intervalo de facturación de inmediato en lugar de en la próxima renovación, y desbloquea el campo **One-time upgrade price** en el Paso 4. Aftersell no cambia el pedido que el cliente acaba de hacer. Este ajuste solo mueve el intervalo de facturación. Márcala solo si tu proveedor de cumplimiento está configurado para reconocer el producto marcador de posición de la mejora y enviar el artículo mejorado en el pedido actual. Esta casilla está desactivada por defecto y no está disponible en todas las tiendas. Solo aparece en los tipos de mejora **Change delivery or billing frequency** y **Both, change frequency and replace subscription product**, y solo una vez que la opción se ha habilitado para tu tienda. Contacta con soporte a través del chat de la app si la necesitas.
## Descuento recurrente
Un incentivo opcional que se aplica a **cada renovación futura** de la suscripción mejorada (no solo al primer ciclo). No está disponible para el tipo de añadir artículo. La forma en que aparece el campo depende de si el plan de venta seleccionado tiene políticas de precios escalonados: * **Cuando se selecciona un plan de venta con niveles de descuento** (por ejemplo, un plan de Loop que aplica \$20 de descuento en el primer cobro y \$10 de descuento a partir del segundo cobro), el campo de entrada libre se sustituye por una lista de botones de opción, uno por nivel. Cada opción muestra el importe del descuento y el rango de cobros al que se aplica (por ejemplo, "Charge 1" o "Charge 2 onward"). Selecciona el nivel que se aplicará a cada renovación futura. * **Cuando no se selecciona ningún plan de venta, o el plan seleccionado no tiene niveles de descuento**, aparece el campo de entrada libre estándar. Introduce el importe y elige **Percentage** o **Fixed amount**.
## Precio de mejora único, por tipo de mejora
El **One-time upgrade price** es lo que el cliente paga en este pedido de Shopify cuando acepta. * En los tipos **Change delivery or billing frequency** y **Both** está bloqueado en `0` por defecto, porque tu proveedor de suscripciones cobra al final del ciclo de facturación actual y el producto marcador de posición aparece en el pedido de Shopify a \$0.00. Solo se vuelve editable cuando se marca la [casilla de momento de la mejora](#upgrade-timing) en el Paso 3. * En **Replace with a different subscription product** y **Add another subscribable item to subscription** la casilla de momento no aplica, por lo que el campo de precio siempre es editable. Lo que debes introducir depende del tipo de mejora: * **Frecuencia, reemplazo o ambos:** la *diferencia* de precio entre la suscripción original y la mejorada. El cliente mantiene su suscripción y este cargo cubre la diferencia. * **Añadir otro artículo con suscripción:** el cargo por el artículo añadido en este pedido. No se intercambia nada, así que no hay diferencia que calcular: es simplemente lo que el cliente paga ahora por el nuevo artículo, que luego se repite con su suscripción. Consulta [Añadir un artículo a una suscripción existente](/es/aftersell/subscription-upgrades-add-item). **First-order discount.** Un descuento opcional aplicado solo a esta compra de mejora, introducido como porcentaje (`%`) o como importe fijo. Se sitúa junto a **One-time upgrade price** y aparece siempre que ese campo sea editable, tanto en la pestaña **Create new** como en **Pick existing**. En el tipo de añadir artículo el campo sigue apareciendo, pero siempre se guarda como `0`; las ofertas de añadir artículo nunca llevan descuento, así que establece el precio que quieras en el producto de la oferta.
## Por qué el producto de la oferta es un marcador de posición
El producto de la oferta es **solo un marcador de posición visual**, no un producto real que el cliente compra. Shopify no permite mostrar un producto de suscripción como upsell post-compra después de un pedido que ya contiene una suscripción, así que Aftersell captura el precio entre mejoras con un SKU marcador de posición sin suscripción. * La imagen, el título y el precio que configures aparecen en la tarjeta de la oferta. * Al aceptar, el precio mostrado se cobra en el pedido de Shopify y Recharge, Skio o Loop aplica la mejora real a la suscripción en su siguiente ciclo. * Si eliges **Pick existing** en lugar de crear uno, el producto debe admitir compra única; los productos solo de suscripción se filtran del selector.