Een API-koppeling is een vaste, automatische verbinding waarmee software zelf data uit een bronsysteem ophaalt en dat steeds opnieuw doet. Een CSV-export is een bestand dat iemand op één moment maakt en daarna zelf ergens inleest. Een koppeling blijft daardoor actueel zonder handwerk, een export veroudert zodra hij is gemaakt. Voor eenmalige of zelden veranderende data is een export prima.
Veel bedrijven beginnen met een export: een knop in het boekhoudpakket of CRM, een CSV-bestand erachter, en dat bestand gaat naar Excel. Dat werkt, tot je er elke week mee moet werken. Het verschil tussen een API-koppeling en een CSV-export zit niet in de data zelf, maar in wat er daarna met die data gebeurt.
Een momentopname tegenover een doorlopende verbinding
Een CSV-export legt de stand van zaken vast op het moment dat iemand op de knop drukt. Daarna verandert het bronsysteem gewoon door: nieuwe facturen, nieuwe contacten, gecorrigeerde boekingen. Het bestand verandert niet mee. Een API-koppeling vraagt het systeem zelf, volgens een vast ritme, om de actuele data. Bij APIboard hangt dat ritme af van je pakket: wekelijks, dagelijks of drie keer per dag, zie de prijzen. Dat is niet realtime, maar het gebeurt wel zonder dat iemand eraan hoeft te denken, en het ritme blijft hetzelfde ook als de persoon die de export altijd deed op vakantie is.
Wat er bij een export met de hand blijft gebeuren
Bij elke export hoort een vaste reeks handelingen: inloggen, het juiste rapport kiezen, de juiste periode instellen, opslaan, het bestand ergens neerzetten, inlezen. Eén vergeten stap en je werkt met oude cijfers zonder dat het opvalt. Dit is dezelfde dynamiek als bij losse Excel-bestanden: zodra data in kopieën rondgaat, weet niemand zeker welke versie klopt. De werkelijke prijs van dat herhaalde handwerk komt aan bod in wat handmatige dataverwerking kost.
Waarom CSV foutgevoelig is
CSV lijkt een eenvoudig, universeel formaat, maar het is minder strak vastgelegd dan veel mensen denken. RFC 4180 is de bekendste beschrijving en noemt zichzelf informatief: het document zegt zelf dat het geen internetstandaard specificeert. Er staat ook dat er geen formele specificatie bestaat, waardoor bestanden op uiteenlopende manieren worden geïnterpreteerd, en dat de implementaties flink van elkaar verschillen. In de praktijk betekent dat: het ene programma schrijft een bestand dat een ander net anders leest. Een kolomkoptekst is bijvoorbeeld optioneel volgens die RFC, en een CSV bevat alleen tekst, dus ook datums en bedragen komen als tekst binnen en moeten door de ontvangende kant worden geïnterpreteerd.
Een koppeling omzeilt dat probleem. Hij haalt gestructureerde data rechtstreeks uit het bronsysteem, in vaste tabellen en velden, zonder dat het door een bestand heen hoeft.
Wanneer een export wel prima is
Een export is niet slecht. Voor data die je één keer nodig hebt, voor een historisch bestand dat niet meer verandert, of voor een systeem waar geen koppeling voor bestaat, is een bestand de simpelste route. Ook bij APIboard kun je naast je koppelingen eigen bestanden (CSV of Excel) uploaden, voor data die niet uit een systeem komt. De regel die ik hanteer: gebruik je de data één keer, dan is een export genoeg; kom je er elke week op terug, dan hoort die data via een koppeling te lopen.
Koppelen zonder code
Een koppeling vraagt niet per se een ontwikkelaar. Bij APIboard koppel je een systeem zonder code, bijvoorbeeld Exact Online of Moneybird, en komt de data daarna automatisch binnen. Wil je eerst weten of zelf bouwen of een platform beter past, lees dan API-koppeling zelf bouwen of een platform gebruiken.
Onze tip: kijk naar hoe vaak je een export maakt. Zodra dezelfde export voor de derde keer in je agenda staat, is dat het moment om die data te koppelen in plaats van te exporteren.
