violation_item_push｜快工助手

资料正文

§1 violation_item_push

Get notified when item status becomes BANNED or SHOPEE_DELETE, or marked as deboost, including the violation type, violation reason, suggestion and fix deadline time.

§2 Overview

Overview

Field	Value
Push code	16
Timeout (seconds)	3
Retry strategy (seconds)	300, 1800, 10800
Guaranteed delivery	No

§3 Push parameters

Push parameters

Name	Type	Sample	Description
data	object		Main Push message data
data.item_id	int64	3400133011	Shopee's unique identifier for an item.
data.item_name	string	test	Name of the item.
data.item_status	string	BANNED	Enumerated type that defines the current status of the item. Applicable values: NORMAL, BANNED, UNLIST, SELLER_DELETE, SHOPEE_DELETE, REVIEWING.
data.deboost	boolean	true	If deboost is true, means that the item's search ranking is lowered.
data.item_status_details	object[]
data.item_status_details.violation_type	string	Prohibited Listing	Violation types defined by Shopee. Applicable values: Prohibited Listing; Counterfeit and IP Infringement; Spam; Inappropriate Image; Insufficient Information; Mall Listing Improvement; Other Listing Improvement
data.item_status_details.violation_reason	string	License Reason	The reason for violation.
data.item_status_details.suggestion	string	Upload license	Shopee provides you with suggestions for modifying items.
data.item_status_details.fix_deadline_time	timestamp	1705227588	Action required deadline. Empty if no deadline.
data.item_status_details.update_time	timestamp	1705054788	Latest update time.
data.deboost_details	object[]
data.deboost_details.violation_type	string	Prohibited Listing	Violation types defined by Shopee. Applicable values: Prohibited Listing; Counterfeit and IP Infringement; Spam; Inappropriate Image; Insufficient Information; Mall Listing Improvement; Other Listing Improvement
data.deboost_details.violation_reason	string	Wrong Category	The reason for violation.
data.deboost_details.suggestion	string	The item is in wrong category, please update to the suggested_category	Shopee provides you with suggestions for modifying items.
data.deboost_details.suggested_category	object[]
data.deboost_details.suggested_category.category_id	int64	107478	ID for Shopee suggested category.
data.deboost_details.suggested_category.category_name	string	Personal Care	Default name for Shopee suggested category.
data.deboost_details.fix_deadline_time	timestamp	1705202227	Action required deadline. Empty if no deadline.
data.deboost_details.update_time	timestamp	1704943027	Latest update time.
shop_id	int64		Shopee's unique identifier for a shop.
code	int32		Shopee's unique identifier for a push notification.
timestamp	timestamp		Timestamp that indicates the message was sent.

§4 Sample

Sample

{
    "data":{
        "item_id":3903127451,
        "item_name":"MZH制造商品1",
        "item_status":"BANNED",
        "deboost":false,
        "item_status_details":[
            {
                "violation_type":"Prohibited Listing",
                "violation_reason":"License Reason",
                "suggestion":"Upload license",
                "fix_deadline_time":1705228281,
                "update_time":1705055481
            },
            {
                "violation_type":"Inappropriate Image",
                "violation_reason":"Image Reason",
                "suggestion":"Update image",
                "fix_deadline_time":1705228281,
                "update_time":1705055481
            }
        ]
    },
    "shop_id":602228340,
    "code":16,
    "timestamp":1705055481
}

{
    "data":{
        "item_id":3903127452,
        "item_name":"MZH制造商品2",
        "item_status":"SHOPEE_DELETE",
        "deboost":false,
        "item_status_details":[
            {
                "violation_type":"Prohibited Listing",
                "violation_reason":"License Reason",
                "suggestion":"Upload license",
                "fix_deadline_time":1700638193,
                "update_time":1699428593
            }
        ]
    },
    "shop_id":602228340,
    "code":16,
    "timestamp":1699428593
}

{
    "data":{
        "item_id":3603542555,
        "item_name":"MZH制造商品3",
        "item_status":"NORMAL",
        "deboost":true,
        "deboosted_details":[
            {
                "violation_type":"Inappropriate Image",
                "violation_reason":"Image Reason",
                "suggestion":"Update image",
                "fix_deadline_time":1704943027,
                "update_time":1704943027
            },
            {
                "violation_type":"Prohibited Listing",
                "violation_reason":"Wrong Category",
                "suggestion":"The item is in wrong category, please update to the suggested_category",
                "suggested_category":[
                    {
                        "category_id":100005,
                        "category_name":"Health"
                    },
                    {
                        "category_id":107478,
                        "category_name":"Personal Care"
                    }
                ],
                "fix_deadline_time":1704943027,
                "update_time":1704943027
            }
        ]
    },
    "shop_id":605748501,
    "code":16,
    "timestamp":1704943027
}

§5 Update log

Update log

Date	Change
2024-01-18	New Push