PutInboundShipment

Description

The PutInboundShipment operation creates or replaces information about a shipment. If the shipment already exists, the information about the shipment (and its associated items) is replaced (for the provided ShipmentId). If the shipment does not exist, one is created.

Request Parameters

NameDescriptionRequired

ShipmentId

The shipment identifier for your shipment.

Type: String

Default: None

Constraints: Must be a valid shipment identifier from GetInboundShipmentPreview.

Yes

ShipmentName

Enter a name for your shipment. Choose a naming convention that helps you distinguish each shipment over time, such as the date it was created.

Type: String

Default: None

Constraints: Must be an alphanumeric string from one to 40 characters in length.

Yes

DestinationFulfillmentCenter

The Amazon fulfillment center the shipment is being sent to.

Type: String

Default: None

Valid values: Four-character string returned in GetInboundShipmentPreview.

Yes

ShipFromAddress

Information about a mailing address.

Type: ???

Yes

MerchantSKUQuantityItem

This parameter is an aggregated element comprised of the following elements:

  • MerchantSKU—The merchant stock keeping unit (SKU) is the unique product identifier you assign for each product in your inventory. The SKU must be distinct from any other product you list.

    Type: String

    Default: None

    Constraints: Must be an alphanumeric string from one to 40 characters in length.

  • Quantity—The number of units (for this Merchant SKU) you are shipping

    Type: Integer

    Default: None

    Constraints: Must be a positive integer.

Yes

Response Elements

The PutInboundShipment operation only returns the following metadata:

NameDescription

RequestId

This operation returns a RequestId upon success. Otherwise an explicit error is returned.

Type: String

Examples

Example SOAP Request

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soapenv:Header>
        <aws:AWSAccessKeyId soapenv:actor="http://schemas.xmlsoap.org/soap/actor/next"
            soapenv:mustUnderstand="0" xmlns:aws="http://security.amazonaws.com/doc/2007-01-01/"
            >0QY05JR56ZA8E56XPG82</aws:AWSAccessKeyId>
        <aws:Signature soapenv:actor="http://schemas.xmlsoap.org/soap/actor/next"
            soapenv:mustUnderstand="0" xmlns:aws="http://security.amazonaws.com/doc/2007-01-01/"
            >Mo7KufVWQZvvzl6zz6Prrl8LoUE=</aws:Signature>
        <aws:Timestamp soapenv:actor="http://schemas.xmlsoap.org/soap/actor/next"
            soapenv:mustUnderstand="0" xmlns:aws="http://security.amazonaws.com/doc/2007-01-01/"
            >2009-01-23T01:14:14Z</aws:Timestamp>
    </soapenv:Header>
    <soapenv:Body>
        <PutInboundShipment xmlns="http://fba-inbound.amazonaws.com/doc/2007-05-10/">
            <ShipmentId>SSF85DGIZZG4RN</ShipmentId>
            <ShipmentName>FBAInboundService Test Shipment</ShipmentName>
            <DestinationFulfillmentCenter>RNO2</DestinationFulfillmentCenter>
            <ShipFromAddress>
                <Name>Test Address</Name>
                <AddressLine1>Address Line 1</AddressLine1>
                <AddressLine2>Address Line 2</AddressLine2>
                <City>Seattle</City>
                <StateOrProvinceCode>WA</StateOrProvinceCode>
                <CountryCode>US</CountryCode>
                <PostalCode>98101</PostalCode>
            </ShipFromAddress>
            <MerchantSKUQuantityItem>
                <MerchantSKU>ssof_dev_drt_mfn_item</MerchantSKU>
                <Quantity>4</Quantity>
            </MerchantSKUQuantityItem>
        </PutInboundShipment>
    </soapenv:Body>
</soapenv:Envelope>

Example Query Request

https://fba-inbound.amazonaws.com/
?Action=PutInboundShipment
&Version=2007-05-10
&AWSAccessKeyId=0QY05JR56ZA8E56XPG82
&Signature=Mo7KufVWQZvvzl6zz6Prrl8LoUE=
&Timestamp=2009-01-23T01:14:14Z
&ShipmentId=SSF85DGIZZG4RN
&ShipmentName=FBAInboundService Test Shipment
&DestinationFulfillmentCenter=RNO2
&ShipFromAddress.Name=Test Address
&ShipFromAddress.AddressLine1=Address Line 1
&ShipFromAddress.AddressLine2=Address Line 2
&ShipFromAddress.City=Seattle
&ShipFromAddress.StateOrProvinceCode=WA
&ShipFromAddress.CountryCode=US
&ShipFromAddress.PostalCode=98101
&MerchantSKUQuantityItem.MerchantSKU=ssof_dev_drt_mfn_item
&MerchantSKUQuantityItem.Quantity=4

Example Response

<?xml version="1.0"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns1:PutInboundShipmentResponse xmlns:ns1="http://fba-inbound.amazonaws.com/doc/2007-05-10/">
            <ns1:ResponseMetadata>
                <ns1:RequestId>45dbf96d-3734-4c5e-929d-c3759565bd9b</ns1:RequestId>
            </ns1:ResponseMetadata>
        </ns1:PutInboundShipmentResponse>
    </soapenv:Body>
</soapenv:Envelope>

Related Operations

PutInboundShipmentItems

PutInboundShipmentData