Descontos Escaláveis da Shopify em 2026: Compre Mais, Economize Mais com Funções
Por Eoin Villarin, 2026-11-15
Como criar descontos escalonados de quantidade na Shopify após a retirada dos Scripts: opções integradas, aplicativos de desconto e uma Função de Desconto JavaScript em funcionamento com tiers de metafield.
Como crio descontos escalonados na Shopify?
Crie descontos quantitativos escalonados na Shopify com uma Função Shopify criada na API de Função de Desconto, ou com uma aplicação de desconto alimentada por Funções da Shopify App Store. A Função conta a quantidade do carrinho, escolhe o nível correspondente e retorna uma operação productDiscountsAdd. As aplicações públicas funcionam em qualquer plano; as aplicações personalizadas com Funções necessitam de Shopify Plus.
Principais conclusões
- Os Shopify Scripts deixaram de funcionar em 30 de junho de 2026, por isso descontos escalonados agora precisam de Shopify Functions.
- Descontos de produto e ordem usam o alvo cart.lines.discounts.generate.run.
- Armazenar os níveis como JSON na função de configuração metafield $app para que mudem sem um deploy.
- Aplicativos de desconto públicos funcionam em qualquer plano; aplicativos personalizados com Funções exigem Shopify Plus.
- Mostrar a tabela de níveis na página do produto para que os clientes vejam a economia antes do carrinho.
Para criar descontos escalonados por quantidade no Shopify em 2026 (por exemplo, comprar 3 e poupar 10%, comprar 5 e poupar 15%, comprar 10 e poupar 20%), use uma função Shopify construída na API de desconto de função ou um aplicativo de desconto com função do Shopify App Store. O Shopify Scripts costumava fazer isso no Shopify Plus, mas parou de funcionar em 30 de junho de 2026. Abaixo está a rota sem código, os limites dos descontos automáticos integrados do Shopify e uma função JavaScript que você pode adaptar, com níveis armazenados em um metafield para que o marketing possa alterá-los sem um deploy.
Três formas de fazer descontos escalonados no Shopify
| Método | Planear | Esforço | Limites |
|---|---|---|---|
| Descontos automáticos integrados (um por tier) | Qualquer | Minutos | Cada desconto tem um mínimo; vários tiers dependem das configurações de combinação de descontos e podem empilhar ou conflitar |
| Aplicativo de desconto alimentado por Funções | Qualquer | Uma hora | Taxa mensal do aplicativo, regras limitadas às configurações do aplicativo |
| Aplicativo personalizado com uma Função de Desconto | Shopify Plus para aplicativos personalizados | 1 a 5 dias | Desenvolvimento e manutenção; controle total |
Para um ou dois tiers simples, tente os descontos automáticos integrados primeiro. Para vários tiers, regras de etiqueta de cliente, regras de coleção ou qualquer coisa que a sua loja dependesse dos Scripts, use uma Função.
Como funciona a API de Função de Desconto
- Uma Função é um pequeno módulo WebAssembly que a Shopify executa durante o carrinho e o checkout. Pode ser escrito em JavaScript ou Rust; a Shopify recomenda Rust para carrinhos grandes.
- Descontos de produto e ordem usam o alvo
cart.lines.discounts.generate.run. Os descontos de envio usamcart.delivery-options.discounts.generate.run. - A função retorna operações como
productDiscountsAdd,orderDiscountsAddoudeliveryDiscountsAdd. - as classes de desconto (
PRODUCT,ORDER,SHIPPING) chega à entrada, para que uma Função possa verificar o que está autorizada a aplicar. - As configurações vivem em um metafield no desconto (namespace
$app, chavefunction-configuration), ler como JSON.
Etapa 1: Gerar a Função
shopify app init
cd your-app
shopify app generate extension --template discount --name tiered-discount
Escolha JavaScript quando o CLI perguntar pela linguagem. O gerador cria a pasta de extensão com uma configuração TOML, uma consulta de entrada e uma função de execução.
Etapa 2: A consulta de entrada
query CartInput {
cart {
lines {
id
quantity
}
}
discount {
discountClasses
metafield(namespace: "$app", key: "function-configuration") {
jsonValue
}
}
}
Etapa 3: A função de execução
import { DiscountClass, ProductDiscountSelectionStrategy } from '../generated/api';
const DEFAULT_TIERS = [
{ min: 3, percent: 10 },
{ min: 5, percent: 15 },
{ min: 10, percent: 20 },
];
export function cartLinesDiscountsGenerateRun(input) {
if (!input.cart.lines.length) {
return { operations: [] };
}
if (!input.discount.discountClasses.includes(DiscountClass.Product)) {
return { operations: [] };
}
const config = input.discount.metafield?.jsonValue;
const tiers = Array.isArray(config?.tiers) && config.tiers.length ? config.tiers : DEFAULT_TIERS;
const totalQuantity = input.cart.lines.reduce((sum, line) => sum + line.quantity, 0);
const tier = [...tiers].sort((a, b) => b.min - a.min).find((t) => totalQuantity >= t.min);
if (!tier) {
return { operations: [] };
}
return {
operations: [
{
productDiscountsAdd: {
selectionStrategy: ProductDiscountSelectionStrategy.First,
candidates: [
{
message: `${tier.percent}% off ${tier.min}+ items`,
targets: input.cart.lines.map((line) => ({ cartLine: { id: line.id } })),
value: { percentage: { value: String(tier.percent) } },
},
],
},
},
],
};
}
Notas: valores percentuais são Decimais e devem ser enviados como strings. Para limitar o desconto a uma coleção, adicione merchandise com inAnyCollection para a consulta de entrada e filtrar as linhas antes de contar.
Etapa 4: Implantar e criar o desconto
- Executar
shopify app devpara testar em uma loja de desenvolvimento, entãoshopify app deploy. - Criar um desconto automático de aplicativo que use a sua Função (por exemplo, com o
discountAutomaticAppCreateMutação da API de Administração), definir a sua classe de desconto para o produto e guardar os tiers JSON em$app/function-configurationmetafield:
{"tiers":[{"min":3,"percent":10},{"min":5,"percent":15},{"min":10,"percent":20}]}
- Defina as regras de combinação do desconto (com descontos de produto, ordem e envio) para corresponder à sua política de promoção.
- Testar carrinhos com 2, 3, 5 e 10 itens, produtos mistos, um código de desconto por cima e diferentes mercados.
Mostrar os níveis na página do produto
Os clientes só compram mais se conseguirem ver a oferta. Adicione uma pequena tabela de tiers sob o preço ("3+ poupar 10%, 5+ poupar 15%, 10+ poupar 20%") usando um bloco de aplicativo de tema ou um metafield no seu tema, e mostre a poupança no carrinho. Mantenha o texto da tabela igual aos tiers da Função para que o carrinho nunca discorde da página do produto.
Problemas comuns
- Desconto não se aplica: o desconto não está ativo, sua classe não inclui produto ou a função não retornou operações (verifique os logs de execução da função no painel de parceiros ou em
shopify app dev). - Empilhamento com códigos: as configurações de combinação de desconto decidem se um código se aplica por cima. Defina-as deliberadamente.
- Nível errado: certifique-se de contar a quantidade pelas linhas certas (todas as linhas, uma coleção ou um produto).
- Carrinhos grandes: carrinhos muito grandes podem atingir os limites da função em JavaScript; Rust é mais rápido se você vir falhas.
Precisa que seja construído?
Eu construo Funções da Shopify, aplicativos de desconto e extensões de UI de Checkout para lojas Shopify e Shopify Plus. Se a sua precificação escalonada parou de funcionar quando os Scripts foram retirados, leia Os Shopify Scripts pararam de funcionar: como corrigir ou veja meu Serviços de desenvolvimento do Shopify.
Perguntas frequentes
A Shopify pode fazer descontos escalonados sem uma aplicação?
Parcialmente. Pode criar um desconto automático por nível com uma quantidade mínima, mas vários níveis dependem de configurações de combinação de descontos e podem comportar-se de forma imprevisível. Uma Função ou aplicação alimentada por Funções dá níveis fiáveis.
Preciso de Shopify Plus para descontos escalonados?
Nenhuma aplicação de desconto pública que use Shopify Functions funciona em qualquer plano. Apenas uma aplicação personalizada com a sua própria Função requer Shopify Plus.
O que substituiu os Shopify Scripts para descontos escalonados?
A API de Função de Desconto. Descontos de produto e encomenda usam o alvo cart.lines.discounts.generate.run e retornam operações productDiscountsAdd ou orderDiscountsAdd.
Posso alterar níveis de desconto sem redeployar?
Sim. Armazene os níveis como JSON no metafield de configuração da função do desconto e leia-o na entrada da Função.
Os descontos escalonados podem aplicar-se apenas a uma coleção?
Sim. Consulte a mercadoria de cada linha com inAnyCollection e conte e desconta apenas as linhas nessa coleção.
Devo escrever Shopify Functions em JavaScript ou Rust?
O JavaScript é mais rápido para escrever e é suficiente para a maioria das lojas. A Shopify recomenda Rust para desempenho, especialmente com carrinhos grandes.