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 文档

GetFulfillmentPreview

根据您指定的配送条件返回配送订单预览列表。

描述

GetFulfillmentPreview 操作根据您指定的配送条件返回配送订单预览列表。每个配送订单预览都包含潜在配送订单的预计配送重量和预计配送费用,以及潜在配送订单中单个货件的发货日期、到货日期和预计的配送重量。在日本,GetFulfillmentPreview 操作会选择性地返回多渠道配送订单的配送计划时间范围。此操作还提供关于配送订单预览中无法配送商品的信息。

注: 如果入库货件的状态为 WORKINGSHIPPED,则亚马逊会认为该入库货件中的商品是可配送商品。即,GetFulfillmentPreview 操作可返回尚未到达亚马逊配送中心的可配送商品的预计重量和运费。因此,状态为 WORKINGSHIPPED 的入库货件中商品的预计重量和运费通常是错误的。

限制

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

请求参数

名称 描述 必填项
Address 配送订单预览的目的地地址。 类型:Address
Items 配送订单预览中各商品的识别信息和数量信息。 类型:GetFulfillmentPreviewItem列表
ShippingSpeedCategories 用于创建配送订单预览的配送方式列表。 ShippingSpeedCategories 值:
  • Standard - 标准配送方式。
  • Expedited - 加急配送方式。
  • Priority - 优先配送方式。
  • ScheduledDelivery - 预约送货上门配送方式。预约送货上门仅适用于日本 (JP)。如需更多信息,请参阅计划配送
注: 各商城的配送方式服务水平协议有所不同。查看您所在商城的亚马逊卖家平台网站以了解配送方式服务水平协议和配送费用。
默认值:All

类型:类型列表:xs:string

IncludeCODFulfillmentPreview 指明是否返回货到付款 (COD) 配送订单预览。 IncludeCODFulfillmentPreview 值:
  • true - 返回所有配送订单预览(货到付款和非货到付款)。
  • false - 只返回非货到付款配送订单预览。

默认值:false

注: IncludeCODFulfillmentPreview 请求参数只适用于中国 (CN) 和日本 (JP)。在其他所有商城中,服务将忽略 IncludeCODFulfillmentPreview 请求参数。

类型:xs:boolean

IncludeDeliveryWindows 指明是否返回 ScheduledDeliveryInfo 响应元素,该响应元素包含计划配送的可用配送时间范围。只能为 ShippingSpeedCategories = ScheduledDelivery 的配送订单预览返回 ScheduledDeliveryInfo IncludeDeliveryWindows 值:
  • true - 返回 ScheduledDeliveryInfo 响应元素。
  • false – 不返回 ScheduledDeliveryInfo 响应元素。
注: IncludeDeliveryWindows 请求参数只适用于日本 (JP)。在其他所有商城中,服务将忽略 IncludeDeliveryWindows 请求参数。

关于计划配送的更多信息,请参阅计划配送

默认值:false

类型:xs:boolean

响应元素

名称 描述
FulfillmentPreviews 配送订单预览列表,包括预计配送重量、预计配送费用,以及预计发货日期和到货日期。

类型:FulfillmentPreview列表

示例

查询请求示例

http://mws.amazonservices.jp/FulfillmentOutboundShipment/2010-10-01/
  ?Action=GetFulfillmentPreview
  &Version=2010-10-01
  &AWSAccessKeyId=AKIAJGUEXAMPLEE2NVUA
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Signature=ZRA9DR5rveSuz%2F1D18AHvoipg2BAev8yblPQ1BbEbfU%3D
  &Timestamp=2014-01-02T02:40:36Z
  &SellerId=A2NKEXAMPLEF53
  &ShippingSpeedCategories.1=Expedited
  &ShippingSpeedCategories.2=Standard
  &ShippingSpeedCategories.3=ScheduledDelivery  
  &Address.Name=Amazon%20Taro
  &Address.Line1=Meguro-ku%20Shimomeguro%2012-34-56
  &Address.Line2=XXX%20building%20101
  &Address.StateOrProvinceCode=Tokyo
  &Address.PostalCode=1500002
  &Address.CountryCode=JP
  &IncludeCODFulfillmentPreview=true
  &IncludeDeliveryWindows=true  
  &Items.member.1.Quantity=1
  &Items.member.1.SellerFulfillmentOrderItemId=TestId1
  &Items.member.1.SellerSKU=SampleSKU1
  &Items.member.2.Quantity=2
  &Items.member.2.SellerFulfillmentOrderItemId=TestId2
  &Items.member.2.SellerSKU=SampleSKU2

响应示例

<?xml version="1.0"?>
  <GetFulfillmentPreviewResponse xmlns="http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/">
    <GetFulfillmentPreviewResult>
      <FulfillmentPreviews>
        <member>
          <EstimatedShippingWeight>
            <Unit>kilograms</Unit>
            <Value>12</Value>
          </EstimatedShippingWeight>
          <ShippingSpeedCategory>Expedited</ShippingSpeedCategory>
          <FulfillmentPreviewShipments>
            <member>
              <LatestShipDate>2014-01-04T00:30:00Z</LatestShipDate>
              <LatestArrivalDate>2014-01-06T06:59:59Z</LatestArrivalDate>
              <FulfillmentPreviewItems>
                <member>
                  <EstimatedShippingWeight>
                    <Unit>kilograms</Unit>
                    <Value>10</Value>
                  </EstimatedShippingWeight>
                  <SellerSKU>SampleSKU1</SellerSKU>
                  <SellerFulfillmentOrderItemId>
                  mws-test-query-20100713023406723-2
                  </SellerFulfillmentOrderItemId>
                  <ShippingWeightCalculationMethod>Package
                  </ShippingWeightCalculationMethod>
                  <Quantity>2</Quantity>
                </member>
                <member>
                  <EstimatedShippingWeight>
                    <Unit>kilograms</Unit>
                    <Value>2</Value>
                  </EstimatedShippingWeight>
                  <SellerSKU>SampleSKU2</SellerSKU>
                  <SellerFulfillmentOrderItemId>
                  mws-test-query-20100713023406723-1
                  </SellerFulfillmentOrderItemId>
                  <ShippingWeightCalculationMethod>Package
                  </ShippingWeightCalculationMethod>
                  <Quantity>1</Quantity>
                </member>
              </FulfillmentPreviewItems>
              <EarliestShipDate>2014-01-04T00:30:00Z</EarliestShipDate>
              <EarliestArrivalDate>2014-01-05T07:00:00Z
              </EarliestArrivalDate>
            </member>
          </FulfillmentPreviewShipments>
          <EstimatedFees>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>225</Value>
              </Amount>
              <Name>FBAPerUnitFulfillmentFee</Name>
            </member>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>475</Value>
              </Amount>
              <Name>FBAPerOrderFulfillmentFee</Name>
            </member>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>660</Value>
              </Amount>
              <Name>FBATransportationFee</Name>
            </member>
          </EstimatedFees>
          <UnfulfillablePreviewItems/>
          <IsFulfillable>true</IsFulfillable>
          <IsCODCapable>false</IsCODCapable>
        </member>
        <member>
          <EstimatedShippingWeight>
            <Unit>kilograms</Unit>
            <Value>12</Value>
          </EstimatedShippingWeight>
          <ShippingSpeedCategory>Standard</ShippingSpeedCategory>
          <FulfillmentPreviewShipments>
            <member>
              <LatestShipDate>2014-01-04T00:30:00Z</LatestShipDate>
              <LatestArrivalDate>2014-07-09T06:59:59Z</LatestArrivalDate>
              <FulfillmentPreviewItems>
                <member>
                  <EstimatedShippingWeight>
                    <Unit>kilograms</Unit>
                    <Value>10</Value>
                  </EstimatedShippingWeight>
                  <SellerSKU>SampleSKU1</SellerSKU>
                  <SellerFulfillmentOrderItemId>
                  mws-test-query-20100713023406723-2
                  </SellerFulfillmentOrderItemId>
                  <ShippingWeightCalculationMethod>Package
                  </ShippingWeightCalculationMethod>
                  <Quantity>2</Quantity>
                </member>
                <member>
                  <EstimatedShippingWeight>
                    <Unit>kilograms</Unit>
                    <Value>2</Value>
                  </EstimatedShippingWeight>
                  <SellerSKU>SampleSKU2</SellerSKU>
                  <SellerFulfillmentOrderItemId>
                  mws-test-query-20100713023406723-1
                  </SellerFulfillmentOrderItemId>
                  <ShippingWeightCalculationMethod>Package
                  </ShippingWeightCalculationMethod>
                  <Quantity>1</Quantity>
                </member>
              </FulfillmentPreviewItems>
              <EarliestShipDate>2014-01-04T00:30:00Z</EarliestShipDate>
              <EarliestArrivalDate>2014-01-05T07:00:00Z
              </EarliestArrivalDate>
            </member>
          </FulfillmentPreviewShipments>
          <EstimatedFees>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>225</Value>
              </Amount>
              <Name>FBAPerUnitFulfillmentFee</Name>
            </member>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>475</Value>
              </Amount>
              <Name>FBAPerOrderFulfillmentFee</Name>
            </member>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>660</Value>
              </Amount>
              <Name>FBATransportationFee</Name>
            </member>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>315</Value>
              </Amount>
              <Name>FBAFulfillmentCODFee</Name>
            </member>
          </EstimatedFees>
          <UnfulfillablePreviewItems/>
          <IsFulfillable>true</IsFulfillable>
          <IsCODCapable>true</IsCODCapable>
        </member>
        <member>
          <EstimatedShippingWeight>
            <Unit>kilograms</Unit>
            <Value>12</Value>
          </EstimatedShippingWeight>
          <ShippingSpeedCategory>ScheduledDelivery</ShippingSpeedCategory>
          <ScheduledDeliveryInfo>
            <DeliveryTimeZone>Asia/Tokyo</DeliveryTimeZone>
            <DeliveryWindows>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-04T23:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-05T03:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-05T03:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-05T05:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-05T05:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-05T07:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-05T07:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-05T09:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-05T09:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-05T11:00:00Z</EndDateTime>
                </DeliveryWindow>
                </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-05T11:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-05T12:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-05T23:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-06T03:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-06T03:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-06T05:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-06T05:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-06T07:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-06T07:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-06T09:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-06T09:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-06T11:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
              <member>
                <DeliveryWindow>
                  <StartDateTime>2014-01-06T11:00:00Z</StartDateTime>
                  <EndDateTime>2014-01-06T12:00:00Z</EndDateTime>
                </DeliveryWindow>
              </member>
            </DeliveryWindows>
          </ScheduledDeliveryInfo>
          <FulfillmentPreviewShipments>
            <member>
              <LatestShipDate>2014-01-04T00:30:00Z</LatestShipDate>
              <LatestArrivalDate>2014-01-06T06:59:59Z</LatestArrivalDate>
              <FulfillmentPreviewItems>
                <member>
                  <EstimatedShippingWeight>
                    <Unit>kilograms</Unit>
                    <Value>10</Value>
                  </EstimatedShippingWeight>
                  <SellerSKU>SampleSKU1</SellerSKU>
                  <SellerFulfillmentOrderItemId>
                  mws-test-query-20100713023406723-2
                  </SellerFulfillmentOrderItemId>
                  <ShippingWeightCalculationMethod>Package
                  </ShippingWeightCalculationMethod>
                  <Quantity>2</Quantity>
                </member>
                <member>
                  <EstimatedShippingWeight>
                    <Unit>kilograms</Unit>
                    <Value>2</Value>
                  </EstimatedShippingWeight>
                  <SellerSKU>SampleSKU2</SellerSKU>
                  <SellerFulfillmentOrderItemId>
                  mws-test-query-20100713023406723-1
                  </SellerFulfillmentOrderItemId>
                  <ShippingWeightCalculationMethod>Package
                  </ShippingWeightCalculationMethod>
                  <Quantity>1</Quantity>
                </member>
              </FulfillmentPreviewItems>
              <EarliestShipDate>2014-01-04T00:30:00Z</EarliestShipDate>
              <EarliestArrivalDate>2014-01-05T07:00:00Z
              </EarliestArrivalDate>
            </member>
          </FulfillmentPreviewShipments>
          <EstimatedFees>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>225</Value>
              </Amount>
              <Name>FBAPerUnitFulfillmentFee</Name>
            </member>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>475</Value>
              </Amount>
              <Name>FBAPerOrderFulfillmentFee</Name>
            </member>
            <member>
              <Amount>
                <CurrencyCode>JPY</CurrencyCode>
                <Value>660</Value>
              </Amount>
              <Name>FBATransportationFee</Name>
            </member>
          </EstimatedFees>
          <UnfulfillablePreviewItems/>
          <IsFulfillable>true</IsFulfillable>
          <IsCODCapable>false</IsCODCapable>
        </member>
      </FulfillmentPreviews>
    </GetFulfillmentPreviewResult>
    <ResponseMetadata>
      <RequestId>f4c29ec4-ceb7-4608-a764-5c758ac0021a</RequestId>
    </ResponseMetadata>
  </GetFulfillmentPreviewResponse>