Driver Status Push
Update Date: 2024-03-26 Mandatory Online test(Sandbox)
Summary
- This interface is used to push driver status information. The prerequisite is that the driver information should be already given, otherwise an error message will be returned.
- If the Vendor does not receive the return message from Ctrip, the vendor should retry 3 times in 5 seconds. Vendor need to ask the driver to push the ACTUAL STATUS during the service, and Ctrip will verify the status of the driver.
API address
API address Format: {Domain}/JNT-{vendorId}/driver/inplace/2.0/{ctripPurchaseOrderID}/{timeStamp}/{sign}
Request Payload
PushDriverStatusRequest
| Parameter | Type | Required | Description | Example | Note |
|---|---|---|---|---|---|
| ctripPurchaseOrderID | Long | Y | Ctrip Purchase Order ID | 881823967638342968 | 18 digital |
| vendorOrderID | String | Y | Vendor's Order ID | Provide by Vendor | |
| vehicleStatus | Integer | Y | Driver Status | 1 | Driver Status List |
Response Payload
PushDriverStatusResponse
| Parameter | Type | Required | Description | Example | Note |
|---|---|---|---|---|---|
| msgCode | String | Y | Response Code | OK | Response Code |
| message | String | N | Response Detail | Success | Response Code |
Request Example
{
"ctripPurchaseOrderID": 881824212456774814,
"vendorOrderID": "1232423",
"vehicleStatus": 1
}
Response Example
{
"msgCode": "OK",
"message": "success",
}
Error Example
{
"msgCode": "ERROR_NO_ORDERID",
"message": "order not found"
}