--- title: How to integrate with AFAS  description: A step by step guide on how to set up an integration between AFAS and Ravio --- [Skip to content](https://help.ravio.com/afas#main-content) English Show submenu for translations ![Ravio logowhite](https://help.ravio.com/hs-fs/hubfs/Ravio%20logowhite.png?width=124&height=45&name=Ravio%20logowhite.png) Open main navigation Close main navigation - English Show submenu for translations - [Contact us](https://fa3fd.share-eu1.hsforms.com/2IkfMVpstTUWvffP5uESSLg) [Contact us](https://fa3fd.share-eu1.hsforms.com/2IkfMVpstTUWvffP5uESSLg) How can we help you? - There are no suggestions because the search field is empty. 1. [Ravio Help Centre](https://help.ravio.com/?hsLang=en) 2. [Integrations and data sharing](https://help.ravio.com/integrations-and-data-sharing?hsLang=en) 3. [Setting up your HRIS integration](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#setting-up-your-hris-integration) # How to integrate with AFAS ## A step by step guide on how to set up an integration between AFAS and Ravio ### How to set up the integration *Estimated, overall set up time: 10 minutes* On a high-level, integrations with AFAS always work through using 'connectors' that expose the required data. To set up the integration you will need to 1. Create an App connector 2. Unblock the App connector Additionally, depending on the data you need, you might also need to add and import a custom GetConnector. The rest of the guide, is a detailed step-by-step introduction on how to set up the integration.  ### Adding custom GetConnectors **Only if** you see either of these fields when setting up the integration: - **Read employments** - **Read groups** ![](https://help.kombo.dev/hc/article_attachments/19608242438161) Download our custom [GetConnector for employees](https://storage.googleapis.com/kombo-assets/connection-guides/afas/custom_employees.gcn). You will need it later in step 5 of [creating an app connector](https://connection-guides.com/guides/Ravio-b73uV48FdZD57HyXr8W4Raah.eu/afas/hris/18767909752337-Connect-your-AFAS-Software-account#h_01HAYFH0CH4QJNETCN422SSPV1). If you don't see either of these fields, skip this section and just continue with the rest of the guide. ### Creating an app connector 1. Go to **General \> Management \> App connector**: ![Screenshot 20231-10-24 at 12.07.58.png](https://help.kombo.dev/hc/article_attachments/19606264139409) 2. Click "**New**" on the top left of the window that just opened: ![SCR-20231024-qgql.png](https://help.kombo.dev/hc/article_attachments/19606264143761) 3. Give the connector any description you like, i.e.: "**App connector for integration**". Then, make sure that the "**Generate a token automatically**" is toggled on in the dialog: ![SCR-20231024-psul.png](https://help.kombo.dev/hc/article_attachments/19606270290065) 4. Select "**Create a new user group based on App connector name**" and click "**Next" ![](https://help.kombo.dev/hc/article_attachments/27708894806289)** 5. **If you had to download a custom GetConnector, follow the sub-section here. Otherwise continue with step 6.** 1. Click on "**Action"** then **"Import": ![](https://help.kombo.dev/hc/article_attachments/27708888250001)** 2. Click on "**1. File**" ![](https://help.kombo.dev/hc/article_attachments/27708888251153) 3. Select the [file you downloaded](https://connection-guides.com/guides/Ravio-b73uV48FdZD57HyXr8W4Raah.eu/afas/hris/18767909752337-Connect-your-AFAS-Software-account#01HQQY15CGB7QX03QR8G9TX9KZ) as part of the preparation and click "**Open**": ![](https://help.kombo.dev/hc/article_attachments/27708894816529) **Note: If you're connecting to AFAS via Citrix web, you'll have to [upload the connector files before they can be imported](https://help.kombo.dev/hc/en-us/articles/27725292480145).** 4. Click on "**Finish**" ![](https://help.kombo.dev/hc/article_attachments/27708879917457) 6. Click on "**Next**" ![](https://help.kombo.dev/hc/article_attachments/27708879918097) 7. Click on "**Finish**" ![](https://help.kombo.dev/hc/article_attachments/27708904839057) 8. A new dialog should pop up, and you will be able to see your token. You **won’t be able to access it again**, so save it somewhere secure: ![SCR-20231024-qbtr.png](https://help.kombo.dev/hc/article_attachments/19606270318481) #### **Tip: how to copy your token out of the Citrix workspace** If you’re accessing AFAS via remote Desktop, you can’t use your Clipboard outside the remote Desktop. If you don’t want to copy the token by writing it down, you can copy it like this: 1. Click on "**Copying**": ![SCR-20231024-qbtr.png](https://help.kombo.dev/hc/article_attachments/19606270322193) 2. Now click the three white lines at the top middle of your screen: ![SCR-20231024-pogg.png](https://help.kombo.dev/hc/article_attachments/19606264077201) 3. A few icons should appear, click the one that looks like a clipboard: ![SCR-20231024-qegv.png](https://help.kombo.dev/hc/article_attachments/19606264180241) 4. A new window should open, you can now copy the contents by pressing "**Ctrl + C**" and use it anywhere outside of Citrix: ![Screenshot 2023-02-02 at 16.48.17.png](https://help.kombo.dev/hc/article_attachments/18769740728209) ### Unblock the app connector 1. Open the properties of the app connector. To do this, go to the app connectors page and **double click** the name of your connector 2. Go to **"General"** and make sure there is **no check mark** left to the field that says **“Blocked”: ![SCR-20231024-qhmy.png](https://help.kombo.dev/hc/article_attachments/19606264180753)** 3. Click on **"Save and close".** ### Adding additional connectors to your App connector Some additional connectors may be required for the integration to work correctly. In this case you will see the highlighted section in the connection flow (***you can skip this step if the highlighted section is not shown***): ![](https://help.kombo.dev/hc/article_attachments/34699528839313) 1. Based on the additional connectors asked in the connection flow, go to either the "***GetConnectors***" or "***UpdateConnectors***" tab, and click on "***New***":![](https://help.kombo.dev/hc/article_attachments/34699656653585) 2. Search for the connector by its "***Connector ID***", click on the checkbox next to the connector, and click on "***Finish***": ![](https://help.kombo.dev/hc/article_attachments/34699634163857) Please repeat this step until you have added all the additional connectors displayed in the connection flow. ### Composing the AFAS service domain The service domain of your AFAS instance takes the form of "**\.rest.afas.online**" You have to replace the **"environmentID"** with the five digit number of your environment name. Your environment name can be found at the top of your Profit workspace and will look something like this: **"O12345AA"** (the first letter is a capital **“O”,** not a 0) So in this case your service domain will be: **"12345.rest.afas.online"** - ⚠️ You have to use an AFAS production environment. Production environment names are always prefixed with the capital letter “O”, so make sure it looks like this "**O12345AA**" and not like this "**A12345AA**" (which would be an “accept” environment) - When entering the environment ID, make sure to remove the **O** and **AA**, so that the URL only contains the five digits (e.g. **"12345.rest.afas.online"**) ### Adding the integration 1. Paste the service domain and user token into the connection flow and click “**Set up integration**”: ![Screenshot 2023-02-02 at 16.51.53.png](https://help.kombo.dev/hc/article_attachments/18769693613713) - [Getting started](https://help.ravio.com/getting-started?hsLang=en#main-content) - [Onboarding](https://help.ravio.com/getting-started?hsLang=en#onboarding) - [Benchmarking](https://help.ravio.com/getting-started?hsLang=en#benchmarking) - [Pay equity](https://help.ravio.com/getting-started?hsLang=en#pay-equity) - [Video guides](https://help.ravio.com/getting-started?hsLang=en#video-guides) - [Using Ravio with AI tools](https://help.ravio.com/getting-started?hsLang=en#using-ravio-with-ai-tools) - [Integrations and data sharing](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#main-content) - [Setting up your HRIS integration](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#setting-up-your-hris-integration) - [Variable and equity data](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#variable-and-equity-data) - [Manually sharing employee data](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#manually-sharing-employee-data) - [Setting up your ATS integration](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#setting-up-your-ats-integration) - [Managing your integration](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#managing-your-integration) - [Video guides](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#video-guides) - [Ravio feature guides](https://help.ravio.com/ravio-feature-guides?hsLang=en#main-content) - [Salary bands](https://help.ravio.com/ravio-feature-guides?hsLang=en#salary-bands) - [Explore the market](https://help.ravio.com/ravio-feature-guides?hsLang=en#explore-the-market) - [Employee mapping & levelling](https://help.ravio.com/ravio-feature-guides?hsLang=en#employee-mapping-levelling) - [Manage my data](https://help.ravio.com/ravio-feature-guides?hsLang=en#manage-my-data) - [Settings](https://help.ravio.com/ravio-feature-guides?hsLang=en#settings) - [Analyse your company](https://help.ravio.com/ravio-feature-guides?hsLang=en#analyse-your-company) - [EU Pay Transparency](https://help.ravio.com/ravio-feature-guides?hsLang=en#eu-pay-transparency) - [User and access management](https://help.ravio.com/user-and-access-management?hsLang=en#main-content) - [User permissions](https://help.ravio.com/user-and-access-management?hsLang=en#user-permissions) - [Single Sign On (SSO)](https://help.ravio.com/user-and-access-management?hsLang=en#single-sign-on-sso) - [Benchmarking and data confidence](https://help.ravio.com/benchmarking-and-data-confidence?hsLang=en#main-content) - [Data](https://help.ravio.com/benchmarking-and-data-confidence?hsLang=en#data) - [Troubleshooting and support](https://help.ravio.com/troubleshooting-and-support?hsLang=en#main-content) - [Contact support](https://help.ravio.com/troubleshooting-and-support?hsLang=en#contact-support) - [FAQ](https://help.ravio.com/faq?hsLang=en#main-content) - [Billing and invoices](https://help.ravio.com/faq?hsLang=en#billing-and-invoices) - [Compliance](https://help.ravio.com/faq?hsLang=en#compliance) - [Ravio community](https://help.ravio.com/faq?hsLang=en#ravio-community) - [Sales](https://help.ravio.com/faq?hsLang=en#sales) - [Integrations](https://help.ravio.com/integrations?hsLang=en) - [Uncategorized](https://help.ravio.com/uncategorized?hsLang=en) - Home - Products - Pricing - Blog - Company [![Ravio logo1](https://help.ravio.com/hs-fs/hubfs/Ravio%20logo1.png?width=105&height=38&name=Ravio%20logo1.png "Ravio logo1")](http://ravio.com) [mailto:hello@ravio.com](mailto:hello@ravio.com) Copyright © 2026, Ravio Technologies Ltd