Ga naar hoofdinhoud

AFAS

Categorie: Directe koppeling · 🏅 Official partner

Nederlands ERP-systeem. Official partner. Yres leest AFAS uit via de AFAS App connector (de REST-services van AFAS Profit/InSite). In Azure Data Factory wordt dit een RestService linked service.

Verwachte input​

Je legt de koppeling aan via de wizard Bron toevoegen. Naast de velden die voor elke bron gelden (bronnaam, type, integration runtime, of de credentials voor alle omgevingen gelijk zijn, eventuele vervaldatum van de credentials, tags) vraagt de AFAS-bron de volgende velden:

VeldToelichting
URLDe REST-basis-URL van je AFAS-omgeving. Moet eindigen op …afas.online/profitrestservices. Voorbeeld/placeholder: https://12345.rest.afas.online/profitrestservices, waarbij 12345 je AFAS-omgevingsnummer is.
Client id (vanaf v1.57)De client id van je App connector voor inloggen via OAuth (client credentials).
Client secret (vanaf v1.57)Het bijbehorende client secret. Yres bewaart het in de Key Vault van je omgeving.
API token (tot en met v1.56)Het volledige tokenblob dat AFAS bij de App connector genereert: <token><version>1</version><data>…</data></token>. Plak de hele waarde, niet alleen het data-deel.

Authenticatie vanaf v1.57: Yres logt in via OAuth met de client id en het client secret. Yres vraagt zelf een toegangstoken aan bij AFAS en vernieuwt het automatisch; je hoeft verder niets te beheren.

Als je een AFAS-bron hebt en naar 1.57 bijwerkt

AFAS stopt in augustus 2027 met het klassieke token. Maak vóór de upgrade naar 1.57 in AFAS een client id en client secret aan voor je App connector en vul ze na de upgrade bij je AFAS-bron in de webapp in. Zie de release notes.

Authenticatie tot en met v1.56: het API token wordt als Authorization-header meegestuurd. Yres bouwt die header zelf op: je plakt het rauwe token-blob (de XML zoals AFAS die levert), en de backend codeert dat naar base64 en zet er de prefix AfasToken voor. Er is geen gebruikersnaam/wachtwoord.

Integration runtime: cloud — AutoResolveIntegrationRuntime. AFAS Online is publiek bereikbaar via HTTPS, dus een self-hosted integration runtime is niet nodig.

Waar de credentials terechtkomen (tot en met v1.56): de frontend bewaart geen secrets. De backend schrijft de opgebouwde headerwaarde (AfasToken + base64 van je token) naar de Azure Key Vault van je eigen omgeving; de linked service haalt die op als secret adf-AFAS-connectionstring (het secret valt onder de naamgroep adf-{bronnaam}-…). De linked service (AFAS.json) staat zelf op Anonymous en zet het token via authHeaders.Authorization als verwijzing naar dat Key Vault-secret.

Voorbereiding (in AFAS Profit)​

  1. Maak een App connector aan via Algemeen → Beheer → App connector.
  2. Voeg de GetConnectors toe die Yres mag uitlezen (elke GetConnector is een bron-"tabel" die je later als gebruikte tabel kunt selecteren).
  3. Vanaf v1.57: maak bij de App connector een client id en client secret aan voor OAuth (client credentials). Tot en met v1.56: genereer het token. AFAS levert dit als XML-bestand; de inhoud is het <token>…</token>-blob dat je in het veld API token plakt.
  4. Noteer je omgevingsnummer voor de URL (https://<omgevingsnummer>.rest.afas.online/profitrestservices).
Tot en met v1.56: plak het token onbewerkt — Yres doet de codering

Voeg zelf geen prefix of encoding toe. Je plakt het rauwe <token>…</token>-blob precies zoals AFAS het levert; de Yres-backend doet de base64-codering en zet er de prefix AfasToken voor, en slaat het resultaat als connectionstring-secret op in de Key Vault. Een token dat je zelf al hebt ge-base64't of van AfasToken hebt voorzien, wordt dubbel gecodeerd en werkt niet. Eventuele licentie-/abonnementsvereisten voor de App connector worden door AFAS bepaald.

Load types & delta​

AFAS-tabellen worden geladen via GetConnectors. De gebruikelijke load types (FULL, DELTA, IMAGE, OVERWRITE, RELOAD, ADDITIONAL, DELTAIMAGE) zijn van toepassing; delta laden vereist een geschikte deltakolom in de betreffende GetConnector. AFAS ondersteunt net als de SQL-bronnen twee deltakolommen.

Officiële documentatie: AFAS Profit — GetConnector / App connector.


Zie ook: Integratiecatalogus · Alle databron-vereisten · Integraties — overzicht