The rate comments (also called contract comments) are provided by hoteliers and must be displayed to the customer before confirming a booking.
The availability response returns a rate comment ID; while a description is returned in the other steps of the booking process.
In the availability response it is possible that certain rates have a comment associated that the hotelier wants to disclose to the final passenger before they book.
Examples of rate comments are: "Minimum age of registration 21 Years Old"; "The Key for the apartment needs to be collected at 522 Main Street”, etc.
These rate comments are returned in the Availability Response and are identified with a code, for example in the XML response will be returned like this: rateCommentsId="1|92088|3"
In order to obtain the description of the rate comments you have two options:
Incoming | Code | Rates | Date Start | Date End | Description |
1 | 92088 | 1,2 | 1st May 2016 | 1st Sep 2016 | "Minimum age of registration 19" |
1 | 92088 | 3 | 1st May 2016 | 1st Sep 2016 | "Minimum age of registration 21" |
1 | 92088 | 1,2,3 | 2nd Sep 2016 | 1st Dec 2016 | "Minimum age of registration 21" |
Reviewing the incoming, the code and the rates, we could have 2 possibilities, "Minimum age of registration 21" and "Minimum age of registration 19", but as the check in date is 13th October 2016 the rateComment to display is "Minimum age of registration 21".
NOTE: In the case that you find more than one description applicable to the check in date then you would have to concatenate each rate comment and show it to the final passenger.