# Package tracking push notifications

# Package tracking push notifications

The package tracking push notification provides real-time tracking updates for Amazon Business orders. Notifications are automatically sent to your webhook endpoint when package tracking status changes occur. You can use the data in this notification to build event-based notification systems, such as email alerts. Each notification also includes all the data necessary to call the Package Tracking API, allowing you to pull more detailed information about each package. For more information, see [Package tracking overview](https://developer-docs.amazon.com/amazon-business/docs/package-tracking-overview).

> 📘
>
> Package tracking notifications are sent for Amazon Business orders that are placed from external systems, such as using Ordering API and Punchout. Package tracking notifications are not sent for orders placed directly from the Amazon Business website.

## Push notification reference

Each push notification contains the following details:

| Name                          | Description                                                   |
| ----------------------------- | ------------------------------------------------------------- |
| `orderId`                     | The unique identifier of an order.                            |
| `trackingId`                  | The unique tracking identifer of the shipment.                |
| `shipmentId`                  | The unique identifier for a shipment.                         |
| `packageId`                   | The unique identifier of the package.                         |
| `poNumber`                    | The purchase order number used to retrieve associated orders. |
| `eventTimeStampInEpochMillis` | The event time stamp in epoch milliseconds.                   |
| `deliveryStatus`              | The current delivery status of the package.                   |
| `detailedTrackingStatus`      | The detailed tracking status of the package.                  |

The `deliveryStatus` and `detailedTrackingStatus` can display the following combinations of values. Each `detailedTrackingStatus` event triggers a notification.

| `detailedTrackingStatus` values                    | `deliveryStatus` values |
| -------------------------------------------------- | ----------------------- |
| `PACKAGE_DEPARTED_FROM_FC_SHIPPER_SELLER`          | `SHIPPED`               |
| `PACKAGE_ARRIVED_AT_CARRIER_FACILITY - (CityName)` | `SHIPPED`               |
| `PACKAGE_LEFT_FROM_CARRIER_FACILITY - (CityName)`  | `SHIPPED`               |
| `PACKAGE_OUT_FOR_DELIVERY`                         | `OUT_FOR_DELIVERY`      |
| `PACKAGE_DELIVERED_TO_CUSTOMER`                    | `DELIVERED`             |
| `PACKAGE_ESTIMATED_DELIVERY_DATE_CHANGED`          | `DELAYED`               |
| `PACKAGE_AVAILABLE_FOR_PICKUP`                     | `DELIVERED`             |

> 📘
>
> Note that the city name is optional in the `PACKAGE_ARRIVED_AT_CARRIER_FACILITY - (CityName)` and `PACKAGE_LEFT_FROM_CARRIER_FACILITY - (CityName)` detailed tracking status values. If the city name is not provided by the shipment carrier, the notification will not include the city name.

```json Sample notification
 { 
      "orderId":"111-7245942-7232256",
      "trackingId":"9361289724456641938913",
      "shipmentId":"433631239441301",
      "packageId":"1",
      "poNumber":"NWMD-NWMD01446",
      "eventTimeStampInEpochMillis":1763581440000,
      "deliveryStatus":"SHIPPED",
      "detailedTrackingStatus":"PACKAGE_ARRIVED_AT_CARRIER_FACILITY - BHIWANDI"
 }
```

## Receiving notifications

### Prerequisites

Before proceeding, ensure you have the following:

1. An Amazon Business account. For more information, see [Onboarding Step 1](https://developer-docs.amazon.com/amazon-business/docs/register-as-a-developer).
2. An HTTPS webhook URL endpoint to receive the notifications.

### Subscribe to notifications

To receive package tracking push notifications, complete the following steps:

1. Determine the account identifier you’d like to use to retrieve notifications. The identifier determines the level at which you receive notifications:

| Identifier                 | Notification level                                                                                                            |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Amazon Business group ID   | Receive notifications for all orders placed using the specified group.                                                        |
| Amazon Business account ID | Receive notifications for all orders placed using your Amazon Business account.                                               |
| Application ID             | Receive notifications for all orders associated with an Amazon Business API application ID in Solution Provider Portal (SPP). |

2. Provide the following details to your Amazon Business technical contact:
   1. Your chosen identifier
   2. Your webhook URL endpoint

Once you provide these details, Amazon Business will enable your account to receive notifications. Once enabled, you will start receiving notifications whenever a package tracking event occurs. For package tracking event specifications, see [Push notification reference](#push-notification-reference).

> 📘
>
> Notifications are sent for any package tracking events that occur after onboarding, including events for shipments that are already currently in progress.