Resivo-koppeling: introductie en functionele achtergrond

Wat is Resivo?

Resivo is een cloudgebaseerd toegangscontrolesysteem van dormakaba. Het platform regelt digitale sleutels en deuropening voor bewoners, beheerders en bezoekers, en biedt aparte documentatie per doelgroep:

• Bewoners & huurders — de resivo home-app voor het activeren van digitale sleutels en het beheren van huisgenoten of tijdelijke toegang.
• Beheerders (facility management) — de resivo Utility-app voor in- en uitcheckprocessen van huurders.
• Ontwikkelaars — de Resivo API voor contracten, facturatie en toegangsbeheer.

i-Reserve koppelt met de Resivo API en gebruikt één functie: bezoekersbeheer met remote deuropening. Een reservering geeft de bezoeker automatisch toegang tot de juiste deur(en) voor de duur van de boeking; bij annulering wordt die toegang weer ingetrokken. Resivo is de opvolger van de oude Exivo-koppeling.

Terminologie: Exivo → Resivo

In de i-Reserve-configuratie gebruiken we Resivo’s eigen terminologie (Site Owner in plaats van “customer”).

Authenticatie

De koppeling gebruikt OAuth 2.0 client credentials op organisatieniveau. Één credential (client-id + client-secret) van een Site Owner geeft toegang tot al diens sites. i-Reserve haalt automatisch een access-token op en hergebruikt dat zolang het geldig is.

Wat er gebeurt bij een statuswijziging

De koppeling reageert op statuswijzigingen van een reservering:

1. Komt een reservering in een trigger-status, dan maakt i-Reserve een Remote Access Authorization Set aan: de gekoppelde deur(en), met een geldigheid van (start − tijd vooraf) tot de eindtijd van de boeking.
2. Resivo verstuurt zelf een e-mail/sms aan de bezoeker met een deurlink waarmee de deur op afstand geopend kan worden.
3. Het id van de aangemaakte autorisatie wordt opgeslagen in een gekozen reserveringsveld — nodig om de toegang later in te kunnen trekken.
4. Komt de reservering in een revoke-status (bijv. geannuleerd), dan trekt i-Reserve de toegang weer in.

Mapping op naam

De koppeling van i-Reserve-objecten aan Resivo-deuren (components) gebeurt op naam, niet op id. De weergavenaam van een component (bijv. “Digitaal cilinder – dubbel”) is uniek per site, terwijl het id kan veranderen bij een site-migratie. Bij elke trigger zoekt i-Reserve de actuele id’s op aan de hand van de gekozen namen.

Telefoonnummers (sms)

Resivo accepteert voor sms alleen mobiele nummers in E.164-formaat (+31612345678). i-Reserve normaliseert 00… naar +… en strijpt spaties. Een nummer zonder landcode (bijv. 06… of een vaste lijn) wordt overgeslagen: alleen de sms valt dan weg, de toegang en de e-mail blijven werken.

Beperkingen (stand van zaken)

• Deurlink niet via de API — de portal-link die Resivo gebruikt komt niet terug in de API-respons. i-Reserve kan die link dus niet vooraf in een eigen mailtemplate zetten; Resivo verstuurt de link via zijn eigen e-mail/sms.
• Mailtaal via de site — de taal van Resivo’s berichten komt uit de defaultLocale van de site (eenmalig in de Resivo-portal in te stellen).
• Notificaties alleen via Resivo — de e-mail naar de bezoeker wordt uitsluitend door Resivo verstuurd; i-Reserve stuurt hiervoor geen eigen mail. De tekst van deze Resivo-e-mails is niet aan te passen.
• Tijdzones — geldig-van/tot worden in UTC verstuurd. De i-Reserve-server moet de juiste tijdzone als standaard hebben, anders kloppen de tijden niet.