Cangooroo Hotel API Certification

Here's what you need to certify the Hotel API:

You need to fill in and answer the questions below, save this document in a PDF, and send it to suporte@cangooroo.net along with the XML or JSON files of the complete flow of each test scenario detailed below, in separate files for each request and response.

Integrator's name
Contact e-mail(s)
Contact telephone number(s)

Below are the names of all the services that must always be used in the complete flow of a hotel booking:
1. Search
2. GetBookingConditions
3. DoBooking
4. CancelByService or CancelAllHotelServices (implementation of at least one of the cancellation services is mandatory)

Questions

1. Could you detail the booking flow you are following?
We want a brief explanation of how your system's booking flow works and at what stage you send us each of our services.

2. Are you aware that it is important to keep the same nationality at all stages of the booking flow?
Remember that it is necessary to set the passenger's nationality in the DoBooking request to the same value as was initially requested in the availability request to ensure that the selected fare will remain available.

3. Are you aware that you must always check the “MustCheckHotelInfo” field returned in the “GetBookingConditions” method?
It is recommended that whenever “MustCheckHotelInfo”: true is returned in the “GetBookingConditions” method, the supplier's hotel data returned in “GetBookingConditions” (fields “SupplierHotelName” and “SupplierHotelAddress”) is checked and some kind of alert is generated in the integrator's system, asking the user to confirm that the data presented is from the hotel they wish to book before proceeding with the reservation. If the “MustCheckHotelInfo” field is equal to “true” and the hotel data returned in “GetBookingConditions” is from another hotel, different from the one returned in the availability query, the integrator is responsible for going ahead with the booking.

4. Are you properly handling all the possible booking statuses returned in the “Status” field of the “DoBooking” method response?
You must always check the booking status, as there may be a problem when trying to generate the booking with the supplier. You should only assume that the booking has been confirmed if you receive “Status”: “Confirmed”. It is also important that you do NOT assume that the booking has not been confirmed with the supplier if you receive an error in the response from doBooking, a lack of response, or a status stating a technical problem.

5. Are you aware of the possibility of sending your booking reference via the “ClientReference” field?
We recommend sending this information along with the booking confirmation request because if there is a problem with the booking confirmation process (and therefore you don't have our locator yet), your own booking reference will help us identify whether this booking was created in the end and/or what happened to it.

6. Do you confirm that you are aware of the reservation status check flow whenever there is an HTTP error (4XX or 5XX) in the “DoBooking” method?
It is important to validate the reservation status using the “CheckBookingStatus” method when the “DoBooking” response is inconclusive. This way, you can confirm whether the reservation has been properly confirmed or whether a new request is necessary.

7. Do you understand that you can only consider a reservation “canceled” after receiving confirmation of the cancellation?
It is important to reiterate that if the response to the cancellation call does not return the canceled status, you must make a new call to ensure that the reservation is actually canceled with the supplier. Otherwise, it may remain active and generate losses.

Test scenarios (send the logs attached)

Scenario 1: Confirm and cancel a reservation with 1 room with 1 adult.

Scenario 2: Confirm and cancel a reservation with 2 rooms with 2 adults in the first room and 1 adult and 1 child in the second room.

Scenario 3: Confirm and cancel a reservation with 3 rooms with 2 adults each.

Scenario 4: Confirm and cancel a reservation with 3 rooms, with 1 adult in the first room, 1 adult and a child in the second room and 2 adults and 2 children in the third room.