API-koppeling: wat is het en hoe koppelt u uw telematicaplatform?

API staat voor Application Programming Interface. Het is een vaste set afspraken waarmee het ene systeem gegevens opvraagt of verstuurt naar het andere.

Bij telematica loopt de keten zo. De tracker in het voertuig legt posities, kilometerstanden en motorgegevens vast, bijvoorbeeld via de CAN-bus. Die gegevens gaan via het mobiele netwerk naar het platform in de cloud. Het platform verwerkt ze tot ritten, uren en meldingen. Via de API haalt een ander systeem die verwerkte gegevens op.

Opvragen of laten melden: polling en webhooks

Er zijn twee manieren om gegevens over te dragen. Bij polling vraagt het ontvangende systeem op vaste momenten of er iets nieuws is, bijvoorbeeld elke vijf minuten of één keer per nacht. Dat is eenvoudig en voor salarisadministratie ruim voldoende.

Bij webhooks werkt het andersom. Het telematicaplatform stuurt zelf een bericht zodra er iets gebeurt, zoals een voertuig dat een geofence binnenrijdt of een motor die een storingscode doorgeeft. Het ontvangende systeem hoeft dan niet steeds te vragen. Dat scheelt dataverkeer en levert snellere updates op, wat handig is voor een klantportaal of een planningsbord.

Let op: Niet elk platform biedt webhooks, en niet voor elk type gebeurtenis. Vraag bij de keuze voor een koppeling welke gegevens realtime beschikbaar zijn en welke alleen via periodiek opvragen.

In de praktijk worden beide termen door elkaar gebruikt. Wie het precies wil nemen, noemt de API-koppeling de technische verbinding tussen twee systemen. API-integratie is dan het bredere geheel: de koppeling plus de afspraken over welke gegevens wanneer waarheen gaan en wat het ontvangende systeem ermee doet.

Een voorbeeld maakt het verschil duidelijk. Een koppeling die kilometerstanden ophaalt, is snel gebouwd. Een integratie waarbij die kilometerstanden automatisch een onderhoudsafspraak in uw werkplaatssoftware aanmaken, vraagt meer denkwerk vooraf.

Een telematicaplatform verzamelt de hele dag gegevens over uw voertuigen en bestuurders. Via een API-koppeling kunt u die gegevens in andere systemen gebruiken. Welke gegevens beschikbaar zijn, hangt af van het platform en de modules die u gebruikt. Vaak gaat het om:

• ritten en kilometers, gesplitst in zakelijk en privé;

• actuele en historische locaties van voertuigen en assets;

• begin- en eindtijden, voor urenregistratie en nacalculatie;

• aankomst- en vertrektijden op locaties, bijvoorbeeld binnen een geofence;

• voertuiggegevens zoals kilometerstand en brandstofverbruik;

• rijgedrag per bestuurder of per voertuig;

• gegevens over bezochte locaties, bijvoorbeeld binnen een geofence.

Het werkt ook andersom. Sommige koppelingen sturen gegevens naar het telematicaplatform, zoals opdrachten uit uw planningssoftware die op de app van de bestuurder verschijnen.

Welke koppeling het meeste oplevert, hangt af van waar in uw organisatie nu het meeste handwerk zit. Dit zijn de koppelingen die wij in de praktijk het vaakst tegenkomen.

Salaris- en urenregistratie

De meest gevraagde koppeling. Uren en kilometers komen direct uit de ritgegevens, zonder handmatige invoer door bestuurders of administratie. Dat scheelt tijd en voorkomt fouten in overwerk, reisuren en kilometervergoedingen. Voor bedrijven die onder een cao met specifieke regels voor reis- en werktijd vallen, is dit vaak de eerste koppeling die zich terugverdient.

TMS en planningssoftware

Een transportbedrijf koppelt het platform aan zijn transportmanagementsysteem (TMS) of planningssoftware. De planner ziet dan live waar elke wagen is en schat aankomsttijden realistischer in. De koppeling werkt vaak in twee richtingen: ritten en stopvolgordes gaan vanuit het TMS naar de bestuurder, statusupdates en tijdstempels komen terug. Die tijdstempels zijn ook bruikbaar als onderbouwing bij discussies over wachttijd of levermomenten.

ERP en projectadministratie

Bedrijven met een ERP-systeem zoals SAP, Microsoft Dynamics of Oracle koppelen telematica vaak aan hun projectadministratie. Een installatie- of bouwbedrijf ziet zo per project hoeveel reistijd, kilometers en machine-uren er gemaakt zijn. Dat maakt nacalculatie nauwkeuriger en facturatie sneller.

Onderhoud en klantportaal

Werkelijke kilometerstanden en draaiuren zijn een betere basis voor onderhoudsplanning dan een schatting of een vaste termijn. Gekoppeld aan uw werkplaats- of onderhoudssoftware plant u onderhoud op het moment dat het echt nodig is. Tot slot koppelen sommige bedrijven hun platform aan een klantportaal, zodat klanten zelf de status van een levering of een monteur volgen.

Een API geeft toegang tot gevoelige gegevens: locaties van voertuigen, werktijden en rijgedrag van medewerkers. Beveiliging verdient daarom net zoveel aandacht als de koppeling zelf.

Technisch draait het om drie dingen.

• Ten eerste authenticatie: elk systeem dat gegevens opvraagt, meldt zich aan met een eigen API-sleutel of token. Deel sleutels nooit tussen systemen en trek sleutels in die niet meer gebruikt worden.

• Ten tweede een versleutelde verbinding (HTTPS), zodat gegevens onderweg niet leesbaar zijn.

• Ten derde beperkte rechten: geef een koppeling alleen toegang tot de gegevens die nodig zijn. Een salarispakket heeft uren en kilometers nodig, geen live locaties of rijstijlscores.

Daarnaast speelt de AVG. Gegevens over locatie en rijgedrag zijn persoonsgegevens zodra ze aan een bestuurder te koppelen zijn. Leg daarom vast met welk doel u welke gegevens deelt, hoe lang het ontvangende systeem ze bewaart en wie er toegang toe heeft. Bij grotere wagenparken of gevoelige gegevens, zoals continue locatiebepaling, is vaak een DPIA (gegevensbeschermingseffectbeoordeling) nodig.

Let op: Een systeem waarmee u de aanwezigheid, het gedrag of de prestaties van medewerkers kunt volgen, valt onder het instemmingsrecht van de ondernemingsraad (artikel 27 Wet op de ondernemingsraden). Dat geldt ook als u bestaande telematicagegevens via een nieuwe koppeling voor een ander doel gaat gebruiken.

Een koppeling begint niet bij de techniek, maar bij de vraag "Welke taken wilt u automatiseren?". Wij zien dat trajecten het soepelst verlopen met deze volgorde:

1. Bepaal het doel. Welk proces wilt u automatiseren en wie is er eigenaar van? Bijvoorbeeld: "uren gaan automatisch naar de salarisadministratie".

2. Kies de gegevens en de frequentie. Welke velden heeft het ontvangende systeem nodig, en hoe vaak? Eén keer per dag of realtime maakt veel uit voor de opzet.

3. Check of er een standaardkoppeling is. Veel softwareleveranciers hebben al een kant-en-klare koppeling of een partner die hem bouwt. Dat is sneller en goedkoper dan maatwerk.

4. Regel toegang en privacy. Maak een aparte sleutel per koppeling, beperk de rechten en leg het doel vast.

5. Test met echte maar beperkte data. Begin met een paar voertuigen of één afdeling. Controleer of de uren en kilometers in het ontvangende systeem kloppen met wat u in het platform ziet.

6. Regel het beheer. Wie krijgt een melding als de koppeling stilvalt? Wie past hem aan als één van beide systemen een update krijgt?

Dat laatste punt wordt vaak vergeten. Een koppeling is geen eenmalig project. Softwareleveranciers voeren updates door en endpoints veranderen soms van versie. Met een vaste eigenaar en een foutmelding bij uitval voorkomt u dat er weken aan gegevens ontbreken voordat iemand het merkt.