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.
Klikněte na Nová aplikace a zvolte typ Pinya.

Vyplňte:

Pole	Popis
Základní Url	Základní URL Pinya API
Tenant	Identifikátor Pinya tenantu
Přístupový token	Autentizační token
Vyloučit absence v pracovní době	Když je zapnuto, nepřítomnosti označené v Pinyi jako pracovní čas se neimportují
Posun data od	Kolik měsíců do minulosti importovat nepřítomnosti
Posun data do	Kolik měsíců do budoucnosti importovat nepřítomnosti

Klikněte na Uložit.

Pro pozdější změnu nastavení otevřete stávající aplikaci Pinya v seznamu - každý typ aplikace lze přidat jen jednou.

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

Vyloučit absence v pracovní době¶

Ve výchozím nastavení (Vyloučit absence v pracovní době 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.