Apaleo icon

Apaleo

Interact with Apaleo API
Join our community

Actions57

Overview

This node interacts with the Apaleo API to perform various actions related to reservations, specifically here focusing on the "PUT assign unit to reservation" operation within the "Reservation Action" resource. The main purpose of this operation is to assign a specific unit (e.g., a hotel room or accommodation unit) to an existing reservation.

Typical use cases include:

  • Automatically assigning rooms to reservations in a property management workflow.
  • Adjusting reservations by linking them to available units based on business rules.
  • Enabling overbooking or unit type changes when assigning units, depending on operational flexibility.

For example, a hotel booking system could use this node to programmatically assign a room to a guest's reservation once payment is confirmed or to reassign a different room if the original one becomes unavailable.

Properties

Name Meaning
Reservation ID The unique identifier of the reservation to which a unit will be assigned.
Unit Conditions Optional conditions that affect how the unit assignment behaves. Options include:
- Allow Overbooking: Permit assigning a unit even if it exceeds normal capacity limits.
- Allow Unit Type Change: Permit changing the unit type during assignment.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output JSON object contains the result of the unit assignment operation for the given reservation. This typically includes updated reservation details reflecting the newly assigned unit.

If the operation involves binary data (not indicated here), it would represent associated files or documents related to the reservation, but this node primarily deals with JSON data representing reservation state.

Dependencies

  • Requires an active connection to the Apaleo API via an API key credential.
  • The node expects the user to configure the Apaleo API credentials in n8n beforehand.
  • Network access to https://api.apaleo.com must be available.

Troubleshooting

  • Common issues:

    • Invalid or missing Reservation ID: The API will reject requests without a valid reservation identifier.
    • Insufficient permissions or invalid API token: Ensure the API key has rights to modify reservations.
    • Attempting to assign a unit that violates conditions (e.g., overbooking not allowed): May cause errors unless the appropriate unit conditions are enabled.

  • Error messages:

    • "Reservation not found": Check that the Reservation ID is correct and exists.
    • "Unauthorized" or "Invalid token": Verify API credentials and refresh tokens if necessary.
    • "Unit assignment failed due to constraints": Review unit conditions and adjust options like allowing overbooking or unit type changes.

Links and References

Discussion