Pre-Launch Announcement: Label Customisation for UK Non-Amazon marketplace volume (OFF-Amazon)

We are excited to announce the “Label Customisation” feature. This feature allows the Amazon Shipping API customers to add internal reference Id or Seller Name on the shipping labels.

Why is this important?

The Amazon Shipping API gives shippers programmatic access to Amazon Shipping services. By enabling the "requestedLabelCustomization/requestAttributes/ (PACKAGE_CLIENT_REFERENCE_ID or SELLER_DISPLAY_NAME” field we provide a seamless way to display the seller’s name or reference Id on the label. We are confident this experience of label customisation will be more engaging and tailored to end customer needs and the details on this feature can significantly streamline warehouse operations and improve the customer experience!

The Challenge We Sought to Address

Across the globe, shippers have voiced a growing demand for more control over the information displayed on their shipping labels. Details that can significantly streamline warehouse operations and improve the customer experience!

The Custom Labels Solution

Label Customisation - a transformative new feature that empowers you to add a variety of artifacts to their Amazon Shipping labels. We with our initial launch, you'll be able to add:

• Package Client ReferenceId: Shippers will be able to include the internal order's identification number or reference Id on the label. This will help them correlate the label to the specific package within their warehouse, ensuring the right products are sent to the right customers.
• Seller Name: Shippers will be able to display their business name on the label. For third-party logistics providers fulfilling orders on behalf of sellers, this field can be used to inform the recipient of the originating seller

How can I create a custom label for my Amazon Shipping parcel?

The custom label will be made available via Amazon Shipping V2 API (PurchaseShipment API and oneClickShipment API For Off-Amazon). The entire configuration process is a straightforward, simple integration and need to add an object in purchaseShipment or oneClickShipment API mentioning what field should appear on label.

Below, please find a sample of the change required to get started!

"requestedLabelCustomization": {	//Object to be included for label customisation
"requestAttributes": [   // requestAttributes is an Array, please include the field names that needs to be displayed on label
        "PACKAGE_CLIENT_REFERENCE_ID",
        "SELLER_DISPLAY_NAME"
    ]
}

Note: requestedLabelCustomization is optional, if this is not passed in the request then default standard label will be created.

Sample purchaseShipment API request with Label Customisation fields:

{
  "requestToken": "amzn1.rq.85432213067105.100",
  "rateId": "75ec65c101bdb68ac979032268ba119ec17dda9a5e84312351bd9503a1bc058b1721804036099",
  "requestedDocumentSpecification": {
    "format": "PDF",
    "size": {
      "width": 4,
      "length": 6,
      "unit": "INCH"
    },
    "dpi": 203,
    "pageLayout": "DEFAULT",
    "needFileJoining": false,
    "requestedDocumentTypes": [
      "LABEL"
    ],
    "requestedLabelCustomization": {
      "requestAttributes": [
        "PACKAGE_CLIENT_REFERENCE_ID",
        "SELLER_DISPLAY_NAME"
      ]
    }
  }
}

Sample oneClickShipment API request with Label Customisation fields:

{
  "shipTo": {
    "name": "TEST ",
    "addressLine1": "XX Darcy Road",
    "city": "Ashtead",
    "stateOrRegion": "Surrey",
    "postalCode": "KTXX XXL",
    "countryCode": "GB",
    "phoneNumber": "44012345678",
    "email": "recepient-test@amazon.com"
  },
  "shipFrom": {
    "name": "TEST Seller",
    "addressLine1": "55 avenue",
    "city": "Milton Keynes",
    "countryCode": "GB",
    "postalCode": "XXX XXX",
    "email": "contact-seller@amazon.com"
  },
  "serviceSelection": {
    "serviceId": [
      "SWA-UK-PREM"
    ]
  },
  "packages": [
    {
      "sellerDisplayName": "A TEST Seller",
      "insuredValue": {
        "unit": "GBP",
        "value": 29.98
      },
      "weight": {
        "unit": "KILOGRAM",
        "value": 1.14
      },
      "items": [
        {
          "quantity": 1,
          "itemValue": {
            "unit": "GBP",
            "value": 1.99
          },
          "description": "Supplements",
          "weight": {
            "unit": "KILOGRAM",
            "value": 1.0
          },
          "itemIdentifier": "64618560956686",
          "isHazmat": false,
          "productType": "Medicine"
        }
      ],
      "isHazmat": false,
      "packageClientReferenceId": "ORDER-12345",
      "dimensions": {
        "unit": "CENTIMETER",
        "length": 3,
        "width": 3.14159,
        "height": 3.14159
      }
    }
  ],
  "labelSpecifications": {
    "dpi": 300,
    "format": "PNG",
    "needFileJoining": false,
    "pageLayout": "DEFAULT",
    "requestedDocumentTypes": [
      "LABEL"
    ],
    "size": {
      "length": 6.0,
      "unit": "INCH",
      "width": 4.0
    },
    "requestedLabelCustomization": {
      "requestAttributes": [
        "PACKAGE_CLIENT_REFERENCE_ID",
        "SELLER_DISPLAY_NAME"
      ]
    }
  },
  "channelDetails": {
    "channelType": "EXTERNAL"
  }
}

Note: The new element, requestedLabelCustomization/requestAttributes, needs to be added to the purchaseShipmentAPI, specifying the field names(Ex : PACKAGE_CLIENT_REFERENCE_ID or SELLER_DISPLAY_NAME ) you want to include on the label.

Field-Name: requestedLabelCustomization (optional)

Field-Type: A request label customisation object

Label customization values:

When will this change be launched?

The Custom Labels feature will be available in early April'25 for Off-Amazon Shippers in the UK.

What’s Next?

The launch of Customized Labels is just the beginning. In our upcoming release, shippers will be able to include product SKUs and utilize freeform text fields to add more information. We're also expanding our custom label features to support MFN (Merchant Fulfilled Network)/ON Amazon orders. Stay tuned for more updates as we work to continuously enhance the Customized Labels feature to meet the changing needs of our shippers.

FAQs:

1. What are Custom Labels in Amazon Shipping?
   Custom Labels is a new feature that allows shippers to add specific information such as Internal order reference Id, and Seller Name to their Amazon Shipping labels, providing greater flexibility and control over label content.

2. Who can use the Custom Labels feature?
   Amazon shipping OFF Amazon shippers in the United Kingdom can use this feature, starting from April

3. How do I get started with Custom Labels?.
   To get started, review the updated Amazon Shipping V2 API documentation. In the purchaseShipment or oneClickShipment API, add the additionalLabelAttributes field, specifying the names of the fields you want to display on the label (Please refer the sample API request provided above).

4. Are there any character limits for custom text fields like Seller Name or orderId?
   Yes, there are character limits to ensure the information fits within the label design.
   For UK Character limit for OrderId/PackageClientReferenceId is 20 Characters and limit Seller Name 20 Characters.
   The exact limits will be detailed in the API documentation.
   Note : If the value provided in the fields exceeds the character limit, the API request will not fail. Instead, the system will truncate the input, selecting the first 20 characters(For UK :OrderId/PackageClientReferenceId, and Seller Name) and display them on the label.

5. Can I keep using PurchaseShipment or OneclickShipment API after the rollout of new fields?
   Yes, you can continue using your API without mapping the new fields, ensuring backward compatibility.