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étodoPlanearEsforçoLimites
Descontos automáticos integrados (um por tier)QualquerMinutosCada 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çõesQualquerUma horaTaxa mensal do aplicativo, regras limitadas às configurações do aplicativo
Aplicativo personalizado com uma Função de DescontoShopify Plus para aplicativos personalizados1 a 5 diasDesenvolvimento 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.

Bolsa de compras reutilizável impressa com Rotterdam 010 em um display de loja
Os níveis de volume aumentam o valor médio da ordem em produtos que as pessoas compram em quantidades múltiplas. Foto: Donald Trung Quoc Don, CC BY-SA 4.0, via Wikimedia Commons

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 usam cart.delivery-options.discounts.generate.run.
  • A função retorna operações como productDiscountsAdd, orderDiscountsAdd ou deliveryDiscountsAdd.
  • 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, chave function-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

  1. Executar shopify app dev para testar em uma loja de desenvolvimento, então shopify app deploy.
  2. Criar um desconto automático de aplicativo que use a sua Função (por exemplo, com o discountAutomaticAppCreate Mutação da API de Administração), definir a sua classe de desconto para o produto e guardar os tiers JSON em $app / function-configuration metafield:
{"tiers":[{"min":3,"percent":10},{"min":5,"percent":15},{"min":10,"percent":20}]}
  1. Defina as regras de combinação do desconto (com descontos de produto, ordem e envio) para corresponder à sua política de promoção.
  2. 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.

Entrada do Shopify em um quadro de diretório de um prédio de escritórios
As Funções de Desconto funcionam dentro do checkout da Shopify, por isso funcionam com a Extensibilidade de Checkout e o Shop Pay. Foto: Raysonho @ Open Grid Scheduler / Grid Engine, CC0, via Wikimedia Commons

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.

Fontes

Leitura relacionada