violation_item_push

Last Updated: 20 Feb 2025

Basics

Property	Value
Category	Product Push
Push Mechanism Name	violation_item_push
Push Mechanism Code	16
Push Mechanism Description	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.
Push Mechanism Subscription Rules	ERP System/Seller In House System/Product Management/Marketing/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		Main Push message data
item_id	int64	3400133011	Shopee's unique identifier for an item.
item_name	string	test	Name of the item.
item_status	string	BANNED	Enumerated type that defines the current status of the item. Applicable values: NORMAL, BANNED, UNLIST, SELLER_DELETE, SHOPEE_DELETE, REVIEWING.
deboost	boolean	true	If deboost is true, means that the item's search ranking is lowered.
item_status_details	object[]
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
violation_reason	string	License Reason	The reason for violation.
suggestion	string	Upload license	Shopee provides you with suggestions for modifying items.
fix_deadline_time	timestamp	1705227588	Action required deadline. Empty if no deadline.
update_time	timestamp	1705054788	Latest update time.
deboost_details	object[]
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
violation_reason	string	Wrong Category	The reason for violation.
suggestion	string	The item is in wrong category, please update to the suggested_category	Shopee provides you with suggestions for modifying items.
suggested_category	object[]
category_id	int64	107478	ID for Shopee suggested category.
category_name	string	Personal Care	Default name for Shopee suggested category.
fix_deadline_time	timestamp	1705202227	Action required deadline. Empty if no deadline.
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.

1. When the item is banned by Shopee:

Java

{
    "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
}

2. When the item is deleted by Shopee:

Java

{
    "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
}

3. When the item is marked as deboost by Shopee:

Json

{
    "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
}

Update Log

Date	Update Details
2024-01-18	New Push