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 a list of items in a specified inbound shipment, or a list of items that were updated within a specified time frame.
The ListInboundShipmentItems operation returns a list of items contained in an inbound shipment that you specify with a ShipmentId. Alternatively, if you submit the LastUpdatedAfter and LastUpdatedBefore request parameters, the ListInboundShipmentItems operation returns inbound shipment items based on when the items were last updated. Note that if you specify the ShipmentId, then the LastUpdatedAfter and LastUpdatedBefore request parameters are ignored.
You can obtain ShipmentId values for a list of inbound shipments by submitting the ListInboundShipments operation.
The ListInboundShipmentItems operation returns a maximum of 200 inbound shipment items. If there are additional inbound shipment items to return, NextToken is returned in the response. To retrieve all of the inbound shipment items, pass the value of NextToken to the ListInboundShipmentItemsByNextToken operation and repeat until NextToken is no longer returned.
This operation is available in all marketplaces except Brazil.
The ListInboundShipmentItems and ListInboundShipmentItemsByNextToken operations together share 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 |
---|---|---|---|
ShipmentId | A shipment identifier used for selecting items in a specific inbound shipment. | Yes, if LastUpdatedAfter and LastUpdatedBefore are not specified. If ShipmentId is specified, LastUpdatedBefore and LastUpdatedAfter are ignored. | Type: xs:string |
LastUpdatedAfter | A date used for selecting inbound shipment items that were last updated after (or at) a specified time. The selection includes updates made by Amazon and by the seller. | Yes, if ShipmentId is not specified.
If LastUpdatedBefore is specified, then LastUpdatedAfter must be specified. |
Must be earlier than
LastUpdatedBefore.
Type: xs:dateTime |
LastUpdatedBefore | A date used for selecting inbound shipment items that were last updated before (or at) a specified time. The selection includes updates made by Amazon and by the seller. | Yes, if ShipmentId is not specified.
If LastUpdatedAfter is specified, then LastUpdatedBefore must be specified. |
Must be later than
LastUpdatedAfter.
Type: xs:dateTime |
Name | Description |
---|---|
NextToken | A generated string used to pass information to your next
request. If NextToken is returned, pass the
value of NextToken to
ListInboundShipmentItemsByNextToken. If
NextToken is not returned, there are no
more inbound shipments to return. Optional Type: xs:string |
ItemData | Item information for an inbound shipment. Includes
ShipmentId,
SellerSKU,
FulfillmentNetworkSKU,
QuantityShipped, and
QuantityReceived. Type: InboundShipmentItem |
For information about standard request requirements, see Required request parameters.
http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/ ?Action=ListInboundShipmentItems &Version=2010-10-01 &AWSAccessKeyId=1QZHP81EXAMPLEN5R44N &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Signature=VY6sqvdk01VeEXAMPLEG0Vh4oj3 &Timestamp=2015-12-01T02:40:36Z &SellerId=1234567890 &ShipmentId=SSF85DGIZZ3OF1
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <ListInboundShipmentItemsResponse xmlns="http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/"> <ListInboundShipmentItemsResult> <ItemData> <member> <ShipmentId>SSF85DGIZZ3OF1</ShipmentId> <SellerSKU>SampleSKU1</SellerSKU> <QuantityShipped>3</QuantityShipped> <QuantityInCase>0</QuantityInCase> <QuantityReceived>0</QuantityReceived> <FulfillmentNetworkSKU>B000FADVPQ</FulfillmentNetworkSKU> <ReleaseDate>2014-12-31</ReleaseDate> </member> <member> <ShipmentId>SSF85DGIZZ3OF1</ShipmentId> <SellerSKU>SampleSKU2</SellerSKU> <QuantityShipped>10</QuantityShipped> <QuantityInCase>0</QuantityInCase> <QuantityReceived>0</QuantityReceived> <FulfillmentNetworkSKU>B0011VECH4</FulfillmentNetworkSKU> </member> </ItemData> </ListInboundShipmentItemsResult> <ResponseMetadata> <RequestId>ffce8932-8e69-11df-8af1-5bf2881764d8</RequestId> </ResponseMetadata> </ListInboundShipmentItemsResponse>