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

create-app-connector


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

import-getconnector

Required GetConnectors

  • Employees
  • Employment_data
  • Organization_Chart

imported-getconnector

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

edit-getconnectors

Once imported, skip the UpdateConnectors step and click Finish

skip-update-getconnector


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

copy-usertoken

To regenerate the token:

  • Navigate to:
    General → Management → App Connector → User Tokens → New

    generate-new-usertoken


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 authorize-group1
  • HRM - Medewerkers authorize-group2

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:
<token>
  <version>1</version>
  <data>ABC</data>
</token>

vault-configuration