Order Flow

Validate Webhook

Place a test order to confirm that Deliverect can validate your webhook (an HTTP callback URL that receives delivery job events)

  1. Create a test order from your test account by following Place a test order.
  2. Select Add Info in the basket and provide a valid delivery address before you place the order.
Basket screen with the Add Info button" caption="Select Add Info in the basket before placing the test order.
Delivery address form for a test order" caption="Enter a valid delivery address for the test order.

Check that the location also has a valid address. Go to Locations, then select Edit for the location.

Locations page with the Edit button for a location" caption="Open the location settings from the Locations page.
Location address settings form" caption="Confirm that the location has a valid address.

After you place the order, Deliverect validates the request to your webhook. Respond according to the samples in the public documentation.


Create Webhook

Once your webhook responds, you can view the order in the Delivery Manager App. Either manually Assign the order to your dispatch channel or wait two minutes for Deliverect to assign the order automatically.

Deliverect posts the event to your Create Webhook URL, which must respond according to the public technical documentation.


Update Endpoint

You can call our Update endpoint to change the delivery job status, courier information, or estimated times of arrival (ETAs) for pick-up and delivery.

The final status is Delivered. The values and relevant specifications are provided in the documentation for the endpoint.

You can track status updates:

  • in the Delivery Manager App (explained here)
  • in your Deliverect staging account by navigating to the Orders page, and selecting the order (explained here).

Cancel Webhook

You can initiate the cancellation of a delivery job using the Delivery Manager App. Find the order and tap More order options.

Order details screen with the More order options menu" caption="Open More order options from the order details screen.

Tap Cancel Delivery. Deliverect calls your Cancel Webhook URL.

More order options menu with Cancel Delivery" caption="Select Cancel Delivery to trigger the cancel webhook.

Your webhook must respond according to the cancel delivery documentation. The app shows a message when the cancellation succeeds.

📘

Create the delivery job without errors before you test the Cancel webhook.


Delivery Logs

You can track any errors that Deliverect receives from a delivery. To do so, find the order on the Orders page and select the Delivery job tab.

Delivery job tab showing delivery logs for an order" caption="Use the Delivery job tab to review delivery errors.