AFAS-koppelingen
AFAS API en connectoren: hoe werkt een koppeling met AFAS?
Een koppeling met AFAS loopt via een app connector: met GetConnectoren haal je gegevens op en met UpdateConnectoren schrijf je gegevens weg.
Je CRM, je webshop of je planningssysteem moet met AFAS praten. De leverancier zegt dat het via de API kan. Maar wat moet je daarvoor in AFAS regelen, wat mag zo'n koppeling wel en niet, en wie let op als hij stilvalt?
Op deze pagina lees je hoe de AFAS API in elkaar zit, welke grenzen AFAS stelt en wanneer je een koppeling zelf bouwt of als beheerde Flow afneemt.
In het kort
Het probleem. Systemen rond AFAS wisselen gegevens uit via exports, overtypen of een koppeling die niemand meer beheert.
De uitkomst. Een koppeling die via de officiële AFAS API loopt, met een duidelijke eigenaar, bewaking en een afgesproken reactie op fouten.
Zo werkt het
- Maak in AFAS een app connector aan en bepaal welke connectoren erin zitten.
- Haal gegevens op met GetConnectoren en schrijf weg met UpdateConnectoren.
- Laat een webhook melden dat er iets is gewijzigd.
- Bewaak de koppeling: tokens, fouten en limieten.
Doe de gratis Flow Check30 minuten, gratis en vrijblijvend
Bijgewerkt op
Inhoudsopgave
Op deze pagina behandelen we de volgende onderwerpen:
Bijna elke koppeling met AFAS gebruikt dezelfde bouwstenen. Wie die kent, kan een leverancier de goede vragen stellen.
Hoe zit de AFAS API in elkaar?
De toegang voor een externe applicatie regel je in AFAS met een app connector. Daarin leg je vast welke connectoren de applicatie mag gebruiken en hoe hij zich aanmeldt. Een applicatie kan alleen de connectoren aanroepen die in zijn app connector zijn geactiveerd.
| Bouwsteen | Wat het doet | Voorbeeld | Let op |
|---|---|---|---|
| GetConnector | Gegevens ophalen uit AFAS | Medewerkers ophalen voor een planningssysteem | Haal alleen gewijzigde gegevens op, in delen |
| UpdateConnector | Gegevens toevoegen, wijzigen of verwijderen in AFAS | Een nieuwe relatie uit het CRM in AFAS zetten | AFAS valideert het bericht; wat niet voldoet, wordt geweigerd |
| Webhook | Melden dat er iets is gewijzigd | Een seintje bij een gewijzigd dossieritem | De melding zegt niet wat er is gewijzigd; dat haal je daarna op met een GetConnector |
Dat laatste is een veelgemaakte denkfout. Een webhook is een bel, geen pakketje. De koppeling moet na de bel zelf ophalen wat er is veranderd.
Wat verandert er met OAuth?
AFAS ondersteunt OAuth met twee methoden: één voor verkeer tussen systemen onderling en één voor portalen waar een gebruiker inlogt. Een toegangstoken is daarbij een uur geldig. De applicatie vraagt dus steeds zelf een nieuw token aan.
De klassieke tokens verdwijnen. Volgens het AFAS Help Center krijgen bestaande klassieke tokens een einddatum in 2027 en zijn klassieke app connectoren na 31 augustus 2027 niet meer te gebruiken. Het authenticatietype van een bestaande app connector is niet te wijzigen. Overstappen betekent dus: een nieuwe app connector aanmaken en de koppeling daarop aansluiten.
Heb je koppelingen die al jaren draaien? Zet dan nu op een rij welke nog op een klassiek token leunen en wie de leverancier is.
Welke grenzen stelt AFAS aan de API?
AFAS publiceert geen vast aantal aanroepen per minuut. Er gelden wel grenzen die het ontwerp van een koppeling bepalen:
- Fair use. Wie steeds opnieuw dezelfde grote dataset ophaalt, krijgt daar bericht over.
- Omvang. Een aanroep is maximaal 75 MB groot.
- Tegelijk. Er zijn maximaal zes parallelle aanroepen toegestaan.
- In delen. Grote sets haal je in stukken op, altijd met een sortering.
- Alleen wijzigingen. Door te filteren op aangemaakt op en gewijzigd op haal je alleen op wat veranderd is.
Een koppeling die elke minuut alles ophaalt, loopt vast. Een koppeling die alleen wijzigingen ophaalt, groeit mee met je organisatie.
Zelf bouwen of een beheerde Flow?
Een koppeling bouwen is het halve werk. De andere helft is beheer: een token dat verloopt, een veld dat verandert na een update, een fout die niemand ziet tot de cijfers niet meer kloppen.
| Vraag | Zelf bouwen | Beheerde Flow |
|---|---|---|
| Wie ziet het als de koppeling stilvalt? | Dat moet je zelf inrichten | Beheer, monitoring en updates horen erbij |
| Wie past aan na een AFAS-update? | Je eigen ontwikkelaar of leverancier | One Value, als onderdeel van het beheer |
| Wat kost het? | Bouwkosten, en daarna eigen beheer | Een Flow uit de bibliotheek heeft een vast maandbedrag; maatwerk in overleg |
Staat jouw koppeling niet in de Flowbibliotheek, dan is FlowPRO de route: maatwerk in drie stappen. Lees meer bij Flow Service.
Voorbeeld: AFAS koppelen met je CRM
De Flow AFAS HubSpot koppeling synchroniseert de afgesproken velden tussen AFAS en HubSpot, logt wijzigingen en lost conflicten op volgens jouw regels. Per veld leg je vast welk systeem de eigenaar is. Zo blijft voorspelbaar welke bron wint als twee systemen iets anders zeggen.
Hetzelfde principe geldt voor andere koppelingen, zoals de AFAS Recruitmentkoppeling: eerst vastleggen welke gegevens overgaan en waar een mens beslist, dan pas bouwen.
Zo maak je het resultaat meetbaar
Leg in de Flow Check een nulmeting vast, zodat je na livegang kunt vergelijken met dezelfde definities. Dit zijn de meetpunten die hier het meest zeggen:
| Meetpunt | Wat het laat zien |
|---|---|
| Aantal handmatige exports en imports per week | Hoeveel overtypwerk de koppeling vervangt |
| Aantal mislukte aanroepen per maand en de tijd tot herstel | Hoe betrouwbaar de koppeling is |
| Aantal records dat in beide systemen verschilt | Of de gegevens echt gelijk lopen |
| Aantal koppelingen dat nog een klassiek token gebruikt | Hoeveel werk de overstap naar OAuth nog vraagt |
Begin met de koppeling die het meeste handwerk of de meeste fouten veroorzaakt, niet met de technisch interessantste.
Waar begin je?
Maak een lijst van alle koppelingen rond AFAS. Noteer per koppeling welk systeem het is, welke app connector hij gebruikt, welk type token, en wie de eigenaar is. In de meeste organisaties bestaat die lijst niet. Hij is wel het begin van elke verbetering, en je hebt hem ook nodig voor de overstap naar OAuth.
Verdieping: de technische inrichting
Elke aanroep gaat naar de REST-service van je eigen AFAS-omgeving. Welke connectoren beschikbaar zijn en welke velden ze hebben, vraag je op via de meta-informatie van de omgeving. Speciale tekens verstuur je in UTF-8. Bij OAuth meldt de applicatie zich aan met een client-ID en een secret en krijgt een toegangstoken dat een uur geldig is. Webhooks stel je in per app connector en vragen een HTTPS-adres dat bereikbaar is.
Welke connectoren jouw omgeving heeft, welke rechten de app connector nodig heeft en hoe compleet de gegevens zijn, onderzoeken we in de Flow Check. Na livegang blijft de Flow onderhouden via Flow Service.
De uitleg op deze pagina is gebaseerd op de documentatie van AFAS, stand oktober 2026. AFAS werkt de software regelmatig bij. Controleer details en data in het AFAS Help Center.
Gratis Flow Check · 30 minuten
Weet welke koppelingen je echt nodig hebt
Doe de gratis Flow Check. In 30 minuten kijken we samen naar een koppeling rond je AFAS-omgeving. Je ontvangt het belangrijkste knelpunt, de Flow die past en een indicatie van de koppelingen die nodig zijn.
Veelgestelde vragen
Wat is het verschil tussen een GetConnector en een UpdateConnector?
Met een GetConnector haal je gegevens op uit AFAS. Met een UpdateConnector voeg je gegevens toe, wijzig je ze of verwijder je ze. Een koppeling die twee kanten op werkt, gebruikt ze allebei.
Wat is een app connector in AFAS?
Een app connector is de toegang voor een externe applicatie. Je legt erin vast welke connectoren de applicatie mag gebruiken en hoe hij zich aanmeldt. Een applicatie kan alleen de connectoren aanroepen die in zijn app connector zijn geactiveerd.
Heeft de AFAS API een limiet?
AFAS publiceert geen vast aantal aanroepen per minuut, maar hanteert fair use. Daarnaast is een aanroep maximaal 75 MB groot en zijn er maximaal zes parallelle aanroepen toegestaan. Haal daarom alleen gewijzigde gegevens op, in delen.
Wat doet een webhook in AFAS?
Een webhook meldt aan een ander systeem dat er iets is gewijzigd. De melding zegt niet wat er is gewijzigd. De koppeling haalt de gegevens daarna zelf op met een GetConnector.
Moet ik overstappen van een klassiek token naar OAuth?
Ja, op termijn. Volgens het AFAS Help Center krijgen bestaande klassieke tokens een einddatum in 2027 en zijn klassieke app connectoren na 31 augustus 2027 niet meer te gebruiken. Controleer de actuele data in het Help Center.
Kan elke applicatie met AFAS koppelen?
Technisch kan elke applicatie die met de REST-service van AFAS kan werken een koppeling maken. Of het voor jouw proces werkt, hangt af van de beschikbare connectoren, de rechten en de kwaliteit van de gegevens. Dat onderzoeken we in de Flow Check.