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

PutTransportContent

Sends transportation information to Amazon about an inbound shipment.

Description

The PutTransportContent operation sends transportation information to Amazon about an inbound shipment. This includes whether an inbound shipment is a Small Parcel or Less Than Truckload/Full Truckload (LTL/FTL) delivery, and whether you intend to use an Amazon-partnered carrier. Note that only sellers in the Amazon European marketplaces (France, Germany, Italy, Spain, and the United Kingdom) and in the United States can use an Amazon-partnered carrier when creating inbound shipments using Amazon Marketplace Web Service (Amazon MWS).

Amazon-partnered carrier shipments

Important:
  • Before using an Amazon-partnered carrier for an inbound shipment, you must read the Seller Central Help about Amazon's Partnered Carrier Program to help ensure that you successfully follow the program instructions and guidelines (Europe) (US).
  • In the EU region, before using an Amazon-partnered carrier for an inbound shipment, you must first review and accept the terms and conditions of the carrier and the terms and conditions of Amazon's Partnered Carrier Program. You can do this on Seller Central. If you attempt to use Amazon Marketplace Web Service (Amazon MWS) to create an inbound shipment using an Amazon-partnered carrier before accepting these terms and conditions, the service returns an error.

If you want to use an Amazon-partnered carrier for an inbound shipment, you can call the PutTransportContent operation to submit the transportation details that are required to get shipping costs. After calling the PutTransportContent operation, you can call the EstimateTransportRequest operation to get an estimate of the shipping cost of an inbound shipment using an Amazon-partnered carrier. For more information, see Using an Amazon-partnered carrier for your inbound shipment in the MWS for FBA Sellers guide.

Non-Amazon-partnered carrier shipments

If you use a non-Amazon-partnered carrier for your inbound shipment, you can call the PutTransportContent operation to send Amazon the shipment tracking numbers for your inbound shipment. Calling the PutTransportContent operation:
  • Helps Amazon process your inbound shipment at the Amazon fulfillment center faster and more accurately.
  • Provides Amazon with your shipment tracking numbers so that you can subsequently call the GetTransportContent operation to get the shipment status for your Small Parcel shipments.

For more information, see Step 6 - Send shipment tracking numbers to Amazon in the MWS for FBA Sellers guide.

Availability

This operation is available in all marketplaces except Brazil.

Throttling

The PutTransportContent 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
IsPartnered Indicates whether a PutTransportContent request is for an Amazon-partnered carrier. Yes IsPartnered values:
  • true – Request is for an Amazon-partnered carrier.
  • false – Request is for a non-Amazon-partnered carrier.

Type: xs:boolean

ShipmentType Specifies the carrier shipment type in a PutTransportContent request. Yes ShipmentType values:
  • SPSmall Parcel
  • LTLLess Than Truckload/Full Truckload (LTL/FTL)

Type: xs:string

TransportDetails Information required to create an Amazon-partnered carrier shipping estimate, or to alert the Amazon fulfillment center to the arrival of an inbound shipment by a non-Amazon-partnered carrier. Yes Type: TransportDetailInput

Response elements

Name Description
TransportResult Workflow status for a shipment with an Amazon-partnered carrier.

Type: TransportResult

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
  ?AWSAccessKeyId=AKIAEIAEXAMPLEQCJLSA
  &Action=PutTransportContent
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &SellerId=A13EXAMPLE1J56
  &SignatureVersion=2
  &Timestamp=2013-08-09T22%3A52%3A25Z
  &Version=2010-10-01
  &SignatureMethod=HmacSHA256
  &ShipmentId=FBAQ6QBP
  &IsPartnered=false
  &ShipmentType=SP
  &TransportDetails.NonPartneredSmallParcelData.
CarrierName=DHL%20EXPRESS%20%28USA%29%20INC
  &TransportDetails.NonPartneredSmallParcelData.
PackageList.member.1.TrackingId=A135KKEKWF1J5666

↑ Top

Example response (Success)

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<PutTransportContentResponse 
    xmlns="http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/">
    <PutTransportContentResult>
        <TransportResult>
            <TransportStatus>WORKING</TransportStatus>
        </TransportResult>
    </PutTransportContentResult>
    <ResponseMetadata>
        <RequestId>616f4f53-973e-4bb3-8dd3-0b46978a45c5</RequestId>
    </ResponseMetadata>
</PutTransportContentResponse>

↑ Top

Example error response (InvalidParameterValue)

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<ErrorResponse xmlns="http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/">;
    <Error>
        <Type>Sender</Type>
        <Code>InvalidParameterValue</Code>
        <Message>Maximum request size was exceeded</Message>
    </Error>
    <RequestID>79e44ae7-b6f0-4154-a3ad-3b95298ff084</RequestID>
</ErrorResponse>

↑ Top