Glossary
Noun convention#
Rate Code-RateCode#
It is used to support multiple quotation schemes under the same room type of the same hotel.
Hotel Products-Product#
A combination of rate codes for each hotel room type, called a hotel product
Valency-ARI#
House Price, House Quantity, House State (Availability,Rate,Inventory) Specific sales information for hotel goods, including price Rate, inventory Inventory, availability Availability
Trial Order-DoubleCheck/PreBook#
Try placing an order, check before placing an order or check availability. It appears in the process of creating hotel reservation orders and the trial order interface, in which the success rate of trial orders can be used as a core indicator affecting the user experience on the channel side.
Interface-Interface#
The "interface" in the R & D document refers to the API interface provided by the Chinese side for the channel side to call.
Protocol-Contract#
"Protocol" in the R & D documentation means that the channel side is responsible for implementing the interface in accordance with the protocol for the Chinese side to call.
Huazhu Certification Center#
the passes used for the api interfaces in all the r & d documents come from the access_token issued by this center. For details, see Certified Security.
Early Morning Room#
If you need to obtain the reservation volume and quotation, the query start date (startDate) must be set to the day before the current date of the server.
When the server time is within the bookable time period supported by the Morning Room (the specific time limit is mainly based on the bookWindow returned by the product interface), you can create an order with the reservation check-in date of yesterday.
For example, if the current time of the server is 02:00 on December 15, 2021 and the bookable time period supported by the morning room is 00:00~06:00, the bookable checkin is the order on December 14, 2021. Logic of other parameters unchanged
Night Room#
Support night room with night room label (tail room)
When the server time is within the bookable time period supported by the supper room (tail room) (the specific time limit is mainly the bookWindow returned by the product interface), an activity order can be created with the reservation check-in date being the same day and the departure date being T +1
For example, if the current time of the server is 20:30 on December 15, 2021 and the bookable time period supported by the supper room (tail room) is 20:00-23:59, the bookable checkin is December 15, 2021 and the checkoutDate is the order on December 16, 2021. Logic of other parameters unchanged
When renting#
query quotation, room inventory information, only ARI startDate for the current day can be checked, endDate even if the date after multiple days is transmitted, only the current day will be returned.
That is, the current date is 2021-12-21, the startDate can only be transmitted to the same day, and the endDate must be greater than or equal to startDate
Date Boundary#
Incremental push: incremental semaphore push has a maximum time span of 30 days, such as checkInDate:2021-12-01 days:30, indicating that the house price or house quantity including 2021-12-01 to 2021-12-30 has been adjusted (excluding 2021-12-31)
Start and end date (closed interval):quotation interface, room inventory interface, the maximum support start and end interval is 30 days, that is, endDate-startDate = 29; The start date cannot be less than yesterday
Inbound and departed date (open interval):trial order interface, order order interface, one order with a maximum interval of 60 days is supported, I .e. checkout-checkin = 60; Check-in date cannot be less than yesterday
Number of rooms booked#
Currently, the maximum number of rooms supported by a single order creation and trial is 3.
Night trial time#
The night trial time is agreed to be 24 o'clock on the day of check-in.
Failed to place the order, retry the suggested exception code#
2001 (system exception),2002(token verification failed)