API-integraties: CAFM koppelen aan HR en BMS

Nederlandse context

Nederlandse CAFM-leveranciers bieden steeds vaker standaard API's (REST/JSON) aan voor koppelingen met gangbare systemen als SAP, AFAS, Exact en diverse BMS-platforms. De NEN-EN-ISO 16484-reeks beschrijft standaarden voor gebouwautomatisering en communicatieprotocollen die relevant zijn voor BMS-integratie.

Kernbegrippen

API

Application Programming Interface. Een gestandaardiseerde manier waarop softwaresystemen onderling data uitwisselen, zonder dat gebruikers handmatig gegevens overtypen.

BMS

Building Management System. Het systeem dat klimaat, verlichting en andere gebouwinstallaties aanstuurt en monitort. Bron van real-time gebouwdata.

Middleware

Tussenliggende software die de communicatie tussen twee systemen vertaalt en orkestreert. Nuttig wanneer systemen geen directe API-koppeling ondersteunen.

Master data

De basisgegevens (personen, locaties, objecten) die in meerdere systemen voorkomen. Eén systeem is leidend (master); andere systemen nemen de data over.

Webhook

Een mechanisme waarbij een systeem automatisch een bericht stuurt naar een ander systeem wanneer een bepaalde gebeurtenis plaatsvindt. Sneller dan periodiek pollen.

Aanpak stap voor stap

Begin met het in kaart brengen van de datastromen: welke informatie stroomt van welk bronsysteem naar welk doelsysteem, en hoe vaak moet dat gebeuren? Typische koppelingen zijn HR → CAFM (medewerkersmutaties, afdelingswijzigingen), BMS → CAFM (storingssignalen, energiedata) en CAFM → ERP (kostenfacturen, inkoopverzoeken).

Bepaal vervolgens per koppeling wie de master is voor welke data. Als HR het leidende systeem is voor personeelsgegevens, mag het CAFM-systeem die data niet overschrijven. Dit lijkt triviaal, maar in de praktijk ontstaan conflicten wanneer beide systemen wijzigingen toestaan op dezelfde gegevens.

Start met de koppeling die de meeste operationele waarde oplevert — vaak is dat de BMS-integratie, omdat real-time storingssignalen de reactietijd verkorten. Bouw de koppeling op in een testomgeving, valideer de data-uitwisseling grondig en plan een terugvalscenario voor het geval de koppeling uitvalt. Documenteer elke integratie met datawoordenboek, foutafhandeling en verantwoordelijke contactpersoon. Ongedocumenteerde koppelingen worden na personeelswisselingen al snel onbeheersbaar.