Push Order Status Change Signal

This signal will be pushed when the order status changes. After receiving the signal, the docking party needs to call Reservation Detail Interface to obtain the current status of the order according to the message content. Order Status Enumeration Dictionary.

Push Protocol#

https POST

Huazhu side request timeout request.timeout = 3s


Description#

Push parameters#

ParameterTypeRequiredMaximum lengthExampleDescription
hotelIdStringY3212 * * 567Hotel ID
typeStringY20Push data type, Enumeration Dictionary
resIdStringY64Reservation number
timestampDateY-Change timestamp, format: yyyy-MM-dd HH: mm: ss.fff
echoTokenStringY20UUID is used by both parties to locate the problem

[failure retry]:
1. after the request fails for the first time, it will be retried immediately
2. if the request fails for two consecutive times, it will enter the failure message queue and delay sending
3. tasks in the failure queue will increase the call interval one by one according to the number of retries, and will not be retried after more than 10 times. The docking party should consider judging whether the current message is the latest data according to the timestamp (timestamp) to avoid historical messages overwriting the latest status.

Response parameters#

ParameterTypeRequiredMaximum lengthExampleDescription
statusStringY101Status code, 1 successful,-1 failed
errorcodestringN50defined by the interfacing party
errormsgstringN500The docking party defines it by itself and needs to clearly describe the cause of the problem

Message example#

Case1: Order check-in notification#

Request Example#

{
"hotelId": "2000014 ",
"type": "orderStatus ",
"timestamp": "2022-08-03 18:00:00.000 ",
"echoToken": "0525082e5**********67ac4b9d2c ",
"resId": "R12**567**32332"
}

Example of Receiving Results#

Receive successful push example#

{
"status": 1,
"errorcode ": "",
"errormsg ": ""
}

End Push Failure Example#

{
"status": -1,
"errorcode": "99 ",
"errormsg": "Unknown"
}