Integrace Pinya HR¶
WFM může importovat záznamy o nepřítomnostech zaměstnanců z Pinya HR. Import probíhá automaticky každou hodinu přes cron job. Data se používají pro plánování dovolené a detekci kolizí se směnami.
Co se importuje¶
Pinya HR poskytuje záznamy o nepřítomnostech zaměstnanců. WFM importuje:
| Pole | Popis |
|---|---|
| ID zaměstnance | Párováno se zaměstnanci WFM podle emailu |
| Datum od/do | Začátek a konec nepřítomnosti |
| Typ | Všechny nepřítomnosti jsou importovány (Pinya nerozlišuje dovolenou vs. nemoc) |
Note
Pinya nerozlišuje mezi typy nepřítomnosti (dovolená, nemoc, jiné). Všechny záznamy jsou importovány jako generické nepřítomnosti bez kategorie.
Konfigurace integrace Pinya¶
- Přejděte do Nastavení > Integrace > Aplikace.
- V sekci Pinya vyplňte:
| Pole | Popis |
|---|---|
| Základní URL | Základní URL Pinya API |
| Přístupový token | Autentizační token |
| Endpoint pro dovolené | Endpoint pro dovolené (výchozí: /vacations) |
| Endpoint pro zaměstnance | Endpoint pro zaměstnance (výchozí: /employees) |
| Tenant | Identifikátor Pinya tenantu |
| Zahrnout pracovní časy | Filtrovat pracovní nepřítomnosti |
| Offset datum od | Dny před začátkem měsíce k importu (výchozí: 30) |
| Offset datum do | Dny po konci měsíce k importu (výchozí: 365) |
- Uložte.
Jak import funguje¶
Import probíhá automaticky přes cron job každou hodinu. Proces:
- Připojí se k Pinya API s nakonfigurovanými credentials.
- Stáhne seznam zaměstnanců a namapuje emaily na ID zaměstnanců WFM.
- Stáhne záznamy nepřítomností pro nakonfigurovaný datumový rozsah.
- Vytvoří nebo aktualizuje záznamy v databázi WFM.
- Označí záznamy zdrojem "pinya" pro sledování.
Ruční import¶
Neexistuje tlačítko pro ruční import. Import probíhá automaticky. Pokud potřebujete spustit import okamžitě, kontaktujte administrátora.
Jak se importovaná data používají¶
Plánování směn¶
Při generování rozvrhu WFM kontroluje konflikty nepřítomností. Pokud má zaměstnanec importovanou nepřítomnost během naplánované směny:
- Směna je automaticky upravena nebo rozdělena.
- Administrátoři přijmou notifikaci o konfliktu.
Fond dovolené¶
Importované nepřítomnosti se započítávají do čerpání dovolené zaměstnance. Fond dovolené sleduje čerpání ze všech zdrojů (Pinya, manuální žádosti, další integrace).
Notifikace¶
Administrátoři pracoviště přijmou notifikace, když importovaná nepřítomnost koliduje s naplánovanou směnou.
Párování dat¶
Zaměstnanci jsou párováni mezi Pinya a WFM podle emailové adresy. Ujistěte se, že emaily zaměstnanců jsou konzistentní v obou systémech.
Pokud zaměstnanec existuje v Pinya, ale ne ve WFM (žádný odpovídající email), záznam nepřítomnosti je přeskočen.
Možnosti filtrování¶
Zahrnout pracovní časy¶
Ve výchozím nastavení (Zahrnout pracovní časy vypnuto) jsou importovány všechny záznamy nepřítomností.
Pokud je zapnuto, záznamy označené jako "working time" v Pinya jsou přeskočeny. Použijte toto, pokud Pinya sleduje jak nepřítomnosti tak pracovní časy a chcete pouze nepřítomnosti.
Poznámky¶
- Import nevytváří duplicitní záznamy - existující záznamy jsou párovány podle externího ID.
- Importované záznamy jsou v databázi označeny zdrojem "pinya".
- Datumový rozsah pro import se počítá z aktuálního data plus offsety.
- Pokud jsou Pinya credentials neplatné nebo API není dostupné, cron job zaznamená chybu a zkusí to znovu příští hodinu.