修改订单信息接口

Point-to-point支持：必须接入

更新时间： 2022-11-06 接送机必须接入，打车无需接入在线调试（沙箱环境）

接口概述

1、该接口用来更新订单信息（如乘客信息、航班信息、航变后的用车时间等）。
2、如果携程未收到确认信息，携程会持续重试3次，每次间隔5秒。如果3次尝试都无信息，携程会通过邮件通知供应商修改用车人信息，由对方客服手动修改。
3、客信息修改可能会发生在下单后、用车前的任何时刻，已经取消的订单不会发生修改。

请求地址

地址格式: {Domain}/JNT/updatepassengerinfo/2.0/{timeStamp}/{sign}

请求内容

UpdatePassengerRequest

参数	类型	接送机站（必填）	点对点（必填）	打车（必填）	描述	示例	备注
ctripPurchaseOrderId	Long	是	是	是	携程采购单号	881823967638342968	18位
vendorOrderId	String	是	是	是	供应商订单id
passenger	PassengerInfoDTO	是	是	是	乘客信息
agent	AgentInfoDTO	否	否	否	代订人信息
flightInfo	FlightInfoDTO	是	否	否	航班信息		仅接送机站场景下必填，点对点和打车场景下无需传值
serviceProviderId	Long	否	否	否	服务商ID	1000000	用于多服务商接入场景，需要的供应商请联系我方技术添加

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

FlightInfoDTO

参数	类型	必传	描述	示例	备注
flightNumber	String	是	航班号	CA1884
takeOffTime	String	否	航班起飞时间，为空表明未发生航变	2020-10-06 18:50:00	yyyy-MM-dd HH:mm:ss计划起飞（当地）时间
flightLandingTime	String	否	航班到达时间，为空表明未发生航变	2020-10-06 21:20:00	yyyy-MM-dd HH:mm:ss 计划到达（当地）时间
departDelayTime	Integer	否	航班到达后延迟用车时间，为空表明未发生航变	20	单位：分钟

返回内容

UpdatePassengerResponse

参数	类型	必传	描述	示例	备注
msgCode	String	是	响应码	OK	响应码
message	String	否	响应详情	成功	响应码

请求示例

{
  "ctripPurchaseOrderId": 4295005950734823,
  "passenger": {
    "name": "李娜",
    "localPhoneAreaCode": "86",
    "localPhone": "13908756327",
    "maskRealPhone": "159***89034"
  },
  "agent": {},
  "flightInfo": {},
}

响应示例

{
  "msgCode": "OK",
  "message": "成功"
}

异常示例

{
  "msgCode": "ERROR_NO_ORDERID",
  "message": "找不到订单"
}

results matching ""

No results matching ""