(27) Thay đổi trạng thái tồn kho

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

Webhook này sẽ được kích hoạt trong một trong các trường hợp sau:

• current_inventory_status đã giảm xuống LOW_STOCK / OUT_OF_STOCK.
• TikTok Shop dự đoán available_quantity sẽ giảm xuống 0 trong X ngày.

Lưu ý: Giá trị của X có thể được cấu hình bởi hệ thống hoặc được người bán thiết lập thủ công.

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

Parameter name	Data type	Sample	Description
type	int	27	ID của webhook topic này, là 27.
tts_notification_id	string	"7327112393057371910"	ID của thông báo webhook này.
shop_id	string	"7494049642642441621"	ID của shop.
timestamp	int	1644412885	Thời điểm webhook này được kích hoạt. Unix timestamp.
data	object
└ product_id	string	"732357708734418520388"	ID của sản phẩm.
└ sku_id	string	"73235770873441823254"	ID của SKU.
└ trigger_reason	object
└└ alert_type	string	"PREDICTION"	PREDICTION: TikTok Shop dự đoán tồn kho sẽ hết hàng trong X ngày REALTIME: Tồn kho đã đạt LOW_STOCK hoặc OUT_OF_STOCK
└└ lead_days	int	21	Khi alert_type == PREDICTION, giá trị là khoảng thời gian giữa update_time và ngày dự đoán hết hàng. Khi alert_type == REALTIME, tham số này không được trả về.
└└ low_stock_threshold	int	0	Khi alert_type == REALTIME, giá trị là ngưỡng tồn kho thấp đã đạt tới. Khi alert_type == PREDICTION, tham số này không được trả về.
└ current_inventory_status	string	"LOW_STOCK"	SUFFICIENT_STOCK: được định nghĩa là có đủ tồn kho. LOW_STOCK: được định nghĩa là tồn kho khả dụng ≤ giá trị cảnh báo tồn kho OUT_OF_STOCK: được định nghĩa là có 0 tồn kho khả dụng.
└ inventory_distribution	object
└└ total_quantity	int	100	Tổng số lượng tồn kho thực tế trong các kho. total_quantity=available_quantity + creator_reserved_quantity + campaign_reserved_quantity + committed_quantity.
└└ available_quantity	int	50	Tổng số lượng SKU có sẵn để đặt hàng trong các kho.
└└ creator_reserved_quantity	int	20	Tổng số lượng SKU được dành riêng cho các creator trong các kho.
└└ campaign_reserved_quantity	int	20	Tổng số lượng SKU được dành riêng cho các campaign trong các kho.
└└ committed_quantity	int	10	Tổng số lượng SKU đã được giữ chỗ bởi các đơn hàng hiện có của khách hàng trong các kho.
└ update_time	int	1627587600	Thời điểm trạng thái thay đổi, biểu diễn dưới dạng Unix timestamp (giây).

Ví dụ sự kiện

JSONWord Wrap

{
"type": 27,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": {
"product_id": "732357708734418520388"
"sku_id": "73235770873441823254"
"trigger_reason": {
"alert_type": "PREDICTION",
"lead_days": 21
},
"current_inventory_status": "LOW_STOCK",
"inventory_distribution": {
"total_quantity": 100,
"available_quantity": 50,
"creator_reserved_quantity": 20,
"campaign_reserved_quantity": 20,
"committed_quantity": 10
},
"update_time": 1627587600
}
}