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.
Confirms a shipment for pre-order.
The ConfirmPreorder operation confirms a shipment for pre-order. Call this operation after calling the GetPreorderInfo operation to get the NeedByDate value and other pre-order information about the shipment. To get a list of shipments that are confirmed for pre-order, call the ListInboundShipments operation and sort the result set by the ConfirmedNeedByDate response element.
After a shipment is confirmed for pre-order, the pre-order Buy Box displays for all of the items in the shipment with release dates on or after the date in the ConfirmedFulfillableDate response element. A shipment that is confirmed for pre-order must arrive at an Amazon fulfillment center by the date in the ConfirmedNeedByDate response element to avoid promise breaks.
This operation is only available in the US, India, and Japan marketplaces.
The ConfirmPreorder 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 |
NeedByDate | Date that the shipment must arrive at an Amazon fulfillment center to avoid delivery promise breaks for pre-ordered items. This comes from the GetPreorderInfo operation. | Yes | Must be in YYYY-MM-DD format. Type: xs:string |
Name | Description |
---|---|
ConfirmedNeedByDate | Date passed in with the NeedByDate
parameter. The confirmed shipment must arrive at an Amazon fulfillment center by this date to avoid
delivery promise breaks for pre-ordered items. In YYYY-MM-DD
format. Type: xs:string |
ConfirmedFulfillableDate | Date that determines which pre-order items in the shipment
are eligible for pre-order. The pre-order Buy Box will appear
for any pre-order item in the shipment with a release date on or
after this date. In YYYY-MM-DD format. Type: xs:string |
For information about standard request requirements, see Required request parameters.
http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01 ?AWSAccessKeyId=AKIAJGUEXAMPLEE2NVUA &Action=ConfirmPreorder &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 &NeedByDate=2015-12-27
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <ConfirmPreorderResponse xmlns="http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/"> <ConfirmPreorderResult> <ConfirmedNeedByDate>2015-12-27</ConfirmedNeedByDate> <ConfirmedFulfillableDate>2015-12-31</ConfirmedFulfillableDate> </ConfirmPreorderResult> <ResponseMetadata> <RequestId>4a1a7029-462b-4a27-a04c-4cbe0fd107e3</RequestId> </ResponseMetadata> </ConfirmPreorderResponse>