KOPPELINGENAFAS PROFITAFAS koppelen aan je andere systemen
In AFAS Profit staan je medewerkers, relaties, orders en boekingen. Koppel je AFAS aan de rest, dan heeft een nieuwe collega op dag één zijn accounts, wordt een gewonnen deal zonder overtypen een debiteur en weet de servicedesk meteen wie er uit dienst is.
ISO 9001 & 27001
- Medewerkers en dienstverbanden gaat heen en weer met Je andere systemen
- Organisatiestructuur gaat heen en weer met Je andere systemen
- Organisaties, personen en verkooprelaties gaat heen en weer met Je andere systemen
- Offertes en orders gaat heen en weer met Je andere systemen
Onder meer gebouwd voor Tata Steel, M&G Investments, Digistore24, Toppers in Concert, Bar-le-Duc en Loogman
Dit zijn de gegevens die organisaties het vaakst tussen systemen laten lopen. Welke daarvan voor jou tellen, hangt af van waar het werk nu blijft liggen.
Medewerkers en dienstverbanden
Naam, personeelsnummer, functie, afdeling, leidinggevende, start- en einddatum. Werkt HR in AFAS, dan is AFAS hiervoor de logische bron: accounts, servicedesk en planning volgen wat HR vastlegt.
Organisatiestructuur
Afdelingen, vestigingen, functies en kostenplaatsen. Andere systemen hebben die nodig om mensen op de juiste plek te hangen, zoals een servicedesk die meldingen per vestiging routeert.
Organisaties, personen en verkooprelaties
Een klant uit je CRM wordt in AFAS een organisatie met een verkooprelatie, de debiteur. AFAS heeft daar aparte UpdateConnectors voor: KnOrganisation voor de organisatie en haar contactpersonen, KnSalesRelationOrg voor de debiteur zelf.
Offertes en orders
Verkoopoffertes en orders komen binnen via de UpdateConnectors FbSalesQuotation en FbSales. Een order uit een webshop of CRM hoeft dan niet opnieuw ingevoerd te worden, mits de artikelen in AFAS bestaan.
Facturen en openstaande posten
Welke facturen openstaan, wat vervallen is en wat betaald is. Sales en accountmanagers willen dat in hun eigen systeem zien, zonder toegang tot de hele financiële administratie.
Per combinatie: welke gegevens er heen en weer gaan, wat de standaardkoppeling doet en waar je op moet letten.
- AFAS koppelen aan HubSpotAFAS koppelen aan HubSpot? Zo wordt een gewonnen deal een debiteur en order in AFAS, en ziet sales in HubSpot welke facturen er nog openstaan.
- AFAS koppelen aan SalesforceAFAS koppelen aan Salesforce? Zo gaan accounts, opportunities en facturen over en weer, binnen de API-limieten en met AFAS als financiële bron.
- AFAS koppelen aan TOPdeskAFAS koppelen aan TOPdesk? Zo komen medewerkers, afdelingen en vestigingen uit AFAS in de servicedesk, en start een in- of uitdienst een aanvraag.
- AFAS koppelen aan Microsoft 365AFAS koppelen aan Microsoft 365? Zo krijgt een nieuwe medewerker uit AFAS een account en groepen in Entra ID, en wordt hij bij uitdienst geblokkeerd.
- AFAS koppelen aan ChatGPTAFAS koppelen aan ChatGPT? Zo geef je een AI-assistent veilig toegang tot AFAS via een MCP-server met beperkte rechten, en houd je salaris en BSN erbuiten.
Niet altijd. Doet een bestaande koppeling voor AFAS Profit precies wat je nodig hebt, dan zeggen we dat ook.
Veel softwareleveranciers hebben zelf een koppeling met AFAS gebouwd. In het AFAS Partnerportal staan koppelingen die AFAS heeft gecertificeerd: getest op werking en veiligheid, en onderhouden. AFAS kijkt daarbij onder meer naar efficiënt gebruik van de API, veilige communicatie, veilig opgeslagen klantdata en een duidelijke handleiding voor de inrichting.
Profit heeft ook ingebouwde koppelingen. Sinds Profit 8 is er een Entra ID-koppeling die gebruikersgroepen en hun leden naar Microsoft Entra ID synchroniseert en gebruikers blokkeert als hun dienstverband eindigt. Inloggen met single sign-on werkt via OpenID Connect met onder meer Microsoft Entra ID en Okta.
Een standaardkoppeling is genoeg als jouw proces lijkt op het proces waarvoor hij gebouwd is: dezelfde velden, één administratie, één richting. Wijkt je proces daarvan af, vraag dan vooraf na wat de koppeling ermee doet.
- Er is voor je andere systeem geen gecertificeerde koppeling, of die dekt maar een deel van de gegevens.
- Je werkt met vrije velden of met meerdere werkgevers en administraties in één omgeving, en elke mutatie moet in de juiste terechtkomen.
- Een wijziging in een medewerker of relatie moet snel elders zichtbaar zijn, terwijl AFAS daar geen webhook voor stuurt.
- Een AI-assistent moet vragen beantwoorden uit AFAS, met alleen de velden die daarvoor nodig zijn.
Connectoren in plaats van vaste endpoints
AFAS Profit heeft een REST API met JSON en een SOAP API met XML, met dezelfde mogelijkheden. Je leest gegevens met GetConnectors. Die bouw je zelf op een gegevensverzameling, met de velden die je kiest en een vaste filter. Je schrijft met UpdateConnectors, die per object vastliggen, zoals KnEmployee voor medewerkers. POST voegt toe, PUT wijzigt en DELETE verwijdert.
Toegang via app connector en token
In een app connector leg je vast welke Get- en UpdateConnectoren een koppeling mag gebruiken. Een token geldt voor de combinatie van omgeving, app connector en gebruiker, en gaat bij elke aanroep base64-gecodeerd mee in de header als AfasToken. Een beheerder maakt de token aan, of de gebruiker haalt hem op met een eenmalige code. Verwijder je de token, dan stopt de koppeling.
Webhooks alleen voor dossieritems en workflows
Sinds Profit 8 stuurt AFAS webhooks bij het toevoegen, wijzigen of verwijderen van een dossieritem, bij reacties daarop en bij workflowtaken en workflowacties. De melding zegt dat er iets veranderd is, niet wat; de details haal je daarna op met een GetConnector. Je endpoint moet binnen twee seconden antwoorden. Voor medewerkers en relaties vraag je periodiek op wat er gewijzigd is.
Test- en acceptomgevingen
Naast productie bestaan er testomgevingen en acceptomgevingen, herkenbaar aan de letter T of A in de omgevingsnaam. Ze hebben een eigen adres: resttest.afas.online of restaccept.afas.online in plaats van rest.afas.online. Zo test je een koppeling zonder in de echte administratie te schrijven.
Grenzen aan wat je ophaalt
Een aanroep is maximaal 75 MB, een filter in de URL maximaal 2.048 tekens en na ongeveer een kwartier volgt een time-out. Standaard krijg je 100 regels terug; met skip en take blader je verder. AFAS Online hanteert een fair-use-beleid: wie bijvoorbeeld elke minuut dezelfde 15 MB ophaalt, wordt benaderd.
Een koppeling verplaatst gegevens. AI kan daartussen lezen, sorteren en een voorstel klaarzetten. Waar het ertoe doet, beslist een mens.
Mutaties nakijken voordat ze AFAS in gaan
Een AI-stap kan een nieuwe relatie of order uit een ander systeem controleren op een ontbrekend KvK-nummer, een afwijkend adres of een organisatie die al lijkt te bestaan. De twijfelgevallen komen op een lijst en iemand van de administratie beslist.
Vragen beantwoorden uit HR-gegevens
Wie is de leidinggevende van dit team, hoeveel mensen beginnen er volgende maand? Een assistent kan dat opzoeken via een GetConnector met alleen naam, functie, afdeling en startdatum. Salaris, BSN en verzuim zet je niet in die connector, dan kan de assistent er ook niet bij.
Waar een mens beslist
Contractwijzigingen, salarismutaties en uitdiensttredingen voert AI niet zelf door. AI mag ze voorbereiden als dossieritem of workflowtaak, en HR keurt goed. AFAS legt vast door welke gebruiker een record is gewijzigd; met een eigen gebruiker voor de koppeling zie je dus terug wat via de API gebeurde.
Iemand past de GetConnector aan
Omdat je GetConnectors zelf inricht, kan een functioneel beheerder een veld weghalen of een filter wijzigen. De koppeling mist dan ineens gegevens, zonder foutmelding. Geef koppelconnectoren een herkenbare naam en spreek af dat niemand ze zonder overleg wijzigt.
Wijzigingen en verwijderingen missen
Wie wijzigingen ophaalt via de velden voor aanmaken en wijzigen, ziet alleen de laatste wijziging. Verwijderde records komen niet vanzelf terug, en na het hernummeren van een project ontbreken de bijbehorende boekingen. Vergelijk daarom periodiek de volledige set.
De token van een collega
Een token hoort bij een gebruiker. Hangt de koppeling aan het account van een medewerker, dan hangen rechten en logging aan die persoon. Maak per koppeling een aparte gebruiker, met alleen de connectoren die nodig zijn.
Alles in één keer ophalen
Een GetConnector zonder filter op een grote administratie loopt tegen de 75 MB, de time-out of het fair-use-beleid aan. Filter op gewijzigde records en blader met skip en take.
Wat moet waarheen
Welke gegevens gaan over, in welke richting, en welk systeem leidend is als twee waarden verschillen. Dat staat op papier voordat er iets gebouwd wordt. Voor deze koppeling gaat het om: Medewerkers en dienstverbanden, Organisatiestructuur, Organisaties, personen en verkooprelaties, Offertes en orders, Facturen en openstaande posten.
Velden en regels
Per veld de vertaling tussen de systemen: statussen, btw-codes, grootboekrekeningen, artikelnummers. En wat er gebeurt bij een dubbel of een ontbrekend gegeven. Voor deze koppeling gaat het om: Connectoren in plaats van vaste endpoints, Toegang via app connector en token, Webhooks alleen voor dossieritems en workflows, Test- en acceptomgevingen, Grenzen aan wat je ophaalt.
Testen met echte gevallen
In een testomgeving of testadministratie, met de uitzonderingen die in de praktijk voorkomen: creditnota's, deelleveringen, gewijzigde klantgegevens.
Live, met logging en bewaking
Elke synchronisatie wordt gelogd en bij een fout krijgt iemand een melding. Verandert de API van een leverancier, dan passen wij de koppeling aan.
Geen accountmanager. Je spreekt iemand die zelf koppelingen bouwt, en die zegt het ook als een standaardkoppeling genoeg is.
- Kantoor aan de Duivendrechtsekade in Amsterdam
- ISO 9001 en ISO 27001, gecertificeerd door Kiwa
- 500 projecten opgeleverd
- 4,8 uit 127 reviews
Heeft AFAS Profit een API?
Ja. AFAS Profit heeft een REST API met JSON en een SOAP API met XML, met dezelfde functionaliteit. Je werkt met connectoren: GetConnectors om gegevens op te halen en UpdateConnectors om gegevens toe te voegen, te wijzigen of te verwijderen. Welke connectoren een koppeling mag gebruiken, stel je in via een app connector.
Ondersteunt AFAS webhooks?
Sinds Profit 8 wel, maar alleen voor dossieritems, reacties op dossieritems en workflows. De melding zegt dat er iets gewijzigd is, niet wat, dus je haalt de details daarna op met een GetConnector. Voor wijzigingen in medewerkers, relaties of boekingen vraag je periodiek de gewijzigde records op.
Kan ik een AFAS-koppeling testen zonder productiegegevens?
Ja, als je een test- of acceptomgeving hebt. Die herken je aan de T of A in de omgevingsnaam en ze hebben een eigen REST-adres. Een losse demo-omgeving voor ontwikkelaars vraagt een AFAS-licentie, via een klant of via het partnerprogramma van AFAS.
Is een gecertificeerde koppeling uit het Partnerportal altijd genoeg?
Niet altijd. Een gecertificeerde koppeling is getest op werking en veiligheid, maar volgt het proces dat de leverancier voor ogen had. Werk je met vrije velden, meerdere werkgevers of eigen regels voor wie leidend is, dan is aanvullend maatwerk nodig. We kunnen elk systeem aan AFAS koppelen, ook als er geen standaardkoppeling is.
Mag een AI-assistent bij gegevens in AFAS?
Dat kan, als je bepaalt wat hij ziet. Maak een aparte app connector met GetConnectors waarin alleen de benodigde velden staan, en geef de assistent geen UpdateConnectors. Salaris, BSN en verzuim laat je eruit, en voor HR-gegevens hoort er een afweging onder de AVG bij.
Bronnen
De technische feiten op deze pagina komen uit de officiële documentatie van de leveranciers, gecontroleerd op 19 september 2026. Leveranciers passen hun API's en limieten aan; bij een koppeling kijken we altijd naar de actuele stand.
- AFAS Help Center: REST API voor ontwikkelaars
- AFAS Help Center: Connector, externe software koppelen met Profit
- AFAS Help Center: Token genereren
- AFAS Help Center: GetConnector toevoegen
- AFAS Help Center: UpdateConnector beschrijvingen
- AFAS Help Center: Webhooks op dossieritems en workflows
- AFAS Help Center: URL's van REST Services
- AFAS Help Center: Gewijzigde gegevens opvragen met een GetConnector
- AFAS Help Center: Gebruikersgroepen synchroniseren met Entra ID
- AFAS Help Center: Single sign-on inrichten
- AFAS Partnerportal: Koppelingen
- AFAS Partnerportal: Veelgestelde vragen over certificering
- AFAS: Bedrijfssoftware