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.
API tokenHet 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: 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: 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. 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).
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