Comarch Optima

PeopleForce integration with Optima: HR data flows without exports

HR and payroll systems / Requires the Professional plan and the ERP Connector add-on

Requests, contracts and salary changes are created in PeopleForce and reach Optima on their own. Optima still runs payroll and sends back leave entitlements, payslips, PIT forms and sick leave. Your accounting firm no longer gets a monthly Excel file.

Capabilities

What changes in day-to-day work

Data is entered once, on the side where it actually originates, and the other side receives it ready to use.

Employee records that meet ERP requirements

At setup, we add to the employee profile the HR fields Polish payroll requires (identification, address, insurance and tax details), along with dictionaries of NFZ branches, ZUS branches and tax offices. We agree during implementation how these fields are first filled with data from Optima, so nobody retypes them by hand.
Employee records that meet ERP requirements

Leave requests reviewed in PeopleForce

The employee submits a request, the manager approves it, and the integrator passes the approved leave on to Optima. A rejected request is not passed on at all; a withdrawn one is deleted. Optima keeps the leave balance: corrections the HR team makes there reach PeopleForce on the next run and are not overwritten.
Leave requests reviewed in PeopleForce

Payslips and PIT forms in the employee's folder

The integrator sorts documents generated in Optima into their owners' folders. The files can be password-protected, and the whole batch is launched in Optima with a single action. Employees stop writing to HR to ask where their payslip is.
Payslips and PIT forms in the employee's folder

Sick leave from ZUS also reaches PeopleForce

Once the payroll team downloads electronic sick notes from eZUS into Optima, the integrator passes them to PeopleForce on the next run. The absence is then visible on the HR side without waiting for the month to close, and the employee profile shows the number of days used.
Sick leave from ZUS also reaches PeopleForce

How it works

What syncs, and in which direction

The integrator is a separate program launched from Windows Task Scheduler, so the exchange runs in cycles rather than instantly. Most data flows one way, from the master system (HR data from PeopleForce, leave entitlements from Optima), and that is where you change it. Only absences sync in both directions: requests are created and approved in PeopleForce, and an entry added or deleted in Optima also reaches PeopleForce. If the same absence entry changes on both sides between runs, the newer change is kept.

What movesDirectionWhenData scope
Employee record
Identification, address, insurance and tax details
PeopleForce Optima
recurring
one-off first import, in the other direction
PESEL, ID document, addresses, bank account numbers, NFZ and ZUS branch, tax office, NIP
Contracts and addenda
Contract register, with history
PeopleForce Optima
recurring
contract type, period, base salary, working time (FTE), position, department
Pay supplements
Bonuses, commissions, other components
PeopleForce Optima
recurring
requires mapping at setup
component name, amount, validity period
Absences
Leave, plus remote work and business trips
PeopleForce Optima
recurring
an entry added or deleted on one side is mirrored on the other
leave type, date range, employee
Documents from designated folders
Land in employees' e-files (e-teczka) in Optima
PeopleForce Optima
recurring
file from a PeopleForce folder, saved in the e-file under the specified document title
Leave entitlements
Arrive in PeopleForce as the employee's balance in the leave policy
Optima PeopleForce
recurring
entitlement for the current year, plus carry-over from the previous year
Sick leave
L4 sick notes downloaded from ZUS
Optima PeopleForce
recurring
date range, number of days used in the employee profile
Payslips, bills for mandate contracts (umowa zlecenie) and PIT forms
Documents generated in Optima
Optima PeopleForce
on demand
launched in Optima
PDF file in the specified employee folder, optionally protected with the PESEL number

A salary change sent from PeopleForce does not overwrite the record in Optima; it adds a new one, so the history of contracts and addenda stays complete.

icon
All PeopleForce integrations
A catalogue of ready-made connections, plus an API for building your own integrations

Setup

Two stages to launch

First a one-off import, then recurring operation. A dedicated Customer Success Manager guides you through both, together with the partner responsible for the integrator.

Stage 1

Initial import

The PeopleForce account is still empty, while Optima holds the full set of employee records.

  • We add to the profiles the HR fields Polish payroll requires, with NFZ, ZUS and tax office dictionaries

  • Data from Optima fills these fields automatically, once, together with employment history if it is to be transferred

  • Managers can be set straight away: from an employee attribute in Optima or from the reporting centre (centrum podległościowe)

  • Absences and entitlements are transferred from 1 January of the current year, so the balance is up to date and the closed year stays in Optima

Stage 2

Recurring operation

Once the data is aligned, PeopleForce becomes the source of truth for employee changes.

  • The integrator runs from Windows Task Scheduler; we agree the run frequency together during implementation

  • Changes from requests and forms reach Optima on the next run

  • Leave entitlements and L4 sick notes come back from Optima on a recurring basis, and payslips and PIT forms once their distribution is launched in Optima

Configuration

What gets agreed during implementation

Some dictionaries have to be matched by hand, because every company names them its own way. This is done once, at the start, and again whenever a new item appears in PeopleForce.

Item

What needs to be agreed

API access

An API key generated in PeopleForce (Settings → Security → API keys, Professional plan), plus the environment address

Leave types

The leave names you use internally are matched with absence types in Optima

Work arrangements

PeopleForce treats remote work and business trips as absences; Optima treats them as another way of performing work. These policies are mapped separately, not to absences

Pay supplements

Bonuses, commissions and other components are matched with their formal names in Optima

Contract types

Contract types from PeopleForce are assigned to the corresponding objects in Optima

Work types

Work types defined in PeopleForce (for example employment contract, mandate contract, specific-task contract, B2B) are matched with their counterparts in Optima

Working-time fractions (FTE) and departments

Mapped separately; department names must have a counterpart on the other side

Scope of synced fields

Each field is enabled separately: email, phone, date of birth, NIP and tax office, addresses, accounts, ID document, gender, NFZ, salary

Document folders

Set separately for payslips, bills and PIT forms, and separately for folders sent to e-files

Task Scheduler

The integrator's run frequency is set in Windows Task Scheduler

Conditions for running the integration

What stays on the Optima side, what we need from you, and who the data exchange covers.

The integrator runs on the Optima side

It is a ready-made plugin built by an authorised partner: a Windows program installed on the server where Optima runs, communicating with PeopleForce via the API. The integration works with the desktop version of Optima and with Optima in Enterprise Cloud. The Standard Cloud variant does not allow installing additional applications or using the Optima API, so it is not supported.

What the integrator needs on your side

A Windows machine (10, 11 or Server 2016–2025, 64-bit) with access to the SQL server hosting the Optima database; Task Scheduler launches the integrator on this machine. You also need an SQL user with rights to write and create tables, and an Optima operator with the Kasa/Bank or Kasa/Bank Plus module: the integrator takes up one licence of that module while it runs. Sometimes an accounting firm manages Optima and an external provider manages the server; in that case, it is worth agreeing before launch who hosts it.

Payroll calculation stays in Optima

PeopleForce collects data and runs processes: requests, approvals, onboarding, salary changes. Optima remains the calculator that breaks salary down into components, and the source of truth for leave entitlements, payslips and tax declarations.

The exchange covers employees from the HR module

People kept in Optima as employees are synced. B2B contractors are sometimes recorded only as counterparties in the accounting module; in that case they stay outside the exchange, although PeopleForce itself lets you manage them like people on any other work type. If your group works on several Optima databases, or part of the team works on a B2B basis, let's agree the scope before implementation.

The PeopleForce team enables the integration

You don't switch the Optima integration on yourself with a toggle in settings. Your account manager launches it together with the partner responsible for the plugin. The fee is a subscription covering both the integration launch, with support from a Customer Success Manager, and regular plugin updates.

Frequently asked questions

What IT and HR teams ask most often before implementation.

Step-by-step guide in the help center

How often does data sync?

What happens if we change the same record in both systems?

Can an employee request sick leave in PeopleForce?

Does the integration cover B2B contractors?

We have several companies and several Optima databases. How will that work?

How much history do we transfer at the start?

What happens if the integrator does not recognise an employee?

Can the same folder in PeopleForce handle both directions?

We are updating Optima. What happens to the integrator?

An accounting firm runs our payroll. Can it work in PeopleForce?

How do I start an integration project?

We'll show you how PeopleForce exchanges data with Optima

In the demo, we'll walk through a leave request, a salary change and payslip distribution, and tell you what's needed on the server side.