Amazon Services China
亚马逊商城网络服务（亚马逊 MWS）文档

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

亚马逊 MWS 文档

GetPackageTrackingDetails

返回多渠道配送订单出库货件包裹的配送追踪信息。

描述

GetPackageTrackingDetails 操作根据您指定的 PackageNumber 的值，返回出库货件中包裹的配送追踪信息。此操作返回包裹的当前追踪状态，以及追踪事件列表。

限制

GetPackageTrackingDetails 操作的最大请求限额为 30 个，恢复速率为每秒钟 2 个请求。有关限制术语的定义以及限制的完整解释，请参阅亚马逊MWS开发者指南中的限制：针对提交请求频率的限制。

请求参数

名称 描述 必填项 值
PackageNumber GetFulfillmentOrder 操作返回的不加密的包裹编号。 是 类型：xs:int

响应元素

名称 描述
PackageNumber 包裹编号。

类型：xs:int

TrackingNumber 包裹的追踪编码。

类型：xs:string

CarrierCode 承运人的名称。

类型：xs:string

CarrierPhoneNumber 承运人的电话号码。

类型：xs:string

CarrierURL 承运人网站的 URL。

类型：xs:string

ShipDate 包裹的发货日期。

类型：xs:dateTime

ShipToAddress 包裹的目的地城市。

类型：TrackingAddress

CurrentStatus 包裹的当前配送状态。

CurrentStatus 值：

  • IN_TRANSIT - 运输在途。
  • DELIVERED - 已发货至目的地地址。
  • RETURNING - 正在返回到亚马逊物流。
  • RETURNED - 已返回到亚马逊物流。
  • UNDELIVERABLE - 由于包裹丢失或破损，无法配送。
  • DELAYED - 已延迟。
  • AVAILABLE_FOR_PICKUP - 可以进行取件。
  • CUSTOMER_ACTION - 需要买家进行操作。

类型：xs:string

SignedForBy 包裹签收人的姓名。

类型：xs:string

EstimatedArrivalDate 预计送达时间。

类型：xs:dateTime

TrackingEvents 追踪事件列表。

类型：TrackingEvent列表

AdditionalLocationInfo 其他位置信息。

AdditionalLocationInfo 值：

  • AS_INSTRUCTED - 指定地址。
  • CARPORT - 车库。
  • CUSTOMER_PICKUP - 买家自提。
  • DECK - 货车车厢。
  • DOOR_PERSON - 住户。
  • FRONT_DESK - 前台。
  • FRONT_DOOR - 前门。
  • GARAGE - 车库。
  • GUARD - 住宅楼门卫。
  • MAIL_ROOM - 收发室。
  • MAIL_SLOT - 投信口。
  • MAILBOX - 邮箱。
  • MC_BOY - 男性未成年人签收。
  • MC_GIRL - 女性未成年人签收。
  • MC_MAN - 男性成年人签收。
  • MC_WOMAN - 女性成年人签收。
  • NEIGHBOR - 邻居代为签收。
  • OFFICE - 办公室。
  • OUTBUILDING - 仓库。
  • PATIO - 庭院。
  • PORCH - 门廊。
  • REAR_DOOR - 后门。
  • RECEPTIONIST - 接待员。
  • RECEIVER - 住户。
  • SECURE_LOCATION - 安全位置。
  • SIDE_DOOR - 侧门。

类型：xs:string

示例

查询请求示例

http://mws.amazonservices.com/FulfillmentOutboundShipment/2010-10-01/
  ?Action=GetPackageTrackingDetails
  &Version=2010-10-01
  &AWSAccessKeyId=AKIAJGUEXAMPLEE2NVUA
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Signature=ZRA9DR5rveSuz%2F1D18AHvoipg2BAev8yblPQ1BbEbfU%3D
  &Timestamp=2010-10-01T02:40:36Z
  &SellerId=A2NKEXAMPLEF53
  &PackageNumber=42343

响应示例

<?xml version="1.0"?>
<GetPackageTrackingDetailsResponse xmlns="http://mws.amazonaws.com/
FulfillmentOutboundShipment/2010-10-01/">
  <GetPackageTrackingDetailsResult>
    <PackageNumber>42343</PackageNumber>
    <TrackingNumber>3A18351E0390447173</TrackingNumber>
    <CarrierCode>UPS</CarrierCode>
    <CarrierPhoneNumber>206-000-0000</CarrierPhoneNumber>
    <CarrierURL>http://www.ups.com/</CarrierURL>
    <ShipDate>2012-03-09T10:27:10Z</ShipDate>
    <ShipToAddress>
      <City>Seattle</City>
      <State>WA</State>
      <Country>US</Country>
    </ShipToAddress>
    <CurrentStatus>DELIVERED</CurrentStatus>
    <SignedForBy>John</SignedForBy>
    <EstimatedArrivalDate>2012-03-09T10:00:00Z</EstimatedArrivalDate>
    <TrackingEvents>
      <member>
        <EventDate>2012-03-09T08:48:53Z</EventDate>
        <EventAddress>
          <City>Reno</City>
          <State>NV</State>
          <Country>US</Country>
        </EventAddress>
        <EventCode>EVENT_202</EventCode>
      </member>
      <member>
        <EventDate>2012-03-10T10:27:10Z</EventDate>
        <EventAddress>
          <City>Seattle</City>
          <State>WA</State>
          <Country>US</Country>
        </EventAddress>
        <EventCode>EVENT_301</EventCode>
      </member>
    </TrackingEvents>
    <AdditionalLocationInfo>FRONT_DESK</AdditionalLocationInfo>
  </GetPackageTrackingDetailsResult>
  <ResponseMetaData>
    <RequestId>5e5e5694-8e76-11df-929f-87c80302f8f6</RequestId>
  </ResponseMetaData>
</GetPackageTrackingDetailsResponse>