Launch Announcement: “Delivery Notes” field is available WW

We are excited to launch the “Delivery Notes” feature. This feature will allow customers to provide delivery instructions via APIs for Amazon Shipping carrier. The instructions provided will only be displayed to the delivery personnel in the portable delivery device. The instructions will not be printed on the labels.

How will this feature benefit the end recipient?

Delivery Notes let customers send delivery instructions, like leaving the package in a shaded area, through API requests to make sure their packages are delivered correctly. These notes are then combined with any other instructions the customer has saved on their Amazon retail account for their deliveries.

How does it work?

Shippers can incorporate a "shipperInstruction" field when using either the getRates or oneClickShipment API to capture delivery notes for individual parcels.

"shipperInstruction":
{
"deliveryNotes": "Please ring the doorbell when you arrive"
}

The deliveryNotes field can accommodate up to 250 characters. However, if the character count exceeds the 250 Char limit, it will not be transmitted to the Delivery personnel's device.

Conditional Logic:

1. If recipient instructions are associated with the Amazon retail account and match the email Id, delivery address, and phone number provided in the shipTo field in the API request for delivery notes, both recipient instructions and delivery notes are sent to the Delivery personnel's device.
2. If no recipient instructions are associated with the Amazon retail account or if any of the provided fields like email Id, delivery address, and phone number do not match, only the delivery note sent via the API is sent to Delivery personnel's device.

Sample getRates API request with shipperInstruction field:

{  
  "shipTo": {  
    "name": "TEST",  
    "addressLine1": "Stamford Bridge",  
    "addressLine2": "SWA Test Account",  
    "stateOrRegion": "London",  
    "city": "London",  
    "countryCode": "GB",  
    "postalCode": "B** **Z",
    "email": "[email protected]", 
    "phoneNumber": "0123456789"
  },  
  "shipFrom": {  
    "name": "2DD test",  
    "addressLine1": "68 ***** *d",  
    "addressLine2": "SWA Test Account",  
    "stateOrRegion": "B********",  
    "city": "B********",  
    "countryCode": "GB",  
    "postalCode": "B** **Z"  
  },
  "shipperInstruction":  
    {  
        "deliveryNotes": "Please ring the doorbell when you arrive"  
    }
  "packages": [  
    {  
      "dimensions": {  
        "length": 30,  
        "width": 33,  
        "height": 21.50,  
        "unit": "CENTIMETER"  
      },  
      "weight": {  
        "unit": "KILOGRAM",  
        "value": 2.00  
      },  
      "items": [  
        {  
          "quantity": 1,  
          "itemIdentifier": "A91-062-1/1",  
          "description": "Item Description",  
          "isHazmat": false,  
          "weight": {  
            "unit": "KILOGRAM",  
            "value": 2.00  
          }  
        }  
      ],  
      "insuredValue": {  
        "unit": "GBP",  
        "value": 10.00  
      },  
      "packageClientReferenceId": "REF12345"
    }  
  ],  
  "channelDetails": {  
    "channelType": "EXTERNAL"  
  }  
}

Please be advised that the Shipper's Instructions are provided solely as a guidance tool to inform and assist the Delivery Associate in the delivery process and do not constitute a warranty or guarantee of successful delivery. Compliance with such instructions is at the discretion of the Delivery Associate and is not mandatory. Therefore, while the Shipper may provide specific instructions, adherence to these instructions is not compulsory for the Delivery Associate.