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
Rates API → Prices
AI-generatedOverview
This node interacts with the Starfish API for CampingCare and HotelCare, specifically focusing on the Rates API's Prices operation. It allows users to either retrieve prices for a specific rate over a date range or update prices and related booking conditions for a rate within a specified period. This is useful for managing dynamic pricing and availability rules in hospitality or camping accommodations.
Use Case Examples
- Retrieve prices for a rate between two dates to analyze pricing trends.
- Update the price and booking restrictions for a rate over a specific date range to reflect seasonal changes or special offers.
Properties
| Name | Meaning |
|---|---|
| Prices Operation | Specifies whether to get or update prices for a rate. Options include 'Get Prices' to retrieve prices and 'Update Prices' to modify prices and booking conditions. |
| Rate ID | The unique identifier of the rate to retrieve or update prices for. |
| Start | The start date (YYYY-MM-DD) for the price retrieval or update period. |
| End | The end date (YYYY-MM-DD) for the price retrieval or update period. |
| Price | The base price to set when updating prices. |
| Closed | Indicates if the rate is closed (1) or open (0) for the specified dates when updating prices. |
| Minimum Stay | Minimum number of days required to stay for the rate during the update period. |
| Maximum Stay | Maximum number of days allowed to stay for the rate during the update period. |
| Min Book Offset | Minimum booking offset in days for the rate during the update period. |
| Max Book Offset | Maximum booking offset in days for the rate during the update period. |
| Closed For Arrival | Indicates if arrivals are closed (1) or open (0) for the specified dates during the update. |
| Closed For Departure | Indicates if departures are closed (1) or open (0) for the specified dates during the update. |
| Weekdays | Specifies which weekdays the price update applies to. |
| Age Table Prices | A list of objects specifying prices for different age tables, each with an ID and price amount, used when updating prices. |
Output
JSON
responseData- The JSON response from the API containing the prices data or confirmation of the update operation.
Dependencies
- Requires an API key credential for the Starfish API (CampingCare/HotelCare).
Troubleshooting
- Ensure the Rate ID is valid and exists in the system to avoid 'not found' errors.
- Verify date formats for 'start' and 'end' parameters are correct (YYYY-MM-DD) to prevent request failures.
- When updating prices, ensure the date range does not exceed the maximum allowed period (266 days).
- Check API key validity and permissions if authentication errors occur.
- If SSL issues arise, consider enabling the 'Ignore SSL Issues' option or verify the SSL certificate.
Links
- Starfish API Documentation - Official documentation for the Starfish API including Rates and Prices endpoints.