API-koppeling · bestaande systemen verbinden
AFAS koppeling laten maken: Profit als bron van waarheid voor je portaal, webshop of app
AFAS Profit is in veel organisaties het leidende systeem voor relaties, projecten, HR en financiën. Een koppeling laat je portaal, webshop, planning of werkbon-app daar rechtstreeks uit lezen en veilig in terugschrijven, zonder dat iemand gegevens overtypt. AFAS heeft daar een duidelijk model voor: GetConnectoren om te lezen, UpdateConnectoren om te schrijven, en tokens die je per koppeling toekent. OmniTechs bouwt de koppeling op dat model, met vastgelegde velden, foutafhandeling en een test in de AFAS-testomgeving voordat er iets live gaat.
Door Sina Sadegh Esfahani · Praktijkpagina van OmniTechs uit Groningen; bedragen volgen het actuele prijscontract · Beoordeeld op .
Wat kost een AFAS-koppeling laten maken?
Een koppeling tussen AFAS en één ander systeem met een gedocumenteerde API spreken we vooraf af als vast bedrag; de calculator op de hoofdpagina API-koppeling toont de vanafprijs voor jouw combinatie en het aantal gegevenssoorten. Daarna is de offerte vast, geen uren achteraf.
Is een van de systemen slecht gedocumenteerd, moeten er eerst documenten of mails worden gelezen, of is onduidelijk welk systeem leidend is, dan starten we met een Solution Sprint van €1.250 excl. btw: daarin testen we de verbinding echt en krijg je een vaste bouwprijs. Terugkerende kosten beperken zich tot hosting van de koppellaag en monitoring in een Care-plan; licenties van de systemen zelf betaal je rechtstreeks aan hun leveranciers.
- Standaardkoppeling: vaste prijs na de calculator en een korte intake
- Onzekere combinatie: Solution Sprint €1.250 excl. btw, daarna vaste offerte
- Terugkerend: hosting van de koppellaag en monitoring via Care
- Eerste beoordeling gratis, binnen één werkdag
Wat beweegt er van en naar AFAS Profit?
Lezen gaat via GetConnectoren die een AFAS-beheerder definieert; schrijven via UpdateConnectoren met vaste velden. Beide bepalen wat een koppeling mag.
| Gegevens | Richting | Let op |
|---|---|---|
| Relaties en contactpersonen | AFAS → portaal of CRM, en terug | Welke kant leidend is per veld; adreswijziging in het portaal of in Profit? |
| Projecten, nacalculatie en uren | Werkbon of urenregistratie → AFAS | Projectcode en kostensoort moeten bestaan; uren per medewerker |
| Verkooporders en facturen | Webshop of portaal → AFAS | Artikelcode en btw; verzendkosten op het juiste grootboek |
| Medewerkers en afwezigheid | AFAS HR → planning of rooster | Alleen de velden die nodig zijn; privacy by design |
| Documenten en dossiers | Portaal → AFAS dossier | Bestandsgrootte en dossiertype |
AFAS Connect, partnerkoppeling of maatwerk?
Voor veel systemen bestaat een partnerkoppeling in het AFAS-partnernetwerk, en integratieplatforms bieden standaardkoppelingen op abonnement. Kies die als je gegevensstroom standaard is. Maatwerk loont als je een eigen portaal, webshop of app hebt die met Profit moet praten, als je gegevens wilt valideren of verrijken voordat ze in Profit landen, of als je precies wilt bepalen welke velden naar buiten gaan.
Hoe een AFAS koppeling technisch werkt
In AFAS Profit maakt de beheerder een App Connector aan en kent per koppeling een token toe; dat token bepaalt welke GetConnectoren gelezen en welke UpdateConnectoren geschreven mogen worden. Lezen en schrijven kan via REST met JSON of via SOAP met XML; wij gebruiken REST waar het kan. Grote gegevenssets halen we in delen op en met een filter op gewijzigde records. Elke koppeling testen we eerst in de AFAS-testomgeving van je organisatie, met echte structuur maar zonder gevolgen voor je administratie.
Wat je vooraf klaarzet
Een AFAS-beheerder die de App Connector en de benodigde Get- en UpdateConnectoren kan aanmaken, toegang tot de testomgeving, en een besluit per gegevenssoort welk systeem leidend is. Met de gratis mapping-tool op de hoofdpagina zet je de velden van je portaal of app naast de AFAS-velden.
Zo verloopt het
Dag 1: gratis beoordeling van de gevraagde gegevensstromen en de beschikbare connectoren. Week 1: veldmapping en afspraken over leidende systemen en foutafhandeling. Week 2 tot 4: bouw, test in de testomgeving, livegang per gegevensstroom. Daarna monitoring via een Care-plan of overdracht aan je eigen beheerders.
Wat je mag verwachten
- Eerste beoordeling binnen één werkdag, gratis
- Veldmapping als document dat je zelf kunt nalopen, met de gratis mapping-tool op de hoofdpagina
- Testen met echte gegevens in een testadministratie voordat de koppeling live gaat
- Foutmeldingen die iemand in je team begrijpt, met een eigenaar en een herhaalpoging
- Code, mapping en documentatie zijn van jou; beheer via Care of in eigen hand
Veelgestelde vragen
Wat zijn GetConnectoren en UpdateConnectoren?
GetConnectoren zijn door de AFAS-beheerder gedefinieerde leesviews op Profit-gegevens; UpdateConnectoren zijn vaste schrijfinterfaces voor onder meer relaties, orders, uren en dossiers. Een koppeling gebruikt alleen de connectoren die aan haar token zijn toegekend.
Hoe veilig is een AFAS koppeling?
Toegang loopt via een token dat alleen de toegekende connectoren mag gebruiken; we bewaren tokens versleuteld buiten de code en spreken een rotatieschema af. Gegevens gaan versleuteld over de lijn en we loggen wat er is gelezen en geschreven zonder persoonsgegevens in de logs.
Kunnen jullie AFAS koppelen aan HubSpot, Salesforce of een werkbon-app?
Ja, zolang het andere systeem een API heeft. Relaties en projecten uit Profit naar het CRM of de app, en uren, orders of statussen terug: dat is de gebruikelijke vorm.
Hoe lang duurt een AFAS koppeling?
Reken op twee tot vier weken per gegevensstroom, inclusief test in de AFAS-testomgeving. De snelheid hangt vaak af van hoe snel de connectoren in Profit klaarstaan.
Kunnen jullie een bestaande AFAS koppeling overnemen of repareren?
Ja. Na een gratis beoordeling van code, tokens en connectoren krijg je te horen wat herstel of overname kost.
Welk systeem moet uit AFAS Profit lezen of erin schrijven?
Stuur de naam van je portaal, webshop of app en welke gegevens moeten bewegen. Binnen één werkdag hoor je welke connectoren nodig zijn en wat de koppeling kost.