查询订单详情接口

更新时间: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": "找不到订单"
}

results matching ""

    No results matching ""