Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

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.

Amazon MWS Documentation

GetFulfillmentPreview

Returns a list of fulfillment order previews based on shipping criteria that you specify.

Description

The GetFulfillmentPreview operation returns a list of fulfillment order previews based on shipping criteria that you specify. Each fulfillment order preview contains the estimated shipping weight and the estimated shipping fees for the potential fulfillment order, as well as ship dates, arrival dates, and estimated shipping weights for individual shipments within the potential fulfillment order. In Japan, the GetFulfillmentPreview operation optionally returns delivery windows for scheduling Multi-Channel Fulfillment orders. This operation also provides information about unfulfillable items in fulfillment order previews.

Note: If an inbound shipment has a status of WORKING or SHIPPED, Amazon considers the items in that inbound shipment to be fulfillable. This means that the GetFulfillmentPreview operation can return weight and shipping fee estimates for fulfillable items that have not yet arrived at an Amazon fulfillment center. For this reason weight and shipping fee estimates for items in inbound shipments with a status of WORKING or SHIPPED will often be incorrect.

Availability

This operation is available in all marketplaces except Brazil.

Throttling

The GetFulfillmentPreview operation has a maximum request quota of 30 and a restore rate of two requests every second. For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.

Request parameters

Name Description Required Values
MarketplaceId The marketplace the fulfillment order is placed against. No MarketplaceId values: see Amazon MWS endpoints and MarketplaceId values.

Type: xs:string

Address The destination address for the fulfillment order preview. Yes Type: Address
Items Identifying information and quantity information for the items in the fulfillment order preview. Yes Type: List of GetFulfillmentPreviewItem
ShippingSpeedCategories A list of shipping methods used for creating fulfillment order previews. No ShippingSpeedCategories values:
  • Standard - Standard shipping method.
  • Expedited - Expedited shipping method.
  • Priority - Priority shipping method.
  • ScheduledDelivery - Scheduled Delivery shipping method. For more information, see Scheduled Delivery.
Note: Shipping method service level agreements vary by marketplace. See the Amazon Seller Central website in your marketplace for shipping method service level agreements and fulfillment fees.
Default: All

Type: List of type: xs:string

IncludeCODFulfillmentPreview Specifies whether to return fulfillment order previews that are for COD (Cash On Delivery). No IncludeCODFulfillmentPreview values:
  • true - Returns all fulfillment order previews (both for COD and not for COD).
  • false - Returns only fulfillment order previews that are not for COD.

Default: false

Note: IncludeCODFulfillmentPreview is a valid request parameter only in Japan (JP). In any other marketplace, the service ignores the IncludeCODFulfillmentPreview request parameter.

Type: xs:boolean

IncludeDeliveryWindows Specifies whether to return the ScheduledDeliveryInfo response element, which contains the available delivery windows for a Scheduled Delivery. The ScheduledDeliveryInfo response element can only be returned for fulfillment order previews with ShippingSpeedCategories = ScheduledDelivery. No IncludeDeliveryWindows values:
  • true - Returns the ScheduledDeliveryInfo response element.
  • false – Does not return the ScheduledDeliveryInfo response element.
Note: IncludeDeliveryWindows is a valid request parameter only in Japan (JP). In any other marketplace, the service ignores the IncludeDeliveryWindows request parameter.

For more information about Scheduled Delivery, see Scheduled Delivery.

Default: false

Type: xs:boolean

Response elements

Name Description
FulfillmentPreviews A list of fulfillment order previews, including estimated shipping weights, estimated shipping fees, and estimated ship dates and arrival dates.

Type: List of FulfillmentPreview

Examples

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

http://mws.amazonservices.jp/FulfillmentOutboundShipment/2010-10-01/   
  ?Action=GetFulfillmentPreview   
  &Version=2010-10-01   
  &AWSAccessKeyId=AKIAJGUEXAMPLEE2NVUA   
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE   
  &SignatureVersion=2   
  &SignatureMethod=HmacSHA256
  &Signature=ZRA9DR5rveSuz%2F1D18AHvoipg2BAev8yblPQ1BbEbfU%3D   
  &Timestamp=2014-01-02T02:40:36Z   
  &SellerId=A2NKEXAMPLEF53   
  &MarketplaceId=ATVPDKIKX0DER
  &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
  &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  
  &ShippingSpeedCategories.1=Expedited   
  &ShippingSpeedCategories.2=Standard   
  &ShippingSpeedCategories.3=ScheduledDelivery      
  &IncludeCODFulfillmentPreview=true   
  &IncludeDeliveryWindows=true     

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?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>
          <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
        </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>

↑ Top