Apaleo icon

Apaleo

Interact with Apaleo API
Join our community

Actions57

Overview

This node interacts with the Apaleo API to manage reservations, specifically allowing you to assign a specific unit to an existing reservation. This operation is useful in property management and hospitality scenarios where you need to allocate or reallocate units (e.g., hotel rooms, apartments) to reservations dynamically.

Typical use cases include:

  • Assigning a particular room or unit to a guest's reservation after booking.
  • Adjusting unit assignments based on availability or guest preferences.
  • Automating unit allocation workflows in property management systems.

For example, after a guest books a stay, this node can be used to assign a specific room ID to their reservation for the duration of their stay.

Properties

Name Meaning
Reservation ID Filter bookings by the unique identifier of the reservation to which the unit will be assigned.
Unit ID The unique identifier of the unit (e.g., room or apartment) that should be assigned to the reservation. This is a required field.
From The start date and optional time for the unit assignment. If not specified, the reservation's arrival date will be used. Accepts ISO8601:2004 formatted date or datetime strings, optionally with UTC offset.
To The end date and optional time for the unit assignment. If not specified, the reservation's departure date will be used. Accepts ISO8601:2004 formatted date or datetime strings, optionally with UTC offset.

Output

The node outputs JSON data representing the result of the unit assignment operation. This typically includes details about the updated reservation and the assigned unit, confirming the successful allocation.

If the operation fails, the output may contain error information describing what went wrong.

No binary data output is produced by this node.

Dependencies

  • Requires an active connection to the Apaleo API via an API authentication token.
  • The node expects the user to provide valid credentials with access rights to modify reservations.
  • Network connectivity to https://api.apaleo.com is necessary.

Troubleshooting

  • Common Issues:

    • Invalid or missing Unit ID or Reservation ID will cause the operation to fail.
    • Date formats for From and To must comply with ISO8601 standards; incorrect formatting may lead to errors.
    • Insufficient permissions or expired API tokens will prevent successful assignment.

  • Error Messages:

    • "Reservation not found": Check that the provided Reservation ID exists.
    • "Unit not available": The specified unit may already be assigned or unavailable for the given dates.
    • "Invalid date format": Ensure From and To fields are correctly formatted as per ISO8601.
    • Authentication errors indicate issues with the API token; refresh or reconfigure credentials as needed.

Links and References

Discussion