AFAS koppeling maken: wat automatiseer je met de AFAS API?

Wat is een AFAS koppeling?

AFAS Profit is bedrijfssoftware voor onder meer financiën, CRM, ordermanagement, projecten en HRM. Een API is een vaste ingang waarlangs software gegevens uitwisselt met andere software. Een koppeling is een automatisering die via die ingang werkt.

Volgens AFAS zit er standaard in Profit voor alle klanten een API om gegevens uit te wisselen. Die werkt via REST (met JSON) of via SOAP (met XML) (help.afas.nl, REST API voor ontwikkelaars, gecontroleerd op 31 oktober 2026). Voor nieuwe koppelingen kies ik REST, omdat n8n en de meeste andere tools daar direct mee werken.

Hoe werkt de AFAS API?

AFAS noemt elk endpoint van de API een connector. Er zijn verschillende soorten, elk met een eigen taak (help.afas.nl, Connector, gecontroleerd op 31 oktober 2026):

Een paar spelregels uit de documentatie die je bij het bouwen tegenkomt:

• Het token gaat Base64-gecodeerd in de header, voorafgegaan door "AfasToken".
• Elke aanroep moet via TLS 1.2 lopen.
• Zonder de parameters skip en take krijg je alleen de eerste 100 regels terug.
• Eén aanroep mag maximaal 75 MB groot zijn.
• Het endpoint metainfo laat zien welke Get- en UpdateConnectors beschikbaar zijn. Handig om te testen of je token klopt.

Bron: help.afas.nl en GetConnector (REST/JSON), gecontroleerd op 31 oktober 2026. De technische referentie per endpoint staat op docs.afas.help.

Wat kun je automatiseren met een AFAS koppeling?

AFAS heeft een lange lijst UpdateConnectors. Dit zijn er een paar die vaak terugkomen bij automatisering (help.afas.nl, UpdateConnector beschrijvingen, gecontroleerd op 31 oktober 2026):

Met GetConnectors werkt het andersom. Je beheerder stelt een GetConnector samen, bijvoorbeeld met openstaande facturen of nieuwe medewerkers, en een workflow haalt die gegevens op om er iets mee te doen: een herinnering sturen, een account aanmaken in een ander systeem, of een overzicht in Teams of Slack zetten.

Kun je een AFAS workflow automatisch laten doorzetten?

Ja, via dossieritems. In Profit lopen veel workflows via dossieritems, zoals een goedkeuring of een aanvraag. AFAS heeft daar drie UpdateConnectors voor:

• KnSubject voegt dossieritems toe, wijzigt ze of verwijdert ze.
• KnSubjectReaction plaatst een reactie bij een dossieritem.
• KnSubjectWorkflowReaction plaatst een reactie of zet het dossieritem door in de workflow.

Een voorbeeld van hoe dat samenkomt: AI leest een binnenkomende mail, herkent de relatie en maakt een dossieritem met de bijlage. Een collega beoordeelt het in AFAS. Een workflow in n8n kijkt op vaste tijden via een GetConnector welke items zijn goedgekeurd en zet de volgende stap in gang.

Hoe bouw je een AFAS koppeling met n8n of maatwerk?

1. Maak een app connector aanJe AFAS-beheerder kiest welke Get- en UpdateConnectors de koppeling mag gebruiken. Met "Automatisch token genereren" maakt Profit de gebruikersgroep, de gebruiker en het token in één keer aan (help.afas.nl).
2. Bewaar het token veiligIn n8n zet je het token in een credential, zodat het niet zichtbaar in de workflow staat.
3. Test eerst in een testomgevingAFAS heeft aparte adressen voor productie, test en accept. Zo kun je bouwen zonder je echte administratie te raken.
4. Laat de koppeling eerst alleen lezenBegin met GetConnectors en vergelijk de uitkomst met wat je team nu doet. Pas daarna komt schrijven met UpdateConnectors.
5. Zorg voor bewakingDe koppeling meldt zich zelf als een aanroep mislukt, zodat een fout niet stil blijft.

In n8n gebruik je de node HTTP Request om de AFAS-API aan te spreken, met het token in de header. Voor grotere lijsten bouw je een lus met skip en take. Met de Code-node zet je gegevens om naar het formaat dat de UpdateConnector verwacht. Wat n8n precies is, lees je in Wat is n8n?

Maatwerk buiten n8n kies ik als het volume heel hoog is of als de logica beter in eigen code past. Meestal is n8n met een paar Code-nodes genoeg. De afweging staat in n8n, Zapier of maatwerk.

Hoe werkt een Exact Online koppeling?

Exact Online heeft een REST API met een openbare lijst van onderdelen. Onder meer SalesInvoices (verkoopfacturen), SalesOrders (verkooporders), Accounts (relaties), PurchaseEntries (inkoopboekingen) en Items (artikelen) kun je ophalen, aanmaken, wijzigen en verwijderen. Bij deze onderdelen geeft Exact ook aan dat er een webhook beschikbaar is, zodat een workflow een seintje krijgt bij een wijziging (Exact Online REST API resources, gecontroleerd op 31 oktober 2026).

Toegang loopt via OAuth 2.0: je geeft een app toestemming zonder je wachtwoord te delen. In n8n werkt dat ook via de node HTTP Request.

Hoe je Exact Online, SnelStart en Yuki koppelt voor factuurverwerking, lees je in Je boekhoudpakket koppelen.

Waarom laat je een koppeling eerst alleen lezen?

Omdat je dan zonder risico ziet of het klopt. Bij Autobedrijf Zieleman werkt de boekhouding in SnelStart. Het systeem dat ik bouwde leest de inkoopfacturen uit Outlook en bepaalt per regel de grootboekrekening en de btw. Het vergelijkt de uitkomst met SnelStart, zonder daar iets te wijzigen. 80 van de 80 facturen werden geboekt zoals de boekhouder het zelf deed. Dezelfde aanpak gebruik ik bij elk pakket: eerst lezen en vergelijken, dan pas schrijven.

Gaan er persoonsgegevens door de koppeling, zoals in HRM, kijk dan ook waar je workflows draaien. Dat lees je in n8n en de AVG.

Wil je weten wat er met jouw AFAS- of Exact-omgeving kan? Op de pagina n8n-specialist lees je hoe ik werk voor kmo's en mkb-bedrijven in Vlaanderen en Nederland. Bouwen kost vanaf €1.500 eenmalig, beheer vanaf €150 per maand, excl. btw. Stuur me een WhatsApp met wat je wilt koppelen, of plan een gratis videocall.

Veelgestelde vragen

Heeft AFAS een API?

Ja. Volgens AFAS zit er standaard in Profit voor alle klanten een API om gegevens uit te wisselen, via REST (JSON) of SOAP (XML). Je regelt de toegang met een app connector en een token.

Wat is het verschil tussen een GetConnector en een UpdateConnector?

Een GetConnector haalt gegevens op uit AFAS Profit, met de velden die je beheerder heeft gekozen. Een UpdateConnector voegt records toe, wijzigt ze of verwijdert ze, zoals verkooprelaties (KnSalesRelationOrg), orders (FbSales) of financiële mutaties (FiEntries).

Kan n8n koppelen met AFAS?

Ja. In n8n spreek je de AFAS-API aan met de node HTTP Request, met het token van de app connector in de header. Zo lees je GetConnectors uit en schrijf je via UpdateConnectors terug.

Kan ik een AFAS workflow automatisch doorzetten?

Ja, via de UpdateConnector KnSubjectWorkflowReaction. Daarmee plaats je een reactie bij een dossieritem of zet je het door in de workflow. Nieuwe dossieritems maak je aan met KnSubject.

Wat kost een AFAS koppeling laten bouwen?

Een koppeling op maat begint bij €1.500 eenmalig, plus vanaf €150 per maand voor hosting, bewaking en onderhoud, excl. btw. Kosten van je AFAS-licentie of van n8n betaal je rechtstreeks aan die leveranciers.

Jurgen Claassens bouwt AI-automatiseringen voor ondernemers, mkb en kmo. Vijftien jaar operations bij Vattenfall, daarna mede-eigenaar van sales- en marketingbureaus. Meer over Jurgen of bekijk zijn projecten.