Wat is een API-koppeling? Uitleg zonder jargon
Je werkbon-app weet wat er gedaan is, je boekhouding moet het factureren. Daartussen zit nu iemand die overtypt. Een API-koppeling haalt die tussenstap weg. Hier lees je wat het is, wat je ermee kunt en waar je op let.
In het kort
- Een API is de vaste ingang waarlangs andere programma’s met software mogen praten.
- Een API-koppeling gebruikt die ingang om gegevens automatisch over te zetten.
- Stabieler dan export en import, en stabieler dan een robot die schermen nadoet.
- De kosten hangen af van de software, het aantal gegevens en de uitzonderingen.
- Sleutels op naam van je eigen bedrijf, en alleen toegang tot wat nodig is.
Wat is een API-koppeling? De balie van de groothandel
Denk aan de groothandel. Je loopt niet zelf het magazijn in om tussen de stellingen te zoeken. Je gaat naar de balie, noemt het artikelnummer en het aantal, en krijgt wat je vraagt. De balie bepaalt wat je mag vragen en hoe. Het magazijn erachter blijft van de groothandel.
Een API is die balie, maar dan voor software. Je boekhoudpakket heeft een balie waar een ander programma kan zeggen: “maak een factuur aan voor deze klant, met deze regels”. Of: “geef me alle openstaande facturen”. Het pakket controleert of de vraag mag, voert hem uit en geeft antwoord.
Een API-koppeling is het vaste loopje tussen twee balies. Elke keer dat er in de werkbon-app een werkbon wordt afgerond, loopt de koppeling naar de balie van de boekhouding en geeft de gegevens af. Niemand hoeft het nog te onthouden.
Voorbeelden van API-koppelingen in een technisch bedrijf
Werkbon-app naar boekhouding
De monteur rondt de werkbon af. De koppeling zet uren, materiaal en klantgegevens door naar het boekhoudpakket, waar een conceptfactuur klaarstaat. Afwijkingen gaan naar kantoor. Zo werkt werkbon naar factuur.
Groothandel naar project
Een orderbevestiging of inkoopfactuur komt binnen en wordt aan de juiste bestelling en het juiste project gekoppeld, zodat de nacalculatie klopt.
Website naar offertemodule
Een aanvraag via het formulier op je site komt direct als klant en aanvraag in je CRM of offertesoftware, met een taak voor de verkoper.
Planning naar werkbon-app
De planner schuift een klus. De monteur ziet de nieuwe dagplanning in zijn app, zonder belletje.
Welke pakketten we zo verbinden, zoals Exact Online en Syntess, staat op koppelingen.
API-koppeling vs export/import vs RPA
Er zijn drie manieren om gegevens van het ene programma in het andere te krijgen. Terug naar de groothandel:
- Export en import is zelf met een kar naar het magazijn rijden. Je downloadt een Excel- of CSV-bestand uit het ene pakket en laadt het in het andere. Het werkt, maar iemand moet eraan denken, en als de kolommen net anders zijn gaat het mis.
- RPA is iemand inhuren die precies jouw route loopt en op dezelfde knoppen drukt. Verplaatst de groothandel de balie, dan staat hij voor een dichte deur. Meer op RPA of AI-agent.
- Een API-koppeling is een vaste afspraak met de balie. Stabiel, direct en automatisch.
| Export/import | RPA | API-koppeling | |
|---|---|---|---|
| Automatisch | Nee, iemand moet het doen | Ja | Ja |
| Direct na de gebeurtenis | Nee | Op vaste momenten | Ja, of op vaste momenten |
| Gevoelig voor veranderingen | Bij andere kolommen | Bij elk ander scherm | Weinig, API’s blijven meestal stabiel |
| Nodig | Een exportfunctie | Toegang tot het scherm | Een API bij beide pakketten, of één API en een andere route |
Wat kost het om een API-koppeling te laten maken?
Een vast bedrag is niet te geven, maar wel waar de kosten van afhangen:
- Bestaat er al een kant-en-klare koppeling? Dan gaat het om inrichten en testen. Moet hij gebouwd worden, dan kost het meer.
- Hoe goed is de API? Een goed gedocumenteerde API is sneller aan te sluiten dan een beperkte of slecht beschreven.
- Hoeveel gegevens en uitzonderingen? Alleen klant en bedrag is eenvoudig. Meerwerk, kortingen, projecten en btw-regels maken het groter.
- Licenties. Sommige leveranciers vragen een extra module of abonnement voor API-toegang. Vraag dat vooraf na.
- Onderhoud. Software verandert. Reken op terugkerend onderhoud, niet alleen op de bouw.
Of het de moeite waard is, reken je uit met wat het handwerk nu kost. Dat doe je op terugverdientijd berekenen. Meer over prijsmodellen lees je op wat kost automatisering.
Is een API-koppeling veilig?
- Versleutelde verbinding. Gegevens gaan via een beveiligde verbinding, niet als bijlage in een mail.
- Sleutels op je eigen naam. De toegangssleutels en accounts horen bij jouw bedrijf, zodat je ze kunt intrekken.
- Alleen wat nodig is. Een koppeling die facturen aanmaakt, hoeft niet bij de salarisadministratie te kunnen.
- Logboek. Je kunt terugzien wat de koppeling wanneer heeft gedaan.
- Privacy. Gaan er persoonsgegevens door, regel dan de afspraken met elke partij. Lees AI en de AVG.
Hoe wij koppelingen aanpakken
Bij Bouwtomation is een koppeling nooit het doel, maar een onderdeel van een proces. We kijken eerst hoe het werk loopt, maken het simpeler en bouwen dan de koppeling, vaak met een agent erachter die controleert wat er doorgaat. Alle accounts staan op naam van jouw bedrijf. Lees meer op bedrijfsprocessen automatiseren of plan een kennismaking.
Veelgestelde vragen
Wat is een API-koppeling in één zin?
Een API-koppeling is een vaste verbinding tussen twee programma’s, waardoor ze automatisch gegevens uitwisselen zonder dat iemand iets hoeft over te typen of te exporteren.
Waar staat API voor?
API staat voor application programming interface. Vrij vertaald: de afgesproken manier waarop een ander programma met deze software mag praten. Welke vragen je mag stellen, in welke vorm, en wat je terugkrijgt.
Heeft elk programma een API?
Nee. De meeste moderne cloudpakketten hebben er een, zoals veel boekhoudpakketten en werkbon-apps. Oudere software die op een eigen server draait vaak niet, of beperkt. Soms moet je voor API-toegang een extra module of abonnement afnemen bij de leverancier. Op koppelingen zie je met welke pakketten we werken.
Is een API-koppeling veilig?
Een goed ingerichte koppeling is vaak veiliger dan bestanden mailen of exporteren. De verbinding is versleuteld, de koppeling krijgt alleen toegang tot wat nodig is en elke actie is terug te zien. Belangrijk is dat de sleutels goed bewaard worden en op naam van je eigen bedrijf staan.
Wat als de software een update krijgt?
Leveranciers houden hun API meestal stabiel en kondigen grote wijzigingen vooraf aan. Toch moet een koppeling af en toe worden bijgewerkt. Spreek daarom af wie dat onderhoud doet, en hoe je merkt dat er iets niet loopt.