return_updates_push｜快工助手

资料正文

§1 return_updates_push

Get notified when the following fields of Return Refund change: return_status, return_solution, seller_proof_status, logistics_status

§2 Overview

Overview

Field	Value
Push code	29
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.order_sn	string	241128EDQ9YKJ0	Return by default. Shopee's unique serial number identifier for an order.
data.return_sn	string	2411280EDT4JRV5	Return by default. Shopee's unique serial number identifier for a Return Refund request.
data.updated_values	object[]
data.updated_values.update_field	string	return_status	The field whose value is updated.; - return_status; - return_solution; - seller_proof_status; - logistics_status
data.updated_values.old_value	string	JUDGING	The value before the updates.
data.updated_values.new_value	string	PROCESSING	The value after the updates.
data.updated_values.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.

§4 Sample

Sample

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

§5 Update log

Update log

Date	Change
2024-12-24	New Push