Go to YourCampus


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:

  1. Create a new System User for the YourCampus API

  2. 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.

  3. Create a custom field to filter out users that do not have access to YourCampus benefits

  4. Import or add a GetConnector that gives access to your Profit Employees

  5. Add an AppConnector and associate the GetConnector with it

  6. 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

(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

Did this answer your question?