> ## 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.
# Upgrades de assinatura
Os Upgrades de Assinatura permitem oferecer a assinantes existentes uma alteração pós-compra na assinatura ativa deles logo após o checkout. Você pode alterar a frequência de entrega, trocar por um produto de assinatura diferente, fazer os dois ou [adicionar outro item à assinatura](/pt/aftersell/subscription-upgrades-add-item). A alteração é aplicada diretamente no Recharge, Skio ou Loop, então nenhum reembolso ou nova cobrança é emitido para a assinatura em si.
## De qual recurso você precisa?
O Aftersell tem três recursos pós-compra que funcionam com assinaturas. Eles parecem semelhantes, mas se comportam de formas muito diferentes. Use este fluxo de decisão antes de configurar qualquer coisa.
**Pense assim:**
1. **Subscription Upgrade** modifica uma assinatura existente de alguma forma — sua frequência, seu produto, ou adicionando um item a ela.
2. **Subscription Upsell** é apenas aditivo: ele cria uma assinatura totalmente nova. Com um provedor de assinaturas conectado, ele funciona até mesmo em pedidos que já contêm uma assinatura, então você não precisa mais se preocupar com a limitação da Shopify.
O Aftersell trata cada cenário com um recurso dedicado, para que você não precise pensar diretamente nas regras da plataforma:
* **Para alterar uma assinatura que o cliente já tem**, use o Subscription Upgrade. Ele modifica a assinatura existente do cliente diretamente no Recharge, Skio ou Loop. Um pequeno produto placeholder sem assinatura é adicionado ao pedido da Shopify para atender às regras da Shopify, enquanto o upgrade real acontece na sua plataforma de assinaturas.
* **Para adicionar uma assinatura totalmente nova**, use o **Subscription Upsell**. O item original permanece no pedido como está, e o cliente fica com uma nova assinatura recorrente ao lado dele. Isso funciona independentemente de o pedido já conter ou não uma assinatura — consulte [upsell para assinantes existentes](/pt/aftersell/subscription-upsell-existing-subscribers).
* **Para trocar um produto de compra única por outro**, use o **Replacement Upsell**. A substituição pode ser uma versão em assinatura do mesmo produto, um produto totalmente diferente ou uma variante ou quantidade diferente do mesmo produto.
**A limitação de "uma assinatura por pedido" não bloqueia mais os upsells de assinatura.** A Shopify não permite que um upsell pós-compra adicione uma assinatura a um pedido que já contém uma. Quando você conecta o Recharge, Skio ou Loop, o Aftersell cria a nova assinatura no seu provedor em vez de fazê-lo pela Shopify, então as ofertas de assinatura também alcançam assinantes existentes. Consulte [upsell para assinantes existentes](/pt/aftersell/subscription-upsell-existing-subscribers).
Use as três perguntas abaixo para encontrar o recurso certo para o seu cenário. Percorra-as em ordem e pare no primeiro **Sim** — esse é o recurso que você deve usar.
**P1: Você quer alterar uma assinatura que o cliente já tem?**
* **Sim**, use o [Subscription Upgrade](#how-subscription-upgrades-work). Este é o recurso coberto por este guia. O Subscription Upgrade modifica a assinatura existente do cliente no Recharge, Skio ou Loop, logo depois de ele concluir o checkout. Você pode alterar a frequência de entrega ou de cobrança, trocar por um produto de assinatura diferente, fazer os dois ao mesmo tempo ou [adicionar outro item à assinatura](/pt/aftersell/subscription-upgrades-add-item). A assinatura existente do cliente é atualizada no lugar. Nenhum reembolso ou nova cobrança é emitido para a assinatura em si. Um pequeno item de linha placeholder (o "produto da oferta") é adicionado ao pedido da Shopify como registro do upgrade aceito.
* **Não**, vá para a P2.
**P2: Você quer adicionar uma assinatura recorrente totalmente nova ao pedido, além do que o cliente já comprou?**
* **Sim**, use o [Subscription Upsell](/pt/aftersell/subscriptions_in_post_purchase_offers). O Subscription Upsell adiciona uma nova assinatura ao pedido. O que o cliente já comprou permanece no pedido, e uma assinatura recorrente é adicionada ao lado. Em um pedido sem assinatura, isso usa a Subscription API da Shopify. Em um pedido que **já contém uma assinatura**, o Aftersell cria a nova assinatura no seu provedor conectado — consulte [upsell para assinantes existentes](/pt/aftersell/subscription-upsell-existing-subscribers). De qualquer forma, o cliente fica com uma segunda assinatura independente.
* **Não**, vá para a P3.
**P3: O cliente comprou um produto de compra única. Você quer substituí-lo por um produto diferente, seja uma versão em assinatura do mesmo produto ou um produto totalmente diferente?**
* **Sim**, use o [Replacement Upsell](/pt/aftersell/replacement_upsells). O Replacement Upsell remove o produto de compra única original do pedido e adiciona a substituição no lugar dele. A Shopify reembolsa o item de linha original e cobra pela substituição. A substituição pode ser uma versão em assinatura do mesmo produto (por exemplo, o cliente comprou um frasco avulso e você quer que ele passe para uma assinatura mensal) ou um produto completamente diferente, avulso ou por assinatura.
### Resumo rápido
| Se você quer | Use este recurso | O que o cliente vê no pedido |
| ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Modificar uma assinatura que o cliente já tem
(alterar a frequência, trocar por um produto de assinatura diferente) | Subscription Upgrade (este guia) | Um pequeno item de linha placeholder (o "produto da oferta"). A assinatura em si muda no Recharge, Skio ou Loop. |
| Adicionar outro item a uma assinatura que o cliente já tem | [Adicionar um item a uma assinatura](/pt/aftersell/subscription-upgrades-add-item) | O item adicionado, cobrado neste pedido. Depois, ele é enviado e cobrado junto com a assinatura. |
| Adicionar uma nova assinatura além do que o cliente comprou | [Subscription Upsell](/pt/aftersell/subscriptions_in_post_purchase_offers) | Um novo item de linha de assinatura, ao lado do que o cliente já comprou. |
| Adicionar uma nova assinatura quando o pedido **já tem** uma assinatura | [Upsell para assinantes existentes](/pt/aftersell/subscription-upsell-existing-subscribers) | O novo item cobrado pelo preço do primeiro ciclo. Uma segunda assinatura é criada no seu provedor. |
| Substituir um produto de compra única por uma assinatura ou por um produto diferente | [Replacement Upsell](/pt/aftersell/replacement_upsells) | Uma linha de reembolso do produto original e uma nova cobrança pelo produto de substituição. |
## Como os Upgrades de Assinatura funcionam
Aqui está a experiência do cliente de ponta a ponta, e o que acontece nos bastidores.
A jornada do cliente tem quatro passos curtos:
1. **Compra a assinatura.** O cliente conclui o checkout de um produto que tem um plano de venda de assinatura.
2. **Vê a oferta de upgrade.** Na página pós-compra, ele vê a oferta de Upgrade de Assinatura que você configurou.
3. **Aceite pós-compra.** Ele aceita sem reinserir os dados de pagamento ou de envio.
4. **O plano é atualizado.** A assinatura existente dele é modificada no Recharge, Skio ou Loop. Um pequeno item de linha placeholder (o "produto da oferta") é adicionado ao pedido da Shopify como registro da aceitação.
Os dois sistemas estão conectados a uma única ação do cliente, mas executam de forma independente:
* **Na Shopify**, o produto da oferta é adicionado ao pedido como um item de linha placeholder. Ele é necessário porque a API pós-compra da Shopify não pode adicionar uma segunda assinatura a um pedido que já contém uma.
* **No Recharge, Skio ou Loop**, a assinatura existente do cliente é atualizada, e nenhum reembolso é emitido para a assinatura original. Na maioria dos casos, ela é editada no lugar e mantém seu ID. Duas situações funcionam de forma diferente:
* **Conversão para um plano pré-pago** no Recharge ou no Skio. O provedor não consegue mudar uma assinatura ativa para um plano pré-pago, então o Aftersell cria a assinatura no novo plano e depois cancela a original.
* **Upgrade de uma linha de uma assinatura com várias linhas** no Skio ou no Loop. O provedor não consegue reprogramar uma única linha, então essa linha é criada como uma nova assinatura própria e removida da original — o Skio define sua quantidade como `0`, o Loop remove a linha diretamente.
Em ambos os casos, o item com upgrade fica sob um **ID de assinatura diferente**, o que importa se você tiver integrações vinculadas a ele. Consulte [Fulfillment e mapeamento de 3PL](/pt/aftersell/subscription-upgrades-fulfillment).
Os preços do novo plano se aplicam no **próximo ciclo recorrente na sua plataforma de assinaturas**, não no pedido da Shopify que o cliente acabou de concluir.
Se a chamada ao provedor falhar depois que o produto da oferta foi adicionado ao pedido, o Aftersell tenta novamente em um fluxo de trabalho em segundo plano. O fluxo classifica a falha primeiro, então o que acontece em seguida depende da causa e do tipo de upgrade:
* **Causas transitórias e limites de taxa do provedor** são reexecutados. O fluxo verifica o estado atual do provedor antes de executar novamente, para que um upgrade lento mas bem-sucedido não seja aplicado duas vezes.
* **Causas que uma reexecução não pode corrigir** são encaminhadas para reconciliação manual.
* **Quando um reembolso é seguro** — nenhuma mutação no provedor teve sucesso e a linha cobrada era um placeholder, e não um produto que o comprador fica — a cobrança é reembolsada automaticamente. Assinaturas totalmente novas e upgrades de box nunca são reembolsados dessa forma, porque o comprador recebe produtos reais em ambos os casos.
Se o resultado for reconciliação manual, entre em contato com o suporte e consulte [Solução de problemas](/pt/aftersell/subscription-upgrades-troubleshooting).
## O que o cliente vê
O fluxo de Upgrade de Assinatura toca dois sistemas, e o cliente vê coisas diferentes em cada um. Entender isso evita tickets de suporte sobre "cobranças duplicadas" ou "itens faltando".
### No pedido da Shopify
Quando o cliente aceita um upgrade, o Aftersell **não** remove o item de linha da assinatura original do pedido. Removê-lo exigiria um reembolso, o que causa mais confusão para o cliente ("Fui cobrado duas vezes, o que está acontecendo?") do que resolve.
Em vez disso, o pedido fica com:
* O **item de linha da assinatura original**, como o cliente comprou.
* O **produto da oferta**, como um item de linha placeholder separado que representa o upgrade.
Por isso, nomear o produto da oferta com clareza é fundamental. O cliente deve conseguir olhar para o resumo do pedido e entender imediatamente o que o segundo item de linha representa.
**Bons nomes:**
* Upgrade para Trimestral
* Upgrade de plano trimestral
* Mudança para entrega mensal
**Evite nomes genéricos** como Subscription Upgrade se você oferece vários níveis de upgrade. O cliente não saberá qual deles aceitou.
No Shopify Admin, adicione também uma breve descrição ao produto da oferta explicando que ele representa o upgrade da assinatura e que não há cobranças adicionais nessa linha.
### No portal do provedor de assinaturas
No portal do cliente do Recharge, Skio ou Loop, o cliente vê sua assinatura atualizada. Quando a alteração entra em vigor depende de a opção de upgrade imediato ter sido usada:
* **Por padrão (próximo ciclo de cobrança)**, a alteração se aplica no próximo ciclo de cobrança do cliente. O ciclo atual permanece inalterado, e o novo plano entra em vigor a partir da próxima renovação.
* **Com o upgrade imediato (beta, sob solicitação)**, o novo intervalo de cobrança começa imediatamente, em vez de aguardar a próxima renovação. A assinatura existente do cliente ainda é atualizada no lugar; ela não é excluída e recriada.
## Funciona com Recharge, Skio e Loop
Os Upgrades de Assinatura são atualmente compatíveis apenas com **Recharge**, **Skio** e **Loop**. O upgrade é aplicado dentro da plataforma que alimenta suas assinaturas, então conectar uma delas é uma etapa de configuração obrigatória.
Para saber o que é uma integração, quais plataformas são suportadas e a configuração de token específica de cada provedor, consulte [Integrações](/pt/aftersell/subscription-upgrades-integrations).
Se você usa um app de assinaturas diferente desses três, não pode usar os Upgrades de Assinatura no momento, mas ainda pode usar o [Subscription Upsell](/pt/aftersell/subscriptions_in_post_purchase_offers) e o [Replacement Upsell](/pt/aftersell/replacement_upsells).
## Próximos passos
Conecte seu provedor e crie a oferta de upgrade com o assistente de configuração.
Amplie uma assinatura adicionando um novo produto a ela, em vez de alterá-la.
Faça um pedido de teste e verifique o upgrade na Shopify e no seu provedor.
Restrições e comportamentos que você deve conhecer antes do lançamento.
Garanta que seu 3PL envie o produto certo após um upgrade.
Correções para os problemas de upgrade mais comuns.
Guias de configuração do Recharge, Skio e Loop.