Pular para o conteúdo principal

Introdução

O módulo de descontos oferece uma ferramenta flexível para gerenciar a precificação em seu aplicativo. Com ele, você pode criar descontos para pedidos e produtos individuais, configurar ofertas personalizadas para grupos específicos de usuários, além de lançar programas de bônus.

Para começar, abra a seção "Descontos" no menu vertical à esquerda.

Tipos de descontos

No sistema, estão disponíveis três tipos:

Desconto

Um desconto universal que se aplica ao pedido ou a produtos individuais, desde que as condições especificadas sejam atendidas. As condições podem incluir a presença de determinados produtos ou categorias no pedido, um valor mínimo de pedido, LTV do usuário e outros. O desconto pode ser percentual, um valor fixo ou um preço fixo para o produto. Além disso, é possível configurar cupons e brindes.

Desconto Pessoal

Funciona da mesma forma que o Desconto, mas com a possibilidade adicional de restringir a aplicação do desconto a grupos específicos de usuários. Também está disponível uma condição adicional — a presença de um determinado atributo no usuário.

Bônus

Programa de concessão de bônus aos usuários. Os bônus são concedidos quando determinados eventos ocorrem — mudança de status do pedido ou envio de formulário. Os bônus acumulados podem ser utilizados pelo usuário ao finalizar um pedido.

Como os descontos são aplicados aos pedidos

Os descontos são aplicados no momento da criação ou pré-cálculo do pedido através da API:

POST /api/content/orders-storage/marker/{marker}/orders

É possível calcular previamente o resultado da aplicação dos descontos (sem criar o pedido) através do mesmo endpoint.

O desconto pode ser aplicado:

  • A um produto específico — nesse caso, a informação sobre o desconto já é visível nos endpoints /products.
  • Ao pedido como um todo — o desconto é aplicado na criação ou pré-cálculo do pedido.

As informações sobre os descontos aplicados, cupons, brindes, o custo de cada produto antes e depois do desconto, bem como o valor total do pedido, são armazenadas no campo discountConfig da resposta.

Condições dinâmicas e cupons
  • Se no desconto for definida uma condição de cupom, o desconto é aplicado apenas quando o cupom é enviado no campo couponCode da solicitação.
  • Se for definida uma condição dinâmica, o desconto é aplicado apenas quando o marcador do desconto é enviado no array additionalDiscountsMarkers da solicitação.