ical ist das Standard-Datenformat für Kalenderdaten. Über die ical-Links haben andere Buchungssysteme oder Kalender (z. B. Outlook oder Apple Kalender) die Möglichkeit, Belegungsdaten aus unserem System herunterzuladen. Wie häufig dabei eine Aktualisierung erfolgt, hängt vom jeweiligen Fremdsystem ab.
Auf der Detailseite der Unterkunft finden Sie den ical-Link in zwei Varianten:
- Der öffentliche Link überträgt die belegten Tage ohne Detailinformationen.
- Der private Link enthält zusätzliche Daten zur Buchung: Buchungsnummer, Notizen, Name und Kontaktdaten des Gastes; jedoch KEINE Preisinformationen zur Buchung. Bei der Weitergabe des privaten Links sind die geltenden Datenschutzvorschriften zu beachten!
Wenn Sie die ical-Links zu einem Kalender oder einer anderen Software hinzufügen, achten Sie darauf, die Daten als „Abonnement“ bzw. „Subscription“ hinzuzufügen. Über ein Abonnement werden die Daten regelmäßig aktualisiert. Wie häufig eine Aktualisierung erfolgt, hängt vom jeweiligen Fremdsystem ab.
Verschiedene Kalender bieten auch die Option an, ical-Daten zu importieren. Dies bedeutet aber in der Regel, dass die Daten nur einmalig in den Kalender eingefügt und danach nicht automatisch aktualisiert werden.
Mit den Buttons hinter dem öffentlichen und privaten Link lassen sich die jeweils aktuellen Daten auch als ical-Datei herunterladen. Hinweis: Dies sind statische Dateien des aktuellen Standes, es sind keine Links.
Anpassung der ical-Links
Standardmäßig werden über ical-Links die Daten aller aktuellen und kommenden Buchungen mit dem Status gebucht und alle blockieren Zeiträume. In einigen Fällen kann es sinnvoll oder notwendig sein, auch stornierte Buchungen und angefragte Buchungen mit zu übertragen.
Ein Anwendungsfall ist zum Beispiel, wenn ein empfangendes System eine abgesagte Buchung erst dann richtig verarbeitet, wenn die Buchung als gecancelter Kalendereintrag mit übertragen wird.
Die ical-Links können mit folgenden Zusätzen so erweitert und konfiguriert werden, dass zusätzlich auch stornierte Buchungen / angefragte Buchungen und Anreise-/Abreisezeiten mit übertragen werden; auch die Sprache der Detailinformationen in Buchungen kann so angepasst werden:
angefragte Buchungen mit übertragen:
...&includeInquired=truestornierte Buchungen mit übertragen:
...&includeCancelled=trueSprache Detailinformationen Deutsch / Englisch:
...&locale=de
...&locale=enAnreise-/Abreisezeit mit übertragen:
...&includeArrivaltime=16&includeDeparturetime=10
Die Uhrzeit kann entsprechend angepasst werden. Der Zusatz der An- und Abreisezeiten verbessert die Darstellung der Buchungen in einigen externen Kalendersystemen.
Anwendungsbeispiele:
ical-Link (Beispiel):
- https://urlaubsarchitektur.biz/assets/ical/property-calendar.ics?propertyId=123456789
Beispiellink mit Ergänzungen:
- 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