AFAS-koppeling: hoe werkt de API van AFAS Profit?
Een AFAS-koppeling loopt via de eigen API van AFAS Profit. De koppeling haalt gegevens op met een GetConnector en schrijft ze terug met een UpdateConnector. Toegang loopt via een app connector met een token van je AFAS-beheerder. Kijk eerst of er al een gecertificeerde koppeling bestaat. Voor een eenvoudige koppeling op maat reken ik € 640 tot € 2.400.
Lútsen MuurlingGecontroleerd door Lútsen Muurling op Bijgewerkt op 5 min lezen
Kerncijfers
- 75 MBMaximale grootte van één aanroep naar de API van AFAS, voor REST en SOAP.Bron: AFAS Help Center, REST API voor ontwikkelaars
- 15 minutenNa ongeveer een kwartier krijgt een verbinding met AFAS Online een time-out. Veel gegevens haal je daarom in delen op.Bron: AFAS Help Center, GetConnector (REST/JSON)
- 150.000AFAS adviseert: aantal kolommen keer aantal regels per aanroep onder de 150.000 houden, om geheugenfouten te voorkomen.Bron: AFAS Help Center, GetConnector (REST/JSON)
AFAS Profit regelt bij veel bedrijven de administratie, het personeel en de relaties. Maar orders, uren of aanvragen komen vaak uit andere software, en dan begint het overtypen. AFAS heeft daarvoor een eigen API: een vaste ingang waarlangs andere programma’s gegevens uitwisselen met AFAS.
Wat kun je aan AFAS koppelen?
Bijna alles wat met relaties, geld, uren of personeel te maken heeft. Een paar voorbeelden:
- Webshop of orderportaal. Een bestelling wordt een verkooporder in AFAS.
- Website en CRM. Een aanvraag van je site komt als relatie of taak in AFAS, in plaats van in een mailbox.
- Planning en uren. Uren uit een planningspakket gaan naar projecten en facturen in AFAS. Welk planningspakket bij een installatiebedrijf past, lees je in planningssoftware voor een installatiebedrijf.
- Personeel. Een nieuwe medewerker in AFAS krijgt automatisch een account in andere systemen.
- Dashboards. Cijfers uit AFAS op één scherm met cijfers uit andere systemen. Zie dashboard laten maken.
Hoe werkt de API van AFAS?
AFAS noemt de onderdelen connectoren. Er zijn er twee die je moet kennen:
- GetConnector: haalt gegevens op uit AFAS, zoals relaties of artikelen.
- UpdateConnector: zet gegevens in AFAS: toevoegen, wijzigen of verwijderen. Een verkooporder plaatsen gaat bijvoorbeeld via een UpdateConnector.
Daarboven zit de app connector. Die bepaalt welke connectoren een koppeling mag gebruiken; andere zijn via de API niet bereikbaar. Aan de app connector hangt een gebruikersgroep, en alleen leden van die groep kunnen hem aanroepen. Wie een koppeling bouwt, krijgt een token: een lange sleutel die hoort bij jouw omgeving, die app connector en die gebruiker. Je kunt hem ook altijd weer intrekken. AFAS raadt aan om per extern programma een eigen app connector te maken.
De API werkt met JSON (REST) of XML (SOAP). Naast de gewone omgeving zijn er aparte adressen voor een test- en een acceptatieomgeving. Er gelden een paar grenzen: één aanroep mag maximaal 75 MB zijn, en een verbinding met AFAS Online krijgt na ongeveer 15 minuten een time-out. Veel gegevens haal je daarom in delen op, met filters. Hoe een API-koppeling in het algemeen werkt, lees je in API-koppeling.
Bestaat er al een koppeling voor jouw pakket?
Kijk dat altijd eerst na. AFAS heeft een Partner en Expertnetwerk, op partner.afas.nl. Daar staan aanvullende producten en koppelingen van andere bedrijven, en je ziet of ze gecertificeerd zijn. Kijk ook in de lijst met koppelingen van je andere pakket: daar staat AFAS soms al bij.
Een bestaande koppeling is snel klaar en de maker houdt hem bij. Het nadeel is hetzelfde als bij elk standaardpakket: hij doet wat hij doet. Wijkt je werkwijze af, dan pas jij je aan, of zet je de uitzonderingen met de hand recht. Hoe je die afweging maakt, lees je in maatwerk of standaardsoftware.
| Bestaande koppeling | Koppeling op maat | |
|---|---|---|
| Kosten | verschilt per maker, vaak een abonnement per maand | eenmalig bouwen tegen € 80 per uur: een eenvoudige koppeling 8 tot 30 uur (€ 640 tot € 2.400), met eigen regels of veel velden 30 tot 80 uur (€ 2.400 tot € 6.400), plus onderhoud vanaf € 49 per maand |
| Past op jouw proces | als je proces standaard is | ja |
| Onderhoud bij wijzigingen | de maker | de bouwer, met afspraken vooraf |
Bedragen excl. btw. Je krijgt vooraf een raming in uren. Voor Exact Online staat dezelfde afweging uitgewerkt in koppeling met Exact Online. Een volledig prijsoverzicht staat in wat kost software op maat.
Wat regel je vooraf bij een koppeling op maat?
- Een eigen app connector en token. Niet iemands persoonlijke inlog. De beheerder van je AFAS-omgeving maakt ze aan en kan ze intrekken.
- Alleen de connectoren die nodig zijn. Een koppeling die orders plaatst, hoeft geen salarisgegevens te kunnen lezen.
- Wie bij jou de eigenaar is. Eén vaste persoon die meldingen krijgt en beslist bij twijfel.
- Een beschrijving van hoe het nu gaat, inclusief de uitzonderingen. Daar zit altijd het meeste werk.
- Een paar echte voorbeelden van de gegevens, en een testomgeving als die er is.
- Wie is leidend? Als een adres in AFAS én in je CRM gewijzigd kan worden, welke wint dan? Spreek het per soort gegeven af.
Doe het even: vraag de beheerder van je AFAS-omgeving welke app connectoren er nu al zijn, en voor welk programma. Staan er oude bij die niemand meer gebruikt, dan mogen die weg.
Waar gaat het vaak mis?
- Te veel tegelijk ophalen. Alles in één keer opvragen loopt tegen de time-out of geheugenfouten aan. AFAS adviseert altijd filters te gebruiken en grote hoeveelheden in delen op te halen.
- Dubbele relaties. De koppeling herkent een klant niet en maakt een nieuwe aan. Spreek vooraf af waarop je een relatie herkent, bijvoorbeeld een klantnummer.
- Een koppeling op naam van één medewerker. Gaat die persoon weg en wordt zijn account opgeruimd, dan stopt de koppeling.
- Niemand merkt dat het stopt. Zonder logboek en meldingen zie je pas weken later dat er orders ontbreken.
Hoe ik koppelingen bouw en onderhoud, lees je bij software en automatisering.
Mijn advies
Als je proces standaard is, neem je een bestaande koppeling. Dan heeft iemand anders hem al gebouwd en houdt hij hem bij als AFAS iets verandert. Maatwerk wordt interessant als je eigen regels hebt die geen koppeling kent, als er drie of meer systemen in het spel zijn, of als je eigen software hebt. Ik kijk dus altijd eerst wat er al bestaat, en laat de toegang op naam van jouw bedrijf zetten.
Eigenaar van Onrust Media
Ik werkte als vormgever en marketeer, ook in de makelaardij, en help nu als zelfstandige mkb-bedrijven met marketing, vormgeving, websites en software. Elk artikel in de kennisbank controleer ik zelf en houd ik bij.
Veelgestelde vragen
Kan ik een koppeling met AFAS eerst testen?
Vaak wel. AFAS heeft aparte adressen voor een test- en een acceptatieomgeving, naast de productieomgeving. Vraag je beheerder of jouw omgeving er een heeft. Een demo-omgeving is volgens AFAS alleen beschikbaar voor klanten met een licentie. Een externe bouwer krijgt toegang via jou als klant, of via het partnerprogramma van AFAS.
Werkt een koppeling met AFAS direct, of met vertraging?
De API van AFAS reageert direct op een vraag, maar meldt zelf bijna niets uit eigen beweging. Webhooks, seintjes bij een wijziging, zijn er volgens AFAS alleen voor dossieritems en workflows. Voor de rest kijkt een koppeling op vaste momenten of er iets veranderd is, bijvoorbeeld elke paar minuten.
Moet ik mijn eigen inlog van AFAS aan de bouwer geven?
Nee. De koppeling krijgt een eigen token via een app connector, gekoppeld aan een gebruikersgroep. Dat token kun je altijd weer intrekken. Geef nooit je persoonlijke inlog, want dan kan de bouwer alles wat jij kunt, en zie je niet meer wie wat deed.
Bronnen
Gecontroleerd door Lútsen Muurling op 30 oktober 2026.
- AFAS Help Center, REST API voor ontwikkelaars (opent in een nieuw venster)
- AFAS Help Center, Connector: externe software koppelen met Profit (API) (opent in een nieuw venster)
- AFAS Help Center, App connector toevoegen voor Profit Rest Service (opent in een nieuw venster)
- AFAS Help Center, GetConnector (REST/JSON) (opent in een nieuw venster)
- AFAS Help Center, App connector (opent in een nieuw venster)
- AFAS Help Center, AFAS Partner en Expertnetwerk (opent in een nieuw venster)
Dit gaat over AFAS Profit. Limieten en werkwijze kunnen veranderen; bij twijfel gaat de documentatie van AFAS voor (help.afas.nl en docs.afas.help).