add_basket_products
ChatGPTAdd rooms, extras or other products to a basket after availability checks. Requires a basket created via create_basket and product IDs from prior availability calls — never invent IDs. At least one product list must be provided. Only include products the user has explicitly requested. All products in a basket must belong to the same hotel. Rooms in the same basket must share the same rate and board: rooms with different rates or boards cannot be added together and must go in separate baskets (one create_basket per rate/board combination). To take products out of the basket use remove_basket_products. Returns the updated basket state after the add operation.
check_room_availability
ChatGPTCheck real-time room availability and pricing for specific dates. Use only when the user has provided both dates and occupancy. If either is missing, ask the user first — never assume. To explore date windows or find the cheapest period, use get_calendar_availability instead. Requires at least one of hotel_ids, room_ids, zone_codes or categories to scope the search. Returns the bookable rooms for the requested dates and occupancy, with the identifiers and pricing needed to add them to the basket via add_basket_products.
confirm_basket
ChatGPTConfirm a locked basket and create a hotel reservation. The basket must be in LOCKED status — call lock_basket first. The lock response defines the minimum required fields per room; extra data provided by the user can also be sent. Returns the order_id — the permanent reservation reference needed for all future order management operations (view, cancel, modify).
create_basket
ChatGPTCreate a new shopping basket to start a hotel booking. First step of the booking flow — required before adding products. Returns the basket_id needed for all subsequent basket operations.
delete_basket
ChatGPTDelete a basket permanently, discarding all its contents. Only call when the user explicitly asks to discard the cart. Irreversible; once deleted the basket_id can no longer be used. To reopen a locked basket for editing use unlock_basket instead. Returns the deletion outcome for the basket.
get_basket_summary
ChatGPTGet the current state of a basket (shopping cart). Use whenever the user asks about their cart or you need to inspect its contents, price or status before locking/confirming. Returns the basket record needed to present the cart to the user, including products, amounts, cancellation penalties and payment schedules.
get_calendar_availability
ChatGPTGet per-day availability, pricing and stay restrictions over a date range. Use when the user has NOT chosen specific dates yet ("What days in July are available?", "Cheapest 3 days in March"). If exact check-in/check-out are already known, call check_room_availability instead. Requires at least one of hotel_ids or room_ids to scope the search. Returns one record per hotel per day, collapsing all rooms into the best aggregate (lowest indicative price, highest availability, least restrictive stays). Does NOT return an avail_id — call check_room_availability once the user picks dates.
get_hotel_board_details
ChatGPTRetrieve details for hotel meal plans (boards/pensions). Use whenever the user wants to know what a meal plan includes (name, description, board type, media). Requires at least one of hotel_ids or board_ids. Returns the descriptive board record needed to present the meal plan to the user.
get_hotel_details
ChatGPTRetrieve descriptive information for one or more hotels by hotel_id. Use whenever the user wants to know about a hotel (description, location, policies, amenities, etc.). Returns the descriptive hotel record needed to present the hotel to the user.
get_hotel_offer_details
ChatGPTRetrieve details for hotel promotional offers. Use whenever the user wants to know what a promotion includes (discount type, activation window, promo codes, visibility rules). Requires at least one of hotel_ids or offer_ids. Returns the offer metadata needed to explain the promotion to the user.
get_hotel_rate_details
ChatGPTRetrieve details for hotel rates. Use whenever the user wants to understand a rate (what it is, how it discounts/adds, scope, taxes). Requires at least one of hotel_ids or rate_ids. Returns the rate metadata — type, discount method, applicability scope, taxes and promo code — needed to explain the rate to the user.
get_hotel_room_details
ChatGPTRetrieve descriptive information for one or more hotel rooms. Use whenever the user wants to know what a room is like (layout, area, occupancy limits, amenities, photos). Requires at least one of hotel_ids or room_ids. Returns the descriptive room record needed to present the room to the user.
lock_basket
ChatGPTLock a basket to prepare the booking confirmation. Call before asking the user for guest or payment data — the response defines the minimum data each room requires and its accepted payment_plan options, and in widget-capable clients it shows the guest a form to fill in that data. Requires a basket created via create_basket with products already added. To edit products, use unlock_basket. Payment is completed outside the chat on the hotel's secure payment page; only the chosen payment_plan_id is needed. Returns per-room confirmation requirements.
open_booking_search
ChatGPTShow an interactive search bar where the user picks destination or hotel, dates and guests. Use at the start of a booking when the user wants to book or search but has NOT given enough trip data (destination or hotel, dates, number of guests). Do NOT call it when destination or hotel, exact dates and guests are already known (call check_room_availability); relative dates that point to specific days ("this weekend", "tomorrow for two nights") count as exact, resolved from today's date (a weekend is Friday to Sunday). Nor when a hotel is already chosen and only dates are missing (call get_calendar_availability), nor if the user is just asking a question. The user fills in the form and submits it as a chat message. After calling this tool, stop and wait for that message: do not call any other tool in the same turn. Pass as arguments only what the user already said.
remove_basket_products
ChatGPTRemove rooms, extras or other products from a basket. Removes only the products identified by the given IDs from the user's own open basket; the basket itself and its other products stay. Removal can change the basket total and the removed product must be re-added (after a new availability check) to get it back, so call it only when the user explicitly asks to remove something. Use the same availability IDs that were used to add the products. At least one product list must be provided. To add products use add_basket_products. Returns the updated basket state after the remove operation.
search_amenities
ChatGPTList all amenities across the hotels the authenticated user can access. Returns amenities, grouped by type: hotel (amenities of the hotel) and room (amenities only available in rooms), each a list of [code, name] tuples. Use the returned codes to filter other tools by amenity, matching the type: hotel codes go in amenity_codes (search_hotels) and hotel_amenity_ids (check_room_availability); room codes go in room_amenity_ids (check_room_availability, get_hotel_room_details).
search_categories
ChatGPTList all categories across the hotels the authenticated user can access. Returns categories: a flat list of [code, name] tuples. Use the returned codes to filter other tools by category — hotels and availability searches.
search_hotels
ChatGPTSearch the Neobookings hotel catalog by destination, name, region, or category. Use it to explore or filter hotels and to resolve a hotel_id. It takes no dates or guests. Tourist destinations: use zone_codes. If a code is already given (e.g. "Ibiza (ibiz)"), use it without calling search_zones; otherwise call it once and pass the main_zone code. Provinces/cities: use states. Vague requests ("somewhere sunny", "near the coast"): ask the user for region, hotel type, or category before searching. Unfiltered result sets degrade response quality. Returns a paginated list of matching hotels. Use hotel_id to fetch details or check availability.
search_zones
ChatGPTList all hotel zones available to the authenticated user. Only when no zone code is known yet; if one was already given, use it directly. Returns zones: rows preserving the administrative hierarchy of each zone as [code, name] sub-tuples for country, state, main_zone (optional) and zone. Any of those codes can be passed to search_hotels(zone_codes=[...]).
unlock_basket
ChatGPTUnlock a locked basket to reopen it for editing. Use it to go back after lock_basket and change products (add_basket_products / remove_basket_products). Call lock_basket again before confirming the booking. Returns the basket with status OPEN.
update_basket_properties
ChatGPTUpdate properties of an existing basket: promotional codes, rewards, origin, or loyalty parameters. Use when the user wants to apply/remove a promo code, toggle rewards, or change loyalty parameters on an existing basket. Not for adding or removing products (use add_basket_products / remove_basket_products). At least one optional property must be provided and the basket must be in 'open' status. Returns the updated basket properties after the change.