Order Status Updated

Fired when an order's delivery status changes

Overview

The order.status_updated event is triggered when the delivery status of an order gets updated by the driver. This can involve a driver marking an order as delivered, missed, or scheduled for a re-attempt.

The HTTP request body contains the route object with its uuid for reference, and specific order data that is relevant for executing downstream workflows.

Topic Name

order.status_updated

Request Headers

HTTP

content-type: 	application/json
x-routific-signature: v0=96f75bab20672af9db0549863fe1b2c6feagf3233708e0670e642effe7b920703
x-routific-topic: 	order.status_updated
x-routific-event-id: 	evt_nRUoQC3hvBb5zohygsa1iP8eEK
x-routific-timestamp: 	2026-06-10T15:03:58Z

Field	Type	Description
x-routific-event-id	String	Unique identifier for this webhook event. This value should remain the same across retries and can be used as an idempotency key.
x-routific-timestamp	DateTime	Date and Time in UTC for when the webhook delivery attempt was made.
x-routific-signature	String	Signature of the webhook payload and metadata. For HMAC-SHA256 signatures, the value is prefixed with v0=
x-routific-topic	String	Event name of the webhook

Request Body

JSON

{
  "type": "order.status_updated",
  "timestamp": "2024-09-25T14:30:00Z",
  "data": {
    "order": {
      "uuid": "e494bee9-8f01-42b6-9ef2-b61bca2df8f3",
      "uri": "/v1/orders/e494bee9-8f01-42b6-9ef2-b61bca2df8f3",
      "workspaceId": 47,
      "customerOrderNumber": "CUST-1001",
      "routificOrderNumber": "ROUT-20A1",
      "status": "delivered",
      "deliveryTime": "2024-09-25T14:29:52Z",
      "deliveryMissedReason": null,
      "deliveryNotes": "test",
      "location": {
        "address": "510 W 8th Ave, Vancouver, BC V5Z 1C5, Canada",
        "latitude": 49.26413,
        "longitude": -123.11499
      }
    },
    "route": {
      "uuid": "246612f0-f160-4649-bb16-292ebaa43555"
    }
  }
}

Field	Type	Description
type	string	This is the topic name for the event. For this webhook, the value is order.status_updated.
timestamp	string	ISO 8601 timestamp for when the route publish event occurred.
data	object	Event-specific payload containing route, timeline, stop, and order details.
route.uuid	string	Unique identifier of the route.
order.uuid	string	Unique identifier of the order.
order.uri	string	URL endpoint to access additional details about the order.
order.workspaceId	integer	ID of the workspace where the order belongs.
order.customerOrderNumber	string	Customer-provided order number.
order.routificOrderNumber	string	Routific order number. This always uses the ROUT-XXYY format.
order.status	string	Current status of the order. Possible values aredeliveredor missed.
order.deliveryTime	string	Timestamp of when the order's status changed to delivered or missed.
order.deliveryMissedReason	string	The reason chosen by the driver for missing the delivery of the order.
order.deliveryNotes	string	Delivery notes recorded by the driver.
order.location.address	string	Delivery address of the order.
orders.address.latitude orders.address.longitude	integer	Exact delivery location for the order in terms of latitude and longitude.