Ferramentas do usuário

Ferramentas do site


integracao_easypromo

Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

Link para esta página de comparações

integracao_easypromo [2026/01/08 14:16]
rafael [Descontos do consumidor]
integracao_easypromo [2026/03/24 11:39] (atual)
rafael [Regras para aplicação dos descontos]
Linha 464: Linha 464:
     <​td>​array</​td>​     <​td>​array</​td>​
     <​td>​Lista com os IDS dos cupons utilizados na compra</​td>​     <​td>​Lista com os IDS dos cupons utilizados na compra</​td>​
 +</tr>
 +<tr>
 +    <​td>​game_prizes</​td>​
 +    <​td>​array</​td>​
 +    <​td>​Lista com os IDS das premiações utilizadas na compra</​td>​
 </tr> </tr>
 <tr> <tr>
Linha 568: Linha 573:
       "​coupon":​ "​15",​       "​coupon":​ "​15",​
       "​coupons":​ [4,5,8],       "​coupons":​ [4,5,8],
 +      "​game_prizes":​ [1,2,3],
       "​operator":​ "​Manu",​       "​operator":​ "​Manu",​
       "​payments":​ [       "​payments":​ [
Linha 929: Linha 935:
       }],       }],
   }   }
 +
 +
 +==== Regras para aplicação dos descontos ====
 +
 +Todos os descontos do consumidor são retornados pela API de acordo com o valor da compra, seguindo os critérios abaixo:
 +
 +  - Os descontos devem ser aplicados integralmente (não é permitido uso parcial).
 +  - Os descontos retornados são determinados com base no valor total da compra, de modo que a soma dos descontos não ultrapasse esse valor.
 +  - Caso o consumidor possua mais descontos disponíveis que não sejam retornados na consulta (em função das regras acima), eles poderão ser utilizados em compras futuras.
 +  - A ordem de aplicação dos descontos é:
 +    - Promoções dos produtos
 +    - Cupons de desconto
 +    - Premiação de jogos
 +
 +Exemplos:
 +
 +1) Compra no valor de R$ 50,00 com um item na promoção com desconto de 20%, um cupom para o consumidor no valor de R$ 10 e uma premiação por jogo no valor de R$ 10,00.
 +
 +  R$ 50,00    - total da compra
 +  - R$ 4,00   - desconto do item
 +  - R$ 10,00  - cupom de desconto
 +  - R$ 10,00  - premiação por jogo
 +  --------------------------------
 +  R$ 26,00    - saldo a pagar
 +
 +2) Compra no valor de R$ 50,00 com um item na promoção com desconto de 30%, um cupom para o consumidor no valor de R$ 30 e uma premiação por jogo no valor de R$ 20,00.
 +
 +  R$ 50,00    - total da compra
 +  - R$ 6,00   - desconto do item
 +  - R$ 30,00  - cupom de desconto
 +  --------------------------------
 +  R$ 14,00    - saldo a pagar
 +
 +<note important>​Nessa situação, a premiação do jogo não irá retornar na api já que a soma dos descontos ultrapassa o valor total da compra.</​note>​
 +
 +<note important>​O mesmo vale nas situações em que o usuário tenha mais descontos a serem aplicados.</​note>​
  
 ===== Resgate de vale compras ===== ===== Resgate de vale compras =====
integracao_easypromo.1767881770.txt.gz · Última modificação: 2026/01/08 14:16 por rafael