Delivery Status Change Notification

Order/

Delivery Status Change Notification
Webhook

Request

This webhook is designed to inform the developer's system whenever there is a change in the status of Keeta Couriers.

Event ID: 1006

Bodyapplication/jsonrequired

orderViewIdinteger, (int64)

Unique identifier for orders on Keeta platform

Example:756823555555859

shopIdinteger, (int64)

Unique identifier of the Keeta store

Example:466663

logisticsStatusinteger

The current operational state of the delivery order in the fulfillment workflow, with the following possible values

Enum Value	Description
0	(Order Created) - The delivery request has been successfully registered in Keeta's system but rider assignment has not yet begun.
10	(Dispatching) - The system is actively searching for and assigning an available rider to fulfill the order.
20	(Rider Assigned) - A rider has accepted the delivery task and is preparing to travel to the merchant location.
25	(Rider Arrived at Store) - The assigned rider has reached the merchant's physical location and is waiting to collect the order.
30	(Order Collected) - The rider has physically received the order package and begun the delivery journey to the customer.
50	(Delivery Completed) - The order has been successfully delivered to and acknowledged by the customer.
99	(Order Cancelled) - The delivery process was terminated.

Example:10

opTimeinteger, (int64)

Time when the event occurred, specified as milliseconds since Jan 1, 1970 (Unix epoch)

Example:1751448108144

courierNamestring

Name of the courier responsible for delivery

Example:"Pony Ma"

courierPhonestring

Phone number of the courier responsible for delivery

Example:"+96342425335"

bigOrderTagboolean

Identifies large orders requiring split delivery:

When bigOrderTag = True, the order is a "Large Order"

When bigOrderTag = False, the order is a standard single-delivery order

Large Order Definition: Orders exceeding logistical capacity thresholds, necessitating division into sub-orders.

Example:false

merchantSubOrderIdinteger, (int64)

Unique identifier for the suborder

Payload

{
  "orderViewId": 756823555555859,
  "shopId": 466663,
  "logisticsStatus": 10,
  "opTime": 1751448108144,
  "courierName": "Pony Ma",
  "courierPhone": "+96342425335",
  "bigOrderTag": false,
  "merchantSubOrderId": 0
}

Responses

Request executed successfully

Bodyapplication/json

codeintegerrequired

A numeric status identifier indicating the result of the interface call, used to determine whether the operation executed successfully.

Enum Value	Description
0	The request was executed successfully.
Non-zero value	The request execution failed. Specific error details can be viewed in the message field.

Example:0

messagestringrequired

Text description corresponding to the status code, explaining the operation result or error cause to users.

Example:"Success"

Response

{
  "code": 0,
  "message": "Success"
}