AFAS Profit koppelen: welke connector je nodig hebt en welke route overblijft

AFAS certificeert koppelingen. Bijna iedereen leest daaruit dat je zonder die certificering niet mag koppelen, en dat is precies de verkeerde conclusie. Certificering is een programma voor softwareleveranciers die hun standaardkoppeling in de etalage van AFAS willen zetten. Het is geen toestemming om verbinding te maken met jouw eigen omgeving.

Die toestemming geef je zelf, met een App connector, in de omgeving waar je al voor betaalt. Deze gids gaat over de koperskant van AFAS Profit: welke connector bij welke datastroom hoort, wat de certificeringspoort echt eist en waarom je er als mkb'er niet doorheen hoeft, welke drie routes daaronder overblijven, wat je zelf inricht, en wat je er per jaar aan kwijt bent.

Drie onderdelen, en je hebt ze alle drie nodig

Een AFAS Profit-koppeling bestaat uit drie onderdelen: een GetConnector die gegevens uit Profit leest, een UpdateConnector die gegevens naar Profit schrijft, en een App connector die per externe applicatie vastlegt welke van die connectoren gebruikt mogen worden en met welke token. De eerste twee zijn de leidingen. De derde is de kraan, en die zit in jouw beheer.

Een GetConnector is een gedefinieerde uitvraag op de Profit-database. AFAS levert er standaard een set mee, en je consultant of beheerder kan er zelf bijmaken met precies de velden die je koppeling nodig heeft. Alles wat naar buiten gaat, van debiteuren tot urenregels, gaat hier doorheen.

Een UpdateConnector doet het omgekeerde en muteert in Profit. Ze dragen technische namen die je in elke offerte terugziet: KnSubject voor dossieritems met bijlagen, FbSales voor een verkooporder, PtLinesToBeInvoiced voor nacalculatieregels. Let op één beperking die veel projecten laat in de rit raakt: je kunt met een UpdateConnector geen verkoopfactuur rechtstreeks aanmaken, omdat een factuur in AFAS altijd voortkomt uit een verkooporder of uit nacalculatie. Wil je factureren vanuit een ander systeem, dan schrijf je dus een order weg en laat je Profit de factuur maken.

De App connector is de toegangsverlening. AFAS is daar in de eigen documentatie streng over: maak voor elke externe applicatie een nieuwe App connector aan, met een eigen gebruiker en een eigen gebruikersgroep. In die App connector hang je de connectoren die deze ene applicatie mag gebruiken. Staat er een connector niet in, dan bestaat hij voor die applicatie niet. Daarbovenop geldt de filterautorisatie van de koppelgebruiker: die bepaalt welke records er terugkomen, ook als de connector wel is toegestaan.

Die twee poorten verklaren vrijwel elke foutmelding uit een AFAS-koppeling die het "ineens niet meer doet". De eerste geeft een harde fout. De tweede geeft gewoon minder rijen terug, zonder waarschuwing, en dat is de gevaarlijkste van de twee.

De certificeringspoort: wat er echt staat

Nu de poort waar dit onderwerp om draait. Om je koppeling in het overzicht van standaardkoppelingen te krijgen, stelt AFAS deze voorwaarden: je organisatie heeft vijf of meer medewerkers, vijf of meer klanten gebruiken diezelfde koppeling, je voert periodiek een pentest of quickscan uit, je levert een implementatiedocument, je stuurt in elke aanroep een uniek IntegrationId mee, en je betaalt een maandelijkse licentie vanaf 155 euro terwijl er expliciet geen maatwerkoplossingen worden gecertificeerd (voorwaarden augustus 2026). De onboarding duurt maximaal een jaar.

De securitylat eronder is stevig. AFAS schrijft dat een pentest een grey box-test moet zijn door een ethische hacker met de OWASP Top 10 als kader, dat een ISO 27001-certificering niet volstaat als vervanging, en dat de goedkopere Security Quickscan drie jaar geldig blijft bij een groene uitslag, vijftien maanden bij oranje en zes maanden bij rood. Ook belangrijk: een bestandskoppeling kan sowieso niet gecertificeerd worden, alleen een koppeling die via de API werkt.

Lees die lijst nu als koper in plaats van als bouwer. Vijf klanten op dezelfde koppeling, een maandlicentie, een terugkerende pentest: dat zijn eisen aan een softwareleverancier met een product, niet aan een bedrijf met één koppeling. Dat AFAS geen maatwerk certificeert is dan ook geen afwijzing van maatwerk. Het is een afbakening van waar dat keurmerk over gaat, namelijk over software die bij meerdere klanten identiek draait. Jouw koppeling draait bij één klant. Jou.

Voor de lichtere lijn is er een aparte ingang. Wie zichtbaar wil worden in het App Center van AFAS SB heeft een koppeling met duidelijke meerwaarde, vijf of meer medewerkers, akkoord met de SB App Center-voorwaarden en een implementatiedocument nodig, en krijgt daarvoor een SB-testomgeving en ontwikkelsupport terug. Daar staat geen maandlicentie bij vermeld. Het label heet daar dan ook geregistreerd, niet gecertificeerd.

Wat je op tafel legt voordat er één token bestaat

Een AFAS-koppeling strandt zelden op code. Hij strandt op iets dat niemand vooraf heeft opgeschreven. Dit is de lijst die dat voorkomt.

• Je stromen, per richting benoemd. Niet "webshop aan AFAS", maar "orders van de webshop naar Profit" en "artikelen van Profit naar de webshop". Elke richting is een eigen connector en een eigen besluit.
• Je Profit-versie en je deelnemersnummer. Het nummer haal je uit je omgevingsnaam: uit O12345AA is dat 12345. De versie bepaalt wat er kan, want mTLS-certificaten op een App connector zijn er pas vanaf Profit 8.
• Wie een App connector mag aanmaken. Dat zit onder Algemeen, Beheer, App connector en vereist beheerrechten. In veel organisaties is dat de succesbeheerder, niet de aanvrager.
• Welke GetConnectors er al zijn. Vraag het overzicht op voordat iemand er nieuwe gaat definiëren. De helft van het werk is vaak al gedaan.
• De filterautorisatie van de koppelgebruiker. Welke administraties, welke dossiers, welke medewerkers mag deze koppeling zien.
• Je vrije velden. AFAS-implementaties leunen er zwaar op, en bij kant-en-klare koppelingen zit ondersteuning daarvoor bijna altijd in het duurste pakket.
• Een testomgeving en een naam voor het beheer. Wie kijkt er over een jaar naar de foutmeldingen, en binnen hoeveel uur.

De drie routes die onder de poort door lopen

Met die lijst in de hand zijn er drie routes. Ze sluiten elkaar niet uit: je kiest per datastroom, niet per systeem.

Route 1: een gecertificeerde koppeling uit het overzicht

AFAS houdt een overzicht bij van koppelingen die volgens de eigen omschrijving getest zijn op werking en veiligheid, onderhouden worden en gecertificeerd zijn, verdeeld over negentien branchecategorieën. Staat jouw combinatie erin en wijkt je proces niet af, dan stopt de zoektocht hier. Je koopt geen koppeling maar een abonnement op iemand die hem onderhoudt, en dat is de helft van de waarde.

Het prijsbeeld is publiek, en de spreiding zit niet in de leverancier maar in wat een pakket dekt. Voor een AFAS-Shopify-koppeling rekent Linkwize 64,99 euro per maand plus 1.520 euro inrichting voor het Basis-pakket met debiteuren, balie- en directfacturen, verkooporders, verkoopoffertes en journaalposten, 86,99 euro plus 2.280 euro voor Premium zodra verkoopprijzen, actieprijzen en voorraden meemoeten, en 107,99 euro plus 3.800 euro voor Totaal met artikelstamdata, artikelafbeeldingen, productgroepen, samenstellingen en vrije velden (vanaf-prijzen, exclusief btw, augustus 2026). Die pakketindeling is belangrijker dan de maandprijs, want hij bepaalt of jouw tweede datastroom er überhaupt in zit. Let er ook op dat lang niet elke aanbieder de eenmalige inrichting publiceert: staat alleen de maandprijs op de site, dan ken je jaar één nog niet.

Kijk naar het verschil tussen de twee balken per pakket. De eenmalige inrichting is in jaar één ongeveer twee tot drie keer de jaarlijkse abonnementskosten, en het verschil tussen het instappakket en het volledige pakket is grofweg een factor twee. Dat maakt de vergelijking met zelf bouwen minder eenzijdig dan hij op het eerste gezicht lijkt.

Route 2: je eigen koppeling op je eigen App connector

Dit is de route die de meeste mensen ten onrechte afschrijven. Je maakt zelf een App connector aan in je eigen omgeving, hangt daar de connectoren aan die je nodig hebt, en bouwt de koppeling. Geen certificering, geen partnercontract, geen maandlicentie van 155 euro. Wel volledige verantwoordelijkheid, en dat is een echte prijs.

De techniek is toegankelijk. Je roept een connector aan via de Profit Rest Services, en vanaf Profit 7 gaat de AFAS-token altijd Base64-gecodeerd mee in de header, als Authorization: AfasToken <waarde>. De URL bouw je het snelst door de GetConnector eerst uit te voeren via de testtooling op connect.afas.nl met je deelnemersnummer.

Voor nieuwe koppelingen is OAuth de standaard geworden. Je maakt de App connector aan onder Algemeen, Beheer, App connector, kiest authenticatietype OAuth (dat kun je achteraf niet meer wijzigen), kiest tussen de Code-flow en Client credentials, en krijgt een client id en een client secret. Dat secret is daarna niet meer in te zien, alleen opnieuw te genereren. Draai je nog op classic tokens, dan heb je een deadline: stap vóór 31 augustus 2027 over op een App connector op basis van OAuth.

Route 3: via je AFAS-consultant of een AFAS-partner

De derde route is de klus uitbesteden aan iemand die de omgeving al kent. Bij AFAS zelf staat een consultant op 1.100 euro per dag, een senior consultant op 1.200 euro en een projectleider op 1.300 euro, bij een dag van zeven uur, met een systeemintegrator op 200 euro per uur (exclusief btw). Een partner uit het netwerk zit daar meestal onder. Deze route is vooral aantrekkelijk voor het definiëren van de GetConnectors en de autorisatie, ook als je de koppeling zelf laat bouwen: dat is precies het deel waar productkennis van Profit sneller werkt dan uitzoeken.

Prijzen augustus 2026, exclusief btw en exclusief je AFAS-licentie zelf.

Van App connector tot de eerste boeking, in acht stappen

Aan het eind van deze acht stappen heb je een externe applicatie die via een eigen App connector leest uit en schrijft naar je Profit-omgeving, met een token dat niet aan een persoon hangt en een testronde die je hebt kunnen controleren. Elke stap levert iets op dat je kunt aanvinken.

1. Schrijf per datastroom de richting en de connector op. Orders naar binnen is een UpdateConnector, artikelen naar buiten is een GetConnector. Twee richtingen tussen dezelfde systemen zijn twee koppelingen.
2. Zoek je combinatie op in het overzicht van gecertificeerde koppelingen. Staat hij er, vraag dan meteen de prijslijst op inclusief inrichting en of vrije velden meekomen. Dit is het moment waarop route 1 afvalt of wint.
3. Laat de GetConnectors definiëren met alleen de velden die je nodig hebt. Minder kolommen is niet netjes maar noodzakelijk, zoals de volgende stappen laten zien.
4. Maak de App connector aan onder Algemeen, Beheer, App connector. Kies OAuth als authenticatietype, maak een eigen gebruikersgroep en een systeemgebruiker, en hang alleen de connectoren eraan die deze applicatie nodig heeft.
5. Zet het client secret weg in een wachtwoordkluis, niet in je broncode. AFAS waarschuwt daar expliciet voor, en het secret is achteraf niet meer op te vragen.
6. Beperk de toegang verder. Stel de filterautorisatie van de koppelgebruiker in per administratie, zet IP-restricties aan als je koppelpartij een vast IP-adres heeft, en gebruik mTLS als je op Profit 8 zit.
7. Test op connect.afas.nl voordat je één regel code schrijft. Voer de GetConnector daar uit, kijk of de velden en de records kloppen, en neem de URL die daaruit komt over in je koppeling.
8. Draai de eerste schrijfronde op een testadministratie. Twintig tot vijftig echte records, met de uitzonderingen erbij: een creditnota, een order met korting, een buitenlandse klant. Pas daarna zet je hem op productie, met bewaking erop.

Waar AFAS-koppelingen in de praktijk stuklopen

Zes faalmodi zie ik telkens terugkomen. Vijf ervan kosten je een middag, de laatste kost je je cijfers.

De melding "GetConnector niet ondersteund voor deze app of de gebruiker is niet geautoriseerd". Twee oorzaken, en je moet ze allebei uitsluiten: de connector zit niet in deze App connector, of de gebruiker zit niet in de gekoppelde gebruikersgroep. Controleer ze in die volgorde, want de eerste is het vaakst het geval.

Alles in één keer ophalen. Een GetConnector heeft een plafond. AFAS adviseert de vuistregel aantal kolommen maal aantal regels onder de 150.000 te houden, omdat je anders een Out of Stringspace of Out of memory krijgt, en AFAS Online kapt een verzoek na vijftien minuten af. De mitigatie is skip en take, met een detail dat mensen overslaan: je moet consequent sorteren, anders weet je bij pagina drie niet meer of je een regel al gehad hebt. Sorteer dus op een unieke sleutel, niet op naam.

Rekenen op een directe verkoopfactuur. Zie hierboven: het gaat via een verkooporder of via nacalculatie. Ontdek dat in de ontwerpfase, niet tijdens de acceptatietest.

Eén App connector voor alles. Dan deelt elke applicatie hetzelfde token en dezelfde rechten, en kun je er niet één intrekken zonder de rest plat te leggen. AFAS adviseert bewust het omgekeerde. Een token dat kwijt is, is trouwens niet terug te halen: je verwijdert hem en maakt een nieuwe.

Een koppeling die op een persoon staat. De koppelgebruiker hoort een systeemgebruiker te zijn met een eigen gebruikersgroep. Zit hij op het account van je administrateur, dan valt de koppeling stil op de dag dat die persoon vertrekt, en meestal merkt niemand dat meteen. Hoe je dat structureel afvangt staat in het draaiboek voor het intrekken van toegang bij vertrek, overname of een leverancierswissel.

Stil stilvallen. Een AFAS-koppeling die niets meer doorstuurt geeft geen foutmelding maar een leegte in je administratie, en die valt pas op bij de maandafsluiting. Spreek daarom een detectietijd af en meet of er binnen het verwachte venster iets is binnengekomen in plaats van alleen te alarmeren op fouten.

Het beslis-kader: vier vragen, in deze volgorde

De eerste vraag kan de rest overbodig maken. Loop ze dus op volgorde af.

• Staat jouw combinatie in het overzicht van gecertificeerde koppelingen, inclusief de velden die je nodig hebt? Zo ja, en je proces is standaard, dan is dat de goedkoopste en rustigste route. Zelf bouwen wat iemand anders voor 65 euro per maand onderhoudt is geen soevereiniteit maar een hobby.
• Wijkt je proces af op een punt dat telt? Vrije velden, meerdere administraties in één stroom, deelleveringen, een eigen kostenplaatsstructuur. Dat is het moment waarop een kant-en-klaar pakket duurder wordt dan het lijkt, want de ondersteuning ervoor zit steevast in de bovenste prijsklasse.
• Loopt je omzet door deze stroom? Zo ja, dan hoort de koppeling bij het deel van je bedrijf dat je zelf in de hand wilt houden, en weegt de bouwsom lichter dan de afhankelijkheid.
• Wie beheert dit over een jaar? Bij route 1 is dat de partner. Bij route 2 en 3 ben jij het, en dan hoort er een onderhoudsregel in de begroting. Reken op vier tot zestien uur onderhoud per draaiende koppeling per jaar en op 800 tot 1.000 euro per bouwdag.

Uitgewerkt voorbeeld: 400 Shopify-orders per maand

Een groothandel met 35 medewerkers draait AFAS Profit voor financieel, HR en voorraad, en verkoopt daarnaast via Shopify. Vierhonderd orders per maand worden nu met de hand overgenomen. Er zijn twee stromen: orders naar Profit, artikelen en voorraad naar de webshop.

Route 1 doorgerekend. De combinatie staat in het overzicht, maar het instappakket dekt deze casus niet. Het Basis-pakket van Linkwize dekt debiteuren, balie- en directfacturen, verkooporders, verkoopoffertes en journaalposten: dat is stroom één, van de webshop naar Profit, en verder niets. Stroom twee valt er buiten, want voorraden zitten pas in Premium (86,99 euro per maand plus 2.280 euro inrichting) en artikelstamdata pas in Totaal. Wie artikelen én voorraad naar de webshop wil duwen, koopt dus Totaal: 3.800 euro inrichting plus twaalf maal 107,99 euro, ongeveer 5.100 euro in jaar één en 1.296 euro per jaar daarna. Daar zitten de vrije velden die deze groothandel op de debiteur gebruikt voor zijn routeplanning, in datzelfde pakket meteen bij in.

Route 2 doorgerekend. Twee stromen, twee connectoren, een App connector met OAuth, een testronde en bewaking. Reken op acht tot twaalf bouwdagen. Met 800 tot 1.000 euro per bouwdag is dat 6.400 tot 12.000 euro, plus hosting en zes tot twaalf uur onderhoud per jaar.

De uitkomst. Op prijs alleen wint route 1, ook in het duurste pakket: 5.100 euro in jaar één tegen 6.400 tot 12.000 euro bouwbudget. De tussenvariant die je zou verwachten, Premium kant-en-klaar voor de orders en de voorraad (3.324 euro in jaar één, 1.044 daarna) met de artikelstroom en de vrije velden er los naast op dezelfde App connector, valt bij narekenen af: het verschil met Totaal is 1.520 euro eenmalig en 252 euro per jaar, en dat is minder dan de twee tot drie bouwdagen van 800 tot 1.000 euro die dat stuk kost, nog voor het onderhoud erbij komt. Zolang een pakket je stroom volledig dekt, is bijkopen goedkoper dan bijbouwen. Het kantelpunt zit dus niet in de rekensom van vandaag maar in wat er in jaar twee gebeurt: gaat deze groothandel ook offertes, retouren en een tweede verkoopkanaal koppelen, dan groeit hij uit het pakket en betaalt hij twee keer. Ik zou hier Totaal nemen voor het standaardwerk, 1.296 euro per jaar, en de App connector vrijhouden voor wat daarna komt. Dat bouw je er los naast, op diezelfde App connector, zonder het pakket open te breken.

Het patroon per stroom kiezen, in plaats van per systeem, is precies de afweging die ook tussen event-driven en delta-batch synchronisatie speelt.

AFAS naast Twinfield en Visma

Drie Nederlandse pakketten, drie heel verschillende poorten. Het is nuttig om te weten waar AFAS staat, zeker als de keuze voor het pakket zelf nog open ligt.

Situatie augustus 2026. Bij Visma is de sandbox zelfbediening en gratis, maar productietoegang vereist een aparte aanvraag nadat je sandbox-test klaar is, via het Spiris Partner Programme. Bij Twinfield staat de rem in de documentatie zelf: sinds 1 december 2024 geldt er een creditlimiet per minuut, en een ClientId dat nog niet gecertificeerd is krijgt daar 5 procent van, dus 50 in plaats van 1.000 credits per minuut. Wolters Kluwer stelt certificering verplicht voor een koppeling die je uitlevert en biedt die aan als abonnement met een maandelijkse vergoeding, met hercertificering elke twee jaar. Dat levert een heel andere afhankelijkheid op dan bij AFAS, waar je de kraan in je eigen omgeving opendraait: hoe die Twinfield-route in de praktijk loopt staat in de gids over koppelen aan het Twinfield-pakket dat op naam van je accountant staat.

Dat is het punt dat vaak ondersneeuwt in vergelijkingen. AFAS heeft de zwaarste certificeringsvoorwaarden van de drie voor leveranciers, en tegelijk de meest open deur voor de klant zelf. De keuze tussen een kant-en-klare app, een integratieplatform of een eigen koppeling op de API is bij AFAS dus een echte keuze, niet een geregisseerde. Draai je een pakket dat helemaal geen open ingang heeft, dan is de afweging een andere en kom je uit bij export, een rapportagelaag, bestandsuitwisseling of een schermrobot.

Vijf vragen aan je AFAS-consultant voordat je begint

Stuur ze als lijstje per mail, dan hoeft niemand ze uit zijn hoofd te beantwoorden en heb je het antwoord zwart op wit.

1. Welke GetConnectors bestaan er al in mijn omgeving, en wie mag er nieuwe definiëren? Dit bepaalt of stap 3 een uur of een week kost.
2. Op welke Profit-versie draai ik, en staan er nog App connectoren op classic tokens? Die moeten voor 31 augustus 2027 om, dus neem dat mee in dezelfde beurt.
3. Welke filterautorisatie krijgt de koppelgebruiker, per administratie? Vraag het antwoord in de vorm van administraties en dossiers, niet in de vorm van "die mag alles".
4. Welke vrije velden zijn er in mijn inrichting in gebruik, en op welke entiteiten? Dit is het veld dat kant-en-klare pakketten het vaakst niet meenemen en dat je offerte verdubbelt.
5. Wat kost een testomgeving en hoe lang mag die blijven staan? Zonder testadministratie schrijf je je eerste UpdateConnector op productie, en dat wil je niet.

De rode draad door dit hele stuk is dat de zwaarste voorwaarden bij AFAS niet aan jou gesteld worden. Ze gelden voor partijen die hun koppeling aan honderd klanten willen verkopen, en dat is een terecht strenge lat. Jij hoeft alleen je eigen data over de drempel te krijgen, en daarvoor bestaat de App connector precies. De echte vraag is dus niet of je mag koppelen. Het is welke stroom het waard is om zelf in de hand te houden.