AFAS Profit¶

Artific Connect · AFAS geeft een sleutel twee tools over de GetConnectors en UpdateConnectors die je organisatie al heeft gekoppeld aan haar eigen App Connector in Profit — een lees- en een schrijfactie, beide precies zo gevormd als je eigen koppelingsconfiguratie bepaalt, geen vast AFAS-objectmodel. Je installeert hem vanaf de Marktplaats, net als elke andere bundel.

Wat je krijgt¶

Eén toolset, afas, met de twee koppelingen, plus een skill die het model AFAS's eenvoudige filtersyntax vertelt en wat het moet bevestigen voordat het schrijft.

Wat je Profit-beheerder eerst bouwt¶

Bouw in Profit een App Connector, en koppel er elke GetConnector en UpdateConnector aan die deze bundel moet kunnen bereiken. AFAS zelf weigert een aanroep die een niet-gekoppelde koppeling noemt — de App Connector is ook waar je het token genereert.

Wat je opgeeft bij het installeren¶

Jouw omgeving staat op https://<jouw-omgevingsnummer>.rest.afas.online, één host onder elke koppeling die je hebt gekoppeld, dus deze bundel vraagt er één keer om:

afas_environment_url — plak https://<jouw-omgevingsnummer>.rest.afas.online met je eigen omgevingsnummer ingevuld. Elke aanroep voegt zelf /ProfitRestServices/connectors/<koppelingsnaam> toe aan dit ene adres, waarbij de naam van de koppeling als onderdeel van de aanroep wordt meegegeven in plaats van hier te worden ingevuld — het model, of de persoon die het helpt, noemt elke keer welke gekoppelde koppeling gelezen of beschreven wordt.

En afas_credential, het token dat je in je App Connector genereerde, met AFAS's eigen AfasToken-schema er precies zo voor gezet — dit is niet het gewone bearer-schema, dus dat voorvoegsel typ je zelf:

{ "type": "bearer", "secret": "AfasToken <base64-token uit Profit>" }

Zolang niet beide zijn opgegeven staat het abonnement op wacht op configuratie.

Voordat het werkt¶

Je beheerder moet de host van jouw omgeving toestaan in het uitgaand verkeer van de sleutel.

Goed om te weten¶

Geverifieerd op 2026-09-24 op help.afas.nl: de vorm van de basis-URL, dat de Authorization-header luidt AfasToken <base64 van het token>, en dat "alleen de gekoppelde GetConnectors" en "alleen de gekoppelde UpdateConnectors" aangeroepen kunnen worden via een gegeven App Connector — AFAS zelf weigert een aanroep die een niet-gekoppelde koppeling noemt, welk adres of welke koppelingsnaam deze bundel ook stuurt. Daarom vraagt deze bundel bij elke aanroep om de naam van de koppeling, in plaats van bij installatie één leeskoppeling en één schrijfkoppeling vast te leggen: de koppeling in Profit is de werkelijke grens, en een koppeling noemen waaraan dit token niet is gekoppeld wordt hoe dan ook door AFAS geweigerd.
Geverifieerd op 2026-09-24 op AFAS's eigen klantportaalpagina's: klassieke App Connector-tokens worden uitgefaseerd voor OAuth. Tokens krijgen vanaf september 2026 een einddatum van 15 februari 2027, nieuwe kunnen nog worden aangemaakt (uiterlijk geldig tot 31 augustus 2027), en de definitieve overgang is 31 augustus 2027. Deze bundel gebruikt vandaag een klassiek token; hij gaat voor die datum over op OAuth 2.1, zonder te veranderen welke tools een sleutel al heeft hangen.
Niet geverifieerd: de precieze namen van de queryparameters die AFAS's eenvoudige GetConnector-filter aanneemt (filterfieldids, filtervalues, operatortypes hierboven, uit externe integratiegidsen in plaats van AFAS's eigen naslag); controleer ze tegen je eigen koppeling voordat je op een gefilterde leesactie vertrouwt.
De vorm van elk koppelingselement is volledig van je eigen Profit-configuratie; vraag degene die de koppeling bouwde in plaats van veldnamen te raden.
Het beeldmerk: de kaart van deze bundel gebruikt nog steeds Artifics eigen placeholder. AFAS's eigen huisstijlpagina zegt dat het logo voor AFAS's eigen gebruik is, en dat een partner eerst moet overleggen met de marketingafdeling van AFAS, wat deze omgeving niet heeft gedaan (gecontroleerd op 2026-09-24).