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

Leave requests reviewed in PeopleForce

Payslips and PIT forms in the employee's folder

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 moves | Direction | When | Data 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.
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.
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
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
What the integrator needs on your side
Payroll calculation stays in Optima
The exchange covers employees from the HR module
The PeopleForce team enables the integration
Frequently asked questions
What IT and HR teams ask most often before implementation.
Step-by-step guide in the help centerHow often does data sync?
The integrator runs from Windows Task Scheduler, so the exchange is recurring rather than instant. We agree the run frequency together during implementation, and you can change it later in the scheduler.
What happens if we change the same record in both systems?
That depends on the direction of the data. Employee records, contracts and entitlements are changed in the system they come from; a change made on the receiving side does not go back to the source. Only absences sync in both directions: if the same entry changes on both sides between runs, the integrator compares the save dates and keeps the newer change.
Can an employee request sick leave in PeopleForce?
In this integration, the employee does not submit a sick leave request: the sick note goes from eZUS to Optima, and from there the integrator passes it to PeopleForce as an approved absence. It shows in PeopleForce after the next integrator run, not only when the month closes; the employee profile also shows the total number of days used.
Does the integration cover B2B contractors?
The exchange works for people kept in Optima's HR module. People working on a B2B basis are sometimes recorded only as counterparties in the accounting module; in that case they are not covered by the sync. PeopleForce itself supports different work types, so they can be managed in the system without data exchange. Before implementation, it is worth checking how they are set up in your instance.
We have several companies and several Optima databases. How will that work?
The exchange is set up between a PeopleForce account and an Optima database, so for a group of companies working on several databases we agree the scope before implementation. We then arrange a call with the partner responsible for the integrator to fit the solution to your structure.
PeopleForce itself manages legal entities as a separate dimension: an employee and their position can be assigned to a specific company, and the split shows in imports, exports and reports, including the pay gap report. We enable this part on request: tell us about your company structure on the first call, and we will set it up together with the exchange scope.
How much history do we transfer at the start?
We sync absences and entitlements from 1 January of the current year. The balance is then correct, including carry-over from the previous year, and the closed year stays in Optima. The contract register is transferred with its history and addenda, because employees use it on an ongoing basis.
What happens if the integrator does not recognise an employee?
Matching takes two steps: first by PESEL number, then by the “PeopleForceId” attribute stored on the employee in Optima. If neither step finds the person, the integrator creates a new record, so when starting on existing databases we first run the PESEL mapping to avoid duplicates.
Can the same folder in PeopleForce handle both directions?
No. In this integration, a folder set for payslips, bills or PIT forms cannot also be the folder that sends documents to e-files in Optima. Each direction gets its own folder; you set this up once, during configuration.
We are updating Optima. What happens to the integrator?
A matching integrator version is prepared for every new version of Optima; updating means replacing the files in its directory. Before replacing them, you stop the task in the scheduler and keep the integrator's configuration file: it holds all the settings and mappings, so it goes back in place after the update.
An accounting firm runs our payroll. Can it work in PeopleForce?
Yes. Someone from the accounting firm can be given an account with limited visibility: they will see only what they need, for example requests from managers and documents to prepare. You decide the scope of permissions, and we help you configure it.
How do I start an integration project?
In PeopleForce, go to Settings → Integrations → Optima and contact the team, or write directly to your account manager. The first step is a call where we agree the Optima version, server access and the scope of mappings.


