info@moozlabs.nl

Systemen koppelen

AFAS koppelen en automatiseren

Welk handwerk rond AFAS Profit je kwijt kunt, hoe een koppeling technisch werkt en waar je op let voordat je begint.

Bijgewerkt op 23 oktober 2026Leestijd 8 minDoor Mooz Labs

Kort antwoord

AFAS Profit heeft voor alle klanten een standaard-API. Met GetConnectoren haal je gegevens op, met UpdateConnectoren voeg je gegevens toe, wijzig je ze of verwijder je ze. Een koppeling krijgt toegang via een app connector en een token, en ziet alleen de connectoren die je daar vrijgeeft. Bestaat er een gecertificeerde partnerkoppeling die doet wat je nodig hebt, dan is dat meestal de snelste weg. Wijkt je werkwijze af, of begint het werk met een mail of pdf, dan is een koppeling op maat de oplossing.

Wat kun je automatiseren rond AFAS Profit?

In AFAS Profit staan vaak zowel personeels- als financiële gegevens. Daardoor raakt een koppeling al snel meerdere afdelingen. Veelvoorkomende voorbeelden:

  • Nieuwe medewerkers uit je wervingstool of onboardingformulier als persoon en medewerker in Profit zetten, zodat HR de gegevens niet opnieuw invoert.
  • Personeelsgegevens, zoals afdeling en contracturen, vanuit Profit doorzetten naar je planning of toegangssysteem.
  • Verkooporders uit je webshop of orderportaal in Profit aanmaken, inclusief relatie en artikelen. Zie AFAS koppelen met bol, Amazon of WooCommerce.
  • Relaties en contactpersonen gelijk houden tussen je CRM of website en Profit.
  • Inkoopfacturen die per mail binnenkomen uitlezen en als e-factuur in Profit klaarzetten voor beoordeling.
  • Een melding of vervolgactie starten zodra er een dossieritem bijkomt of een workflow een volgende stap bereikt.
  • Rapportages of overzichten uit Profit automatisch ophalen en mailen.

Hoe werkt een koppeling met AFAS Profit?

AFAS biedt in Profit standaard een API om gegevens uit te wisselen, bereikbaar via REST (JSON) en SOAP (XML). Beide kunnen hetzelfde (AFAS Help Center). De koppeling bestaat uit drie onderdelen.

GetConnectoren: gegevens ophalen

Een GetConnector is een gegevensdefinitie die een AFAS-beheerder zelf samenstelt, bijvoorbeeld "alle actieve medewerkers met afdeling en functie". Een externe applicatie roept die aan en krijgt de rijen terug. Je kunt per verzoek filteren en sorteren, en met skip en take haal je grote sets in stukken op (REST API voor ontwikkelaars). Omdat je de definitie zelf maakt, bepaal je ook welke velden een koppeling te zien krijgt.

UpdateConnectoren: gegevens wegschrijven

Met een UpdateConnector voegt een externe applicatie records toe (POST), wijzigt ze (PUT) of verwijdert ze (DELETE). Welke acties mogelijk zijn, verschilt per connector. Profit controleert elk verzoek eerst met zijn eigen bedrijfsregels en geeft daarna direct antwoord of het gelukt is. De API werkt synchroon: de verbinding blijft open tot Profit klaar is (AFAS Help Center).

App connector en token: de toegang

Om de API te gebruiken voeg je in Profit een app connector toe. Daaraan koppel je een gebruikersgroep, en je geeft er precies aan welke GetConnectoren en UpdateConnectoren gebruikt mogen worden. Andere connectoren zijn via de API niet bereikbaar (App connector toevoegen).

Aanmelden gaat met tokens in plaats van gebruikersnamen en wachtwoorden. Een token is een sleutel voor een combinatie van omgeving, app connector, gebruiker en apparaat. Je maakt hem handmatig aan of laat de externe applicatie hem aanvragen met een eenmalige code per mail (Token genereren). In elk verzoek gaat het token Base64-gecodeerd mee in de header, achter het woord AfasToken. Verder heb je het omgevingsnummer nodig, en er zijn aparte adressen voor productie-, test- en acceptatieomgevingen.

Wat de API niet doet: webhooks en limieten

Profit kan zelf alleen een seintje geven (een webhook) bij dossieritems, reacties daarop en workflowstappen. Voor andere onderdelen kijkt de koppeling op vaste momenten of er iets is veranderd. Dat kan efficiënt door te filteren op de velden "aangemaakt op" en "gewijzigd op", die in bijna alle GetConnectoren beschikbaar zijn (AFAS Help Center).

AFAS noemt ook een aantal grenzen. Een verzoek mag maximaal 75 MB groot zijn, een verbinding krijgt na ongeveer 15 minuten een time-out en een filter in de URL mag niet langer zijn dan 2.048 tekens. Voor het ophalen van gegevens geldt een fair-use policy. Wie elke minuut dezelfde grote dataset ophaalt, kan een belletje van AFAS verwachten. Bij normale volumes merk je hier weinig van, maar een koppeling die duizenden mutaties verwerkt, moet ze in porties ophalen en versturen.

Standaardkoppeling of maatwerk?

Alle koppelingen die AFAS met externe pakketten heeft, staan op partner.afas.nl/koppelingen. Gecertificeerde partnerkoppelingen zijn samen met AFAS ontwikkeld en getest, en de leverancier moet onder meer beveiligingstests uitvoeren. AFAS raadt aan om zo'n koppeling te kiezen als die voor jouw situatie bestaat (Koppelingen met AFAS Profit beheersbaar houden).

Gecertificeerde partnerkoppelingKoppeling op maat
Wat het isEen kant-en-klare koppeling tussen Profit en één bekend pakket.Een koppeling die jouw werkwijze volgt, ook tussen meerdere systemen.
Snel liveJa, na inrichten bij de leverancier.Na bouwen en testen in een testomgeving, meestal enkele weken.
UitzonderingenAlleen wat de koppeling ondersteunt.Jouw regels, bijvoorbeeld per vestiging, contractsoort of klantgroep.
AI erbijMeestal niet.Mogelijk, bijvoorbeeld om mails, formulieren of pdf's uit te lezen.
BeheerDoor de leverancier van het andere pakket.Door de bouwer, met afspraken over monitoring en updates.

Maatwerk is zinvol als je werkwijze afwijkt, als er meer dan twee systemen bij betrokken zijn of als het werk begint met iets wat eerst gelezen moet worden. Denk aan een order die als pdf in de mail zit of een ziekmelding die via een formulier binnenkomt.

Waar AI het verschil maakt

Een gewone koppeling verplaatst gegevens die al netjes in een systeem staan. Veel werk rond AFAS begint met een mail, een pdf of een formulier in vrije tekst. Daar komt AI-automatisering in beeld: een AI-model leest het bericht, haalt de juiste gegevens eruit en zet die via een UpdateConnector in Profit. Bij twijfel, zoals een onbekende relatie of een ontbrekend ordernummer, gaat het naar een mens.

Voor inkoopfacturen heeft Profit zelf al veel aan boord. Profit leest UBL-facturen direct in, en voor pdf-facturen zonder UBL-bestand is er de ingebouwde Scan & herken-functie (E-factuur (inkoopfactuur)). Een externe applicatie kan e-facturen aanleveren via de UpdateConnector FiElectronicInvoicePurchase. Hoe je factuurverwerking verder automatiseert, lees je in Inkoopfacturen automatisch verwerken met AI.

Eén kanttekening voor HR: laat AI geen sollicitanten selecteren of afwijzen. Een systeem dat cv's automatisch selecteert, valt onder de AI Act in de categorie hoog risico, met strenge eisen vanaf 2 december 2027. Gegevens van een aangenomen kandidaat in Profit zetten is iets anders. Zie AI Act en AVG voor het mkb.

Waar je op let voordat je begint

AFAS geeft zelf een aantal adviezen om koppelingen beheersbaar te houden (AFAS Help Center). De belangrijkste voor een mkb-bedrijf:

  • Maak per koppeling een aparte app connector met een eigen gebruiker en gebruikersgroep. Zo bepaal je per koppeling welke gegevens toegankelijk zijn, en zet je er één uit zonder de rest te raken.
  • Neem in een GetConnector alleen de velden op die de koppeling echt nodig heeft. Salaris- en persoonsgegevens horen niet in een koppeling met je planningstool als die ze niet gebruikt.
  • Stel IP-restricties in als de koppelende partij een vast IP-adres heeft.
  • Ga zorgvuldig om met tokens. Na het aanmaken is de waarde niet meer op te vragen, je kunt een geldigheidsduur instellen en een token deel je nooit via mail of een gedeeld document.
  • Houd een overzicht bij van alle koppelingen: met welk systeem, via welke app connector, wie de eigenaar is en wanneer er voor het laatst naar is gekeken.
  • Bouw en test in een test- of acceptatieomgeving. Een UpdateConnector die in productie verkeerde gegevens wegschrijft, ruim je met de hand weer op.
  • Leg vast welk systeem leidend is. Anders overschrijven Profit en je CRM elkaars wijzigingen.

Verwerkt de koppeling persoonsgegevens, en bij HR is dat vrijwel altijd zo, dan hoort er een verwerkersovereenkomst bij met de partij die de koppeling bouwt of beheert.

Veelgestelde vragen

Heeft AFAS Profit een API?

Ja. AFAS biedt in Profit voor alle klanten een standaard-API, via REST (JSON) of SOAP (XML). Gegevens ophalen gaat met GetConnectoren, toevoegen, wijzigen en verwijderen met UpdateConnectoren. Toegang regel je met een app connector en een token.

Wat is het verschil tussen een GetConnector en een UpdateConnector?

Een GetConnector haalt gegevens uit Profit op volgens een definitie die je zelf maakt, bijvoorbeeld een lijst medewerkers of openstaande facturen. Een UpdateConnector schrijft gegevens naar Profit, zoals een nieuwe relatie, order of e-factuur. Profit controleert die berichten op geldigheid voordat ze worden verwerkt.

Heeft AFAS webhooks?

Alleen voor dossieritems, reacties op dossieritems en workflowstappen. Voor andere wijzigingen controleert een koppeling op vaste momenten of er iets nieuw of gewijzigd is, met een filter op de velden "aangemaakt op" en "gewijzigd op".

Kan ik AFAS koppelen met n8n, Make of Zapier?

Ja, mits de tool een HTTP-verzoek met een eigen header kan versturen, want de REST API werkt met een token in de header. Let wel op waar de gegevens doorheen gaan. In Systemen koppelen: n8n, Make of Zapier? lees je hoe de tools verschillen.

Geldt dit ook voor AFAS SB?

Nee, dit artikel gaat over AFAS Profit. AFAS SB heeft een eigen REST API met andere endpoints en een eigen route voor partnerkoppelingen. Die staat beschreven in het AFAS Help Center voor SB.

Wat kost een AFAS-koppeling op maat?

Dat hangt af van het aantal systemen, de uitzonderingen en het volume. Lees Wat kost AI-automatisering? voor de factoren, of reken met de Quick Scan uit wat het je oplevert.

Bronnen

Mus, oprichter van Mooz Labs

Welk werk kost je te veel tijd of blijft liggen? Binnen één werkdag hoor je of we kunnen helpen.

Doe eerst de Quick Scan als je wilt weten wat het waard is, of plan meteen een gesprek van dertig minuten.

  • Kennismaking is gratis
  • Geen verplichtingen
  • Je praat met degene die het bouwt