ESS -> Maxtech: Lomien ja muiden poissaolotapahtumien siirron kuvaus
Tämä ohje koskee Maxtech Pro™ -palvelua. Maxtech Easy™ käyttäjille on olemassa erilliset ohjeet.
Olet mahdollisesti kiinnostunut myös tästä: Personec FK -palkka-aineistosiirto
Tämä toiminnallisuus kuuluu seuraaviin tuotteisiin ja vaatii toimiakseen seuraavat moduulit:
| TUOTTEET | MODUULIT |
|---|---|
| TES-tulkinta, lisäpalkkarivit ja palkka-aineistot™ |
Perustiedot
Tässä on kuvattu Maxtech Pro -järjestelmän ESS -> Maxtech loma- ja poissaolosiirron asetukset. Rajapinnan asetuksia voidaan muuttaa erilaisiksi asiakaskohtaisesti järjestelmän vientiasetuksilla. Kenttien järjestystä ei saa muuttaa.
Tuonnissa ei ole mukana tapahtuman kestoa, joten tapahtumat tuodaan järjestelmään koko päivän kestävinä tapahtumina ja kesto haetaan työntekijän työaikatiedoista järjestelmästä.
| Tiedoston nimi | Sovitaan erikseen, tyypillisesti lomat_t.csv (tuntipalkkaiset), lomat_k.csv (kk-palkkaiset), poissaolot_t.csv (tuntipalkkaiset), poissaolot_k.csv (kk-palkkaiset) |
| Tiedonsiirtotapa | csv-muotoiset tiedostot siirretään Maxtechin ylläpitämälle levynkulmapalvelimelle, josta ne luetaan ajastetusti järjestelmään |
| Tiedostoformaatti | CSV |
| Kenttien erotinmerkki | puolipiste (;) |
| Merkistö | UTF-8 |
| Päivämääräformaatti | DD.MM.YYYYesimerkiksi: 23.02.2022 |
| Desimaalierotin | pilkku (,) |
| Tuhaterotin | Ei käytössä |
| Kenttien otsikot | Käytössä |
| Kenttien järjestys | Dynaaminen, vastaa otsikkoja |
Rajapinnassa siirrettävät tiedot
- Lomat ja poissaolot ja niiden päivämäärävälit henkiöittäin
- Tapahtumien hyväksynnän tila ja ilmoituspäivämäärät
- Poissaolojen syykoodit ja tekstimuotoiset nimet (esim. Sairauspoissaolo)
Lomat ja muut poissaolot
ESS-loma- ja poissaolosiirron formaatti on csv-tiedosto, jossa on header. Header sisältää kenttien nimet. Tässä esimerkkitiedostoja:
Lomat
Henkilonro;Alkupäivä;Loppupäivä;Ess-tila;Poissaolon ilmoitusaika;
10109;31.08.2022;02.09.2022;Hyväksytty;01.08.2022;
Poissaolot
Henkilonro;Alkupäivä;Loppupäivä;Poissaolos;Poissaolon syy;Ess-tila;Poissaolon ilmoitusaika;
10109;17.08.2022;18.08.2022;20;Sairausloma;Hyväksytty;17.08.2022;
Siirron ajastus
Lomat ja poissaolot siirretään csv-tiedostoina sovitulle levynkulmapalvelimelle (SFTP), josta ne luetaan ajastetusti eräajona, tyypillisesti kerran vuorokaudessa aamulla ennen työpäivän alkua, järjestelmään.
Vientiasetukset
Vientiasetuksilla voidaan määritellä tiettyjä siirtoon liittyviä asioita. Itse viennin konfigurointi suoritetaan Maxtechin ylläpitäjien toimesta. Tässä listaus asioista, joihin asetuksilla voidaan vaikuttaa:
- SFTP-kirjautumistiedot (palvelimen osoite, portti, käyttäjätunnus ja salasana)
- Kansiot, joihin onnistuneesti / epäonnistuneesti siirretyt vientitiedostot siirretään sisäänluvun jälkeen
- Poissaolotiedot sisältävän tiedoston tiedostonimi
- Lomatiedot sisältävän tiedoston tiedostonimi
- Aineiston poimintaväli, esim +-3kk ajohetkestä (aiemmin ESS:stä tuodut tapahtumat, joita ei löydy annetulla aikavälillä järjestelmästä, eikä ole aineistossa mukana, poistetaan)
- Oletustapahtumatyyppi poissaoloille / lomille
- Luoduissa poissaolo/lomatapahtumissa käytettävä Sisäinen viite
- ESS-poissaolokoodeille voidaan määrittää vastaavuustaulukko, jonka perusteella poissaolokoodit tulkitaan tuonnissa halutuiksi tapahtumatyypeiksi. Mikäli koodille ei löydy taulukosta vastaavaa tapahtumatyyppiä, käytetään yllämainittua poissaolojen oletustapahtumatyyppiä
