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 the information required to create an inbound shipment.
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.
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.
This operation is available in all marketplaces except Brazil.
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.
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:
ShipToCountryCode values for MCI sellers in Europe:
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:
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 |
Name | Description |
---|---|
InboundShipmentPlans | Inbound shipment information used to create an inbound shipment. Type: InboundShipmentPlan |
For an example of CreateInboundShipmentPlan with multiple PrepOwners, see Preparation examples.
For information about standard request requirements, see Required request parameters.
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
For information about standard response formatting, see Response format.
<?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>