Starfish (CampingCare/HotelCare) icon

Starfish (CampingCare/HotelCare)

Interact with the Starfish API for CampingCare and HotelCare
Join our community

Actions30

Overview

This node interacts with the Starfish API for CampingCare and HotelCare to create reservations. It supports creating reservations either by using a price calculation (with calculation ID and draft ID) or by forcing a reservation with custom data. This node is useful for automating booking processes, integrating reservation creation into workflows, and managing accommodation bookings programmatically. For example, it can be used to create a reservation after calculating the price or to force a reservation with specific details without relying on the price calculation API.

Use Case Examples

  1. Create a reservation using a previously obtained price calculation ID and draft ID.
  2. Force a reservation with custom data including arrival and departure dates, number of persons, and forced rows for pricing.
  3. Add co-travelers with custom fields to a reservation.

Properties

Name Meaning
Creation Method Determines how the reservation is created, either using a price calculation or forcing with own data.
Accommodation Name or ID Select or specify the accommodation for the reservation.
Calculation ID The calculation ID returned from the Price Calculation API, required if using price calculation method.
Calculation Draft ID The draft ID returned from the Price Calculation API, required if using price calculation method.
Arrival Date Arrival date for the booking in YYYY-MM-DD format, required for date-based creation methods.
Departure Date Departure date for the booking in YYYY-MM-DD format, required for date-based creation methods.
Number of Persons Number of persons staying in the accommodation, required for date-based creation methods.
Forced Rows Custom rows to force pricing details when forcing reservation creation with own data.
Contact ID Optional ID of the contact associated with the reservation.
Co-Travelers Add one or more co-travelers with their dynamic custom fields.

Output

JSON

  • id - The unique identifier of the created reservation.
  • status - The status of the reservation after creation.
  • accommodation_id - The ID of the accommodation for which the reservation was made.
  • arrival - The arrival date of the reservation.
  • departure - The departure date of the reservation.
  • persons - Number of persons included in the reservation.
  • calculation_id - The calculation ID used if reservation was created using price calculation.
  • forced_rows - Details of any forced rows used in the reservation creation.
  • contact_id - The contact ID associated with the reservation.
  • co_travelers - Details of co-travelers added to the reservation.

Dependencies

  • Starfish API for CampingCare and HotelCare

Troubleshooting

  • Ensure the API key credential is correctly configured and has necessary permissions.
  • Verify that required fields like accommodation ID, calculation ID, and dates are correctly provided based on the creation method.
  • Check date formats to match YYYY-MM-DD as required by the API.
  • If forcing own data, ensure forced rows are correctly structured with valid types and values.
  • Handle API errors gracefully by inspecting error messages returned from the Starfish API.

Links

Discussion