Holiday rental (iCal) Smart-Home-Integration, kostenlos und Open Source
An- und Abreisen der Gäste aus iCal-Exporten von Airbnb, Booking.com, Vrbo: Vorheizen, Reinigung.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Die An- und Abreisen der Gäste einer Ferienunterkunft, gelesen aus den iCal-Exportkalendern, die jede Plattform für jedes Inserat bereitstellt (Airbnb, Booking.com, Vrbo, Abritel, Gîtes de France, Smoobu und andere Channel-Manager): kein Konto, keine Partner-API. Vor der Ankunft vorheizen, bei der Abreise die Heizung abschalten, an einem Wechseltag die Reinigung benachrichtigen.
Ohne echtes Gastgeberkonto entwickelt: Rückmeldungen willkommen. Die Formate wurden an echten, veröffentlichten Exporten geprüft.
Was du bekommst
- Ein Gerät pro Unterkunft (höchstens drei), mit:
- Belegt (ja / nein): ein Aufenthalt läuft, von seiner Anreisezeit bis zu seiner Abreisezeit;
- Anreise bald (ja / nein): die nächste Anreise liegt innerhalb des Vorlaufs der Optionen (standardmäßig 3 Stunden);
- Wechsel heute (ja / nein): Gäste reisen ab und andere am selben Tag an;
- Nächste Anreise und Nächste Abreise: Tag, Uhrzeit und Plattform, z. B. „Fr., 13. Nov., 16:00 · Booking.com“;
- Stunden bis zur Anreise (aufgerundet) und Tage bis zur Anreise;
- Verbleibende Nächte des laufenden Aufenthalts.
- Drei Szenen-Auslöser: Anreise der Gäste, Abreise der Gäste, Anreise bald.
- Eine Szenen-Aktion, die den laufenden oder nächsten Aufenthalt liest, für eine Nachricht.
- Ein Dashboard-Widget: jetzt belegt oder frei, dann die kommenden Aufenthalte.
Konfiguration
Für jede Unterkunft, unter Integrationen → Holiday rental (iCal) → Konfiguration:
- Name: der Name des Geräts in Gladys (du kannst das Gerät später umbenennen).
- iCal-Adresse: die Exportadresse (.ics) des Kalenders der Unterkunft auf einer Plattform. Weitere iCal-Adresse: dieselbe Unterkunft auf einer zweiten Plattform. Mehrere Adressen lassen sich auch in ein Feld einfügen, durch Leerzeichen getrennt. Die Aufenthalte aller Adressen werden zusammengeführt, Doppelte entfernt.
- Anreisezeit und Abreisezeit (standardmäßig 16:00 und 11:00): Die Plattformen exportieren Tage, keine Uhrzeiten. Gibt ein Feed eine Uhrzeit an (manche Channel-Manager), gilt diese.
Wo du die Adresse findest:
- Airbnb: Kalender → das Inserat → Verfügbarkeit → Kalender verbinden → Kalender exportieren.
- Booking.com (Extranet): Preise & Verfügbarkeit → Kalender synchronisieren → Exportieren. Booking.com schreibt jedes gebuchte oder geschlossene Datum als „CLOSED - Not available“: Wähle, nur die gebuchten Daten zu exportieren, wenn das Extranet es anbietet.
- Vrbo / Abritel: Kalender → Importieren und exportieren → Kalender exportieren.
- Gîtes de France, Clévacances, Smoobu, Lodgify, Beds24…: die Seite „iCal-Export“ oder „Kalendersynchronisierung“ des Inserats.
Optionen:
- Vorlauf vor der Anreise (Stunden, 0 bis 72): wann „Anreise bald“ angeht und sein Auslöser startet. 0 schaltet es ab.
- „Not available“-Daten: Booking.com und Smoobu exportieren jede Buchung als „Not available“, genau wie ein Datum, das du selbst gesperrt hast. Standardmäßig zählen sie als Aufenthalte (sonst sähe ein Booking.com-Gastgeber gar keine Buchung); wähle „Ignorieren“, wenn alle deine Buchungen aus Feeds kommen, die sie benennen (Airbnb „Reserved“, Vrbo „Reserved - …“). Die Sperren von Airbnb („Airbnb (Not available)“) und Vrbo („Blocked“) werden immer ignoriert: Bei Airbnb enthalten sie auch die von anderen Plattformen importierten Buchungen, die deren eigener Feed liefert.
- Gastnamen und Codes anzeigen: standardmäßig aus. Eingeschaltet erscheinen der Vorname (Vrbo) und der
Buchungscode (Airbnb), die manche Feeds enthalten, im Widget und in der Variable
guestder Szenen. - Aktualisierung der Kalender: alle 15, 30 (Standard) oder 60 Minuten, oder alle 3 Stunden. Die Plattformen aktualisieren ihre Exporte selbst bestenfalls alle paar Stunden: Ein schnellerer Takt sieht eine Buchung auf ihrer Seite nicht früher.
- Sprache der Namen: Namen der Funktionen und Texte der Zustände, beim Anlegen des Geräts festgelegt.
Öffne dann den Reiter Erkennung und füge jede Unterkunft zu Gladys hinzu.
Aktionen
Kalender jetzt prüfen lädt jeden Kalender neu und fasst pro Unterkunft die Zahl der kommenden Aufenthalte und die nächste Anreise zusammen, oder die Kalender, die nicht gelesen werden konnten.
Szenen
Auslöser (Kategorie „Holiday rental (iCal)“ im Szenen-Editor), jeder nach Unterkunft filterbar:
- Anreise der Gäste: die Anreisezeit eines Aufenthalts ist erreicht.
- Abreise der Gäste: die Abreisezeit ist erreicht: Heizung aus, Reinigung. Nutze eine Aktion „Warten“ der Szene für die Reinigung ein paar Stunden später.
- Anreise bald: der Vorlauf vor einer Anreise ist erreicht: vorheizen.
Variablen der drei: Unterkunft, Plattform, Nächte, Anreise, Abreise, Wechsel am selben Tag (ja / nein) und Gast (leer, außer die Option ist an).
Die Gerätezustände dienen auch als Bedingungen: „Stunden bis zur Anreise“ bei 24 oder weniger, um den Code eines smarten Schlosses am Vortag zu setzen, „Belegt“ bei nein, um die Heizung im Frostschutz zu halten, „Wechsel heute“ bei ja, um das Reinigungsteam morgens zu benachrichtigen. Ist kein Aufenthalt bekannt, zeigt „Stunden bis zur Anreise“ 9999 und „Tage bis zur Anreise“ 999, damit ein Schwellwert nie darauf auslöst.
Aktion: Nächsten Aufenthalt lesen liefert für eine Unterkunft den laufenden Aufenthalt oder sonst den nächsten: gefunden (ja / nein), Unterkunft, jetzt belegt, Anreise, Abreise, Nächte, Tage bis zur Anreise, Plattform.
Dashboard
Füge das Widget Aufenthalte hinzu: eine Statuszeile pro Unterkunft (belegt bis…, oder frei und die nächste Anreise), dann bis zu acht kommende Aufenthalte mit Daten, Anzahl der Nächte und Plattform; der laufende Aufenthalt und die Anreisen des Tages sind markiert. Einstellungen: eine Unterkunft (alle, wenn leer) und ob die Zeilen belegt / frei angezeigt werden.
Fehlerbehebung
- Die Konfigurationsseite meldet „Kalender nicht erreichbar“: Die Adresse ist falsch kopiert, oder die Plattform hat sie erneuert. Kopiere sie erneut von der Plattform. „Kalender jetzt prüfen“ zeigt, welche Unterkunft fehlschlägt. Die schon gelesenen Aufenthalte bleiben solange erhalten.
- Ein Aufenthalt fehlt: Ist er im Export der Plattform? Manche exportieren nur die kommenden 12 Monate, und eine Booking.com-Buchung braucht „Not available“-Daten, die als Aufenthalte zählen.
- Ein gesperrtes Datum erscheint als Aufenthalt: Es ist in einem „Not available“-Feed gelandet (Booking.com importiert die Sperren von Airbnb). Exportiere bei Booking.com nur die gebuchten Daten, oder wähle „Ignorieren“.
- Die Uhrzeiten sind um eine Stunde oder mehr verschoben: Sie werden in der Zeitzone von Gladys gelesen (Einstellungen → System). Unterkunft und Gladys müssen in derselben Zeitzone liegen.
Grenzen
- Höchstens drei Unterkünfte, je zwei Adressfelder (mehrere Adressen können sich ein Feld teilen).
- Die Plattformen aktualisieren ihre Exporte in ihrem eigenen Takt, oft alle paar Stunden: Eine Buchung von vor einer Minute erscheint eventuell erst später.
- Mit den Gästen vereinbarte frühe Anreisen und späte Abreisen stehen nicht in den Exporten: Es gelten die eingestellten Uhrzeiten.
- Kein Aufenthalt wird in den Gladys-Kalender eingetragen: Die Integration ICS-Kalender kann dieselben Feeds dort anzeigen.
Datenschutz und Sicherheit
Die iCal-Adressen sind Geheimnisse (wer sie hat, liest deinen Kalender): Gladys speichert sie, sie dienen nur zum Herunterladen der Kalender und erscheinen nie in den Logs (nur der Hostname). Nichts wird auf die Festplatte geschrieben. Gastnamen und Buchungscodes bleiben verborgen, außer du schaltest die Option ein. Keine Verbindung zu Airbnb, Booking.com, Vrbo, Abritel oder einer anderen hier genannten Plattform.
Konfigurationseinstellungen
Diese Einstellungen fragt Holiday rental (iCal) in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Deine Unterkünfte | section | Nein | Bis zu drei Unterkünfte, jede ein Gerät. Füge die iCal-Exportadresse ihres Kalenders auf jeder Plattform ein (Airbnb: Kalender → Verfügbarkeit → Kalender verbinden; Booking.com: Preise & Verfügbarkeit → Synchronisieren). Private Adressen: sie bleiben in Gladys. |
| Unterkunft 1 | section | Nein | |
| Unterkunft 1: Name | string | Nein | Name des Geräts in Gladys. |
| Unterkunft 1: iCal-Adresse | secret | Nein | Exportadresse (.ics) des Kalenders der Unterkunft auf einer Plattform. Mehrere Adressen lassen sich durch Leerzeichen trennen. |
| Unterkunft 1: weitere iCal-Adresse | secret | Nein | Dieselbe Unterkunft auf einer anderen Plattform: Die Aufenthalte werden zusammengeführt, Doppelte entfernt. |
| Unterkunft 1: Anreisezeit | select | Nein | |
| Unterkunft 1: Abreisezeit | select | Nein | |
| Unterkunft 2 | section | Nein | |
| Unterkunft 2: Name | string | Nein | Name des Geräts in Gladys. |
| Unterkunft 2: iCal-Adresse | secret | Nein | Exportadresse (.ics) des Kalenders der Unterkunft auf einer Plattform. Mehrere Adressen lassen sich durch Leerzeichen trennen. |
| Unterkunft 2: weitere iCal-Adresse | secret | Nein | Dieselbe Unterkunft auf einer anderen Plattform: Die Aufenthalte werden zusammengeführt, Doppelte entfernt. |
| Unterkunft 2: Anreisezeit | select | Nein | |
| Unterkunft 2: Abreisezeit | select | Nein | |
| Unterkunft 3 | section | Nein | |
| Unterkunft 3: Name | string | Nein | Name des Geräts in Gladys. |
| Unterkunft 3: iCal-Adresse | secret | Nein | Exportadresse (.ics) des Kalenders der Unterkunft auf einer Plattform. Mehrere Adressen lassen sich durch Leerzeichen trennen. |
| Unterkunft 3: weitere iCal-Adresse | secret | Nein | Dieselbe Unterkunft auf einer anderen Plattform: Die Aufenthalte werden zusammengeführt, Doppelte entfernt. |
| Unterkunft 3: Anreisezeit | select | Nein | |
| Unterkunft 3: Abreisezeit | select | Nein | |
| Optionen | section | Nein | |
| Vorlauf vor der Anreise (Stunden) | number | Nein | „Anreise bald“ geht so viele Stunden vor der Anreise an, und sein Szenen-Auslöser startet: Zeit zum Vorheizen. 0 schaltet es ab. |
| „Not available“-Daten | select | Nein | Booking.com und Smoobu exportieren jede Buchung als „Not available“, wie ein gesperrtes Datum. Sperren von Airbnb und Vrbo werden immer ignoriert. |
| Gastnamen und Codes anzeigen | boolean | Nein | Aus: Vornamen und Buchungscodes mancher Feeds bleiben in Widget und Szenen verborgen (personenbezogene Daten). |
| Aktualisierung der Kalender | select | Nein | |
| Sprache der Namen | select | Nein | Namen der Funktionen und Texte der Zustände, beim Anlegen des Geräts festgelegt. |
So installierst du Holiday rental (iCal) in Gladys
- Öffne in Gladys Integrationen: Holiday rental (iCal) erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-location-saisonniere:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-location-saisonniere.
Holiday rental (iCal) benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Holiday rental (iCal) ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation