iCal-Synchronisation

Zwei-Wege-iCal-Synchronisation

Kalender-Tool 2.0 unterstützt die bidirektionale iCal-Synchronisation mit externen Plattformen wie Airbnb, Booking.com und Smoobu. So bleiben deine Buchungen über alle Plattformen hinweg aktuell.

Export: Von Kalender-Tool 2.0 nach außen

Jede Ressource bietet einen iCal-Export-Feed:

https://www.kalender-tool.de/cal/{token}/resource/{resource_id}.ics

Dieser Feed enthält alle bestätigten und gesperrten Buchungen der letzten 12 Monate. Trage diesen Link in die Kalender-Import-Funktion deiner externen Plattform ein.

• Airbnb: Kalender → Verfügbarkeit → Kalender importieren → URL einfügen
• Booking.com: Preise & Verfügbarkeit → Kalender-Sync → Feed-URL einfügen
• Smoobu: Channels → iCal Sync → URL hinzufügen

Import: Von außen nach Kalender-Tool 2.0

Um Buchungen von einer externen Plattform automatisch in Kalender-Tool 2.0 zu importieren, legst du einen iCal-Feed für die Ressource an:

1. Feed-URL beschaffen
   Kopiere die iCal-Export-URL aus deiner externen Plattform (z.B. Airbnb → Kalender → Kalender exportieren).
2. Feed hinzufügen
   Öffne den Buchungskalender → Ressourcen → klicke auf „Bearbeiten" bei der gewünschten Ressource. Unter dem Abschnitt „iCal Sync" findest du das Formular „Import feeds". Gib ein Label (z.B. „Airbnb") und die iCal-URL ein und klicke auf „+ Feed hinzufügen".
3. Automatische Synchronisation
   Kalender-Tool 2.0 synchronisiert den Feed automatisch alle 15 Minuten. Neue Buchungen aus der externen Plattform erscheinen als gesperrte Buchungen in Kalender-Tool 2.0.

Wie funktioniert der Import?

• Der Feed wird alle 15 Minuten abgerufen (via bookings:sync Scheduled Command)
• Neue iCal-Einträge (VEVENTs) werden als Buchungen mit Status „Gesperrt" angelegt
• Reservierte Zeiträume werden an SUMMARY-Schlüsselwörtern erkannt: „reserved", „booked", „not available", „closed"
• Jede importierte Buchung erhält eine externe Referenz (feed:{feed_id}:{vevent_uid})
• Wenn ein Eintrag aus dem externen Feed verschwindet, wird die zugehörige Buchung in Kalender-Tool 2.0 gelöscht
• Wichtig: Nur Buchungen mit passender Feed-Referenz werden beim Sync verwaltet — manuell erstellte Buchungen werden nie berührt

Manuelle Synchronisation

Neben der automatischen 15-Minuten-Synchronisation kannst du einen Feed auch manuell synchronisieren. Klicke dazu auf den „Sync"-Button neben dem Feed in der Ressourcen-Verwaltung.

Fehlerbehandlung

Wenn ein Feed nicht abgerufen werden kann (z.B. weil die URL ungültig ist oder der Server nicht erreichbar), wird der letzte Fehler und der Zeitpunkt des letzten erfolgreichen Syncs angezeigt. Die anderen Feeds werden weiterhin normal synchronisiert.