How to Connect Personio GPC to Deel

The Personio Global Payroll Connect (GPC) integration is an API-based solution designed to eliminate manual data entry for your Global Payroll entities. This integration currently utilizes three core modules to automate your payroll lifecycle: People Match for record consistency, Global Payroll - People Data Sync for onboarding and employment changes, and Global Payroll - External Payroll Documents Sync for automated document management.

In This Article

• Before You Begin
• Step 1: Prepare Personio
• Step 2: Connect the Integration
• Step 3: Configure the People Data Sync plugin
• Step 4: Configure the External Payroll Documents Sync plugin
• Step 5: Verify and Sync

Before You Begin

You must have:

• Org Admin or Integrations Admin in Deel.
• In Personio:
  • A user with an admin role to manage API credentials and attribute access.
  • Admin access with Read permissions for all payroll-relevant employee attributes.

Supported Worker Types

• Global Payroll (GP)

Step 1: Prepare Personio

Before connecting to Deel, you must ensure Deel has the necessary permissions to read your employee data.

1. Log in to your Personio admin dashboard.
2. Navigate to Settings > Integrations > API credentials.
3. Select Deel from the list of connected integrations.
4. In the API credentials tab, click Generate new API credentials.
5. Copy the Client ID and Client Secret as you will need them in the next step.

Step 2: Connect the Integration

To establish the initial handshake between Deel and Personio:

1. Log in to the Deel App.
2. Navigate to More > Apps and search for Personio GPC.
3. Click Connect Personio GPC.
4. Enter your Personio base URL, then the Client ID, and Client Secret gathered in Step 1.
5. Click Connect & go to settings to confirm changes.

Step 3: Configure the People Data Sync plugin

This plugin defines the structural relationship between your Personio GPC paygroups and Deel payroll groups.

1. Click to Enable the Global Payroll - People Data Sync plugin.
2. Select the Personio GCP paygroup from the dropdown menu.
3. Select the Deel paygroup to map it to the corresponding Personio group.
4. Select a default permission group to assign access levels for the synced workers.

5. Enter the date format used in your Personio GPC environment to ensure accurate processing.

6. Click to Edit map data points that apply to all entities within your organization.

7. Click the Edit icon next to the relevant countries to map fields required for specific jurisdictions.

8. Click View under Source data to identify available items from Personio GPC if you are unsure of the correct mapping.

9. Click Continue.

10. Verify the final mapping logic and activate the sync for this paygroup.

Step 4: Configure the External Payroll Documents Sync plugin

This plugin syncs payroll documents when they are generated or uploaded on the Deel platform to your team's Personio profiles.

1. Navigate to the Plugins tab and select Global Payroll - External Payroll Documents Sync.
2. Map the Deel document categories to the specific document categories in Personio for Payslips, Tax Documents, and Other Documents.
3. Toggle ON the specific documents you wish to sync for each worker category:
   • Global payroll compliance, payslips, and payroll documents - Toggle on Employee payslips, Employment Agreement, and Tax documents.
   • EOR compliance, payslips, and payroll documents - Toggle on the relevant items. Deel only syncs EOR documents for employees who have granted permission on their account.
4. Select a date from which you want to back-sync historical documents. This date will be unset automatically after the next successful sync.
5. Click Back to confirm settings.

Step 5: Verify and Sync

1. Trigger your first sync by clicking Sync Integration in the dashboard.
2. Check the Sync Logs to confirm the data and documents have successfully transferred.