Wat is een API-koppeling en wat kost die?

Een API-koppeling is een verbinding waarmee twee programma's zelf gegevens uitwisselen, zonder dat jij iets hoeft over te typen. Bijvoorbeeld: een bestelling in je webshop komt vanzelf als verkoopfactuur in je boekhouding. Wat zo'n koppeling kost, hangt af van de pakketten, de gegevens en wat er moet gebeuren als iets misgaat. Een eenduidig bedrag bestaat niet; daar leg ik hieronder uit waarom en waar het van afhangt.

Wat is een API?

API staat voor application programming interface. Het is de manier waarop een programma van buitenaf aanspreekbaar is voor andere programma's. Zie het als het loket van een pakket: je kunt er netjes iets afgeven, iets opvragen of iets laten wijzigen, en je hoeft niet te weten hoe het erachter werkt.

Veel pakketten die ondernemers gebruiken hebben zo'n loket, bijvoorbeeld Moneybird voor boekhouding. Het pakket beschrijft in documentatie welke gegevens je kunt opvragen of aanmaken en hoe je jezelf bekendmaakt.

Wat is een API-koppeling dan?

Een API-koppeling is de software die tussen twee van die loketten staat. Zij vraagt bij het ene pakket gegevens op of ontvangt ze, vertaalt ze naar wat het andere pakket verwacht en geeft ze daar af. Dat gebeurt automatisch, elke keer op dezelfde manier. Daarin verschilt een koppeling van een AI-agent, die zelf kiest welke stap hij zet.

Een koppeling werkt grofweg op twee manieren:

• Opvragen op een vast moment. De koppeling kijkt elk kwartier of elk uur of er iets nieuws is. Eenvoudig, maar er zit vertraging in.
• Een melding via een webhook. Het ene pakket stuurt zelf een bericht zodra er iets gebeurt, bijvoorbeeld een nieuwe bestelling of een betaling. Dat is directer. Zo'n bericht is technisch gezien een POST-verzoek naar een adres van de koppeling.

Voorbeelden uit de praktijk

Typische koppelingen voor kleine bedrijven:

• Webshop naar boekhouding. Elke bestelling wordt een factuur of boeking, met de juiste btw.
• Inkoopfactuur naar boekhouding. Een binnengekomen factuur wordt uitgelezen en klaargezet als boeking; hoe facturen automatisch verwerken werkt staat in een eigen artikel.
• Website-formulier naar CRM of agenda. Een aanvraag staat direct bij je klanten of in je planning.
• Betaling naar order. Zodra een betaling binnen is, krijgt de klant een bevestiging en gaat de bestelling de deur uit.
• Voorraad gelijk houden tussen webshop, magazijnsysteem en marktplaats.

Op de pagina over automatisering staat welke pakketten ik kan koppelen. Heeft een pakket een API, dan is koppelen meestal mogelijk.

Wanneer lukt het zonder maatwerk?

Niet elke koppeling hoeft gebouwd te worden. Er zijn drie routes, van licht naar zwaar:

1. Een ingebouwde koppeling. Veel pakketten hebben een knop "koppel met …". Kijk daar eerst. Het kost vaak niets of een klein bedrag per maand, maar je krijgt wat de maker bedacht heeft.
2. Een tool als Make of Zapier. Je stelt zelf stappen in: als dit gebeurt, doe dan dat. Goed voor eenvoudige, losse taken. Het wordt lastig bij uitzonderingen, grote aantallen of gegevens die gecontroleerd of omgezet moeten worden.
3. Een koppeling op maat. Die bouw je als de standaardroutes niet passen: een eigen regel voor btw, een stap waarbij een mens moet goedkeuren, of meer dan twee systemen.

Mijn advies: begin bij route 1, ga alleen naar de volgende als je een concrete reden hebt.

Wat kost een API-koppeling?

Er is geen vast bedrag, omdat een koppeling uit meerdere kostenposten bestaat:

• Eenmalig: de bouw. Hoeveel werk dat is, hangt af van hoeveel gegevens er heen en weer gaan, hoe goed de API van beide pakketten is, welke uitzonderingen je hebt en hoeveel er getest moet worden.
• Per maand: de pakketten zelf. Sommige leveranciers rekenen extra voor API-toegang of voor een hoger abonnement. Controleer dat vooraf.
• Per maand: hosting en onderhoud. Een koppeling draait ergens en moet in de gaten gehouden worden. Pakketten veranderen hun API, wachtwoorden verlopen en gegevens kunnen onverwacht anders zijn. Zonder onderhoud staat je koppeling op een dag stil, vaak zonder dat je het merkt.

Zo werk ik zelf: je begint met een gratis scan, daarna krijg je een vaste prijs voor de bouw en een vast maandbedrag voor hosting en onderhoud. Wat het uiteindelijk wordt, hoor je voordat er iets gebouwd wordt.

Waar let je op?

Een paar zaken die het verschil maken tussen een koppeling die werkt en een die problemen geeft:

• Limieten. Pakketten laten maar een bepaald aantal verzoeken per periode toe. Bij Moneybird is dat volgens de documentatie bijvoorbeeld beperkt per vijf minuten. Een goede koppeling houdt daar rekening mee en probeert het later opnieuw.
• Toegang. Een koppeling krijgt een sleutel of toestemming van jou. Geef alleen de rechten die nodig zijn en wees duidelijk over wie die sleutel beheert.
• Persoonsgegevens. Gaan klantgegevens heen en weer, dan val je onder de AVG. Kijk bij de Autoriteit Persoonsgegevens wat dat voor jou betekent, en maak afspraken met de partij die de koppeling beheert.
• Fouten zichtbaar maken. Wat gebeurt er als een bestelling niet aankomt? Je wilt een melding, geen stille fout.
• Eén bron van waarheid. Bepaal per soort gegeven welk pakket leidend is. Anders overschrijven twee systemen elkaar.

Is een koppeling het waard?

Reken het simpel door. Hoe vaak komt de taak voor en hoeveel tijd kost het jou of je team? Wat kosten fouten, zoals een verkeerd overgetypte factuur? Een koppeling loont zodra een taak vaak terugkomt en fouten geld of vertrouwen kosten. Komt iets een paar keer per maand voor, dan is handwerk of een kant-en-klare knop vaak voldoende. In welke taken je kunt automatiseren staat een toets die je daarbij helpt.