> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://supr-bundles-and-subscriptions.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Tipos de kit: descontos por quantidade, Compre X Ganhe Y, kits fixos e monte sua caixa

O Supr Bundles & Subscriptions oferece quatro **tipos de kit**, e escolher o certo é a chave para configurar ofertas como **Compre 1 e leve 1 grátis**, descontos por volume do tipo **compre mais, economize mais**, um conjunto de **produtos diferentes** vendidos juntos ou um **kit montado pelo cliente (BYOB)**, em que os clientes escolhem os próprios itens (também chamado de mix & match ou monte sua caixa). Este guia explica cada tipo, quando usá-lo e todas as configurações disponíveis em uma opção de kit. Todos os tipos podem ser comprados **uma única vez ou por assinatura**.

### Índice

* [Como os kits são criados](#3-como-os-kits-sao-criados)
* [Preciso de um produto de kit dedicado?](#3-preciso-de-um-produto-de-kit-dedicado)
* [Qual tipo de kit devo usar?](#3-qual-tipo-de-kit-devo-usar)
* [Combinando produtos diferentes em um kit](#3-combinando-produtos-diferentes-em-um-kit)
* [Desconto por quantidade](#3-desconto-por-quantidade)
* [Comprando mais do que a sua maior opção](#3-comprando-mais-do-que-a-sua-maior-opcao)
* [Compre X, ganhe Y](#3-compre-x-ganhe-y)
* [Kit fixo](#3-kit-fixo)
* [Monte seu kit (BYOB)](#3-monte-seu-kit-byob)
* [Descontos progressivos em um kit montado pelo cliente](#3-descontos-progressivos-em-um-kit-montado-pelo-cliente)
* [A opção individual](#3-a-opcao-individual)
* [Uma escolha em vez de duas](#3-uma-escolha-em-vez-de-duas)
* [Opções de kit e o seu estoque](#3-opcoes-de-kit-e-o-seu-estoque)
* [Configurações da opção de kit](#3-configuracoes-da-opcao-de-kit)
* [Variáveis no texto da opção de kit](#3-variaveis-no-texto-da-opcao-de-kit)
* [Definindo um kit como padrão](#3-definindo-um-kit-como-padrao)
* [Arredondando preços e economias](#3-arredondando-precos-e-economias)
* [Descontos a partir do preço comparativo](#3-descontos-a-partir-do-preco-comparativo)
* [Configurações adicionais da opção de kit](#3-configuracoes-adicionais-da-opcao-de-kit)
* [Brindes e complementos](#3-brindes-e-complementos)
* [Códigos de desconto e preços de kit](#3-codigos-de-desconto-e-precos-de-kit)
* [Anexando um código de desconto a uma opção de kit](#3-anexando-um-codigo-de-desconto-a-uma-opcao-de-kit)
* [Combinando códigos de desconto com preços de kit no Shopify Plus](#3-combinando-codigos-de-desconto-com-precos-de-kit-no-shopify-plus)
* [Publicação e segmentação](#3-publicacao-e-segmentacao)
* [Usando descontos de kit com um adicionar ao carrinho personalizado](#3-usando-descontos-de-kit-com-um-adicionar-ao-carrinho-personalizado)
* [Solução de problemas](#3-solucao-de-problemas)
* [Perguntas frequentes](#3-perguntas-frequentes)
* [Guias relacionados](#3-guias-relacionados)

### Como os kits são criados

Tudo fica em uma única página: [**Supr Bundles & Subscriptions > Ofertas**](https://admin.shopify.com/apps/super-subscriptions/app/offers). Clique em **Criar oferta** e escolha o que você quer oferecer:

* **Kit** dá aos compradores um preço melhor por comprar mais, ou por comprar um conjunto de produtos juntos. Comprado uma única vez.
* **Assinatura** vende um produto de forma recorrente, sem opções de kit.
* **Kit + Assinatura** faz as duas coisas, para que os compradores possam escolher uma quantidade ou um conjunto *e* assinar.

Para um kit, o passo seguinte é **Escolha um tipo de kit**: uma galeria de pontos de partida prontos que você pode filtrar por **Descontos por quantidade**, **Compre X, ganhe Y**, **Kit fixo**, **Monte o seu** e **Brindes e complementos** (por exemplo "Compre um, leve outro grátis", "Multipacks" ou "Brinde em pedidos maiores"). Escolha um e a oferta abre com essas opções já configuradas, ou clique em **Começar do zero** no topo da página para ter uma única opção mais uma opção de desconto por quantidade **Dupla** com desconto. Os botões **Cores** e **Layout** nesse passo mudam o design de todos os widgets da sua loja. Você pode mudar o tipo da oferta e todas as configurações depois.

Dentro de uma oferta de kit, você tem uma ou mais **opções**. Uma opção é uma escolha individual que o cliente vê na página de produto ("1 garrafa", "3 garrafas, economize 15%", "Monte sua caixa"). **Cada opção tem o próprio tipo**, então uma única oferta pode misturar um desconto por quantidade com uma opção de monte seu kit, se é isso que você quer. Clique em **Adicionar opção de kit** para adicionar uma e escolher o tipo dela.

O título acima das opções é o **Nome do kit** da oferta, no topo da seção **Opções de kit** ("Bundle & Save", a menos que você mude). Se o título aparece e como ele fica é definido em **Design > Elementos > Opções de kit > Título**.

Depois de adicionar ao carrinho, os compradores veem o carrinho lateral ou a página do carrinho do tema. Para enviá-los à página do carrinho ou direto ao checkout, abra qualquer opção de kit, clique em **Pular o carrinho do tema** em **Carrinho**, nas **Configurações adicionais** dela, e escolha **Ir para a página do carrinho** ou **Ir para o checkout**. A escolha vale para todas as opções de kit da oferta.

|| Você não cria um "produto de kit" separado para isso. As opções de kit são exibidas nas suas páginas de produto existentes, e o app cuida dos produtos componentes nos bastidores. Veja [Preciso de um produto de kit dedicado?](#3-preciso-de-um-produto-de-kit-dedicado) abaixo.

### Preciso de um produto de kit dedicado?

Não. Os kits são criados como opções dentro de uma oferta e aparecem nas páginas de produto que a oferta segmenta, então não há nada extra para criar. Você também não precisa do app Shopify Bundles.

Se você preferir divulgar o kit em **uma página própria** (uma página "Kit de presente", por exemplo, em vez de mostrar as opções de kit na página de cada componente), faça isso com um produto normal da Shopify:

1. Crie um produto comum da Shopify para o kit, com título, imagens e descrição próprios.
2. Em [**Supr Bundles & Subscriptions > Ofertas**](https://admin.shopify.com/apps/super-subscriptions/app/offers), crie a oferta de kit, geralmente com uma opção de **Kit fixo** ou de **Monte seu kit** contendo os produtos reais.
3. Em **Aplica-se a**, segmente a oferta para esse produto, para que as opções de kit apareçam na página dele.

Os clientes recebem uma página de produto limpa, que também pode ficar nas suas coleções, e o estoque continua sendo abatido dos produtos componentes reais.

|| **O antigo kit de "Produto agrupado" não é mais a forma de fazer isso.** Esse fluxo criava para você um produto de kit especial. Se você já tem um, ele continua funcionando e ainda aparece na sua lista de Ofertas marcado como **Kit de produto**, mas é somente leitura ali, e os novos kits devem ser criados como opções dentro de uma oferta, seguindo os passos acima.

### Qual tipo de kit devo usar?

| Objetivo | Tipo de opção |
|---|---|
| Comprar mais de um produto e economizar (ex.: "Compre 3, economize 15%") | **Desconto por quantidade** |
| Comprar X e ganhar Y grátis ou com desconto (ex.: "Compre 1 e leve 1 grátis") | **Compre X, ganhe Y** |
| Vender um conjunto fixo de produtos diferentes juntos | **Kit fixo** |
| Deixar os clientes escolherem os próprios itens entre grupos que você define (mix & match, monte sua caixa) | **Monte seu kit (BYOB)** |
| Deixar os compradores levarem uma única unidade pelo preço normal | **A opção individual**, veja abaixo |
| Deixar cada opção decidir entre compra única e assinatura, para que o comprador faça uma única escolha | **Somente assinatura** e **Somente compra única** nas suas opções, veja [Uma escolha em vez de duas](#3-uma-escolha-em-vez-de-duas) |
| Vender uma assinatura apenas em tamanhos fixos de pacote (ex.: pacotes de 3) | [**Vender em quantidades fixas**](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/a-beginners-guide-to-subscription-offers-mpp4ps/#3-vender-em-quantidades-fixas) na opção de assinatura |

Os quatro tipos de opção funcionam para **compras únicas e assinaturas**.

### Combinando produtos diferentes em um kit

**Sim, um kit pode conter produtos diferentes**, e pode ser comprado uma única vez ou por assinatura. Dois tipos de opção fazem isso:

* **Kit fixo**: você escolhe os produtos e quantos de cada ("1 xampu + 1 condicionador + 1 escova"). Os clientes escolhem uma variante de cada produto onde você permitir.
* **Monte seu kit (BYOB)**: você escolhe os produtos entre os quais os clientes podem escolher, eles definem a mistura ("quaisquer 6 sabores", "2 cafés e 1 pacote de filtros"), e você pode dar um desconto maior conforme a caixa enche.

Os dois aparecem nas páginas de produto às quais a sua oferta se aplica, e o pedido contém os produtos reais. Adicione uma opção de assinatura à mesma oferta (tipo **Kit + Assinatura**) para deixar os clientes assinarem o conjunto.

Um **desconto por quantidade** conta cada produto separadamente, a menos que você marque **Combinar produtos diferentes nos descontos por quantidade** (veja [Desconto por quantidade](#3-desconto-por-quantidade)), que reúne qualquer um dos produtos da oferta nos pacotes dele. Os kits criados com outros apps de kit geralmente não podem ser combinados com as nossas assinaturas; veja [Using Supr Bundles & Subscriptions with other apps and tools](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/using-the-app-with-other-apps-1vtgstq/).

### Desconto por quantidade

*Compre mais, economize mais.* O clássico desconto por volume, aplicado ao produto em que o widget é exibido.

Para cada opção, defina:

* **Quantidade**: quantas unidades esta opção compra.
* **Preço**: **Preço cheio**, **Porcentagem de desconto**, **Desconto em valor** ou **Preço fixo**.
  * **Desconto em valor** é tirado de **cada unidade**, e por isso o campo diz *Desconto em valor por produto*. Defina R$ 5 em uma opção de 3 unidades e o cliente economiza R$ 15.
  * Um **Preço fixo** é o preço da **opção inteira**, não de uma unidade. Defina R$ 30 em uma opção de 3 unidades e o cliente paga R$ 30 pelas três.

Uma configuração típica é [a opção individual](#3-a-opcao-individual) para uma unidade e depois 3 unidades com 10% de desconto e 6 unidades com 20% de desconto. Uma opção de desconto por quantidade de 1 unidade a preço cheio faz o mesmo trabalho, se você preferir que ela fique na lista junto com as outras.

**Um desconto por quantidade conta um produto por vez, a menos que você marque Combinar produtos diferentes nos descontos por quantidade.** Por padrão, as unidades são contadas por produto, então um pacote de 3 significa três unidades do *mesmo* produto, e três produtos diferentes cobertos pela oferta não se somam para chegar à faixa do pacote de 3.

**Combinar produtos diferentes nos descontos por quantidade** é uma caixa de seleção em **Nome do kit**, acima das suas opções de kit. Ela só aparece quando todas as opções de kit da oferta são descontos por quantidade. Com ela ativada, as unidades de todos os produtos da oferta contam juntas: 2 de um produto e 1 de outro chegam ao pacote de 3, e cada uma delas recebe o desconto no checkout. Algumas coisas a saber:

* Cada produto mantém o próprio preço, então **Porcentagem de desconto** é a opção que funciona melhor. Um **Desconto em valor** é tirado de cada unidade, e um **Preço fixo** é dividido igualmente entre as unidades do pacote.
* Itens de assinatura e de compra única são contados separadamente, assim como duas opções de assinatura diferentes.
* A página de produto mostra o preço do pacote para o produto que está sendo visto; o desconto combinado é calculado no carrinho e no checkout. Escreva "Mix and match" no subtítulo da opção para que os compradores saibam.
* Ele vale para todas as opções de kit da oferta, e o frete grátis de uma opção segue a mesma contagem.

Para conjuntos fixos de produtos diferentes, veja [Combinando produtos diferentes em um kit](#3-combinando-produtos-diferentes-em-um-kit).

**Misturando variantes em um pacote.** As variantes de um mesmo produto contam juntas, então um cliente que monta um pacote de 3 com três sabores diferentes ainda recebe o preço do pacote de 3. O seletor de variantes da opção faz isso por você. Se o seu adicionar ao carrinho é personalizado, veja [Usando descontos de kit com um adicionar ao carrinho personalizado](#3-usando-descontos-de-kit-com-um-adicionar-ao-carrinho-personalizado).

**No carrinho.** Um desconto por quantidade adiciona essa quantidade de unidades do produto, então um pacote de 8 aparece no carrinho como o produto com quantidade 8. A Shopify mostra as quantidades assim para todos os apps, e um pacote não pode ser exibido como um único item.

**Se o seu tema mantém o próprio seletor de quantidade.** As opções definem a quantidade para você e, na maioria dos temas, o seletor de quantidade do próprio tema fica oculto enquanto as opções de kit são exibidas. Onde ele continua visível, os dois se movem juntos: um comprador que muda o seletor tem selecionada a opção de desconto por quantidade que essa quantidade conquistou, sempre a melhor que ela alcança, então 4 cai na sua opção de 3 unidades e voltar para 1 cai na sua opção de 1 unidade. O número dele é mantido, então pedir 4 compra 4 em vez de voltar ao tamanho da opção. As opções que não são descontos por quantidade são deixadas de lado de propósito, porque um kit fixo, um monte seu kit ou uma opção Compre X, ganhe Y é um conjunto de itens que o seletor não descreve, assim como [a opção individual](#3-a-opcao-individual).

### Comprando mais do que a sua maior opção

**Em uma oferta cujas opções de kit são todas descontos por quantidade, comprar mais do que a sua maior opção mantém o desconto dela.** Cada opção funciona como um limite: qualquer quantidade igual ou maior que o tamanho de uma opção ganha o preço dessa opção em todas as unidades, e o cliente sempre recebe a melhor opção que alcançou. Com opções de 2 e 3 unidades, 4 ou 10 unidades recebem o desconto de 3 unidades em todas elas. Isso vale independentemente de como a quantidade é alcançada, na página de produto ou alterando a quantidade no carrinho.

Duas coisas a saber:

* **Uma oferta que mistura tipos de opção é mais rígida.** Assim que a oferta também tem uma opção Compre X, ganhe Y, de kit fixo ou de monte seu kit, um desconto por quantidade é cobrado no próprio tamanho ou em um múltiplo exato dele (3, 6, 9 para um pacote de 3), então outras quantidades podem ser cobradas a preço cheio. Se você quer "compre mais, economize mais" em qualquer quantidade, mantenha as opções dessa oferta como descontos por quantidade.
* **Compras diferentes são contadas separadamente.** As unidades compradas em frequências de entrega diferentes, ou compra única ao lado de uma assinatura, são contadas como compras separadas, e não somadas.

### Compre X, ganhe Y

*Compre X itens, ganhe Y grátis ou com desconto.*

* **Quantidade comprada**: quantos o cliente precisa comprar, a preço cheio.
* **Quantidade da recompensa**: quantos ele ganha como recompensa.
* **Desconto da recompensa**: **Grátis**, **Porcentagem de desconto**, **Desconto em valor** ou **Preço fixo**.
* **Produtos da recompensa**: de onde vem a recompensa.
  * **O mesmo produto que ele compra**, a clássica oferta do mesmo SKU, sem seletor.
  * **Os produtos da oferta**, para que o cliente escolha a recompensa entre tudo o que a oferta cobre.
  * **Produtos específicos** que você escolhe, para que a recompensa venha de um conjunto que você controla.

Isso cobre "Compre 1, leve 1 grátis", "Compre 2, leve 1 com 50% de desconto" e "Compre 3, ganhe um produto grátis à sua escolha" com o mesmo tipo de opção.

**Os itens comprados são sempre a preço cheio.** O desconto inteiro de uma opção Compre X, ganhe Y é a recompensa, então não há porcentagem nem valor de desconto no lado da compra, como há em um desconto por quantidade. Uma opção "Compre 2 e leve 1 GRÁTIS" em um produto de R$ 43,99 cobra R$ 87,98 e envia três unidades.

**Com uma assinatura.** Em uma oferta **Kit + Assinatura**, o desconto da assinatura é tirado primeiro de cada unidade e a recompensa é calculada sobre esse preço. Assim, "Assine e economize 10%" mais "Compre 2 e leve 1 GRÁTIS" cobra 2 x R$ 39,59 = R$ 79,18 em vez de R$ 87,98. Se você quer a oferta Compre X, ganhe Y apenas em pedidos de compra única, clique em **Somente compra única** na opção e ative-o. Cada opção lista as outras configurações como pequenos chips sob os campos principais, cada um nomeando uma configuração e, quando está ativada, mostrando **Ativado** ou o seu valor. Clicar em um chip abre a seção **Configurações adicionais** da opção com essa configuração expandida, e o seletor dela a ativa.

**No checkout, em uma assinatura.** Uma opção Compre X, ganhe Y comprada por assinatura entra no carrinho como duas linhas, os itens comprados e os itens da recompensa, então a Shopify mostra "This order has a recurring charge for multiple items" onde, de outra forma, mostraria um subtotal recorrente. Isso é proposital. A Shopify calcula o subtotal recorrente por conta própria, sem o desconto da opção, então nessas ofertas ele indicava um preço de renovação que ninguém jamais é cobrado. O cliente ainda vê o detalhamento completo na página, e o primeiro pedido e cada renovação são cobrados exatamente como a opção diz.

**Cada unidade é uma escolha própria.** Em uma opção que recompensa **o mesmo produto**, o cliente recebe um seletor de variantes para cada unidade do conjunto, então uma opção "Compre 2 e leve 1 grátis" em uma camiseta permite levar uma M, uma G e uma P grátis. O seletor é sempre exibido em opções Compre X, ganhe Y (sempre que o produto tem mais de uma variante), porque, de outra forma, o item grátis seria apenas mais uma cópia do que estiver selecionado na página de produto. Cada linha traz o próprio preço, com o preço que aquela unidade custaria sozinha riscado ao lado, para que a recompensa seja lida como economia.

**Qual unidade é a grátis.** Quando as unidades não têm todas o mesmo preço, a recompensa vai para a unidade **mais barata** do conjunto, do mesmo jeito que funciona o desconto Compre X, ganhe Y da própria Shopify. É isso que a opção risca e que o cliente paga, para que ninguém possa colocar a variante mais cara no espaço do item grátis.

**Recompensas escolhidas de um grupo.** Quando a recompensa vem de **os produtos da oferta** ou de **produtos específicos**, a opção tem duas metades e as duas podem ser escolhidas. Os itens comprados ficam no topo, com um seletor de variantes por unidade, então uma opção "Compre 2" pode ser uma M e uma G em vez de duas do que estiver selecionado na página de produto. A recompensa é escolhida nos cards abaixo, cada um mostrando o preço normal da recompensa riscado sob o preço da oferta, e levar a mesma recompensa mais de uma vez dá um menu de variantes por unidade, então dois itens grátis podem ser de dois tamanhos diferentes. Quando a recompensa vem de uma lista com mais de seis produtos, os cards abrem em um seletor atrás de um botão **Escolher itens**, em vez de serem impressos ao longo da opção.

A palavra exibida no lugar do preço em um item grátis pode ser alterada em **Design > Rótulos** e é traduzível como qualquer outro rótulo.

### Kit fixo

*Venda um conjunto fixo de produtos diferentes juntos.* Você decide exatamente o que vai na caixa; o cliente a compra como uma coisa só.

Abra a opção, defina o **Preço do kit** (**Preço cheio**, **Porcentagem de desconto**, **Desconto em valor** ou **Preço fixo**) e depois use **Adicionar um produto** em **Produtos do kit**. Para cada produto, você pode definir:

* **Quantidade**: quantas unidades desse produto o kit inclui.
* **Variantes permitidas**: todas as variantes são oferecidas, a menos que você restrinja. Clique no link "X de Y variantes" sob o produto e marque as variantes que esta opção pode usar no seletor de produtos da Shopify. Marque apenas uma para fixar a opção nessa variante: o cliente não tem escolha de variante, então um produto vendido em pacotes de 1, 2 e 8 pode ter uma opção de kit fixo por pacote.
* **Variante padrão**: qual variante vem pré-selecionada. O cliente ainda pode mudá-la onde houver um menu de variantes.

**Mostrar os produtos antes de a opção ser escolhida** é uma configuração de uma opção de kit fixo, em **Exibição**. Desativada, os produtos da opção e as escolhas de variante deles aparecem quando o comprador escolhe a opção. Ativada, eles são listados na opção desde o início, e escolher uma variante (uma amostra ou uma escolha em um menu) também escolhe a opção, no mesmo clique.

**No carrinho**, cada produto do kit é uma linha própria, e o kit permanece inteiro: aumentar a quantidade de qualquer item adiciona um segundo kit inteiro, diminuir tira um kit e remover um item remove o kit inteiro. Se um carrinho é editado de outra forma, só os kits completos recebem o preço de kit, e quaisquer itens extras são cobrados pelo preço normal.

**Produtos adicionados um a um.** Ative **Agrupar estes produtos em kit no carrinho** na opção e o preço do kit também vale quando um comprador adiciona cada produto do kit separadamente, por exemplo pela página de cada produto, por uma página de coleção ou por um adicionar ao carrinho personalizado. Os produtos precisam ser comprados do mesmo jeito (todos por compra única ou todos por assinatura), e apenas conjuntos completos recebem o preço. Os itens que já têm preço de outra opção de kit mantêm esse preço, então um carrinho nunca recebe desconto duas vezes. Sem a configuração, só os kits adicionados pela opção de kit recebem o preço do kit.

**Estoque.** Um kit fixo só pode ser comprado como um conjunto completo, então, enquanto qualquer produto dele estiver esgotado, a opção mostra **Esgotado** no lugar do preço e não pode ser selecionada. Reponha o produto ou tire-o do kit antes de divulgá-lo. Veja [Opções de kit e o seu estoque](#3-opcoes-de-kit-e-o-seu-estoque).

### Monte seu kit (BYOB)

*Deixe os clientes escolherem os próprios itens entre os seus grupos.* Também conhecido como **mix & match** ou **monte sua caixa**, é uma experiência completa de kit montado pelo cliente. Ao adicionar uma opção, escolha **Monte seu kit (BYOB)** como tipo e defina o **Preço da caixa**.

**Mostrar os produtos antes de a opção ser escolhida** é uma configuração de uma opção de monte seu kit, em **Exibição**. Ativada, a caixa e os produtos dela, com as escolhas de variante, são exibidos desde o início, e adicionar um item ou escolher uma variante também escolhe a opção, no mesmo clique. Desativada, a caixa aparece quando o comprador escolhe a opção.

Uma opção pode ter **um ou mais grupos** (clique em **Adicionar outro grupo** para ter outro), e cada grupo tem:

* **Nome do grupo**: o rótulo que o cliente vê para aquele passo.
* **Subtítulo do grupo** (opcional): uma linha curta sob o nome do grupo, como "Sedosos e duradouros". Traduza-o em **Configurações > Traduções > Ofertas**.
* **Mínimo a escolher** e **Máximo a escolher**: definir os dois com o mesmo número significa "exatamente N". A caixa tem um espaço para cada item, até o máximo.
* **Produtos que os clientes podem escolher**: o grupo de produtos daquele grupo. Cada produto precisa estar **Ativo** na Shopify e disponível no seu canal de vendas **Loja virtual**, senão os compradores não conseguem escolhê-lo.
* **Permitir que os clientes escolham o mesmo produto mais de uma vez**: ativado, um produto pode preencher mais de um espaço, então um cliente pode colocar três dele na caixa. Desativado, cada produto entra uma vez, então uma caixa de seis significa seis produtos diferentes.
* **Itens iniciais**: o que a caixa contém quando a página carrega. O editor os preenche com os primeiros produtos do grupo quando você os adiciona.
  * **Uma caixa com no máximo tantos espaços quanto produtos** tem uma linha por espaço (**Item 1**, **Item 2** e assim por diante). Escolha um produto diferente no menu de qualquer linha, ou desmarque um item para deixar aquele espaço vazio para os clientes escolherem. Todos os itens vêm marcados, a menos que você os desmarque.
  * **Uma caixa com mais espaços do que produtos**, por exemplo uma caixa de 25 a partir de 5 refeições, tem uma linha por produto, em que você define com quantas unidades dele a caixa começa. O que você deixar sem preencher começa vazio para os clientes escolherem. Se cada produto só pode entrar uma vez, cada produto é uma caixa de seleção.

Um grupo é um simples "escolha 4 deste grupo de produtos". Vários grupos formam uma caixa em etapas ("escolha 2 cafés e depois 1 pacote de filtros"). Para vender vários tamanhos de caixa, adicione uma opção por tamanho ou use [descontos progressivos](#3-descontos-progressivos-em-um-kit-montado-pelo-cliente) para que uma opção cubra todos os tamanhos.

**A caixa abre cheia.** Na página de produto, a caixa já vem preenchida com os seus itens iniciais e a opção mostra o preço na hora, então um cliente que gosta da sua seleção a adiciona ao carrinho com um toque. O visual de um grupo depende de quantos produtos ele tem:

* **Seis produtos ou menos**: cada produto é um card na opção, com os seus itens iniciais já escolhidos. O cliente toca em um card para adicioná-lo ou retirá-lo e, quando **Permitir que os clientes escolham o mesmo produto mais de uma vez** está ativado, usa os botões de mais e menos em um card escolhido para definir quantos.
* **Mais de seis produtos**: uma linha por item, com imagem e nome. Cada linha tem um botão **Alterar** que abre uma lista curta de produtos: cada produto com a imagem, o preço já com o desconto do kit ao lado do preço normal riscado, uma escolha de variante e um botão **Escolher** que troca o item e fecha a lista. Um espaço que você desmarcou mostra **Escolha um item** com um botão **Escolher**. Como os produtos só aparecem nessa lista, um grupo longo nunca empurra o seu preço e o botão de adicionar ao carrinho para baixo na página.

De qualquer forma, uma caixa que ainda não está cheia precisa ser preenchida antes de ir para o carrinho. Um produto que a sua loja não pode vender agora (rascunho, arquivado, fora da Loja virtual ou esgotado em todas as variantes) mostra **Indisponível** e não pode ser escolhido. Se o seu estoque dos produtos de um grupo somar menos do que a caixa precisa, a opção inteira mostra **Esgotado** e, se um cliente escolher mais de um item do que você tem, os botões de compra ficam desativados até ele mudar as escolhas. Veja [Opções de kit e o seu estoque](#3-opcoes-de-kit-e-o-seu-estoque).

Quando cada produto só pode entrar uma vez, um produto que já está na caixa não pode ser adicionado de novo, e a lista de produtos o marca como **Na sua caixa**. No editor, um produto usado em um item inicial é marcado como **usado em outro espaço** nas outras linhas.

Os botões **Alterar** e **Escolher**, o título **Selecionar produto**, os textos **Escolha um item** e **Na sua caixa** e todas as outras palavras que a caixa imprime podem ser alterados em **Design > Rótulos** (no grupo **Monte sua caixa**) e são traduzidos para os seus outros idiomas em **Configurações > Traduções > Widgets**. Todos eles já vêm traduzidos nos idiomas compatíveis com o app.

Você também pode marcar **Sempre incluir o produto atual em todas as caixas**, para que o produto em que o widget é exibido sempre faça parte da caixa. Acima de um grupo de cards, ele aparece como uma linha **Inclui**; acima de linhas, é listado como o primeiro item, sem botão Alterar.

Mais duas opções ajudam com listas de produtos longas e produtos com opções:

* **Pesquisar, ordenar e filtrar** adiciona uma caixa de busca e um menu de ordenação (a sua ordem, preço do menor para o maior, preço do maior para o menor, nome de A a Z) ao topo da lista de produtos. Quando os produtos do grupo têm dois ou mais tipos de produto na Shopify, uma fileira de botões de tipo também filtra a lista. Ele aparece na lista que abre em **Alterar**, então ajuda em grupos com mais de seis produtos.
* **Mostrar variantes como amostras** agora fica na página Design, onde uma única opção vale para todas as escolhas de variante nos dois widgets; veja [O widget de assinatura](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/the-subscription-widget-l9335l/). Uma caixa que tinha essa opção ativada aqui mantém uma caixa de seleção **Mostrar variantes como amostras nesta caixa** até você desativá-la.

**Pesquisar, ordenar e filtrar** é uma caixa de seleção na opção, abaixo de **Sempre incluir o produto atual em todas as caixas**, e o texto dele (**Pesquisar produtos**, **Ordenar**, as opções de ordenação, **Todos** e **Nenhum produto corresponde à sua busca**) pode ser alterado em **Design > Rótulos**, no grupo **Monte sua caixa**.

Um kit montado pelo cliente oferece o que a caixa pode conter, e não um assistente passo a passo: não há um fluxo separado de "escolha o tamanho da caixa e depois escolha por categoria", e o app não programa conteúdos de caixa diferentes para cada mês. Os clientes escolhem o conteúdo e os assinantes podem alterá-lo depois pelo portal do cliente (veja abaixo).

|| Uma opção de monte seu kit serve para escolher entre **produtos diferentes**. Se tudo o que você quer é um produto comprado em um pacote em que cada unidade pode ser uma variante diferente, isso é um **desconto por quantidade** com o seletor de variantes ativado. Uma opção de monte seu kit também é a forma de definir o preço de um conjunto de produtos *diferentes* que o cliente escolhe: um desconto por quantidade conta cada produto separadamente.

### Descontos progressivos em um kit montado pelo cliente

*Dê um desconto maior quanto mais itens entrarem na caixa.* Uma opção de monte seu kit pode ter até 10 faixas de desconto, então uma opção cobre todos os tamanhos de caixa, em vez de uma opção por tamanho.

1. Abra a opção e defina o **Preço da caixa** como **Preço cheio**, ou como **Porcentagem de desconto** para um desconto que vale antes da primeira faixa.
2. Defina **Mínimo a escolher** e **Máximo a escolher** como a menor e a maior caixa que você vende.
3. Em **Descontos progressivos**, clique em **Adicionar uma faixa de desconto** e defina os **Itens na caixa** e o **Desconto** (% de desconto) de cada faixa, por exemplo 2 ou mais com 10%, 4 ou mais com 20% e 6 ou mais com 25%.
4. Clique em **Salvar**.

Todo item da caixa conta para uma faixa, seja qual for o produto ou a variante, então um comprador que escolhe 5 de um sabor e 1 de outro chega à faixa de 6 itens sem precisar escolher antes um tamanho de caixa. A caixa sempre recebe o maior desconto que alcançou, e o preço da caixa da própria opção vale até a primeira faixa.

Os compradores veem isso enquanto montam: a opção mostra **Economize até 25%** antes de qualquer escolha, o preço é atualizado a cada item adicionado e uma linha sob a caixa diz quantos itens a mais liberam o próximo desconto. As duas linhas podem ser reescritas por você em **Design > Rótulos** e são traduzidas em **Configurações > Traduções > Widgets**.

O checkout cobra a faixa que a caixa alcançou, em pedidos de compra única e em assinaturas, e as renovações mantêm esse preço. Uma caixa que o cliente edita no portal do cliente é recalculada na faixa que o novo conteúdo alcança.

|| As faixas exigem um preço de caixa **Porcentagem de desconto** ou **Preço cheio**. Uma opção com preço de caixa **Desconto em valor** ou **Preço fixo** mantém o desconto único dela, seja qual for o conteúdo da caixa.

### A opção individual

Toda oferta de kit também tem uma **opção individual**: uma unidade do produto pelo preço normal, sem desconto, para os compradores que não querem um kit. É o equivalente, no kit, da linha de compra única de uma oferta de assinatura, e fica na lista **Opções de kit** ao lado das opções que você criou, com o título **Individual**, a menos que você a renomeie.

**Uma nova oferta começa com ela visível, no topo das opções** (o ponto de partida **Multipacks** é a exceção e a deixa oculta), para que os compradores cheguem comprando uma unidade e passem para opções maiores a partir daí. As ofertas que você criou antes de a opção individual existir mantêm o que você definiu: a opção continua oculta até você ativá-la, então nada do que você já tem em andamento ganha uma opção que nunca pediu.

1. Acesse [**Supr Bundles & Subscriptions > Ofertas**](https://admin.shopify.com/apps/super-subscriptions/app/offers) e abra a oferta.
2. Encontre a linha **Individual** na lista **Opções de kit**. Um selo **Oculta** significa que ela está desativada no momento.
3. Clique no **olho** para exibi-la nas suas páginas de produto, ou para ocultá-la de novo.
4. Clique para abrir a linha e definir o **Título**, um **Subtítulo** e uma **imagem**. Deixe o título vazio e ele usa o texto de toda a loja de **Design > Rótulos**.
5. Use as **setas** para colocá-la acima ou abaixo das suas opções de kit e clique em **Salvar**.

A opção individual não é arrastada com as outras, porque só fica no topo ou no fim da lista, que é onde ela pode aparecer na vitrine. As setas funcionam com ela exibida ou oculta, então você pode decidir onde ela fica antes de ativá-la.

Como ela pertence à oferta, e não à loja, você pode usá-la em um kit e não em outro. O título e o subtítulo dela são traduzíveis em **Configurações > Traduções > Ofertas**, no grupo da oferta, para que apareça corretamente em todos os idiomas em que você vende.

|| A opção individual tem o próprio botão **Definir como padrão**, como todas as outras opções. Defina-a como padrão e a página de produto abre em uma unidade pelo preço normal, no topo ou no fim da lista; defina qualquer outra opção como padrão e a página abre nesse kit. Veja [Definindo um kit como padrão](#3-definindo-um-kit-como-padrao).

**Quais opções de assinatura ela oferece.** Como qualquer opção de kit, a opção individual oferece todas as opções de assinatura da oferta. Para deixar uma de fora, abra essa opção de assinatura, clique em **Restringir a opções de kit específicas**, ative-o e deixe a opção individual desmarcada: ela está listada ali junto com as opções que você criou. Mantenha todas as opções de assinatura fora dela e a unidade individual é vendida somente por compra única. Veja [Uma escolha em vez de duas](#3-uma-escolha-em-vez-de-duas).

### Uma escolha em vez de duas

Em uma oferta **Kit + Assinatura**, o comprador geralmente faz duas escolhas: uma opção de kit e depois compra única ou assinatura no widget abaixo dela. Se cada uma das suas opções já diz como é comprada, por exemplo **1 unidade**, **1 unidade todo mês** e **pacote de 3**, você pode transformar isso em uma única escolha.

1. Acesse [**Supr Bundles & Subscriptions > Ofertas**](https://admin.shopify.com/apps/super-subscriptions/app/offers) e abra a oferta.
2. Exiba [a opção individual](#3-a-opcao-individual) para uma unidade comprada uma vez.
3. Adicione uma opção de **Desconto por quantidade** com quantidade 1 para a assinatura, clique em **Somente assinatura** nela e ative-o.
4. Adicione o seu pacote, por exemplo uma opção de **Desconto por quantidade** de 3 unidades, clique em **Somente compra única** nela e ative-o.
5. Abra a sua opção de assinatura, clique em **Restringir a opções de kit específicas** e ative-o; depois, marque apenas a opção de desconto por quantidade de 1 unidade. Deixe a opção individual desmarcada para que ela continue sendo só compra única.
6. Clique em **Salvar**.
7. Acesse [**Supr Bundles & Subscriptions > Design**](https://admin.shopify.com/apps/super-subscriptions/app/widget) e ative **Ocultar quando houver uma única opção** no card **Configurações de complementos**.

Agora, cada opção deixa exatamente uma forma de comprar, então o widget de assinatura sai do caminho e a opção que o comprador escolhe é a decisão inteira. A opção somente assinatura mostra o preço de assinatura desde o início, e cada opção entra no carrinho do jeito que diz: uma vez, ou por assinatura.

|| O widget só sai do caminho para uma opção que deixa uma única forma de comprar. Uma opção **Somente assinatura** em uma oferta com duas frequências de entrega ainda mostra o widget, para que o comprador possa escolher uma.

**Uma frequência diferente para cada pacote** funciona do mesmo jeito: adicione uma opção de assinatura por frequência (todo mês, a cada 2 meses, a cada 3 meses) e, em cada uma, clique em **Restringir a opções de kit específicas**, ative-o e marque apenas o pacote dela. O pacote de 2 passa a ser oferecido a cada 2 meses, o de 3 a cada 3 meses e assim por diante.

### Opções de kit e o seu estoque

As opções de kit seguem o estoque da sua Shopify para produtos que **Controlam a quantidade** e estão com **Continuar vendendo quando estiver sem estoque** desativado.

* **Uma opção que o seu estoque não consegue atender mostra Esgotado** no lugar do preço, fica esmaecida e não pode ser selecionada. Por exemplo, um pacote de 6 quando restam apenas 4, ou uma caixa de 60 quando os produtos que a compõem somam menos de 60. Ela volta a ficar disponível assim que houver estoque suficiente, ou quando o cliente trocar para uma variante que tenha estoque.
* **Se a opção selecionada por padrão está esgotada**, a próxima opção que pode ser atendida é selecionada no lugar dela quando a página carrega.
* **Em um monte seu kit, as escolhas são verificadas em relação ao estoque.** Se um cliente escolhe mais de um item do que você tem, os botões de adicionar ao carrinho, Comprar agora e de checkout expresso são desativados, e uma mensagem sob a opção diz quantos restam, até ele mudar as escolhas.

Um brinde esgotado segue a configuração **Quando um brinde estiver esgotado** da oferta: a opção mostra **Esgotado**, ou é vendida sem o brinde. Veja [Brindes e complementos](#3-brindes-e-complementos).

A página de produto lê o estoque do produto que exibe. Para os outros produtos de um kit fixo ou de um monte seu kit, ela só sabe se estão esgotados, então a verificação de estoque da própria Shopify ainda se aplica a eles: se a Shopify não consegue adicionar o kit inteiro, nada dele é adicionado e o cliente vê a mensagem da Shopify sob a opção.

As duas mensagens podem ser reescritas por você em **Design > Rótulos** (**Opção esgotada** e **Estoque insuficiente**) e são traduzidas em **Configurações > Traduções > Widgets**.

### Configurações da opção de kit

Toda opção, seja qual for o tipo, tem estas configurações principais:

* **Título**: o texto principal da opção.
* **Padrão**: qual opção vem pré-selecionada na página de produto. Clique em **Definir como padrão** na opção que você quer destacar. Veja [Definindo um kit como padrão](#3-definindo-um-kit-como-padrao).
* **Seletor de variantes**: deixa os clientes escolherem uma variante para cada item da opção (clique em **Seletor de variantes** na opção e ative-o). Sempre ativado em uma opção **Compre X, ganhe Y** que recompensa o mesmo produto, em que a recompensa é um item separado que o cliente está escolhendo.
* Arraste as opções para reordená-las, ou clique em **Duplicar** em uma para criar rapidamente uma faixa parecida.

No editor, cada linha de opção é rotulada com o tipo acima do título, por exemplo "Desconto por quantidade (x3)", para que as opções de kit e as de assinatura sejam fáceis de distinguir à primeira vista.

A ordem em que os dois widgets são empilhados na página de produto é definida em **Design > Elementos > Layout da página**: **Kit no topo** coloca as opções de kit primeiro e, desativado, coloca o widget de assinatura primeiro.

### Variáveis no texto da opção de kit

O **Título**, o **Selo**, o **Subtítulo** e o **Texto abaixo** de uma opção podem incluir variáveis, que são preenchidas com os preços atuais da opção e mudam quando o comprador troca uma variante ou uma opção de assinatura. Por exemplo, um subtítulo `Você economiza {{ saved_total }}` aparece como **Você economiza R$ 12,00**.

| Variável | Preenchida com |
| --- | --- |
| `{{ total }}` | o preço da opção, depois do desconto do kit |
| `{{ price }}` | o preço de um item dela |
| `{{ original_total }}`, `{{ original_price }}` | o mesmo antes do desconto (o preço comparativo, quando o produto tem um, a menos que **Economia calculada pelo preço de venda** esteja ativada na oferta) |
| `{{ saved_total }}`, `{{ saved_amount }}` | quanto a opção, ou um item, economiza |
| `{{ saved_percentage }}` | a economia em porcentagem |
| `{{ discount }}` | o desconto como você o definiu, por exemplo 15% ou R$ 5,00 |
| `{{ quantity }}` | quantos itens a opção contém |
| `{{ product }}`, `{{ variant }}` | o título do produto e a variante escolhida |

Você não precisa digitá-las: clique no ícone de código no canto superior direito de um desses campos. Ele lista todas as variáveis; clique em uma e ela é adicionada ao fim do texto. O ícone funciona no celular também.

O **Título** e o **Subtítulo** da [opção individual](#3-a-opcao-individual) também aceitam variáveis: `{{ price }}`, `{{ original_price }}`, `{{ saved_amount }}`, `{{ saved_percentage }}`, `{{ product }}` e `{{ variant }}`, preenchidas para uma unidade pelo preço normal. Assim, um subtítulo `Apenas {{ price }}` aparece como **Apenas R$ 4,00**.

Os nomes usados pelo Kaching Bundles também funcionam, como `{{ new_price }}`, `{{ new_total }}` e `{{ saved_percentage }}`, então o texto que você traz de lá continua funcionando. As mesmas variáveis funcionam no [texto da opção de assinatura](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/a-beginners-guide-to-subscription-offers-mpp4ps/#3-variaveis-no-texto-da-opcao).

### Definindo um kit como padrão

O **padrão** é a opção que já está selecionada quando a página de produto carrega. Fazer da sua faixa de melhor custo-benefício o padrão, um pacote de três em vez de uma unidade, é uma das formas mais rápidas de aumentar o valor médio dos pedidos.

1. Acesse [**Supr Bundles & Subscriptions > Ofertas**](https://admin.shopify.com/apps/super-subscriptions/app/offers) e abra a oferta.
2. Clique em **Definir como padrão** na opção de kit que você quer pré-selecionada.
3. Clique em **Salvar**.

| O botão **Definir como padrão** fica na linha da opção, na lista, então não é preciso abrir a opção. Ele funciona do mesmo jeito na [opção individual](#3-a-opcao-individual), nas opções de assinatura e na linha de compra única.

Só uma opção pode ser a padrão por vez, então definir uma nova limpa a anterior. Reordenar as opções arrastando não muda qual é a padrão.

Uma oferta que você começa do zero não torna nenhuma das opções de kit a padrão, o que deixa a opção individual selecionada, e a linha dela mostra o selo **Padrão**. A maioria dos pontos de partida prontos torna uma opção de kit a padrão. Clique em **Definir como padrão** em uma opção para mover a seleção inicial para ela e em **Definir como padrão** na opção individual para movê-la de volta. Uma opção individual oculta nunca é exibida, então não pode ser a padrão: se você a ocultar sem escolher outra opção, a página abre na sua primeira opção de kit.

Em uma oferta **Kit + Assinatura**, há duas escolhas independentes. O padrão da opção de kit define em qual tamanho de pacote o comprador começa, e o padrão da opção de assinatura define se esse pacote começa como assinatura ou como compra única. Defina os dois se quiser algo como "pacote de 3, entregue todo mês" pré-selecionado.

|| Os passos completos para opções de assinatura e para a linha de compra única estão em [Setting the default option](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/a-beginners-guide-to-subscription-offers-mpp4ps/#3-como-definir-a-opcao-padrao).

### Arredondando preços e economias

Duas configurações da oferta ajeitam centavos quebrados. Cada uma vale para todas as opções da oferta.

**Arredondar preços** é a caixa de seleção abaixo de **Nome do kit**, no topo de **Opções de kit**. Ela cobra um valor inteiro em opções de **desconto por quantidade** e **Compre X, ganhe Y**: uma opção "Compre 2 e leve 1 GRÁTIS" que daria R$ 79,92 é cobrada como R$ 80,00. O checkout, o carrinho, o widget na página de produto e as renovações de uma assinatura usam o preço arredondado, então o que o cliente vê é o que ele paga.

* **Como arredonda.** Cada conjunto de uma opção é arredondado para o valor inteiro mais próximo, então dois conjuntos no carrinho custam o dobro de um conjunto. O arredondamento funciona ajustando o desconto da opção nos poucos centavos necessários, então nunca cobra mais do que os itens custam sem a opção, e uma opção grátis continua grátis.
* **O que ele deixa em paz.** Uma opção sem desconto próprio, como a [opção individual](#3-a-opcao-individual), não tem o que ajustar e mantém o preço. Se você quer esses valores inteiros também, defina o preço do próprio produto como um valor inteiro. Kits fixos, kits montados pelo cliente e opções Compre X, ganhe Y com recompensa escolhida de um grupo não são arredondados.
* **Opções de assinatura pré-paga.** O total cobrado é arredondado, mas o preço por entrega mostrado ao lado é esse total dividido pelas entregas, então nem sempre é um valor inteiro.

**Arredondar o valor economizado** é uma caixa de seleção na seção **Etiqueta de economia** de uma opção. Ela mostra a economia na etiqueta como um número inteiro, então "Economize R$ 69,93" aparece como "Economize R$ 70". Ela só muda o texto, nunca um preço, então use também **Arredondar preços** se quiser os preços inteiros.

### Descontos a partir do preço comparativo

Por padrão, um desconto de kit sai do preço de venda do produto. Marque **Calcular os descontos de kit a partir do preço comparativo** abaixo de **Nome do kit**, no topo de **Opções de kit**, para calculá-lo a partir do preço comparativo, nos produtos cujo preço comparativo está acima do preço.

Exemplo: um produto com preço comparativo de R$ 100 é vendido por R$ 80. Uma opção "pacote de 2, 30% de desconto" normalmente custa R$ 112 (30% de desconto sobre R$ 160). Com a configuração ativada, custa R$ 140 (30% de desconto sobre R$ 200), e o preço riscado mostra R$ 200.

* **Porcentagem de desconto** sai do preço comparativo, **Desconto em valor** é tirado do preço comparativo e um **Preço fixo** é cobrado como está.
* **Nunca cobra mais do que o preço.** Se o desconto a partir do preço comparativo ficar acima do preço de venda (10% de desconto sobre R$ 100 dá R$ 90, acima do preço de R$ 80), a opção cobra o preço de venda e não mostra economia.
* **Produtos sem preço comparativo**, ou com um igual ou abaixo do preço, recebem o desconto a partir do preço, como antes. Em um kit fixo ou em um monte seu kit, cada produto usa o próprio preço comparativo, quando tem um.
* **Vale para compras únicas.** Em uma assinatura, o desconto do kit continua saindo do preço, porque a Shopify só entrega ao app o preço comparativo de itens de compra única no carrinho. As recompensas de **Compre X, ganhe Y**, os brindes e os complementos sempre são calculados a partir do preço.
* A página de produto, o carrinho e o checkout usam o mesmo preço, então o que o cliente vê é o que ele paga.

### Configurações adicionais da opção de kit

**Subtítulo**, **Texto abaixo**, **Selo** e **Imagem** são campos principais, exibidos sempre que a opção está aberta. Todo o resto é um chip abaixo deles: clique nele para abrir as **Configurações adicionais** da opção com essa configuração expandida e use o seletor dela para ativá-la.

**Texto e exibição**

* **Rótulos dos botões** (somente opções Compre X, ganhe Y): substitui os botões da recompensa nesta opção (o **Botão de escolher** e o **Convite para adicionar item**).
* **Subtítulo**: uma linha de texto de apoio sob o título.
* **Texto abaixo**: uma linha de texto exibida sob a opção.
* **Etiqueta de economia**: mostra quanto o cliente economiza. Desative para não mostrar economia nesta opção.
  * **Automática** calcula a economia para você, contando tanto o desconto nos produtos quanto o valor dos brindes que a opção acrescenta. Ela só aparece em opções que de fato fazem o cliente economizar algo. Em uma opção **Compre X, ganhe Y**, ela é exibida como um valor, porque a economia é o valor da recompensa; para mostrar uma porcentagem, use um desconto por quantidade com preço **Porcentagem de desconto**.
  * Em uma opção de **monte seu kit**, a etiqueta aparece logo de cara, antes de o cliente mudar qualquer coisa, sempre que a opção aplica uma **porcentagem de desconto** ou um **desconto em valor**: a economia é a mesma seja qual for o conteúdo da caixa, então não há motivo para escondê-la. Uma opção com preço de caixa **fixo** é a exceção, já que a economia dela é a diferença entre esse preço e o que estiver na caixa, então a etiqueta aparece quando há algo na caixa.
  * **Manual** permite escrever o texto você mesmo. Coloque `{value}` onde quiser que o valor calculado apareça, por exemplo `Você economiza {value} hoje`. Deixe `{value}` de fora e a etiqueta mostra exatamente o que você digitou e continua na opção mesmo quando ela não tem desconto para calcular, o que é útil para uma linha fixa, como destacar o valor de um brinde.
  * Marque **Arredondar o valor economizado** para mostrar a economia como um número inteiro. Veja [Arredondando preços e economias](#3-arredondando-precos-e-economias).
  * O texto da etiqueta é traduzível, para aparecer corretamente em todos os idiomas em que você vende.
* **Economia calculada pelo preço de venda** não é mais uma configuração da opção de kit: é um chip em **Preço**, na parte de baixo dos detalhes da oferta. Por padrão, quando um produto tem preço comparativo acima do preço, os preços riscados e as economias são medidos a partir do preço comparativo, então um produto reduzido de R$ 72 para R$ 44 e vendido em kit por R$ 40 mostra "Economize R$ 32". Com ela ativada, o preço riscado mostra R$ 44 e a etiqueta "Economize R$ 4", contando só o desconto do kit. Ela vale para todas as opções de assinatura, todas as opções de kit e a linha de compra única da oferta, e muda apenas o que os compradores leem, nunca o que é cobrado. Veja [Savings from the selling price](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/a-beginners-guide-to-subscription-offers-mpp4ps/#6-economia-calculada-pelo-preco-de-venda).
* **Selo**: destaca a opção com um selo, por exemplo "Mais popular" ou "Mais vendido". Combina bem com tornar essa mesma opção a padrão. Os selos são uma configuração da opção de kit; as opções de assinatura não têm. O formato, a posição, as cores e o tamanho do selo ficam em **Design > Elementos > Selo de mensagem**, e o selo automático de desconto fica em **Design > Elementos > Selo de desconto**.
* **Imagem**: mostra uma imagem ao lado desta opção na vitrine.

**Preço e comportamento do carrinho**

* **Frete grátis**: inclui frete grátis quando um cliente seleciona esta opção. A linha "Inclui frete grátis" é exibida na parte de baixo da opção, abaixo de qualquer complemento, para que seja lida como um resumo de tudo o que aquela opção conquista. Como o desconto de um desconto por quantidade, ele é conquistado pelas unidades de um produto.
* **Código de desconto** (em **Preço e desconto**): um dos seus códigos de desconto da Shopify, adicionado ao carrinho quando um cliente adiciona esta opção, para que ele não precise digitá-lo. Veja [Anexando um código de desconto a uma opção de kit](#3-anexando-um-codigo-de-desconto-a-uma-opcao-de-kit).
* **Desconto por mercado** (em **Preço e desconto**, exibido quando a sua loja vende em dois ou mais mercados): uma porcentagem de desconto maior para compradores de alguns dos seus mercados, por exemplo 10% em todos e 15% no Canadá. Cada mercado tem uma linha com uma caixa de seleção: marque-a e digite a porcentagem dele ao lado, que precisa ser maior que a da própria opção. A página de produto mostra a cada comprador o preço do mercado dele, e o checkout o aplica. Exige um desconto percentual (ou preço cheio), então é recusado em **Compre X, ganhe Y**, em um preço **Preço fixo** ou **Desconto em valor** e em um monte seu kit com descontos por tamanho de caixa.

**Comportamento da assinatura**

* **Aplicar desconto às assinaturas**: aplica o desconto desta opção também aos pedidos de assinatura. Desative-o se você não quer que o desconto do kit se some ao desconto da assinatura: o desconto da opção passa a valer apenas para compras únicas. Para uma opção Compre X, ganhe Y, use **Somente compra única**.
* **Somente assinatura**: oculta a linha de compra única quando esta opção está selecionada, para que a opção só possa ser comprada por assinatura.
* **Somente compra única**: o oposto. Oculta as opções de assinatura quando esta opção está selecionada, para que ela só possa ser comprada uma vez. Útil para um kit de presente, um tamanho de teste ou um pacote grande de abastecimento que você não quer que seja enviado de forma recorrente.
* **Ocultar para clientes B2B**: oculta esta opção de clientes que compram em nome de uma empresa (Shopify B2B) e mantém o desconto dela fora dos pedidos deles, já que eles compram pelo preço do catálogo da empresa.
* **Mercados**: as opções de kit seguem a oferta. Para vender uma oferta apenas em alguns mercados, use o chip **Mercados** na parte de baixo dos detalhes da oferta; veja [Selling in some markets only](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/a-beginners-guide-to-subscription-offers-mpp4ps/#6-como-vender-apenas-em-alguns-mercados).

**Somente assinatura** e **Somente compra única** são as duas pontas da mesma escolha, então ativar uma desativa a outra.

|| **Monte seu kit em uma assinatura.** Os produtos entre os quais os clientes escolhem são sempre adicionados à assinatura da oferta, então uma caixa comprada por assinatura continua sendo uma assinatura, seja qual for o valor de **Aplicar desconto às assinaturas** (essa configuração só define se o desconto da própria opção também vale). Esses produtos são vendidos por assinatura somente dentro da caixa: a menos que a oferta também os segmente, as páginas de produto deles não mostram opções de assinatura, e os clientes não podem adicioná-los a uma assinatura pelo portal do cliente. Para deixar um cliente que já tem a caixa mudar o que há nela, ou o tamanho, pelo portal, ative **Editar caixas de kit** em [**Configurações > Portal do cliente**](https://admin.shopify.com/apps/super-subscriptions/app/settings/customer-portal). Ele vem desativado por padrão. Veja [Editing a build your own bundle box](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/customer-portal-settings-hymca7/#3-editar-uma-caixa-de-kit-montado-pelo-cliente).

Quais opções de assinatura uma opção de kit oferece é definido no sentido contrário, na própria opção de assinatura: abra-a e clique em **Restringir a opções de kit específicas**. A opção individual também está nessa lista. Veja [Additional settings](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/a-beginners-guide-to-subscription-offers-mpp4ps/#3-configuracoes-adicionais).

|| Se uma opção de kit acabar não oferecendo nada, porque é somente compra única (ou nenhuma opção de assinatura se aplica a ela) *e* a linha de compra única está oculta nesta oferta, o widget de assinatura fica totalmente oculto enquanto essa opção está selecionada, e a opção é adicionada ao carrinho como uma compra única simples.

|| Com **Ocultar quando houver uma única opção** ativado em **Design > Configurações de complementos**, o widget também sai do caminho enquanto uma opção que deixa exatamente **uma** forma de comprar está selecionada, e essa forma é usada: uma opção somente compra única é adicionada ao carrinho uma vez, e uma opção somente assinatura com uma única frequência de entrega é adicionada ao carrinho nessa assinatura.

**Extras**

* **Complementos** e **Brindes**, descritos na próxima seção.

### Brindes e complementos

Os dois são ativados por opção, pelos chips **Brindes** e **Complementos**, e valem enquanto essa opção está selecionada.

Os **Brindes** adicionam produtos sem custo.

1. Clique em **Brindes** na opção, ative-o e clique em **Adicionar um brinde** para escolher o produto; depois, defina a **Quantidade**.
2. Defina **O brinde vale para**: **Somente o primeiro pedido** ou **Todos os pedidos (contínuo)**.
3. Defina **Como os brindes são dados**: **Dar todos os brindes** adiciona cada um automaticamente, **Deixar o cliente escolher** transforma os brindes em um grupo do qual o cliente escolhe e **Brindes que o cliente escolhe** define quantos (por exemplo, 2 brindes entre 3 produtos).
4. Defina **Quando um brinde estiver esgotado**. Isso vale para todas as opções da oferta, em qualquer opção em que você defina (veja abaixo).
5. Clique em **Salvar**.

**Quando um brinde estiver esgotado.** Um produto de brinde que controla a quantidade, está em zero e tem **Continuar vendendo quando estiver sem estoque** desativado não pode ser adicionado a um carrinho, então você escolhe o que a oferta faz no lugar:

* **Mostrar esta opção como esgotada** (o padrão): a opção mostra **Esgotado** e não pode ser selecionada até o brinde voltar ao estoque. Use quando o brinde faz parte da oferta.
* **Pular o brinde e vender mesmo assim**: os clientes ainda podem comprar a opção. A linha do brinde mostra **Indisponível** no lugar de **Grátis**, o brinde fica de fora do carrinho e a economia da opção deixa de contar o valor do brinde. Use quando você prefere continuar vendendo a esperar o brinde ser reposto.

Em uma opção em que os clientes escolhem os brindes, um brinde esgotado mostra **Indisponível** e também não pode ser escolhido, de qualquer forma. Com **Pular o brinde e vender mesmo assim**, os clientes escolhem entre os brindes que restam; com **Mostrar esta opção como esgotada**, a opção fica esgotada quando restam poucos brindes para completar o número que os clientes escolhem. Um brinde configurado para continuar vendendo quando está sem estoque continua sendo adicionado normalmente. A palavra **Indisponível** é o rótulo **Produto indisponível** em **Design > Rótulos**.

Uma linha de brinde com apenas um nome digitado em **Produto de brinde**, e nenhum produto escolhido, aparece na opção sem adicionar nada ao carrinho. Isso serve para um brinde que você envia fora da Shopify, como um cartão escrito à mão.

Na vitrine, cada brinde é uma linha própria na parte de baixo da opção: a imagem e o nome do produto à esquerda e, à direita, uma coluna de preço que mostra o preço normal do brinde riscado sobre a palavra **Grátis**, para o cliente ver quanto o brinde vale. O nome do brinde vem do próprio produto e segue as suas traduções da Shopify. A palavra **Grátis** pode ser alterada em **Design > Rótulos** e é traduzível como qualquer outro rótulo. Quando o produto do brinde tem mais de uma variante, o cliente escolhe a variante (em um menu, ou em amostras quando **Mostrar variantes como amostras** está ativado) depois que a opção é selecionada; nas outras opções, a linha do brinde mostra apenas o nome e o preço.

Em uma assinatura, o brinde entra no carrinho na assinatura, junto com o item ao qual ele veio, então o checkout mostra "This order has a recurring charge for multiple items" em vez de um subtotal recorrente que a Shopify calcula sem o desconto da opção. Um brinde definido como **Somente o primeiro pedido** é retirado da assinatura depois que esse primeiro pedido é feito, para que o seu cliente fique com o brinde prometido sem que ele chegue grátis em toda renovação. Um produto que você só dá de brinde não passa a oferecer assinatura sozinho na própria página de produto.

|| **Um brinde em uma opção de assinatura:** as opções de assinatura têm a própria configuração **Brinde**, com estas mesmas configurações de brinde, mais **Um número definido de pedidos**. Veja [Free gift](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/a-beginners-guide-to-subscription-offers-mpp4ps/#3-brinde) no guia de ofertas de assinatura.

Os **Complementos** são extras opcionais que o cliente marca: "comprados juntos com frequência" ou uma oferta de última hora na página de produto ("Adicione uma escova por R$ 5").

1. Clique em **Complementos** na opção, ative-o e clique em **Adicionar um complemento**.
2. Escolha o produto. O complemento é sempre exibido com o nome do próprio produto. Quando o produto tem mais de uma variante, **Variante selecionada inicialmente** define a variante selecionada quando a página carrega (**Primeira em estoque**, por padrão); os compradores podem escolher outra variante em um menu no complemento.
3. Defina o **Preço**: **Preço cheio**, **Porcentagem de desconto**, **Desconto em valor**, **Preço fixo** ou **Grátis**. Marque **Incluir frete grátis quando este complemento for selecionado** se o complemento deve conquistar frete grátis.
4. Clique em **Salvar**.

Abaixo dos complementos, mais três configurações:

* **Mostrar como comprados juntos com frequência** organiza os complementos do jeito que os compradores conhecem das grandes lojas. Sob o título **Comprados juntos com frequência**, o produto da opção e os complementos ficam lado a lado, ligados por sinais de mais; tocar na imagem de um complemento o adiciona ou o remove, e um desmarcado fica esmaecido. Abaixo deles fica o total da opção e de todos os complementos marcados, com o preço cheio riscado quando os complementos têm desconto. Depois vem uma lista: **Este item**, com o preço da opção, seguido de cada complemento com a caixa de seleção, a escolha de variante e o preço. Os clientes adicionam tudo com o botão **Adicionar ao carrinho** da própria página de produto. Reescreva o título, a primeira linha e o total em **Design > Rótulos** (**Título de Comprados juntos com frequência**, **Comprados juntos com frequência: este item**, em que `{title}` é o nome do produto, e **Total de Comprados juntos com frequência**, em que `{total}` é o valor).
* **Marcar os complementos inicialmente**: os complementos começam marcados, e os compradores desmarcam o que não querem.
* **Adicionar as recomendações da Shopify** adiciona até 4 dos produtos complementares que você define para cada produto no app **Search & Discovery** da Shopify, depois dos seus próprios complementos. Eles são vendidos pelo preço normal: o checkout não consegue saber quais produtos foram recomendados, então não pode dar desconto neles.

Os complementos aparecem como caixas de seleção abaixo da opção selecionada, sem um título próprio, a menos que sejam exibidos como comprados juntos com frequência. Cada complemento entra no carrinho como um **item de compra única**, mesmo quando a opção é comprada por assinatura, então ele é enviado com o primeiro pedido e não se repete nas renovações. Para oferecer extras a quem já assina, use [Upsells](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/upsells-w393d/).

| Os complementos de uma opção de kit não são a mesma coisa que o card **Configurações de complementos** da página Design, que reúne recursos do widget como **Ocultar quando houver uma única opção**. Veja [Product Page Add-ons](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/product-page-add-ons-1b9e1n3/).

### Códigos de desconto e preços de kit

Os preços de kit são cobrados por um desconto automático da Shopify que o app cria para você, chamado **Supr Bundle Block Pricing** (as lojas que instalaram o app antes de setembro de 2026 ainda podem ver um nome mais antigo até o app atualizá-lo). Deixe-o como está: excluí-lo ou desativá-lo em **Admin da Shopify > Descontos** faz todas as opções de kit pararem de dar desconto no checkout.

Esse desconto está configurado para se combinar com descontos de produto, de pedido e de frete, então se o código de desconto de um cliente também se aplica é decidido pelas **configurações do próprio código**:

* Em **Admin da Shopify > Descontos**, abra o código e encontre **Combinações**. Marque **Descontos de produtos** para deixar o código valer em um pedido que já tem um preço de kit. Deixe desmarcado para manter o código fora dos kits: a Shopify então aplica apenas um dos dois, não os dois.
* Um código de desconto de **pedido** (por exemplo, 10% de desconto no pedido) ou um código de **frete grátis** vale por cima dos preços de kit quando está configurado para se combinar com descontos de produtos.
* Um código de desconto de **produto** não se soma a um preço de kit no mesmo item: a Shopify dá a cada linha do carrinho um desconto de produto, o maior. No Shopify Plus, você pode mudar isso; veja [Combinando códigos de desconto com preços de kit no Shopify Plus](#3-combinando-codigos-de-desconto-com-precos-de-kit-no-shopify-plus). A mesma regra é o motivo pelo qual o desconto automático de outro app pode substituir o seu preço de kit; veja [When another discount app overrides your prices](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/how-subscription-discounts-work-1btg9f3/#3-quando-outro-app-de-descontos-sobrepoe-seus-precos).

Para códigos voltados a assinantes (somente o primeiro pedido, um número definido de renovações), veja [Shopify discounts and discount codes](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/how-subscription-discounts-work-1btg9f3/#3-descontos-e-codigos-de-desconto-da-shopify).

### Anexando um código de desconto a uma opção de kit

Uma opção de kit pode aplicar um dos seus códigos de desconto da Shopify para o cliente. Por exemplo, um código para uma sacola grátis apenas no pacote de 3.

1. Crie antes o código na Shopify, em **Descontos**. Em **Combinações**, marque **Descontos de produtos** para que ele valha junto com o preço do kit (veja acima).
2. Em Supr Bundles & Subscriptions > Ofertas, abra a opção de kit, clique em **Código de desconto** em **Preço e desconto** e ative-o.
3. Digite o código e clique em **Salvar**.

Ao salvar, o app procura o código na sua loja. Um código que não existe impede o salvamento e é marcado no campo. Um código expirado ou que ainda não está ativo, ou que não se combina com descontos de produtos, é salvo com um aviso sob o campo.

* O código é adicionado ao carrinho logo depois que o cliente adiciona esta opção de kit, pela própria opção ou com o botão **Adicionar ao carrinho** da sua página de produto. Os códigos que já estão no carrinho são mantidos.
* Quando o carrinho não contém mais nada desta opção, o código é retirado. Os códigos que o cliente digitou por conta própria nunca são removidos.
* A Shopify ainda decide se o código vale: compra mínima, produtos elegíveis, limites de uso e combinações são verificados no checkout.
* Em um kit comprado por assinatura, se o código continua valendo nas renovações depende da configuração **Pagamentos recorrentes para assinaturas** do próprio código na Shopify. Defina o **Tipo de compra** dele como **Assinatura** ou **Ambos** para que ele valha para assinaturas.
* **Comprar agora** e os botões de checkout expresso pulam o carrinho, então o código não é adicionado ali. Os clientes ainda podem digitá-lo no checkout.
* O código fica visível no código-fonte da sua página de produto, então use um código que você não se importe que qualquer pessoa encontre.
* As opções de assinatura têm a mesma configuração; veja [Discount code](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/a-beginners-guide-to-subscription-offers-mpp4ps/#3-codigo-de-desconto).

### Combinando códigos de desconto com preços de kit no Shopify Plus

No plano **Shopify Plus**, um código de desconto de produto pode valer no mesmo item que um preço de kit, para que os clientes mantenham o preço do kit ou o brinde e ainda recebam o seu código. A Shopify permite isso quando os dois descontos têm tags que permitem um ao outro.

1. Acesse [**Supr Bundles & Subscriptions > Configurações > Combinações de descontos**](https://admin.shopify.com/apps/super-subscriptions/app/settings/discounts). A página só aparece em lojas Shopify Plus.
2. Ative **Permitir que descontos com tag se acumulem com o preço do kit**.
3. **Tags no preço do kit** é a tag que o app adiciona aos descontos de kit dele (**supr-bundle**, a menos que você mude). Em **Acumular com descontos com as tags**, digite a tag que você vai colocar nos seus próprios códigos, por exemplo **coupon**. Separe várias tags com vírgulas.
4. Clique em **Salvar**.
5. Em **Admin da Shopify > Descontos**, abra cada código que deve se acumular. Adicione a tag **coupon** e, em **Combinações**, marque **Descontos de produtos** e permita que descontos com a tag **supr-bundle** valham no mesmo produto. Salve o código.

|| O código precisa ser um desconto de **Valor de desconto em produtos** voltado a produtos ou coleções específicos. A Shopify só deixa descontos de produto se acumularem no mesmo item, e um código que vale para o pedido inteiro é um desconto de pedido.

Dois descontos só se acumulam quando cada um permite uma tag do outro. Se COUPON10 e COUPON15 têm a tag **coupon** e cada um permite apenas **supr-bundle**, qualquer um dos códigos se acumula com os seus preços de kit, mas os dois códigos nunca se acumulam entre si.

A Shopify calcula como os descontos acumulados se somam. Um código de 10% em uma opção **Compre X, ganhe Y**, por exemplo, pode tirar 10% do preço cheio por cima do item grátis, em vez de 10% do preço do kit. Adicione um kit e o seu código a um carrinho e confira o total antes de divulgar o código. Em uma assinatura, a configuração **Pagamentos recorrentes** do próprio código decide em quantas renovações ele vale.

### Publicação e segmentação

* Toda oferta tem um **Status** no card lateral da página dela. As novas ofertas começam como **Publicada**; escolha **Rascunho** para tirar a oferta de todos os produtos aos quais ela se aplica (os assinantes existentes continuam sendo renovados). Apenas as ofertas **Publicadas** aparecem na sua vitrine.
* Escolha a quais produtos a oferta se aplica em **Detalhes da oferta > Aplica-se a**: **Todos os produtos**, **Coleções específicas** ou **Produtos específicos**. Com produtos específicos, você pode restringir um produto a algumas das variantes dele.
* Um produto mostra as opções de kit de uma oferta. Se duas ofertas de kit se aplicam ao mesmo produto, só uma delas aparece, então mantenha uma oferta de kit por produto (ofertas limitadas a variantes diferentes do mesmo produto não têm problema).
* As ofertas que segmentam uma coleção usam os produtos que estavam nela quando você salvou pela última vez. Depois de mudar uma coleção, clique em **Atualizar** no card **Produtos das coleções** da página Ofertas.

|| A segmentação decide quais páginas de produto mostram as opções. Ela não junta produtos: uma opção de desconto por quantidade em uma oferta de toda a coleção continua sendo conquistada um produto por vez.

|| O widget precisa estar **ativado** para que os kits apareçam e funcionem na vitrine. Se [**Supr Bundles & Subscriptions > Design**](https://admin.shopify.com/apps/super-subscriptions/app/widget) mostra um botão **Ativar widget**, clique nele e depois em **Salvar** no editor de temas que abrir. As opções não aparecem por outro motivo? Veja [Bundle options are not showing on the product page](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/bundle-bars-are-not-showing-y1j0tv/).

### Usando descontos de kit com um adicionar ao carrinho personalizado

Esta seção é para desenvolvedores. Pule-a, a menos que alguém tenha criado um adicionar ao carrinho personalizado na sua loja.

Normalmente, a opção de kit adiciona os itens ao carrinho por conta própria e tudo o que está abaixo é tratado para você. Mas algumas lojas têm uma página de destino, uma seção de construtor de páginas ou um front-end headless que cria o próprio adicionar ao carrinho. O desconto do kit ainda funciona nesse caso, porque é um desconto da Shopify, e não parte do widget, mas só consegue contar o que o carrinho informa. **Um adicionar ao carrinho personalizado precisa marcar as próprias linhas, senão o desconto vai calcular errado o preço de carrinhos mistos.**

|| Um adicionar ao carrinho personalizado não tem suporte oficial. Ele funciona hoje com as propriedades abaixo, mas uma atualização futura pode exigir que o seu código mude.

**Como o desconto conta as unidades**

As unidades são contadas **por produto**, entre as linhas do carrinho que pertencem ao mesmo kit. As linhas são agrupadas pela propriedade `_bundle_block_id`, pelo produto e pela forma de compra (compra única ou em qual opção de assinatura), e o total desse grupo é comparado com a quantidade da opção. Produtos diferentes nunca se juntam, mesmo quando uma oferta cobre todos.

É por isso que o mesmo pacote de 3 pode se comportar de duas maneiras:

* **Três da mesma variante** chegam como uma linha de quantidade 3. Mesmo sem marcação, o desconto vê 3 unidades e o preço do pacote de 3 vale. Isso funciona por acaso.
* **Duas de uma variante e uma de outra** chegam como duas linhas, de quantidade 2 e quantidade 1. Sem marcação, cada linha é calculada por conta própria, então o cliente recebe o preço do pacote de 2 mais uma unidade a preço cheio. Em uma loja com um produto de R$ 16,99, um pacote de 2 por R$ 31,99 e um pacote de 3 por R$ 44,99, isso dá R$ 48,98 em vez de R$ 44,99.

Marque as duas linhas com o mesmo `_bundle_block_id` e o desconto vê um grupo de 3 unidades e cobra R$ 44,99.

**Propriedades de uma opção de desconto por quantidade ou Compre X, ganhe Y**

Envie estas em `properties` em **todas** as linhas do kit:

| Propriedade | Valor |
|---|---|
| `_bundle_block_id` | O id do kit. O mesmo valor em todas as linhas, nunca um por opção. |
| `_bundle_block_quantity` | O total de unidades do pacote selecionado, como texto, por exemplo `"3"`. |
| `_ssBundleBar` | A posição da opção na oferta, começando em 0, como texto. Deixe de fora para a opção individual. |
| `_bundle_block_name` | Opcional. O título da opção. |

Só o `_bundle_block_id` afeta o preço em uma oferta cujas opções são todas descontos por quantidade. Envie as outras mesmo assim: assim que a oferta ganha uma opção Compre X, ganhe Y, de kit fixo ou de monte seu kit, a correspondência fica mais rígida. O `_ssBundleBar` passa a indicar a opção que o comprador escolheu, para que um pacote de 2 e um "compre 1, leve 1" (ambos com duas unidades) nunca sejam confundidos, e o `_bundle_block_quantity` é conferido com o tamanho do pacote dessa opção.

Não adicione `_ssBundleGroup` a essas linhas. Uma linha que o contém é tratada como parte de um kit fixo ou de uma caixa de monte seu kit, abaixo. Uma opção Compre X, ganhe Y cuja recompensa o cliente escolhe entre outros produtos usa um conjunto diferente de propriedades, que não é coberto aqui; fale com o suporte se precisar dele.

**Propriedades de uma opção de kit fixo ou de monte seu kit**

Elas são agrupadas de outra forma e são as que devem ser usadas quando um único desconto envolve **produtos diferentes**. Envie uma linha por variante, marcada com:

| Propriedade | Valor |
|---|---|
| `_ssBundleGroup` | O id do kit. O mesmo em todas as linhas da caixa. |
| `_ssBundleBar` | A posição da opção na oferta, começando em 0, como texto. |
| `_ssBundleKey` | Um valor que você inventa para esta caixa, **idêntico em todas as linhas da caixa** e novo para cada caixa que você adiciona. |
| `_ssMixGroup` | Somente monte seu kit: o índice, começando em 0, do grupo do qual o item foi escolhido, para que o mínimo e o máximo de cada grupo sejam conferidos com o grupo certo. |
| `_bundle_block_name` | Opcional. O título da opção, exibido como o nome da caixa no portal do cliente. |

Os três valores `_ssBundleGroup`, `_ssBundleBar` e `_ssBundleKey` juntos são o que faz as linhas formarem uma caixa. Se o `_ssBundleKey` estiver errado, a caixa não é reconhecida:

* **Uma chave diferente em cada linha** divide a caixa em caixas de um item cada. Nenhuma delas está completa, então todas as linhas são cobradas a preço cheio.
* **A mesma chave em duas caixas de monte seu kit** junta as duas em uma única caixa, com preço de uma caixa: os itens além do máximo de um grupo pagam preço cheio.

O desconto confere a caixa antes de calcular qualquer preço:

* **Um kit fixo** é cobrado em conjuntos inteiros: cada produto da opção, na sua quantidade. Um conjunto em que falta um produto não ganha nada, e as unidades extras além dos conjuntos inteiros pagam preço cheio.
* **Uma caixa de monte seu kit** precisa de pelo menos o mínimo de cada grupo. Os itens além do máximo de um grupo pagam preço cheio.
* **Só contam os produtos da própria opção**: os produtos do kit fixo (e as variantes que você permitiu) ou os produtos entre os quais os clientes podem escolher em um monte seu kit (mais o próprio produto, quando a opção sempre o inclui). Qualquer outro produto com as mesmas tags é cobrado a preço cheio.

Uma linha pode ter quantidade acima de 1. Duas unidades da mesma variante podem ser uma linha de quantidade 2, ou duas linhas com propriedades idênticas, que a Shopify junta em uma de qualquer forma.

**Linhas de assinatura**

Para vender o kit por assinatura, adicione isto a **todas** as linhas, em qualquer tipo de opção:

* `selling_plan` (ao lado de `id` e `quantity`, não dentro de `properties`): o id numérico da opção de assinatura. A Shopify recusa a linha se essa opção de assinatura não cobrir a variante.
* `_ssPlanBase` (dentro de `properties`): o preço normal de compra única da variante para **uma** unidade, como um valor simples na moeda do carrinho, por exemplo `"18.99"`. Não em centavos, e não o total da linha. Pegue-o do preço da variante.

O `_ssPlanBase` importa em uma opção com preço **Preço fixo** ou **Desconto em valor**. Esses valores são preços de compra única, e uma linha de assinatura chega ao desconto já reduzida pela opção de assinatura, então, sem o `_ssPlanBase`, o desconto da assinatura se perde: uma caixa de R$ 50 com uma opção de assinatura de 5% cobra R$ 50 em vez de R$ 47,50, sem nenhum erro. Uma opção **Porcentagem de desconto** calcula o mesmo preço nos dois casos.

As configurações da própria opção continuam valendo: com **Aplicar desconto às assinaturas** desativado, uma caixa comprada por assinatura não recebe desconto de kit, e uma opção **Somente assinatura** não dá desconto a uma compra única.

**Exemplo**

Uma caixa de monte seu kit com três itens, por assinatura, enviada para `/cart/add.js` em uma única requisição. Para uma caixa de compra única, deixe de fora `selling_plan` e `_ssPlanBase`.

```json
{
  "items": [
    {
      "id": 44000000000001,
      "quantity": 2,
      "selling_plan": 700000000001,
      "properties": {
        "_ssBundleGroup": "BUNDLE_ID",
        "_ssBundleBar": "0",
        "_ssBundleKey": "box-lq3k9x-1",
        "_ssMixGroup": "0",
        "_ssPlanBase": "18.99",
        "_bundle_block_name": "Build your box"
      }
    },
    {
      "id": 44000000000002,
      "quantity": 1,
      "selling_plan": 700000000001,
      "properties": {
        "_ssBundleGroup": "BUNDLE_ID",
        "_ssBundleBar": "0",
        "_ssBundleKey": "box-lq3k9x-1",
        "_ssMixGroup": "0",
        "_ssPlanBase": "21.50",
        "_bundle_block_name": "Build your box"
      }
    }
  ]
}
```

**Encontrando os ids**

Com o widget ativado, carregue uma página de produto que a oferta segmenta e leia-os na opção renderizada: o id do kit é o atributo `data-bundle-block-id` no bloco do kit, e o índice de cada opção é o `data-tier-index` dela. O id da opção de assinatura é o id do selling plan do produto, disponível no Liquid do seu tema como [`selling_plan.id`](https://shopify.dev/docs/api/liquid/objects/selling_plan). Se o widget não estiver ativado no seu tema, fale com o suporte e procuramos os ids para você.

**O que vale a pena conferir**

* Use os nomes de propriedade exatos acima. Um nome aproximado, como `_bundle_name`, é ignorado, e a linha continua a preço cheio.
* Marcar agrupa unidades do **mesmo produto**. Dois produtos diferentes marcados com o mesmo `_bundle_block_id` ainda são contados separadamente, então um desconto por quantidade nunca é conquistado comprando um de cada dois produtos. Use uma opção de kit fixo ou de monte seu kit para um desconto que envolve produtos diferentes.
* O `_bundle_block_id` só conta em um produto ao qual a oferta se aplica. Em qualquer outro produto, ele é ignorado.
* Adicione todas as linhas de uma caixa em uma única requisição, para que o carrinho nunca fique com meia caixa.
* Agrupe os itens por variante antes de enviar, para que três de um sabor sejam uma linha de quantidade 3 em vez de três linhas de 1. A Shopify junta linhas idênticas de qualquer forma, e agrupar mantém o carrinho organizado.
* Uma opção com preço acima do que o carrinho já custa é ignorada corretamente. Um pacote de 2 de R$ 31,99 não faz nada depois que um desconto de assinatura de 10% já levou duas unidades a R$ 30,58, e isso é proposital: o desconto não vai aumentar um preço.

### Solução de problemas

* **Nada acontece na página de produto depois de criar um kit**: siga [Bundle options are not showing on the product page](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/bundle-bars-are-not-showing-y1j0tv/). As causas mais comuns são uma oferta do tipo **Assinatura** (sem opções de kit), uma oferta definida como **Rascunho**, um produto que não está em **Aplica-se a** ou o widget não ativado em **Design**.
* **Selecionar um pacote coloca apenas uma unidade no carrinho**: confira se o widget está ativado (**Design** não mostra o botão **Ativar widget**) e se você clicou em **Salvar** no editor de temas. Se está ativado, o adicionar ao carrinho do seu tema está ignorando as opções: fale com o suporte e adaptamos para o seu tema.
* **Uma opção de kit mostra Esgotado**: não há estoque suficiente para atendê-la. Reponha os produtos ou, em um kit fixo, tire o produto esgotado. Veja [Opções de kit e o seu estoque](#3-opcoes-de-kit-e-o-seu-estoque).
* **Uma opção de kit com um brinde mostra Esgotado, ou o brinde mostra Indisponível**: o produto do brinde está sem estoque. Reponha-o ou escolha o que a oferta faz em **Quando um brinde estiver esgotado**, nas configurações de **Brindes** da opção. Veja [Brindes e complementos](#3-brindes-e-complementos).
* **Um kit fixo não pode ser adicionado ao carrinho**: um produto dele está esgotado ou não está **Ativo** na sua **Loja virtual**. Reponha-o ou tire-o do kit. Veja [Kit fixo](#3-kit-fixo).
* **Uma caixa de monte seu kit abre vazia, ou com espaços vazios**: esses espaços não têm item inicial, ou o item deles está desmarcado. As caixas configuradas antes de os itens iniciais existirem começam assim. Abra a oferta e, em **Itens iniciais**, no grupo, escolha um produto para cada linha e confira se cada um está marcado, ou defina com quantas unidades de cada produto a caixa começa, e salve. Deixe espaço apenas onde você quer que os clientes escolham. Veja [Monte seu kit (BYOB)](#3-monte-seu-kit-byob).
* **Os compradores não conseguem escolher produtos em uma caixa de monte seu kit, ou um produto mostra Indisponível**: todo produto de um grupo precisa estar **Ativo** na Shopify e disponível no canal de vendas **Loja virtual**, senão a sua loja não pode vendê-lo. Um produto que você duplica na Shopify começa como **Rascunho**, então uma caixa criada com cópias não tem nada para escolher até você defini-las como Ativas. Abra cada produto na Shopify, defina o **Status** como **Ativo**, confira se ele está disponível no canal de vendas **Loja virtual** e recarregue a página de produto. Um item inicial que a sua loja não pode vender agora deixa o espaço dele vazio, em vez de colocar na caixa algo que não pode ser comprado.
* **Um produto de monte seu kit não mostra opções de assinatura na própria página**: isso é proposital. Os produtos entre os quais os clientes escolhem são vendidos por assinatura somente dentro da caixa. Para vender um deles também de forma avulsa, adicione-o aos produtos que a oferta segmenta, ou a outra oferta. Veja [Configurações adicionais da opção de kit](#3-configuracoes-adicionais-da-opcao-de-kit).
* **Um monte seu kit comprado por assinatura foi finalizado como pedido de compra única**: os produtos entre os quais os clientes escolhem entram na assinatura da oferta quando a oferta é salva, então uma caixa configurada antes dessa mudança pode estar sem eles. Faça qualquer alteração na oferta e salve, ou fale com o suporte e os adicionamos para você.
* **Um cliente não consegue adicionar dois do mesmo produto a uma caixa**: confira **Permitir que os clientes escolham o mesmo produto mais de uma vez** nesse grupo. Com ele desativado, cada produto entra uma vez, e a lista de produtos marca os que já estão na caixa como **Na sua caixa**. Veja [Monte seu kit (BYOB)](#3-monte-seu-kit-byob).
* **Um produto de monte seu kit não mostra imagem, ou mostra uma antiga**: cada item mostra a imagem da variante escolhida, se ela tiver uma; caso contrário, a **primeira** imagem do produto na Shopify. Para mudar a imagem, arraste a que você quer para a primeira posição no produto, na Shopify, e recarregue a página de produto.
* **A opção errada está pré-selecionada na vitrine**: só uma opção pode ser a padrão, então definir uma nova limpa a antiga. Reabra a oferta, clique em **Definir como padrão** na opção que você quer, salve e recarregue a página de produto. Veja [Definindo um kit como padrão](#3-definindo-um-kit-como-padrao).
* **A opção individual não está na página de produto**: as novas ofertas a mostram, mas uma oferta criada antes de ela existir a mantém oculta até você ativá-la. Abra a oferta, encontre a linha **Individual** em Opções de kit, clique no olho e salve. Veja [A opção individual](#3-a-opcao-individual).
* **As opções de kit ficam no fim da página, aparecem duas vezes ou parecem sem estilo**: veja [The subscription widget appears twice or at the bottom of the page](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/the-subscription-widget-appears-twice-or-at-the-bottom-of-the-page-21b9cb/). Em construtores de páginas, a posição pode precisar de um pequeno ajuste da nossa parte; fale com o suporte.
* **O preço de uma opção aparece como código, como `<span class=money>`**: o formato de preço do seu tema está conflitando com a opção. Fale com o suporte e corrigimos na sua loja.
* **A imagem de uma opção não é enviada**: fale com o suporte e envie a imagem pelo chat, e nós a adicionamos à opção para você.
* **O widget de assinatura desaparece em uma opção de kit**: essa opção não oferece nada para escolher, porque é **Somente compra única** ou nenhuma opção de assinatura se aplica a ela, e a linha de compra única está oculta na oferta. Mostre a linha de compra única ou aplique uma opção de assinatura a essa opção de kit. Ele também sai do caminho quando **Ocultar quando houver uma única opção** está ativado e a opção deixa só uma forma de comprar, o que é proposital: veja [Uma escolha em vez de duas](#3-uma-escolha-em-vez-de-duas).
* **A opção individual não oferece mais uma assinatura**: uma opção de assinatura da oferta está com **Restringir a opções de kit específicas** ativado e a opção individual não está marcada. Marque-a para oferecer essa assinatura também na opção individual.
* **Não há seletores de variantes em uma opção Compre X, ganhe Y**: eles só aparecem quando o produto tem mais de uma variante, e um produto cuja única opção de produto é o "Title" padrão da Shopify conta como uma variante. Confira se o produto tem opções de produto reais, como tamanho ou cor.
* **O preço de um Compre X, ganhe Y parece menor do que o esperado**: com uma assinatura selecionada, o desconto da assinatura sai primeiro e a recompensa é calculada sobre esse preço menor, então o total fica abaixo de "quantidade comprada x preço cheio". Veja [Compre X, ganhe Y](#3-compre-x-ganhe-y).
* **Uma linha de brinde mostra Grátis, mas nenhum preço riscado**: o preço é lido ao vivo da sua vitrine, então ele é deixado de fora, em vez de adivinhado, quando o produto do brinde não está disponível no mercado do cliente. Confira se o produto do brinde está publicado nesse mercado.
* **Uma unidade diferente ficou grátis do que o cliente esperava em uma opção Compre X, ganhe Y**: a recompensa sempre vai para a unidade mais barata do conjunto, então um cliente que mistura uma variante de R$ 30 e uma de R$ 20 recebe a de R$ 20 de graça. Colocar o mesmo preço em todas as variantes elimina a dúvida.
* **Um cliente esperava um desconto por comprar dois produtos diferentes**: um desconto por quantidade conta um produto por vez, então dois produtos diferentes comprados uma vez cada são duas unidades individuais, não um pacote de 2. Se você quer um desconto entre produtos diferentes, use uma opção de **kit fixo** ou de **monte seu kit**.
* **Mudar o seletor de quantidade do tema não move a opção selecionada**: a seleção só acompanha o seletor entre opções de **desconto por quantidade**. Enquanto um kit fixo, um monte seu kit, um Compre X, ganhe Y ou a opção individual está selecionado, a escolha do comprador é deixada onde está, porque essas opções são um conjunto de itens, e não um número de unidades. Veja [Desconto por quantidade](#3-desconto-por-quantidade).
* **Um sabor recebe o preço do pacote, mas um pacote misto não**: as unidades estão caindo em linhas de carrinho separadas e não estão sendo contadas juntas. Na opção de kit do próprio app, isso é tratado para você. Em um adicionar ao carrinho personalizado, significa que as linhas estão sem a propriedade `_bundle_block_id`. Veja [Usando descontos de kit com um adicionar ao carrinho personalizado](#3-usando-descontos-de-kit-com-um-adicionar-ao-carrinho-personalizado).
* **O desconto se chama "Volume discount" em vez do título da opção**: o nome no checkout vem do **Título** da opção, ou do **Nome do kit** da oferta quando a opção não tem um, como eram quando a oferta foi salva pela última vez. Dê um título à opção, salve a oferta e teste com um carrinho novo.
* **Uma caixa de um adicionar ao carrinho personalizado cobra preço cheio**: as linhas não estão sendo reconhecidas como uma caixa. Confira se todas as linhas da caixa têm os mesmos `_ssBundleGroup`, `_ssBundleBar` e `_ssBundleKey`. Se cobrar o preço de caixa de compra única em uma assinatura, falta o `_ssPlanBase` nas linhas. Veja [Usando descontos de kit com um adicionar ao carrinho personalizado](#3-usando-descontos-de-kit-com-um-adicionar-ao-carrinho-personalizado).
* **O carrinho cobra um preço diferente do que a opção mostra**: na maioria das vezes, o desconto automático de outro app está substituindo o seu preço de kit. Veja [When another discount app overrides your prices](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/how-subscription-discounts-work-1btg9f3/#3-quando-outro-app-de-descontos-sobrepoe-seus-precos).
* **O checkout diz "This order has a recurring charge for multiple items" em vez de um preço**: essa é a redação da própria Shopify, e aparece sempre que um pedido de assinatura tem mais de um item, que é o caso de uma opção com um brinde ou uma recompensa Compre X, ganhe Y. A Shopify calcula o subtotal recorrente sem o desconto do kit, então o valor que ela teria mostrado no lugar não é o que alguém paga. O detalhamento completo continua na página, e a cobrança é exatamente a que a opção diz.
* **O "Subtotal recorrente" do checkout é maior que o preço do kit**: a Shopify calcula essa linha antes dos descontos, e ela não pode ser alterada fora do Shopify Plus. O primeiro pedido é cobrado pelo preço do kit, e o app mantém esse preço na assinatura, então as renovações também são cobradas por ele.
* **Um brinde continua chegando em toda renovação**: confira a configuração do brinde na opção. **Todos os pedidos (contínuo)** se repete de propósito. **Somente o primeiro pedido** é retirado da assinatura depois que o primeiro pedido é feito, então, se um brinde configurado assim ainda se repete em uma assinatura criada antes dessa mudança, edite a assinatura e remova a linha do brinde. Veja [Brindes e complementos](#3-brindes-e-complementos).
* **O preço riscado "de" não aparece no carrinho ou no checkout**: a Shopify não exibe preços comparativos ali. Esse é um comportamento da plataforma e afeta todos os apps, não só este.

### Perguntas frequentes

**O que acontece se um cliente comprar mais do que o meu maior kit?**
Em uma oferta cujas opções são todas descontos por quantidade, ele mantém o desconto da maior opção em todas as unidades: com um pacote de 3 como sua maior opção, 4 ou 10 unidades recebem o valor do pacote de 3. Veja [Comprando mais do que a sua maior opção](#3-comprando-mais-do-que-a-sua-maior-opcao).

**Posso combinar produtos diferentes, como 3 ou 4 produtos com desconto, e deixar os clientes assinarem?**
Sim. Adicione uma opção de **Kit fixo** ou de **Monte seu kit** a uma oferta **Kit + Assinatura**. Veja [Combinando produtos diferentes em um kit](#3-combinando-produtos-diferentes-em-um-kit).

**Se um cliente adicionar os produtos do kit separadamente, ele recebe o preço do kit?**
Kits fixos, kits montados pelo cliente e ofertas Compre X, ganhe Y só são calculados quando comprados pela própria opção. Um desconto por quantidade conta unidades do mesmo produto no carrinho, então, em uma oferta cujas opções são todas descontos por quantidade, aumentar a quantidade no carrinho ainda conquista o preço do pacote.

**Como mudo o título "Bundle & Save" acima das opções?**
Abra a oferta e edite o **Nome do kit** no topo da seção **Opções de kit**. A página Design só ativa ou desativa o título e o estiliza. Para outros idiomas, use **Configurações > Traduções > Ofertas**.

**Como adiciono um selo "Mais vendido" ou mudo "Economize 10%" para o meu próprio texto?**
Abra a opção, digite o seu texto em **Selo** e depois clique em **Etiqueta de economia** na opção e escolha **Manual** para a economia. Veja [Configurações adicionais da opção de kit](#3-configuracoes-adicionais-da-opcao-de-kit).

**Os clientes podem adicionar um produto extra, como uma escova, ao comprar um kit?**
Sim, com **Complementos** na opção. São caixas de seleção opcionais com preço próprio, e são itens de compra única que não se repetem nas renovações. Veja [Brindes e complementos](#3-brindes-e-complementos).

**Posso dar um brinde apenas no primeiro pedido da assinatura?**
Sim. Adicione um brinde a uma opção e defina **O brinde vale para** como **Somente o primeiro pedido**. Veja [Brindes e complementos](#3-brindes-e-complementos).

**Os códigos de desconto funcionam por cima dos preços de kit?**
Depende da configuração **Combinações** do código na Shopify. Veja [Códigos de desconto e preços de kit](#3-codigos-de-desconto-e-precos-de-kit).

**O desconto do kit pode ser calculado a partir do preço comparativo?**
Sim, para compras únicas: marque **Calcular os descontos de kit a partir do preço comparativo** no topo de **Opções de kit**. Veja [Descontos a partir do preço comparativo](#3-descontos-a-partir-do-preco-comparativo).

**Por que o carrinho não mostra o meu preço comparativo (o preço "de")?**
A Shopify mostra os preços comparativos apenas nas páginas de produto. Se você quer que a economia apareça no carrinho e no checkout, defina o preço normal do produto como o preço cheio, remova o preço comparativo e deixe a opção de kit ou a opção de assinatura dar o desconto: ele aparece então como uma linha de desconto. A contrapartida é que lugares como o app Shop e o Google Shopping mostram o preço cheio.

### Guias relacionados

* [A Beginner's Guide to Bundles](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/a-beginners-guide-to-subscription-bundles-1ix99nf/)
* [Bundle options are not showing on the product page](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/bundle-bars-are-not-showing-y1j0tv/)
* [A Beginner's Guide to Subscription Offers](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/a-beginners-guide-to-subscription-offers-mpp4ps/)
* [Setting the default option](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/a-beginners-guide-to-subscription-offers-mpp4ps/#3-como-definir-a-opcao-padrao)
* [How subscription discounts work](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/how-subscription-discounts-work-1btg9f3/)
* [The Subscription Widget](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/the-subscription-widget-l9335l/)
* [Customer Portal Settings](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/customer-portal-settings-hymca7/)
* [Upsells](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/upsells-w393d/)