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

CreateInboundShipment

Creates an inbound shipment.

Description

The CreateInboundShipment operation creates an inbound shipment, based on information that was returned by the CreateInboundShipmentPlan operation. The CreateInboundShipment operation can include up to 200 items. If you need to create an inbound shipment that contains over 200 items, see Creating an inbound shipment containing over 200 items in Amazon MWS for FBA Sellers.

Availability

This operation is available in all marketplaces except Brazil.

Throttling

The CreateInboundShipment 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
InboundShipmentHeader Header information for an inbound shipment. Yes Type: InboundShipmentHeader
InboundShipmentItems SellerSKU and QuantityShipped information for items in an inbound shipment. Yes Type: InboundShipmentItem

Response elements

Name Description
ShipmentId The ShipmentId submitted in the request.

Type: xs:string

Examples

For more examples of how CreateInboundShipment works with 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=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
&InboundShipmentHeader.IntendedBoxContentsSource=FEED
&InboundShipmentItems.member.1.QuantityShipped=1
&InboundShipmentItems.member.1.SellerSKU=SKU00001
&InboundShipmentItems.member.1.PrepDetailsList.member.1.PrepInstruction=Taping 
&InboundShipmentItems.member.1.PrepDetailsList.member.1.PrepOwner=AMAZON
&InboundShipmentItems.member.2.QuantityShipped=2
&InboundShipmentItems.member.2.SellerSKU=SKU00002
&InboundShipmentItems.member.2.PrepDetailsList.member.1.PrepInstruction=Taping 
&InboundShipmentItems.member.2.PrepDetailsList.member.1.PrepOwner=SELLER

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

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

↑ Top