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

Preparation examples

These examples demonstrate how to create separate shipments for items that have different PrepOwners for the same PrepInstruction, and show how errors can result if the same instruction is given to two owners in the same shipment.

Creating multiple plans for different PrepOwners

In this example, the seller is creating a shipment plan where multiple items requiring the same PrepInstruction have different PrepOwners. Because each shipment must have the same PrepOwner for a given PrepInstruction, this plan proposes multiple shipments. In this case, one item is being taped by Amazon, the other is being taped by the seller.

Example query request

https://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01
?AWSAccessKeyId=AKIAEIAL5QODNGQCJLSA
&Action=CreateInboundShipmentPlan
&SellerId=A135KKEKWF1J56
&SignatureVersion=2
&Timestamp=2015-11-29T22%3A36%3A53Z
&Version=2010-10-01
&Signature=wMAeU2CEHdRCPh%2Fg7lQC7HkgRjxZlLxtbbDvFDHzdOE%3D
&SignatureMethod=HmacSHA256
&LabelPrepPreference=SELLER_LABEL
&ShipFromAddress.Name=test1
&ShipFromAddress.AddressLine1=LINE_1
&ShipFromAddress.City=Seattle
&ShipFromAddress.StateOrProvinceCode=WA
&ShipFromAddress.PostalCode=98121
&ShipFromAddress.CountryCode=US
&InboundShipmentPlanRequestItems.member.1.SellerSKU=SKU00001
&InboundShipmentPlanRequestItems.member.1.Quantity=1
&InboundShipmentPlanRequestItems.member.1.PrepDetailsList.PrepDetails.1.PrepInstruction=Taping          
&InboundShipmentPlanRequestItems.member.1.PrepDetailsList.PrepDetails.1.PrepOwner=AMAZON
&InboundShipmentPlanRequestItems.member.2.SellerSKU=SKU00002
&InboundShipmentPlanRequestItems.member.2.Quantity=1
&InboundShipmentPlanRequestItems.member.2.PrepDetailsList.PrepDetails.1.PrepInstruction=Labeling         
&InboundShipmentPlanRequestItems.member.2.PrepDetailsList.PrepDetails.1.PrepOwner=AMAZON
&InboundShipmentPlanRequestItems.member.2.PrepDetailsList.PrepDetails.2.PrepInstruction=Taping         
&InboundShipmentPlanRequestItems.member.2.PrepDetailsList.PrepDetails.2.PrepOwner=SELLER

Example response

<?xml version="1.0" encoding="UTF-8"?>
<CreateInboundShipmentPlanResponse
  xmlns="http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/">
  <CreateInboundShipmentPlanResult>
    <InboundShipmentPlans>
      <member>
        <DestinationFulfillmentCenterId>ABE2</DestinationFulfillmentCenterId>
        <LabelPrepType>SELLER_LABEL</LabelPrepType>
        <ShipToAddress>
          <City>Breinigsville</City>
          <CountryCode>US</CountryCode>
          <PostalCode>18031</PostalCode>
          <Name>Amazon.com</Name>
          <AddressLine1>705 Boulder Drive</AddressLine1>
          <StateOrProvinceCode>PA</StateOrProvinceCode>
        </ShipToAddress>
        <Items>
          <member>
            <FulfillmentNetworkSKU>FNSKU00001</FulfillmentNetworkSKU>
            <Quantity>1</Quantity>
            <SellerSKU>SKU00001</SellerSKU>
            <PrepDetailsList>
              <PrepDetails>
                <PrepInstruction>Taping</PrepInstruction>
                <PrepOwner>AMAZON</PrepOwner> 
              </PrepDetails>
            </PrepDetailsList>
          </member>
        </Items>
        <ShipmentId>FBA0000001</ShipmentId>
      </member>
      <member>
        <DestinationFulfillmentCenterId>ABE2</DestinationFulfillmentCenterId>
        <LabelPrepType>AMAZON_ONLY</LabelPrepType>
        <ShipToAddress>
          <City>Breinigsville</City>
          <CountryCode>US</CountryCode>
          <PostalCode>18031</PostalCode>
          <Name>Amazon.com</Name>
          <AddressLine1>705 Boulder Drive</AddressLine1>
          <StateOrProvinceCode>PA</StateOrProvinceCode>
        </ShipToAddress>
        <Items>
          <member>
            <FulfillmentNetworkSKU>FNSKU00002</FulfillmentNetworkSKU>
            <Quantity>1</Quantity>
            <SellerSKU>SKU00002</SellerSKU>
            <PrepDetailsList>
              <PrepDetails>
                <PrepInstruction>Taping</PrepInstruction>
                <PrepOwner>SELLER</PrepOwner> 
                <PrepInstruction>Labeling</PrepInstruction>
                <PrepOwner>AMAZON</PrepOwner>                     
              </PrepDetails>
            </PrepDetailsList>
          </member>
        </Items>
        <ShipmentId>FBA0000002</ShipmentId>
      </member>
    </InboundShipmentPlans>
  </CreateInboundShipmentPlanResult>
  <ResponseMetadata>
    <RequestId>babd156d-8b2f-40b1-a770-d117f9ccafef</RequestId>
  </ResponseMetadata>
</CreateInboundShipmentPlanResponse>

Creating a single shipment for matching PrepOwners

In this example, the seller is creating a single shipment where the same PrepInstruction is executed by the same PrepOwner. In this case, both SKUs are being labelled by Amazon.

Example query request

https://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01  
?AWSAccessKeyId=AKIAEIAL5QODNGQCJLSA
&Action=CreateInboundShipment
&SellerId=A135KKEKWF1J56
&SignatureVersion=2
&Timestamp=2015-11-29T22%3A51%3A09Z
&Version=2010-10-01
&Signature=zzk0jdEopg7JgFAAjVrmESGYHKwvBJ2BhYdC1gLaUhc%3D
&SignatureMethod=HmacSHA256
&ShipmentId=FBA0000001
&InboundShipmentHeader.ShipmentName=SHIPMENT_NAME
&InboundShipmentHeader.ShipFromAddress.Name=NAME
&InboundShipmentHeader.ShipFromAddress.AddressLine1=ADDR_LINE1
&InboundShipmentHeader.ShipFromAddress.City=Seattle
&InboundShipmentHeader.ShipFromAddress.StateOrProvinceCode=WA
&InboundShipmentHeader.ShipFromAddress.PostalCode=98121
&InboundShipmentHeader.ShipFromAddress.CountryCode=US
&InboundShipmentHeader.DestinationFulfillmentCenterId=ABE2
&InboundShipmentHeader.ShipmentStatus=WORKING
&InboundShipmentHeader.LabelPrepPreference=SELLER_LABEL
&InboundShipmentItems.member.1.QuantityShipped=1
&InboundShipmentItems.member.1.SellerSKU=SKU00001
&InboundShipmentItems.member.1.PrepDetailsList.PrepDetails.1.PrepInstruction=Labeling 
&InboundShipmentItems.member.1.PrepDetailsList.PrepDetails.1.PrepOwner=AMAZON
&InboundShipmentItems.member.2.QuantityShipped=2
&InboundShipmentItems.member.2.SellerSKU=SKU00002
&InboundShipmentItems.member.2.PrepDetailsList.PrepDetails.1.PrepInstruction= Labeling
&InboundShipmentItems.member.2.PrepDetailsList.PrepDetails.1.PrepOwner= AMAZON
&InboundShipmentItems.member.2.PrepDetailsList.PrepDetails.2.PrepInstruction=Taping 
&InboundShipmentItems.member.2.PrepDetailsList.PrepDetails.2.PrepOwner= SELLER

Example response

<?xml version="1.0" encoding="UTF-8"?>
<CreateInboundShipmentResponse
  xmlns="http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/">
  <CreateInboundShipmentResult>
    <ShipmentId>FBA000111</ShipmentId>
  </CreateInboundShipmentResult>
  <ResponseMetadata>
    <RequestId>2a1455aa-c5f9-4993-9b18-dc10407e09ba</RequestId>
  </ResponseMetadata>
</CreateInboundShipmentResponse>

Creating a single shipment with incompatible PrepOwners

In this example, the seller is trying to create a single shipment where the same PrepInstruction has two different PrepOwners. This would result in an IncompatiblePrepOwner error.

Example query request

https://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01
?AWSAccessKeyId=AKIAEIAL5QODNGQCJLSA
&Action=CreateInboundShipment
&SellerId=A135KKEKWF1J56
&SignatureVersion=2
&Timestamp=2015-11-29T22%3A51%3A09Z
&Version=2010-10-01
&Signature=zzk0jdEopg7JgFAAjVrmESGYHKwvBJ2BhYdC1gLaUhc%3D
&SignatureMethod=HmacSHA256
&ShipmentId=FBA0000001
&InboundShipmentHeader.ShipmentName=SHIPMENT_NAME
&InboundShipmentHeader.ShipFromAddress.Name=NAME
&InboundShipmentHeader.ShipFromAddress.AddressLine1=ADDR_LINE1
&InboundShipmentHeader.ShipFromAddress.City=Seattle
&InboundShipmentHeader.ShipFromAddress.StateOrProvinceCode=WA
&InboundShipmentHeader.ShipFromAddress.PostalCode=98121
&InboundShipmentHeader.ShipFromAddress.CountryCode=US
&InboundShipmentHeader.DestinationFulfillmentCenterId=ABE2
&InboundShipmentHeader.ShipmentStatus=WORKING
&InboundShipmentHeader.LabelPrepPreference=SELLER_LABEL
&InboundShipmentItems.member.1.QuantityShipped=1
&InboundShipmentItems.member.1.SellerSKU=SKU00001
&InboundShipmentItems.member.1.PrepDetailsList.PrepDetails.1.PrepInstruction=Taping 
&InboundShipmentItems.member.1.PrepDetailsList.PrepDetails.1.PrepOwner=AMAZON
&InboundShipmentItems.member.2.QuantityShipped=2
&InboundShipmentItems.member.2.SellerSKU=SKU00002
&InboundShipmentItems.member.2.PrepDetailsList.PrepDetails.1.PrepInstruction=Taping 
&InboundShipmentItems.member.2.PrepDetailsList.PrepDetails.1.PrepOwner=SELLER

Example response

<ErrorResponse
  xmlns="http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/">
  <Error>
    <Type>Sender</Type>
    <Code>IncompatiblePrepOwner</Code>
    <Message>Incompatible PrepOwner. A shipment cannot have a mix of AMAZON and SELLER as PrepOwner for the same prep instruction</Message>
  </Error>
  <RequestId>b8e929f5-18bb-4c28-905e-f9d634a61038</RequestId>
</ErrorResponse>