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

# Caixas: bundles montados pelo cliente

> Crie caixas dinâmicas ou estáticas: o cliente escolhe o que recebe em cada entrega por um montador na sua loja, com tamanhos, descontos por volume e upsells.

Uma **caixa** é uma assinatura em que o cliente escolhe o que recebe em cada entrega. Você a cria em **Reval → Caixas**, ela é publicada como um **produto real da sua loja**, e o botão de compra dessa página leva a um **montador**: uma tela dentro do seu tema onde o cliente enche a caixa, vê o preço ao vivo e segue para o checkout. As caixas são vendidas **somente por assinatura** — não existe compra única de uma caixa.

<Note>
  Na primeira vez que você entrar depois desta atualização, a Shopify vai pedir para **re-aprovar as permissões do app**: a Reval agora precisa criar e publicar produtos para poder sincronizar cada caixa como um produto da sua loja.
</Note>

## Os dois tipos de caixa

|                    | **Dinâmica**                                                                     | **Estática**                                                      |
| ------------------ | -------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| **Preço**          | A soma do que o cliente escolhe, a preço de plano                                | Fixo por tamanho de caixa — o que ele colocar dentro não o altera |
| **Descontos**      | O % do plano «Caja dinámica», mais descontos opcionais por tamanho ou por volume | O preço do tamanho já é a oferta                                  |
| **Planos que usa** | Do tipo **«Caja dinámica»** (são criados em [Planos](/pt/lojista/planos))        | Planos padrão («Suscribí y Ahorrá»)                               |
| **Tamanho**        | Faixa livre (mín/máx), tamanhos predefinidos ou único                            | Tamanhos predefinidos ou único, cada um com o seu preço           |

***

## Criar uma caixa

A tela é um formulário em cinco passos. Uma caixa **só é salva completa** e pronta para venda — se faltar algo, o checklist final diz exatamente o quê.

<Steps>
  <Step title="Tipo e plano">
    Escolha o **tipo de caixa** e marque os **planos de assinatura** sobre os quais ela é vendida. Uma caixa estática só lista planos padrão; uma dinâmica, só planos do tipo «Caja dinámica». Com mais de um plano marcado, o cliente escolhe a frequência no montador (a primeira da lista é a inicial). Os planos de uma caixa devem ter **frequências distintas**.
  </Step>

  <Step title="Nome e produto na loja">
    O **nome** é o título do produto na Shopify e a base da URL do montador. Você pode somar uma descrição e a URL de uma imagem (envie o arquivo em Shopify → Conteúdo → Arquivos e cole o link). A imagem é enviada à Shopify **somente na primeira sincronização**: para trocá-la depois, edite o produto na Shopify.
  </Step>

  <Step title="Tamanho e preço">
    * **Faixa livre** (só dinâmicas): mínimo e máximo de produtos.
    * **Vários tamanhos predefinidos** ou **um único tamanho exato**: cada tamanho define a sua quantidade de produtos e — nas estáticas — o seu **preço fixo**, ou — nas dinâmicas — um **desconto opcional** (percentual ou valor fixo).
    * **Descontos por volume** (só dinâmicas, opcional): níveis que são ativados por quantidade de produtos ou pelo valor da caixa. O cliente vê ao vivo quanto falta para o próximo nível; se alcançar vários, é aplicado o que mais lhe convém, e um desconto fixado a um tamanho tem prioridade sobre os níveis.
  </Step>

  <Step title="Produtos">
    * **Elegíveis para a caixa**: o que o cliente pode colocar dentro (ele pode repetir o mesmo produto). Ao escolher um produto entram todas as suas variantes; remova as que não fizerem sentido.
    * **Compras únicas (upsells)**: são oferecidas no final da montagem e cobradas uma única vez — não entram no preço recorrente. Recomendamos entre 3 e 5 para não sobrecarregar.
  </Step>

  <Step title="Apresentação (opcional)">
    Por padrão usamos os nossos textos. Você pode substituir o título, o subtítulo, o título no portal do cliente, o do passo de upsells e o do desconto. Mais duas opções: **mostrar cada variante como cartão separado** (útil quando as variantes são sabores que se comparam entre si) e **ocultar o preço individual** dos produtos dentro da caixa (só o total é exibido).
  </Step>
</Steps>

Ao clicar em **Criar caixa**, o produto é criado e publicado na Shopify automaticamente. Se a sincronização falhar, a caixa fica salva e você a completa com o botão **Publicar na Shopify** — ou **Tentar sincronizar de novo**, se o produto já existia.

<Note>
  Um produto elegível **não precisa de plano próprio** para ser vendido dentro de uma caixa. Na **estática** ele é exibido a preço de tabela e o dinheiro vive no preço do tamanho; na **dinâmica**, todo elegível é precificado ao preço de tabela vigente menos o % do plano «Caja dinámica» — não é preciso criar preços por frequência.
</Note>

***

## O montador na sua loja

Cada caixa tem a sua URL: **`/apps/subscriptions/caja/<handle>`** (você a vê no cartão da caixa). Na página do produto, o bloco da Reval substitui o widget de assinatura e o "Adicionar ao carrinho" por um único botão — configurável no tema, por padrão **"Monte a sua caixa"**.

O que o cliente vê no montador:

* **Frequência** (se a caixa é vendida em mais de um plano) e **tamanho** como grades de opções.
* A grade de produtos elegíveis com seletor de variante, preço por unidade (com o preço de tabela riscado quando o plano desconta) e controles **− / +**. As variantes sem estoque aparecem desabilitadas.
* O resumo **"Sua caixa"**: subtotal, **Desconto de assinatura**, o desconto da caixa, total, a barra de progresso até o próximo nível ("Adicione mais 2 e leve 10% off") e a economia total. No mobile ele fica fixo embaixo.
* Se a caixa tem upsells, um passo final: **"Quer adicionar algo por uma única vez?"**.

O checkout mostra a caixa com o seu nome e imagem e o detalhe dos conteúdos abaixo, e **revalida tudo do lado do servidor** — elegibilidade, tamanho e preços. Se algo mudou (uma frequência descontinuada, um produto que deixou de estar disponível), o cliente volta ao montador com um aviso claro em vez de um erro.

***

## A caixa como produto na Shopify

* Caixa **estática**: uma variante real por tamanho (opção **"Tamanho"**, valores como "6 produtos"), cada uma com o preço do tamanho.
* Caixa **dinâmica**: uma única variante com um preço "a partir de" estimado, para que os cartões de coleção não mostrem \$0.
* As variantes de caixa são criadas **sem controle de estoque** — uma caixa nunca bloqueia o próprio pedido; o estoque é controlado pelos produtos de dentro.
* **Arquivar** uma caixa passa o produto para rascunho na Shopify e a retira da venda. As assinaturas existentes continuam ativas.

### Os pedidos de uma caixa

* Caixa estática: o pedido leva **a linha da caixa ao seu preço** mais uma linha em \$0 para cada conteúdo — essa é a lista de picking, e são esses SKUs que baixam o estoque.
* Caixa dinâmica: os conteúdos com os seus preços mais uma **linha em \$0 com a identidade da caixa**, para que o pedido mostre o nome e a imagem da caixa e não o primeiro produto de dentro.
* O estoque é gerenciado pela sua [política de estoque](/pt/lojista/configuracao), com uma nuance: **a caixa estática é tudo-ou-nada**. Com "Pedir só os produtos com estoque", uma estática com um item faltando simplesmente não gera o pedido daquele ciclo — um cliente nunca paga a caixa inteira e recebe uma incompleta — enquanto em uma dinâmica só as linhas sem estoque são removidas. Com "Tentar novamente no dia seguinte", qualquer item faltando difere o pedido completo nos dois tipos; com backorder (o padrão) o pedido sai completo de todo modo. Os produtos adicionais fora da caixa mantêm sempre o comportamento por linha.

***

## O que o assinante pode fazer

Pelo portal, o cliente edita a composição com **"Editar minha caixa"**: muda quantidades, adiciona ou remove produtos, troca o tamanho e vê o total projetado ao vivo. As mudanças valem **a partir da próxima entrega**. Ele também pode somar **produtos adicionais** recorrentes por fora da caixa (mesma frequência, a preço de plano — não contam para o tamanho nem para os descontos). O passo a passo está em [Gerenciar a sua assinatura](/pt/assinante/gerenciar-assinatura).

Dois comportamentos para ter em mente:

* **Janela de faturamento**: nas 24 horas anteriores à próxima cobrança o portal bloqueia a edição da caixa ("A sua próxima entrega já está em preparação"). **Você não tem esse limite**: pelo [detalhe da assinatura](/pt/lojista/assinaturas) você pode editar a composição de todo modo — a mudança vale a partir do próximo ciclo, nunca sobre uma cobrança em processo.
* **Produtos descontinuados**: se você tirar um produto da caixa, quem já o tinha **o conserva** (ele o vê como "Não é mais oferecido — você pode mantê-lo": pode diminuir a quantidade ou removê-lo, mas não aumentá-la nem adicioná-lo de novo). Se em vez disso você **excluir a variante na Shopify**, ela é removida das caixas ao salvar e os pedidos afetados saem com a tag **`Producto eliminado`** ("produto excluído" — as tags são emitidas em espanhol) — por isso vale **migrar os assinantes antes de excluir uma variante**.

***

## Limitações

* Os planos de uma caixa devem ter **frequências distintas** — o cliente escolhe por frequência.
* Uma assinatura contém **uma única caixa**; duas caixas são duas assinaturas.
* Não existe **compra única** de uma caixa: ela é sempre uma assinatura.
* A **imagem** é sincronizada com a Shopify só na primeira vez; depois ela é trocada na Shopify.
* Se mais adiante você tirar da caixa o plano com o qual um cliente assinou, esse cliente **deixa de poder editar a sua composição** (a cobrança dele segue igual).
