Apaleo icon

Apaleo

Interact with Apaleo API

Overview

This node integrates with the Apaleo API to perform various actions related to reservations, including adding city tax to a reservation. Specifically, for the "PUT add city tax to reservation" operation under the "Reservation Action" resource, it allows users to update an existing reservation by applying a city tax charge.

Common scenarios where this node is beneficial include:

  • Automatically applying local city taxes to hotel reservations during billing or checkout processes.
  • Adjusting reservation charges dynamically based on local regulations or changes in tax rates.
  • Integrating tax calculations into broader automated workflows for property management or accounting.

For example, a hotel automation workflow could use this node to add the appropriate city tax to each reservation before generating the final invoice.

Properties

Name Meaning
Reservation ID Filter bookings by reservation ID. The unique identifier of the reservation to which the city tax will be added.

Output

The node outputs an array of JSON objects representing the results of the executed operations. For the "add city tax to reservation" operation, the output JSON typically contains the updated reservation details reflecting the applied city tax.

If the node supports binary data output (not explicitly shown here), it would represent any associated files or documents returned by the API, such as invoices or receipts, but this is not indicated in the provided code.

Dependencies

  • Requires an API authentication token credential to access the Apaleo API.
  • The base URL for API requests is https://api.apaleo.com.
  • The node depends on the Apaleo API being available and accessible with proper permissions to modify reservations.

Troubleshooting

  • Common issues:

    • Invalid or missing Reservation ID: Ensure the reservation ID provided exists and is correctly formatted.
    • Authentication errors: Verify that the API token credential is valid and has not expired.
    • Network or API downtime: Confirm connectivity to the Apaleo API endpoint.
  • Common error messages:

    • "Unauthorized" or "Authentication failed": Check API credentials.
    • "Reservation not found": Verify the reservation ID is correct.
    • "Bad Request" or validation errors: Ensure all required parameters are correctly set.

To resolve these, double-check input parameters, refresh credentials if needed, and consult Apaleo API documentation for specific error codes.

Links and References

Discussion