查询订单详情接口
更新时间:2022-10-17 打车必须接入,接送机站无需接入。
接口概述
1、该接口用来查询供应商的订单数据。
2、当线上服务发生异常时,携程侧的订单数据可能不完整,此时会调用接口查询供应商的订单详情来修正线上数据。
3、性能要求:供应商需要在2000ms内响应结果。
请求地址
地址格式:
{Domain}/{Channel}/orderdetail/2.0/{timeStamp}/{sign}
请求内容
OrderDetailRequest
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
ctripPurchaseOrderId |
Long |
是 |
携程采购单号 |
881823967638342968 |
18位 |
vendorOrderId |
String |
是 |
供应商订单id |
|
|
serviceProviderId |
Long |
否 |
服务商ID |
1000000 |
用于多服务商接入场景,需要的供应商请联系我方技术添加 |
返回内容
OrderDetailResponse
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
msgCode |
String |
是 |
响应码 |
OK |
响应码 |
message |
String |
否 |
响应详情 |
成功 |
响应码 |
ctripPurchaseOrderId |
Long |
是 |
携程采购单号 |
881823967638342968 |
18位 |
vendorOrderId |
String |
是 |
供应商订单id |
|
|
categoryCode |
String |
是 |
服务类型 |
airport-pickup |
服务类型 |
priceMode |
Integer |
否 |
计价模式 |
|
0-普通计费 1-一口价 |
useTime |
String |
否 |
用车时间 |
|
yyyy-MM-dd HH:mm |
orderStatus |
Integer |
是 |
订单状态 |
|
订单状态 |
passenger |
PassengerInfoDTO |
是 |
乘客信息 |
|
|
agent |
AgentInfoDTO |
否 |
代订人信息 |
|
|
driverInfo |
DriverInfoDTO |
否 |
司机信息 |
|
注1:司机接单后必须有值 |
feeItems |
List<FeeItemDTO> |
否 |
费用明细 |
|
注1:打车场景下,行程结束后必须有值 |
duseLocation |
GeoDTO |
是 |
出发地址 |
|
|
auseLocation |
GeoDTO |
是 |
到达地址 |
|
|
totalFee |
BigDecimal |
否 |
订单总费用(优惠后) |
|
注1:打车场景下,行程结束后必须有值 |
originTotalFee |
BigDecimal |
否 |
优惠前总费用 |
|
|
actualDistance |
Integer |
否 |
实际行驶距离 |
|
|
actualTime |
Integer |
否 |
实际行驶时间 |
|
|
orderTime |
String |
否 |
下单时间 |
|
yyyy-MM-dd HH:mm:ss |
takenTime |
String |
否 |
司机接单时间 |
|
yyyy-MM-dd HH:mm:ss |
readyTime |
String |
否 |
司机就位时间 |
|
yyyy-MM-dd HH:mm:ss |
serviceStartTime |
String |
否 |
服务开始时间 |
|
yyyy-MM-dd HH:mm:ss |
serviceEndTime |
String |
否 |
服务结束时间 |
|
yyyy-MM-dd HH:mm:ss |
paymentTime |
String |
否 |
支付时间 |
|
yyyy-MM-dd HH:mm:ss |
PassengerInfoDTO
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
name |
String |
否 |
用车人姓名 |
张三 |
境内用车场景下必传 |
firstName |
String |
否 |
用车人名 |
San |
Trip站、境外用车场景下必传 |
lastName |
String |
否 |
用车人姓 |
Zhang |
Trip站、境外用车场景下必传 |
localPhoneAreaCode |
String |
否 |
用车人本地电话号码区号 |
+86 |
境内用车场景下必传 |
localPhone |
String |
否 |
用车人本地电话号码 |
13161453199 |
|
maskRealPhone |
String |
否 |
带掩码的乘车人真实电话 |
134**6871 |
|
email |
String |
否 |
用车人邮箱 |
car@ctrip.com |
|
intlPhoneAreaCode |
String |
否 |
用车人目的地国际电话区号,与用车人本地电话号码区号必传其一 |
+44 |
|
intlPhone |
String |
否 |
用车人目的地电话,与用车人本地电话号码必传其一 |
|
|
hotelPhone |
String |
否 |
酒店电话 |
|
|
hotelPhoneAreaCode |
String |
否 |
酒店国际电话区号 |
|
|
emergencyPhone |
String |
否 |
紧急联系人国际电话区号 |
|
|
emergencyPhoneAreaCode |
String |
否 |
紧急联系人电话 |
|
|
imType |
String |
否 |
即时通讯工具 |
WeChat |
WhatsApp/Skype/LINE/WeChat |
imNo |
String |
否 |
及时通讯工具号码 |
|
|
AgentInfoDTO
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
name |
String |
否 |
代订人姓名 |
Isaac Newton |
|
firstName |
String |
否 |
代订人名 |
Isaac |
|
lastName |
String |
否 |
代订人姓 |
Newton |
|
intlPhoneAreaCode |
String |
是 |
代订人国际电话区号 |
+86 |
|
intlPhone |
String |
是 |
代订人电话号码 |
13161453199 |
|
DriverInfoDTO
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
driverId |
String |
否 |
司机id |
|
|
driverName |
String |
是 |
司机名字 |
|
|
driverPhone |
String |
是 |
司机真实电话 |
13161453199 |
仅在虚拟号码失败等应急场景使用 |
driverPhoneCode |
String |
是 |
司机真实电话国家码 |
+86 |
|
driverVirtualPhone |
String |
否 |
司机虚拟电话 |
13177777777 |
对接前请和携程产品沟通虚拟号码绑定逻辑 |
driverVirtualPhoneCode |
String |
否 |
司机虚拟电话国家码 |
+86 |
|
driverAgentVirtualPhone |
String |
否 |
代订人绑定的司机虚拟号 |
13177777777 |
对接前请和携程产品沟通虚拟号码绑定逻辑 |
driverAgentVirtualPhoneCode |
String |
否 |
代订人绑定的司机虚拟号国家码 |
+86 |
|
vehicleNumber |
String |
是 |
车牌号码 |
|
|
vehicleBrand |
String |
是 |
车型品牌 |
|
|
vehicleBrandDetail |
String |
否 |
车型详情 |
|
|
vehicleColor |
String |
是 |
车辆颜色 |
|
|
vehicleType |
Integer |
否 |
车型编码 |
|
|
driverEmail |
String |
否 |
司机邮箱 |
|
|
driverAvaterURL |
String |
否 |
司机头像URL |
|
|
driverImType |
String |
否 |
司机IM类别 |
|
|
driverImNo |
String |
否 |
司机IM号码 |
|
|
dispatcher |
Boolean |
否 |
是否是调度人员 |
|
|
level |
BigDecimal |
否 |
司机星级(最高5.0) |
|
|
extend |
ExtendDTO |
否 |
扩展字段 |
|
|
ExtendDTO
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
nucleicFlag |
Integer |
否 |
核酸检测标签 |
1 |
1-是;0-否 |
vaccineFlag |
Integer |
否 |
新冠疫苗标签 |
0 |
1-是;0-否 |
compliance |
Integer |
否 |
双证合规标签 |
0 |
1-合规 0-不合规 |
FeeItemDTO
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
code |
String |
是 |
费用编码 |
|
费用编码 |
name |
String |
是 |
费用名称 |
|
|
amount |
BigDecimal |
是 |
费用金额 |
|
注1:折扣项的费用金额应该是负数,如折扣金额8元,此处应返回 -8 |
discount |
Boolean |
是 |
是否属于折扣/优惠项 |
|
注1:仅在费用金额为负数的场景下返回true |
GeoDTO
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
address |
String |
是 |
地址 |
携程旅行网(新总部) |
POI名称 |
detailAddress |
String |
是 |
详细地址 |
上海市-长宁区-金钟路968号凌空SOHO16号楼 |
POI详细地址 |
longitude |
BigDecimal |
是 |
经度 |
121.351145 |
精确到小数点后6位,不足6位补0 |
latitude |
BigDecimal |
是 |
纬度 |
31.221373 |
精确到小数点后6位,不足6位补0 |
geoType |
String |
是 |
坐标系类型 |
GCJ02 |
GCJ02;WGS84 |
poiCode |
String |
否 |
携程地址ID信息 |
|
|
cityId |
long |
是 |
城市Id |
258 |
城市ID列表 |
cityName |
String |
否 |
城市名称 |
福州 |
城市ID列表 |
FixedLocationDTO
参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
fixedCode |
String |
是 |
机场三字码/火车站code |
FOC |
注2 |
fixedLocationName |
String |
是 |
机场名称/火车站名称 |
长乐国际机场 |
注3 |
cityId |
String |
是 |
城市Id |
258 |
城市ID列表 |
cityName |
String |
是 |
城市名称 |
福州 |
城市ID列表 |
请求示例
{
"ctripPurchaseOrderId":4297402542489160,
"vendorOrderId":"123456789asdfghjkl"
}
响应示例
{
"msgCode":"OK",
"message":"SUCCESS",
"ctripPurchaseOrderId":4297402542493543,
"vendorOrderId":"123456789asdfghjkl",
"categoryCode":"taxi-ondemand",
"totalFee":100,
"actualDistance":2131231,
"actualTime":2313,
"priceMode":0,
"vehicleType":117,
"useTime":"2022-07-21 20:55",
"duseLocation":{
"address":"天河国际机场T3航站楼",
"detailAddress":"天河国际机场 T3",
"longitude":114.218929,
"latitude":30.771418,
"geoType":"GCJ02",
"cityId":477,
"cityName":"武汉"
},
"auseLocation":{
"address":"武汉纵横奥莱酒店",
"detailAddress":"百联奥特莱斯二期B10栋,黄陂区,武汉,湖北,中国",
"longitude":114.257835,
"latitude":30.733063,
"geoType":"GCJ02",
"cityId":477,
"cityName":"武汉"
},
"passenger":{
"name":"携程客户",
"localPhoneAreaCode":"+86",
"localPhone":"13006351164",
"maskRealPhone":"181yiQA5523",
"email":"",
"intlPhoneAreaCode":"+86",
"intlPhone":""
},
"agent":{
"name":"携程客户",
"intlPhoneAreaCode":"+86",
"intlPhone":"13006351164"
},
"orderStatus":501,
"feeItems":[
{
"code":"START_FEE",
"name":"起步费",
"amount":10,
"discount":false
},
{
"code":"NORMAL_KM_FEE",
"name":"里程费",
"amount":10,
"discount":false
},
{
"code":"LONG_KM_FEE",
"name":"长途费",
"amount":10,
"discount":false
},
{
"code":"NORMAL_TIME_FEE",
"name":"时长费",
"amount":10,
"discount":false
},
{
"code":"OTHER_FEE",
"name":"其他费用",
"amount":10,
"discount":false
}
],
"orderTime":"2022-07-21 10:08:19",
"takenTime":"2022-07-21 10:10:19",
"readyTime":"2022-07-21 10:10:19",
"serviceStartTime":"2022-07-21 10:10:19",
"serviceEndTime":"2022-07-21 10:10:19",
"driverInfo":{
"driverId":"111",
"driverName":"大大师傅",
"driverPhone":"13699286011",
"driverAvaterURL":"http://",
"driverVirtualPhone":"177708316667",
"driverAgentVirtualPhone":"15879011126",
"vehicleType":117,
"vehicleBrand":"大众帕萨特",
"vehicleColor":"黑色",
"vehicleNumber":"京Q19BA9",
"level":4.9,
"driverPhoneLangauge":"DR-ZH"
}
}
异常示例
{
"msgCode": "ERROR_NO_ORDERID",
"message": "找不到订单"
}