return_updates_push

Last Updated: 31 Dec 2024

Basics

Property	Value
Category	Return Push
Push Mechanism Name	return_updates_push
Push Mechanism Code	29
Push Mechanism Description	Get notified when the following fields of Return Refund change: return_status, return_solution, seller_proof_status, logistics_status
Push Mechanism Subscription Rules	ERP System/Seller In House System/Order Management/Customer Service/Ads's Service 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		Main Push message data.
order_sn	string	241128EDQ9YKJ0	Return by default. Shopee's unique serial number identifier for an order.
return_sn	string	2411280EDT4JRV5	Return by default. Shopee's unique serial number identifier for a Return Refund request.
updated_values	object[]
update_field	string	return_status	The field whose value is updated. - return_status - return_solution - seller_proof_status - logistics_status
old_value	string	JUDGING	The value before the updates.
new_value	string	PROCESSING	The value after the updates.
update_time	timestamp	1732796767	The time of the updates.
shop_id	int64	220004993	Shopee's unique identifier for a shop. Required param for most APIs.
code	int64	29	Shopee's unique identifier for a push notification.
timestamp	timestamp	1732796767	This is to indicate the timestamp of the request.

Json

{
   "data": {
       "order_sn": "241128EDQ9YKJ0",
       "return_sn": "2411280EDT4JRV5",
       "updated_values": [
           {
               "update_field": "return_status",
               "old_value": "JUDGING",
               "new_value": "PROCESSING",
               "update_time": 1732796767
           },
           {
               "update_field": "logistics_status",
               "old_value": "LOGISTICS_NOT_STARTED",
               "new_value": "LOGISTICS_PENDING_ARRANGE",
               "update_time": 1732796767
           }
       ]
   },
   "shop_id": 220004993,
   "code": 29,
   "timestamp": 1732796767
}

Update Log

Date	Update Details
2024-12-24	New Push