Skip to main content
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.
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.

Os dois tipos de caixa


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ê.
1

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.
2

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.
3

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.
4

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.
5

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).
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.
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.

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, 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. 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 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).