Update Order

Update Date: 2022-12-12 Mandatory Online test(Sandbox)

Summary

1、This interface can be used to update the order info.
2、If Ctrip does not receive result, we will retry 3 times in 5 second. 3、The customer information might be modified at any time during the order is placed and finished except the order is cancelled.

API address

API address Format:  {Domain}/JNT/updatepassengerinfo/2.0/{timeStamp}/{sign}

Request Payload

UpdateOrderRequest

Parameter Type Required Description Example Note
ctripPurchaseOrderId Long Y Ctrip Purchase Order ID 881823967638342968 18 digital
vendorOrderId String Y Vendor's Order ID   Provide by supplier
passenger PassengerInfoDTO Y Passenger Info    
agent AgentInfoDTO N Agent Info   Booking agent information
flightInfo FlightInfoDTO N Flight Info   Only provided in airport pick-Up
useTime String N Use Time 2020-08-28 14:46 Local Time, we will use the flight landing time plus the buffer time to calculate use time, Format：yyyy-MM-dd HH:mm

PassengerInfoDTO

Parameter Type Required Description Example Note
name String N Passenger Name Zhang San  
firstName String N Passenger First Name San  
lastName String N Passenger Last Name Zhang  
localPhoneAreaCode String N Passenger local phone country calling code +86  
localPhone String N Passenger local phone number 13161453199  
maskRealPhone String N Passenger real local phone number with mask 134**6871  
email String N Passenger Email car@ctrip.com  
intlPhoneAreaCode String N Passenger destined country calling code +44  
intlPhone String N Passenger destined phone number    
hotelPhone String N Hotel phone number    
hotelPhoneAreaCode String N Hotel country calling code    
emergencyPhone String N Emergency Contact Person country calling code    
emergencyPhoneAreaCode String N Emergency Contact Person phone number    
imType String N Instant Messaging App WeChat WhatsApp/Skype/LINE/WeChat
imNo String N Instant Messaging Number    
  1. Either name or firstName and lastName will be provided.
  2. Either localPhone or intlPhone will be provided. If it is China mainland order, then the number is an encrypted number which is coupled with the corresponding driver. Only the Driver can contact with this passenger.</font>

AgentInfoDTO

Parameter Type Required Description Example Note
name String N Agent Name Isaac Newton  
firstName String N Agent First Name Isaac  
lastName String N Agent Last Name Newton  
intlPhoneAreaCode String Y Agent country calling code +86  
intlPhone String Y Agent phone number 13161453199  

FlightInfoDTO

Parameter Type Required Description Example Note
flightNumber String Y Flight Number CA1884  
takeOffTime String N Flight take off Time 2020-10-06 18:50:00 Flight Plan take off (Local) Time; yyyy-MM-dd HH:mm:ss
flightLandingTime String N Flight Landing Time 2020-10-06 21:20:00 Flight Plan Landing (Local) Time; yyyy-MM-dd HH:mm:ss
departDelayTime Integer N Buffer time:Use car after landing 20 Unit: Minute

Response Payload

UpdateOrderResponse

Parameter Type Required Description Example Note
msgCode String Y Response Code OK Response Code
message String N Response Detail Success Response Code

Request Example

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

Response Example

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

Error Example

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

results matching ""

    No results matching ""