Files
fewo-stommer/docs/PORTALE.md
T
Lars 783068501c
Deploy FeWo mit PipelineManager / deploy (push) Successful in 2m33s
Generische iCal-Kanäle mit Bestandsklärung und sicheren Exporten bereitstellen
2026-10-27 17:14:45 +01:00

19 KiB
Raw Blame History

Portal-Analyse: Kalender-Abgleich, Buchungshoheit, Empfehlung

MVP-Folgeauftrag 27.10.2026: Bereitstellung und Benutzung beschreibt die automatische Generierung eines eigenen Exportlinks je Portal in der vorhandenen Oberfläche, persönliche Zuordnung mehrfacher Kalenderdarstellungen und konfigurierbares Echoverhalten. Die offene Frage zur zusätzlichen Kalenderpflege-Bestätigung bei Ostseeklar wird dort festgehalten. Reale Importadressen werden vom externen Portal bezogen und in der Oberfläche eingetragen.

Stand: 22.10.2026 · Grundlage: öffentliche Hilfeseiten und Vertragsunterlagen der Anbieter (Quellen unten). Konditionen, die nur Dritte nennen oder die vertragsabhängig sind, sind als „prüfen“ markiert.

Implementierungsergänzung 27.10.2026, noch nicht ausgeliefert: Generische iCal-Kanalkonfiguration dokumentiert die lokale Erweiterung mit unabhängigen Richtungen, Test-/Regulärmodus, eingefrorenen Exporten, Herkunft, sicherer Änderung/Entfernung und Tests. Die folgenden Anbieterangaben bleiben Recherche vom 22.10., keine neue Verifikation. Die frühere Beschreibung einer Mail/iCal-Übernahme anhand gleicher Termine in Abschnitt 4b ist im neuen Stand ersetzt: Zusammenführung nur über gemeinsame Referenz/UID; unbekannte Zuordnungen bleiben Prüffälle. Im Testmodus werden Fremdbelegungen auch nicht an andere Portale weitergegeben. Die von Lars berichtete erfolgreiche FeWo-direkt-Probe ist dort als einzelner Nutzerbericht getrennt von automatisierten Nachweisen erfasst.

1. Kurzfazit

  1. Die meisten genannten Portale nehmen Kalender per iCal an – FeWo-direkt, Ostseeklar und ferienundwohnen.de (automatisch nur im Premium-Inserat). Echtes „wir müssen führend sein“ verlangen vor allem Systeme mit Online-Buchung über eine Software-Schnittstelle: das Buchungssystem der Tourist-Information (DS Destination Solutions) und jedes Portal, sobald es per Channel-Manager-API angebunden ist (dann schaltet z. B. FeWo-direkt den iCal-Import ab).
  2. Es kann immer nur ein System führend sein. Entweder unser System (Variante A, iCal) oder ein Channel-Manager (Variante B, Echtzeit-API). Beides gleichzeitig führt zu Konflikten.
  3. Empfehlung: Start mit Variante A (unser System führt, iCal zu allen Portalen, die es können, enge Überwachung). Die Tourist-Information nicht als Buchungskanal, sondern als Schaufenster mit Link auf unsere Webseite nutzen – plus feratel-Meldeschein-Anbindung (spart Handarbeit bei Gästemeldung/Kurabgabe). Wechsel zu Variante B erst, wenn Sofortbuchungsportale (FeWo-direkt mit Sofortbuchung, Booking.com) einen relevanten Anteil haben. Unser Connector-System ist dafür vorbereitet.

2. Portale im Einzelnen

Portal Buchungsmodell Kalender von uns übernehmen (Import) Kalender an uns geben (Export) Schnittstelle / Channel-Manager Kosten
FeWo-direkt (Vrbo / Expedia Group) Anfrage oder Sofortbuchung über das Portal Ja, bis zu 5 iCal-Kalender je Objekt, Anzeige nach bis zu 20 Min., 365 Tage voraus – nur solange das Objekt im Vermieterbereich verwaltet wird, nicht bei Anbindung über Fremdsoftware Ja, iCal-URL (optional inkl. vorläufiger Buchungen) API nur über zertifizierte Partner (Channel-Manager) prüfen (Abo/Provision je nach Modell)
ferienundwohnen.de Inserat; Anfragen gehen direkt per E-Mail/Telefon an den Vermieter, keine Provision Gratis-Inserat: nur manuelle Synchronisierung; Premium: automatischer iCal-Abgleich Belegungsplan „mit vielen Kalendern kompatibel“ – Exportrichtung prüfen keine bekannt Gratis oder Premium (Preis: prüfen)
Tourist-Information Kühlungsborn (kuehlungsborn.de) Gastgeberverzeichnis (Präsentation, Kontakt) und Online-Buchung über DS Destination Solutions (Buchungsmaske ibe.ds-srv.net); Vertrag kommt zwischen Gast und Gastgeber zustande Nein per iCal; DS erwartet Pflege im DS-System oder Anbindung eines zugelassenen Channel-Managers (eigener Schnittstellenvertrag) über DS/Channel-Manager DS ist selbst Channel-Manager (HRS-Gruppe); externe Channel-Manager nur mit Vertrag DS ↔ Partner DS: provisionsbasiert, i. d. R. ohne Grundgebühr; Anbindungsgebühr in anderen Regionen 119 € einmalig; Konditionen Kühlungsborn: prüfen
Kühlungsborn – Meldeschein (feratel MeldeClient) Pflicht-Gästemeldung, Kurabgabe, digitale Gästekarte „Küstenkarte“; 5 % Aufwandsentschädigung lt. Kurabgabesatzung – – Schnittstelle für Software-Partner (Kundenportal feratel, Testbetrieb), Pre-Check-In-Link für Gäste –
Ostseeklar Inserat, Anfrage Ja, iCal-Link wird bei Ostseeklar hinterlegt Belegungskalender einbindbar – Exportrichtung prüfen Kalenderschnittstelle zu Fewo-Line und Fewo-Verwalter/Feondi Paket „1 Inserat“ 89 €/Jahr inkl. iCal (lt. Anbieterseite; prüfen)

Typische weitere Portale

Portal Kalender-Abgleich Bemerkung
Booking.com iCal für Ferienwohnungen mit Einschränkungen (u. a. max. 20 Zimmertypen à 1 Einheit), Einstellung „Gebucht + geschlossene Termine“ wichtig Sofortbuchung, hohe Reichweite, Provision; echte Synchronisation nur per Channel-Manager-API
Airbnb iCal Import/Export, Abruf ca. alle 2 Std., nur 364 Tage voraus API nur über Partner
Holidu / ferienwohnungen.de iCal Import und Export (zweistufig einzurichten) Meta-Suche mit eigener Buchung
Traum-Ferienwohnungen iCal-Abgleich vorhanden (nicht offiziell verifiziert – prüfen) Anfrage/Sofortbuchung, großes deutsches Portal
Ostsee-Ferienwohnungen.de, BestFewo, Optimale Präsentation per Channel-Manager (z. B. Smoobu) anbindbar regionale Reichweite Ostsee

Zeitversatz iCal: je nach Portal 15 Min. bis mehrere Stunden; deckt nur Belegung ab (keine Preise, keine Gästedaten).

3. Varianten

A – Unser System führt (iCal) · empfohlen für den Start

  • Import: Wir lesen alle 5 Min. die iCal-Feeds der Portale → Sperrzeiten.
  • Export: je Portal ein eigener Feed mit allen Belegungen außer denen dieses Portals (verhindert Rückkopplung).
  • Überwachung: Sync-Protokoll, Warnung bei Fehlern/veralteten Feeds, sofortige Konflikt-Mail, /health/sync für n8n.
  • Webseiten-Anfragen sind risikofrei (Prüfung vor Bestätigung). Restrisiko nur bei Sofortbuchungen auf zwei Portalen im selben Zeitfenster.
  • Kosten: keine zusätzlichen.

B – Channel-Manager führt (Echtzeit-API)

  • Smoobu, Beds24 o. ä. synchronisiert FeWo-direkt, Booking.com, Airbnb (und ggf. DS/feratel) in Sekunden.
  • Unser System wird ein Kanal des Channel-Managers (API + Webhooks): Webseiten-Buchungen gehen sofort hinein, Portalbuchungen kommen sofort heraus.
  • Preise müssen dann im Channel-Manager gepflegt oder von uns dorthin übertragen werden.
  • Kosten: ca. 10–45 €/Monat je nach Anbieter und Objektzahl (Angaben in Vergleichen widersprüchlich – prüfen).

Mischform vermeiden

Ein Portal per API und per iCal anzubinden erzeugt Doppel- oder Fehlsperren. Pro Portal genau ein Weg.

4. Empfehlung je Kanal

Kanal Empfehlung
Eigene Webseite Hauptkanal, provisionsfrei, führt die Belegung (Variante A)
FeWo-direkt iCal in beide Richtungen; Sofortbuchung nur, wenn das Restrisiko akzeptiert wird, sonst Anfrage
Ostseeklar iCal-Import unseres Feeds
ferienundwohnen.de Nur behalten, wenn Anfragen kommen (Quelle messen); automatischer Abgleich erfordert Premium
Tourist-Info Kühlungsborn Gastgeberverzeichnis mit Link auf unsere Webseite; keine DS-Online-Buchung in Variante A. feratel-Meldeschein anbinden (Gästemeldung/Kurabgabe aus unseren Buchungsdaten, Pre-Check-In-Link in der Anreise-Mail)
Booking.com / Airbnb Erst mit Variante B sinnvoll

4a. Channel-Manager: Konditionen, Zuverlässigkeit, Eigenbau

Kernbefund: Für FeWo-direkt bringt ein Channel-Manager bei einer einzelnen Wohnung in Deutschland voraussichtlich keinen Echtzeit-Vorteil:

  • Vrbo/FeWo-direkt hat keine frei zugängliche API; Zugang nur über zertifizierte Partner.
  • Smoobu bindet Vrbo/FeWo-direkt nur per iCal an: Vrbo-Buchungen kommen nach 10–20 Min. bei Smoobu an, Änderungen in Smoobu brauchen bei Vrbo bis zu 24 Std.
  • Beds24: Vrbo-XML-Anbindung in manchen Regionen erst ab 5 Objekten, sonst iCal.
  • Lodgify: Vrbo-API ohne Mindestanzahl nur für Nordamerika/APAC.
  • Ein Channel-Manager wäre für FeWo-direkt also dieselbe iCal-Verbindung wie unsere – nur mit zusätzlicher Zwischenstation.
Smoobu Beds24 Eigenbau (unser System)
Kosten 1 Objekt 35 €/Monat (Jahresabo 31,50 €), Flex 29 € + 0,9 % ab 15,50 €/Monat + 0,55 € je Kanal-Verknüpfung keine laufenden Kosten
FeWo-direkt iCal iCal (API erst ab 5 Objekten, regional) iCal
Booking.com / Airbnb API (Echtzeit) API (Echtzeit) nur iCal – API-Zugang für Eigenbau praktisch ausgeschlossen (Partnerzertifizierung)
Eigene API für unser System ja (Buchungen, Preise, Webhooks) ja, umfangreich (API v2, Webhooks) –
Zuverlässigkeit überwiegend positive Erfahrungsberichte, vereinzelt hängende Syncs/Doppelbuchungen (teils alte, teils Affiliate-Quellen) technisch stark, steile Lernkurve so gut wie unsere Überwachung

Nachbauen lässt sich: iCal-Import/-Export, Überwachung, Konfliktwarnung, Statusseite – das ist im Kern, was ein Channel-Manager für FeWo-direkt heute leistet. Nicht nachbauen lässt sich: die API-Anbindung an Booking.com, Airbnb und Vrbo (nur für zertifizierte Softwareanbieter mit Volumen).

Sofortbuchung bei FeWo-direkt – das eigentliche Risiko

Gefährlich ist nur die Richtung „anderswo gebucht → FeWo-direkt sperrt zu spät“, weil FeWo-direkt unseren Feed in unbekannten Abständen abholt. Gegenmaßnahmen, von einfach bis aufwendig:

  1. Sperr-Aufgabe im Workflow (empfohlen, sofort): Bei jeder bestätigten Buchung, die nicht von FeWo-direkt kommt, erzeugt unser System eine Aufgabe „Bei FeWo-direkt sperren“ mit direktem Link in den Vermieterkalender; erledigt per Klick. Bei ca. 20–40 Buchungen/Jahr ein Aufwand von Sekunden, 100 % zuverlässig, kein Regelverstoß. Unser iCal-Feed bleibt zusätzlich als Absicherung aktiv.
  2. Sofortbuchung auf Anfrage umstellen: eliminiert das Risiko, kann aber das Ranking bei FeWo-direkt verschlechtern.
  3. Browser-Automatisierung („manueller Zugang simuliert“): Ein Bot meldet sich im Vermieterbereich an und setzt die Sperre.
    • 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.
  • E-Mail-Schnellerkennung: Buchungs-, Storno- und Anfrage-Mails der Portale (Absender je Portal hinterlegt, z. B. fewo-direkt.de, vrbo.com) werden jede Minute per IMAP gelesen (channels:fetch-mail, Mails bleiben ungelesen) oder per signiertem Push von n8n (POST /automation/portal-mail) übergeben. Erkannte Buchungen werden sofort gesperrt (Quelle „email“) und an manuell gepflegte Portale weitergegeben; der spätere Kalender-Abgleich übernimmt die Sperre (gleiche Daten) bzw. ersetzt sie (abweichende Daten). Stornierungs-Mails heben Mail-Sperren auf. Nicht sicher erkannte Mails → „Bitte prüfen“ mit Mail an den Vermieter und Aktion „Sperre anlegen“ im Admin (Vermietung › Portal-E-Mails). Postfach-Störungen werden wie Portal-Störungen gemeldet und im Status-Endpunkt angezeigt.
  • Zeitkette FeWo-direkt-Buchung: E-Mail (≈ 1–2 Min.) bzw. Kalender (≤ 5 Min. + Bereitstellung durch FeWo-direkt) → Sperre auf unserer Webseite sofort → Feeds der anderen Portale sofort aktualisiert (Abholung durch das Portal in dessen Takt) → bei Portalen mit Handpflege zusätzlich Aufgabe + Mail.
  • 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?
  • feratel: Zugang zum Schnittstellen-Kundenportal für die Meldeschein-API (Testbetrieb), Kosten für Software-Partner?
  • FeWo-direkt: Aktuelles Vertragsmodell (Abo/Provision), Sofortbuchung aktiv? Ist das Objekt aktuell über eine Software angebunden?
  • Ostseeklar / ferienundwohnen.de: Exportieren sie selbst einen iCal-Feed (für Anfragen, die dort als „belegt“ eingetragen werden)? Preis Premium?

6. Nächste Schritte im System

  1. Herkunft jeder Anfrage erfassen („Wie haben Sie uns gefunden?“ + UTM-Parameter) → Portal-Nutzen messen.
  2. iCal-Connector (Import/Export je Kanal) mit Überwachung – siehe Konzept §7/§7a.
  3. feratel-MeldeClient-Connector nach Klärung der Schnittstelle.
  4. Channel-Manager-Connector (Smoobu oder Beds24) als Option für Variante B.

Quellen