PayPal - AFAS - Connect with AFAS manual
This guide explains how to set up an App Connector in AFAS to connect with Paypal. AFAS uses a unique connector system, so proper setup is essential for the integration to work.
1. Access AFAS Environment 🔑
Open Citrix Workspace (required for remote access).
Log in to AFAS: https://login.afasonline.com/
2. Navigate to App Connector Section 📂
Go to: General
>Management>App Connector
3. Create a New App Connector 🛠️
Click New.
Fill in the following details:
Description: Enter a clear name (e.g., "Databrydge - Paypal AFAS connection").
Generate token automatically: Enable this option.
Create a new user group: Select this to assign permissions.
Create a new user: Assign a dedicated user for the connector.
Click Next.
Adding GetConnectors and UpdateConnectors 🔗
Adding GetConnectors 📥
In the App Connector assistant, click Actions
>Import.Select the required GetConnector file and complete the import process.
Adding UpdateConnectors 📤
Click New under the UpdateConnectors tab.
Select the appropriate connectors from the list.
Click Next.
✅ Required GetConnectors (Fetch Data)
Profit_Administrations: Fetches administrations.Databrydge_Profit_Accounts: General Ledger Accounts*Databrydge_Profit_Journals: Journals*
⚠️ Note: All connectors marked with
*must be imported manually. See the section below.
Importing the Custom Connector
Most connectors are available in the standard connectors list. However, the following are custom connectors and must be imported manually:
Databrydge_Profit_Accounts
Databrydge_Profit_Journals
To import it, follow these steps:
Download the custom connector file.
Go to the connectors screen and click the Actions button.
In the displayed menu, select Import.
Click the File button and select the downloaded file.
Complete the import process.
✅ Required UpdateConnectors (Modify Data)
FiEntries: Saves transactions (purchase and journal transactions).
Generating and Storing the API Token 🔐
Once the assistant is completed, AFAS will generate an API token.
⚠️ Important: This token is displayed only once. Copy and store it securely.
Configuring Permissions & Authorizations🔒
To ensure the App Connector only accesses necessary data, follow these steps:
1. Access the Authorization Tool
Go to: General
>Management>Authorization Tool
2. Assign User to the Correct Group
In the User Maintenance tab, select the user you created for the connector.
Switch to the Member Group tab.
Click New and add the ADM record.
Testing the Connection 🧪
You can test the connection using tools like Postman, a script, or the AFAS Connection Test site.
Visit the AFAS Connection Test site:
AFAS Connection TestEnter your AFAS Online member number (your ID).
Select the appropriate environment type.
Enter the token you saved when you created the connection.
Press “Login with token”
Verify that the App Connector can:
✅ Read the necessary data.
✅ Post transactions to AFAS for the selected administration.
This is done by checking if the configured GetConnectors and UpdateConnectors are in the list of available connectors. If any issues arise, ensure the correct connectors are assigned and that permissions are configured properly.
Final Checks ✅
Ensure all required GetConnectors and UpdateConnectors are included.
Validate that the connectors work correctly by testing with real data and make sure it shows up in the configured AFAS-environment.