> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appreval.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Planos de assinatura: frequência, preço e ativação

> Como criar grupos de planos, vinculá-los a variantes, escolher entre desconto percentual ou preço fixo, e aplicar uma mudança de preço aos assinantes existentes.

Os planos definem com que frequência a cobrança acontece e a que preço. Um produto mostra o buy box de assinatura na sua página **somente quando tem pelo menos um plano ativo**.

## O tipo de plano

A primeira coisa a escolher ao criar um plano é o seu **tipo**, e ele não pode ser alterado depois (os nomes aparecem em espanhol, como todo o admin):

| Tipo                                               | Para que serve                                                                                                                                            |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **«Suscribí y Ahorrá»** ("Assine e Economize")     | Produtos com cobrança recorrente — o plano clássico: você vincula variantes e define o desconto ou o preço fixo                                           |
| **«Caja dinámica (Dynamic Box)»** (caixa dinâmica) | O cliente monta a sua caixa com produtos elegíveis — o plano define a frequência e um **% de desconto sobre o preço de tabela** do que o cliente escolher |

Um plano de caixa dinâmica **não leva produtos vinculados**: os elegíveis, os tamanhos e os descontos por volume são definidos na caixa, na seção [Caixas](/pt/lojista/caixas). Pelo mesmo motivo, ele também não tem "Aplicar aos assinantes": o preço de cada caixa é recalculado ao editá-la. O desconto admite de 0 a 99 (0 é válido — a caixa pode descontar só pelos próprios níveis), e ao editá-lo a mudança vale para compras novas e para a próxima edição de cada caixa.

Na lista, cada grupo leva a sua etiqueta de tipo: **«Caja dinámica»** ou **«Suscribí y Ahorrá»**.

## Grupos de planos

A unidade com a qual você trabalha é o **grupo de planos**: um título, um intervalo e uma forma de preço, ao qual você depois vincula todas as variantes que quiser.

A vantagem é que você define os termos uma única vez. Se você tem vinte produtos com assinatura mensal a 15% de desconto, isso é um grupo com vinte variantes vinculadas, e não vinte configurações separadas.

### As duas formas de preço

| Modo           | Como funciona                                                                            | Quando faz sentido                                                                                           |
| -------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Percentual** | Um % de desconto sobre o preço vigente de cada produto, resolvido no momento da cobrança | Catálogos com preços diferentes, ou quando você quer que o desconto acompanhe as mudanças de preço de tabela |
| **Preço fixo** | Um único preço absoluto para todas as variantes vinculadas                               | Caixas ou kits em que todos os produtos valem o mesmo dentro do plano                                        |

<Warning>
  **O intervalo não pode ser alterado depois de criado o grupo.** Se você errou a frequência, é preciso criar um grupo novo com a correta e mover as variantes. É uma restrição de como os mandatos são modelados no Mercado Pago.
</Warning>

***

## Criar um plano

<Steps>
  <Step title="Abra Planos">
    No seu admin da Shopify, entre em **Apps → Reval → Planos**.
  </Step>

  <Step title="Crie o grupo">
    Defina o título, o intervalo (número + unidade: dias, semanas ou meses) e a forma de preço — percentual de desconto ou preço fixo. O título é interno, mas o assinante o vê como descrição do débito no Mercado Pago.
  </Step>

  <Step title="Escolha como ele aparece na loja (opcional)">
    O campo **Nome na página de produto** controla o texto do seletor de planos no buy box. Vazio, é exibida a frequência (ex.: "Mensal"); preenchido, é exibido o seu texto (ex.: "Clube Café") com a frequência visível logo abaixo — o cliente nunca assina sem ver de quanto em quanto tempo será cobrado.
  </Step>

  <Step title="Vincule as variantes">
    Adicione as variantes de produto que serão oferecidas com esses termos. Cada variante vinculada recebe o seu próprio template de preço no Mercado Pago.
  </Step>

  <Step title="Verifique no storefront">
    Abra a página de um desses produtos: o buy box já deve mostrar a opção de assinatura.
  </Step>
</Steps>

<Note>
  As semanas são uma unidade de exibição: o Mercado Pago só entende dias e meses, então uma frequência semanal é convertida em dias multiplicando por sete. O comportamento é o mesmo.
</Note>

***

## Limites de ciclos (mínimos e máximos)

Ao criar ou editar um plano você pode definir dois limites opcionais, ambos em quantidade de cobranças:

* **Ciclos mínimos** — um compromisso de permanência. Até completar essa quantidade de cobranças, o cliente **não pode pausar nem cancelar pelo portal** (ele vê o motivo e quanto ainda falta). Você sempre pode cancelar pelo admin, sem restrição.
* **Ciclos máximos** — uma duração definida. Depois da cobrança número N, a assinatura **para de cobrar sozinha**: a Reval cancela o mandato no Mercado Pago e emite o evento "Assinatura finalizada" para o Klaviyo / Shopify Flow, para o e-mail de encerramento. O status permanece **Ativa** (mesmo critério da Skio): a finalização é comunicada com o aviso "Ciclos concluídos — sem mais cobranças" no admin e no portal do cliente, e fica registrada no histórico.

O buy box do produto mostra o compromisso antes de assinar ("Compromisso mínimo de X entregas", "Assinatura por no máximo Y entregas"). Vazio = sem limite, e nada é exibido.

<Note>
  Os limites são salvos no plano: ao editá-los, eles passam a valer também para as assinaturas existentes desse plano, tanto para o bloqueio de pausa/cancelamento quanto para a finalização automática.
</Note>

***

## Mudar o preço de um plano

Aqui está a parte que gera mais confusão, então vale ser explícito:

<Warning>
  **Editar o preço de um grupo NÃO muda o que os seus assinantes atuais pagam.** Muda apenas o que vão pagar aqueles que assinarem de agora em diante.
</Warning>

Para que a mudança alcance os assinantes existentes, você precisa executar **Aplicar aos assinantes** a partir do grupo. Essa ação percorre as assinaturas desse grupo e atualiza o valor do mandato no Mercado Pago, com efeito **a partir do próximo ciclo** — uma cobrança já realizada nunca é tocada.

Cada mudança fica registrada no histórico de preços da assinatura.

<Tip>
  A separação é deliberada: ela permite corrigir um plano cadastrado errado sem mexer no preço de ninguém, e decidir separadamente quando repassar um aumento à sua base existente. Vale também avisar o cliente antes de aumentar o valor dele — em vários mercados é uma obrigação legal, e em todos é uma boa prática.
</Tip>

***

## Gerenciar planos existentes

### Editar um grupo

Você pode mudar o título, o nome na página de produto e os termos de preço. **O intervalo, não.** As mudanças de preço são escritas em todas as variantes vinculadas, mas lembre-se de que elas não alcançam os assinantes até você usar "Aplicar aos assinantes".

<Tip>
  Se um produto tem **mais de um plano**, qual deles chega pré-selecionado ao abrir a página de produto é escolhido por produto em [Produtos](/pt/lojista/produtos). Por padrão é o de menor frequência.
</Tip>

### Remover uma variante

Retira essa variante do grupo. O produto deixa de oferecer assinatura no buy box se não sobrar nenhum outro plano ativo. **As assinaturas existentes dessa variante continuam sendo cobradas normalmente.**

### Arquivar um grupo

Os planos não são excluídos, são arquivados. O grupo deixa de ser oferecido no storefront e desaparece da lista, que por padrão mostra apenas os ativos.

<Note>
  Arquivar **não cancela nem pausa** nenhuma assinatura. Quem já assinou com esse plano segue o ciclo normal. Se você precisa agir sobre eles, vá em [Ferramentas](/pt/lojista/operacoes-em-massa).
</Note>

***

## Se um produto não mostra a opção de assinatura

Revise nesta ordem:

1. Se a variante está vinculada a um grupo de planos **ativo**
2. Se o grupo não está arquivado
3. Se o bloco do buy box está presente no tema do produto

Os dois primeiros você resolve por esta tela. O terceiro exige mexer no tema — fale com a gente.
