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 pre-order information, including dates, that a seller needs before confirming a shipment for pre-order. Also indicates if a shipment has already been confirmed for pre-order.
The GetPreorderInfo operation returns pre-order information, including dates, that a seller needs before confirming a shipment for pre-order. Call this operation after creating the shipment using the CreateInboundShipment operation. You can also call this operation to find out if a shipment has already been confirmed for pre-order. To confirm the shipment for pre-order, call the ConfirmPreorder operation.
Pre-orders are available only in India and Japan.
This operation is only available in the US, India, and Japan marketplaces.
The GetPreorderInfo 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.
For more information about the request parameters that are required for all Amazon MWS operations, see Required request parameters in the Amazon MWS Developer Guide.
Name | Description | Required | Values |
---|---|---|---|
ShipmentId | A shipment identifier originally returned by the CreateInboundShipmentPlan operation. | Yes | Type: xs:string |
Name | Description |
---|---|
ShipmentContainsPreorderableItems | Indicates whether the shipment contains items that have been enabled for pre-order.
For more information about enabling items for pre-order, see the
Seller Central Help (IN) (JP). Type: xs:boolean |
NeedByDate | Date that the shipment would need to arrive at an Amazon fulfillment center to avoid delivery promise breaks for pre-ordered items if
this shipment is later confirmed for pre-order. See ConfirmPreorder. In YYYY-MM-DD
format. Type: xs:string |
ConfirmedFulfillableDate | Date that determines which pre-order items in the shipment are eligible for
pre-order. If this shipment is confirmed for pre-order with a
subsequent call to the ConfirmPreorder
operation, the pre-order Buy Box will appear for any pre-order
items in the shipment with a release date on or after this date.
Call the ListInboundShipmentItems
operation to get the release dates for the pre-order items in
this shipment. In YYYY-MM-DD format. Type: xs:string |
ShipmentConfirmedForPreorder | Indicates whether this shipment has been confirmed for pre-order. Type: xs:boolean |
For information about standard request requirements, see Required request parameters.
http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01 ?AWSAccessKeyId=AKIAJGUEXAMPLEE2NVUA &Action=GetPreorderInfo &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &SellerId=A2NKEXAMPLEF53 &SignatureVersion=2 &Timestamp=2015-11-02T02:40:36Z &Version=2010-10-01 &Signature=ZRA9DR5rveSuz%2F1D18AHvoipg2BAev8yblPQ1BbEbfU%3D &SignatureMethod=HmacSHA256 &ShipmentId=FBA2F3KCQF
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <GetPreorderInfoResponse xmlns="http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/"> <GetPreorderInfoResult> <ShipmentContainsPreorderableItems>true </ShipmentContainsPreorderableItems> <NeedByDate>2015-12-27</NeedByDate> <ConfirmedFulfillableDate>2015-12-31</ConfirmedFulfillableDate> <ShipmentConfirmedForPreorder>true</ShipmentConfirmedForPreorder> </GetPreorderInfoResult> <ResponseMetadata> <RequestId>4a1a7029-462b-4a27-a04c-4cbe0fd107e3</RequestId> </ResponseMetadata> </GetPreorderInfoResponse>