Partner-API
Verbinden Sie Ihre Plattform mit Vivestay
Für Property-Management-Systeme, Hospitality-Plattformen und Integrationspartner, die mit Vivestay-Kunden arbeiten. Ihre Plattform führt weiterhin die Buchung; Vivestay übernimmt die Gästeregistrierung — und gibt Ihrer Plattform Bescheid, sobald sie abgeschlossen ist.
Was Ihre Plattform kann
Von der Buchung zum registrierten Gast
-
Registrierungen aus Buchungen anlegen
Senden Sie eine Buchung an Vivestay, und daraus wird eine Gästeregistrierung für die richtige Unterkunft — identifiziert über Ihre eigene Buchungsreferenz.
-
Den Gäste-Link ausgeben
Erhalten Sie beim Anlegen der Registrierung einen sicheren Check-in-Link für den Gast, und fordern Sie jederzeit einen neuen an, wenn er erneut gebraucht wird.
-
Buchungen synchron halten
Geben Sie Änderungen an Reisedaten, Ankunftszeit oder Gästezahl weiter. Eine Registrierung, die der Gast bereits abgeschlossen hat, wird nie überschrieben.
-
Den Stand prüfen
Rufen Sie jede Registrierung über Ihre Buchungsreferenz ab und sehen Sie ihren Status und ob alle erforderlichen Angaben vorliegen.
-
Erfahren, wann ein Gast fertig ist
Vivestay benachrichtigt Ihre Plattform, sobald ein Gast seine Registrierung abschließt. Benachrichtigungen sind signiert, damit Sie sie verifizieren können, werden wiederholt, falls Ihre Plattform kurz nicht erreichbar ist, und protokolliert, damit sich jede Zustellung prüfen lässt.
-
Behördenmeldung verfolgen
Wenn der Kunde Aufenthalte über Vivestay an die Behörden meldet, sieht Ihre Plattform, wie weit jede Meldung ist.
Informationsfluss
Was hineingeht, was zurückkommt
-
Was Ihre Plattform sendet
Ihre Buchungsreferenz, die Vivestay-Unterkunft, An- und Abreisedatum sowie — sofern vorhanden — Ankunftszeit, Gästezahl und Name und Kontaktdaten des Buchenden.
-
Was Vivestay zurückgibt
Den Status der Registrierung, ob ihre Anforderungen erfüllt sind und, auf Anfrage, den sicheren Gäste-Link.
-
Identitätsdaten bleiben beim Gast
Gäste geben ihre Identitätsdaten direkt bei Vivestay an, über ihren eigenen sicheren Link. Ihre Plattform muss nie Reisepässe oder Ausweisdokumente erfassen.
-
Eine Buchung, eine Registrierung
Jede Buchungsreferenz gehört zu genau einer Registrierung — dieselbe Buchung zweimal zu senden, erzeugt nie ein Duplikat.
Typische Integrationen
So nutzen Partner die Partner-API
-
Check-in-Link bei der Buchung
Ein Property-Management-System legt die Registrierung an, sobald eine Buchung bestätigt ist, und fügt den Gäste-Link in seine eigenen Buchungsnachrichten ein.
-
Registrierungsstatus neben jeder Anreise
Eine Hospitality-Plattform zeigt, welche Anreisen bereits registriert sind — aktualisiert in dem Moment, in dem ein Gast abschließt.
-
Eine Prüfung vor dem Anreisetag
Ein Integrationspartner prüft anstehende Aufenthalte und hakt bei Registrierungen nach, die noch offen sind.
Ihre Buchungssoftware anbinden
Fertige Anbindungen, ganz ohne Entwicklung
Vivestay-Kunden können ihre Buchungssoftware auch direkt in Vivestay anbinden, ganz ohne Integrationsaufwand.
-
OwnerRez
Buchungen, Änderungen und Stornierungen fließen automatisch aus OwnerRez ein, sobald der Kunde sein Konto verbindet.
-
iCal-Kalender
Jeder Kalender, der einen iCal-Feed veröffentlicht, lässt sich synchronisieren, sodass seine Buchungen in Vivestay erscheinen.
Zugang und Voraussetzungen
Die Partner-API arbeitet im Auftrag eines Vivestay-Kunden. Der Administrator des Kunden richtet in der Vivestay-Konsole einen eigenen Zugang für Ihre Plattform ein, beschränkt auf Integrationsaufgaben und jederzeit widerrufbar. Eine separate Entwickler-Registrierung gibt es nicht.
Die Unterkünfte des Kunden sind in Vivestay eingerichtet, und Buchungen werden ihnen zugeordnet; die Partner-API legt aus Buchungen keine Unterkünfte an. Die Meldung an die Behörden bleibt eine Aktion des Kunden selbst in Vivestay.
Integrationspartner erhalten die technische Integrationsdokumentation: Kontaktieren Sie uns und wählen Sie „Partnerschaft oder Integration“.
Planen Sie eine Integration?
Erzählen Sie uns von Ihrer Plattform und den Kunden, die Sie betreuen — wir teilen die technische Dokumentation und helfen Ihnen bei der Anbindung.