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


Updates an existing inbound shipment.


The UpdateInboundShipment operation can add, update, and remove items from an existing inbound shipment. The existing shipment is identified by the ShipmentId. Each UpdateInboundShipment operation that you submit can include up to 200 items.

If you include the InboundShipmentHeader request parameter, it replaces the InboundShipmentHeader information for the shipment you are updating. Note that you can update the status of your inbound shipment by including the InboundShipmentHeader request parameter and changing the ShipmentStatus element.

If you include the InboundShipmentItems request parameter, the behavior is as follows:

  • Including an item that doesn't exist in the inbound shipment, as identified by the SellerSKU, adds the new item to the inbound shipment.
  • Including an item that already exists in the shipment, as identified by the SellerSKU, replaces the existing item. Note that if the new item that replaces the old item has QuantityShipped set to zero, this indicates that the item is removed from the inbound shipment.


This operation is available in all marketplaces except Brazil.


The UpdateInboundShipment 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


Example query request

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

Show example code Hide example code

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

↑ Top