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.
Returns a list of fulfillment order previews based on shipping criteria that you specify.
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.
This operation is available in all marketplaces except Brazil.
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.
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:
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: AllType: List of type: xs:string |
IncludeCODFulfillmentPreview | Specifies whether to return fulfillment order previews that are for COD (Cash On Delivery). | No | IncludeCODFulfillmentPreview values:
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:
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 |
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 |
For information about standard request requirements, see Required request parameters.
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
For information about standard response formatting, see Response format.
<?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>