How to Connect to AFAS Software

This guide walks you through the one-time setup in AFAS Profit so Apideck can read from (and write to) your environment.

The setup is the same whether you're using the HRIS API, the Accounting API, or both — just import the GetConnector package that matches the vertical you need (or both).

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 — leave checked.
Create a new user group based on the App Connector name — leave checked.

create-app-connector

2. Import GetConnectors

Apideck maintains pre-configured GetConnector packages with all the fields we map. Import the one(s) you need:

Vertical	Package
HRIS	AFAS_Getconnectors_HRIS.zip
Accounting	(ZIP forthcoming — see "Manual enablement" below)

Manual enablement (accounting, until the ZIP ships)

For accounting, add each connector below manually via App Connector → GetConnectors → Actions → Add → search for name. This takes a few minutes once per environment.

In the App Connector wizard:

Go to the GetConnectors step.
Click Actions → Import.
Select the ZIP for your vertical.

import-getconnector

GetConnectors — HRIS

Employees
Employment_data
Organization_Chart

GetConnectors — Accounting

Profit_Debtors — customers
Profit_Creditors — suppliers
Profit_FinancialAccounts — ledger-accounts
Profit_VAT_code — tax-rates
Profit_Transactions — journal-entries (read)
Profit_Employers — company-info + subsidiaries
Profit_SalesInvoices — invoices
Profit_PurchaseInvoices — bills
Profit_CreditNotes — credit-notes (tenants without a dedicated credit-notes connector can point at Profit_SalesInvoices filtered to CreditnotaVerkoop)
Profit_Payments — customer payments
Profit_BillPayments — supplier payments
Profit_Items — invoice-items
Profit_Projects — projects
Profit_BankAccounts — bank-accounts
Profit_DimAx1 — tracking-categories (override to DimAx2..5 per tenant preference)
Profit_OpenItemsDebtors — aged-debtors
Profit_OpenItemsCreditors — aged-creditors
Profit_PurchaseOrders — purchase-orders
Profit_SalesQuotes — quotes
Profit_EmployeeExpenses — expenses
Profit_ExpenseCategories — expense-categories
Profit_ExpenseReports — expense-reports
Profit_Warehouses — locations
Profit_ItemCategories — categories
Profit_AttachedDocuments — attachments (tenant-defined — see below)
Profit_BalanceSheet — balance-sheet (tenant-defined — see below)
Profit_ProfitAndLoss — profit-and-loss (tenant-defined — see below)
Profit_Refunds — refunds (tenant-defined — see below)

Tenant-defined GetConnectors: AFAS ships no Profit_Refunds, Profit_BalanceSheet, Profit_ProfitAndLoss, or Profit_AttachedDocuments by default. If you need these resources, create your own GetConnectors with matching names (or point the relevant setting in the Vault configuration at an existing custom GetConnector).

imported-getconnector

Customizing GetConnectors

To modify the fields for any imported GetConnector:

Open the App Connector → GetConnectors tab.
Double-click the GetConnector you want to edit.
Select Data and add/remove fields as needed.

For HRIS, custom fields should be added to Employment_data (returns all data for a given employee).

edit-getconnectors

3. Add UpdateConnectors (only if you need write access)

Add these UpdateConnectors in the App Connector wizard (Actions → Add UpdateConnector) only if you plan to use the matching write endpoints:

UpdateConnector	Enables
`KnSalesRelationPer`	customers — add / update
`KnSalesRelationOrg`	customers — add / update (legal entities)
`KnPurchaseRelationPer`	suppliers — add / update
`KnPurchaseRelationOrg`	suppliers — add / update (legal entities)
`FiAccount`	ledger-accounts — add / update
`FiEntries`	journal-entries — add / delete
`FbSalesLines`	invoices — add
`FbDirectInvoice`	bills — add
`FbPayments`	payments — add

Skip this entire step if your integration is read-only.

4. Copy the User Token

After finishing the App Connector wizard, a user token is shown.
It's displayed only once — copy and store it securely.

copy-usertoken

To regenerate a lost token: General → Management → App Connector → User Tokens → New.

generate-new-usertoken

5. Set Access Rights for the New User Group

Go to General → Management → Authorisation tool → Group maintenance and open the user group that was created alongside your App Connector.

On the Authorisation tab, enable the modules that match your vertical:

Vertical	Enable
HRIS	HRM – Werkgevers, HRM – Medewerkers
Accounting	Financieel – Grootboek, Financieel – Debiteuren, Financieel – Crediteuren, Facturering, Inkoop

authorize-group1 authorize-group2

6. Vault Connection Setup

Back in the Apideck Vault:

Environment name — your company number followed by the environment type. Examples:
- 12345.rest — production
- 12345.restaccept — acceptance
- 12345.resttest — test

User Token — paste including the XML tags:


<token>
  <version>1</version>
  <data>ABC</data>
</token>

Custom connector names (optional) — if you renamed any imported GetConnector (or point at a custom one), fill in the matching field in the settings form. Defaults match the names in the tables above.

vault-configuration

Troubleshooting

403 Forbidden on specific resources — the GetConnector or UpdateConnector isn't added to your App Connector, or the user group lacks authorisation for the underlying module. Re-check steps 2, 3, 5.
Empty results despite data existing — your GetConnector's data-filter (in AFAS) excludes the rows. Open the GetConnector in AFAS → Data → clear the filter.
Profit_CreditNotes not found — your tenant doesn't ship that connector. Create a custom GetConnector (e.g. Profit_CreditNotes_Custom) based on Profit_SalesInvoices filtered to CreditnotaVerkoop, then point the credit_notes_connector setting in Vault at its name.
Balance sheet / P&L / refunds unavailable — these require tenant-defined GetConnectors. See the "Tenant-defined GetConnectors" callout in step 2.