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

ConfirmPreorder

Confirms a shipment for pre-order.

Description

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.

Note: After a shipment is confirmed for pre-order, items in the shipment with release dates on or after the date returned in the ConfirmedFulfillableDate response element are subject to the following restrictions:

Availability

This operation is only available in the US, India, and Japan marketplaces.

Throttling

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.

Request parameters

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

Response elements

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

Examples

Example query request

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

Show example code Hide example code

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

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?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>

↑ Top