Desconto

O tipo Desconto é um desconto básico que é aplicado ao pedido ou a produtos individuais, desde que as condições especificadas sejam atendidas.

Informações Gerais

Ao criar um desconto, preencha os campos principais:

• Nome — nome do desconto para exibição na interface.
• Marcador — campo obrigatório. Uma string única identificadora para uso no código do aplicativo.
• Tipo — desconto geral ou pessoal.

Após a criação, dentro do desconto, é necessário especificar adicionalmente:

• Data de início — campo obrigatório. Data a partir da qual o desconto começa a ser válido.
• Data de término — campo opcional. Se não especificada, o desconto é válido por tempo indeterminado.

Condições

As condições definem quando o desconto será aplicado. Várias condições podem ser combinadas pela regra E (todas as condições devem ser atendidas) ou OU (basta uma).

Condição	Descrição
Produto	O desconto é aplicado se o pedido contém o produto especificado
Categoria	O desconto é aplicado se o pedido contém um produto da categoria especificada
Atributo do produto	O desconto é aplicado se o pedido contém um produto com atributos específicos
Produto (dinâmico)	Semelhante à condição "Produto", mas requer a passagem do marcador do desconto em additionalDiscountsMarkers
Categoria (dinâmico)	Semelhante à condição "Categoria", mas requer a passagem do marcador do desconto em additionalDiscountsMarkers
Valor mínimo do pedido	O desconto é aplicado apenas quando o valor do pedido atinge o valor especificado
LTV do usuário	O desconto é aplicado com base no valor total dos pagamentos do usuário

Valor mínimo do pedido

Se outros descontos já estão aplicados aos produtos no pedido, o valor mínimo é calculado após a aplicação dos descontos nos produtos.

Por exemplo: o valor mínimo para o desconto é 1000 ₽. No pedido, há 10 produtos a 100 ₽ = 1000 ₽. Mas para cada produto, há um desconto de 5%, o valor total do pedido é 950 ₽. Como 950 < 1000, o desconto para o pedido inteiro não é aplicado.

Aplicação

Configure como o desconto será calculado:

• Tipo de desconto:

  • Sem desconto — o desconto não é aplicado.
  • Porcentagem do valor do produto/pedido — o desconto é calculado como uma porcentagem.
  • Valor fixo de desconto — redução de preço fixa.
  • Preço fixo — o produto terá o preço fixo especificado.

• Valor — valor numérico do desconto de acordo com o tipo escolhido.

• Valor máximo — relevante para o tipo percentual. Define o valor máximo que o desconto pode atingir. A fórmula aplicada é: min(valor calculado, valor máximo).

• Aplicação:

  • Ao produto — o desconto é exibido no nível do produto e visível nos endpoints /products quando todas as condições são atendidas.
  • Ao pedido — o desconto é aplicado ao criar ou pré-calcular o pedido.

Cupons

Cupons podem ser vinculados ao desconto. O desconto com cupom é aplicado apenas quando o código do cupom é passado no campo couponCode da solicitação.

Cupom manual

Cupom com um nome arbitrário, que pode ser usado um número ilimitado de vezes. Símbolos permitidos: letras latinas, números, - e _.

Geração de cupom

Geração de cupons com base em uma máscara, onde:

• A — substituído por uma letra aleatória
• 9 — substituído por um número aleatório

Por exemplo, a máscara AAAA-9999 criará cupons do tipo XKBM-4721.

Escapando símbolos

Se for necessário deixar o símbolo A ou 9 no código do cupom literalmente, ele pode ser escapado.

A máscara deve conter no mínimo 5 símbolos especiais (A ou 9).

Ao pré-calcular o pedido com um cupom de uso único, o desconto será mostrado, mas o cupom não será utilizado. Ao criar o pedido, o cupom é marcado como utilizado e não funcionará novamente.

Presentes

É possível adicionar presentes ao desconto — produtos que aparecerão no pedido com preço 0.

• Produto-presente é escolhido a partir da lista de produtos.
• Comportamento em caso de coincidência — se o cliente adicionou ao pedido o mesmo produto que é um presente, a configuração determina o comportamento:
  • O produto permanece pago, e mais uma unidade do mesmo produto é adicionada ao pedido com preço 0 (como presente).
  • O produto no pedido se torna gratuito (substituído por um presente).

Exceções

É possível especificar produtos ou categorias que serão excluídos das condições do desconto (condições "Produto", "Categoria" e suas variantes dinâmicas). Produtos ou categorias da lista de exclusões não serão considerados na verificação das condições.