Pinya HR Integration¶
WFM can import employee absence records from Pinya HR. Import runs automatically every hour via a cron job. The data is used for vacation planning and shift collision detection.
What gets imported¶
Pinya HR provides absence records for employees. WFM imports:
| Field | Description |
|---|---|
| Employee ID | Matched to WFM employees by email |
| From/To dates | Absence start and end dates |
| Type | All absences are imported (Pinya doesn't distinguish vacation vs. sick leave) |
Note
Pinya does not differentiate between absence types (vacation, sick leave, other). All records are imported as generic absences without category.
Configure Pinya integration¶
- Go to Settings > Integrations > Applications.
- In the Pinya section, fill in:
| Field | Description |
|---|---|
| Base URL | Pinya API base URL |
| Access Token | Authentication token |
| Endpoint Vacations | Endpoint for vacations (default: /vacations) |
| Endpoint Employees | Endpoint for employees (default: /employees) |
| Tenant | Pinya tenant identifier |
| Include Working Times | Filter working-time absences |
| Offset Date From | Days before month start to import (default: 30) |
| Offset Date To | Days after month end to import (default: 365) |
- Save.
How import works¶
Import runs automatically via cron job every hour. The process:
- Connects to Pinya API using configured credentials.
- Downloads employee list and maps emails to WFM employee IDs.
- Downloads absence records for the configured date range.
- Creates or updates records in WFM database.
- Marks records with source "pinya" for tracking.
Manual import¶
There is no manual import button. Import runs automatically. If you need to trigger an import immediately, contact your administrator.
How imported data is used¶
Shift planning¶
When generating schedules, WFM checks for absence conflicts. If an employee has an imported absence during a scheduled shift:
- The shift is automatically adjusted or split.
- Administrators receive a notification about the conflict.
Vacation fund¶
Imported absences count toward the employee's vacation usage. The vacation fund tracks usage across all sources (Pinya, manual requests, other integrations).
Notifications¶
Workplace administrators receive notifications when an imported absence conflicts with a scheduled shift.
Data matching¶
Employees are matched between Pinya and WFM by email address. Make sure employee emails are consistent across both systems.
If an employee exists in Pinya but not in WFM (no matching email), the absence record is skipped.
Filtering options¶
Include Working Times¶
By default (Include Working Times disabled), all absence records are imported.
If enabled, records marked as "working time" in Pinya are skipped. Use this if Pinya tracks both absences and working time and you only want absences.
Notes¶
- Import does not create duplicate records - existing records are matched by external ID.
- Imported records are marked with source "pinya" in the database.
- The date range for import is calculated from the current date plus offsets.
- If Pinya credentials are invalid or the API is unavailable, the cron job logs an error and retries next hour.