Actions57
- Booking Actions
- Group Actions
- Offer Actions
- Block Actions
- Block Action Actions
- Reservation Actions
- Reservation Action Actions
- Types Actions
- Folio Actions
- Folio Action Actions
Overview
This node interacts with the Apaleo API to retrieve service offers related to accommodations. Specifically, the GET service-offers operation under the "Offer" resource fetches available service offers for a given stay period and rate plan. This is useful in scenarios where you want to dynamically obtain pricing or availability information for additional services tied to a booking, such as extra amenities or special packages.
Practical examples include:
- A hotel booking system that wants to display all available service offers for a guest's selected dates.
- A channel manager integrating Apaleo data to show promotional or corporate offers applicable to a reservation.
- An application that filters offers by channel (e.g., Booking.com vs Direct) or applies promo codes to get special rates.
Properties
| Name | Meaning |
|---|---|
| Arrival | Date and optional time of arrival in ISO8601 format; defines the start of the stay period. |
| Departure | Date and optional time of departure in ISO8601 format; defines the end of the stay period. |
| Adults | Number of adults included in the booking. |
| Channel Code | The sales channel through which the offer is made. Options: Direct, Booking.com, IBE, Channel Manager, Expedia, Homelike, HRS, AltoVita, DesVu. |
| Rate Plan ID | Identifier of the rate plan for which to retrieve service offers. |
| Additional Fields | Collection of optional parameters: |
| - Children Ages | Comma-separated list of children ages to consider in the offer calculation. |
| - Include Unavailable | Boolean flag to include offers that are currently unavailable. |
| - Page Number | Pagination page number for results. Defaults to 1. |
| - Page Size | Number of items per page in paginated results. Defaults to 100. |
| - Time Slice Template | Filter for rate plans by time slice type. Options: Day Use, Over Night. |
| - Promo Code | Promotional code to apply special offers. |
| - Corporate Code | Corporate rate code to apply special corporate discounts. |
Output
The node outputs an array of JSON objects representing the retrieved service offers matching the input criteria. Each object typically contains details about the offer such as pricing, availability, applicable dates, and any restrictions or conditions.
If binary data is returned (not typical for this operation), it would represent downloadable content related to offers, but this operation primarily deals with JSON data.
Dependencies
- Requires an active connection to the Apaleo API using an API authentication token.
- The node expects the user to configure credentials providing access tokens for Apaleo.
- Network connectivity to
https://api.apaleo.comis necessary.
Troubleshooting
- Invalid or expired API token: The node will fail if the provided API token is invalid or expired. Refresh or reconfigure the API credentials.
- Incorrect date formats: Ensure that the Arrival and Departure fields use valid ISO8601 date/time strings.
- Missing required fields: The operation requires
arrival,departure,adults, andratePlanId. Omitting these will cause errors. - Pagination issues: If too many results are requested at once, consider adjusting
pageSizeor using pagination properly. - Unavailable offers not showing: Set
Include Unavailableto true if you want to see offers that are currently not bookable. - Channel code mismatches: Use the correct channel code string matching your sales channel to get relevant offers.