Vabi Connect: deel gegevens van je woningvoorraad veilig met externe systemen

Vabi Assets Energie in de Cloud bevat veel waardevolle informatie over je woningvoorraad. Denk aan energielabels, installaties, maatregelen en energieplannen. Met Vabi-Connect deel je deze gegevens veilig via een API-koppeling met bijvoorbeeld een dataplatform, onderhoudspartij, adviseur of BI-omgeving. Jij bepaalt welke gegevens je deelt, met welke partij en voor welke deelvoorraad. 

Een koppeling naast je bestaande koppelingen 

Vabi Connect staat los van de koppelingen die je misschien al gebruikt. In Vabi Assets Energie in de Cloud zijn er drie soorten, elk met een eigen doel:

  • ERP-koppeling, specifiek ingericht voor systemen als Tobias 365, Viewpoint, XBIS en Zig365.
  • Woonlasten, een aparte API voor het berekenen en delen van woonlastengegevens.
  • Vabi Connect, voor alle overige externe systemen, waarbij jij zelf bepaalt welke gegevens je deelt.

Heb je al een ERP-koppeling? Dan blijft die gewoon werken zoals hij werkt. Vabi Connect vervangt die niet, maar vult aan voor partijen waarvoor geen standaardkoppeling bestaat.

Deel gegevens gericht per dataset

De kern van Vabi Connect is dat je gegevens niet in één blok hoeft te delen. De informatie is opgedeeld in datasets en bij het aanmaken van een koppeling vink je aan welke daarvan je beschikbaar stelt. Dat is belangrijker dan het klinkt. Een onderhoudspartij heeft andere informatie nodig dan een duurzaamheidsdashboard. Door per partij te kiezen, geef je nooit meer toegang dan nodig is voor het doel van de samenwerking. Jij houdt de regie, ook als er later een partij bijkomt.

Daarnaast kun je ook aangeven uit welke deelvoorraden de gegevens gedeeld mogen worden. Krijgt de koppeling toegang tot alle deelvoorraden? Dan krijgt de koppeling automatisch ook toegang tot deelvoorraden die je later aanmaakt. Handig bij een vaste partner, maar zet het uit als je een partij bewust tot een deel van je portefeuille wilt beperken.

Welke gegevens kun je delen?

Je kunt kiezen uit de volgende datasets:

  • Algemeen, basisgegevens van je objecten, zoals adres, bouwjaar en woningtype. Vrijwel elke koppeling heeft dit nodig om objecten te herkennen.
  • Installaties, verwarming, ventilatie, tapwater, koeling en zonne-energie. Handig voor een onderhoudspartij of installatiebeheerssysteem.
  • Geometrie, de bouwkundige opbouw van je objecten. Bruikbaar voor platformen die met dezelfde afmetingen willen rekenen.
  • Energielabel resultaten, de uitkomsten van de labelberekening, bijvoorbeeld voor rapportages over je voorraad.
  • Maatregelen, de vastgelegde verduurzamingsmaatregelen, inclusief kosten en effect.
  • Energieplannen, de planning daaromheen. Bruikbaar voor planningssoftware of een aannemer die werkpakketten samenstelt.
  • WWS, de woningwaarderingsgegevens, relevant voor verhuur- en huurprijsprocessen.

Welke combinatie je nodig hebt, hangt af van de samenwerking. Een duurzaamheidsdashboard wil vooral labelresultaten, maatregelen en energieplannen. Een onderhoudspartij komt meestal toe met Algemeen en Installaties.

Zo stel je een koppeling in

  1. Bepaal het doel. Welke partij krijgt toegang, en waarvoor gebruiken zij de gegevens? Leg dit vast voordat je iets inricht.
  2. Selecteer de datasets. Vink aan wat nodig is voor dat doel, en bepaal of de koppeling toegang krijgt tot alle deelvoorraden.
  3. Richt de koppeling in. Ga naar Beheer → API-koppelingen, geef de koppeling een herkenbare naam en kies de authenticatiemethode: een API-token of OAuth2. Stel de geldigheidsduur in, standaard één jaar. Noteer daarna het Organisatie ID en de token. De token krijg je maar één keer te zien, dus bewaar hem veilig en deel hem alleen met de juiste contactpersoon.
  4. Zet de technische partij aan het werk. Zij gebruiken de Swagger-pagina: een online handleiding voor ontwikkelaars waarin staat welke gegevens opvraagbaar zijn en hoe. Als beheerder hoef je hier zelf niet in te werken.
  5. Test en controleer. Kijk samen of de juiste datasets binnenkomen, en of er niets wordt gedeeld dat buiten de afspraak valt.

Wijs daarnaast binnen je organisatie één beheerder aan. Die houdt bij welke koppelingen er zijn en controleert vóór het aflopen van de geldigheidsduur of de koppeling nog nodig is. Een koppeling die openstaat terwijl de samenwerking is gestopt, wil je voorkomen.

Aan de slag

Wil je Vabi Connect gaan gebruiken? Bekijk de supportpagina voor het instellen van de koppeling, of neem contact op met onze support. We denken graag met je mee over welke koppeling past bij jouw situatie en welke datasets je daarbij nodig hebt.