How to Connect to AFAS Software
This guide walks you through the steps required to connect your AFAS Profit environment using an App Connector.
We support multiple employments per employee and to use the EmployeesOne endpoint, you need to import the preconfigured GetConnector Employment_data available for download in this guide. This connector requires AFAS version 6 or later due to the data collection method used.
If you’re using AFAS version 5, you can develop your own custom connector. It should be structured around Employee/Contract data and subsequently consolidated at the Employment level.
AFAS has confirmed that all clients will be migrated to version 6 within the next few months and you can expedite the migration process if needed.
1. Add a New App Connector
- Log in to AFAS Profit
- Navigate to:
General → Management → App Connector
- Click New
Use the following settings:
- Description:
Apideck
or the name of your app - Automatically generate a token
- Create a new user group based on the App Connector name
2. Add GetConnectors
- Download the preconfigured
GetConnectors
ZIP file here:
Download GetConnectors Files (ZIP) - In the App Connector wizard, go to the GetConnectors step
- Click Actions → Import to import the GetConnectors you've downloaded
Required GetConnectors
Employees
Employment_data
Organization_Chart
Customizing GetConnectors
To modify the fields, edit the imported GetConnectors. If you need to add custom fields, add them to the Employment_data GetConnector. This connector returns all data for a specific employee, including multiple employments.
- Go to the app connector / GetConnectors
- Double-click to edit
- Select Data
- Add or remove any fields as needed
Once imported, skip the UpdateConnectors step and click Finish
3. Copy the User Token
- After finishing the App Connector wizard, a user token will be shown
- This token is displayed only once, so make sure to copy and store it securely
To regenerate the token:
-
Navigate to:
General → Management → App Connector → User Tokens → New
4. Set Access Rights for the New User Group
- Go to:
General → Management → Authorisation tool → Group maintenance
- Open the newly created user group
- In the Authorisation tab, enable:
- HRM - Werkgevers
- HRM - Medewerkers
5. Vault Connection Setup
Now that your App Connector is configured, you can set up the connection in Vault.
- The Environment name contains your company number, followed by the environment type
E.g.12345.rest
is for production - Enter the names of the GetConnectors that you have previously imported into AFAS or created yourself
- The User Token has to be added with the tags: