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 nepřítomnosti	Typ nepřítomnosti z Pinyi (Holiday, Sick day, HO, …), použitý pro mapování typů níže

Note

Všechny záznamy o nepřítomnosti jsou importovány. Každý nese svůj typ nepřítomnosti z Pinyi, který můžete namapovat na konkrétní typ požadavku ve WFM — viz Mapování typů nepřítomností.

Konfigurace integrace Pinya¶

Přejděte do Nastavení > Integrace > Aplikace.
V sekci Pinya vyplňte:

Pole	Popis
Base Url	Základní URL Pinya API
Tenant	Identifikátor Pinya tenantu
Access Token	Autentizační token
Exclude Working Time Absences	Když je zapnuto, nepřítomnosti označené v Pinyi jako pracovní čas se neimportují
Offset Date From (months)	Kolik měsíců do minulosti importovat nepřítomnosti
Offset Date To (months)	Kolik měsíců do budoucnosti importovat nepřítomnosti

Uložte.

Mapování typů nepřítomností¶

Každá nepřítomnost z Pinyi nese typ (Holiday, Sick day, HO, …). V sekci Mapování typů nepřítomností můžete každý typ namapovat na typ požadavku ve WFM, aby se nepřítomnosti v plánu zobrazily se správným popiskem a barvou.

V poli Výchozí typ požadavku zvolte typ požadavku použitý pro každý typ nepřítomnosti, který nenamapujete.
Pro každý typ nepřítomnosti z Pinyi, který chcete zobrazit konkrétně, přidejte řádek: vyberte Typ nepřítomnosti a Typ požadavku, na který se mapuje.
Klikněte na Uložit.

Jako cíle mapování se nabízejí pouze typy požadavků typu „volno". Nepřítomnost, jejíž typ není namapován, spadne na výchozí typ požadavku. Mapování slouží pouze k zobrazení — nenamapovaná nepřítomnost se přesto importuje a nadále blokuje plán.

Seznam typů nepřítomností z Pinyi se plní z dat stažených během hodinového importu, takže se typ v nabídce objeví, jakmile byl alespoň jednou importován.

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í¶

Exclude Working Time Absences¶

Ve výchozím nastavení (Exclude Working Time Absences 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.