Ferramentas do usuário
integracao_easypromo
Diferenças
Aqui você vê as diferenças entre duas revisões dessa página.
|
integracao_easypromo [2025/06/30 12:51] rafael [Cadastrar produto] |
integracao_easypromo [2026/03/24 11:39] (atual) rafael [Regras para aplicação dos descontos] |
||
|---|---|---|---|
| Linha 153: | Linha 153: | ||
| "expires_at": null, | "expires_at": null, | ||
| "disabled_at": null, | "disabled_at": null, | ||
| + | "flash_offer_enabled": false, | ||
| "active": true, | "active": true, | ||
| "created_at": "2024-05-20T12:06:27.000000Z", | "created_at": "2024-05-20T12:06:27.000000Z", | ||
| Linha 226: | Linha 227: | ||
| <td>string</td> | <td>string</td> | ||
| <td>Data de início da promoção</td> | <td>Data de início da promoção</td> | ||
| + | </tr> | ||
| + | <tr> | ||
| + | <td>expires_at</td> | ||
| + | <td>string</td> | ||
| + | <td>Data de término da promoção</td> | ||
| + | </tr> | ||
| + | <tr> | ||
| + | <td>flash_offer_enabled</td> | ||
| + | <td>boolean</td> | ||
| + | <td>Oferta relâmpago ativa (Campo expires_at é obrigatório)</td> | ||
| </tr> | </tr> | ||
| <tr> | <tr> | ||
| Linha 242: | Linha 253: | ||
| "percent_off": 10, | "percent_off": 10, | ||
| "quantity_limit": 0, | "quantity_limit": 0, | ||
| - | "starts_at": "2024-05-22 15:45:00", | + | "starts_at": "2024-05-22 15:45:00 |
| + | "expires_at": "2024-05-23 15:45:00", | ||
| + | "flash_offer_enabled": true, | ||
| "active": true | "active": true | ||
| } | } | ||
| Linha 313: | Linha 326: | ||
| <td>string</td> | <td>string</td> | ||
| <td>Data de início da promoção</td> | <td>Data de início da promoção</td> | ||
| + | </tr> | ||
| + | <tr> | ||
| + | <td>expires_at</td> | ||
| + | <td>string</td> | ||
| + | <td>Data de término da promoção</td> | ||
| + | </tr> | ||
| + | <tr> | ||
| + | <td>flash_offer_enabled</td> | ||
| + | <td>boolean</td> | ||
| + | <td>Oferta relâmpago ativa (Campo expires_at é obrigatório)</td> | ||
| </tr> | </tr> | ||
| <tr> | <tr> | ||
| Linha 329: | Linha 352: | ||
| "percent_off": 10, | "percent_off": 10, | ||
| "quantity_limit": 0, | "quantity_limit": 0, | ||
| - | "starts_at": "2024-05-22 15:45:00", | + | "starts_at": "2024-05-22 15:45:00 |
| + | "expires_at": "2024-05-23 15:45:00", | ||
| + | "flash_offer_enabled": true, | ||
| "active": true | "active": true | ||
| } | } | ||
| Linha 434: | Linha 459: | ||
| <td>string</td> | <td>string</td> | ||
| <td>Número do cupom</td> | <td>Número do cupom</td> | ||
| + | </tr> | ||
| + | <tr> | ||
| + | <td>coupons</td> | ||
| + | <td>array</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 537: | Linha 572: | ||
| "pdv": "1", | "pdv": "1", | ||
| "coupon": "15", | "coupon": "15", | ||
| + | "coupons": [4,5,8], | ||
| + | "game_prizes": [1,2,3], | ||
| "operator": "Manu", | "operator": "Manu", | ||
| "payments": [ | "payments": [ | ||
| Linha 818: | Linha 855: | ||
| <td>number</td> | <td>number</td> | ||
| <td>Desconto total a ser aplicado no item da venda</td> | <td>Desconto total a ser aplicado no item da venda</td> | ||
| + | </tr> | ||
| + | <tr> | ||
| + | <td>coupons.id</td> | ||
| + | <td>number</td> | ||
| + | <td>ID do cupom a ser aplicado na compra</td> | ||
| + | </tr> | ||
| + | <tr> | ||
| + | <td>coupons.discount</td> | ||
| + | <td>number</td> | ||
| + | <td>Valor do desconto aplicado na compra em R$</td> | ||
| + | </tr> | ||
| + | <tr> | ||
| + | <td>game_prizes.id</td> | ||
| + | <td>number</td> | ||
| + | <td>ID da premiação obtida com jogos</td> | ||
| + | </tr> | ||
| + | <tr> | ||
| + | <td>game_prizes.discount</td> | ||
| + | <td>number</td> | ||
| + | <td>Valor do desconto aplicado na compra em R$</td> | ||
| </tr> | </tr> | ||
| </tbody> | </tbody> | ||
| Linha 859: | 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": [{ | ||
| + | "id": 4, | ||
| + | "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.1751287882.txt.gz · Última modificação: 2025/06/30 12:51 por rafael
Ferramentas da página
