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
Subscribe to order notifications: Use the Orders API to subscribe to the
submittedevent for your caterer ID. This ensures ezCater alerts your system the moment a new order is placed.Receive the webhook: When a delivery order is placed, you will receive an asynchronous notification containing the core order details.
Retrieve the
deliveryId: Use the information from the webhook to call the Order Details query. This step is required to obtain the uniquedeliveryIdrequired for tracking.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.
