added
Launch Announcement: Introduction of Small Shipping Labels in Amazon Shipping APIs only for India
4 days ago
The purpose of this announcement is to notify shipping integrators about the addition of small shipping label options in the Amazon Shipping API for the Indian market.
What's New?
We are introducing new label size options to accommodate various shipping needs, particularly beneficial for beauty D2C brands, documents (passport, credit cards, gift cards), and other small-dimension packages.
The two new label sizes being introduced are:
• 2" (l) x 3" (w)
• 3" (l) x 4" (w)
The label size already supported is 6” (l) x 4” (w)
Key Features:
- New label size options in purchaseShipment API and OneClickShipment API.
- Simplified smaller label formats with essential information.
- Compatible single and bulk shipment creation workflows.
How It Works?
The APIs already include functionality to specify label size preference at the shipment level. We will allow adding two new dimensions other than the existing 6”x 4”.
Schema Changes
{
"requestToken": "amzn1.rq.99343242158747.100",
"rateId": "3a33109f23f0926b2c40529fbcb1b7210fc427b98da116860c3c58fa8f9a2d661727350449486",
"requestedDocumentSpecification": {
"format": "PDF",
"size": {
"width": 4.0, // Shippers can now add 3” OR 4” as width
"length": 6.0,// Shippers can now add 2” (with 3" as width)
// OR 3” (with 4’’ as width) OR 6” (with 4’’ as width) as length
"unit": "INCH"
},
"dpi": 300,
"pageLayout": "DEFAULT",
"needFileJoining": false,
"requestedDocumentTypes": [
"LABEL"
],
"requestedLabelCustomization": {
"requestAttributes": [
"PACKAGE_CLIENT_REFERENCE_ID",
"COLLECT_ON_DELIVERY_AMOUNT"
]
}
},
"requestedValueAddedServices": [
{
"id": "CollectOnDelivery"
}
]
}
{
"shipTo": {
"name": "Test Test",
"addressLine1": "Hyderabad King koti, King koti Hyderabad",
"addressLine2": "30, Aryan Mahal, 6th Floor, C Road, before intercontinental",
"addressLine3": "string",
"companyName": "new",
"stateOrRegion": "telangana",
"city": "hyderabad",
"countryCode": "IN",
"postalCode": "500008"
},
"shipFrom": {
"name": "Shipper_Test",
"addressLine1": "1st Floor, World Trade Center, Brigade Gateway",
"companyName": "DocX-Test",
"stateOrRegion": "Karnataka",
"city": "Bengaluru",
"countryCode": "IN",
"postalCode": "560055"
},
"packages": [
{
"dimensions": {
"length": 13,
"width": 9,
"height": 17,
"unit": "CENTIMETER"
},
"weight": {
"unit": "GRAM",
"value": 400
},
"insuredValue": {
"value": 10,
"unit": "INR"
},
"isHazmat": false,
"sellerDisplayName": "new place",
"charges": [
{
"amount": {
"value": 150,
"unit": "INR"
},
"chargeType": "TAX"
}
],
"packageClientReferenceId": "12345",
"items": [
{
"itemValue": {
"value": 2,
"unit": "INR"
},
"description": "description of item1",
"itemIdentifier": "item-11111",
"quantity": 1,
"weight": {
"unit": "GRAM",
"value": 400
},
"isHazmat": false,
"productType": "health care",
"invoiceDetails": {
"invoiceNumber": "1234567",
"invoiceDate": "2022-05-31T18:28:43Z"
}
}
]
}
],
"valueAddedServiceDetails": [
{
"id": "CollectOnDelivery",
"amount": {
"unit": "INR",
"value": 30
}
}
],
"taxDetails": [
{
"taxType": "GST",
"taxRegistrationNumber": "anbp1234"
}
],
"channelDetails": {
"channelType": "EXTERNAL"
},
"serviceSelection": {
"serviceId": [
"SWA-IN-OA"
]
},
"labelSpecifications": {
"format": "PDF",
"size": {
"width": 4, // Shippers can now add 3" OR 4" as width
"length": 6, // Shippers can now add 2" (with 3" as width)
// OR 3” (with 4" as width) OR 6" (with 4" as width) as length
"unit": "INCH"
},
"requestedLabelCustomization": {
"requestAttributes": [
"PACKAGE_CLIENT_REFERENCE_ID",
"COLLECT_ON_DELIVERY_AMOUNT"
]
},
"dpi": 203,
"pageLayout": "DEFAULT",
"needFileJoining": false,
"requestedDocumentTypes": [
"LABEL"
]
}
}
//This error message appears only for IN market. Other marketplaces to be remained unchanged.
{
"errors": [
{
"code": "InvalidInput",
"message": "Invalid input.",
"details": "Amazon Shipping doesn't support requested document size. Supported sizes(LxW, Unit=INCH): 6.0x4.0, 2.0x3.0, 3.0x4.0"
}
]
}
Important Notes:
- Smaller labels will continue to support addition/ deletion of ‘Order ID’
- Bulk manifestation will allow single label-size selection within a single upload.
- Amazon Shipping will continue to support 3 formats (PDF, PNG, ZPL) for Label and DPI- 300, 203.
FAQs:
- Which label sizes are supported in the initial release?
The initial release will support 2"x 3" labels and 3"x 4" labels. - Can I customize fields on smaller labels?
The presently customizable field-Order ID will be available in both Small Label sizes. - What happens to reverse labels for packages with small shipping labels?
In the initial release, reverse labels will be printed in the standard 6"x 4" size in Amazon network. Future releases will support smaller sizes for reverse labels. - What happens if a shipper ends up sharing any other dimensions other than the supported ones?
Amazon Shipping will not allow any other dimensions, other than mentioned above, and will throw error in shipment creation.