Discount API

A Discount API é um conjunto de ferramentas que permite o desenvolvimento de uma ampla gama de regras promocionais.

Antes de começar a ver onde e como as promoções e descontos devem ser exibidos nas lojas, vamos explicar esses termos.

  • Promoção: conjunto de propriedades e regras de negócios que descreve um comportamento. Ex: Leve 3, pague 2 em camisetas

  • Desconto: valor que é deduzido do total do carrinho porque uma promoção foi aplicada. Ex: - R$25


Promoções

As promoções vão se mostrar na loja de acordo com cada um dos seguintes tipos:

  • Line Item: aplica-se ao nível do produto.

  • Cross Items: aplica-se a todos os produtos.

  • Shipping Line: aplica-se aos custos de frete.

Line Item

Se um produto tiver uma promoção do tipo Leve 2, pague 1 ou 20% OFF comprando 2 ou mais, deve ser mostrado em:

> Lista de produtos

Para que um usuário conheça uma promoção, é necessário incluir um label no item do produto, continuando com os mesmos estilos utilizados em cada layout. O estilo CSS .label-primary poderia ajudar porque é usado na maioria dos layouts.

Se um mesmo produto tiver 2 promoções diferentes configuradas no aplicativo, no storefront vai se mostrar apenas 1. A lógica de qual será mostrada é responsabilidade do desenvolvedor do aplicativo.

Possíveis pontos de ancoragem:

  • data-store=”product-item-labels”

  • data-store=”product-item-promotion-label”

  • data-store=”product-item-offer-label”

> Detalhe do produto

O mesmo label da lista também deve ser mostrado no produto.

Como espaço adicional, abaixo do preço pode se incluir uma legenda que reforce a promoção. Caso um produto tenha um desconto progressivo por quantidade, este é o lugar para mostrá-lo. Vai se mostrar em forma de tabela, o estilo CSS .table poderia ajudar porque é usado na maioria dos layouts.

Possíveis pontos de ancoragem:

  • data-store=”product-price-...” 

  • data-store=”product-buy-button” 

  • data-store=”product-promotion-info” 

Cross item / Shipping line

Se a compra tiver alguma promoção geral, como "15% OFF em compras acima de R$500" ou algum desconto relacionado ao frete, será mostrado em:

> Carrinho de compras

Ao acessar o carrinho de compras, acima do “Subtotal” deverá ser exibida a legenda que comunica a promoção.

Possíveis pontos de ancoragem:

  • data-store=”cart-subtotal”

Descontos

Se o usuário teve um desconto pelo uso de uma promoção, vai se mostrar no carrinho de compras abaixo do subtotal da compra e respeitando a seguinte ordem:

  1. Promoções nativas da Nuvemshop

  2. Line item

  3. Cross item

  4. Shipping line

Possíveis pontos de ancoragem:

  • data-store=”cart-subtotal”