package_info_push｜快工助手

资料正文

§1 package_info_push

Get notified immediately on package information updates, including Ship By Date and Logistics Channel changes, and Return Code generation for Return To Seller scenarios (Return Code only applies to packages under the SPX Instant & Sameday channel in ID region), so you can take the necessary steps in time.

§2 Overview

Overview

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

§3 Push parameters

Push parameters

Name	Type	Sample	Description
shop_id	int64	220688102	Shopee's unique identifier for a shop.
code	int32	47	Shopee's unique identifier for a push notification.
timestamp	timestamp	1764569832	Timestamp that indicates the message was sent.
data	object
data.order_sn	string	2512017TFPB0HF	Shopee's unique identifier for an order.
data.package_number	string	OFG218268963204539	Shopee's unique identifier for the package under an order.
data.changed_fields	string[]	["ship_by_date"]	Returns value: ship_by_date, logistics_channel_id, or return_code, depending on which field has been updated. Both values will be returned if both fields have been updated.
data.old	object		Previous Ship By Date and logistics channel assigned to order.
data.old.logistics_channel_id	int64	70124	Shopee's unique identifier for the previous logistics channel assigned to the order.
data.old.ship_by_date	timestamp	1764746165	Previous Ship By Date assigned to the order.
data.old.return_code	string	""	The previous Return Code of the package.; Note: Since return_code is generated only once and will not change, this field will always be empty when return_code is pushed.
data.new	object		New Ship By Date and logistics channel assigned to order.
data.new.logistics_channel_id	int64	70124	Shopee's unique identifier for the new logistics channel assigned to the order.
data.new.ship_by_date	timestamp	1764573365	New Ship By Date assigned to the order.
data.new.return_code	string	1234	The OTP generated after the package enters the RTS (Return to Seller) process. Sellers need to provide this OTP to the driver to complete the return confirmation.; Note: This field only applies to packages under the SPX Instant& Sameday channel in ID region.
data.update_time	timestamp	1764569831	Timestamp that indicates the last time that there was a change in value of ship_by_date or logistics_channel_id.

§4 Sample

Sample

{
    "data": {
        "changed_fields": [
            "ship_by_date"
        ],
        "old": {
            "logistics_channel_id": 70124,
            "ship_by_date": 1764573365
        },
        "new": {
            "logistics_channel_id": 70124,
            "ship_by_date": 1764746165
        },
        "order_sn": "2512017TFPB0HF",
        "package_number": "OFG218268963204539",
        "update_time": 1764569831
    },
    "shop_id": 220688102,
    "code": 47,
    "timestamp": 1764569832
}

§5 Update log

Update log

Date	Change
2026-04-24	Support return_code field generation push notification
2025-12-18	New Push