Launch Announcement: “PDF” label format available for EU market

We are excited to announce the launch of PDF label format with Amazon Shipping APIs. With this launch Shippers will now have options to print Amazon Shipping labels via API Integration in any of these formats – PDF, PNG, ZPL.

Why is this important?

The Amazon Shipping API gives shippers programmatic access to Amazon Shipping services, enabling your team to prepare orders quickly and efficiently. As 15% of shippers want the label in PDF format. This allows the shippers to print label in their desired format.

What is the impact of this feature?

Amazon Shipping supports Seller and Shipper requests from both – Sellers selling on Amazon marketplace (Seller Central) and Sellers selling via their website/ other sources (Shipper Central). PDF label option brings parity for both the types of customers. It allows customers to print Amazon Shipping labels via any supported printer and not worry about converting the PNG or ZPL format into PDF. This will allow Amazon Shipping customers to save value time and effort during API integration and development.

How will the PDF option be displayed in the GetRatesV2 response?

The PDF option is made available via Amazon Shipping V2 API. In the response of GetRatesV2 request, the PDF is available as a label option.

Sample getRates response with PDF, PNG and ZPL options:

{
        "availableValueAddedServiceGroups": [
          {
            "groupDescription": "Pickup",
            "groupId": "VAS_GROUP_ID_PICKUP",
            "isRequired": true,
            "valueAddedServices": [
              {
                "cost": {
                  "unit": "GBP",
                  "value": 0.0
                },
                "id": "CARRIER_PICKUP_CHARGE",
                "name": "Carrier Pickup"
              }
            ]
          }
        ],
        "carrierId": "AMZN_UK",
        "carrierName": "Amazon Shipping",
        "promise": {
          "deliveryWindow": {
            "end": "2022-11-05T20:00:00Z",
            "start": "2022-11-05T20:00:00Z"
          },
          "pickupWindow": {
            "end": "2022-11-04T17:30:00Z",
            "start": "2022-11-04T16:30:00Z"
          }
        },
        "rateId": "d5140f63-04d2-4697-b410-9xxxxxxxxxx",
        "requiresAdditionalInputs": false,
        "serviceId": "prime-premium-uk-mfn",
        "serviceName": "Amazon Shipping One-Day Tracked",
        "supportedDocumentSpecifications": [
          {
            "format": "ZPL",
            "printOptions": [
              {
                "supportedDPIs": [300
                ],
                "supportedDocumentDetails": [
                  {
                    "isMandatory": true,
                    "name": "LABEL"
                  }
                ],
                "supportedFileJoiningOptions": [
                  true
                ],
                "supportedPageLayouts": [
                  "LEFT"
                ]
              }
            ],
            "size": {
              "length": 6.0,
              "unit": "INCH",
              "width": 4.0
            }
          },
          {
            "format": "PNG",
            "printOptions": [
              {
                "supportedDPIs": [
                  
                ],
                "supportedDocumentDetails": [
                  {
                    "isMandatory": true,
                    "name": "LABEL"
                  }
                ],
                "supportedFileJoiningOptions": [
                  true
                ],
                "supportedPageLayouts": [
                  "LEFT"
                ]
              }
            ],
            "size": {
              "length": 6.0,
              "unit": "INCH",
              "width": 4.0
            }
          },
          {
            "format": "PDF",
            "printOptions": [
              {
                "supportedDPIs": [
                  
                ],
                "supportedDocumentDetails": [
                  {
                    "isMandatory": true,
                    "name": "LABEL"
                  }
                ],
                "supportedFileJoiningOptions": [
                  true
                ],
                "supportedPageLayouts": [
                  "LEFT"
                ]
              }
            ],
            "size": {
              "length": 6.0,
              "unit": "INCH",
              "width": 4.0
            }
          }
        ],
        "totalCharge": {
          "unit": "GBP",
          "value": x.xx
        }
      }
    ],
    "requestToken": "amzn1.rq.6db4d77e-edf3-4c63-8baf-xxxxxxxxxxxx.101"

Sample purchaseShipment request with PDF label request:

{
    "requestToken": "amzn1.rq.6db4d77e-edf3-4c63-8baf-xxxxxxxxxxxx.101",
    "rateId": "d5140f63-04d2-4697-b410-98a0d485a0b7",
    "requestedDocumentSpecification": {
        "format": "PDF",
        "size": {
            "width": 4,
            "length": 6,
            "unit": "INCH"
        },
        "pageLayout": "LEFT",
        "needFileJoining": true,
        "requestedDocumentTypes": [
            "LABEL"
        ]
    },
    "requestedValueAddedServices": [
        {
            "id": "CARRIER_PICKUP_CHARGE"
        }
    ]
}