HotelPlanet

Complete hotel booking and management system. Search hotels, check availability, make bookings, and manage reservations. Perfect for travel agencies, booking platforms, and hotel management workflows.
Join our community

Actions8

Overview

The node "HotelPlanet" provides a comprehensive hotel booking and management system integration. It allows users to search for hotels, check availability, make bookings, and manage reservations through various operations. This node is ideal for travel agencies, booking platforms, or hotel management workflows that require automated interaction with hotel data and booking services.

Specifically, the Check Availability operation enables users to verify if rooms are available at a specified hotel for given check-in and check-out dates, number of guests, and number of rooms. This is useful in scenarios such as:

  • Travel agents confirming room availability before making a booking.
  • Booking platforms validating availability in real-time during user searches.
  • Workflow automations that need to ensure availability before proceeding with further steps.

Example: A workflow could use this node to check if 2 rooms are available at Hotel ID "12345" from July 1 to July 5 for 4 guests before triggering a booking process.

Properties

Name Meaning
Hotel ID Identifier of the hotel to check availability for.
Check-in Date The start date of the stay (check-in).
Check-out Date The end date of the stay (check-out).
Number of Guests Total number of guests who will stay.
Number of Rooms Number of rooms required for the stay.

Output

The output JSON contains the response from the hotel availability API endpoint. It includes a success flag indicating whether the request was successful and relevant availability data when successful. If the request fails, an error message is provided.

The exact structure depends on the external API but typically includes details such as available room types, prices, and booking conditions.

This node does not output binary data.

Dependencies

  • Requires an API key credential for authentication with the HotelPlanet API service.
  • The base URL for the API is obtained from the credentials; defaults to http://localhost:3000 if not set.
  • Uses the Axios HTTP client library to perform REST API calls.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect date formats or invalid date ranges (e.g., check-out before check-in) may result in API errors.
    • Requesting availability for a non-existent hotel ID will return an error.
    • Network connectivity problems can cause request timeouts or failures.

  • Error messages:

    • "API request failed" indicates the external API returned an unsuccessful response without a specific error message.
    • Errors thrown by the node include descriptive messages from the API or generic failure notices.

  • Resolutions:

    • Verify that the API key credential is correctly configured and has necessary permissions.
    • Ensure date inputs are valid ISO date strings and logically consistent.
    • Confirm the hotel ID exists in the system.
    • Check network connectivity and API endpoint accessibility.

Links and References

  • No direct external links are provided in the source code.
  • For more information, consult the documentation of the HotelPlanet API or the n8n node documentation for custom integrations.

Discussion