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.

ESS:stä tuotujen tapahtumien muokkaaminen

Mikäli tulee tarve muokata ESS:stä tuotua tapahtumaa, täytyy toimia niin, että ensin vie tuodun tapahtuman roskakoriin sellaisenaan, ja sen jälkeen luo manuaalisesti uuden tapahtuman halutuilla muutoksilla.

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ä