Partner-API
Koppel je platform aan Vivestay
Voor property-managementsystemen, hospitalityplatforms en integratiepartners die met klanten van Vivestay werken. Je platform blijft de boeking beheren; Vivestay regelt de gastenregistratie — en laat je platform weten wanneer die klaar is.
Wat je platform kan
Van boeking tot geregistreerde gast
-
Registraties aanmaken vanuit boekingen
Stuur een boeking naar Vivestay en die wordt een gastenregistratie voor de juiste accommodatie, herkenbaar aan je eigen boekingsreferentie.
-
De gastlink uitgeven
Ontvang een beveiligde check-inlink voor de gast zodra de registratie is aangemaakt, en vraag een nieuwe aan wanneer die opnieuw nodig is.
-
Boekingen gelijk houden
Geef wijzigingen in datums, aankomsttijd of aantal gasten door. Een registratie die de gast al heeft afgerond, wordt nooit overschreven.
-
Zien hoe het ervoor staat
Zoek elke registratie op met je boekingsreferentie en zie de status en of alles wat nodig is al is aangeleverd.
-
Horen wanneer een gast klaar is
Vivestay laat je platform weten zodra een gast de registratie afrondt. Meldingen zijn ondertekend zodat je ze kunt verifiëren, worden opnieuw verstuurd als je platform even niet bereikbaar is, en worden vastgelegd zodat je elke levering kunt nakijken.
-
Meldingen aan de autoriteiten volgen
Als de klant verblijven via Vivestay aan de autoriteiten meldt, kan je platform zien hoe elke melding verloopt.
Informatiestroom
Wat erin gaat, wat eruit komt
-
Wat je platform verstuurt
Je boekingsreferentie, de accommodatie in Vivestay, aankomst- en vertrekdatum en — als je die hebt — de aankomsttijd, het aantal gasten en de naam en contactgegevens van de hoofdboeker.
-
Wat Vivestay teruggeeft
De status van de registratie, of aan de vereisten is voldaan en, als je erom vraagt, de beveiligde gastlink.
-
Identiteit blijft bij de gast
Gasten geven hun identiteitsgegevens rechtstreeks aan Vivestay, via hun eigen beveiligde link. Je platform hoeft nooit paspoorten of identiteitsbewijzen te verzamelen.
-
Eén boeking, één registratie
Elke boekingsreferentie hoort bij precies één registratie, dus dezelfde boeking twee keer sturen levert nooit een dubbele op.
Typische integraties
Zo gebruiken partners de Partner-API
-
Check-inlink bij de boeking
Een property-managementsysteem maakt de registratie aan zodra een boeking is bevestigd en neemt de gastlink op in zijn eigen boekingsberichten.
-
Registratiestatus bij elke aankomst
Een hospitalityplatform toont welke aankomsten al geregistreerd zijn, bijgewerkt op het moment dat een gast afrondt.
-
Een controle vóór de aankomstdag
Een integratiepartner loopt komende verblijven na en volgt de registraties op die nog openstaan.
Koppel je boekingssoftware
Kant-en-klare koppelingen, zonder ontwikkelwerk
Klanten van Vivestay kunnen hun boekingssoftware ook rechtstreeks in Vivestay koppelen, zonder integratiewerk.
-
OwnerRez
Boekingen, wijzigingen en annuleringen stromen automatisch binnen vanuit OwnerRez zodra de klant zijn account koppelt.
-
iCal-agenda’s
Elke agenda die een iCal-feed publiceert, kan worden gesynchroniseerd, zodat de boekingen ervan in Vivestay verschijnen.
Toegang en voorwaarden
De Partner-API werkt namens een klant van Vivestay. De beheerder van de klant geeft je platform eigen toegang vanuit de console van Vivestay, beperkt tot integratiewerk, en kan die op elk moment intrekken. Een aparte ontwikkelaarsregistratie is er niet.
De accommodaties van de klant zijn in Vivestay ingericht en boekingen worden daaraan gekoppeld; de Partner-API maakt geen accommodaties aan vanuit boekingen. Melden aan de autoriteiten blijft een handeling van de klant zelf in Vivestay.
Technische integratiedocumentatie is beschikbaar voor integratiepartners: neem contact met ons op en kies “Samenwerking of integratie”.
Een integratie in de planning?
Vertel ons over je platform en de klanten die je bedient, dan delen we de technische documentatie en helpen we je bij het koppelen.