Quantity Boost para Magento 2

MAGENTO 2 · PROMOÇÕES · ESCALÕES DE QUANTIDADE · REGRAS DO CARRINHO

Kowal Quantity Boost

Utilize as regras nativas do Magento para qualificar a promoção e escalões próprios para calcular o desconto. Combine a campanha com mensagens no frontend e um relatório de encomendas.

Percentagem ou valor · Prioridades e exclusões · Relatório de promoções

COMO FUNCIONA NA PRÁTICA

As regras de carrinho padrão do Magento 2 suportam bem promoções clássicas, mas têm limitações em cenários mais avançados de descontos por quantidade. O Quantity Boost resolve este problema ao adicionar um mecanismo flexível de desconto progressivo dependente do número de unidades elegíveis no carrinho.

O módulo funciona com base nas regras de carrinho nativas do Magento. Na prática, isto significa que os mecanismos existentes da plataforma continuam responsáveis pela qualificação da promoção: atividade da regra, datas de validade, grupos de clientes, cupões, condições de produtos, condições do carrinho e ordem de aplicação. O Quantity Boost ignora apenas o valor de desconto padrão definido nas regras selecionadas e substitui-o pelo seu próprio algoritmo por escalões.

O administrador pode definir escalões numa tabela dinâmica, por exemplo, a primeira unidade sem desconto, a segunda unidade com 20% de desconto e a terceira e cada uma das seguintes com 30% de desconto. O desconto é calculado sobre as unidades elegíveis dos produtos, ordenadas por preço, permitindo que o produto mais caro permaneça sem desconto e que a redução seja aplicada às posições seguintes de acordo com os pressupostos da promoção.

O Quantity Boost também suporta o controlo da interação com outras promoções. O módulo respeita a prioridade nativa das regras Magento e a configuração Discard subsequent rules, enquanto a configuração adicional Exclude Cart Price Rules permite indicar regras que devem bloquear a aplicação do desconto por quantidade.

As mensagens frontend integradas ajudam a apresentar claramente ao cliente as regras da promoção na barra superior, na página do produto, na listagem de categorias e no carrinho. O módulo também pode comunicar o escalão de portes grátis, obtendo-o a partir do método nativo Free Shipping. O aspeto das mensagens pode ser configurado separadamente para cada local de apresentação, sem modificar o código.

Para equipas de vendas e marketing, o relatório é um elemento importante. O Quantity Boost guarda campos de auditoria próprios e disponibiliza uma grelha no painel Magento, que permite analisar encomendas com desconto aplicado, valores da promoção, regras utilizadas, cupões e número de unidades elegíveis.

• Descontos progressivos por quantidade sem codificação rígida dos escalões.
• Integração com as regras de carrinho nativas do Magento 2.
• Suporte para cupões, grupos de clientes, website e condições de produtos através do mecanismo padrão do Magento.
• Possibilidade de indicar várias regras de controlo da promoção.
• Exclusão explícita de promoções através de Exclude Cart Price Rules.
• Tabela dinâmica de escalões: percentagem ou valor fixo de desconto.
• Mensagens promocionais no frontend com aspeto configurável.
• Leitura do escalão de portes grátis a partir do método nativo do Magento.
• Relatório de encomendas com desconto Quantity Boost aplicado.
• Suporte para ambientes multistore e configuração por store view.

O Quantity Boost é adequado para lojas Magento 2 que realizam promoções por quantidade e pretendem aumentar o valor do carrinho sem abdicar dos mecanismos nativos de promoção do Magento.

Utilizações típicas:

• «Compre mais, ganhe mais».
• «Segundo produto -20%, terceiro e seguintes -30%».
• Promoções sazonais em categorias selecionadas.
• Ações com cupão para grupos de clientes selecionados.
• Descontos múltiplos combinados com vouchers ou portes grátis.
• Campanhas de marketing que exigem relatório dos resultados da promoção.

O módulo permite selecionar uma ou várias regras de carrinho nativas do Magento. Estas regras definem quando a promoção está ativa e que produtos são elegíveis para o desconto.

O administrador gere os escalões numa tabela de configuração. Cada escalão contém o número da unidade, o tipo de desconto, o valor do desconto e uma etiqueta opcional.

Exemplo:

Unidade · Desconto

1 · 0%

2 · 20%

3+ · 30%

Cada escalão pode aplicar um desconto percentual ou um valor fixo de desconto. Os descontos por valor são configurados por store view e também guardados na moeda base.

O valor de desconto da regra de controlo nativa é ignorado. O módulo utiliza a regra para qualificar a promoção, mas calcula de forma autónoma o valor do desconto.

O Quantity Boost respeita as prioridades das regras Magento e a configuração de bloqueio das regras seguintes. Além disso, o administrador pode selecionar regras cuja aplicação desativa o desconto Quantity Boost.

O módulo apresenta mensagens promocionais:

• na barra superior,
• na página do produto,
• na listagem e na página de categoria,
• no carrinho.

As mensagens suportam dados dinâmicos, como o número de unidades elegíveis, o próximo desconto e o escalão de portes grátis.

Para cada local de apresentação é possível configurar separadamente a cor do texto, o fundo, a font, o padding, a margin, o contorno e uma classe CSS própria.

O relatório Marketing > Promotions > Quantity Boost mostra encomendas em que foi aplicado o desconto Quantity Boost. Isto facilita a análise da eficácia da campanha e o controlo da interação com outras promoções.

A loja lança a campanha «Descontos múltiplos 2026»:

• primeiro produto elegível sem desconto,
• segundo produto com 20% de desconto,
• terceiro e cada um dos seguintes com 30% de desconto,
• a promoção funciona apenas para categorias selecionadas,
• a promoção pode funcionar em conjunto com um voucher de 100 zł, se a configuração das regras Magento o permitir,
• o escalão de portes grátis é comunicado no carrinho.

Neste cenário, o administrador cria uma regra de carrinho Magento padrão, define nela as condições dos produtos e os grupos de clientes e, em seguida, seleciona essa regra na configuração do Quantity Boost. Os escalões de desconto são configurados diretamente no módulo.

Stores → Configuration → Kowal → Quantity Boost permite selecionar Cart Price Rules, regras de exclusão, Discount Tiers, mensagens e aspeto. As condições de produtos, cupões, website, grupos de clientes e prioridades são configurados na regra nativa do Magento.

O relatório atual encontra-se em Marketing → Promotions → Quantity Boost. Mostra encomendas, Store View, regras utilizadas, cupão, unidades elegíveis e desconto na moeda da loja e na moeda base.

A primeira unidade elegível mantém o preço integral. É bloqueado o registo de um escalão para a primeira unidade com desconto superior a zero. As unidades são ordenadas por preço base de forma decrescente.

Os valores são agregados na posição e truncados ao cêntimo antes de serem enviados para totals. Por exemplo, 20% de 79,99 zł dá 15,99 zł de desconto em vez de arredondamento para cima para 16,00 zł.

Um número Priority mais baixo significa uma regra anterior. O desconto Quantity Boost tem em conta o valor da posição após os descontos das regras anteriores; para um resultado previsível, defina prioridades diferentes.

Exclude Cart Price Rules bloqueia o desconto por quantidade quando a regra indicada foi aplicada. O escalão Free Shipping é apenas lido para as mensagens — o módulo não altera as condições nem o mecanismo de portes grátis.

O atributo quantity_boost_eligible pode ser utilizado nas condições das regras para limitar produtos. Os campos de auditoria abrangem posições de quote, encomendas, faturas e correções; o debug guarda decisões em var/log/quantity_boost.log.

Por predefinição, o frontend suporta Luma. As mensagens em Hyvä podem exigir adaptação. Antes de lançar a campanha, verifique os resultados com outras regras, variantes de produtos e moedas.

Pacote kowal/module-quantity-boost, módulo Kowal_QuantityBoost. Depois de configurar o acesso ao repositório Kowal, instale o pacote, ative o módulo, atualize o Magento e limpe a cache. Em produção, inclua a compilação e a implementação de conteúdo estático de acordo com o processo da loja.

1. Cria uma regra de controlo
Define produtos, cupão, clientes e datas no Magento.

2. Define escalões por unidades
A primeira mantém o preço integral, as seguintes recebem desconto.

3. Comunica e analisa o resultado
Verifica o carrinho, as mensagens e o relatório de encomendas.

Com os escalões 1 = 0%, 2 = 20% e 3 = 30%, a primeira unidade elegível permanece sem desconto. A segunda gera 31,98 zł e a terceira 47,97 zł de desconto.

O desconto total é de 79,95 zł na ausência de outras promoções que alterem a base. Para preços diferentes, o módulo começa pela unidade elegível mais cara.