Update Delivery Tracking Information

Request

This endpoint allows merchants to provide real-time delivery tracking updates for merchant self-delivery orders, including ETA(estimated time of arrival) and courier location coordinates.

Notes:

This API is exclusively for merchant self-delivery orders where the merchant manages their own delivery service.
Regular updates help improve customer experience by providing accurate delivery estimates and tracking.
Coordinate information should use GPS coordinates with precision of 6 decimal places for accuracy.
At least one tracking parameter (besides orderViewId) must be provided in each request.
Time Range Requirements: estimatedTimeStampLeft and estimatedTimeStampRight must both have values or both be omitted. You cannot provide only one of these fields.
Coordinate Requirements: courierCoordinateLng and courierCoordinateLat must both have values or both be omitted. You cannot provide only one coordinate.

Bodyapplication/jsonrequired

orderViewIdinteger, (int64)required

Unique identifier for orders on Keeta platform

Example:1186341416633223

estimatedTimeStampLeftinteger, (int64)

Left boundary of estimated delivery time range in Unix timestamp milliseconds. Must be provided together with estimatedTimeStampRight or both omitted.

Example:1754432190391

estimatedTimeStampRightinteger, (int64)

Right boundary of estimated delivery time range in Unix timestamp milliseconds. Must be provided together with estimatedTimeStampLeft or both omitted.

Example:1754432190391

estimatedTimeStampinteger, (int64)

Estimated delivery time in Unix timestamp milliseconds

Example:1754432190391

courierCoordinateLngnumber, (double)

Courier longitude coordinate (GPS), precision recommended to 6 decimal places. Must be provided together with courierCoordinateLat or both omitted.

Example:103.819998

courierCoordinateLatnumber, (double)

Courier latitude coordinate (GPS), precision recommended to 6 decimal places. Must be provided together with courierCoordinateLat or both omitted.

Example:51.296999

curl -i -X POST \
  https://open.mykeeta.com/api/open/delivery/merchant/self/delivery/callback \
  -H 'Content-Type: application/json' \
  -d '{
    "orderViewId": 1186341416633223,
    "estimatedTimeStampLeft": 1754432190391,
    "estimatedTimeStampRight": 1754432190391,
    "estimatedTimeStamp": 1754432190391,
    "courierCoordinateLng": 103.819998,
    "courierCoordinateLat": 51.296999
  }'

Responses

Delivery tracking information update successful

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"
}