Se sua loja permite combinar cupons, reserve um teste para a próxima atualização do WooCommerce. A versão 11.2 muda um critério de ordenação dos descontos sequenciais, e isso pode alterar o valor atribuído a cada cupom e, em alguns carrinhos, o total.
O WooCommerce 11.2 está em pré-lançamento. As notas oficiais de 21 de setembro indicam previsão para a semana de 6 de outubro de 2026. Confira o lançamento antes de programar a atualização da loja.
O que muda no cálculo
Quando a loja aplica descontos em sequência, cupons com a mesma prioridade e o mesmo limite de itens passam a seguir a ordem em que foram aplicados ao carrinho. Antes, nesse empate, o cupom de menor valor era calculado primeiro.
O alcance é específico: a configuração de descontos sequenciais precisa estar ativa. Prioridades diferentes, inclusive as definidas por extensões, e limites de itens diferentes continuam tendo precedência. A mudança não se aplica a carrinhos com cálculo não sequencial. A implementação do WooCommerce preserva esses critérios.
Um exemplo de arredondamento
Considere um único produto de R$ 12,34, sem impostos nem frete, e dois cupons percentuais, de 20% e 10%, com a mesma prioridade e o mesmo limite de itens. Com descontos sequenciais, o teste de regressão da alteração confirma:
- 20% primeiro: o desconto é de R$ 2,47. Sobre os R$ 9,87 restantes, o cupom de 10% desconta R$ 0,99. O total fica em R$ 8,88.
- 10% primeiro: o desconto é de R$ 1,23. Sobre os R$ 11,11 restantes, o cupom de 20% desconta R$ 2,22. O total fica em R$ 8,89.
Antes da alteração, as duas ordens resultavam em R$ 8,89, pois o cálculo começava pelos 10%, conforme a descrição técnica do PR.
A diferença de um centavo ilustra o arredondamento entre etapas. Ela não é uma previsão do impacto na sua loja. O resultado depende do carrinho, das regras e das extensões. Em outros casos, o total pode permanecer igual e mudar apenas a parcela de desconto de cada cupom.
O que conferir antes de atualizar
Faça a comparação em uma cópia de testes da loja, com os mesmos produtos, configurações e extensões usados na operação.
- Confira a configuração. Verifique se o cálculo sequencial está ativo e liste as combinações de cupons que seus clientes realmente usam. Anote os limites de itens e eventuais regras de prioridade de plugins.
- Registre a situação atual. Monte carrinhos representativos, incluindo produtos com centavos, quantidades diferentes e promoções em andamento. Guarde o total e o desconto de cada cupom.
- Repita na versão de teste. Remova os cupons e aplique-os novamente na mesma ordem. Depois, repita com a ordem invertida. Mantenha o restante do cenário igual.
- Confira toda a compra. Compare carrinho, finalização e pedido de teste. Inclua os cálculos de frete e impostos usados na loja e verifique se o valor enviado ao meio de pagamento corresponde ao pedido.
- Revise as campanhas. Se houver diferença, confira a regra comercial esperada e o comportamento das extensões antes de liberar a atualização em produção.
Consulte também a documentação oficial de cupons para revisar restrições de uso e limites. Guarde os resultados dos testes: eles ajudam a distinguir uma mudança esperada de um problema que precisa de correção.
Quer revisar as combinações de cupons da sua loja antes de atualizar? Converse com a AGTI.