Belegungsdaten können an UA über unsere ical-Schnittstelle übermittelt werden.

Wir nutzen die übermittelten Belegungsdaten:

• für den Belegungskalender in den einzelnen Einträgen
• für die Suche unserer Leser nach verfügbaren Zeiträumen

Hier die technischen Details zur Schnittstelle:

Grundlage

Wir nutzen zum Austausch das ical-Protokoll (iCalendar) entsprechend der internationalen Norm RFC 5545.
-> https://de.wikipedia.org/wiki/ICalendar.

Der Austausch von Belegungsdaten über das ical-Protokoll wird in der von uns genutzten Form von vielen anderen Plattformen praktiziert, z.B. airBNB, booking.com, Fewo etc.
Es handelt sich also nicht um eine UA spezifische Lösung !
Eine entsprechende Schnittstelle ist für unterschiedliche Buchungssoftware oder Chanelmanager 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 .ics 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 URLAUBSARCHITEKTUR keine Buchungen bearbeitet, benötigt die Gegenseite keine Daten von uns.

.ics-Datei

Wir benötigen in der .ics-Datei die Daten von allen belegten oder nicht verfügbaren Zeiträume mit Start- und Enddatum. Benötigt werden jeweils die Daten ab dem aktuellen Datum.
Jeder belegte Zeitraum ist in der .ics-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.:

DTEND:20220609
DTSTART:20220608

DTEND:VALUE=DATE:20220609
DTSTART:VALUE=DATE:20220608

Die .ics 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 .ics-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 die erforderlichen Regelungen zum Datenschutz, falls die .ics Datei entsprechende Daten enthält.