URLAUBSARCHITEKTUR.ORG

ical-link of booking data

ical is the standard data format for calendar data. On the property’s details page, you will find two versions of the calendar’s ical-link:

  • The public link transfers the occupied days without detailed information.
  • The private link contains additional booking data: booking number, notes, name, and contact details of the guest – but NO price information for the booking. When sharing the private link, the applicable data protection regulations must be observed!

You can use the ical-links to store them in a calendar (Outlook, Apple Calendar, e.g.) or in another booking system.

When adding ical-links to a calendar, make sure to add the data as a “subscription” to ensure that the data is updated regularly. How often the date is updates depends on the calendar software used.

Various calendars also offer the option of importing data via iCal. This usually means that the data is only added to the calendar once and is not automatically updated afterward.

Customizing the ical-links

The ical-links generated by the booking tool contain by default all bookings with the status booked and all blocked periods. In some cases, it may be useful or necessary to also transfer canceled bookings and requested bookings; for example, when a receiving system only processes a canceled booking correctly if the booking is transferred as a cancelled calendar entry.

The ical-links can be extended and configured with the following additions so that cancelled bookings/requested bookings and arrival/departure times are also transferred; the language of the detailed information in bookings can also be adjusted in this way:

Requested bookings:

...&includeInquired=true

Cancelled bookings:

...&includeCancelled=true

Language of detailed information German/English:

...&locale=de
...&locale=en

Arrival/departure time:

...&includeArrivaltime=16&includeDeparturetime=10


The time can be adjusted accordingly. Adding arrival and departure times improves the display of bookings in some external calendar systems.

Examples:

ical-link (example):

  • https://urlaubsarchitektur.biz/assets/ical/property-calendar.ics?propertyId=123456789

Link with additions:

  • https://urlaubsarchitektur.biz/assets/ical/property-calendar.ics?propertyId=123456789&includeCancelled=true&includeInquired=true
  • https://urlaubsarchitektur.biz/assets/ical/property-calendar.ics?propertyId=123456789&includeArrivaltime=16&includeDeparturetime=10