--- basis/X00_Sonderprozesse.md +++ v0.7/X00_Sonderprozesse.md @@ -3,7 +3,7 @@ typ: prozesskatalog titel: Sonder- und Ausnahmeprozesse status: arbeitsstand -version: '0.6' +version: '0.7' --- # X00 – Sonder- und Ausnahmeprozesse (vorläufiger Katalog) @@ -27,3 +27,10 @@ **Prozessübergabe nach V01 (E-010):** Nach Abschluss der Buchungs- und Leistungserbringung noch offene Fälle (z. B. Schadenersatzforderung, Erstattung, Streitfall) werden an einen zuständigen Folgeprozess übergeben. Sie bleiben mit der ursprünglichen Buchung verbunden. Ob dafür ein separater Vorgang oder eine verknüpfte Aktivität angelegt wird, ist noch nicht entschieden. **Rechtsfragen separat:** Für externe Vollabwicklung liegt die Vertrags-/Mahn-/Storno-Verantwortung beim Portal gemäß vertraglicher Vereinbarung; FewoPortal braucht einen nachvollziehbaren Übergabestatus und mindestens die für eigene Pflichten nötigen Informationen. + + +## Präzisierung v0.7: Änderungs-/Stornovorgang und Konfliktnachweise + +- **X02/X04:** Zwischen *Anfrage*, *Annahme/Bestätigung*, *wirksamer Vertragsänderung/Stornierung* und *tatsächlichen Finanz-/Belegungsfolgen* unterscheiden. Ursache, Initiator, Ausführender und Verantwortlicher sind keine austauschbaren Felder. Tatsächlicher Vermieterstornogrund bleibt Vermieterstornogrund, selbst wenn ein Gast auf der Portaloberfläche die Aktion ausführt; Portalregeln und rechtliche Wirkungen gesondert prüfen. Der Betreiber hat beim FeWo-direkt-Konto bislang keine solche Änderung oder Vermieterstornierung selbst durchgeführt; unbekannte Prozesse nicht als erprobte Ist-Abläufe ausgeben. +- **X05/X06:** Fehlende Preisdetails, zusammengefasste Service-/Provisionsanteile oder abweichende Auszahlungssummen sind normale Klärungsfälle; manuelle Zuordnung und erneuter Abgleich, ohne Buchungspreis zu überschreiben. +- **X07:** Bei Destination Solutions manuelle Kalendersperre ohne serverseitig/partnernetzweit bestätigten Sperrnachweis; bei FeWo-direkt verzögerter iCal-Import. Technische Ursache und mögliche Rechts-/Haftungsfolgen getrennt bewerten. [Ausführlicher Fachfall X07](X01_Belegungskonflikte_und_Sperrnachweise.md). --- basis/AENDERUNGSUEBERSICHT.md +++ v0.7/AENDERUNGSUEBERSICHT.md @@ -6,3 +6,14 @@ - Offene Detailkriterien und Zustandsübergänge ausdrücklich **nicht** als entschieden dargestellt. - Keine Löschung bestehender Inhalte, keine Änderung des Anwendungscodes. Gitea selbst wurde nicht verändert. - `AENDERUNGEN_ZU_V0.6.diff` dokumentiert die tatsächlichen Textänderungen. + + +# Änderung v0.7 gegenüber v0.6 (Konsolidierung 31.10.2026) + +- E-012–E-021 aus dem fachlichen Interview nachgeführt; fünf Archetypen, kein A6. +- Destination Solutions (A3) als realer Referenzfall samt Stornostaffel, manueller Sperre ohne Übernahmenachweis, provisionsabhängigen Partnerkanälen und ungeklärtem Gast-Aufschlag dokumentiert. +- FeWo-direkt (A4) um differenzierte Zahlungsdaten, iCal-Risiko, noch offene Rechts-/Gast- und Gebühreninformationen ergänzt. +- Flexible Preispositionen und Sammelbeträge, manuelle/hybride Klärung und kontrollierbare Nachweiskette in P01–P05, K00/K01, G00, X00 aufgenommen. +- Neues Portalfragenregister und verbindliche Dokumentationsarbeitsregel: aktuelle Originaldokumente künftig **vor jedem Edit erneut anfordern**. +- R01-Referenzentwurf inhaltlich unverändert übernommen, R08 neu ergänzt. +- Ausgangsdokumente unverändert gelassen; Diff und Prüfliste im Paket. Keine Gitea-Änderung/Implementierungsfreigabe. --- basis/00_Portalprofile_und_Vertragsvorlagen.md +++ v0.7/00_Portalprofile_und_Vertragsvorlagen.md @@ -3,10 +3,10 @@ typ: fachliches-konzept titel: Portalprofile, Konditionsquellen und Vertragsvorlagen status: diskussionsentwurf -version: "0.1" +version: "0.2" stand: 2026-10-31 prozess: V01 -bezugsstand_archetypen: "0.3" +bezugsstand_archetypen: "0.6" --- # K00 – Portalprofile und Vertragsvorlagen @@ -39,7 +39,7 @@ | A1 / A2, eigener Angebotsabschluss | Eigenes **bindendes Angebot** mit ausgewählten Vertragsbedingungen/Anlagen. Wirksam angenommene Version wird unverändert nachgewiesen; anschließend Vertragsdokument bzw. Bestätigung aus diesem Stand. | | A3 / A4, extern bereits verbindlich, Vertragstext/Unterlagen durch uns | **Kanal- und buchungstypspezifische Vertragsdokumentation** der bereits vereinbarten Bedingungen; **keine zweite obligatorische Annahme**. Widersprechende/neue Klauseln nicht still ergänzen. | | A5, Vertrag/Abwicklung extern | Externen Vertrags- und Konditionsnachweis referenzieren/ablegen, eigene Dokumente nur, wenn erforderlich. Keine doppelte Vertragsbegründung. | -| A6, Hub/Partnervermittlung | Aus Herkunft und tatsächlicher Zuständigkeit das passende A2–A5-Profil und damit Dokumentenprofil bestimmen. | +| Optional: Partnerherkunft | **Kein eigener Archetyp A6.** Nur bei kaufmännischer Relevanz (z. B. unterschiedliche Vermittlerprovision) Herkunft erfassen; Buchung bleibt A1–A5. | Eine **gemeinsame Konditions-/Vertragszusammenstellung** soll vor dem Versand anzeigen: maßgeblicher Preis, enthaltene/optionale Leistungen, Rabatte, Stornoregel, Gastdaten, gewählte **Vorlage mit Version**, passende **Anlagen**, nachweisbarer Konditionsstand und Dokumentenvorschau. Der Vermieter kann die Auswahl im Rahmen der rechtlich/fachlich zulässigen Regeln korrigieren; keine separaten Portalfomulare. @@ -76,3 +76,29 @@ 4. **Noch offen:** Welche konkreten Dokumententypen und Anlagen sollen über Vermieter/Objekt/Portal hinweg wiederverwendbar sein, und welche müssen zwingend getrennt bleiben? **Status:** Portalübergreifende Fachregeln aus dem Interview festgehalten; Auswahlregeln sind ein fachlicher Vorschlag zur späteren Validierung, **keine freigegebene technische Implementierung**. + + +## 8. Erweiterung v0.2 – Flexible Portal- und Preisfunktionen + +**Konfiguration nach tatsächlicher Fähigkeit statt Portalname fest in Programmcode:** + +| Merkmal | Konfigurierbare Ausprägungen / Konsequenz | +|---|---| +| Eingang/Belegung | iCal/API/E-Mail/Portalansicht/manuell; zeitverzögert, nicht verfügbar oder unbekannt; manuelle Sperraufgabe zulässig | +| Gast-/Vertragsdaten | vollständig, teilweise, nicht geliefert; ggf. manuell über Gast oder Portal abrufen | +| Vertrag und Preisquelle | eigene verbindliche Angebotsdaten oder extern bestätigter Gastpreis; Gesamtbetrag auch ohne Einzelpreise zulässig | +| Preisdetailtiefe | Einzelpositionen, Sammelpositionen, reiner Gesamtpreis; Gebührentyp oder Empfänger kann ungeklärt bleiben | +| Preisaufschlag/Provision | Vermieterprovision, zusätzliche Gast-Servicegebühr, partnerkanalabhängiger Endpreisaufschlag – getrennt, sofern belegbar; auch kombinierte/unbekannte Position zulassen | +| Zahlungszuständigkeit | Eigener Einzug oder Portal/Paymentanbieter; Ratenstatus, Auszahlungsvorschau und Bankeingang getrennt | +| Stornobedingungen | Portalkonfiguration, beim Vertragsschluss nachweislich vereinbarter Stand, später übermitteltes eigenes Dokument trennen | +| Bearbeitungsmodus | automatisch / manuell / gemischt, nach einzelner Aktivität bzw. verfügbarem Feld; offene Klärungsaufgabe statt erfundene Daten | +| Nachweise | Zeitpunkt der Erfassung, ggf. Screenshot/Buchungsbestätigung, Zeitpunkt und Wirksamkeit einer Kalendersperre soweit nachgewiesen | + +**Keine freie Regel-Engine für MVP erforderlich.** Wenige Profilparameter sowie manuelle, nachvollziehbare Bearbeitungsschritte reichen zunächst. Die tatsächliche Informationstiefe kann **von Buchung zu Buchung** variieren, nicht nur pro Portal. + +### Konkrete Kanalprofile als gesonderte Referenzfälle + +- **FeWo-direkt (A4):** Eigene Miet-/Rabatt-/Stornokonfiguration im Portal; im Vermieterposteingang sind bei einer Buchung einzelne Summen, Zahlungsraten und erwartete Auszahlung ersichtlich, nicht notwendigerweise die Einzelpreiszerlegung. Eigener statischer Mietvertrag bislang nicht im Inserat hinterlegt. Angeblich/öffentlich angebotene Funktionen sind nicht automatisch im konkreten Betreiberkonto vorhanden. +- **Destination Solutions (A3):** Extern bereits verbindliche Buchung; danach vollständige Abwicklung beim Vermieter. **In aktuellem Betreiberzugang keine Kalendersynchronisation**; manuelle Portalsperrung mit begrenzter Nachweisbarkeit. Provision kann nach Vertriebskanal differieren; Gast-Serviceaufschlag, Preisaufschläge und vorvertragliche Anzeige der Stornobedingungen sind noch ungeklärt. + +Details: [K01 Preise & Abrechnung](K01_Preisstruktur_und_Abrechnung.md); [R08 Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md); [O00 offene Fragen](O00_Offene_Portalprueffaelle.md). --- basis/S00_Supportprozesse.md +++ v0.7/S00_Supportprozesse.md @@ -3,7 +3,7 @@ typ: prozesskatalog titel: Supportprozesse status: arbeitsstand -version: '0.6' +version: '0.7' --- # S00 – Supportprozesse (vorläufiger Katalog) @@ -25,3 +25,11 @@ **Einordnung für den heutigen Produktumfang:** S01–S07 und S09 soweit für Buchungsabwicklung nötig; S08 schlank in P04/P05. V02-Marketing und Loyalty sind **Wertschöpfung** und nicht bloß allgemeine administrative Supportprozesse. Marketingfunktionen werden fachlich vorgesehen, aber nach dem Kernbuchungsprozess detailliert. Einzelheiten folgen nach Freigabe der Gesamtprozesslandkarte. Keine zusätzlichen Organisations-/Oberflächenmodule aus dieser Tabelle ableiten. + + +## Präzisierung v0.7 (E-012 bis E-020) + +- **S01:** Portalprofil umfasst tatsächliche Datenschnittstelle (oder manuelle Schritte), Ausführungsverantwortung, Quellennachweis, Preis-/Storno-Verfügbarkeit und den Status nachgelagerter Vertriebskanäle, soweit relevant. Partnerherkunft ist **kein A6-Prozess**; nur kaufmännisches Merkmal bei Bedarf. +- **S02:** Kalenderverzögerung, manuelle Sperrung und fehlender Bestätigungsbeleg als reale Normalfälle. „Exportiert“ oder „im Portal eingetragen“ ist nicht gleich „partnernetzweit wirksam“. +- **S04/S07:** Kaufmännische **Einzel-, Sammel- und Gesamtbeträge** unterstützen; Gast-Servicegebühr, Vermieterprovision, Preisaufschlag, Rabatte, Zahlung und Auszahlung getrennt, soweit feststellbar. Unbekannte Zusammenhänge bleiben ungeklärt; manueller Abgleich möglich. +- **S05/S06:** unterschiedliche Vertragsvorlagen/Anlagen und Versionen je Buchungsprofil; manuelle Daten-/Dokumentenbeschaffung und Klärungsaufgaben ohne separate Portalsoftware-Workflows. --- basis/G00_Gates_und_Uebergaben.md +++ v0.7/G00_Gates_und_Uebergaben.md @@ -3,7 +3,7 @@ typ: gate-modell titel: Gate- und Übergabemodell status: arbeitsstand -version: '0.6' +version: '0.7' --- # G00 – Gate- und Übergabemodell (Arbeitsstand) @@ -41,3 +41,14 @@ ## Noch offen Detailkriterien für das P05-Abschlussgate und die Detailbedingungen der Storno-/Abbruch-Ausgänge; konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt. + + +## Ergänzende Gates / Informationsbewertung v0.7 (E-013 bis E-020) + +- **G1/P01 – Externe Belegung:** Zeitpunkt und Quelle von Kalenderexport, manueller Sperre oder Meldung dokumentieren. **Veranlasst**, **im Zielportal beobachtet** und **in nachgelagerten Kanälen nachgewiesen** sind verschiedene Zustände; letzterer kann unbekannt bleiben. +- **G2/P02 – Konditionsstand:** Extern verbindlicher **Gastgesamt-/Mietpreis** kann hinreichend belegt sein, auch wenn Tages-/Einzelpreise fehlen. Portalkonfiguration, Buchungssnapshot, gastseitig tatsächlich vereinbarter Konditionsstand und nachträglich versandte Unterlagen getrennt. Fehlt ein für Vertragsdokumentation erforderlicher Beleg, nur die konkrete Tätigkeit zur Klärung vorsehen; bereits bindende Buchung nicht rückwirkend entwerten. +- **G3/P03 – Kaufmännische Teilinformationen:** Einzelposition, Sammelposten und Gesamtbetrag zulässig; Quelle, Betrag, Währung, zugeordneter Zahler/Empfänger (oder **ungeklärt**), Status und mögliche Doppelzählung prüfen. Gast-Mietforderung ≠ Gast-Portalservicegebühr ≠ Vermieterprovision ≠ Auszahlung. Aufklärung je Tätigkeit; fehlende Provisionsdetails blockieren beispielsweise nicht automatisch die Anreisevorbereitung. +- **G3/P03 – Zahlung:** **Fällig laut Zahlungsplan**, **laut Portal bezahlt**, **Auszahlung angekündigt** und **tatsächlicher Bankeingang** sind unabhängige Status. Widersprüchliche Portalwerte bleiben offen, nicht automatisch überschrieben. +- **X02/X04/X07:** Storno-/Änderungsantrag ist **kein** wirksames Ergebnis. Bei Belegungskonflikt Ursache, zeitliche Abfolge, Bindung beider Buchungen, belegte extern wirksame Sperren und verbleibende Handlungsmöglichkeiten erfassen; Verantwortlichkeit wird nicht aus einem einzigen Button abgeleitet. + +**Evidenzstatus je Datenpunkt:** `übermittelt / durch externe Quelle behauptet / anhand Beleg geprüft / intern erfasst / manuell ergänzt / nicht geliefert / widersprüchlich / nicht anwendbar`; als **fachliche Beispiele**, nicht als freigegebene technische Enum. `unbekannt` ist **nicht** `0` oder `nicht vorhanden`. --- basis/E00_Entscheidungsprotokoll.md +++ v0.7/E00_Entscheidungsprotokoll.md @@ -3,7 +3,7 @@ typ: entscheidungsprotokoll titel: Entscheidungsprotokoll status: arbeitsstand -version: '0.6' +version: '0.7' --- # E00 – Entscheidungsprotokoll @@ -40,3 +40,25 @@ ## Dokumentationsregel (Arbeitsvereinbarung) Die bestehende Gitea-Dokumentation ist die führende Ablage. Es gibt **eine aktuelle Markdown-Datei je Thema**, P01–P05 dürfen jeweils mehrere Unterdokumente enthalten. Bei **neuen und fachlich aktualisierten Markdown-Dateien** einen knappen YAML-Header (`id`, `typ`, `titel`, `status`, `version`) verwenden. Bestehende Abschnitte bei Fortschreibungen nicht still kürzen oder löschen; fachliche Entscheidungen mit ID verknüpfen und Änderungen per Git-Diff kontrollieren. **Keine implizite Freigabe von Implementierung oder Go-live.** + + +## Ergänzende Beschlüsse und Prüfstände vom 31.10.2026 – Konsolidierung v0.7 + +Die folgenden IDs ergänzen **E-001–E-011**. Betreiberangaben und die daraus fachlich bestätigten Regeln sind von ausstehenden Portal- und Rechtsprüfungen zu unterscheiden. + +| ID | Status | Festlegung | +|---|---|---| +| **E-012** | **Beschlossen** | **Genau fünf Buchungsarchetypen A1–A5**. Der zuvor verwendete A6-Eintrag („Hub/Partnervermittlung“) entfällt als Archetyp. Partnerherkunft ist nur als optionales kaufmännisches Merkmal zu erfassen, soweit sie etwa Provisionssatz oder Auswertungen beeinflusst; keine eigenständige Vermittlungskettenlogik. | +| **E-013** | **Beschlossen** | **Vertrags-/Dokumentenprofil je Vermieter/Objekt/Portal/Buchungsart**, inklusive unterschiedlicher Vorlagen und Anlagen, Versionierung und unverändertem Buchungs-/Konditionsstand. Nach externer Direktbuchung **keine zweite Annahme und keine einseitigen neuen Gastpflichten**. Die tatsächliche vorvertragliche Einbeziehung bleibt Prüffall. | +| **E-014** | **Beschlossen** | Die Informationsbeschaffung kann je Portal und Feld **automatisch, manuell oder gemischt** erfolgen. Fehlen Einzelbeträge, dürfen Buchungen mit **Gesamtpreis oder Sammelpositionen** bearbeitet werden; fehlende Daten sind ausdrücklich unbekannt, nicht null und nicht geschätzt. | +| **E-015** | **Beschlossen** | **Gast-Mietforderung, ggf. gesonderte Gast-Servicegebühr, Vermieterprovision/-gebühr, Zahlungsraten, Auszahlung und Rabatte** sind fachlich getrennte Sachverhalte, auch wenn ein Portal Beträge zusammenfasst. Flexible kaufmännische Positionen, spätere manuelle Zuordnung/Aufteilung, Nachweis und Differenzabgleich sind erforderlich; ursprüngliche Portalwerte bleiben erhalten. **Keine doppelte Zählung** zusammengefasster Teil- und Gesamtbeträge. | +| **E-016** | **Beschlossen / Referenzbetrieb** | **Destination Solutions = A3**, keine Ergänzung „A6“: bereits extern verbindliche Buchung, nachfolgende Vertrags-/Zahlungs-/Aufenthaltsabwicklung durch Vermieter. Partnerherkunft kann unterschiedliche **Vermittlerprovisionen zu Lasten des Vermieters** bewirken, aber **keine nachträgliche Belastung des Gastes**. Ob das Portal selbst eine zusätzliche Gastgebühr erhebt oder den Endpreis erhöht, bleibt ungeklärt. | +| **E-017** | **Bestätigte Betreiberangabe, Wirksamkeit ungeklärt** | Bei Destination Solutions ist folgende **sechsstufige Stornostaffel** genannt: mindestens 60 Tage vorher 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, 11 Tage oder weniger 100 % jeweils vom „Mietpreis“. **Nicht nachgewiesen** ist, ob diese Staffel im Portal bereits vor Buchung transparent gemacht und wirksam einbezogen wird; die Preisbasis („Mietpreis“) ist zu klären. | +| **E-018** | **Beschlossen / Risiko festgehalten** | **Externe Verfügbarkeit ist nicht allein durch korrekte Pflege des FewoPortal-Kalenders sicher**: FeWo-direkt importiert iCal nur zeitverzögert; beim verwendeten Destination-Solutions-Zugang erfolgt **manuelle Sperrung ohne bestätigtes Partnernetz-Sync und ohne verwertbaren Sperrbeleg**. Vorgang „Sperre veranlasst / Zielportal erkennbar / partnernetzweit wirksam“ getrennt; letzteren Zustand niemals ohne Nachweis behaupten. | +| **E-019** | **Beschlossen** | Buchungsänderung, Storno und Doppelbuchung sind **Teil-/Sonderprozesse derselben Akte**. Auslösende Ursache, Initiator, ausführender Akteur, Zuständigkeit, verbindliche Wirksamkeit sowie Kalender-/Vertrags-/Finanzfolgen getrennt führen. Technische Stornierung durch den Gast ersetzt nicht die wahrheitsgemäße Einordnung einer Vermieterursache; Fremdportalregelungen und Rechtslage fallbezogen prüfen. | +| **E-020** | **Beobachteter A4-Iststand** | In einer FeWo-direkt-Buchung sind **aggregierter Übernachtungspreis, Rabatt, Sammelgebühren, Gastgesamtbetrag, portalbezogener Abzug, Auszahlungsvorschau und Ratenstatus** einsehbar. **Nicht belegt** sind Einzelpreise, Gebührenzusammensetzung, durchgängige Exporte und alle tatsächlich vom Gast akzeptierten Unterlagen. Widersprüchliche Auszahlungsangaben bleiben offener Prüffall. | +| **E-021** | **Verbindliche Dokumentationsarbeitsregel** | **Vor jeder künftigen Dokumentänderung/Erweiterung die aktuell gültigen Originaldateien erneut explizit beim Betreiber anfordern**. Gitea bleibt führende Ablage; ältere lokale Chat-/ZIP-Kopien allein reichen für spätere Änderungen nicht. Änderungen ausschließlich auf bestätigter Basis, mit Versionsfortschreibung, Bestandsbewahrung, Diff und Quellvermerk. | + +**Nicht beschlossen:** Dass technische Portalprobleme automatisch rechtlich fehlendes Verschulden beweisen; dass eine 10-Minuten-Freigabe heute bei den genannten Portalen möglich ist; dass alle Portale gleiche Preis-/Gast-/Zahlungsdaten bereitstellen; dass nachträglich versandte Stornobedingungen wirksam werden. Solche Aussagen bleiben Prüffälle. + +**Weitere Fachkonzepte:** [Archetypen A1–A5](00_Buchungsarchetypen.md), [Portal-/Vertragsprofile](00_Portalprofile_und_Vertragsvorlagen.md), [Flexible kaufmännische Positionen](K01_Preisstruktur_und_Abrechnung.md), [Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md), [offene Portalprüffälle](O00_Offene_Portalprueffaelle.md). --- basis/00_Buchungsarchetypen.md +++ v0.7/00_Buchungsarchetypen.md @@ -3,15 +3,15 @@ typ: archetypenkatalog titel: FewoPortal – Buchungsarchetypen und Verantwortungsübergaben status: diskussionsentwurf -version: "0.5" +version: "0.6" stand: 2026-10-31 prozess: V01 -bezugsstand_prozessarchitektur: "0.6" +bezugsstand_prozessarchitektur: "0.7" --- # A00 – Buchungsarchetypen und Verantwortungsübergaben -> **Arbeitsstand für das Fachinterview, nicht abschließend freigegeben.** Grundlage: Betreiberbeschreibung vom 31.10.2026; Übergaben `UEBERGABE-BUCHUNGSPROZESS.md` (30.10.2026) und `crystalline-floating-glacier.md` (31.10.2026); Prozessarchitektur v0.6 und Szenario R01. **Bestätigte Geschäftsregeln, aktueller Praxisablauf, Annahmen und offene Fragen werden getrennt ausgewiesen.** +> **Arbeitsstand für das Fachinterview, nicht abschließend freigegeben.** Grundlage: Betreiberbeschreibung vom 31.10.2026; Übergaben `UEBERGABE-BUCHUNGSPROZESS.md` (30.10.2026) und `crystalline-floating-glacier.md` (31.10.2026); Prozessarchitektur v0.7 und Szenarien R01/R08. **Bestätigte Geschäftsregeln, aktueller Praxisablauf, Annahmen und offene Fragen werden getrennt ausgewiesen.** ## 1. Gemeinsamer Grundsatz @@ -25,7 +25,7 @@ **Archetypen sind Geschäftskonstellationen, keine getrennt zu implementierenden Workflows.** Sie bestimmen die bei Eintritt bekannten Tatsachen, Zuständigkeiten, notwendigen Aktivitäten, Kommunikationswege und Nachweise. Dieselbe Buchungsakte und dieselben Fachfunktionen werden verwendet. Ein Portal kann einzelne Tätigkeiten durchführen; FewoPortal behält den konsolidierten Vorgangsüberblick, ohne fremde Primärnachweise vorzutäuschen. -## 2. Katalog der sechs Archetypen +## 2. Katalog der fünf Archetypen | ID | Geschäftskonstellation | Zustand beim Eingang | Vertragsunterlagen | Zahlung / Storno | Informationsbedarf | |---|---|---|---|---|---| @@ -34,9 +34,8 @@ | **A3** | Externe Direktbuchung mit anschließender vollständiger Abwicklung durch uns | Bereits verbindliche Portalbuchung | Wir versenden Dokumentation der bestehenden Vereinbarung, **keine zweite Annahme** | Wir | Buchung, Portalpreis und Gastdaten übernehmen / ergänzen | | **A4** | Externe Direktbuchung mit **geteilter Abwicklung** (heutiger FeWo-direkt-Fall) | Bereits verbindliche Portalbuchung | Vertragsdokumentation durch uns ohne zweite Annahme | Zahlung über Portal; tatsächliche Storno-/Mahnverantwortung noch prüfen | Gastdaten, rechtsrelevante Konditionen, Portalstatus, lokale Abgaben | | **A5** | Externe Direktbuchung mit weitgehend vollständiger Portalabwicklung | Bereits verbindliche Portalbuchung | Durch Portal, soweit tatsächlich vereinbart | Durch Portal, soweit tatsächlich vereinbart | Für Vor-Ort-Betreuung und rechtliche Pflichten benötigte Daten und Status | -| **A6** | Portal / Buchungshub vermittelt über weitere Partnerportale | Abhängig vom zugrunde liegenden A2–A5 | Abhängig von Herkunft und Abwicklungsmodell | Abhängig von Herkunft und Abwicklungsmodell | **Eingangskanal**, **tatsächliche Herkunft** und **Abwicklungsverantwortung** getrennt erfassen | -**Modellierungshinweis:** A6 ist ein **zusätzliches Herkunfts- und Vermittlungsmerkmal**, kein eigener alternativer Lebenszyklus. „Manuell/telefonisch“ ist ein **Eingangskanal** und kann insbesondere bei A1/A2 verwendet werden. Eine reine Eigenbelegung/Sperrzeit ist ein angrenzender Belegungsfall, **kein siebter Buchungsarchetyp**. +**Modellierungshinweis (E-012):** Die ehemalige Kennung **A6 wurde ausdrücklich gestrichen**; Partnervertrieb ist allenfalls ein optionales kaufmännisches Herkunftsmerkmal. „Manuell/telefonisch“ ist ein **Eingangskanal** und kann insbesondere bei A1/A2 verwendet werden. Eine reine Eigenbelegung/Sperrzeit ist ein angrenzender Belegungsfall, **kein weiterer Buchungsarchetyp**. ## 3. Gegenüberstellung entlang des generischen Prozesses @@ -48,7 +47,7 @@ | **P04 Leistung** | Anreise, lokale Pflichten, Aufenthalt, Abreise | Wie A1 | Wie A1 | Wie A1, zuvor Gastinformationen nachfordern | Wie A1, soweit wir vor Ort verantwortlich sind | | **P05 Abschluss** | Aufenthalt, Feedback, offene Fälle übergeben | Wie A1 | Wie A1 | Wie A1, ggf. offener Portal-Auszahlungs-/Stornofall | Lokale Erfüllung abschließen, relevante Portal-Ergebnisse erfassen | -**A6** wird auf die zutreffende Spalte gelegt; die Herkunft kann Konditionen, Pflichten und Kommunikationswege beeinflussen. Phasen können sich zeitlich überlappen; eine bereits extern verbindliche Buchung darf nicht durch offene Stammdaten künstlich unverbindlich werden. +Die Partnerherkunft begründet **keinen sechsten Archetyp**; sie wird nur bei relevantem Einfluss auf die Vermittlerprovision oder notwendige Auswertung erfasst. Phasen können sich zeitlich überlappen; eine bereits extern verbindliche Buchung darf nicht durch offene Stammdaten künstlich unverbindlich werden. ## 4. Gemeinsame Informations- und Übergabegates @@ -121,7 +120,7 @@ Die vom Betreiber bereitgestellte vierseitige FeWo-direkt-Vertragsvorlage wurde unter [A04 – Vertragsvorlage und Prozessanalyse](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md) gesondert bewertet. Besonders prüfbedürftig sind: Verbindlichkeit vor dem nachträglichen Vertragsversand (§ 5), zuvor einbezogene Konditionen, Preis-/Gebührentrennung (§ 4), Portalstorno gegenüber eigener Stornoklausel (§ 13), Datenbedarf sowie sichere Trennung von Vertragsdokument und Zugangs-/Anreiseinformationen. **Keine Änderung der Betreibervertragsklauseln ohne gesonderte rechtliche und fachliche Freigabe.** -**Status dieses Dokuments:** Sechs Betreiber-Archetypen strukturiert, aber nicht als vollständige oder rechtlich validierte Portalprofile freigegeben. Nächster Fachschritt: **A4 als vollständigen Ist-/Soll-Ablauf durchspielen**, einschließlich Vertrag, Zahlung, Gastdaten und Storno; anschließend A3 und A5 dagegenlegen. +**Status dieses Dokuments:** Fünf Archetypen (A1–A5) nach E-012; Portalprofile und rechtliche Detailfragen bleiben offen. Neben FeWo-direkt (A4) ist Destination Solutions (A3) dokumentierter Praxisfall. ## 10. A4-Praxisnachweis aus FeWo-direkt-Ansichten (31.10.2026) @@ -130,6 +129,20 @@ **Portalinvariante:** Verantwortlichkeit für Zahlung oder Kommunikation, Portalstatus und tatsächlicher Erfüllungsnachweis sind getrennt zu verwalten. -## 9. Änderungs- und Stornoereignisse (portalunabhängig) +## 11. Änderungs- und Stornoereignisse (portalunabhängig) Ein Storno bzw. eine Buchungsänderung ist ein **Teilprozess auf derselben Buchungsakte**, kein zusätzlicher Archetyp. Die fachliche Ursache (Gastwunsch, Unmöglichkeit beim Vermieter, Doppelbuchung, Regelverstoß, technischer Fehler), der Initiator, der ausführende Beteiligte und die Abwicklungsverantwortung sind voneinander zu unterscheiden. Anfrage, Bestätigung und tatsächliche Wirksamkeit sind getrennte Ereigniszustände. Kalender, Konditionen, Vertrag und Zahlungen werden erst nach ausreichend belegter Wirksamkeit angepasst. Eine durch den Vermieter verursachte Stornierung darf nicht durch Aufforderung an den Gast als Gaststorno umetikettiert werden. **FeWo-direkt** ist dafür ein dokumentiertes Portalbeispiel (siehe [A04 Abschnitt 8](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md)); andere Portale können abweichende Wege, Daten und Zuständigkeiten haben. + + +## 12. Destination Solutions als Praxisreferenz A3 (E-012/E-016/E-017/E-018) + +- **Verbindlicher Buchungseingang**, vollständige weitere Vertrags-, Gäste-, Zahlungs- und Aufenthaltsabwicklung beim Vermieter; keine zweite Angebotsannahme. Der Vermieter erhält laut Betreiber eine vollständige Buchungsmeldung für seine Abwicklung, **nicht zwingend eine vollständige Einzelpreis- oder Gebührenzerlegung**. +- **Keine im genutzten Zugang funktionierende automatische Kalendersynchronisation**; manuelles Blockieren anderer Portale. Ein Portalbeleg über den Zeitpunkt oder die wirksame Verteilung an Partnerkanäle steht nach Betreibererfahrung nicht zur Verfügung. +- **Vermittlerprovisionen** können nach Vertriebskanal variieren. Sie sind nicht nachträglich vom Gast zu fordern. Ob zusätzlich ein direkter Gast-Aufschlag/Serviceentgelt oder Partner-Endpreisaufschlag existiert, muss beim Anbieter und anhand einer Gastbestätigung geprüft werden. +- **Stornostaffel** vom Betreiber angegeben: ≥60 Tage 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, ≤11 Tage 100 % vom „Mietpreis“; **vorvertragliche Einbeziehung, Berechnungsbasis und rechtliche Wirksamkeit offen**. + +Siehe [R08 Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md) und [O00 Offene Portalprüffälle](O00_Offene_Portalprueffaelle.md). + +## 13. Portaldaten können unterschiedlich detailliert und zusammengesetzt sein (E-014/E-015) + +Bei A2–A5 sind **automatische, manuelle und hybride** Informationen und Tätigkeiten gleichwertig zu modellieren. Pro Buchung sind vollständig aufgeschlüsselte Positionen, **kombinierte Service-/Gebührenpositionen**, bloße Gesamtbeträge sowie nur teilweise verfügbare Zahlungsauszüge möglich. Keine fiktive Zerlegung des Gesamtpreises; unbekannte Gebührenarten, Zahlende/Empfänger und Provisionsanteile bleiben offen. Nachträgliche Zuordnung oder Aufteilung erhält den originalen Portalbetrag und verhindert doppelte Summierung. Fehlende rein interne Kostenanalyse blockiert nicht ohne Weiteres den vertraglichen Aufenthalt. Siehe [K01](K01_Preisstruktur_und_Abrechnung.md). --- basis/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md +++ v0.7/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md @@ -3,7 +3,7 @@ typ: prozessanalyse titel: FeWo-direkt – Vertragsvorlage und Einordnung in den A4-Istprozess status: diskussionsentwurf -version: "0.4" +version: "0.5" stand: 2026-10-31 prozess: V01 archetyp: A4 @@ -157,3 +157,14 @@ - https://hilfe.fewo-direkt.de/articles/Accept-or-decline-a-guest-s-change-request - https://hilfe.fewo-direkt.de/articles/Die-Reservierung-eines-Gastes-stornieren - https://www.fewo-direkt.de/tlp/trust-and-safety/partner-initiated-cancellation-policy + + +## 9. Einordnung nach Gesamt-Konsolidierung v0.7 + +1. **A4 bleibt realer Praxisfall**, nicht Muster für alle Portale. FeWo-direkt zeigt in einer Buchung im Posteingang Zahlungsplan, einige aggregierte Preisbestandteile, Gäste-Gesamtzahlung, Abzug und erwartete Auszahlung; eine lückenlose Einzelpreis-/Gebührentransparenz und eine konsistente Auszahlungsübersicht sind weiter **nicht nachgewiesen**. Das frühere pauschale Urteil „keinerlei Zahlungsdaten“ ist überholt; konkrete Screenshots in Abschnitt 7 sind maßgeblich. +2. **Ical-Verzögerung:** Direkte Buchung kann vor Verarbeitung einer anderswo veranlassten Blockierung verbindlich werden. FewoPortal darf eigene erfolgreiche Exporte nicht als Portal- oder Partnernetzbestätigung behandeln. Die Idee eines 10-Minuten-Freigabefensters ist **kein aktuell verfügbarer A4-Prozess**. +3. **Vertragsdokumente:** Der eigene vierseitige Vertrag wird bisher nach der Portalbuchung versandt und ist nicht als statisches PDF in FeWo-direkt hinterlegt; Inhalt der dem Gast vor/bei Buchung gezeigten Bedingungen bleibt zu verifizieren. Statische allgemeine Bedingungen von individuellen Preis-/Zahlungsdetails trennen; keine still nachgeschobenen Verpflichtungen. +4. **Sonderprozesse:** Bisher keine konkret selbst durchlaufene FeWo-direkt-Buchungsänderung und keine eigene Vermieterstornierung. Kein nicht erprobtes Verfahren als gelebte Praxis behaupten. Differenzierung **tatsächliche Stornoursache, Antragsteller, ausführender Beteiligter** beachten. +5. **Abrechnung:** Unbekannte Gast-Servicegebühren, Portalabzüge, Vermieterprovisionen oder kombinierte Sammelpositionen müssen nicht künstlich zerlegt werden. Portalinformationen und manuelle Ergänzungen mit Quelle sichern; bei abweichenden Summen Klärungsaufgabe. + +Fachliche Konkretisierung: [K01](K01_Preisstruktur_und_Abrechnung.md), [X01](X01_Belegungskonflikte_und_Sperrnachweise.md) und [O00](O00_Offene_Portalprueffaelle.md). Keine Aktualisierung oder juristische Freigabe des ursprünglichen PDF-Vertrags durch diese Analyse. --- basis/README.md +++ v0.7/README.md @@ -3,15 +3,15 @@ typ: projektindex titel: FewoPortal Prozessarchitektur status: arbeitsstand -version: '0.6' +version: '0.7' --- -# FewoPortal – Prozessarchitektur v0.6 +# FewoPortal – Prozessarchitektur v0.7 **Status:** Fachlicher Arbeitsstand / Interview, keine Implementierungsfreigabe **Stand:** 31.10.2026 -Diese Version führt den konsolidierten Stand v0.5 mit **E-011 (alternative fachliche Prozessausgänge)** fort und bewahrt die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die Entscheidungen E-001 bis E-010 sowie die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.** +Diese Konsolidierung führt die Version v0.6 mit **E-011 (alternative fachliche Prozessausgänge)** fort und bewahrt die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die Entscheidungen E-001 bis E-010 sowie die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.** ## Dateien @@ -24,3 +24,25 @@ **Quellen:** `crystalline-floating-glacier.md`, `UEBERGABE-BUCHUNGSPROZESS.md`, Gesamtprozess v0.3 und die Betreiberpräzisierung vom 31.10.2026. Weitere Fach- und Rechtsprüfung erforderlich. **Arbeitsregel:** Nur ausdrücklich beschlossene Punkte als Entscheidung kennzeichnen; Vorschläge als solche markieren. Jede Datei trägt einen YAML-Header mit `id`, `typ`, `titel`, `status`, `version`. Die Version v0.5 bezeichnet den konsolidierten **Dokumentationsstand**, nicht eine Implementierungsversion. Bestehende Inhalte werden nicht stillschweigend gekürzt. Änderungen an Gitea erfolgen erst nach Abgleich mit dem dortigen Stand. Keine automatischen Änderungen am produktiven System. + + +## Konsolidierung v0.7 (31.10.2026) + +**Wichtige Entscheidung E-012:** Fünf Buchungsarchetypen **A1–A5**, **A6 gestrichen**. Referenzportale: Destination Solutions = **A3**, FeWo-direkt = **A4**. Ein generischer V01-Buchungsprozess mit variabler Aktivitäts- und Informationslage; keine separaten Portalworkflows. + +**Neue Anforderungen:** Portal-/Dokumentenprofile, versionierter Vertrags-/Konditionsnachweis, manuelle/automatische/gemischte Datenbeschaffung, flexible Einzel- und Sammelpreise, unbekannte Gastgebühr/Provision ohne Scheingenauigkeit, Abstimmung Zahlungsplan vs. tatsächliche Auszahlung, unsichere Kalender-/Sperrnachweise und Änderungs-/Stornoteilprozesse. Externe Direktbuchungen werden nicht durch neues Eigenangebot ersetzt. Rechtlich ungeklärte Portal- und Stornokonditionen bleiben offene Prüffälle. + +**Neue bzw. fortgeschriebene Dateien:** + +- [`00_Buchungsarchetypen.md`](00_Buchungsarchetypen.md) – A1–A5 und reale Referenzfälle +- [`00_Portalprofile_und_Vertragsvorlagen.md`](00_Portalprofile_und_Vertragsvorlagen.md) – Profile und Vertragstypen +- [`K01_Preisstruktur_und_Abrechnung.md`](K01_Preisstruktur_und_Abrechnung.md) – Einzel-/Sammel-/Gesamtbeträge, Provisionen, Zahlungsfluss +- [`A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md`](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md) – konkrete A4-Beobachtungen und rechtliche Prüffragen +- [`R00_Szenarien/R01_Eigene_Webseite.md`](R00_Szenarien/R01_Eigene_Webseite.md) – früherer Referenzentwurf, **inhaltlich unverändert** +- [`R00_Szenarien/R08_Destination_Solutions.md`](R00_Szenarien/R08_Destination_Solutions.md) – A3 Referenzfall +- [`X01_Belegungskonflikte_und_Sperrnachweise.md`](X01_Belegungskonflikte_und_Sperrnachweise.md) – X07-Vertiefung +- [`O00_Offene_Portalprueffaelle.md`](O00_Offene_Portalprueffaelle.md) – spätere Konfigurations- und Nachweispunkte +- [`D00_Dokumentationsregel_und_Uebergabe.md`](D00_Dokumentationsregel_und_Uebergabe.md) – **Pflicht zur erneuten Dokumentenanforderung vor jedem zukünftigen Edit** +- [`E00_Entscheidungsprotokoll.md`](E00_Entscheidungsprotokoll.md) – Beschlüsse E-012–E-021 + +**Quellenintegrität:** v0.6 aus dem originalen ZIP extrahiert, da die entpackte v0.6-Verzeichnisansicht P01–P05 nicht enthielt; ergänzende Dokumente aus ihrem jeweils neuesten im Chat verfügbaren Bearbeitungsstand. **Kein direkter Schreibzugriff auf Gitea; keine Repository-Aktualisierung behauptet.** Vor jeder künftigen Änderung aktuelle Quelldokumente erneut vom Betreiber anfordern. --- basis/00_Prozesslandkarte.md +++ v0.7/00_Prozesslandkarte.md @@ -3,10 +3,10 @@ typ: prozesslandkarte titel: FewoPortal – Prozesslandkarte status: arbeitsstand -version: '0.6' +version: '0.7' --- -# 00 – Prozesslandkarte FewoPortal v0.6 +# 00 – Prozesslandkarte FewoPortal v0.7 **Status:** gemeinsamer Arbeitsstand; übergreifendes Modell, nicht vollständig freigegeben. **Stand:** 31.10.2026 @@ -111,3 +111,18 @@ 5. Pro Kanal tatsächlicher Verbindlichkeitsnachweis, Datenlage und Portalbestimmungen. Die detaillierte Umsetzung erfolgt erst nach Abstimmung der Prozesslandkarte. + + +## H. Konkretisierung v0.7: Portalneutralität, Informationslücken und Verantwortlichkeit + +**A1–A5 (E-012):** Nur die tatsächliche Buchungs- und Abwicklungsverantwortung klassifiziert den Archetyp. Der bisherige A6-Eintrag entfällt; Herkunft/Partnervertrieb ist bei Bedarf eine separate **kaufmännische Metainformation**, keine eigene Prozessvariante. Referenzfälle: **FeWo-direkt A4**, **Destination Solutions A3**. Der identische V01-Prozess durchläuft dieselben fachlichen Phasen/Gates, Aktivitäten können je Profil extern/intern oder manuell/automatisch erfolgen. + +**Fünf unabhängige Dimensionen je Buchung:** (1) rechtlicher Bindungs-/Konditionsnachweis, (2) operative Zuständigkeit, (3) technische Datenquelle/Übermittlungsweg und Verfügbarkeit, (4) preisliche Detailtiefe bzw. Zuordnungsgrad, (5) tatsächliche Nachweisqualität. Aus „Portal zuständig“ folgt weder „erledigt“ noch „nachgewiesen“. + +**Kaufmännischer Grundsatz (E-014/E-015):** Das Portal kann Einzelposten, Teilaggregationen, Gesamtpreise, unbekannte Gebührenmischungen oder widersprüchliche Auszahlungsansichten liefern. FewoPortal darf den verbindlichen Gastpreis bei externer Buchung nicht durch Eigenkalkulation ersetzen, keine unbekannten Einzelposten erfinden und keine Vermittlerprovision ohne Vereinbarung dem Gast nachberechnen. Eine manuelle Klärung kann ergänzen; ursprüngliche Rohdaten bleiben erhalten. + +**Verfügbarkeit (E-018):** Keine generelle Aussage, dass alle Vertriebskanäle synchron oder endgültig gesperrt sind. Manuell oder zeitversetzt übertragenes Blockieren ist kein Nachweis partnernetzweiter Wirksamkeit. Sofort bestätigte externe Doppelbuchungen bleiben wirksame **Konfliktfälle**, nicht automatisch ablehnbare Anfragen. Eine vorgeschlagene Livefreigabe/10-Minuten-Karenz ist derzeit nur **optionales Zukunfts-/Integrationskonzept**, kein Ist-Ablauf. + +**Nachträgliche Ereignisse (E-019):** Änderungsanfrage, bestätigte Änderung, Stornierungswunsch und wirksame Stornierung unterscheiden. Ursache, Durchführender, vertragliche Folgen, Belegung und Geldflüsse getrennt dokumentieren. + +**Zu vertiefen:** [K01 Preis- und Abrechnungsmodell](K01_Preisstruktur_und_Abrechnung.md), [X01 Belegungskonflikt- und Sperrnachweise](X01_Belegungskonflikte_und_Sperrnachweise.md), [O00 offene Portalfragen](O00_Offene_Portalprueffaelle.md). --- basis/P05/P05_Abschluss_und_Nachbereitung.md +++ v0.7/P05/P05_Abschluss_und_Nachbereitung.md @@ -3,7 +3,7 @@ typ: prozessphase titel: Abschluss und Nachbereitung status: entwurf -version: '0.6' +version: '0.7' --- # P05 – Abschluss und Nachbereitung @@ -28,3 +28,8 @@ ## Noch offen Genaue Abschlusskriterien und erforderliche Nachweise; Zuständigkeit und Verknüpfung nachlaufender Folgeprozesse; Objektbereitstellung und Abgrenzung zum Folgeaufenthalt; alternativer Ausgang bei Stornierung oder abgebrochenem Vorgang. **Ob die technische Buchungsakte geschlossen wird oder nur der V01-Prozessstatus wechselt, ist nicht entschieden.** + + +## Ergänzung v0.7: Abrechnung und Nachweislücken + +Eine Buchung darf nach erbrachter Leistung fachlich regulär enden, selbst wenn **Provisionsaufschlüsselung, ausstehende Auszahlung oder ungeklärte Sammelgebühren** in einem gesondert zugewiesenen Folgefall weiterbearbeitet werden. Gastbezogene offene Forderungen, Storno- oder Auszahlungsdifferenzen müssen mit Quelle, Verantwortlichem und Buchungsreferenz nachvollziehbar übergeben werden. Fehlende detaillierte Preisaufteilung ist nicht automatisch eine unvollständige Gastleistung. --- basis/P03/P03_Buchungsverwaltung_und_Abwicklung.md +++ v0.7/P03/P03_Buchungsverwaltung_und_Abwicklung.md @@ -3,7 +3,7 @@ typ: prozessphase titel: Buchungsverwaltung und kaufmännische Abwicklung status: entwurf -version: '0.6' +version: '0.7' --- # P03 – Buchungsverwaltung und kaufmännische Abwicklung @@ -26,3 +26,16 @@ ## Noch offen Mindestdaten je Portalprofil, eigene versus externe Zahlungsstände, Reconciliation, Übergänge zum Abschluss. + + +## Flexible Preis- und Zahlungsbearbeitung v0.7 + +1. Übernommene Positionen **unverändert mit Quelle** speichern: Einzelpositionen, Misch-/Sammelbeträge oder nur verbindlichen Gesamtbetrag. Fehlende Details nicht als 0 interpretieren. +2. **Preis-/Kostenbeziehungen** unterscheiden: Gast ↔ Vermieter (Mietforderung und enthaltene Leistungen); Gast ↔ Portal (mögliche eigene Servicegebühr); Vermieter ↔ Portal (Provision/Servicekosten); Zahlungen, Rückerstattungen und spätere Auszahlungen jeweils separat. +3. **Manuelle Ergänzung und Aufteilung** ermöglichen (auch ohne Portal-API): originalen Sammelbetrag erhalten, abgeleitete Teilpositionen zuordnen, Summen abstimmen, doppelte Zählung verhindern. Nicht bekannte Debitoren/Kreditoren, Rabattbezüge und Gebührenarten als **ungeklärt** führen. +4. **Zahlungsstände** trennen: Gast-Fälligkeit, portalbestätigte Gastzahlung, Auszahlungsvorschau, tatsächlicher Geldeingang, Abweichung/Erstattung. Widersprüche als Klärung auf derselben Buchungsakte, nicht heimlich mit Eigenkalkulation ausgleichen. +5. **Pflicht nur je Tätigkeit:** Fehlt für eine von uns zu stellende Rechnung die rechtlich nötige Aufschlüsselung, Klärungsaktivität einplanen. Fehlende reine Vermieter-Kostenanalytik darf Anreise oder andere unabhängige Schritte nicht grundsätzlich sperren. +6. **Destination Solutions A3:** Vermieter führt Vertrag, Zahlungsanforderung, Zahlungskontrolle und ggf. Stornobearbeitung; Höhe der Vermittlerprovision je Herkunft unterschiedlich möglich. Keine zusätzliche Provisionsrechnung an den Gast ohne vorbestehende Vereinbarung. +7. **FeWo-direkt A4:** Sichtbarer Gastzahlungsplan und erwartete Auszahlung ersetzen weder den Beleg über Bankeingang noch vollständige Gebührenaufschlüsselung; siehe konkrete A4-Screenshots und offenen 5,51-€-Differenzfall. + +[Vertiefung: K01](../K01_Preisstruktur_und_Abrechnung.md). --- basis/P01/P01_Buchungseingang_und_Verfuegbarkeit.md +++ v0.7/P01/P01_Buchungseingang_und_Verfuegbarkeit.md @@ -3,7 +3,7 @@ typ: prozessphase titel: Buchungseingang und Verfügbarkeitssicherung status: entwurf -version: '0.6' +version: '0.7' --- # P01 – Buchungseingang und Verfügbarkeitssicherung @@ -29,3 +29,13 @@ ## Noch offen Mindestfelder nach Eingangstyp, Übergaberegeln für unklare iCal-Ereignisse, Konfliktverhalten, genaue Hold- und Kalenderregeln. + + +## Praxisfälle und Aktivitätsvarianten v0.7 + +- **FeWo-direkt (A4):** Sofortbuchung kann während verzögertem iCal-Abgleich entstehen. Portal-Verfügbarkeitsstatus darf nicht als Echtzeitgarantie dargestellt werden; eigenes Sync-Ereignis, Zeitpunkt des Abrufs und bekannte Konflikte festhalten. +- **Destination Solutions (A3):** Im konkret genutzten Zugang **keine aktive Kalender-Synchronisation** laut Betreiber; externe neue Buchung kommt bereits verbindlich an. Andere Vertriebskanäle müssen im Portal **manuell blockiert** werden; nachgelagerter Partnervertrieb kann weitere Verzögerungen verursachen. Eigene protokollierte Aufgabe mit Zeitpunkt, Bearbeiter, Portalanzeige/Screenshot (wenn möglich) – keine Behauptung, der Portalserver habe eine rechtzeitige Übernahme quittiert. +- **Portalunabhängig:** Art des Belegungs-Inputs (iCal, API, E-Mail, manuell), Ausführungspfad (automatisch/manuell/hybrid), Verzögerung/Unsicherheit und Kontrollmöglichkeiten im Portalprofil hinterlegen. Neue, extern **bereits verbindliche** Kollisionsbuchung als Konflikt behandeln; keine stillschweigende Ablehnung oder Löschung. +- **Drei Sperrzustände:** `Sperrung veranlasst`, `im Zielportal sichtbar`, `nachweislich im relevanten Vertrieb wirksam`. Fehlender Nachweis bleibt **unbekannt**. Für eigene Holds eigene atomare Freihaltung und Sicherung des bindenden Angebots prüfen, ohne fremde Echtzeitwirkung zu versprechen. + +Siehe [X01 – Konfliktmanagement und Nachweise](../X01_Belegungskonflikte_und_Sperrnachweise.md). --- basis/R00_Szenarien/00_Szenariomatrix.md +++ v0.7/R00_Szenarien/00_Szenariomatrix.md @@ -4,7 +4,7 @@ titel: Buchungsszenarien und Vergleichsfälle autor: FewoPortal Fachinterview status: diskussionsentwurf -version: '0.1' +version: '0.2' --- # R00 – Buchungsszenarien und Vergleichsfälle @@ -18,7 +18,12 @@ | R03 | Unverbindliche Portalanfrage | Portal-Anfrage → eigenes Angebot → Annahme | Fehlende Gastdaten, Portal-Kommunikation | Vorgemerkt | | R04 | Verbindliche Portalbuchung, Vertrag durch uns | Bereits extern verbindlich | Externer bindender Preis, nachträgliche Vertragsdokumentation ohne erneute Annahme, Zahlung je Portal | Vorgemerkt | | R05 | Portal wickelt verbindliche Buchung vollständig ab | Bereits extern verbindlich | Lokale Leistung und notwendige Informationen, Portal für Vertrag/Zahlung/Mahnung/Storno zuständig | Vorgemerkt | -| R06 | Hub/Partnerportal | Je Herkunft Anfragen oder Direktbuchungen | Herkunftserkennung bestimmt Profil | Vorgemerkt | +| R06 | (Historisch) Hub-/Partnervermittlung | Kein eigener Buchungsprozess; A1–A5 richten sich nach Bindung/Abwicklungszuständigkeit | Herkunft allenfalls für Provision/Auswertung relevant | Als separates Szenario nicht weiterführen (E-012) | | R07 | Eigenbelegung/Sperre | Keine Gastbuchung | Belegungsmanagement ohne Gästeakte | Angrenzender Fall, kein vollständiger V01-Buchungsweg | **Quellen:** Ausgangsdokumente vom 30./31.10.2026 und Entscheidungsstand der Prozessarchitektur v0.6. Die Bearbeitungsstände beziehen sich auf das Fachinterview, nicht auf die Implementierung. + + +## Ergänzung v0.2: Externe Direktbuchung + +**R08 – Destination Solutions (A3):** Bereits verbindliche Buchung, danach Vertrags-/Zahlungs-/Gastabwicklung durch Vermieter; manuelle Sperre externer Kalender, kein belegter Partner-Sync; unterschiedliche Vermittlerprovisionen je Kanal, zusätzliche Gastgebühren und einzelne Preispositionen derzeit unklar. **A6 entfällt** als Archetyp. [R08 Referenzfall](R08_Destination_Solutions.md). --- basis/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md +++ v0.7/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md @@ -3,7 +3,7 @@ typ: prozessphase titel: Leistungsvorbereitung und Aufenthalt status: entwurf -version: '0.6' +version: '0.7' --- # P04 – Leistungsvorbereitung und Aufenthalt @@ -25,3 +25,8 @@ ## Noch offen Ob die Organisation des Objektbetriebs vollständig als Supportprozess geführt wird; örtliche Anforderungen; Übergabe- und Eskalationsstandards. + + +## Ergänzung v0.7: externe Kommunikationszuständigkeit + +Bei Portal-Direktbuchungen unterscheiden: Portal kündigt Gastnachricht an, Portalversand ist tatsächlich bestätigt oder Vermieter versendet eigene Informationen. FeWo-direkt kündigt in der gezeigten Buchung eine E-Mail etwa 72 Stunden vor Anreise an; dies ist **noch kein Nachweis**, dass sie dem Gast zugegangen ist. Falls erforderliche Gäste-/Meldedaten fehlen, manuell nachfordern. Bei Destination Solutions führt Vermieter die Gast- und Dienstleisterkommunikation im Rahmen der eigenen Abwicklung. --- basis/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md +++ v0.7/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md @@ -3,7 +3,7 @@ typ: prozessphase titel: Konditionen und Buchungsverbindlichkeit status: entwurf -version: '0.6' +version: '0.7' --- # P02 – Konditionen und Buchungsverbindlichkeit @@ -49,3 +49,13 @@ - [§ 148 BGB – Bestimmung einer Annahmefrist](https://www.gesetze-im-internet.de/bgb/__148.html) - [§ 150 BGB – verspätete und abändernde Annahme](https://www.gesetze-im-internet.de/bgb/__150.html) - [§ 312j BGB – Besonderheiten im elektronischen Geschäftsverkehr](https://www.gesetze-im-internet.de/bgb/__312j.html) + + +## Konditions- und Vertragsprofile v0.7 + +- **Kanalabhängige Vorlagen:** Für A1/A2 bindendes Angebot einschließlich wirksam zur Kenntnis gegebener Bedingungen; für A3/A4 Dokumentation bereits extern abgeschlossener Buchung; für A5 nur die zur eigenen Tätigkeit nötigen Unterlagen. Vorlagen/Anlagen je Vermieter, Objekt, Portal und Buchungstyp unterscheiden, Version + verwendeten Konditionsstand aufbewahren. +- **Extern verbindliche Preisgrundlage:** Der bestätigte Gastpreis kann lediglich **als Gesamtbetrag** vorliegen. Dies ist kein Grund, Tagespreise oder einzelne Gebühren zu erfinden. Vom Portal selbst erhobene Gast-Servicegebühren und Vermieterprovisionen können davon abweichen und separat oder nur aggregiert bekannt sein. +- **Vorvertragliche Einbeziehung:** Ob dem Gast vor Abschluss Stornostaffeln, Pflichtgebühren und sonstige Bedingungen angezeigt wurden, ist je Portal zu prüfen; ein nachträgliches Dokument erzeugt nicht automatisch neue Vertragspflichten. +- **Destination Solutions:** Genannte Stornostaffel (vom Betreiber berichtet): mindestens 60 Tage vorher 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, 11 Tage oder weniger 100 % des „Mietpreises“. **Ungeklärt:** Nachweis im Buchungsprozess, Durchsetzbarkeit, genaue Kostenbasis. Nicht als globalen A3-Standard verwenden. + +Siehe [K00](../00_Portalprofile_und_Vertragsvorlagen.md), [K01](../K01_Preisstruktur_und_Abrechnung.md) und [R08 Destination Solutions](../R00_Szenarien/R08_Destination_Solutions.md). --- /dev/null +++ v0.7/D00_Dokumentationsregel_und_Uebergabe.md @@ -0,0 +1,34 @@ +--- +id: D00 +typ: arbeitsregel +titel: Dokumentationsregeln, Quellenbasis und Übergabe +status: diskussionsentwurf +version: "0.1" +stand: 2026-10-31 +--- + +# D00 – Dokumentationspflege und Kontextübergabe + +**Verbindliche Arbeitsvereinbarung des Betreibers vom 31.10.2026:** + +> **Vor jeder zukünftigen Änderung oder Erweiterung der Fachdokumentation muss ChatGPT den Betreiber ausdrücklich bitten, die aktuell gültigen Originaldokumente erneut bereitzustellen.** Nicht aus Erinnerung oder einem alten Chat-ZIP heraus eine bestehende Datei überschreiben. Maßgebliche Ablage bleibt **Gitea**. Dieser Stand v0.7 ist eine **lokale konsolidierte Bearbeitungsfassung**, kein nachgewiesener Gitea-Stand. + +## Vorgehen bei der nächsten Dokumentationsänderung + +1. **Vor dem Editieren** aktuelle Gitea-Originaldateien bzw. aktuellen Export/Snapshot **explizit beim Betreiber anfordern** (auch wenn eine ältere Version in /mnt/data oder der Chat-Historie vorhanden ist). +2. Vergleich mit diesem Stand / bisherigen Entscheidungen, YAML-Metadaten, Dokumenten-IDs und Verlinkungen; Unterschiede und mögliche Konflikte aufzeigen. +3. Nur auf dem bestätigten Stand weiterarbeiten; bestehende Inhalte nicht still kürzen, vereinbarte Regeln nicht als unbelegte Produktfunktionen ausgeben. +4. Versionsnummern je geändertem Dokument erhöhen, Entscheidungshistorie und Prüffälle aktualisieren; Änderungen via **Diff/Manifest** nachvollziehbar machen. +5. Dateipaket zur **kontrollierten Übernahme nach Gitea** bereitstellen; keine Behauptung, Dateien seien bereits im Repository gespeichert. Unklare Rechts-/Portalfragen offen kennzeichnen. + +## Quellen und Sicherungsstand der jetzigen Konsolidierung + +- Ausgangsbasis Hauptdokumentation: `FewoPortal_Dokumentation_v0.6.zip` **einschließlich P01–P05, die im separaten entpackten Ordner fehlten**. +- Zusätzliche Ausgangsbasis: `FewoPortal_Portalprofile_Update/{00_Buchungsarchetypen.md v0.5, 00_Portalprofile_und_Vertragsvorlagen.md v0.1, A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md v0.4}`. +- Weiteres Referenzmaterial: `FewoPortal_R01_Arbeitsentwurf/R00_Szenarien/{00_Szenariomatrix.md, R01_Eigene_Webseite.md}`. +- Nachzutragende Betreiberangaben: Gespräch vom 31.10.2026 zu FeWo-direkt-Screenshots, Destination Solutions, fünf Archetypen, Storno, unsicheren Kalendern und flexibler Preis-/Gebührenbearbeitung. +- **Nicht verifiziert:** Ob in Gitea neuere Fassungen dieser Dateien existieren. Vor künftigen Änderungen deshalb erneute Anforderung. + +## Kompakter Kontext für den nächsten Chat + +FewoPortal ist eine **kleine, mandantenfähige Vermieterwebsite-/Buchungsanwendung für typischerweise 1–3 Ferienwohnungen je Vermieter, kein Marktplatz**. Ein gemeinsamer Hauptprozess V01 P01–P05, dazu V02 Vermarktung/Gästegewinnung/Gästebindung. Fünf Archetypen: A1 eigene Webseite, A2 externe unverbindliche Anfrage, A3 externe verbindliche Buchung mit weiterer eigener Gesamtabwicklung (**Destination Solutions**), A4 externe verbindliche Buchung mit geteilter Abwicklung (**FeWo-direkt**), A5 überwiegend externe Vollabwicklung. **A6 gestrichen**; Partnerherkunft nur bei Provisionsrelevanz. Ein Vorgang/eine Akte. Externer Preis und beim Vertragsschluss vereinbarte Bedingungen bleiben maßgeblich, spätere Dokumente keine stillen neuen Pflichten. Unterschiedliche/versionierte Vorlagen pro Kanal/Buchungstyp. Portale liefern unterschiedlich vollständige Daten; **manuelle Bearbeitung und Sammel-/Gesamtpreise** sind konstitutive Fachfunktionen. Gast-Mietforderung, externe Gastgebühr, Vermieterprovision, Auszahlung und Zahlung getrennt. Kein Erfinden unbekannter Gebührenanteile. Verfügbarkeit extern nicht garantiert: FeWo-direkt verzögerter iCal-Import, Destination Solutions manuelles Sperren ohne verlässlichen Portal-/Partnernachweis; Doppelbuchungen möglich, deshalb Ausnahmeprozess und Belegkette. Nicht bekannte Vertrags- und Portalfragen im O00-Prüffallregister. **Vor der nächsten Dokumentbearbeitung aktuelle Gitea-Fassung explizit erfragen.** --- /dev/null +++ v0.7/K01_Preisstruktur_und_Abrechnung.md @@ -0,0 +1,73 @@ +--- +id: K01 +typ: fachliches-konzept +titel: Preis-, Gebühren- und Abrechnungsinformationen +status: diskussionsentwurf +version: "0.1" +stand: 2026-10-31 +--- + +# K01 – Flexible Preis-, Gebühren- und Abrechnungsinformationen + +**Fachstatus:** Betreiberentscheidungen E-014/E-015 sind bestätigt; konkrete Feldliste/Technik, Steuern und portalbezogene Berechnungsregeln bleiben zu validieren. Zielgruppe: kleine Vermieter (typischerweise 1–3 Wohnungen), keine komplexe Vollbuchhaltung. + +## 1. Zentrales Prinzip + +Portale können vollständige Einzelposten, **nur Teilaufschlüsselungen**, **kombinierte Sammelgebühren** oder ausschließlich einen **Gesamtpreis** bereitstellen. FewoPortal muss all diese Informationsstände aufnehmen und später ergänzen können. **Die Gesamtpreisangabe ist ein gültiger Ausgangswert; sie berechtigt nicht zur Erfindung unbekannter Einzelpreise.** Extern bestätigter Gastpreis bleibt Grundlage der bestehenden Buchung. + +## 2. Unbedingt zu unterscheidende wirtschaftliche Sachverhalte + +| Dimension | Beispiel | Fachliche Bedeutung / Grenze | +|---|---|---| +| **Gast ↔ Vermieter** | Vereinbarte Unterkunftsmiete, ggf. vertragliche Zusatzleistungen und Rabatte | Eigene Mietforderung gegenüber Gast; tatsächlich vereinbarter Gastpreis maßgeblich | +| **Gast ↔ externes Portal** | Eventuelle Vermittlungs-/Servicegebühr des Portals | Fremde Forderung, nicht automatisch unsere Miete oder unser Umsatz | +| **Vermieter ↔ Vermittler/Portal** | Provision, Transaktionskosten, sonstige vertragliche Dienstleistung | Eigene Kosten des Vermieters; nicht nachträglich dem Gast belasten | +| **Gastzahlungen** | Anzahlung/Restzahlung, Erstattung, Kaution | Zahlungsplan und Zahlungsstatus unabhängig von der Mietforderung | +| **Auszahlung an Vermieter** | Nettoauszahlung nach Portalabzügen | Ist-Zahlungsfluss; nicht mit Gastpreis oder vereinbartem Mietbetrag gleichsetzen | +| **Ungeklärte Mischposition** | Eine „Servicepauschale“ mit unbekanntem Anteil an Reinigung, Portalgebühr oder Provision | **Nicht ohne Nachweis in Einzelpositionen umwandeln**; Zahler/Empfänger ggf. offen | +| **Preisdifferenz/Vertriebsaufschlag** | Höherer Endpreis auf Partnerkanal möglich | Nur bei Nachweis; unterscheiden von gesonderter Gastgebühr und Vermieterprovision | + +**Begriffe:** „Brutto“, „Netto“, „Provision“ und „Servicegebühr“ können auf Portalen unterschiedlich verwendet werden. Keine umsatzsteuerliche Zuordnung ohne überprüfte Angaben. Für die Rechnungsstellung sind tatsächlich geschuldete Leistungen/Steuerregeln separat rechtlich/kaufmännisch zu prüfen. + +## 3. Fachliche Positionsstruktur – Vorschlag, noch keine technische Datenmodellfreigabe + +Je Position oder Aggregateintrag mindestens soweit bekannt: Bezeichnung, Betrag, Währung, positive/negative Wirkung, **Art der Position** (Einzelpreis, Teilaggregat, Gesamtbetrag, Rabatt, Zahlung, Aufwand, Auszahlung, unbekannt), **wer schuldet wem**, Preis-/Leistungsbezug, Quelle und Erfassungszeitpunkt, zugehörige Buchung und Konditionsstand, Status/Nachweis. Optional: Zeitraum, Menge, Steuerregel, ursprüngliche Portalzeile, externe Referenz, Verknüpfung zu Teilpositionen. + +**Qualitäts- und Nachweisstatus:** vom Portal behauptet / im Portal sichtbar / durch Beleg belegt / manuell übernommen / abgeleitet mit Rechenweg / unbekannt / widersprüchlich / nicht anwendbar. Das sind fachliche Kategorien, kein verbindlich vorgeschriebenes Enum. + +### Regeln zur Zerlegung und zum Summenabgleich + +1. **Original erhalten:** Jede Portal-Sammelposition bleibt mit Ursprung und Betrag historisch erhalten, auch nach Aufteilung. +2. **Zerlegung mit Rechenweg:** Teilpositionen nur bei ausreichender Quelle oder ausdrücklicher dokumentierter manueller Zuordnung. Rest bleibt als „ungeklärter Anteil“. +3. **Doppelzählung vermeiden:** Ein Gesamtaggregat und seine Unterpositionen dürfen in Summen **nicht additiv** gezählt werden. Die Aggregationshierarchie bleibt nachvollziehbar. +4. **Keine Scheingenauigkeit:** Nur Gesamtpreis bekannt → keine Tagespreise aus Durchschnittswert als tatsächliche Portalpreise deklarieren. Interne Vergleichskalkulation ausdrücklich von Vertragsfakten trennen. +5. **Widersprüche erhalten:** Zwei verschiedene Portal-Auszahlungswerte bleiben beide mit Herkunft stehen, bis sie belegt geklärt werden. +6. **Keine Umdeutung der Vertragspflicht:** Aufteilung, interne Provision oder Auszahlung ändern den verbindlichen Gastpreis nicht rückwirkend. +7. **Korrekturen historisieren:** Neue Information ergänzt oder korrigiert die interne Zuordnung nachvollziehbar; die ursprünglichen Portalwerte bleiben referenzierbar. + +## 4. Beschaffung und manuelle Bearbeitung + +- **Automatisch:** Datenimport per vorhandener Schnittstelle, Parser oder anderem verlässlichen Kanal, soweit die Daten tatsächlich verfügbar sind. +- **Manuell:** Vermieter ruft Portalbestätigung, Posteingang oder Abrechnungsseite auf, erfasst Werte und kann Belege/Screenshot hinterlegen. +- **Hybrid:** Automatisch importierter Gesamtpreis, manuell nacherfasste Provision oder einzelne Gebühren. +- **Klärungsaufgabe:** Wenn tatsächlich für die **nächste Fachhandlung** erforderlich, z. B. noch fehlender Betrag zur korrekten Gastrechnung oder Zahlungseinforderung. +- **Kein unnötiger Prozessstopp:** Rein interne Provisionszerlegung oder fehlende Tagespreise blockieren nicht automatisch bereits verbindliche Buchung, Kalender- oder Anreisevorbereitung. + +## 5. Getrennte Finanzzustände (kein unzulässiger Statusschluss) + +`Gastbetrag vereinbart` → `Rate fällig` → `Rate laut Portal bezahlt` → `Auszahlung angekündigt` → `Auszahlung auf Bankkonto belegt`. Diese Ereignisse sind **nicht zwangsläufig linear** und nicht in allen Portalen sichtbar. Eine sichtbare „bezahlt“-Markierung ist noch kein eigener Zahlungseingang beim Vermieter; Kaution, Mietzahlung, Gebühr und Erstattung gesondert betrachten. + +## 6. Reale Prüfbeispiele + +**FeWo-direkt A4 – beobachteter Screenshot, Buchung 10.–17.07.2027:** 840,00 € Übernachtungen, −42,00 € Rabatt, +181,51 € „Gebühren und Steuern“, 979,51 € Gastgesamtbetrag, −84,82 € „An FeWo-direkt gezahlt“, 894,69 € ausgewiesene Gesamtauszahlung. In anderer Ansicht 900,20 € erwartete Auszahlung (5,51 € Differenz). Sichtbarer Zahlungsplan 390,61 € bezahlt und 588,90 € später fällig. **Keine belegte Zerlegung** von 181,51 €/84,82 € oder der 5,51-€-Differenz; einzelne Tagespreise fehlen. Siehe [A04 Abschnitt 7](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md). + +**Destination Solutions A3 – Betreiberangaben:** Extern bestätigter Buchungspreis ist zu übernehmen und Zahlung durch Vermieter abzuwickeln. Provisionssatz kann nach vermittelndem Partner variieren. Ob Partnerportal den Endpreis erhöht oder eine separate Gast-Servicegebühr erhebt, ist derzeit nicht bestätigt; auch dort darf nur ein übermittelter Gesamtpreis zulässig sein. Keine nachträgliche Provisionsbelastung des Gastes. + +## 7. Noch zu entscheiden + +- Für welche Dokumente/Rechnungen ist eine echte Einzelpositionsauflösung zwingend? Gesetzliche Buchführungs-/Umsatzsteuerpflichten jeweils gesondert prüfen. +- Wie sollen Rundungsdifferenzen, Fremdwährungen, Kaution, Kurabgabe, Auszahlungstermine und Teilrückerstattungen technisch dargestellt werden? +- Welche Vereinbarungen gelten für Stornokostenbasis („Mietpreis“ vs. Gesamtbetrag; inkludierte/ausgeschlossene Leistungen), wenn nur eine Gesamtsumme vorliegt? +- Welche individuellen Portalberichte, tatsächlichen Zahlungsnachweise und Importformate stehen zur Verfügung? + +**Fachliche Herkunft:** Betreiberinterview vom 31.10.2026, FeWo-direkt-Screenshots, [E00 E-014–E-020](E00_Entscheidungsprotokoll.md). Rechtliche Gestaltung separat prüfen. --- /dev/null +++ v0.7/O00_Offene_Portalprueffaelle.md @@ -0,0 +1,49 @@ +--- +id: O00 +typ: prueffallregister +titel: Portalbezogene Prüf- und Klärungsfälle +status: diskussionsentwurf +version: "0.1" +stand: 2026-10-31 +--- + +# O00 – Offene Portalprüffälle / spätere Konfiguration + +**Status:** Keine offenen Fragen als beantwortet ausgeben, solange konkrete Portalansichten, Verträge, Anbieterantworten oder Gastbuchungen fehlen. Unterschiedliche Vermieter-/Portalverträge können unterschiedlich sein. Die untenstehenden Prüfpunkte sind **keine Vorbedingungen für alle Prozessschritte**. + +## A. Destination Solutions / Kühlungsborn (A3) + +| ID | Prüffall | Bekannter Stand | Erforderlicher Nachweis / spätere Konfiguration | +|---|---|---|---| +| DS-01 | Erhält Gast Stornobedingungen **vor** verbindlicher Buchung? | Staffel laut Betreiber separat im späteren Vertrag; Betreiber vermutet ggf. Portal-Einstellungen / Hinweis | Gast-Buchungsstrecke, Gast-Bestätigung, Portal-AGB/Smart-Account-Einstellungen, ggf. Betreibervereinbarung | +| DS-02 | Welche Basis ist „Mietpreis“ für Storno? | Unklar, ob Übernachtung allein oder zusätzliche Leistungen | Vertrag/Preisaufschlüsselung und rechtliche Prüfung | +| DS-03 | Gibt es eigene Gast-Servicegebühr oder Partner-Aufschläge? | **Unbekannt**; nur unterschiedliche **Vermieterprovisionen** je Vermittlungskanal sind berichtet | Gastansicht/Gastbestätigung plus Provisionsrechnung des konkreten Kanals | +| DS-04 | Vollständiger Preisnachweis | Buchung kommt mit Gesamtinformationen; Einzelposten nicht gesichert | Beispieldokumente/Muster einer echten Buchung; Fähigkeit „nur Gesamtpreis“ zulassen | +| DS-05 | Kalender-/Sperrprotokoll | Nach Betreibererfahrung **manuelle Sperre, kein formaler Sperrnachweis** | Anbieterantwort zum Serverzeitstempel, Änderungslog und Partnerweitergabe | +| DS-06 | Verfahren und Zuständigkeit für Storno/Umbuchung | Noch kein durchlaufener Prozess beschrieben | Portalvertrag, Beispielbuchung, konkrete Änderung/Storno aus Praxistest wenn möglich | + +## B. FeWo-direkt (A4) + +| ID | Prüffall | Bekannter Stand | Benötigter Nachweis | +|---|---|---|---| +| FW-01 | Welche Dokumente/Bedingungen werden vor verbindlicher Buchung gezeigt? | Eigene vierseitige Vertragsvorlage **nicht** im Portal hochgeladen; exakte Gastansicht unbekannt | Gastansicht, Buchungsbestätigung, Portal-AGB und tatsächlich bei Buchung vereinbarte Konditionen | +| FW-02 | Sind Gast-Servicegebühr, Portalabzug, Vermieterprovision und Steuerbestandteile trennbar? | Im Screenshot Gesamt- und Teilaggregationen; 181,51 € „Gebühren und Steuern“, 84,82 € „An FeWo-direkt gezahlt“ nicht weiter zerlegt | Vollständige Detailansicht/Provisionsabrechnung, ggf. vertraglicher Abgleich | +| FW-03 | Wieso zwei Auszahlungsbeträge? | 894,69 € und 900,20 € (Differenz 5,51 €) | Ursachenprüfung anhand derselben Buchung und Zahlungskonto | +| FW-04 | Welche Zahlungsdaten sind wirklich exportierbar? | Posteingang pro Buchung mit Raten, jedoch allgemeiner Zahlungsverlauf/Export vom Betreiber als unzureichend beschrieben | Exporttest, Auszahlungsbeleg und tatsächlicher Bankeingang | +| FW-05 | Änderungs- und Stornoprozess / Sanktionen | Betreiber hat bisher selbst weder Vermieterstorno noch Änderung ausgeführt | Portalregeln, Betreiberkonto, konkrete Verfahrensnachweise; tatsächliche Ursache korrekt klassifizieren | +| FW-06 | Gastdaten und örtliche Meldepflichten | Vollständige Gastanschrift nicht immer verfügbar | Tatsächlich vom Portal lieferbare Felder und konkret erforderliche lokale Pflichtdaten prüfen | +| FW-07 | iCal-Übernahme und Nachweis | Verzögerter Fremdkalenderabgleich, reale Doppelbuchungsgefahr | Zeit- und Änderungsnachweise soweit technisch verfügbar; keine Echtzeitgarantie | + +## C. Portalübergreifende Rechts-/Funktionsfragen + +- **Rechtswirksame Einbeziehung** von AGB, Storno- und Pflichtkosten vor Vertragsschluss bei externen Direktbuchungen; **späterer Dokumentversand ≠ neue automatische Einbeziehung**. Einzelprüfung anhand konkreter Verträge und Buchungsscreens. +- **Stornokosten**: Wirksamkeit der Pauschalierung und mögliche Abzüge ersparter Aufwendungen / alternative Vermietung; gesetzliche Regeln und Portal-AGB beachten, kein automatisches Rechtsurteil in FewoPortal. +- **Vollständigkeit**: Unbekannte Posten und aggregierte Beträge sind im Fachmodell ausdrücklich zulässig; der nächste notwendige Schritt kann dennoch manuelle Klärung verlangen. +- **Verfügbarkeit**: Manuelle Sperre, Zielportal-Sichtbarkeit und partnernetzweite Wirksamkeit unterscheiden. Nicht nachgewiesene Serverbestätigung nicht fingieren. +- **Datensparsamkeit**: Nur tatsächlich erforderliche Gast- und Mitreisendendaten für Vertrag und anwendbare örtliche Vorschriften erheben. + +## D. Was sich vor späterer Konfiguration beschaffen lässt + +Pro Portal idealerweise **ein vollständig anonymisierter realer Buchungsfall**, Gast-Buchungsbestätigung soweit vorhanden, Betreiber-Provisionsabrechnung, Preis-/Stornokonfiguration und ein Beispiel für Änderung/Stornierung. **Nicht alle Nachweise müssen jetzt vorliegen**; Fehlen führt zu manuellen Aufgaben oder offenen Informationsfeldern, nicht zum Erfinden von Regeln. + +**Referenzen:** [Portalprofil K00](00_Portalprofile_und_Vertragsvorlagen.md), [Preisstruktur K01](K01_Preisstruktur_und_Abrechnung.md), [FeWo-direkt A04](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md), [Destination Solutions R02](R00_Szenarien/R08_Destination_Solutions.md). --- /dev/null +++ v0.7/R00_Szenarien/R08_Destination_Solutions.md @@ -0,0 +1,61 @@ +--- +id: R08 +typ: geschaeftsszenario +titel: Verbindliche Direktbuchung – Destination Solutions +status: diskussionsentwurf +version: "0.1" +stand: 2026-10-31 +--- + +# R08 – Destination Solutions: Verbindliche Direktbuchung mit Abwicklung durch Vermieter + +**Zuordnung:** A3; Partnerherkunft **kein A6**. Dies ist ein reales, vom Betreiber beschriebenes Referenzszenario, keine Implementierungsfreigabe. Anbieter: [Destination Solutions](https://www.ds-destinationsolutions.com/). Die Angaben beschreiben den **konkret verwendeten Betreiberzugang**, nicht zwangsläufig alle Kunden und Softwareprodukte des Unternehmens. + +## 1. Dokumentierter Ist-Sachverhalt (Betreiberangaben) + +- Der Anbieter bzw. sein Partnernetz vermittelt und bestätigt Buchungen **verbindlich**, bevor der Vermieter sie erhält. +- Die Buchung wird dem Vermieter mit den für die weitere Abwicklung vorgesehenen Daten übermittelt; die Abwicklung von **Vertragsunterlagen, Gastkommunikation, Zahlungsforderung/-kontrolle, Aufenthalt und Folgevorgängen** liegt danach beim Vermieter. Einzelne Preis-/Gebührenpositionen können trotzdem fehlen; vollständige kaufmännische Aufschlüsselung ist nicht bestätigt. +- Für diesen Betreiberzugang gibt es **keinen automatischen Abgleich mit den Vermieterkalendern**. Andere Portale müssen nach Eingang einer Buchung **unverzüglich manuell gesperrt** werden. Für den Zeitpunkt der Portalübernahme/Weitergabe der Sperrung gibt es nach Betreiberangabe **keinen belastbaren Bestätigungsbeleg**. +- Destination Solutions nutzt zusätzlich Partnervertrieb. Der Vermieter erhält je nach Vertriebspartner **unterschiedliche Provisionen**. Eine unbekannte Gastgebühr oder ein Endpreisaufschlag ist **nicht nachgewiesen** und darf nicht als Tatsache modelliert werden. +- Beim Buchungsabschluss ist der Preis bereits vereinbart. Unsere Provision an den Vermittler darf daher **nicht nachträglich als Zusatzforderung gegenüber dem Gast** erhoben werden. + +## 2. Generischer Sollablauf P01–P05 mit manuellen Aufgaben + +| Phase | Tätigkeiten / Abweichung | Gate / Nachweis | +|---|---|---| +| **P01 Eingang & Belegung** | Eingehende **bereits verbindliche** Buchung übernehmen, Objekt/Zeitraum/Referenz und Gastdaten zuordnen. Eigene Kalender sofort aktualisieren, für nicht angebundene Portale **manuelle Sperraufgabe** erzeugen, mit Bearbeiter und Zeitpunkt quittieren. Bei Kollision X07. | Buchung verbindlich extern; Sperraufgabe erledigt ≠ nachweislich partnernetzweit wirksam | +| **P02 Konditionen/Vertrag** | Ursprünglich vereinbarten Gastpreis und bekannte Konditionen übernehmen, nicht selbst nachkalkulieren. Zugehöriges Vertragsprofil/Anlagen auswählen; Gast bereits gebunden – **keine zweite Annahme**. Storno-/Pflichtbedingungen auf vorvertragliche Einbeziehung prüfen. | Quelle für Gastpreis, vertragsrelevante Bedingungen und ggf. offene Rechts-/Datenlücke | +| **P03 Kaufmännisch** | Eigene Buchungsdokumentation versenden; Zahlungsplan/Anzahlung/Restzahlung festlegen bzw. gemäß Vereinbarung übernehmen, Zahlungen überwachen, Mahn-/Stornofälle selbst führen. Vermittlerrechnung/Provision ggf. nach Kanal zuordnen, Gastservicegebühren nur soweit nachgewiesen. | Eigener Zahlungsstand und offene Finanz-/Konditionsprüfungen erkennbar | +| **P04 Aufenthalt** | Gastkontakt, lokale Ansprechpartner, Anreise, Schlüssel, Reinigung, Kurabgabe/Meldedaten soweit nötig, Aufenthalt/Abreise. | Erforderliche Leistungsinformationen vorhanden; manuelle Schritte möglich | +| **P05 Abschluss** | Aufenthalt abschließen, Feedback, finanzielle Rest-/Provisionsprüfung ggf. Folgefall. | V01 regulär beendet oder offener Nachläufer verantwortlich übergeben | + +## 3. Betreiberangabe zu Stornobedingungen + +| Zeit vor Mietbeginn | Stornopauschale vom „Mietpreis“ | +|---|---:| +| 60 Tage oder mehr | 0 % | +| 59–45 Tage | 35 % | +| 44–33 Tage | 50 % | +| 32–22 Tage | 70 % | +| 21–12 Tage | 90 % | +| 11 Tage oder weniger | 100 % | + +**Wichtige Einschränkung:** Der Betreiber ist nicht sicher, ob diese Bedingungen **bereits vor der Buchung** im Portal angezeigt und wirksam einbezogen wurden oder erst mit dem eigenen, nachträglich übersandten Vertrag vereinbart werden sollen. Ein späteres Dokument kann nicht ohne Weiteres einseitig neue Pflichten begründen. Auch ob „Mietpreis“ nur Übernachtungen oder Zusatzleistungen enthält und wie 90–100 % als Pauschalierung rechtlich einzuordnen sind, muss geprüft werden. Siehe [§ 305 BGB](https://www.gesetze-im-internet.de/bgb/__305.html), [§ 309 Nr. 5 BGB](https://www.gesetze-im-internet.de/bgb/__309.html) und [§ 537 BGB](https://www.gesetze-im-internet.de/bgb/__537.html) als Prüfquellen, **nicht als abschließendes Rechtsgutachten**. + +## 4. Finanzielle Unklarheiten / Konfigurationsfragen + +1. Wird die vereinbarte Gastmiete vom Portal oder einem Partnerportal **durch eigene Gast-Servicegebühr** ergänzt? +2. Werden je Vermittlungskanal unterschiedliche **Gäste-Endpreise/Vertriebsaufschläge** berechnet? +3. Wie werden Provisionskosten und die (eventuell andere) **vertragliche Mietforderung** beim Vermieter nachgewiesen? +4. Welche Beträge/Positionen sieht der Gast vor dem Abschluss und in der Gast-Buchungsbestätigung? +5. Wie ist die **Stornokostenbasis** bei unbekannten Einzelpreisen definiert; was passiert bei optionalen Leistungen und Neuvermietung? + +## 5. Risiko: Nachweislose Sperrung trotz Sofortbuchung + +Das System muss die **eigene Ausführung** dokumentieren (Sperraufgabe, Zeitstempel, Screenshot sofern verfügbar) und gleichzeitig ehrlich kennzeichnen, dass kein Nachweis über den Servereingang bzw. die Partnernetz-Verteilung vorliegt. Buchungsüberschneidungen können auch dann auftreten, wenn der Vermieter schnell handelt. **Technisch verursachte Verzögerung beweist für sich genommen keine rechtliche Entlastung.** Livefreigabe durch Vermieter oder Karenzfrist sind hier **nicht vorhandene Ist-Funktionen** und bleiben lediglich hypothetische Integrationsoptionen. + +## 6. Quellen- und Verifizierungsstatus + +- **Bestätigt aus dem Betreiberinterview:** verbindliche Buchungsübermittlung, komplette weitere Vermieterabwicklung, manuelle Sperre ohne Bestätigungsbeleg, unterschiedliche Vermittlerprovisionen je Partner, Stornostaffel als genannte Vertragsbedingung. +- **Nicht verifiziert:** konkrete Ansicht/Bestätigung des Gastes, Vertragseinbeziehung der Stornoregeln, zusätzliche Gastgebühren oder Aufschläge, Preisaufschlüsselung, verwendete Destination-Solutions-Vertragsvariante, technische Verteilung/Protokollierung. +- Weitere Nachweise erforderlich: [O00](../O00_Offene_Portalprueffaelle.md). --- /dev/null +++ v0.7/X01_Belegungskonflikte_und_Sperrnachweise.md @@ -0,0 +1,41 @@ +--- +id: X07-DOK +typ: sonderprozess +titel: Verfügbarkeitsabgleich, Sperrnachweise und Doppelbuchungen +status: diskussionsentwurf +version: "0.1" +stand: 2026-10-31 +--- + +# X07 – Verfügbarkeitsabgleich, Sperrnachweise und Doppelbuchungen + +**Geltungsbereich:** Alle Buchungsarchetypen und Vertriebskanäle. Das Dokument ist eine Vertiefung von X07 aus [X00](X00_Sonderprozesse.md), kein zusätzlicher Buchungsarchetyp. + +## 1. Reale Ursachen und Grenzen + +- **FeWo-direkt:** Verzögertes iCal-Importintervall kann dazu führen, dass nach einer eigenen verbindlichen Buchung dort noch buchbare Zeiten angezeigt werden. Dass ein eigener Export korrekt aktualisiert wurde, beweist keine rechtzeitige Portalübernahme. +- **Destination Solutions:** Beim konkreten Vermieteraccount fehlt ein automatischer Kalenderabgleich; manuelle Sperrung im Zielportal. Anschließende Weitergabe an Partnerportale und wirksamer Zeitpunkt sind **nicht verifizierbar**; eine protokollierte Sichtkontrolle des Vermieters ist kein Portalserver-Zeitstempel. +- **Generische Grenze:** Bei heute sofort wirksam werdenden externen Direktbuchungen verhindert FewoPortal **nicht jede Doppelbuchung**. Vom Betreiber vorgeschlagene 10-Minuten-Bestätigung oder Livefreigabe sind sinnvolle technische Zukunftsoptionen, werden **nicht als bestehende Funktionen** vorausgesetzt. + +## 2. Minimale Nachweiskette, ohne Überbürokratisierung + +1. **Auslösende Buchung:** Portal/Quelle, externe Referenz, Ankunft der Nachricht, soweit ermittelbarer tatsächlicher Buchungs-/Bestätigungszeitpunkt. +2. **Eigene Belegungsänderung:** Zeitstempel, interne Buchungs-ID, Zeitraum, Nutzer/Systemaktion, Stand eigener Kalender. +3. **Propagation:** Ausgeführter Export oder angelegte manuelle Sperraufgabe; Zeitpunkt und verantwortliche Person. +4. **Zielportal:** Soweit möglich manuelle Sichtkontrolle und optionaler Screenshot. Status nur **„angezeigt“**, wenn dadurch belegt. +5. **Partnernetz:** Nur als **„wirksam nachgewiesen“** markieren, falls geeignete Rückmeldung/Protokoll vorhanden; sonst **„unbekannt“**. +6. **Fehler:** Doppelbuchung → Meldungszeitpunkte, beide Verbindlichkeitsnachweise, mögliche Ursache, Kommunikation und Entscheidung gesondert festhalten. + +**Rechtliche Vorsicht:** Ein technisch nicht vermeidbarer Sync-Verzug belegt nicht automatisch fehlendes Verschulden nach Miet- und Portalvertrag. Verantwortlichkeit erst nach Vertrags- und Sachverhaltsprüfung beurteilen. FeWo-direkt-Richtlinien zu Gastgeberstornierungen gesondert beachten; die tatsächliche Ursache nicht durch Gast-Button umdeklarieren. + +## 3. Generischer Konflikt-Teilprozess + +Konflikt entdecken → unverändert dokumentieren → **bereits verbindliche Buchungen** und Zeitachse prüfen → Ursache/Zuständigkeiten ermitteln → realistische Lösung mit Gästen/Portalen abstimmen → **rechtlich tatsächlich wirksame** Umbuchung/Stornierung oder Alternativleistung dokumentieren → Kalender/Finanzen/Vertragsdokumente aktualisieren → Folgefälle übergeben. + +Keine bereits verbindliche externe Buchung nur aufgrund widersprüchlicher Kalenderdaten löschen; keine bloße Stornoanfrage als wirksam verbuchen. Mit dem Gast wird transparent kommuniziert, ohne durch Druck eine abweichende Ursache zu konstruieren. + +## 4. Zielarchitektur, nicht Ist-Funktionen + +Mögliche spätere technische Fähigkeiten: Live-API-Verfügbarkeitsabfrage, atomare Reservierung, Portalbestätigung vor Vertragsschluss, Webhooks/Audit-Logs, automatische Konfliktfrüherkennung. **Aktuell nicht als verfügbar oder implementiert voraussetzen.** Für den MVP zunächst: gut sichtbare Sperraufgaben und revisionsfähige Eigenprotokolle. + +Siehe [P01](P01/P01_Buchungseingang_und_Verfuegbarkeit.md), [E00](E00_Entscheidungsprotokoll.md), [Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md).