By setting up the integration between AFAS and Alleo you will achieve following:
Employees in your AFAS Profit account will be added to Alleo.
Any mutations in AFAS (on and off-boarding of employees) will automatically be synced with Alleo on a daily basis.
This integration grants Alleo '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 System User for the Alleo integration
Create a New User group with the appropriate access levels
Place the newly created System User + your own AFAS user in the User Group
Creation of custom fields (optional)
Create two new GetConnectors by importing templates (for Employees and Contracts)
Create App Connector
Share App Connector Token and Profit ID with Alleo.
Required fields
The following information is synced via the GetConnectors:
Email (Mail)
First Name (FirstName)
Last Name (BirthName)
Prefix (PrefixBirthName)
Termination Date (EmploymentEnd)
Department
Alleo Access
Optionally custom budget fields
Date of Birth (DateOfBirth)
Hire Date (EmploymentStart)
Step 1: Create a new group for the Alleo integration
Go to General > Management > Authorization tool
Go to the tab Group maintenance
Go to New
Name the Group, for example Alleo Group
Click Finish
Step 2: Create a System User for the Alleo integration
Go to General > Management > Authorization tool
Go to the tab User maintenance
Go to New system user
Name the User, for example 1234.AlleoAPI
Give access to the “Profit Windows” in the Access section
[optional - only if you have an AFAS Accept subscription]
Give access to the “AFAS Accept” in the Advanced sectionSkip the email field in the last step
Click Finish
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.AlleoAPI) and give access to the “Profit Windows” and, if an AFAS Accept subscription is active, "AFAS Accept" section on the next step. You can skip the email field in the last step.
In the Authorization (Autorisatie) tab go and Activate the following HR -> Employee - Employee MSS -> Filters -> HR Employees -> Alle Medewerkers
( HRM -> Medewerker -> Medewerker MSS -> Filters -> HR Employees -> Alle Medewerkers)
2) Adding the System User to the Alleo Group
In the authorization tool add in the Group Maintenance (Onderhoud groepen) tab select the Alleo Group.
In the Users in Group (Gebruikers in groep) tab add the newly created User to the group by clicking on the New button.
PS: If you cannot add the user to the group, make sure to select 'manual' instead of 'fill based on function'
Alleo Custom Field
This step is required when not all of your employees should have access to the Alleo benefits.
1) Adding the Custom Field
Navigate to the following section: General > Management > Management tool
( Algemeen > Beheer > Management tool > Employee > employee )
Import the custom field as supplied by Alleo
from the following URL https://yourcampus-static-assets.s3.eu-west-1.amazonaws.com/utils/Employee_Alleo_Access.fie
(SHA256 209dae38f1d74809872eff2af0c207fa64b0ec6506ae91bd822e3079b6eeb719)
After setting up the field go to the Tabs (Tabbladen) tab and add a new tab called “Alleo” and drag the “Alleo” 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.
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 > Employee
(General > HR > Medewerker > Medewerker )
Select an employee and scroll to the Alleo tab where you can check or uncheck the new field.
Optional: Assigning varying budgets
If you would like to vary the Alleo budget assigned to employees, this can be achieved by adding custom field(s) in AFAS to indicate per employee what the budget is that she should receive. Follow the instructions in this article to set this up.
Alleo GetConnectors
In order to get the necessary employee data we will need to import the GetConnectors provided by Alleo.
Note: Make sure you have the import permissions otherwise you will need to recreate the GetConnectors with the addition of the Alleo custom field.
1) Download and import the Alleo GetConnectors from the following link
(sha256: 635e49106a3b23a5e38a64edf77061fed7e134a32f5438a60cb34b55b3cf53b8)
(sha256: 48e99ed46abac6af71917304c1d7d353d9b4a8dc146aa4e10e3d26c038c68467)
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
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 “Alleo App connector” and associated to the group indicated at step 1) - Alleo Group
Toggle Automatic token generation (Automatisch token genereren)
Use the existing Alleo Group and the Alleo API user you created in step 1 and 2
In the GetConnectors tab click the New button and add the previously imported GetConnectors (Profit_Employees_Alleo and Profit_Contract)
You will finally be redirected to a Generated Token screen. Here you can copy the code and securely share it afterwards with Alleo together with your AFAS account id (ex. 12345).
Ex. <token><version>1</version><data>610C51AE2FFE4B2C8E33D5A5EB163E12735C72A44D98C278C5E7B5B560079BC1</data></token>