Skip to main content

Prerequisites

Before using the Delivery API, you must implement a listener for new order events. While the Delivery API is used to transmit updates _to_ ezCater, it does not provide notifications for new orders. That is handled by the Orders API.

How the APIs Work Together

  1. Subscribe to order notifications: Use the Orders API to subscribe to the submitted event for your caterer ID. This ensures ezCater alerts your system the moment a new order is placed.

  2. Receive the webhook: When a delivery order is placed, you will receive an asynchronous notification containing the core order details.

  3. Retrieve the deliveryId: Use the information from the webhook to call the Order Details query. This step is required to obtain the unique deliveryId required for tracking.

  4. Send delivery updates: Using the deliveryId, you can now submit courier assignments, real-time status updates, and other delivery events via the Delivery API as documented above.

Did this answer your question?