物流轨迹 (Tracking Response)

表示包裹的物流状态和历史事件轨迹。

属性

属性	类型	是否必填	描述
TrackingNumber	string	是	运单号 / 追踪号。
Status	TrackingStatus	是	当前物流状态枚举。
Events	List<TrackingEvent>	否	历史轨迹事件列表。

TrackingStatus 枚举

值	描述
Unknown	未知状态，单号不存在。
DataReceived	物流商已收到包裹信息。
InTransit	包裹运输中。
Delivered	妥投 / 包裹已送达。
DeliverFailed	派送失败。

TrackingEvent 对象

属性	类型	是否必填	描述
TimeLocal	DateTime	是	事件发生的时间 (本地时间，例如 2026-03-13T15:36:22)。
TimeUtc	DateTime	否	事件发生的时间 (UTC时间，例如 2026-03-13T19:36:22Z)。
TimezoneOffset	string	否	时区偏移量 (例如 -04:00)。
CarrierEventCode	string	否	承运商轨迹状态码。
Description	string	否	轨迹事件描述。
Location	TrackingLocation	否	轨迹事件发生的地理位置信息。

TrackingLocation 对象

属性	类型	描述
CountryCode	string	ISO 2 位国家代码。
City	string	城市名称名。
Province	string	省/州名称或代码。
Postcode	string	邮政编码。