> ## 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.
# Referência do Subscription Upsell
Esta página reúne o funcionamento e as regras de plataforma por trás do Subscription Upsell: como a assinatura é adicionada, como os planos e descontos são resolvidos, o que o cliente vê, o fulfillment, as limitações da plataforma Shopify e o catálogo completo de solução de problemas. Para saber como criar um, veja [Assinaturas em ofertas pós-compra](/pt/aftersell/subscriptions_in_post_purchase_offers).
## Como a assinatura é adicionada
O Subscription Upsell usa o changeset de pós-compra nativo `add_subscription` da Shopify. A Aftersell não chama diretamente a API do seu app de assinaturas neste fluxo: a assinatura é criada pela Shopify e o seu app de assinaturas a captura por meio da própria integração com a Shopify. É por isso que o Subscription Upsell funciona com qualquer app de assinaturas que use a Subscription API nativa da Shopify.
O primeiro ciclo da assinatura é atendido a partir do **pedido original da Shopify** como um item de linha normal. As renovações seguintes são gerenciadas pelo seu provedor de assinaturas, da mesma forma que qualquer assinatura criada durante um checkout normal.
## Plataformas de assinatura compatíveis
O Subscription Upsell é totalmente independente de provedor do lado da Aftersell. A Aftersell adiciona a assinatura pelo changeset nativo `add_subscription` da Shopify, e a Shopify encaminha a inscrição para o app de assinaturas que você tiver instalado na Shopify Subscription API. Qualquer app de assinaturas que use a Subscription API nativa da Shopify funciona sem configuração adicional, incluindo Recharge, Skio, Loop, Stay.ai, Appstle, Smartrr, Bold Subscriptions (quando executado na API de assinaturas nativa da Shopify) e os selling plans nativos da Shopify.
Os selling plans que você cria no seu app de assinaturas são importados automaticamente para a Aftersell. (A compatibilidade do Subscription Upgrade é diferente e específica por provedor; veja [Upgrades de assinatura](/pt/aftersell/subscription-upgrades).)
## Como os selling plans são resolvidos
### Allowed subscription plans
A configuração **Allowed subscription plans** é uma lista de permissões aplicada **por variante**. Para a variante que o cliente seleciona, ele vê apenas os planos permitidos disponíveis para aquela variante:
* Se exatamente um plano permitido se aplicar, o nome dele é exibido como texto estático e não há escolha a fazer.
* Se vários se aplicarem, o cliente escolhe entre eles em um menu suspenso **Purchase options**.
* Se nenhum se aplicar, aquela variante volta a exibir todos os seus próprios planos.
Esse escopo por variante significa que uma única lista de permissões pode lidar corretamente com um produto cujas variantes têm selling plans diferentes. Se nenhum dos planos permitidos estiver disponível para uma variante (porque um plano foi removido ou desativado na Shopify), a oferta volta a exibir todos os planos disponíveis para aquela variante, para que os clientes ainda possam concluir a compra. A configuração de planos permitidos também é limpa automaticamente se você alterar a opção de compra do produto para somente compra única, o que evita erros de configuração quando as opções de assinatura são removidas.
### Qual selling plan é exibido por padrão
Quando nenhum plano está selecionado em **Allowed subscription plans**, a oferta pré-seleciona o **primeiro selling plan** configurado no produto na Shopify. Se a variante tiver mais de um plano disponível, os clientes podem alterá-lo no menu suspenso **Purchase options**. Para controlar qual plano os clientes veem:
* **Restrinja os planos** (recomendado). Use a seleção múltipla **Allowed subscription plans**. Permita exatamente um e os clientes verão apenas esse plano, sem menu suspenso.
* **Reordene os selling plans na Shopify.** A ordem dos selling plans no produto determina qual é exibido primeiro.
* **Remova os selling plans não utilizados do produto.** Se você tem várias frequências e quer que apenas uma apareça, mantenha somente o selling plan relevante vinculado ao produto.
O fator mais importante para a retenção é alinhar a cadência ao uso real do produto. Uma assinatura de xampu a cada 30 dias, em que o frasco dura 60 dias, será cancelada; uma assinatura a cada 60 dias, em que o frasco dura 30 dias, será pulada. Analise os seus dados de recompra avulsa para encontrar a cadência natural de cada produto.
## Como os descontos de assinatura são exibidos
Um desconto em uma oferta de Subscription Upsell se aplica **apenas ao primeiro ciclo de cobrança**; os pedidos recorrentes futuros são cobrados pelo preço normal da assinatura. A oferta pós-compra mostra dois preços distintos:
* O **botão Accept Offer** e o subtotal do item de linha refletem o **preço do primeiro ciclo**, incluindo qualquer desconto do primeiro ciclo.
* O campo **Recurring subtotal** mostra quanto o cliente será cobrado nas **renovações seguintes**, pelo preço normal da assinatura.
Isso fica claro para descontos típicos de primeiro ciclo (10 a 25% de desconto na primeira entrega). Pode ficar confuso com um desconto extremo no primeiro ciclo, como 100% de desconto, porque o preço recorrente (e não o preço de \$0 do primeiro ciclo) é o número mais visível. Se a intenção for oferecer a primeira entrega grátis, seja explícito no texto da oferta ("Primeira caixa grátis, depois \$59.99 a cada 30 dias").
Os descontos podem ser uma **porcentagem** (por exemplo, 15% de desconto) ou um **valor fixo** (por exemplo, \$5 de desconto). O desconto acompanha o changeset `add_subscription` da Shopify, em vez de ser aplicado pelo seu app de assinaturas, e afeta apenas a assinatura criada por esta oferta.
O desconto só chega à assinatura se você marcar **Apply discount to subscriptions**. Sem isso, o changeset `add_subscription` não leva nenhum desconto e a assinatura é cobrada pelo preço integral; o desconto da oferta, então, se aplica apenas ao item de compra única.
## O que o cliente vê
Quando um cliente aceita um Subscription Upsell, três coisas acontecem em dois sistemas.
**No pedido da Shopify.** A confirmação do pedido inclui tanto o **item de linha original de compra única** quanto o **novo item de linha de assinatura** (cobrado pelo preço com desconto do primeiro ciclo). O cliente paga pelos dois itens no pedido original, e o primeiro envio da assinatura sai desse pedido como um item de linha normal.
**Nos e-mails de confirmação.** A Shopify envia a confirmação de pedido padrão com os dois itens de linha. O seu provedor de assinaturas normalmente envia o próprio e-mail de boas-vindas da assinatura, explicando o cronograma recorrente. Configure esse e-mail de boas-vindas para ser enviado minutos após a aceitação, com o nome do cliente e o produto, a cadência, a data da próxima cobrança e um link direto para o portal do cliente.
**No portal do provedor de assinaturas.** O cliente gerencia a nova assinatura no portal do seu provedor, onde normalmente pode pausar ou pular uma entrega, alterar a cadência, trocar produtos ou cancelar. O portal pertence ao seu provedor, não à Aftersell; certifique-se de que ele esteja acessível pela área de conta da sua loja ou pelo e-mail de boas-vindas, caso contrário os clientes procurarão o suporte para cancelar.
## Fulfillment de assinaturas
* **Primeiro ciclo.** O primeiro pedido da assinatura faz parte do pedido original da Shopify, então ele passa por qualquer processo de fulfillment que você use para pedidos avulsos (3PL, interno, dropship). O item de assinatura é enviado junto com a compra única original.
* **Renovações seguintes.** Os ciclos futuros são criados pelo seu provedor de assinaturas de acordo com a cadência de renovação. Cada renovação se torna um novo pedido da Shopify, atendido da mesma forma que qualquer outro pedido.
Se o seu 3PL se integra diretamente ao seu provedor de assinaturas, as renovações normalmente fluem automaticamente. Se o seu 3PL sincroniza apenas a partir de pedidos da Shopify, nenhuma configuração extra é necessária, porque cada renovação cria um pedido da Shopify.
## Limitações da plataforma Shopify
Algumas regras da plataforma Shopify se aplicam às ofertas pós-compra relacionadas a assinaturas, independentemente de qual recurso da Aftersell você use.
### Uma assinatura por pedido
A Shopify não permite que um upsell pós-compra adicione uma assinatura a um pedido que já contém uma assinatura. Essa restrição é definida pela Shopify e se aplica a todos os apps de pós-compra.
**Conectar um provedor de assinaturas remove essa restrição para o Subscription Upsell.** Quando Recharge, Skio ou Loop está conectado, a Aftersell cria a nova assinatura no seu provedor em vez de pedir à Shopify que a adicione, então as ofertas de assinatura alcançam clientes cujo pedido já contém uma assinatura. Veja [upsell para assinantes existentes](/pt/aftersell/subscription-upsell-existing-subscribers).
Se **nenhum provedor estiver conectado**, a Aftersell lida automaticamente com o caso de "assinatura já no carrinho":
* **Produtos somente de assinatura** em uma oferta são removidos do funil para aquele cliente.
* **Produtos de modo duplo** (compra única e assinatura) são automaticamente rebaixados para somente compra única, então a oferta ainda é exibida, mas sem a opção de assinatura.
De qualquer forma, você pode deixar uma oferta de Subscription Upsell no seu funil sem se preocupar com disparos incorretos em pedidos que já têm assinatura. Para modificar a assinatura que o cliente já tem, em vez de adicionar uma segunda, use o [Subscription Upgrade](/pt/aftersell/subscription-upgrades).
### Produtos somente de assinatura
Se um produto da sua oferta estiver configurado para ser vendido apenas como assinatura e nenhum provedor estiver conectado, a oferta é ignorada sempre que o pedido do cliente já contiver um produto de assinatura. O que o editor de funil mostra depende da sua configuração:
* **Um provedor está conectado.** Nenhum banner; a limitação não se aplica.
* **Nenhum provedor está conectado.** Um banner **Unlock more reach** com uma ação **Connect a provider**, explicando que clientes cujo pedido já contém uma assinatura não veem a opção de assinatura desta oferta.
* **O funil já exclui pedidos com assinatura.** Nenhum banner, já que a oferta nunca chega a esses clientes.
Onde o banner de aviso antigo **Subscription limitations** aparece, ele lista os produtos afetados e sugere definir o **Subscription trigger** como **do not include a subscription**.
### Várias ofertas de assinatura no mesmo funil
Se mais de uma oferta no seu funil contiver um produto de assinatura, apenas a primeira assinatura aceita é adicionada ao pedido; as ofertas de assinatura seguintes são ignoradas. O editor de funil avisa quando esse conflito é detectado, listando as outras ofertas que também contêm produtos de assinatura. Para evitar ofertas ignoradas, limite o seu funil a uma oferta de assinatura ou use o **Subscription trigger** para excluir pedidos que já contêm uma assinatura.
## Solução de problemas
Para que os controles de assinatura apareçam, o produto selecionado precisa ter pelo menos um selling plan ativo na Shopify. Verifique se o seu app de assinaturas criou selling plans para este produto e se eles estão ativos e atribuídos ao produto.
A oferta pré-seleciona o primeiro selling plan configurado no produto na Shopify, e os clientes podem alterá-lo no menu suspenso **Purchase options** quando mais de um plano se aplica à variante deles. Para controlar qual plano eles veem, restrinja a oferta com a seleção múltipla **Allowed subscription plans**, reordene os selling plans do produto na Shopify para que o desejado seja o primeiro ou remova completamente do produto os selling plans não utilizados. Permitir exatamente um plano remove o menu suspenso.
Sim, quando mais de um plano se aplica à variante selecionada, a oferta mostra um menu suspenso **Purchase options**. Para evitar isso, use **Allowed subscription plans** para permitir um único plano; a cadência então é exibida como texto estático. Os clientes ainda podem alterar a cadência depois, no portal do seu provedor de assinaturas.
Use o modo **One-time purchase only** na configuração de opção de compra da oferta. A Aftersell tem três modos para produtos com assinatura habilitada: **One-time purchase only**, **Subscription only** e **One-time purchase and subscription**. Selecionar **One-time purchase only** oculta completamente a opção de assinatura, mesmo quando o produto tem selling plans ativos.
Este é um dos modos de falha mais prejudiciais, porque o cliente foi cobrado, mas a assinatura nunca foi criada no seu provedor. A causa raiz mais comum, de longe, é um **selling plan que foi desativado entre a renderização da oferta e a aceitação do cliente**. A Shopify aceita o changeset porque ele tem um ID de selling plan válido no momento da renderização, mas, se o plano for desativado antes de o cliente aceitar, nenhuma assinatura é registrada posteriormente e nenhum erro é exibido.
Outras causas comuns:
* **O webhook do app de assinaturas está falhando.** Qualquer app de assinaturas que capta novas assinaturas da Shopify depende dos webhooks da Shopify. Verifique a saúde da entrega de webhooks nos logs do seu app de assinaturas.
* **O selling plan foi desvinculado do produto**, mas ainda tem um ID ativo. A Shopify aceita o changeset e o item de linha é registrado, mas o provedor de assinaturas não tem nenhum registro sobre o qual agir.
**Importante:** não há nova tentativa automática no caminho nativo `add_subscription`; ali, a Shopify é responsável pela inscrição, então a Aftersell não tem nada a reprocessar. (O caminho separado via provedor, usado quando o pedido já contém uma assinatura, *é* coberto pelo [fluxo de nova tentativa de upgrade de assinatura](/pt/aftersell/subscription-upgrades-troubleshooting).) Se isso acontecer:
1. Confirme que o selling plan ainda está ativo na Shopify e atribuído ao produto.
2. Verifique os logs de importação de pedidos / webhooks do seu app de assinaturas para o pedido afetado.
3. Se a assinatura realmente estiver faltando, a equipe de suporte do seu app de assinaturas normalmente pode inscrever o cliente manualmente a partir do ID do pedido.
Se vários clientes forem afetados, entre em contato com o suporte da Aftersell informando os IDs dos pedidos e o seu provedor de assinaturas, mas espere que a correção aconteça do lado do provedor de assinaturas, e não na Aftersell.
Isso geralmente acontece quando o desconto do primeiro ciclo é extremo (por exemplo, 100% de desconto no primeiro ciclo). O botão Accept reflete o preço do primeiro ciclo, mas, se esse preço for lido de forma idêntica ao preço recorrente, pode parecer que o desconto não foi aplicado. Confirme na pré-visualização da oferta que o desconto está configurado corretamente e conte com o texto da oferta ("Primeira caixa grátis, depois \$X a cada Y dias") para deixar os termos sem ambiguidade.
Por padrão, os descontos se aplicam **apenas ao primeiro ciclo de cobrança**. Se um cliente perguntar por que o segundo ou terceiro pedido não tem o desconto, isso é esperado. Os pedidos recorrentes são cobrados pelo preço normal da assinatura, que o cliente viu como **Recurring subtotal** na oferta.
Se você tiver Recharge, Skio ou Loop conectado, isso é esperado e a oferta funciona: a Aftersell cria a nova assinatura no seu provedor. Veja [upsell para assinantes existentes](/pt/aftersell/subscription-upsell-existing-subscribers).
Se nenhum provedor estiver conectado, a Shopify bloqueia a adição de uma segunda assinatura e a oferta é ignorada silenciosamente durante a execução. Conecte um provedor ou impeça que a oferta seja exibida a esses clientes definindo o **Subscription trigger** como **do not include a subscription**.
A Shopify permite apenas uma assinatura por pedido. Se você tiver várias ofertas de assinatura no mesmo funil, a primeira aceita prevalece e as demais são ignoradas. Limite o seu funil a uma oferta de assinatura ou use o Subscription trigger para excluir pedidos que já têm uma assinatura.
A nova assinatura é gerenciada no portal do cliente do seu provedor de assinaturas, e não diretamente na Shopify. Certifique-se de que o portal esteja vinculado na área de conta da sua loja e confirme que o e-mail de boas-vindas do seu provedor está configurado para ser enviado imediatamente após a aceitação.
O primeiro ciclo foi pago como parte do pedido da Shopify, então os reembolsos funcionam da mesma forma que para qualquer outro item de linha. O cancelamento dos ciclos futuros acontece no seu provedor de assinaturas, e não na Aftersell. Reembolsar o item na Shopify não cancela a assinatura automaticamente; você também precisa cancelá-la no portal do provedor.