Products › Payroll Adapter
Payroll Adapter.
HR data in, payroll results out.
A payroll adapter is a bidirectional connector between Payroll Engine and an HR or ERP system. Inbound: the adapter reads employee master data and contract records from the source system and syncs them into Payroll Engine — eliminating manual re-entry and keeping the tenant current. Outbound: selected adapters post the computed payroll results back to the finance side of the same ERP — as journal entries, ledger lines, or result files. Adapters run as a standalone console or background service via the PayrollEngine.Adapter framework.
Payroll Engine never overwrites HR master data. The source system stays authoritative for employee records; Payroll Engine is authoritative for computed payroll results. Outbound posts results to the finance side — a different system-of-record than the HR master data.
→
Inbound
All connectors
HR master data and contract records flow from the source system into Payroll Engine — eliminating manual re-entry and keeping the tenant current.
AdapterSync
AdapterTest
⇆
Outbound
Bidirectional connectors
Computed payroll results flow from Payroll Engine to the ERP finance side as journal entries, ledger lines, or result files.
AdapterExport
Bidirectional Adapters
Import master data & export payroll results
⇄ Import + Export · Dynamics 365, Sage, Odoo, AFAS, Papaya Global, CSV, JSON
Bidirectional adapters connect to an ERP or file format that owns both HR master data and a finance ledger. They import employee and contract data into Payroll Engine and post the computed payroll results back to the ERP finance side as journal entries, ledger lines, or result files. Both flows stay independent — neither overwrites the other's system-of-record.
ERP System
HR data + finance
Adapter
Host
Payroll Engine
Backend
Inbound (AdapterSync): master data flows into Payroll Engine. Outbound (AdapterExport): computed results are posted to the ERP finance side — a different system-of-record than the HR master data.
Available Adapters
Import + export with Dynamics 365 Finance & Operations
Imports employee and employment data from Microsoft Dynamics 365 Finance & Operations via OData v4 data entities. Authenticates via Microsoft Entra ID (Azure AD) client-credentials. Exports payroll results as journal and ledger lines via OData. Designed for enterprise ERP deployments across all supported country regulations.
- Employee identity, employment dates, and contract data
- Compensation (fixed monthly salary, hourly rate, weekly hours)
- Multi-company support via cross-company queries and legal entity filter
- Delta sync on ModifiedDateTime — automatic token refresh before expiry
- Exports results as journal/ledger lines via OData
Import + export with Sage
Imports employee and payroll data from Sage accounting and payroll systems. Supports multiple Sage product lines used across Europe and the US. Exports computed payroll results to a configurable Sage endpoint.
- Employee records and employment details
- Payroll-relevant fields (tax codes, NI categories, pay elements)
- Cost centre and department structure
- Historical pay data for retro-capable setup
- Exports payroll results to a configurable Sage endpoint
Import + export with Odoo
Bidirectional ERP connector for Odoo via XML-RPC. Imports employee and contract master data into Payroll Engine and exports computed payroll results as journal entries to the Odoo accounting module. Odoo has no native UK payroll — Payroll Engine fills that gap while Odoo remains authoritative for HR master data.
- Imports hr.employee and hr.contract records into the universal AdapterImport case
- Configurable field mapping to country-specific regulation CaseFields
- Exports payroll results as account.move journal entries per payroll period
- Balancing clearing-account line for clean general ledger posting
Import + export with AFAS Software
Imports employee master data, employment contracts, and HR records from AFAS — the Dutch ERP and HRM platform used by thousands of Dutch companies. Exports computed payroll results back to AFAS via UpdateConnector.
- Employee master data (personal, contact, address)
- Employment contracts and salary records
- HR events (hire, change, leave, termination)
- Cost center and department assignments
- Exports payroll results via AFAS UpdateConnector
Import + validation with Papaya Global EOR
Bidirectional adapter for Papaya Global — the enterprise platform for global payroll, EOR, and payments (160+ countries). Imports worker master data via the PG API, runs a parallel payroll calculation in Payroll Engine, and validates results against Papaya's ICP calculation with a per-category delta report.
- Worker identity, employment, and compensation data via PG REST API
- Universal AdapterImport schema — one mapping template for all 11 countries
- Validation engine compares PG ICP results against PE payrun results
- Per-category delta report (tax, social security, net pay) with deviation status
- Full sync with automatic pagination — Bearer Token authentication
Import + export via CSV files
Imports employee master data and payroll inputs from structured CSV files — a universal format adapter for any source system that can produce delimited exports. Exports computed payroll results to a result CSV file for downstream consumption.
- Employee master data (personal, contact, address)
- Employment contracts and salary records
- Payroll input variables and absence data
- Configurable column mapping and date formats
- Exports payroll results to a result CSV file
Import + export via JSON files
Imports employee master data and payroll inputs from structured JSON files — a universal format adapter with dynamic field flattening for any source system that emits JSON. Exports computed payroll results to a result JSON file for downstream consumption.
- Dynamic field flattening of arbitrary JSON documents
- Configurable field mapping to the universal AdapterImport schema
- Employee master data, contracts, and payroll input variables
- Exports payroll results to a structured result JSON file
Inbound Adapters
Import master data only
→ Import only · SAP SuccessFactors, Workday, Personio, PayFit, Silae
Inbound adapters import employee and contract master data from an HR or HCM platform into Payroll Engine (Full Sync or Delta Sync). The source system stays authoritative for employee records; Payroll Engine never writes back. Payroll output is consumed via the REST API, reports, or a file-based bidirectional adapter.
Source System
HR / HCM platform
Adapter
Host
Payroll Engine
Backend
Single flow (AdapterSync): the adapter pulls master data from the source and writes it into Payroll Engine. The Adapter Host runs on a schedule (service mode) or on-demand (console mode).
Available Adapters
Import from SAP SuccessFactors Employee Central
Imports identity, employment, job, and compensation data from SAP SuccessFactors Employee Central — the global HXM cloud suite used by enterprises worldwide.
- Personal data (date of birth, gender, national ID, tax ID)
- Employment and job information (start/end, FTE, weekly hours)
- Recurring compensation (base salary, hourly rate)
- Bank account IBAN via payment information entity
Import from Workday Human Capital Management
Imports worker and employment data from Workday HCM via the REST API v1. Authenticates via OAuth 2.0 client-credentials (Integration System User). Designed for global enterprise deployments across all supported country regulations.
- Worker identity, employment, and job data
- Compensation (base pay, hourly rate, scheduled weekly hours)
- Configurable field mapping to the universal AdapterImport schema
- Full sync via REST v1 limit/offset paging — automatic token refresh
Import from Personio
Imports employee profiles, employment data, and HR events from Personio — the leading European HR platform for SMEs, available in multiple countries.
- Employee profiles and personal data
- Employment type, salary, and contract data
- Absences, time tracking, and HR events
- Custom attributes and multi-country setups
Import from PayFit
Imports employee identity, contract, and time data from PayFit — the European payroll SaaS platform operating in France, Germany, Spain, and the UK.
- Employee identity (SSN, date of birth, gender, IBAN)
- Contract data (start/end dates, employment type)
- Time information (weekly hours, full-time equivalent)
- Multi-country support via country-specific contract endpoints
Import from Silae
Imports employee master data and payroll inputs from Silae — the leading French payroll platform used by payroll bureaus and HR departments across France.
- Employee master data and personal records
- Payroll input variables (variable pay, absences)
- Collective agreement and classification data
- Contract types and employment details
Deployment
How adapters run
Console Host
PayrollEngine.Adapter.Host.Console
Extension of the pecmd CLI. Adds adapter commands for one-shot or scheduled imports. Pass the adapter configuration file as argument — suitable for CI pipelines, cron jobs, and on-demand runs.
pecmd Extension
One-Shot
CI / Cron
Service Host
PayrollEngine.Adapter.Host.Service
Windows / Linux background service for continuous operation. Runs adapters on a configurable polling interval with automatic reconnect. Ideal for production deployments that require ongoing, hands-free HR data synchronization.
Service
Continuous
Auto-Reconnect