Diensten

API-koppelingen laten maken

Gegevens die twee keer worden ingevoerd, lijstjes die uit de pas lopen, processen die wachten op handwerk? Codivo bouwt API-koppelingen tussen je website, ERP, CRM, boekhouding en andere software. Betrouwbaar, met foutafhandeling en logging.

Wanneer een API-koppeling loont

Een API-koppeling laat twee systemen automatisch gegevens uitwisselen. Een API (Application Programming Interface) is de ingang die software daarvoor beschikbaar stelt. Dat klinkt technisch, maar het resultaat is simpel: wat in het ene systeem verandert, staat zonder handwerk ook in het andere.

Een koppeling loont vooral als je dit herkent:

  • Medewerkers voeren dezelfde gegevens in twee of meer systemen in.

  • Er gaan Excel-lijsten of exports heen en weer tussen afdelingen.

  • Er ontstaan fouten door overtypen of kopiëren en plakken.

  • Informatie loopt achter, omdat iemand het eerst moet bijwerken.

  • Een proces staat stil tot iemand een handeling uitvoert.

Een voorbeeld: bij Kleinkunstig gaan goedgekeurde facturen van docenten automatisch in batch naar Snelstart. Wat vroeger per factuur handwerk was, gebeurt nu op de achtergrond.

Systemen waarmee we koppelen

Een greep uit de systemen waarmee Codivo koppelingen heeft gebouwd. Staat jouw pakket er niet tussen? Als het een API heeft, kunnen we er meestal mee verbinden.

Realtime, periodiek of op een seintje

Niet elke koppeling werkt hetzelfde. Welke vorm past, hangt af van hoe actueel de gegevens moeten zijn en om hoeveel gegevens het gaat.

Vorm

Hoe het werkt

Voorbeeld

Realtime

Het ene systeem vraagt gegevens op, of stuurt ze door, op het moment dat het nodig is.

Het docentenportaal van Kleinkunstig leest en schrijft direct in het ERP.

Periodiek

Op vaste momenten worden wijzigingen in één keer verwerkt, op de achtergrond.

Goedgekeurde facturen gaan in batch naar Snelstart; marketingdata wordt periodiek bijgewerkt in ActiveCampaign.

Op een seintje (webhook)

Het andere systeem meldt zelf dat er iets is gebeurd, waarna de koppeling in actie komt.

Een betaalprovider meldt dat een betaling is gelukt, en de bestelling wordt direct verwerkt.

Vaak is het een combinatie. Periodiek synchroniseren heeft als voordeel dat je website of platform er niet trager van wordt. Daarom is de ActiveCampaign-koppeling van Kindertheater bijvoorbeeld zo opgezet.

Koppelingen die blijven werken

Een koppeling bouwen is één ding. Zorgen dat hij over twee jaar nog steeds goed werkt, is het echte werk. Daar letten we op:

  • Foutafhandeling die niet stilletjes faalt. Gaat er iets mis, dan wordt het opnieuw geprobeerd of krijgt iemand een melding.

  • Logging. Achteraf is altijd te achterhalen wat er wanneer is uitgewisseld, en waarom iets niet doorkwam.

  • Achtergrondprocessen. Zware of tijdrovende taken draaien op de achtergrond (bijvoorbeeld met Hangfire), zodat gebruikers er niets van merken.

  • Bestand tegen storingen. Is een systeem even niet bereikbaar, dan wacht de koppeling en pakt hij het later weer op.

  • Duidelijke afspraken over de bron. Per gegeven ligt vast welk systeem leidend is, zodat systemen elkaars gegevens niet overschrijven.

  • Testen voor livegang. Een koppeling testen we met testdata op een aparte omgeving, ook in de situaties waarin iets misgaat.

Koppelingen in Umbraco

Veel Umbraco-vraagstukken zijn eigenlijk koppelingsvraagstukken. Een Umbraco-website staat zelden op zichzelf: formulieren moeten naar het CRM of de e-mailmarketing, productgegevens komen uit het ERP, en de zoekfunctie moet door grote hoeveelheden content kunnen.

Bij Kindertheater is het Umbraco-platform gekoppeld aan ActiveCampaign en Google Agenda. Artiesten koppelen hun agenda, zodat organisatoren direct zien wanneer ze beschikbaar zijn.

Omdat Umbraco op .NET draait, kunnen website en koppelingen in één codebase leven, met één deployment en één plek voor monitoring. Meer over Umbraco-ontwikkeling bij Codivo.

agenda-image-case-kindertheater.png
Google Agenda-koppeling op het platform van Kindertheater

Koppelingen in de praktijk

  • Kleinkunstig: het ERP gekoppeld aan een docentenportaal voor ruim 300 docenten, aan Snelstart voor de uitbetaling en aan ActiveCampaign voor marketing rond evenementen.

  • Kindertheater: een Umbraco-platform gekoppeld aan ActiveCampaign, via een aparte synchronisatie, en aan Google Agenda voor de beschikbaarheid van artiesten.

  • Gearbooker: een koppeling met ElasticSearch voor zoeken en filteren, met het aantal resultaten per categorie vooraf zichtbaar.

  • Novaware: voor dit digitale bureau integraties met onder andere Dynamics 365 binnen Umbraco-projecten.

Werkwijze

Zo pakken we een koppeling aan

  1. Stap 01

    Inventarisatie

    Welke gegevens moeten waarheen, hoe vaak, en welk systeem is leidend? We bekijken ook de API's zelf: wat kan er wel en wat niet.

  2. Stap 02

    Bouwen en testen

    We bouwen de koppeling en testen hem met testdata op een aparte omgeving, inclusief de situaties waarin iets misgaat.

  3. Stap 03

    Livegang

    We gaan live op een rustig moment, met extra monitoring in de eerste periode.

  4. Stap 04

    Beheer

    API's van leveranciers veranderen. We houden de koppeling bij, zodat hij blijft werken.

Veelgestelde vragen over API-koppelingen

Een API-koppeling is een verbinding tussen twee softwaresystemen die automatisch gegevens uitwisselen via hun API: de digitale ingang die een systeem daarvoor aanbiedt. Zo hoeft niemand gegevens meer over te typen.

Dat hangt af van de hoeveelheid gegevens, of de koppeling één of twee kanten op werkt, hoe goed de API's gedocumenteerd zijn en hoeveel foutafhandeling nodig is. Een eenvoudige koppeling in één richting is minder werk dan een synchronisatie tussen meerdere systemen. Na een korte inventarisatie krijg je een concrete inschatting.

Dan zijn er vaak andere ingangen, zoals een geautomatiseerde uitwisseling van bestanden of, als dat veilig kan, rechtstreeks via de database. Dat bekijken we per systeem.

Ja, als beide systemen dat ondersteunen. Soms is periodiek synchroniseren beter, bijvoorbeeld om je website niet te belasten. We kiezen per koppeling wat past.

Dan probeert de koppeling het later opnieuw, en wordt vastgelegd wat er is gebeurd. Blijft het misgaan, dan volgt een melding. Zo raken er geen gegevens ongemerkt kwijt.

Ja. Elk traject begint met een inventarisatie van wat er ligt. Daarna weet je of de koppeling verbeterd kan worden of beter opnieuw gebouwd wordt.

Dat kunnen wij doen. API's van leveranciers veranderen af en toe; met beheer houden we de koppeling up-to-date en grijpen we in als er iets misgaat.

Ja. Koppelingen met CRM, ERP, e-mailmarketing en zoekdiensten zijn bij Umbraco-websites heel gebruikelijk. Lees meer bij Umbraco specialist.

Volgende stap

Een koppeling laten maken?

Vertel welke systemen met elkaar moeten praten. Dan kijken we samen naar de beste aanpak.