Alles over AFAS

AFAS koppelen aan APIcenter

Stap voor stap: importeer de connectorset, richt een App connector met OAuth in AFAS in en koppel AFAS aan APIcenter.

Bijgewerkt op 9 november 2026

Om AFAS te koppelen, richt je eerst je AFAS-omgeving in. Daarna vul je vier gegevens in APIcenter in: de client ID, de client secret, het omgevingsnummer en het omgevingstype. Neem de tijd voor de voorbereiding in AFAS: voor sommige stappen heb je een AFAS-beheerder nodig.

Voordat je begint

Je gebruikt AFAS Online.
Je hebt AFAS Profit met de modules Orderbeheer en/of Financieel.
Je mag in AFAS GetConnectoren importeren en App connectoren beheren, of iemand die dat mag helpt je. Voor het importeren heb je in AFAS autorisatie nodig op de functie GetConnector en op de actie Importeren.

Stap 1: Importeer de connectorset

APIcenter leest gegevens uit AFAS via GetConnectoren en schrijft gegevens via UpdateConnectoren. De GetConnectoren die APIcenter nodig heeft, zitten in de APIcenter-connectorset. De UpdateConnectoren zijn standaardconnectoren van AFAS: die voeg je in stap 2 alleen toe aan de App connector.

Download de APIcenter-connectorset en pak het bestand uit.
Ga in AFAS Profit naar Algemeen > Uitvoer > Beheer > GetConnector.
Kies Meer acties > Importeren. Kies Map om alle connectoren uit de uitgepakte map in één keer te importeren. Kies Bestand voor één connector (een .gcn-bestand).
Klik op Voltooien en doorloop de wizard.

Na het importeren zie je de APIcenter-connectoren in de lijst.

AFAS geeft aan dat het importeren van connectoren uit een andere Profit-versie problemen kan geven, door verschillen tussen versies. Controleer de connectoren daarom na het importeren.

De connectoren zijn niet plug-and-play. Een deel bevat dummyvelden: tijdelijke vrije velden, bijvoorbeeld voor de zichtbaarheid van producten, SEO, afmetingen, varianten en filters. Vervang die dummyvelden door de vrije velden uit je eigen AFAS-omgeving, of verwijder ze als je die functie niet gebruikt. De connectoren zijn gevoelig voor spelling en hoofdletters, dus neem veldnamen precies over. De artikelen van de flows leggen uit welke velden ertoe doen.

Stap 2: Richt de App connector in

Ga in AFAS Profit naar Algemeen > Beheer > App connector.
Klik op Nieuw en vul een omschrijving in, bijvoorbeeld APIcenter.
Kies bij Authenticatietype de optie OAuth. Je kunt het authenticatietype na het aanmaken niet meer wijzigen.
Kies bij Type OAuth flow de optie Client credentials en selecteer de gebruiker namens wie APIcenter de connectoren aanroept.
Voeg bij de GetConnectoren alle APIcenter-connectoren toe. De GetConnector ApiCenter_Article moet erbij zitten: APIcenter gebruikt die om de verbinding te testen.
Voeg bij de UpdateConnectoren de connectoren toe die je flows nodig hebben (zie hieronder). APIcenter kan alleen UpdateConnectoren gebruiken die in de App connector staan.
In het laatste scherm zie je de OAuth client id en de OAuth client secret. Kopieer ze allebei (zie stap 3) en klik op Voltooien.
Controleer in de eigenschappen van de App connector dat Geblokkeerd niet is aangevinkt.

Heb je al een APIcenter App connector met een classic token? Vanaf Profit 9 zet je die met een omzetactie om naar OAuth. De gekoppelde connectoren blijven dan behouden. Zie de AFAS-pagina over de overstap naar OAuth.

Welke UpdateConnectoren je nodig hebt, hangt af van de flows die je gebruikt:

Klanten en contacten: Contact (KnContact), Organisatie (KnOrganisation), Persoon (KnPerson), Verkooprelatie organisatie (KnSalesRelationOrg) en Verkooprelatie persoon (KnSalesRelationPer).
Verkooporders: Verkooporder (FbSales) en de UpdateConnectoren voor klanten en contacten hierboven, want APIcenter maakt de klant van de order aan of werkt die bij. Stuur je orders op een andere manier, voeg dan ook toe: FbSalesQuotation (offerte), KnQuotation (voorcalculatie), PtProject (project bij een voorcalculatie), FbDirectInvoice (directe factuur), FiEntries (financiële mutatie) of CmForecast (forecast).
Creditnota's: FbDirectInvoice of FiEntries, afhankelijk van hoe je ze boekt.
Producten: FbItemArticle.
Prijslijsten: FbSalesPrice.
Inkooporders: FbPurch, en voor leveranciers KnPurchaseRelationOrg en KnPurchaseRelationPer.

Stap 3: Bewaar de client ID en client secret

Kopieer in het laatste scherm van de wizard de OAuth client id en de OAuth client secret.
Bewaar ze op een veilige plek, zoals een wachtwoordmanager. Behandel de client secret als een wachtwoord en stuur hem niet per e-mail of chat.

De client ID kun je later nog opzoeken in de eigenschappen van de App connector. De client secret kun je niet meer opvragen. Ben je die kwijt, genereer dan een nieuwe client secret in de App connector en vul die in bij je AFAS-applicatie in APIcenter. De oude client secret werkt daarna niet meer.

APIcenter vraagt met de client ID en client secret zelf een toegangstoken aan bij AFAS. Zo'n token is een uur geldig. Daarna vraagt APIcenter automatisch een nieuw token aan: daar hoef je niets voor te doen.

Let op: een client secret kan verlopen. Vanaf Profit 9 heeft elke client secret een geldigheidsduur, standaard 180 dagen. Je ziet de vervaldatum in de instellingen van de App connector. Verloopt de client secret, dan stopt de koppeling. Genereer daarom ruim op tijd een nieuwe client secret en vul die in APIcenter in. Lees de actuele regels op de AFAS-pagina over OAuth.

Gebruik je nog een classic token? Bestaande classic tokens werken vanaf 1 mei 2027 niet meer. Vanaf 31 augustus 2027 moet elke koppeling OAuth gebruiken.

Stap 4: Geef de gebruikersgroep rechten op de gegevens

GetConnectoren geven alleen gegevens terug die de gebruikersgroep mag zien. Stel dit in AFAS in:

Open de Autorisatie tool in AFAS en selecteer de gebruikersgroep van de App connector.
Geef op het tabblad Autorisatie rechten op de filters voor de gegevens die je flows ophalen (filterautorisatie).
Geef de groep geen rechten op functies (menu-items), tabbladen en acties. Met deze groep hoort niemand in Profit te werken.

Rechten in AFAS zijn erg specifiek: vraag je AFAS-adviseur als je niet zeker weet welke filters je nodig hebt.

Stap 5: Zoek het omgevingsnummer en -type op

Omgevingsnummer: het deelnemersnummer van je AFAS-omgeving. Gebruik alleen de cijfers. De naam van je omgeving begint met een letter, bijvoorbeeld O12345AA: het omgevingsnummer is dan 12345.
Omgevingstype: het soort omgeving waarmee je koppelt. Je ziet het aan de eerste letter van de omgevingsnaam:
- rest voor productie (de naam begint met een O)
- resttest voor test (de naam begint met een T)
- restaccept voor accept (de naam begint met een A)

Kies het type van de omgeving waarin je de App connector hebt aangemaakt.

Stap 6: Vul de gegevens in APIcenter in

Ga in APIcenter naar Applicaties en kies AFAS onder Nieuwe applicatie koppelen. Je kunt dit ook doen in stap 2 van de wizard, Verbind je apps.
Vul de velden in:
- Weergavenaam: een naam die je zelf kiest. Handig als je meerdere AFAS-applicaties hebt.
- Client ID: de OAuth client id uit stap 3.
- Client Secret: de OAuth client secret uit stap 3.
- Environment Number: je omgevingsnummer.
- Environment Type: rest, resttest of restaccept.
Klik op Testverbinding. APIcenter slaat de gegevens op en test de verbinding.

Veelvoorkomende problemen

Verkeerd omgevingstype of omgevingsnummer. Het omgevingstype moet passen bij de omgeving van de App connector, en het omgevingsnummer bestaat alleen uit cijfers. Mislukt de test, controleer dan eerst deze twee.
De test mislukt terwijl de client ID en client secret kloppen. Controleer of de GetConnector ApiCenter_Article in de App connector staat en of je bij Type OAuth flow de optie Client credentials hebt gekozen.
De client secret is verlopen of de App connector is geblokkeerd. Controleer de vervaldatum van de client secret en of Geblokkeerd is aangevinkt. Genereer zo nodig een nieuwe client secret en vul die in APIcenter in.
Ontbrekende rechten op connectoren. De verbinding werkt, maar een flow meldt dat hij geen gegevens kan ophalen of versturen. Controleer of de connector in de App connector staat en of de gebruikersgroep de juiste filterautorisatie heeft.
Connectoren niet aangepast. Dummyvelden die niet in je omgeving bestaan, geven fouten. Vervang of verwijder ze (stap 1).

Volgende stappen

Maak een integratie met AFAS en controleer de instellingen. Voor klanten en orders heeft AFAS minimaal een administratie, een debiteurenrekening (verzamelrekening) en betalingsvoorwaarden nodig. Zie Verkooporders naar AFAS sturen en AFAS verbindings- en integratie-instellingen.