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

ListInboundShipmentItems

Returns a list of items in a specified inbound shipment, or a list of items that were updated within a specified time frame.

Description

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.

Availability

This operation is available in all marketplaces except Brazil.

Throttling

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.

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 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.

In ISO 8601 date time format.

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.

In ISO 8601 date time format.

Type: xs:dateTime

Response elements

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

Examples

Example query request

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

Show example code Hide example code

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

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?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>

↑ Top