• As Regras de Preço do Carrinho Avançadas ampliam as promoções nativas do Magento 2 com novos tipos de desconto que o painel padrão não oferece.
• Permitem criar campanhas como "compre o produto X e leve o produto Y com desconto", descontos no item mais caro ou mais barato do carrinho e preço fixo para um conjunto de produtos.
• Adicionam ainda condições novas (por histórico de compras do cliente e por situação do produto), além de mensagens de cupom personalizadas exibidas ao cliente no carrinho.
• Recurso para lojas Magento 2. Toda a configuração é feita na mesma tela das promoções já existentes.

#Passo a Passo por Escrito

#1. Acesse as Regras de Preço do Carrinho

No painel administrativo, acesse Marketing → Promoções → Regras de Preço do Carrinho (Cart Price Rules).

Nessa tela você vê a lista de todas as promoções de carrinho da loja. Para editar uma promoção existente, clique sobre ela. Para criar uma nova, clique no botão Adicionar Nova Regra (Add New Rule).

#2. Preencha as informações gerais da regra

No formulário da regra, preencha os campos básicos como em qualquer promoção do Magento:

1. Nome da regra (Rule Name) — nome interno para você identificar a promoção.
2. Sites (Websites) e Grupos de Clientes (Customer Groups) — onde e para quem a regra vale.
3. Cupom (Coupon) — defina se a promoção é aplicada automaticamente ou exige um código de cupom.

#3. Defina as condições da promoção

Na aba Condições (Conditions), além das condições nativas do Magento, você encontra novas opções ao clicar no botão de adicionar condição:

• Customer Attribute — permite condicionar a promoção a qualquer dado cadastral do cliente.
• Customer History — condiciona pelo histórico de compras do cliente:
  • Número Total de Pedidos — quantos pedidos o cliente já fez.
  • Valor Total de Vendas — quanto o cliente já gastou na loja.

Nas condições de produto (usadas para escolher a quais itens o desconto se aplica), há também a opção Product Extra Attribute, com:

• Tem Preço Especial — o produto está com preço promocional cadastrado.
• Tem Desconto — o produto já recebeu algum desconto no carrinho.

#4. Escolha o tipo de desconto avançado

Na aba Ações (Actions), abra o campo Aplicar (Apply). Além das opções nativas (agrupadas em Native Rules), você verá os novos tipos organizados em três grupos:

Desconto Percentual (Percent Discount) — o valor informado é um percentual:

• Discount for Most Expensive product — desconto no produto mais caro do carrinho.
• Discount for Most Cheapest product — desconto no produto mais barato.
• Discount for All except Most Expensive product — desconto em todos, exceto no mais caro.
• Discount for Cheapest products by step — desconto nos produtos mais baratos, em etapas (ex.: a cada X itens).
• Buy product X Get % discount for product Y — compre o produto X e ganhe um percentual de desconto no produto Y.

Desconto Fixo (Fixed Discount) — o valor informado é em dinheiro:

• Fixed discount for Most Expensive product — desconto fixo no produto mais caro.
• Discount for Most Cheapest product — desconto fixo no produto mais barato.
• For each $X spend, give $Y discount — a cada valor gasto, concede um valor de desconto.
• Fixed Discount for Cheapest products by step — desconto fixo nos mais baratos, em etapas.
• Buy product X Get $ discount for product Y — compre o produto X e ganhe um valor de desconto no produto Y.

Preço Fixo (Fixed Price) — o valor informado passa a ser o preço final:

• Fixed Price for All Products — define um preço fixo para todos os produtos da regra.
• Fixed Price for Cheapest Product — preço fixo para o produto mais barato.
• Fixed Price for Cheapest product by step — preço fixo para os mais baratos, em etapas.
• Buy product X Get product Y for fixed price — compre o produto X e leve o produto Y por um preço fixo.

Depois de escolher o tipo, preencha o Valor do Desconto (Discount Amount) — que será interpretado como percentual, valor em dinheiro ou preço final, conforme o grupo. Quando o tipo exige quantidade ou etapa, preencha também os campos Quantidade máxima de desconto (Discount Qty) e Passo (Discount Step).

#5. Confira a pré-visualização do tipo de desconto

Logo abaixo do campo Aplicar, o módulo exibe uma pré-visualização com exemplos de carrinho mostrando como o tipo de desconto escolhido se comporta em diferentes situações.

Use essa pré-visualização para confirmar se o comportamento é o que você espera antes de salvar a promoção.

#6. Personalize as mensagens do cupom (opcional)

Ainda no formulário da regra, na seção de informações gerais, você encontra dois campos novos:

• Mensagem de Sucesso do Cupom (Coupon Success Message) — texto exibido ao cliente quando o cupom desta promoção é aplicado com sucesso no carrinho.
• Mensagem de Erro do Cupom (Coupon Error Message) — texto exibido quando o cupom não pôde ser aplicado.

Você pode usar %1 dentro da mensagem para inserir automaticamente o código do cupom digitado. Exemplo: Cupom %1 aplicado com sucesso!.

#7. Salve a promoção e limpe o cache

Clique em Salvar Regra (Save) no topo da tela.

#Validação e Testes

Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.

Teste 1 — O novo tipo de desconto aparece na regra

Ação: acesse Marketing → Promoções → Regras de Preço do Carrinho, edite uma regra, vá até a aba Ações e abra o campo Aplicar.

Teste 2 — O desconto é aplicado no carrinho

Ação: crie uma promoção com um tipo avançado (ex.: Discount for Most Expensive product com Valor do Desconto 20), salve, limpe o cache e monte um carrinho no site que atenda às condições da regra.

Teste 3 — A mensagem de cupom personalizada é exibida

Ação: em uma promoção que exige cupom, preencha a Mensagem de Sucesso do Cupom (ex.: Cupom %1 aplicado!), salve e limpe o cache. No site, adicione produtos ao carrinho e aplique o cupom.

Se não funcionar, verifique:

• Se o cache da loja foi limpo após salvar a regra.
• Se a promoção está Ativa e dentro do período de datas (Data Inicial / Data Final).
• Se o carrinho realmente atende a todas as Condições definidas (site, grupo de cliente, produtos e histórico).
• Se o Valor do Desconto foi preenchido corretamente para o tipo escolhido (percentual, valor ou preço final).

#Observações Importantes

• Onde tudo é configurado: o módulo não adiciona uma tela própria de configuração. Todos os recursos ficam dentro de Marketing → Promoções → Regras de Preço do Carrinho, na mesma tela das promoções nativas.
• Nomes em inglês: os nomes dos tipos de desconto e dos grupos aparecem em inglês no painel. Os campos de mensagens de cupom e as condições novas (Número Total de Pedidos, Valor Total de Vendas, Tem Preço Especial, Tem Desconto) já aparecem em português.
• Condições por histórico só valem para clientes logados: para visitantes não identificados, o número de pedidos e o valor gasto são considerados zero.
• Botão Visualizar Regras: a listagem de promoções ganha o botão Visualizar Regras, que abre uma tela em formato de árvore para você acompanhar suas regras de forma organizada.
• Prioridade entre promoções: como no Magento nativo, quando várias promoções podem se aplicar, a ordem é definida pelo campo Prioridade e pela opção Descartar regras subsequentes. Avalie esses campos ao combinar promoções avançadas com as nativas.
• Sempre limpe o cache: qualquer alteração em uma regra só reflete no site após a limpeza do cache.

#Referências e Relacionados

• Regras de preço do carrinho (nativas): entenda os campos padrão de uma promoção do Magento (condições, cupom, prioridade) antes de usar os tipos avançados.
• Regras de preço de catálogo: para descontos aplicados diretamente no preço do produto (e não no carrinho), esta é a alternativa complementar.
• Configuração de cache da loja: após qualquer alteração em uma promoção, é necessário limpar o cache para que a mudança apareça no site.
• Grupos de clientes: as condições e a abrangência das promoções dependem dos grupos de clientes — esta doc ajuda a organizá-los.