确认接单接口
更新时间: 2022-10-17 打车必须接入(对接前请先沟通),接送机站无需接入。 在线调试(沙箱环境)
接口概述
1、该接口在预接单模式下用来通知供应商司机接单成功。
2、供应商推送司机后,平台会在一段时间内决策是否由该司机接单,决策结束后会调用本接口通知供应商接单成功;
3、如果超过一段时间仍未收到通知,并且平台也没有取消订单,供应商可自行调用无法服务接口取消订单(具体的决策时长和超时取消时长请在对接时沟通确认)。
4、性能要求:供应商需要在500ms内响应结果。
请求地址
地址格式: {Domain}/RTN/acceptorder/2.0/{timeStamp}/{sign}
请求内容
CancelOrderRequest
参数 | 类型 | 必传 | 描述 | 示例 | 备注 |
---|---|---|---|---|---|
ctripPurchaseOrderId | Long | 是 | 携程采购单号 | 881823967638342968 | 18位 |
vendorOrderId | String | 是 | 供应商订单id | ||
driverId | String | 否 | 司机ID | ||
serviceProviderId | Long | 否 | 服务商ID | 1000000 | 用于多服务商接入场景,需要的供应商请联系我方技术添加 |
返回内容
CancelOrderResponse
参数 | 类型 | 必传 | 描述 | 示例 | 备注 |
---|---|---|---|---|---|
msgCode | String | 是 | 响应码 | OK | 响应码 |
message | String | 否 | 响应详情 | 成功 | 响应码 |
orderAccepted | Boolean | 是 | 是否可服务 | true | 如返回false,订单将改派给其他司机 |
请求示例
{
"ctripPurchaseOrderId":4297402542485245,
"vendorOrderId":"123456789asdfghjkl"
}
响应示例
{
"msgCode":"OK",
"message":"SUCCESS",
"orderAccepted":true
}
异常示例
{
"msgCode": "ERROR_NO_ORDERID",
"message": "找不到订单"
}