promotion_update_push
Last Updated: 18 Aug 2022
Basics
| Property | Value |
|---|---|
| Category | Marketing Push |
| Push Mechanism Name | promotion_update_push |
| Push Mechanism Code | 9 |
| Push Mechanism Description | Get the promotion update |
| 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 | 122406687 | Shopee's unique identifier for a shop. |
| promotion_id | int | 965808642693807 | The identity of item promotion. |
| promotion_type | string | seller_discount | The type of promotion.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 |
| end_time | timestamp | 1660123171 | Promotion end time. |
| action | string | promo_time_updated | The action of the event. Action: added_in_promo / removed_from_promo / promo_time_updated |
| item_id | int | 89526059511 | Shopee's unique identifier for an item. |
| variation_id | int | 163967197734 | Shopee's unique identifier for a variation of an item. |
| shop_id | int | 122406687 | Shopee's unique identifier for a shop. |
| code | int | 9 | Shopee's unique identifier for a push notification. |
| timestamp | timestamp | 1660123173 | Timestamp that indicates the message was sent. |
We will push messages when these three events occur：
- item is added in a promotion
- item is removed from a promotion
- promotion start /end time is updated
Push logic:
1.when item is added in a promotion:
- for reserved stock promotion（flash_sale/product_promotion），reserved_stock = reserved stock qty ；
- for non-reserved stock promotion，reserved_stock field won't return
- action = added_in_promo；
Json
{"data":{"shop_id":712661865,"promotion_id":22775521,"promotion_type":"bundle_deal","start_time":1660124460,"end_time":1661943600,"action":"added_in_promo","item_id":14662380213,"variation_id":0},"shop_id":712661865,"code":9,"timestamp":1660124466}
2.when item is removed form a promotion:
- for reserved stock promotion（FS/PP），reserved_stock = the stock qty (the latest value)；
- action= removed_from_promo；
- there is one cases when item is removed form a promotion:
item is rejected/deleted，promotion still valid, notification will return the unique item that removed from a promotion;
Json
{"data":{"shop_id":526225965,"promotion_id":668908774363077,"promotion_type":"seller_discount","action":"removed_from_promo","item_id":20332329221,"variation_id":145413438373},"shop_id":526225965,"code":9,"timestamp":1660124435}
3.when promotion start/end time is update (include upcoming and ongoing promotion):
- promotion_status = normal；
- action= promo_time_updated;
- start_time/ end_time return the updated start/end time；
- no reserved stock field
Json
{"data":{"shop_id":722406687,"promotion_id":665808642693807,"promotion_type":"seller_discount","end_time":1660123171,"action":"promo_time_updated","item_id":19526059511,"variation_id":163767197734},"shop_id":722406687,"code":9,"timestamp":1660123173}
Update Log
| Date | Update Details |
|---|---|
| 2022-08-18 | New Push Mechanism |