Koppeling
AFAS API: koppelingen met AFAS Profit
Met de AFAS API lees en schrijf je gegevens in AFAS Profit vanuit je andere systemen. Een AFAS koppeling zet bijvoorbeeld uren en materiaal van de werkbon op het juiste project, en haalt relaties op voor je planning.
Het systeem
AFAS Profit in een bouw- of installatiebedrijf
AFAS Profit is een ERP-pakket voor onder meer financiƫn, HRM, projecten en ordermanagement. Grotere bouw- en installatiebedrijven gebruiken het vaak als het centrale systeem voor personeel en administratie, met daarnaast een apart pakket voor werkbonnen of planning.
Juist die combinatie vraagt om een koppeling: de monteur werkt in een app, het salaris en de facturen lopen via AFAS.
Wat je koppelt
Van werkbon tot salarisstrook
- Gewerkte uren per project of werkbon, voor nacalculatie en loon.
- Verkoopfacturen en de bijbehorende projecten.
- Relaties en medewerkers, als bron voor je planning of klantportaal.
- Documenten, zoals een getekende werkbon of een opleverrapport bij het dossier.
- Bestellingen bij de groothandel via een OCI-koppeling.
Technisch
Connectoren: zo is de AFAS API opgebouwd
AFAS werkt met connectoren. Een GetConnector is een vaste vraag die gegevens teruggeeft, bijvoorbeeld alle open projecten. Een UpdateConnector schrijft gegevens terug, bijvoorbeeld een urenregel. De connectoren worden in AFAS zelf ingericht, zodat de beheerder precies bepaalt wat een koppeling mag zien en doen.
De koppeling praat met AFAS via REST, met een token en het nummer van de AFAS-omgeving. Een API-call naar AFAS mag in totaal maximaal 75 MB zijn; dat telt ook voor bestanden via de FileConnector.
Voor bestellen bij de groothandel heeft AFAS zelf al een OCI-koppeling met onder meer Technische Unie: de inkoper vult een winkelmand in de webshop van de groothandel en die komt als inkoopaanvraag in AFAS terug.
Waar je op let
Drie dingen die vooraf moeten kloppen
- Wie in AFAS de connectoren mag aanmaken en het token uitgeeft.
- Welke projectstructuur je gebruikt, zodat uren op de juiste regel landen.
- Of bestanden, zoals foto's in hoge resolutie, binnen de grens van 75 MB per API-call blijven.
Veelgestelde vragen
Veelgestelde vragen
Wat is het verschil tussen een AFAS koppeling en de AFAS API?
De API is de technische ingang van AFAS. Een koppeling is wat je daarmee bouwt: een vaste stroom van gegevens tussen AFAS en een ander systeem, zoals uren van de werkbon naar het project.
Moet onze AFAS-beheerder iets doen?
Ja, een keer. De beheerder richt de connectoren in en maakt een token aan voor de koppeling. Wij geven precies door welke connectoren nodig zijn.
Kunnen we bij Technische Unie bestellen vanuit AFAS?
AFAS heeft daar een eigen OCI-koppeling voor. Wil je bestellen vanuit een werkbon of project in een ander systeem, dan sluiten we daarop aan.
Voorstel op maat
Voorstel aanvragen: AFAS
Elk bedrijf werkt met andere software en andere afspraken, dus elk voorstel is op maat. Vertel kort hoe het nu gaat. We bellen of mailen je terug met een voorstel.
- Eerst een voorstel, daarna pas bouwen
- Geen verplichtingen tot je akkoord geeft op een voorstel