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

CreateInboundShipmentPlan

Returns the information required to create an inbound shipment.

Description

The CreateInboundShipmentPlan operation returns one or more inbound shipment plans, which provide the information you need to create one or more inbound shipments for a set of items that you specify. Multiple inbound shipment plans might be required so that items can be optimally placed in Amazon's fulfillment network—for example, positioning inventory closer to the customer. Alternatively, two inbound shipment plans might be created with the same Amazon fulfillment center destination if the two shipment plans require different processing—for example, items that require labels must be shipped separately from stickerless, commingled inventory.

Note: If you are creating your own labels, see Item label specifications in Amazon MWS for FBA Sellers.

Creating inbound shipments to countries

Sellers in North America and Multi-Country Inventory (MCI) sellers in Europe can use the ShipToCountryCode request parameter of the CreateInboundShipmentPlan operation to specify which country their inbound shipments will be sent to. Sellers whose home marketplace is the US or Canada can specify that their inbound shipments will be sent to Amazon's fulfillment network in either one of those countries. Likewise, MCI sellers whose home marketplace is Germany, France, Italy, Spain, or the United Kingdom can specify that their inbound shipments will be sent to the fulfillment network in any one of those countries.

Availability

This operation is available in all marketplaces except Brazil.

Throttling

The CreateInboundShipmentPlan 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
ShipFromAddress The address from which you will send your inbound shipment. Yes Type: Address
ShipToCountryCode The two-character country code for the country where you want your inbound shipment to be sent.

Only for sellers in North America and Multi-Country Inventory (MCI) sellers in Europe.

No. Specifying both ShipToCountryCode and ShipToCountrySubdivisionCode returns an error. ShipToCountryCode values for North America:
  • CA – Canada
  • MX – Mexico
  • US – United States

ShipToCountryCode values for MCI sellers in Europe:

  • DE – Germany
  • ES – Spain
  • FR – France
  • GB – United Kingdom
  • IT – Italy

Default: The country code for your home marketplace.

ShipToCountrySubdivisionCode The two-character country code, followed by a dash and then up to three characters that represent the subdivision of the country where you want your inbound shipment to be sent. For example, "IN-MH". In full ISO 3166-2 format.

Only for sellers in India.

No. Specifying both ShipToCountryCode and ShipToCountrySubdivisionCode returns an error. See the ISO 3166-2 standard for states and union territories in India. If specified, only an ISO 3166-2 subdivision code for a state that contains an Amazon fulfillment center that the seller is registered with will result in a successful call. Specifying any other value returns an error.

If neither ShipToCountrySubdivisionCode nor ShipToCountryCode is specified, the shipment goes to the seller's home marketplace.

LabelPrepPreference Your preference for label preparation for an inbound shipment. No LabelPrepPreference values:
  • SELLER_LABEL - Seller labels the items in the inbound shipment when labels are required.
  • AMAZON_LABEL_ONLY - Amazon attempts to label the items in the inbound shipment when labels are required. If Amazon determines that it does not have the information required to successfully label an item, that item is not included in the inbound shipment plan.
  • AMAZON_LABEL_PREFERRED - Amazon attempts to label the items in the inbound shipment when labels are required. If Amazon determines that it does not have the information required to successfully label an item, that item is included in the inbound shipment plan and the seller must label it.
Note: Unless you are enrolled in the FBA Label Service, SELLER_LABEL is the only valid LabelPrepPreference value. The FBA Label Service is not available in India (IN) and is currently in beta development in Japan (JP). For more information about the FBA Label Service, see the Seller Central Help for your marketplace.

Default: SELLER_LABEL

Type: xs:string

InboundShipmentPlanRequestItems SKU and quantity information for the items in an inbound shipment. Yes Type: InboundShipmentPlanRequestItem

Response elements

Name Description
InboundShipmentPlans Inbound shipment information used to create an inbound shipment.

Type: InboundShipmentPlan

Examples

For an example of CreateInboundShipmentPlan with multiple PrepOwners, see Preparation examples.

Example query request

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

Show example code Hide example code

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.member.1.PrepInstruction=Taping
&InboundShipmentPlanRequestItems.member.1.PrepDetailsList.member.1.PrepOwner=AMAZON

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<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>
        <EstimatedBoxContentsFee>
          <TotalUnits>10</TotalUnits>
          <FeePerUnit>
            <CurrencyCode>USD</CurrencyCode>
            <Value>0.10</Value>
          </FeePerUnit>
          <TotalFee>
            <CurrencyCode>USD</CurrencyCode>
            <Value>10.0</Value>
          </TotalFee>
        </EstimatedBoxContentsFee>
        <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>
    </InboundShipmentPlans>
  </CreateInboundShipmentPlanResult>
  <ResponseMetadata>
    <RequestId>babd156d-8b2f-40b1-a770-d117f9ccafef</RequestId>
  </ResponseMetadata>
</CreateInboundShipmentPlanResponse>

↑ Top