Ferramentas do usuário
integracao_easypromo
Diferenças
Aqui você vê as diferenças entre duas revisões dessa página.
|
integracao_easypromo [2025/08/27 20:14] 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 851: | Linha 857: | ||
| </tr> | </tr> | ||
| <tr> | <tr> | ||
| - | <td>coupons.coupon_id</td> | + | <td>coupons.id</td> |
| <td>number</td> | <td>number</td> | ||
| <td>ID do cupom a ser aplicado na compra</td> | <td>ID do cupom a ser aplicado na compra</td> | ||
| </tr> | </tr> | ||
| <tr> | <tr> | ||
| - | <td>coupons.discount_type</td> | + | <td>coupons.discount</td> |
| - | <td>string</td> | + | <td>number</td> |
| - | <td>Tipo do desconto (PERCENT ou VALUE)</td> | + | <td>Valor do desconto aplicado na compra em R$</td> |
| </tr> | </tr> | ||
| <tr> | <tr> | ||
| - | <td>coupons.value</td> | + | <td>game_prizes.id</td> |
| <td>number</td> | <td>number</td> | ||
| - | <td>Valor do desconto</td> | + | <td>ID da premiação obtida com jogos</td> |
| </tr> | </tr> | ||
| <tr> | <tr> | ||
| - | <td>coupons.is_stackable</td> | + | <td>game_prizes.discount</td> |
| - | <td>boolean</td> | + | |
| - | <td>Cupom acumulativo para mesma compra</td> | + | |
| - | </tr> | + | |
| - | <tr> | + | |
| - | <td>coupons.discount</td> | + | |
| <td>number</td> | <td>number</td> | ||
| - | <td>Valor final do desconto a ser aplicado na compra</td> | + | <td>Valor do desconto aplicado na compra em R$</td> |
| </tr> | </tr> | ||
| </tbody> | </tbody> | ||
| Linha 915: | Linha 916: | ||
| "promotion_id": 7, | "promotion_id": 7, | ||
| "price": 36.59, | "price": 36.59, | ||
| - | "final_price": 32.931000000000004, | + | "final_price": 32.93, |
| "discount": 7.318 | "discount": 7.318 | ||
| } | } | ||
| } | } | ||
| "coupons": [{ | "coupons": [{ | ||
| - | "coupon_id": 4, | + | "id": 4, |
| - | "discount_type": "PERCENT", | + | |
| - | "value": 7.5, | + | |
| - | "is_stackable": true, | + | |
| "discount": 0.75 | "discount": 0.75 | ||
| + | }, { | ||
| + | "id": 5, | ||
| + | "discount": 0.5 | ||
| + | }], | ||
| + | "game_prizes": [{ | ||
| + | "id": 10, | ||
| + | "discount": 10 | ||
| + | }, { | ||
| + | "id": 15, | ||
| + | "discount": 11 | ||
| }], | }], | ||
| } | } | ||
| + | |||
| + | |||
| + | ==== 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.1756325679.txt.gz · Última modificação: 2025/08/27 20:14 por rafael
Ferramentas da página
