Actions45
- Block Actions
- Block Action Actions
- Booking Actions
- Group Actions
- Offer Actions
- Reservation Actions
- Folio Actions
- Types 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 guest configuration. This is useful in scenarios such as travel booking platforms, hotel management systems, or any application needing to display or process available service offers dynamically based on user input like arrival/departure dates and number of guests.
Practical examples:
- A hotel booking website showing available service offers (e.g., spa packages, breakfast deals) for selected check-in and check-out dates.
- A corporate travel tool fetching special corporate rate offers for employees traveling on business.
- A channel manager system retrieving offers filtered by distribution channels like Booking.com or Expedia.
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 request. |
| Channel Code | The distribution channel through which the offer is requested. Options: Direct, Booking.com, IBE, Channel Manager, Expedia, Homelike, HRS, AltoVita, DesVu. |
| Rate Plan ID | Identifier of the rate plan to filter offers by specific pricing plans. |
| Additional Fields | Collection of optional parameters: |
| - Children Ages | Comma-separated list of children ages to consider in the offer calculation. |
| - Include Unavailable | Boolean flag indicating whether to include offers that are currently unavailable. |
| - Page Number | Pagination page number for results. |
| - Page Size | Number of items per page in paginated results. |
| - Time Slice Template | Filter for rate plans by time slice type. Options: Day Use, Over Night. |
| - Promo Code | Promotional code to apply special discounts or offers. |
| - Corporate Code | Code used to access corporate rates. |
Output
The node outputs JSON data representing the retrieved service offers matching the specified criteria. The structure typically includes details about each offer such as identifiers, descriptions, pricing, availability, applicable rate plans, and any associated promotional or corporate codes.
If binary data is returned (not indicated explicitly here), it would represent downloadable content related to offers, but this node primarily returns structured JSON data.
Dependencies
- Requires an active connection to the Apaleo API via an API authentication token (access token).
- The node expects the user to configure credentials providing access to the Apaleo API.
- Network connectivity to
https://api.apaleo.comis necessary.
Troubleshooting
Common issues:
- Invalid or expired API token leading to authentication errors.
- Incorrect date formats for arrival or departure causing validation failures.
- Requesting unavailable pages or sizes beyond allowed limits may result in empty or error responses.
- Using unsupported channel codes or rate plan IDs might yield no results.
Error messages:
- Authentication errors: Ensure the API key/token is valid and has not expired.
- Validation errors on dates: Confirm that arrival and departure are in correct ISO8601 format.
- Pagination errors: Adjust page number and size within acceptable ranges.
- Network errors: Verify internet connectivity and API endpoint accessibility.