Apaleo icon

Apaleo

Interact with Apaleo API

Overview

This node interacts with the Apaleo API to manage reservation actions, specifically allowing you to unassign a unit from an existing reservation. This operation is useful in scenarios where a previously assigned accommodation unit (e.g., hotel room or apartment) needs to be released or changed without cancelling the entire reservation.

Practical examples include:

  • A guest changes their mind and no longer requires a specific unit.
  • The originally assigned unit becomes unavailable due to maintenance or overbooking.
  • Adjusting reservations dynamically in property management workflows.

By using this node, you can automate updates to reservations directly within your workflow, ensuring your booking system stays synchronized with real-time changes.

Properties

Name Meaning
Reservation ID The unique identifier of the reservation from which the unit will be unassigned.

Output

The node outputs JSON data representing the result of the unassignment operation on the reservation. This typically includes updated reservation details reflecting that the unit has been unassigned.

If the operation involves binary data (not indicated here), it would represent related files or documents, but for this operation, output is purely JSON.

Dependencies

  • Requires an API authentication token credential to access the Apaleo API.
  • Needs network connectivity to https://api.apaleo.com.
  • The node depends on the Apaleo API's reservation action endpoints to perform the unassignment.

Troubleshooting

  • Common issues:

    • Invalid or missing Reservation ID: Ensure the Reservation ID provided exists and is correctly formatted.
    • Authentication errors: Verify that the API key or token credential is valid and has sufficient permissions.
    • Network or API downtime: Check connectivity and Apaleo service status.
  • Error messages:

    • "Reservation not found": The specified Reservation ID does not exist; verify the ID.
    • "Unauthorized" or "Authentication failed": The API credentials are invalid or expired; update credentials.
    • "Unit cannot be unassigned": The unit may already be unassigned or the reservation state disallows this action.

Resolving these usually involves verifying input parameters, refreshing credentials, and consulting Apaleo API documentation for constraints.

Links and References

Discussion