Use of Rate Comments

Rate comments, also called contract comments or contract remarks, are important information that the traveler should know when they book a hotel.

Some 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.

This information could be related to hotel operational but also to rate limitations or hotel rules. For this reason, it is important to show this information during the booking process.

Rate comments are sent on each booking operation, it is Availability, CheckRate, Confirmation and even Booking details operation. However, in the first, the information is represented differently.

1 - Rate comments at Availability

Next, an example of how rate comments look like at Availability response. Pay attention to the field rateCommentsId , which returns the code: 256|24524|3

        rateKey = "20201205|20201207|W|256|217516|DBL.DX|GC-ALL|RO||1~2~1|6|N@05~~20c65~107727977~N~~~C8707DE2DC8C4F4159912750444500AAUK0200059001000021020c65"
        rateClass = "NOR"
        rateType = "BOOKABLE"
        net = "101.12"
        allotment = "37"
        rateCommentsId = "256|24524|3"
        paymentType = "AT_WEB"
        packaging = "false"
        boardCode = "RO"
        boardName = "ROOM ONLY"
        rooms = "1"
        adults = "2"
        children = "1"
        childrenAges = "6">
                <cancellationPolicy amount = "75.54" from = "2020-12-02T23:59:00-08:00"/>

These are the steps that you have to follow to build the rate comments at this step:

1.1 - Use this code to retrieve the initial rate comment from Content API.

You have two ways to do it:

  • Offline solution (recommended): Use the “rateComments” operation
    This operation retrieves all rate comments from all hotels. Next an example of how it shows one rate-comments with this operation.
<rateComment incoming="102" hotel="14978" code="173049">
        <commentByRates rateCodes="2 0">
          <comments dateEnd="2022-12-31" dateStart="2014-10-24">
            <description>First child until 12 years old free in room only basis, sharing room with their parents, on request.
Cot from 0-2 years old free, on request</description>

You must match the code from the Availability operation from those returned (and stored locally) by this operation. You can do that knowing that: rateCommentsId = incoming | code | rateCodes

You must also have into account the dateStart and dateEnd dates, based on the check-in date. For example, for the same code we could have:

startDate endDate Description
1st May 2016 1st Sep 2016 "Minimum age of registration 19"
1st May 2016 1st Sep 2016 "Minimum age of registration 21"
2nd Sep 2016 1st Dec 2016 "Minimum age of registration 21"

If the check-in is 13th October 2016 then the rateComment to choose is "Minimum age of registration 21".

If you find more than one description applicable to the check-in date, you would have to concatenate each of them and show it to the final passenger.

  • Online solution: Use the “rateCommentDetails” operation.
    This operation uses the rate-comments code and the check-in date of the availability request to return the rate-comments description. Check for more information here.

1.2. Retrieve the Taxes information.

Those can be retrieved from availability response, after the development of the tax breakdown, more information could be found here here

1.3. Retrieve the Issues of the hotel.

Those can be retrieved from content-API using hotels or hoteldetails operations under <issues> tag. More info here.

1.4. Retrieve the mandatory facilities.

Those can be retrieved from content-API using hotels or hoteldetails operations under <facilities> tag and are identified using the value true on the "voucher" tag. More info here.

1.5. Concatenate all the information you retrieved from steps 1 to 4.

You have the full rate comments now!

2 - Rate comments at CheckRates, Booking and BookingDetail

Except for the Availability, the rest of operations will directly return the full rate comments for you, that is, the concatenation previously explained is already done.

Here you have for example a sample of the CheckRates. Pay attention to the field: rateComments

<room code="STU.ST" name="STUDIO STANDARD">
          rateComments="Estimated total amount of taxes & fees for this booking:3.30 Euro payable on arrival.  Key Collection 15:00-00:00.Check-in hour 15:00-00:00.Car park YES (with additional debit notes) 12.00 EUR Per unit/night" 
          boardName=" BED AND BREAKFAST"