订单确认接口
更新时间:2022-11-06 在中国大陆提供服务的供应商建议接入,在中国港澳台地区及中国境外提供服务的供应商必须接入,打车无需接入。 在线调试(沙箱环境)
接口概述
1、该接口为延后派模式确认服务接口。回调该接口代表确认服务订单,并会在最晚派司机时间前提供司机信息,否则承担相应的判罚。
2、若不选择延后派模式的供应商可跳过此步骤,在携程下单后立即指派司机以确认接单。
3、携程会对请求内容中的国家码、电话进行合法性校验。当供应商未收到携程的返回值时应当发起重试,该接口最多重试三次,每次间隔5秒。
4、最晚派司机时间可在接入该接口前联系携程商务和技术确认。
请求地址
地址格式: {Domain}/JNT-{vendorID}/order/confirm/2.0/{ctripPurchaseOrderID}/{timeStamp}/{sign}
请求内容
ConfirmOrderRequest
参数 | 类型 | 必传 | 描述 | 示例 | 备注 |
---|---|---|---|---|---|
ctripPurchaseOrderID | Long | 是 | 携程采购单号 | 881823967638342968 | 18位 |
vendorOrderID | String | 是 | 供应商订单号 | 供应商自己的订单号 | |
connectTel | String | 是 | 调度电话/客服电话 | ||
connectTelCode | String | 是 | 调度电话/客服电话 国家码 | +86 | |
connectTelLanguage | String | 否 | 调度电话/客服电话 语言类别 | CO-ZH | 客服语言 |
connectEmail | String | 否 | 调度邮箱地址 | ||
connectImType | String | 否 | 调度IM类别 | LINE | WhatsApp,Skype,LINE,WeChat |
connectImNo | String | 否 | 调度IM号码 | ||
pickUpLocationDesc | String | 否 | 接驳点详细信息 | ||
pickUpLocationImgUrl | String | 否 | 接驳点图片详细信息 |
返回内容
ConfirmOrderResponse
参数 | 类型 | 必传 | 描述 | 示例 | 备注 |
---|---|---|---|---|---|
msgCode | String | 是 | 响应码 | OK | 响应码 |
message | String | 否 | 响应详情 | 成功 | 响应码 |
请求示例
{
"ctripPurchaseOrderID": 881824251234568435,
"vendorOrderID": "424323432",
"pickUpLocationDesc": "",
"pickUpLocationImgUrl": "",
"connectTel": "3434245665",
"connectTelCode": "+86",
"connectTelLanguage": "",
"connectEmail": "",
"connectImType": "",
"connectImNo": ""
}
响应示例
{
"msgCode": "OK",
"massage": "成功"
}
异常示例
{
"msgCode": "ERROR_URL_PARAM",
"massage": "错误的URL格式"
}