Portal-Synchronisation: unser System führt

- Connector-System (app/Channels, config/channels.php) mit iCal-Connector, robustem Parser und Export-Feed je Portal (ohne eigene Belegungen, ohne Gästedaten)
- Abgleich alle 5 Min. mit Protokoll, Echo-Erkennung, Konflikt-Mail bei möglicher Doppelbuchung
- Überwachung: Störungs-Mail, Status-Endpunkt /health/sync für n8n
- Portal-Aufgaben für Sofortbuchungsportale (FeWo-direkt): automatisch aus Buchungen/Sperren/anderen Portalen, Mail + Erinnerung, Abhaken im Admin
- Optionaler signierter Automatisierungs-Webhook mit Rückmeldung
- Herkunftsmessung: Abfrage im Formular + UTM-Parameter
- Portal-Analyse: AGB-Prüfung Automatisierung, Umsetzungsbeschreibung

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Lars StommerandClaude Opus 5.5 committed 2026-10-22 11:13:55 +02:00
1 parent a8e72715ab
commit 0b7205e050
55 files changed
+2290 -3

No files matched your search

+18
View File
@@ -89,6 +89,23 @@ ### Sofortbuchung bei FeWo-direkt – das eigentliche Risiko
- Technisch machbar (z. B. Playwright), **nicht** auf Strato (kein Browser) – passender Ort: Ihr privater Server (FastAPI/n8n), angesteuert per Webhook aus unserem System.
- **Risiken:** Nutzungsbedingungen verbieten automatisierten Zugriff häufig (für FeWo-direkt vor Umsetzung zu prüfen – die AGB-Seite war beim Abruf gesperrt); Kontosperre möglich; Zwei-Faktor-Anmeldung, Captchas und Oberflächenänderungen machen den Bot fehleranfällig. Deshalb nur mit Fehlerüberwachung und Rückfall auf Variante 1.
### AGB-Prüfung Automatisierung (Stand 22.10.2026)
- **Vrbo-Vermieter-AGB (Host Terms, § 14):** Vermieter dürfen den Dienst und seine Datenbanken nicht „automatisiert oder manuell“ kopieren oder verwerten und Inhalte oder Gästekommunikation nicht mit „robots, spiders or other automatic instruments“ überwachen. Das Setzen von Sperren per Bot ist nicht wörtlich genannt, fällt aber in eine Grauzone; Folge eines Verstoßes kann die Sperrung des Kontos sein.
- **FeWo-direkt (deutsche AGB):** Abruf beim Prüfen gesperrt (HTTP 429) – bitte im Vermieterbereich die aktuellen Nutzungsbedingungen einsehen.
- **Bewertung:** Kein Bot für FeWo-direkt ohne schriftliche Zustimmung von FeWo-direkt. Die Schnittstelle für eine externe Automatisierung (signierter Webhook + Rückmeldung) ist trotzdem gebaut – für Portale, die Automatisierung erlauben, oder falls FeWo-direkt zustimmt.
## 4b. Umsetzung im System
- **Admin › Wohnung › Portale & Kanäle:** Portal anlegen, iCal-Adresse des Portals eintragen, unsere Export-Adresse ins Portal kopieren, „Zusätzlich von Hand sperren“ für Sofortbuchungsportale (FeWo-direkt) aktivieren und Link zum Vermieterkalender hinterlegen.
- **Abgleich** alle 5 Min. (`channels:sync`), Protokoll je Portal, „Jetzt abgleichen“ per Klick.
- **Konflikt-Mail** sofort bei Überschneidung einer neuen Portalbelegung mit einer bestehenden Belegung.
- **Störungs-Mail** einmal pro Störung, wenn ein Portal 60 Min. lang nicht abgeglichen werden konnte.
- **Portal-Aufgaben** (Admin › Vermietung › Portal-Aufgaben): entstehen automatisch bei Bestätigung/Stornierung von Buchungen, bei Sperrzeiten und bei Belegungen anderer Portale; Mail sofort, Erinnerung nach 2 Std.
- **Status für n8n:** `GET /health/sync?token=…` (200 = ok, 503 = gestört) mit offenen Aufgaben und Zustand je Portal.
- **Automatisierungs-Webhook (optional):** `FEWO_AUTOMATION_WEBHOOK_URL` + `FEWO_AUTOMATION_SECRET`; Aufgaben werden als JSON mit `X-Signature` (HMAC-SHA256) gesendet, Erledigung per signiertem POST an die mitgelieferte `callback_url`.
- **Herkunft** jeder Anfrage („Wie sind Sie auf uns aufmerksam geworden?“ + UTM-Parameter) wird an der Buchung gespeichert.
## 5. Offene Fragen an die Anbieter
- **Tourist-Info / DS:** Provision und Gebühren in Kühlungsborn? Ist Online-Buchung Pflicht für den Verzeichniseintrag? Welche Channel-Manager sind zugelassen?
@@ -112,4 +129,5 @@ ## Quellen
- feratel / Channel-Manager: [Smoobu ↔ feratel Deskline](https://support.smoobu.com/hc/en-us/articles/360020483459-How-to-connect-Feratel-Deskline), [Beds24 ↔ feratel](https://wiki.beds24.com/wikiDE/index.php/Feratel), [Smoobu ↔ Ostsee-Ferienwohnungen.de/BestFewo](https://support.smoobu.com/hc/en-us/articles/5600409673490-How-do-I-connect-Optimale-Pr%C3%A4sentation-BestFewo-Ostsee-Ferienwohnungen-de-and-Secra-to-Smoobu)
- Ostseeklar: [Vermieter-Info](https://www.ostseeklar.de/vermieter.php), [Feondi-Schnittstelle Ostseeklar](https://www.fewo-verwalter.de/service/schnittstellen-beschreibung/schnittstelle-ostseeklar-de.html)
- Weitere: [Holidu iCal](https://www.holidu.com/help/host/managing-your-listings/how-do-i-configure-an-icalsync-to-connect-my-calendar-with-other-platforms), [Channel-Manager-Vergleich 2026](https://www.oasify.de/ratgeber/channel-manager-ferienwohnung-vergleich), [Doppelbuchungsrisiko iCal](https://www.almenrausch.at/magazin/detail/doppelbuchung-in-der-ferienwohnung/)
- Vrbo-AGB: [Host Terms](https://www.vrbo.com/en-ca/lp/b/host-terms-notice), [Guest Terms](https://www.vrbo.com/lp/b/terms-of-service)
- Channel-Manager & Vrbo: [Smoobu ↔ Vrbo/FeWo-direkt per iCal](https://support.smoobu.com/hc/en-us/articles/360018462060-Connect-Vrbo-FeWo-direkt-to-Smoobu-by-iCal), [Smoobu Preise](https://support.smoobu.com/hc/en-us/articles/360003170680-How-much-does-Smoobu-cost-Plans-and-pricing-explained), [Smoobu API](https://docs.smoobu.com/), [Smoobu Webhooks](https://support.smoobu.com/hc/en-us/articles/360003170740-Use-the-Smoobu-API-get-an-API-key-set-up-webhooks-and-sign-your-requests), [Beds24 Preise](https://www.beds24.com/pricing.html), [Beds24 VRBO Setup](https://wiki.beds24.com/index.php/VRBO_Setup), [Beds24 API V2](https://wiki.beds24.com/index.php/Category:API_V2), [Beds24 Webhooks](https://wiki.beds24.com/index.php/Booking_Webhooks), [Lodgify Vrbo-Anbindung](https://help.lodgify.com/hc/en-us/articles/21094192692380), [Host Port: Vrbo-Anbindung](https://hostport.co/blog/best-channel-managers-vrbo), [Vrbo-Partnerprogramme](https://www.rentalscaleup.com/airbnb-vrbo-and-booking-software-partner-programs-how-to-qualify-and-should-property-managers-care/), [Smoobu Erfahrungen (Capterra)](https://www.capterra.com.de/software/160106/smoobu), [Trustpilot](https://at.trustpilot.com/review/smoobu.com?page=10), [Hostradar-Test](https://hostradar.eu/en/reviews/smoobu/), [BGH I ZR 224/12 (Screen Scraping)](https://gesetze.co/urteile/I_ZR_224-12)