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 unique package labels for faster and more accurate shipment processing at the Amazon fulfillment center.
The GetUniquePackageLabels operation returns PDF document data for printing unique shipping labels and carrier labels for an inbound shipment. For information about extracting PDF document data, see Extracting PDF Document Data.
Use this operation to get unique shipping labels for the packages in all types of inbound shipments: Small Parcel, Less Than Truckload/Full Truckload (LTL/FTL), Amazon-partnered, or non-Amazon-partnered shipments. For Amazon-partnered, Small Parcel shipments, this operation returns carrier labels in addition to shipping labels.
The language of the address section of a shipping label is determined by the ShipFromAddress value for the shipment, which was specified with a previous call to the CreateInboundShipmentPlan operation. The language of the FC Prep instructions (if applicable) is determined by the marketplace of the Amazon fulfillment center receiving the shipment.
Before calling the GetUniquePackageLabels operation, use the Feeds API section to submit the FBA Inbound Shipment Carton Information Feed (_POST_FBA_INBOUND_CARTON_CONTENTS_). This provides information to Amazon about the carton contents of your inbound shipment, which enables faster and more accurate processing of your shipment at the Amazon fulfillment center. You must submit this feed before calling the GetUniquePackageLabels operation, otherwise the operation returns the NoPackageContentInformation error. For more information, see the following links:
Amazon-partnered shipments
Non-Amazon-partnered shipments
This operation is available in all marketplaces except Brazil.
The GetUniquePackageLabels 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.
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 | Must match a ShipmentId value previously passed
using the FBA Inbound Shipment Carton Information Feed. If not, the
operation returns the NoPackageContentInformation
error. For more information, see Providing carton contents information. Type: xs:string |
PageType | The page type that you want to print the labels on. | Yes | PageType values:
Submitting a PageType value that is not supported in your marketplace returns an error. Type: xs:string |
PackageLabelsToPrint | A list of identifiers that specify for which packages you want package labels printed. | Yes | Must match CartonId values previously passed using the FBA
Inbound Shipment Carton Information Feed. If not, the operation
returns the IncorrectPackageIdentifier
error code. For more information, see Providing carton contents information. Maximum: 999 Type: xs:string |
Name | Description |
---|---|
TransportDocument | PDF document data and checksum. Type: TransportContent |
For information about standard request requirements, see Required request parameters.
http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01 ?AWSAccessKeyId=AKIAEIAEXAMPLEQCJLSA &Action=GetUniquePackageLabels &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &SellerId=A13EXAMPLE1J56 &SignatureVersion=2 &Timestamp=2015-08-10T00%3A25%3A41Z &Version=2010-10-01 &SignatureMethod=HmacSHA256 &ShipmentId=FBAQFGQZ &PageType=PackageLabel_Letter_6 &PackageLabelsToPrint.member.1=CartonA &PackageLabelsToPrint.member.2=CartonB &PackageLabelsToPrint.member.3=CartonD &PackageLabelsToPrint.member.4=CartonE
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <GetUniquePackageLabelsResponse xmlns="http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/"> <GetUniquePackageLabelsResult> <TransportDocument> <PdfDocument>ABEAAAAAAlbHMucGRmUEsFBgAAAAABAAEAPwAAALQXAQAAAA== </PdfDocument> <Checksum>WGQwqA+NlzMVL1plHc/7ZA==</Checksum> </TransportDocument> </GetUniquePackageLabelsResult> <ResponseMetadata> <RequestId>985a3fa9-3ce2-46fb-a1c7-321439269d2b</RequestId> </ResponseMetadata> </GetUniquePackageLabelsResponse>