Chuyển tới nội dung chính

(39) Thay đổi trạng thái hoạt động

Tình huống kích hoạt

Khi một hoạt động khuyến mãi thuộc loại được chỉ định bắt đầu, hết hạn hoặc bị vô hiệu hóa, bạn sẽ nhận được webhook này. Webhook này chỉ được kích hoạt khi tất cả các điều kiện sau được đáp ứng:

  • App của bạn đã được cấp quyền scope Promotion Information.

  • Các hoạt động thuộc các loại sau:

  • FIXED_PRICE

  • DIRECT_DISCOUNT

  • SHIPPING_DISCOUNT

  • BUY_MORE_SAVE_MORE

  • FLASHSALE (Chỉ có sẵn ở các thị trường SEA: SG, TH, ID, MY, PH, VN)

  • Một trong các thay đổi trạng thái sau xảy ra:

  • Hoạt động bắt đầu: trạng thái thay đổi từ NOT_START sang ONGOING.

  • Hoạt động hết hạn: trạng thái thay đổi từ ONGOING sang EXPIRED.

  • Hoạt động bị vô hiệu hóa: trạng thái thay đổi sang DEACTIVATED.

Tham số nghiệp vụ dữ liệu

Parameter nameData TypeSampleDescription
typeint39ID của loại webhook.
tts_notification_idstring"7327112393057371910"ID của thông báo.
shop_idstring"7494049642642441621"ID của shop.
timestampint1644412885Thời điểm webhook này được kích hoạt, biểu diễn bằng Unix timestamp.
dataobject
└ activity_idstring"7136104329798256386"ID của hoạt động khuyến mãi.
└ update_timeint1644412885Thời điểm trạng thái thay đổi, biểu diễn dưới dạng Unix timestamp (giây).
└ activity_typestring"FIXED_PRICE"Loại của hoạt động khuyến mãi. Các giá trị có thể có là: * FIXED_PRICE * DIRECT_DISCOUNT * SHIPPING_DISCOUNT * BUY_MORE_SAVE_MORE * FLASHSALE (Chỉ có sẵn ở các thị trường SEA: SG, TH, ID, MY, PH, VN)
└ product_levelstring"PRODUCT"Chiều sản phẩm của hoạt động, các giá trị là: * PRODUCT * VARIATION * SHOP
└ statusstringONGOINGTrạng thái hiện tại của hoạt động khuyến mãi. Các giá trị có thể có là: * ONGOING * EXPIRED * DEACTIVATED

Ví dụ sự kiện

JSONWord Wrap

{
"type": 39,
"shop_id": "7494049642642441621",
"tts_notification_id": "7327112393057371910",
"timestamp": 1644412885,
"data": {
"activity_id": "7136104329798256386",
"update_time": 1644412885,
"activity_type": "FIXED_PRICE",
"product_level": "PRODUCT",
"status": "ONGOING"
}
}