Bonotel Direct API

audience there are two options available to customers wishing to connect with bonotel product via an api bonotel's direct api that provides a streamlined interface that uses xml format bonotel's "complete" api that provides additional details and elements, allows for ari searching without requiring hotel id mapping, and uses a json format both implementations have their pros and cons for questions or support regarding which choice might be best for you use case, or for any other inquiries involving apis please contact us at apisupport\@bonotel com mailto\ apisupport\@bonotel com overview bonotel exclusive travel offers the ability for organizations to connect their client applications directly to hotel product offers and content this is accomplished via integration with available apis and content sources transactional api availabilty search / shopping pre book reservation cancel lookup report content api content files important points when searching for availability and rates, you can search by city, hotel, or multiple hotels however, note that as of 2024, bonotel strongly recommends discontinuing searches by bonotel defined city codes we will be phasing out support for this by mid 2025 the system will provide net rates to the customer (i e customer’s contracted rate with bonotel) the rates are provided as rate per room per day (room type / bed combination) and the total cost of booking each room type / bed combination the total cost is the final amount the tour operator will pay bonotel per room taxes are included in rates, but additional fees (e g resort fees) are displayed as either "included" or "excluded" in the price wherever a special promotion applies e g book 5 nights and pay for 4, the free night daily rate will return as 0 0 unless there is an inclusive resort fee on the free night, then you would see this fee it is possible to send notes/comments and your booking reference numbers when requesting a reservation however, these notes are not always reviewed or honored by hotels please do not assume that your requests will be acknowledged and fulfilled our call center {{customer support phone}} is available for direct follow up with hotels if necessary if sending notes, please limit to standard utf 8 characters and numbers only cancellation policy/fee rules will be sent via the availability response message when you request them details below cancel policy is based on the hotel local time zone ages are required for children, and child cutoff age limitations will apply if a child is over the cutoff age, the interface will count this person as an adult when bookings are saved, the system will return your confirmation number, and the status attribute would equal ‘y’ when bookings are not saved, we will return an error code and the status attribute would equal ‘n ’ customer configured timeout values are not supported an industry standard timeout setting for customer and supplier connections has been established at 60 seconds if a reservation request is initiated by a customer and confirmed within 60 seconds, that reservation is considered confirmed with bonotel and the supply partner and will be evaluated accordingly if a customer requires a shorter timeout value for their client system, it is at their discretion to develop a solution that queries for reservations made beyond the timeout value and initiate an immediate cancellation request cancellation policies, including non refundable conditions should be evaluated prior to initiating a cancellation request static hotel content is being provided separately it consists of hotel info, room combination info, hotel contact info, hotel accessible facilities info, city list, and more we also offer a data api, which is covered in a separate specifications document the customer will need to add a mark up to the rates received from the interface, collect payment, and send final confirmations to the guests payment transactions are not conducted via this api general policies the maximum number of nights that can be searched is 30 all rooms must include at least 1 adult each room must have a valid primary guest name where first and last name are each longer than 1 character we do not recommend sending special characters in any field not all hotels or supplier systems support them all guests designated as children must include age cutoff age for children varies by hotel, but the maximum is 18 the age element should only be used for occupants provided as a child in the room data element hotel fees and cancel policies must be requested and captured from our availability method do not use the legacy solutions for cancellation policies in the availability response, which includes the following elements bookingpolicy and policydescription – instead, always include cancelpolicy="y" as an attribute of the root element for availabilityrequest and use the roombookingpolicy sections per room that returns