De AFAS-koppeling die we aanbieden stelt ons in staat om gegevens van gebruikers (zoals vrijwilligers of medewerkers) op te halen en te verwerken vanuit AFAS Profit. Hieronder volgt een uitleg over hoe deze koppeling werkt en welke informatie nodig is.
Benodigde Informatie
Adres van de GET-connector
Dit is de URL waarmee we verbinding maken om gegevens uit AFAS op te halen. Het ziet er bijvoorbeeld zo uit: https://12345.rest.afas.online/profitrestservices/connectors/Naam
Deze URL wijst naar een specifieke connector in AFAS, waarmee bepaalde data (zoals gebruikersinformatie) kan worden opgevraagd.
XML-token
Om toegang te krijgen tot de gegevens, is een XML-token nodig. Dit token wordt gebruikt om de authenticatie te regelen en ervoor te zorgen dat alleen geautoriseerde verzoeken worden verwerkt.
Het token ziet er als volgt uit: <token><version>1</version><data>xxxxx</data></token>.
Dit token wordt in de header van het verzoek meegestuurd om toegang te verlenen tot de data in AFAS.
Gegevens per gebruiker
Bij het ophalen van gegevens via deze koppeling verwachten we per gebruiker (account) de volgende informatie terug in JSON-formaat:
json
{"Id":"123456","FirstName":"Lorum","LastName":"Ipsum","MailAddress":"lorum.ipsum@mail.nl","Groups":"Locatie 1;Locatie 2"}
- Id: Dit is het unieke identificatienummer van de gebruiker binnen AFAS.
- FirstName: Voornaam van de gebruiker.
- LastName: Achternaam van de gebruiker.
- MailAddress: E-mailadres van de gebruiker.
- Groups: Groep(en) waaraan de gebruiker is gekoppeld, zoals een specifieke locatie. In het geval van meerdere locaties, dienen deze met puntkomma gescheiden te worden.
Filter voor Actieve Vrijwilligers/Medewerkers
Indien wenselijk stel je zelf binnen de GetConnector een filter in om te zorgen dat enkel actieve vrijwilligers worden opgehaald en verwerkt. Dit kan helpen om de gegevens binnen ons systeem up-to-date en relevant te houden.
Met deze koppeling kunnen we op een efficiënte en veilige manier gegevens uit AFAS Profit integreren in ons systeem, waarbij we ervoor zorgen dat alleen de benodigde en actuele informatie iedere nacht wordt opgehaald.
Koppeling testen
De output van de API kan op deze pagina getest worden: https://connect.afas.nl/tools/restget