Pular para o conteúdo principal

Desconto

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

O editor de desconto consiste nas abas Dados básicos, Atributos, Condições, Desconto, Cupons, Presentes, Exclusões e Histórico de Versões. Na aba Atributos, é possível selecionar um conjunto de atributos para o desconto (Selecionando um conjunto de atributos), e na aba Histórico de Versões é armazenado o histórico de alterações do desconto. As outras abas estão descritas abaixo.

Informações Gerais​

Ao criar um desconto, preencha os campos principais:

  • Nome — o nome do desconto a ser exibido na interface.
  • Marcador — campo obrigatório. Uma string única identificadora para uso no código do aplicativo.
  • Tipo — Descontos (desconto), Descontos Pessoais (desconto pessoal) ou Bônus (bônus).

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

  • Data de Início — campo obrigatório. A 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çãoDescrição
ProdutoO desconto é aplicado se o pedido contém o produto especificado
CategoriaO desconto é aplicado se o pedido contém um produto da categoria especificada
Atributo do ProdutoO 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âmica)Semelhante à condição "Categoria", mas requer a passagem do marcador do desconto em additionalDiscountsMarkers
Valor Mínimo do PedidoO desconto é aplicado apenas ao atingir o valor mínimo especificado do pedido
LTV do UsuárioO 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​

Na aba Desconto, 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. Esta opção aparece apenas se no campo Aplicação for selecionado Ao produto.

  • 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). O valor 0 significa sem limite.

  • Aplicação:

    • Ao produto — o desconto é exibido no nível do produto e visível nos endpoints /products se todas as condições forem 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 nome arbitrário, que pode ser usado um número ilimitado de vezes. Símbolos permitidos: letras latinas, números, - e _; comprimento — de 3 a 50 caracteres. Na lista de cupons adicionados, esse cupom é marcado como Reutilizável.

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.

Além da máscara, indique a quantidade de cupons — não mais que 100 por solicitação.

Escape de Símbolos

Se precisar deixar o símbolo A ou 9 no código do cupom literalmente, coloque uma barra invertida antes dele: \A, \9. Por exemplo, a máscara PROMO\9-AAA-999 criará cupons do tipo PROMO9-XYZ-123.

A máscara deve conter no mínimo 5 símbolos especiais (A ou 9; os escapados não contam) e não deve ter mais de 20 caracteres. Além deles, na máscara são permitidas letras latinas, números, -, _ e /.

Os cupons gerados são de uso único: na lista, cada um mostra se foi utilizado ou não.

Ao pré-calcular um pedido com um cupom de uso único, o desconto será exibido, mas o cupom não será utilizado. Ao criar um 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 é selecionado da lista de produtos.
  • Substituir itens do carrinho por presentes — a caixa de seleção determina o que acontece se o cliente adicionar ao pedido o mesmo produto que é um presente:
    • Ativado — o produto no pedido se torna gratuito (substituído pelo presente).
    • Desativado — o produto permanece pago, e um novo item do mesmo produto com preço 0 é adicionado ao pedido (como presente).

Exclusões​

Na aba Exclusões, é possível indicar produtos que serão excluídos das condições do desconto (condições "Produto", "Categoria" e suas variantes dinâmicas). A categoria e os atributos nesta aba servem apenas como filtro para a seleção de produtos — não é possível excluir a categoria inteira. Os produtos da lista de exclusões não serão considerados na verificação das condições.