Introduction
By setting up the integration between AFAS and YourCampus you will achieve following:
All the existing employees in your AFAS Profit account will be added to YourCampus
Any mutations in AFAS (on and off-boarding of employees) will automatically be synced with YourCampus on a daily basis
This integration grants YourCampus 'Read-Only' access to your AFAS account.
Setting up the integration
To set up the integration you will need to complete the following steps, each step is outlined in detail in this article:
Create a new System User for the YourCampus API
Place the newly created user in the External Access Group. This group should give usage access to the GetConnectors. Create the group if it does not exist yet.
Create a custom field to filter out users that do not have access to YourCampus benefits
Import or add a GetConnector that gives access to your Profit Employees
Add an AppConnector and associate the GetConnector with it
Share the User Token from the AppConnector setup
The required fields are:
Email
First Name
Last Name
Employment Status (if available)
Termination Date
Department
Optional fields:
Birthday
Hire Date
YourCampus API System User
1) Adding the System User
Navigate to the following section: General > Management > Authorization tool
( Algemeen > Beheer > Autorisatie tool )
Then from the toolbar: User -> New System User ( Gebruiker -> Nieuwe systeemgebruiker )
Fill in the user and description fields (ex. 12345.YourCampusAPI) and only give access to the “Profit Windows” section on the next step. You can skip the email field in the last step.
2) Adding the System User to the External Usage Group
In the authorization tool add in the Group Maintenance (Onderhoud groepen) tab select the External Access Group (default PR-006 - Externe toegang: connector gebruikers (Profit)). If this group does not exist please create an equivalent one.
In the Users in Group (Gebruikers in groep) tab add the newly created User to the group by clicking on the New button.
Video here
YourCampus Custom Field
This step is required when not all of your employees should have access to the YourCampus benefits.
1) Adding the Custom Field
Navigate to the following section: General > Management > Management tool
( Algemeen > Beheer > Management tool )
Select the “Medewerker” function group (functiegroep) then the “Employee” (Medewerker) section. In the Fields (Velden) tab add a new field of type “Yes/No” (Ja/Nee) called “YourCampus_Access”.
Here you can either import the custom field as supplied by YourCampus
from the following URL https://yourcampus-static-assets.s3.amazonaws.com/utils/Employee_YourCampus_Access.fie
(SHA256 d885162df7d64914815df09df5515565503368a1af90d9328d7b8f62e379b537)
Video tutorial
After setting up the field go to the Tabs (Tabbladen) tab and add a new tab called “YourCampus” and drag the “YourCampus” Custom field to the right side.
The authorization tab will open, make sure your admin users have the maintain permissions enabled on the new field.
Video tutorial
2) Using the Custom Field
Note: The system might request to restart in order to apply the tab and field.
Navigate to the following section: General > HR > Employee
(General > HR > Medewerker)
Select an employee and scroll to the YourCampus tab where you can check or uncheck the new field.
Video tutorial
YourCampus GetConnector
In order to get the necessary employee data we will need to import a GetConnector provided by YourCampus.
Note: Make sure you have the import permissions otherwise you will need to recreate a GetConnector based on the existing Profit_Employees GetConnector with the addition of the YourCampus custom field.
1) Download and import the YourCampus GetConnector from the following link
(SHA256 ce82abff3cb1a2ca3f9d2e7115d938d9ac674ab90a3e04aa3c6866e5256e5738)
Navigate to the following section: General > Output > Management > GetConnector
(Algemeen > Uitvoer > Beheer > GetConnector)
Click on the Import (Importeren) button and add the file downloaded earlier.
Note: If you are missing the import button please follow the following official guide on how to enable it https://help.afas.nl/help/NL/SE/120594.htm
Video tutorial
2) Create an App connector
Navigate to the following section: General > Management > App connector
(General > Beheer > App connector)
Click the New button and add a description “YourCampus App connector” and associated to the group indicated at step 1) (PR-006 - Externe toegang: connector gebruikers (Profit))
After creating the App connector your will be redirected to the edit view where you need to perform the following steps
Uncheck the “Blocked” (Geblokkeerd) box in the General (Algemeen) Tab (note: if you add a Token Validity Period (Geldigheidsduur), make sure you inform YourCampus before it expires in order to keep the integration running)
In the GetConnectors tab click the New button and add the previously imported GetConnector (Profit_Employees_YourCampus)
In the User tokens (Gebruikerstokens) tab click on the New button and add the previously created user (YourCampusAPI) and add a description
You will finally be redirected to a Generated Token screen. Here you can copy the code and securely share it afterwards with YourCampus together with your AFAS account id (ex. 12345).
Ex. <token><version>1</version><data>610C51AE2FFE4B2C8E33D5A5EB163E12735C72A44D98C278C5E7B5B560079BC1</data></token>
Video Tutorial