查询订单详情接口

更新时间： 2021-01-15 接送机站可选接入，打车无需接入 在线调试（沙箱环境）

接口概述

1、该接口用来查询携程订单的部分数据，包括司机信息、用车时间、航班信息等。
2、例如：当供应商通过重新调用司机信息接口更新司机信息失败时，此时携程采购订单司机信息仍为原司机，但供应商自己订单信息已更新为新司机。此时供应商可调用携程订单详情接口来比对数据，重新推司机，以确保双方订单信息一致）
3、此外在航班发生延误等场景也可以利用此接口来更新最新的航班与用车时间信息。
4、当供应商未收到携程的返回值时可发起重试，该接口最多重试三次，每次间隔5秒。

请求地址

地址格式:  {Domain}/JNT-{vendorID}/order/detail/2.0/{ctripPurchaseOrderID}/{timeStamp}/{sign}

请求内容

OrderDetailRequest

参数 类型 必传 描述 示例 备注
ctripPurchaseOrderID Long 是 携程采购单号 881823967638342968 18位
vendorOrderID String 是 供应商订单id   供应商订单id

返回内容

OrderDetailResponse

参数 类型 必传 描述 示例 备注
ctripMasterOrderID Long 是 携程用户单号 12550815666 11位
ctripPurchaseOrderID Long 是 携程采购单号    
vendorOrderID String 是 供应商订单号    
orderStatus String 是 订单状态 CANCELLED 携程订单状态
passengerInfoDO PassengerInfoDTO 是 乘客信息    
driverInfo OrderDetailDriverInfoDTO 否 司机信息    
cancelDetail OrderDetailCancelDetailDTO 否 取消原因    
orderDetailRuleDO OrderDetailRuleDTO 否 订单重要时间节点   下单后有值，订单取消或完成后为空。包括最晚确认时间、最晚确认司机时间、预计用车时间
orderDetailFlightInfo OrderDetailFlightInfoDTO 否 航变信息   发生航变才会有值，需要单独联系携程产研接入
msgCode String 是 响应码 OK 响应码
message String 否 响应详情 成功 响应码

PassengerInfoDTO

参数 类型 必传 描述 示例 备注
name String 否 用车人姓名，境内用车场景下必传 张三  
firstName String 否 用车人名 San Trip站、境外用车场景下必传
lastName String 否 用车人姓 Zhang Trip站、境外用车场景下必传
mobile String 否 用车人本地电话号码 13161453199 境内用车场景下必传，为虚拟号码，只有绑定的司机可以拨通。境外为真实号码
realPhoneMask String 否 带掩码的乘车人真实电话 134**6871  
email String 否 用车人邮箱 car@ctrip.com  
intlAreaCode String 否 用车人目的地国际电话区号，与用车人本地电话号码区号必传其一 +44  
intlMobile String 否 用车人目的地电话，与用车人本地电话号码必传其一    
hotelTel String 否 酒店电话    
hotelTelCode String 否 酒店国际电话区号    
emergencyTel String 否 紧急联系人国际电话区号    
emergencyTelCode String 否 紧急联系人电话    
bookedByTel String 否 代订人电话区号    
bookedByTelCode String 否 代订人电话    
wechatNo String 否 微信号    
messageAppType String 否 即时通讯工具 WeChat WhatsApp/Skype/LINE/WeChat
messageAppNo String 否 及时通讯工具号码    
passengerType Integer 否 1.联系人 2.乘车人（传一人时默认同一人）    

OrderDetailDriverInfoDTO

参数 类型 必传 描述 示例 备注
driverStatus Integer 是 司机状态 1 司机状态列表
driverName String 是 司机名字    
driverPhone String 是 司机电话    
driverPhoneCode String 是 司机电话国家码    
driverVirtualPhone String 否 司机虚拟电话 13177777777 对接前请和携程产品沟通虚拟号码绑定逻辑
driverVirtualPhoneCode String 否 司机虚拟电话国家码 +86  
driverAgentVirtualPhone String 否 代订人绑定的司机虚拟号 13177777777 对接前请和携程产品沟通虚拟号码绑定逻辑
driverAgentVirtualPhoneCode String 否 代订人绑定的司机虚拟号国家码 +86  
vehicleNumber String 是 车牌号码    
vehicleBrand String 是 车型品牌    
vehicleBrandDetail String 否 车型详情    
vehicleColor String 是 车辆颜色    
driverEmail String 否 司机邮箱    
driverAvaterURL String 否 司机头像URL    
driverImType String 否 司机IM类别    
driverImNo String 否 司机IM号码    
dispatcher Boolean 否 是否是调度人员    

OrderDetailCancelDetailDTO

参数 类型 必传 描述 示例 备注
cancelReason String 是 供应商订单取消原因 CONFIRMED 当dispatched=TRUE时为改派类别。 CONFIRMING:确认前改派，CONFIRMED:确认后改派，NOSHOW:确认后无车改派
cancelReasonDetail String 否 供应商订单取消原因详情 OTA 当dispatched=TRUE时为改派来源。OPERATOR:客服改派，OTA:供应商无法服务申请改派，CUSTOMER:用户改派，SYSTEM:系统改派。
dispatched Boolean 是 是否跨供应商改派 TRUE TRUE为订单以改派给其他供应商，FALSE为订单已取消。
customerLostFee BigDecimal 是 用户损失费 0 当dispatched=TRUE时，为0。
vendorLostFee BigDecimal 是 供应商损失费 20 当dispatched=TRUE时，为无法服务罚款。

OrderDetailRuleDTO

参数 类型 必传 描述 示例 备注
lastConfirmTime String 是 最晚确认订单时间 2020-08-28 14:46 最晚需要请求订单确认接口确认接单的时间
lastPushDriverTime String 是 最晚确认司机时间 2020-08-29 14:46 最晚需要请求司机信息推送接口的时间
sysExpectBookTime String 否 预估用车时间 2020-08-30 09:46 可能为空值（注1）

注

1.只有在下单后预计用车时间发生变动才会有值，请供应商按照最新的预估用车时间服务。

OrderDetailFlightInfoDTO

参数 类型 必传 描述 示例 备注
flightNo String 是 航班号 CA1888  
arrAirportCode String 是 起飞机场三字码 PVG  
deptAirportCode String 是 到达机场三字码 XIY  
planDepTime String 是 计划起飞时间 2020-08-28 14:46  
expectDepTime String 否 预计起飞时间 2020-08-28 13:46 可能为空值（注2）
actualDepTime String 否 实际起飞时间 2020-08-28 13:40 可能为空值（注2）
planArrTime String 是 计划落地时间 2020-08-28 16:40  
expectArrTime String 否 预计落地时间 2020-08-28 16:50 可能为空值（注3）
actualArrTime String 否 实际落地时间 2020-08-28 17:10 可能为空值（注3）

注

2.只有在下单后航班状态发生变动才会有值。 3.落地时间指的是航班绝对的降落时间，不包含用户走出机场的时间，也不等于用车时间。

请求示例

{
    "ctripPurchaseOrderID": 881824212456774814,
    "vendorOrderID": "1232423"
}

响应示例

{
    "msgCode": "OK",
    "ctripMasterOrderID": 12732069098,
    "ctripPurchaseOrderID": 881824212456774814,
    "vendorOrderID": "20A6GFTHZUZBRF",
    "orderStatus": "cancelled",
    "cancelDetail": {
        "cancelReason": "行程有变，暂不需要用车",
        "cancelReasonDetail": "147",
        "customerLostFee": 0,
        "vendorLostFee": 174.00
    }
}

异常示例

{
    "msgCode": "Error",
    "massage": ""
}

results matching ""

    No results matching ""