item_promotion_push
Last Updated: 1 Aug 2023
Basics
| Property | Value |
|---|---|
| Category | Marketing Push |
| Push Mechanism Name | item_promotion_push |
| Push Mechanism Code | 7 |
| Push Mechanism Description | Get the promotion update info |
| Push Mechanism Subscription Rules | Original/ERP System/Seller In House System/Product Management/Marketing/Customized APP/Swam ERP |
| Time Out Seconds | 3s |
| Sequence Guaranteed | No |
| Can Repeated Same Message | Yes |
| Retry Seconds | 300s,1800s,10800s |
Push Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| data | object | ||
| shop_id | int | 180727490 | Shopee's unique identifier for a shop. |
| item_id | int | 15183813372 | Shopee's unique identifier for an item. |
| variation_id | int | 12572585702 | Shopee's unique identifier for a variation of an item. |
| promotion_type | string | flash_sale | Promotion type：seller_discount / product_promotion_SG / product_promotion_MY / product_promotion_ID / product_promotion_VN / product_promotion_TW / product_promotion_TH / product_promotion_PH / flash_sale (contains: in_shop_flash_sale, flash_sale, brand_sale) / add_on_deal_main / add_on_deal_sub / bundle_deal / group_buy / Platform Streaming / Seller Streaming / Campaign (contains: deep_discount, platform_sale, low_price_promotion) |
| promotion_id | int | 169262197127658 | The identity of item promotion. |
| action | string | promo_cancelled | action could be one of promo\_lock\_stock, promo\_cancelled and promo\_end. |
| update_time | timestamp | 1660124045 | Promotion update time. |
| start_time | timestamp | 1660410000 | Promotion start time. |
| end_time | timestamp | 1660453200 | Promotion end time. |
| reserved_stock | int | 0 | The reserved stock set by the seller for the promotion. |
| shop_id | int | 18072749 | Shopee's unique identifier for a shop. |
| code | int | 7 | Shopee's unique identifier for a push notification. |
| timestamp | timestamp | 1660124045 | Timestamp that indicates the message was sent. |
Push will be triggered whenever an item's stock is locked/unlocked by promotion.
Push logic:
1.When the item was added in promotion, the normal stock will deduct the stock set by the promotion stock, At this time, the promotion stock is also reserved_stock.
action will return promo_lock_stock.
Json
{"data":{"shop_id":46641242,"item_id":14946910660,"variation_id":58301485734,"promotion_type":"flash_sale","promotion_id":669260829761778,"action":"promo_lock_stock","update_time":1660123421,"start_time":1660453200,"end_time":1660474800,"reserved_stock":100},"shop_id":46641242,"code":7,"timestamp":1660123421}
2.When the promotion ends or promo_cancelled, the remaining promotion stock will be added back to the normal stock. At this time, action will return promotion ends or promo_cancelled.
Json
{"data":{"shop_id":180727490,"item_id":15183813372,"variation_id":125725857023,"promotion_type":"flash_sale","promotion_id":669262197127658,"action":"promo_cancelled","update_time":1660124045,"start_time":1660410000,"end_time":1660453200,"reserved_stock":0},"shop_id":180727490,"code":7,"timestamp":1660124045}
Json
{"data":{"shop_id":498881374,"item_id":20109158685,"variation_id":87837495102,"promotion_type":"flash_sale","promotion_id":669083704356214,"action":"promo_end","update_time":1660122009,"start_time":1660114800,"end_time":1660122000,"reserved_stock":0},"shop_id":498881374,"code":7,"timestamp":1660122018}
Update Log
| Date | Update Details |
|---|---|
| 2023-08-01 | update promotion_type |
| 2022-08-18 | New Push Mechanism |