Belegungsdaten können an uns über unsere ical-Schnittstelle übermittelt werden. Wir nutzen die übermittelten Belegungsdaten:
- für den Belegungskalender in den Einträgen
- für die Suche unserer Leser nach verfügbaren Zeiträumen
Hier die technischen Details zur Schnittstelle:
technische Grundlage
Wir nutzen zum Austausch das ical-Protokoll (iCalendar) nach der internationalen Norm RFC 5545:
-> https://de.wikipedia.org/wiki/ICalendar.
Der Austausch von Belegungsdaten über das ical-Protokoll wird von vielen anderen Plattformen praktiziert, z. B. airBNB, booking.com, Fewo etc.
Es handelt sich also nicht um eine URLAUBSARCHITEKTUR spezifische Lösung!
Eine entsprechende Schnittstelle ist für unterschiedliche Buchungssoftware oder Channelmanager verfügbar.
ical-Link
Für jede Unterkunft (Apartment / Zimmer) benötigen wir einen separaten ical-Link (= URL), über den wir jederzeit die Datei mit den aktuellen Belegungsdaten abrufen können. Bei größeren Unterkünften können nach vorheriger Abstimmung u.U. auch Daten der Zimmerkategorien verwendet werden.
Die von uns zur Einrichtung benötigte Liste kann z.B. so aussehen:
- Apartment 1, https://www.webseite.de/7d8c4a20caf04d15b12924433d5a0099.ics
- Apartment 2, https://www.webseite.de/7d8c4a20caf04d15b12924433d5a0098.ics
- Apartment 3 …
Alle ical-Links müssen ohne weitere Authentifizierung aufrufbar sein.
Ãœber den Aufruf des Links werden die aktuellen Belegungsdaten als Datei heruntergeladen und von uns verarbeitet.
Wir laden die Belegungsdaten über die ical-Links alle 6 Stunden neu und verwerfen die älteren Daten.
Die Schnittstelle ist eindirektional: Wir erhalten die Daten der aktuellen Belegung; da über URLAUBSARCHITEKTUR keine Buchungen erfolgen, benötigt die Gegenseite keine Daten von uns.
ical-Datei
Ãœber den ical-Link laden wir die ical-Datei mit den Belegungsdaten.
Die Datei hat typischerweise die Dateiendung .ics. Wir benötigen in der Datei die Daten von allen belegten oder nicht verfügbaren Zeiträumen mit Start- und Enddatum.
Jeder belegte Zeitraum ist in der Datei ein VEVENT, der Datensatz einer Belegung ist z.B.:
BEGIN:VEVENT
DTEND;VALUE=DATE:20220520
DTSTART;VALUE=DATE:20220207
END:VEVENT
Bei der Angabe des Start- und Enddatums gibt es zum Teil Unterschiede, die wir aber in der Regel verarbeiten können, z. B. folgende Varianten:
DTEND:20220609
DTSTART:20220608
DTEND:VALUE=DATE:20220609
DTSTART:VALUE=DATE:20220608
Die Datei kann darüber hinaus weitere Angaben enthalten, z. B. Angaben zur Unterkunft (Zimmernummer etc.), zur Buchung (Gastname, Buchungsnummer etc.), Uhrzeit Checkin/Checkout oder Daten von vergangenen Buchungen. Alle diese Daten dürfen in der Datei enthalten sein, werden aber von uns nicht verarbeitet. Wir verarbeiten nur VEVENTs ab dem aktuellen Datum und jeweils nur das Start- und Enddatum.
Bitte beachten Sie aber die erforderlichen Anforderungen an den Datenschutz, falls die Datei personenbezogene Daten enthält.