Best Practices

Here we list common mistakes you should not repeat. If you have any question regarding them please do not hesitate to contact our support team.

  • DO NOT make hotel mappings in the test environment (that is, when under the evaluation or pre-production plan).

  • DO NOT send a CheckRates request for every rateKey in the availability response, only for those needed. Remember you can send more than one rateKey in one CheckRates operation.

  • DO NOT send a CheckRates request if the rateKey's rateType is BOOKABLE. As stated before, you can send more than one rateKey in one CheckRates request but never send a CheckRates request with rateKeys of both RECHECK and BOOKABLE.

  • DO NOT send a CheckRates together with a booking request. If you need to send a CheckRates, first analyze its response in case it has an error and only if it's completion code was 200, then you can proceed to the confirmation.

  • Always take into account the Completion code of the responses. If you receive a 400 error code check your requests, you are sending something wrong. If you receive a 503 error code means that the product is not available anymore, you must restart your booking process from the beginning. In both cases, do not try to send the same request again, you will receive the same error until you change your request message. For more information about the completion codes review our API ERRORS.

  • Remember that the correct workflow to make a booking is the following: 
    1) Send ONE Availability request
    2) if rateType == RECHECK then
    Send ONE CheckRates Request
    3) Send ONE Booking request.

    It is never needed to send more than one availability request (or CheckRates) to make one booking. If you feel that you need to do so in order to adapt your workflow to ours, please contact with us.

  • Your code must be prepared to accept non-breaking changes in the API: we might do those changes at any time, and that should not break your code. 

Docs Navigation