Skip to main content
Soluciones para los problemas más comunes de Subscription Upgrade. Si sigues atascado después de probarlas, contacta con soporte con los detalles indicados en Pruebas y verificación.

​
Supervisión de fallos de mejora

Aftersell supervisa los fallos terminales de mejora durante una ventana móvil de 7 días. Si el número de fallos supera el umbral de alerta, aparece un banner de advertencia en tu página de inicio que describe cuántas mejoras fallaron y durante cuántos días. La misma alerta también aparece en el panel Needs attention de la página de inicio. La alerta incluye un botón Review orders que te lleva directamente al navegador de pedidos filtrado por problemas de mejoras de suscripción, para que puedas ver los pedidos afectados y la causa específica de cada fallo. Se borra automáticamente una vez que el recuento de fallos cae por debajo del umbral dentro de la ventana móvil. Si ves esta alerta, abre el navegador de pedidos y comprueba la causa mostrada en cada pedido afectado; luego consulta los pasos de solución de problemas correspondientes a continuación.
La plantilla Subscription Upgrade nunca está oculta — siempre aparece listada bajo Add Funnel, sea cual sea la configuración de tu proveedor. Lo que te bloquea es la comprobación de conexión del Paso 1: Continue permanece deshabilitado hasta que Test API key devuelva API key verified con una marca verde.Dos resultados distintos muestran el mismo icono rojo de cancelación, así que lee el mensaje que lo acompaña:
  • Tu proveedor rechazó la clave. Al token le faltan permisos requeridos o ha sido revocado, y el mensaje nombra el problema concreto. Emite un nuevo token en el panel de tu proveedor con los permisos indicados en Configuración inicial, pégalo y prueba de nuevo.
  • Aftersell no pudo comunicarse con tu proveedor — “Could not verify the API key. Please try again.” No tiene por qué haber nada mal con el token; la llamada en sí falló. Haz clic en Test API key de nuevo.
Editar el proveedor o el token borra el veredicto anterior, así que vuelve a probar después de cualquier cambio.
Este es el comportamiento esperado. El producto es el producto de oferta, el artículo de línea provisional añadido al pedido de Shopify como registro de la mejora aceptada. Para reducir la confusión, cambia el nombre del producto de oferta a algo claro y añade una descripción en Shopify Admin que explique lo que representa. Consulta Lo que ve el cliente.
El changeset de Shopify y la llamada a la API del proveedor son independientes. Si el producto de oferta se añadió al pedido pero la suscripción no cambió, las causas más comunes son:
  • Tu token de API del proveedor está caducado o carece de los permisos requeridos. Para Recharge, el token debe tener read_orders, read_subscriptions, write_subscriptions y read_plans. Ve a Step 1: Connect provider, vuelve a probar tu clave y comprueba el mensaje de error para ver los permisos específicos que faltan.
  • El producto elegible del embudo no coincide con lo que el cliente realmente suscribió.
  • Para Loop, el plan de venta de destino no existe en tu panel de Loop para la frecuencia configurada.
  • El flujo de trabajo de reintentos puede estar aún siguiendo su calendario: tras una llamada fallida, vuelve a intentarlo a +1 hora y luego a +24 horas. Esto es igual para todos los proveedores — Loop incluido, cuyas llamadas de mejora son síncronas y aparecen en el panel de inmediato cuando tienen éxito.
Aftersell reintenta automáticamente las llamadas fallidas al proveedor en un flujo de trabajo en segundo plano. El flujo de trabajo comprueba el estado actual del proveedor antes de volver a ejecutarse, de modo que una mejora exitosa pero lenta no se aplica dos veces.Si una repetición no puede corregir la causa, el flujo de trabajo o bien reembolsa el cargo — cuando ninguna mutación del proveedor tuvo éxito y la línea cobrada era un producto provisional — o marca la mejora para conciliación manual, dejando el pedido intacto. Las suscripciones completamente nuevas y las mejoras de cajas nunca se reembolsan automáticamente, porque el comprador recibe productos reales. Contacta con soporte con los detalles indicados en Pruebas y verificación.
La opción “Use an existing selling plan” obtiene los planes directamente de Recharge, Skio o Loop. Si el menú desplegable está vacío:
  • Confirma que los planes de venta están configurados en el panel de tu proveedor.
  • Asegúrate de que tu token de API tiene acceso de lectura a Plans (Recharge: permiso read_plans) o los permisos adecuados (Skio, Loop).
  • Vuelve a Step 1: Connect provider, vuelve a probar tu clave de API y continúa.
Esto es lo esperado. En Loop el campo Billing frequency no se muestra en absoluto — solo Delivery frequency, con la nota “Loop syncs billing to delivery — customers are charged on each renewal”. Lo que establezcas como frecuencia de entrega es también la frecuencia de facturación.Por eso también las suscripciones prepagadas — una frecuencia de facturación más larga que la frecuencia de entrega — no son compatibles en Loop: la integración las rechaza de plano en lugar de ofrecer un campo que no puedes usar. Los demás proveedores muestran ambos campos.
El producto de oferta es solo de suscripción — ya sea el producto en sí o todas y cada una de sus variantes — y el checkout del cliente ya contenía una suscripción. Shopify no permite una segunda suscripción en el mismo pedido, por lo que la oferta se omitió.El panel de detalles del pedido especifica cuál fue el caso: “The customer’s checkout already has a subscription, and the offer product is subscription-only” o “All variants of the offer product are subscriptions, and the customer’s checkout already has one.” Ambos se corrigen de la misma manera — edita la selección de producto de la oferta y cámbialo por un producto de compra única, o usa la opción Create new en Step 4: Offer product para generar un producto provisional.
  • Comprueba que Show this funnel for all customers no esté habilitado. Esto anula todos los demás disparadores.
  • Comprueba el disparador Variant on subscription. Muestra el embudo solo cuando el pedido incluye uno de los productos seleccionados comprado como suscripción. En un embudo que tiene una oferta de mejora de suscripción, el asistente es dueño de este disparador y lo mantiene sincronizado con el producto que se mejora, por lo que es de solo lectura — el panel dice “Managed by this funnel’s subscription upgrade offer.” Si apunta a los productos equivocados, corrige el producto disparador de la oferta de mejora en lugar del disparador en sí.
  • Comprueba la prioridad del embudo. Un embudo de mayor prioridad con disparadores más amplios puede estar activándose primero.
No intentes reproducir esto con un disparador de producto separado más un disparador de suscripción. Ese emparejamiento es exactamente lo que Variant on subscription reemplazó: los dos coincidían de forma independiente, así que un pedido que contenía tu producto disparador como compra única y un artículo de suscripción sin relación satisfacía ambos, activaba el embudo y la mejora luego fallaba más adelante. Un solo disparador, que comprueba juntos el producto y el estado de suscripción, es la configuración compatible.