Kalender Sync

Lösungen für iCal Sync und Kalender-Probleme.

iCal Import funktioniert nicht

URL wird abgelehnt

Symptom: "Bitte gib eine gültige URL ein" (oder "Bitte überprüfe deine Eingaben.", falls die URL formal gültig ist, aber auf eine private/interne Adresse zeigt)

Lösung:

• URL muss mit http:// oder https:// beginnen

• URL darf nicht auf eine private/interne Netzwerkadresse zeigen (localhost, 127.x.x.x, 10.x.x.x, 172.16-31.x.x, 192.168.x.x etc. — aus Sicherheitsgründen blockiert)

• URL muss gültigen iCal-Inhalt liefern (.ics)

• Teste URL im Browser (sollte Download starten)

• Generiere neue URL auf Plattform

Keine Events importiert

Symptom: Sync erfolgreich, aber keine Blocks sichtbar

Ursache:

• Nur zukünftige Events werden importiert
• Vergangene Buchungen werden ignoriert

Lösung:

• Überprüfe Datumsbereiche in externem Kalender
• Stelle sicher, dass zukünftige Buchungen existieren

Sync-Verzögerung

Änderungen nicht sofort sichtbar

Normal:

• Automatische Sync (Stayoa): Alle 30 Minuten
• Externe Plattformen (Airbnb/Booking.com): ca. 15-60 Minuten, bis diese ihren eigenen Feed aktualisieren
• Total: Bis zu ca. 1.5 Stunden Verzögerung im ungünstigsten Fall

Lösung:

• Klicke Sync Now für sofortige Sync
• Warte 1-2 Minuten
• Aktualisiere Kalender-Ansicht

Doppelbuchungen

Trotz Sync Doppelbuchung möglich

Ursache: Sync-Verzögerung zwischen Plattformen

Prävention:

• Manuell syncen vor wichtigen Zeiträumen
• Regelmässig Kalender prüfen

Bei Doppelbuchung:

• Identifiziere welche Buchung storniert werden soll

• Storniere auf entsprechender Plattform

• Informiere Gast schnellstmöglich

• Entschädigung gemäss Stornierungsrichtlinie

Export-Probleme

Externe Plattform akzeptiert URL nicht

Lösung:

• Kopiere URL genau (kein Leerzeichen am Ende)

• Prüfe ob Plattform iCal Import unterstützt

• Versuche URL in Browser (sollte .ics herunterladen)

• Kontaktiere Support der externen Plattform

Buchungen erscheinen nicht auf externer Plattform

Ursache: Externe Plattform syncet langsam

Lösung:

• Warte 1-2 Stunden
• Trigger manuellen Sync auf externer Plattform
• Überprüfe ob URL korrekt eingefügt

Manuelle Blocks vs. iCal Import

Kann manuellen Block nicht erstellen

Symptom: "Eine Sperrung für diesen exakten Zeitraum existiert bereits" oder "Eine Sperrung überschneidet sich mit einem bestehenden Zeitraum"

Ursache: iCal-Import-Blocks sind von dieser Überschneidungsprüfung bewusst ausgenommen — ein manueller Block kann jederzeit auch auf Daten erstellt werden, die bereits durch einen iCal-Import belegt sind (er existiert dann einfach parallel dazu; iCal-Import-Blocks werden beim nächsten Sync ohnehin ersetzt). Dieser Fehler bedeutet, dass ein anderer manueller Block (oder ein aus einer Buchung abgeleiteter Block) bereits denselben oder einen überschneidenden Zeitraum belegt.

Lösung:

• Kalender auf einen bestehenden manuellen Block im gleichen Zeitraum prüfen

• Den überschneidenden manuellen Block zuerst bearbeiten oder löschen, dann erneut versuchen

• Die iCal URL muss nicht entfernt werden, um einen manuellen Block über iCal-Import-Daten zu erstellen

Calendar View

Kalender lädt nicht

Lösung:

• Browser aktualisieren (F5)

• Cache leeren

• Anderen Browser testen

Blocks falsch angezeigt

Lösung:

• Check-in/Check-out Zeiten prüfen

• Timezone-Einstellungen überprüfen

• iCal Sync manuell auslösen

Häufige Fehler

Sync schlägt wiederholt fehl (Benachrichtigung: "iCal-Sync fehlgeschlagen")

Ursache: Die externe URL war nicht erreichbar, hat nicht rechtzeitig geantwortet, oder einen Fehler zurückgegeben. Jede URL wird innerhalb eines Sync-Versuchs automatisch 3-mal wiederholt (mit kurzem Backoff von wenigen Sekunden) — keine verzögerte Wiederholung — bevor der Versuch als fehlgeschlagen markiert wird.

Lösung:

• URL in Browser testen
• Plattform-Status prüfen (Airbnb/Booking.com down?)
• Neue URL generieren
• Nicht nötig zu warten — die nächste automatische Sync läuft innerhalb von 30 Minuten, oder Sync Now klicken für sofortigen Versuch

Ungültiges iCal-Format

Ursache: Die URL liefert keinen gültigen iCal-Inhalt (kein BEGIN:VCALENDAR/BEGIN:VEVENT) — die externe Plattform liefert einen ungültigen oder leeren Feed

Lösung:

• Generiere neue Export-URL auf Plattform
• Kontaktiere Plattform-Support
• Als Workaround: Manuell Blocks erstellen