Unterkunftsbuchung

Das Formular lässt sich an jedem Einhängepunkt direkt mit Absenden abschließen. Nach erfolgreicher serverseitiger Speicherung erscheint die Buchungsbestätigung. Bei ungültigen Angaben oder einer inzwischen belegten Unterkunft bleibt das Formular geöffnet, erklärt den Fehler und kann nach der Korrektur erneut abgesendet werden.
1. Was macht die App?
Die App @it-tremmel.de/app-accommodation-booking ist eine bestehende Buchungskomponente für Ferienwohnungen, Apartments und ähnliche Unterkünfte. Sie führt Gäste von der Auswahl eines Zimmertyps über An- und Abreisedatum bis zur Preisübersicht und zur verbindlichen Anfrage oder Buchung. Der Kern umfasst Zimmerauswahl, Gästezahl, optionale Zusatzleistungen, Gutscheine und ein strukturiertes Formular für Kontakt- und Buchungsdaten.
Die Komponente ist als App für den Einbau in größere React-Anwendungen gedacht. Sie bringt Übersetzungen für Deutsch, Englisch und Spanisch mit, kann Preise inklusive Steuer darstellen und unterstützt ergänzende Bausteine wie Kalender-Write-Back, Preisprüfung gegen ein Backend und Event-Weitergabe an andere Module.
2. Für wen?
Die App richtet sich an Betreiber von Ferienwohnungen, kleinen Apartmenthäusern, Pensionen und vergleichbaren Unterkunftsangeboten. Sie passt besonders gut zu Teams, die bereits in einer Plattform arbeiten und Buchungsdaten direkt mit Folgeprozessen wie Abrechnung, Dokumentenerstellung oder Kundenverwaltung verbinden wollen.
Geeignet ist sie für Gastgeber, Reservierungsmitarbeiter, Backoffice-Teams und Produktteams, die Self-Service-Portale bauen. Auch Multi-Property-Szenarien sind denkbar, weil Zimmertypen, Formularfelder, Zahlarten, Sprache und Theme konfigurierbar sind.
Wichtige Funktionen
Die App bietet lokalisierte Zimmernamen und Beschreibungen, Preislogik pro Nacht, Endreinigung, Extras und Gutscheincodes. Die Zusammenfassung zeigt Zwischensummen, Rabatte, Gesamtpreis und optional Steuer- oder USt.-Anteile. Zimmer lassen sich nach Belegung filtern, und Formularfelder können als Pflicht- oder Zusatzfelder konfiguriert werden.
Bei den Terminen nutzt der Hauptfluss einen Verfügbarkeitskalender über /api/accommodation/availability-calendar, sobald ein propertyId vorhanden ist. Zusätzlich exportiert das Paket Hooks für Verfügbarkeiten aus JSON- und ICS-Daten, Datumsvalidierung, Preisabfragen, Preisvergleich mit dem Backend sowie leichte dynamische Preisempfehlungen. Dazu kommen Sicherheitsmechanismen wie Hashcash und Honeypot.
4. Integration (Kanban, CRM, Invoicing)
Die deutlichsten vorhandenen Integrationen liegen bei CRM- und Abrechnungsprozessen. Nach erfolgreicher Buchung veröffentlicht die App ein booking-confirmed-Ereignis auf dem Plattform-Event-Bus. Laut bestehender Bridge kann @it-tremmel.de/app-invoicing daraus einen Rechnungsentwurf erzeugen. Außerdem ist @it-tremmel.de/app-document-builder als Empfänger vorgesehen, um Vertrags- oder Check-in-Dokumente zu erstellen.
Für CRM-nahe Abläufe erzeugt die App strukturierte Gast- und Buchungsdaten und leitet daraus Kundenbezug und Anzeigenamen ab. Zusätzlich existieren Importhilfen für Kontaktinformationen aus ICS- und VCF-Dateien. Eine fest eingebaute Kanban-Integration ist im Paket selbst nicht sichtbar. Kanban-Folgeschritte lassen sich aber über denselben Event-Strom oder Host-Logik anbinden, etwa für Housekeeping, Aufgaben oder Nachverfolgung.
So starten Sie
Für den produktiven Einsatz braucht die App einen Host, der die Komponente einbettet, die i18n-Ressourcen registriert und mindestens die Zimmerkonfiguration übergibt. In realen Setups kommen meist Extras, Zahlarten, Steuerkonfiguration, AGB-Link, optionale Zusatzfelder und ein Submit-Handler dazu. Ohne Host bleibt die App eine UI-Komponente, speichert also nicht selbst dauerhaft.
Wichtig ist die Sicherheitsverdrahtung. Beim Absenden erwartet die App Schutzdaten wie Hashcash, CAPTCHA oder Honeypot. Fehlen diese Felder, blockiert die Entwicklungsumgebung den Versand bewusst. Sinnvoll sind außerdem angebundene Verfügbarkeitsdaten, optionale Preisquote-Endpunkte und Kalender-Write-Back, wenn Kalender automatisch gepflegt werden sollen.
6. Use Cases
Ein typischer Anwendungsfall ist die direkte Buchungsstrecke auf einer Ferienwohnungsseite. Der Gast wählt Unterkunft, Reisedaten, Extras und Zahlungsmethode und sendet danach die Reservierung. Im Anschluss kann das umgebende System Rechnung, Dokumente, Reporting oder Benachrichtigungen anstoßen.
Weitere sinnvolle Einsätze sind mehrsprachige Buchungswidgets in Kundenportalen, Anfrageformulare für kleinere Betriebe und Operator-Oberflächen, die Frontend-Preise mit Backend-Quoten abgleichen wollen. Für ausgebuchte Zeiträume gibt es außerdem eine Wartelisten-Komponente, die bei Bedarf in den Gesamtprozess eingebunden werden kann.
7. Limits
Die App ist kein vollständiges Property-Management-System. Sie enthält keine komplette serverseitige Buchungslogik, keine garantierte Zahlungsabwicklung und keine automatische Persistenz ohne Host-Anbindung. Die eigentliche Speicherung, Geschäftsvalidierung und spätere Verarbeitung liegen im umgebenden System.
Ebenso wichtig: Nicht jede vorhandene Hilfsfunktion ist automatisch im Hauptbildschirm aktiv. Es gibt Exportpfade für Warteliste, ICS, Preisprüfung und Kontaktimport, aber ihre Nutzung hängt vom Einbaukontext ab. Für Kanban gibt es aktuell keinen eigenen Standard-Connector. Zudem zeigt ein bestehender Kommentar, dass Objektmetadaten für Multi-Property-Flows noch nicht überall vollständig weitergereicht werden.
8. Roadmap
Aus dem aktuellen Quellcode lassen sich realistische nächste Schritte ableiten. Naheliegend ist zuerst die vollständigere Weitergabe von propertyId und propertyName, weil dafür bereits ein TODO im Submit-Fluss existiert. Ebenfalls plausibel ist eine stärkere Standardisierung der Event-Weiterverarbeitung, damit Invoicing, Dokumente und Reporting mit weniger Host-spezifischer Zusatzlogik auskommen.
Darüber hinaus bietet die Architektur Raum für engere CRM- und Kanban-Automatisierung, etwa automatische Folgeaufgaben oder Service-Workflows nach bestätigten Buchungen. Auch die vorhandene Wartelisten-Komponente und die Preisoptimierung Lite wirken wie Bausteine, die künftig noch näher an den Hauptfluss rücken können.
FAQ
Die App erledigt nicht den kompletten Buchungsprozess allein. Sie sammelt Daten, prüft Eingaben, berechnet Preise im Frontend und übergibt die finale Anfrage an einen Host-Callback. Rechnungen entstehen daher nur automatisch, wenn das umgebende System den vorhandenen Event-Pfad nutzt. Dasselbe gilt für Dokumente, Reporting und CRM-Folgeaktionen.
Mehrsprachigkeit ist bereits eingebaut, aktuell mit Deutsch, Englisch und Spanisch. Gutscheine, Extras, Steuersätze und Formularfelder sind konfigurierbar. Wenn kein Verfügbarkeitsendpunkt angeschlossen ist, kann die App weiterhin Termine erfassen, aber nicht denselben Grad an servergestützter Kalenderlogik bieten. Für ausgebuchte Zeiträume steht eine separate Wartelisten-Komponente bereit.
Entwurf-Autospeicherung (#27038)
Ihre Buchungseingaben werden jetzt automatisch gespeichert, während Sie das Formular ausfüllen. Zimmer, Daten, Personenzahl, Extras, Gutschein und Kontaktdaten werden lokal in Ihrem Browser (pro Mandant getrennt) abgelegt und überstehen ein versehentliches Neuladen der Seite. Bei der Rückkehr erscheint der Hinweis „Entwurf wiederhergestellt"; Sie können weiter bearbeiten oder mit „Entwurf verwerfen" neu beginnen. Der Entwurf wird automatisch gelöscht, sobald Ihre Buchung erfolgreich abgeschickt wurde. Über diese Funktion verlassen keine Daten Ihren Browser, und Entwürfe, die älter als sieben Tage sind, werden verworfen.
Warum „Absenden" gesperrt ist (#40799)
Der Absenden-Knopf ist gesperrt, solange die Buchung noch nicht abgeschickt werden kann. Bisher blieb offen, woran es liegt. Jetzt steht der Grund direkt über dem Knopf und wird auch von Screenreadern vorgelesen: „Bitte zuerst eine Zimmerkategorie auswählen." (es ist noch keine Kategorie gewählt), „Bitte Anreise- und Abreisedatum auswählen." (der Zeitraum fehlt oder umfasst keine Nacht) oder „Die Buchung wird gerade gesendet – bitte einen Moment warten." (Ihre Anfrage läuft bereits). Sobald der genannte Punkt erledigt ist, verschwindet der Hinweis und der Knopf wird aktiv.