Actions30
- Accommodations API Actions
- Administrations API Actions
- Contacts API Actions
- Invoices API Actions
- Price Calculation API Actions
- Rates API Actions
- Reservations API Actions
- Timezones API Actions
Overview
This node interacts with the Starfish API for CampingCare and HotelCare, specifically providing a Price Calculation API operation. It calculates the price for a booking based on various parameters such as accommodation ID, arrival and departure dates, number of persons, and optional inclusions like guest prices, taxes, discounts, required options, and deposits. It also supports retrieving available bookable options, alternative accommodations, available places, detailed row information, and translations. The node is useful for automating price calculations in booking workflows, enabling dynamic pricing based on user input and booking details.
Use Case Examples
- Calculate the total price for a booking at a specific accommodation for given arrival and departure dates, including taxes and discounts.
- Retrieve available bookable options and deposit information for a booking to present detailed pricing to customers.
- Check alternative accommodations and available places for a given date range to offer options to users.
Properties
| Name | Meaning |
|---|---|
| Accommodation Name or ID | The accommodation ID for which the price calculation is performed. It can be selected from a list or specified via expression. |
| Arrival Date | The arrival date and time for the booking in the format YYYY-MM-DD or YYYY-MM-DD HH:MM:SS. |
| Departure Date | The departure date and time for the booking in the format YYYY-MM-DD or YYYY-MM-DD HH:MM:SS. |
| Number of Persons | Number of persons staying in the accommodation. The calculation always includes 2 persons by default. |
| Get Guests Price | Whether to include extra guest prices in the calculation. |
| Get Taxes Price | Whether to include taxes in the calculation. |
| Get Discounts Price | Whether to include discounts in the calculation. |
| Get Required Options Price | Whether to include required options in the calculation. |
| Get Options | Whether to get available bookable options such as baby chair, extra tent, dog, etc. |
| Get Deposit | Whether to include deposit information in the calculation. |
| Translations | Whether to include translations in the response. |
| Search Alternative | Whether to search for alternative accommodations. |
| Get Available Places | Whether to get available places for the booking. |
| Get Rows | Whether to include detailed row information in the calculation. |
| Age Table IDs | One or more age table IDs to be used in the calculation. |
| Birthdates | One or more birthdates (YYYY-MM-DD) to be used in the calculation. |
| Channel | Select a channel for the booking. |
| Card ID | Card identifier for the booking. |
| Reservation ID | Reservation ID to check the calculation against an existing reservation. |
| Place ID | Specific place identifier for the booking. |
| Code | Promotional or discount code to apply in the calculation. |
| History Date | Historical date for price calculation in the format YYYY-MM-DD. |
| Timeslot ID | Timeslot identifier for the booking. |
| Timezone | Timezone to use for the calculation. |
| Request Options | Additional request options such as batching, ignoring SSL issues, proxy settings, and timeout configuration. |
Output
JSON
price- The calculated price details for the booking.options- Available bookable options if requested.deposit- Deposit information if requested.translations- Translations included if requested.alternative_accommodations- Alternative accommodations found if search alternative is enabled.available_places- Available places if requested.detailed_rows- Detailed row information if requested.
Dependencies
- Starfish API for CampingCare and HotelCare
- An API key credential for authentication
Troubleshooting
- Ensure the API key credential is correctly configured and has necessary permissions.
- Verify that the accommodation ID and other required parameters are valid and correctly formatted.
- Check network connectivity and proxy settings if requests fail or time out.
- If SSL certificate validation issues occur, consider enabling the option to ignore SSL issues (insecure).
- Review error messages returned by the API for specific issues such as invalid dates, missing parameters, or quota limits.
Links
- n8n Expressions Documentation - Documentation on how to use expressions in n8n for dynamic parameter values.