Unimicro-integraatio

Sisällysluettelo

• Useat yhteydet
• Unimicro
• Ota integraatio käyttöön
• Tuetut ominaisuudet
• Tuetut kentät – työntekijäkentät
• Tuetut kentät – tehtäväkentät
• Unimicro ja Huma – poissaolointegraatio
• Unimicro ja Huma – palkkaintegraatio
• Usein kysytyt kysymykset: Unimicron ja Human tehtäväintegraatio
• Yleiset kysymykset

Useat yhteydet

Jos sinun on määritettävä useita integraatioyhteyksiä, noudata tätä ohjetta.

Onko Unimicro-tililläsi useita «Underenheter» ja tarvitset jokaiselle oman yhteyden? Silloin sinun on määritettävä yksi integraatioyhteys jokaista «Underenhet»-yksikköä kohden.

Unimicro

Käytätkö DNB Regnskap-, Sparebank1 Regnskap-, Eika Regnskap- tai Azets-järjestelmää? Hyviä uutisia: Huma integroituu nyt saumattomasti näihin järjestelmiin.

Tämä tarkoittaa, että sinun ei tarvitse kirjautua Unimicroon, jos käytät DNB Regnskapia, Sparebank1 Regnskapia, Eika Regnskapia tai Azetsia. Käytä vain omaa järjestelmääsi yllä luetelluista.

Ota integraatio käyttöön

• Integraation määrittäminen Humassa edellyttää järjestelmäroolia, jolla on täydet oikeudet organisaatioon.
• Jos et ole varma, mitä rooleja Unimicrossa tarvitaan integraation käyttöönottoon, pyydä ohjeita Unimicron tuesta.

Pääset nopeasti alkuun näillä vaiheilla:

1. Siirry kohtaan «Integraatiot».
2. Valitse «Unimicro» ja sitten «Uusi yhteys».
3. Lue välilehdet «Yleiskatsaus» ja «Tiedot».
4. Valitse «Määritä», anna yhteydelle nimi ja valitse, kenen tulisi olla osa integraatiota.
5. Valitse ympäristö ja liitä Y-tunnus (organisaationumero).
6. Ota käyttöön tai poista käytöstä asetukset «Käyttäjät», «Tehtävät», «Palkka» ja «Poissaolot».
7. Sinut ohjataan Unimicroon, jossa sinua pyydetään hyväksymään yhteys Unimicro-tiliisi.
8. Yhdistä poissaolotyypit, jos poissaolojen synkronointi on käytössä.
9. Integraatio aktivoidaan synkronoimalla käyttäjät manuaalisesti. Valitse «Synkronoi käyttäjät».

Tuetut ominaisuudet

Synkronoi käyttäjät Unimicron ja Human välillä

Kun synkronoit käyttäjiä manuaalisesti, Huma vertaa Unimicron käyttäjiä Huma-organisaatiosi käyttäjiin. Päätä, mitä tehdään arvoille, jotka eivät täsmää tai puuttuvat, sekä käyttäjille, jotka eivät ole molemmissa järjestelmissä.

⚠️ Uudet käyttäjät lisätään vain synkronoimalla uudelleen. Niitä ei lisätä automaattisesti.

Profiilit päivittyvät automaattisesti Humasta Unimicroon reaaliajassa

Muutokset tuettuihin profiilikenttiin päivittyvät automaattisesti Unimicroon.

⚠️ Huomaa, että Unimicrossa tehdyt muutokset eivät päivity automaattisesti Humaan. Niitä varten sinun on synkronoitava manuaalisesti uudelleen.

Huomaa

Jos synkronoinnissa tapahtuu virhe, näet tarkemmat tiedot Human Unimicro-integraatiosivun virhelokista («Error log»).

Tuetut kentät – synkronoitavat työntekijäkentät

Humassa tuettuihin kenttiin (lueteltu alla) tehdyt muutokset päivittyvät automaattisesti Unimicroon reaaliajassa. Unimicrossa tehdyt muutokset on kuitenkin synkronoitava manuaalisesti Humaan.

employee.businessRelation.emails[].emailAddress

employee.employeeNumber

employee.businessRelation.name

employee.businessRelation.name

employee.businessRelation.phones[].number

birthdate

employee.socialSecurityNumber

employee.internationalID

employee.internasjonalIDType

employee.internasjonalIDCountry

employee.addresses[].address

employee.sex

Tuetut kentät – synkronoitavat tehtäväkentät

📄 Lue lisää siitä, miten työntekijätietojen synkronointi toimii integraatioissa yleisesti.

⚠️ Huomaa, että integraation aktivointi ei siirrä historiallisia tehtävätietoja Unimicroon. Vain tehtävät, jotka luodaan tai joita päivitetään Humassa integraation aktivoinnin jälkeen, synkronoidaan.

Tehtävätiedot synkronoidaan vain Humasta Unimicroon, ei Unimicrosta Humaan.

employee.employments[].employmentType

employee.employments[].workPercent

employee.employments[].startDate

employee.employments[].jobName

Usein kysytyt kysymykset: Unimicron ja Human poissaolointegraatio

🔗 Lue lisää siitä, miten poissaolojen synkronointi toimii integraatioissa yleisesti.

💡 Huomaa, että poissaolojen synkronointi toimii vain Humasta Unimicroon. Suoraan Unimicroon kirjattuja poissaoloja ei synkronoida takaisin Humaan.

Tuetut kentät – synkronoitavat poissaolokentät

Nämä poissaolokentät synkronoidaan Humasta Unimicroon:

Miten yhdistän poissaolotyypit Human ja Unimicron välillä?
Käy läpi Humaan luodut poissaolotyypit ja valitse jokaiselle vastaava poissaolokoodi (Timearter) Unimicrossa. Oikea yhdistäminen on synkronoinnin edellytys, eikä poissaolotyyppiä, jota ei ole yhdistetty, siirretä.

1. Jos sinulla on jo aktiivinen integraatio: siirry Humassa integraatiosivulle, valitse oikeasta yläkulmasta kolme pistettä ja «Muokkaa yhteysasetuksia». Vahvista valtuutesi ja valitse «Seuraava». Sen jälkeen voit ottaa poissaolot käyttöön.
2. Jos otat integraatiota käyttöön alusta alkaen, noudata näitä vaiheita.

Miten poissaolot kohdistetaan Human ja Unimicron välillä?
Poissaolo kohdistetaan Unimicrossa työsuhteeseen, jos työsuhteen ajanjakso kattaa poissaolon päivät. Jos työntekijällä on useampi aktiivinen työsuhde, joka kattaa ajanjakson, poissaolo kirjataan kaikkiin niistä eikä vain yhteen.

Milloin poissaolo lähetetään Unimicroon?
Poissaolo lähetetään, kun:

• työntekijä on synkronoitu Unimicroon
• poissaolotyyppi on yhdistetty poissaolokoodiin Unimicrossa
• vähintään yksi työsuhde kattaa poissaolon ajanjakson
• Unimicrossa ei ole jo päällekkäistä poissaoloa samalle ajanjaksolle.

Mitä Unimicron poissaololle tapahtuu, kun sitä muutetaan Humassa?
Se riippuu siitä, muuttuiko poissaolotyyppi:

• Sama tyyppi: Unimicron olemassa oleva poissaolokirjaus päivitetään.
• Muuttunut tyyppi: Unimicro poistaa vanhan kirjauksen ja luo uuden. Tämä edellyttää, että sekä alkuperäinen että uusi poissaolotyyppi on yhdistetty poissaolokoodiin.

Muutos tehdään jokaiseen työsuhteeseen, josta alkuperäinen poissaolokirjaus löytyy.

Mitä tapahtuu, jos poissaolo poistetaan Humasta?
Unimicro etsii poissaolokirjaukset, jotka vastaavat tyyppiä ja ajanjaksoa, ja poistaa ne kaikista vastaavista työsuhteista.

⚠️ Jos poissaolotyyppiä ei ole yhdistetty poissaolokoodiin poistohetkellä, Unimicrossa ei yritetä poistaa mitään, eikä virhettä näytetä. Varmista, että yhdistäminen säilyy, jos kyseisen tyypin poissaoloja on jo synkronoitu.

Miksi osa Humaan kirjatuista poissaoloista hylätään?
Yleisiä syitä:

• Poissaolotyyppiä ei ole yhdistetty poissaolokoodiin Unimicrossa.
• Mikään Unimicron työsuhde ei kata poissaolon ajanjaksoa.
• Unimicrossa on jo päällekkäinen poissaolo samalle ajanjaksolle.
• Poissaolo on loma, joka ulottuu kahdelle kalenterivuodelle. Unimicro ei salli tätä.

Tarkempi selitys löytyy Human Unimicro-integraatiosivun virhelokista.

Usein kysytyt kysymykset: Unimicron ja Human palkkaintegraatio

💰 Integraatio tukee vain NOK-määräisiä palkkoja. Muissa valuutoissa olevat palkkatiedot hylätään, eikä niitä lähetetä Unimicroon.

⛓️‍💥 Palkkojen synkronointi toimii vain Humasta Unimicroon.

Tuetut kentät – synkronoitavat palkkakentät

Jakson yksikkö määrää, mihin kenttään määrä kirjoitetaan: kuukausi → MonthRate, vuosi → YearRate, tunti → HourRate.

⚠️ Viikkopalkkaa ei tueta. Unimicrossa ei ole viikkopalkan kenttää, joten viikkopalkat hylätään.

Miten otan palkkojen synkronoinnin käyttöön integraatiossa?

1. Jos sinulla on jo aktiivinen integraatio: siirry Humassa integraatiosivulle, valitse oikeasta yläkulmasta kolme pistettä ja «Muokkaa yhteysasetuksia». Vahvista valtuutesi ja valitse «Seuraava». Sen jälkeen voit ottaa palkan käyttöön.
2. Jos otat integraatiota käyttöön alusta alkaen, noudata näitä vaiheita.

Miten palkka kohdistetaan oikeaan työsuhteeseen Unimicrossa?
Luotaessa palkka kohdistetaan työsuhteeseen, jonka ajanjakso kattaa palkan aloituspäivän. Jos useampi työsuhde täsmää, käytetään sitä, joka on merkitty Unimicrossa vakiotyösuhteeksi.

Mitä tapahtuu, jos muokkaan tai poistan palkan, jolle ei ole vastaavaa kirjausta Unimicrossa?
Muokattaessa tai poistettaessa Huma etsii Unimicrosta palkkakirjausta, jolla on sama aloituspäivä kuin alkuperäisellä palkalla. Jos vastaavaa kirjausta ei löydy, muutos hylätään, ja sinun on tehtävä se manuaalisesti Unimicrossa.

💡 Unimicro asettaa ensimmäisen palkkakirjauksen aloituspäiväksi automaattisesti työsuhteen oman aloituspäivän riippumatta siitä, mikä päivä Humassa oli asetettu. Tämän vuoksi myöhempi muokkaus ei välttämättä löydä vastinetta ensimmäisellä kerralla, koska päivät eivät enää täsmää. Tarkista asia suoraan Unimicrosta, jos näin käy.

Miten integraatio käsittelee eri valuuttoja?
Integraatio tukee vain NOK-määräisiä palkkoja. Muissa valuutoissa olevia palkkatietoja ei siirretä Unimicroon, ja integraatiovirhe kirjataan.

Mitä tapahtuu, kun palkka poistetaan Humasta?
Vastaava palkkakirjaus poistetaan Unimicrosta, jos vastaava kirjaus löytyy (katso yllä).

Usein kysytyt kysymykset: Human ja Unimicron tehtäväintegraatio

Täytyykö tehtävätietojen synkronointi ottaa käyttöön?

Kyllä. Suosittelemme vahvasti, että integraatio on aktiivinen ja «Tehtävät»-synkronointi on käytössä ennen kuin alat hallinnoida tehtäviä Humassa.

Näin teet sen:

1. Siirry Huma-tililläsi Unimicro-integraation sivulle.
2. Valitse oikeasta yläkulmasta kolme pistettä ja «Muokkaa yhteysasetuksia».
3. Vahvista valtuutesi valintaruudulla ja valitse «Jatka».
4. Ota sitten käyttöön «Tehtävät: Luo, päivitä ja poista».
   1. Tehtävät lähetetään vain Humasta Unimicroon, ei Unimicrosta Humaan.
   2. Unimicroon siirretään vain tehtävät, jotka luodaan tai joita päivitetään integraation aktivoinnin jälkeen.

Tehtävien luominen Humassa

Et voi luoda tehtävää Humassa niin, että se synkronoituu ja luodaan Unimicroon. Tehtävä on ensin luotava Unimicroon ja sen jälkeen Humaan. Jotta synkronointi toimii, tehtävien on täsmättävä seuraavissa kentissä:

• Sopimustyyppi, Työaika prosentteina, Sopimuksen alkamispäivä ja Tehtävänimike.

Päivittääkö integraatio tehtävätietoja?

Kyllä. Kun tuettuja tehtäväkenttiä muutetaan Humassa, päivitys lähetetään automaattisesti Unimicroon.

Tämä koskee esimerkiksi tilanteita, joissa tehtävä luodaan tai kun kenttiä, kuten sopimuspäiviä, työaikaprosenttia tai sopimustyyppiä, muutetaan.

Mihin suuntaan tiedot synkronoidaan?

Tehtävätiedot synkronoidaan vain yhteen suuntaan:

Huma → Unimicro

Suoraan Unimicrossa tehtyjä muutoksia ei lähetetä takaisin Humaan.

Miten tehtävät kohdistetaan Human ja Unimicron välillä?

Tehtävät kohdistetaan sopimuksen alkamispäivän perusteella.

• Jos Unimicron olemassa olevalla tehtävällä on sama alkamispäivä kuin Humassa päivitettävällä tehtävällä, Huma päivittää Unimicron tehtävän uusilla arvoilla.
• Jos alkamispäivä on eri, olemassa olevaa tehtävää ei päivitetä.

Tämä tarkoittaa, että kun muokkaat ensimmäistä tehtävää, jonka Huma luo automaattisesti, kun työsuhdehistoria otetaan käyttöön, tehtävän alkamispäivän on vastattava Unimicron vastaavaa tehtävää.

Milloin tehtävätiedot lähetetään Unimicroon?

Tehtävätiedot lähetetään Unimicroon, kun:

• Humassa luodaan uusi tehtävä
• Humassa päivitetään olemassa oleva tehtävä
• muutos tapahtuu integraation aktivoinnin jälkeen.

Voiko historiallisia tehtäviä siirtää?

Historialliset tehtävätiedot on kirjattava Unimicroon joko manuaalisesti tai päivittämällä tehtävä Humassa integraation aktivoinnin jälkeen.

Integraatio ei siirrä historiallisia tehtävätietoja, jotka olivat olemassa ennen integraation aktivointia.

Miksi kaikkia Human tehtävätietoja ei lähetetä Unimicroon?

Kaikkia tehtäväkenttiä ei synkronoida Human ja Unimicron välillä, koska tiedot on jäsennelty järjestelmissä eri tavoin. Jotkin kentät ovat olemassa vain toisessa järjestelmässä, tai niiden rakenne tai merkitys voi olla erilainen.

Joissakin tapauksissa syynä ovat myös Unimicron API:n tekniset rajoitukset tai tapa, jolla tietoja käsitellään Humassa. Näiden erojen vuoksi kaikkien tehtäväkenttien täydellinen 1:1-siirto järjestelmien välillä ei ole aina mahdollista.

Miksi tehtävää ei poisteta Unimicrosta, kun poistan sen Humasta?

Tätä toimintoa ei valitettavasti tueta, joten tehtävät on poistettava Unimicrosta manuaalisesti.

Miksi työaikaprosentin muutosta ei lähetetty Unimicroon?

Huma päivittää työaikaprosentin Unimicroon vain, jos se pystyy päättelemään, mikä prosentti on voimassa oleva. Muutosta ei lähetetä, jos:

• työsuhteen työaikaprosenttihistoriassa Unimicrossa on kirjaus ilman alkamispäivää
• Unimicron prosentti ei vastaa prosenttia, joka Humassa oli ennen muutosta.

Muutos tallentuu silti Humaan. Unimicro-integraatiosivun virhelokissa näkyy viesti «Position not synced to Unimicro» ja sen jälkeen syy.

Näin korjaat asian:

1. Päivitä työaikaprosentti manuaalisesti Unimicroon.
2. Jos historiassa on kirjaus ilman alkamispäivää, lisää sille alkamispäivä, jotta tulevat muutokset synkronoituvat.

⚠️ Muutosta ei lähetetä uudelleen automaattisesti. Jos korjaat vain Unimicron historian, Humassa tekemäsi muutos on silti lisättävä manuaalisesti.

Yleiset kysymykset

Miten Human ja Unimicron välinen integraatio toimii?

Integraation avulla voit synkronoida käyttäjiä Human ja Unimicron välillä. Kun yhteys on muodostettu, Humassa käyttäjiin tehdyt päivitykset siirtyvät automaattisesti Unimicroon tuettujen kenttien osalta. Voit myös tehdä manuaalisen synkronoinnin, jolla vertaat käyttäjiä ja käsittelet erot.

Mitä tapahtuu, kun päivitän kenttää Humassa?

Jos tuettua kenttää muutetaan Humassa, päivitys siirtyy automaattisesti Unimicroon reaaliajassa.

Jos päivitän kenttää Unimicrossa, miksi en näe muutosta Humassa?

Unimicrossa tehdyt muutokset eivät päivity automaattisesti Humaan. Saat päivitykset Unimicrosta Humaan tekemällä manuaalisen synkronoinnin.

Miksi työsuhdetta ei luoda, kun lisään sen Humassa?

Integraatio ei luo työsuhteita automaattisesti Unimicroon. Sinun on lisättävä ne manuaalisesti Unimicroon.

Miten varmistan, että työsuhteen päivitykset näkyvät Unimicrossa?

• Jos työntekijällä on Unimicrossa jo oletustyösuhde, Human tuettuihin kenttiin tehdyt muutokset päivittyvät automaattisesti.
• Jos työsuhdetta ei ole, sinun on ensin luotava se manuaalisesti Unimicroon.
• Tee sitten kerran manuaalinen synkronointi, jotta tiedot yhdistetään. Sen jälkeen tulevat päivitykset siirtyvät Humasta automaattisesti.

Miksi työntekijätunnus ei päivity Unimicroon, kun muutan sen Humassa?

Työntekijätunnusta ei voi muuttaa integraation kautta, koska se on Unimicrossa yksilöllinen tunniste. Jos muutat sen Humassa, sinun on päivitettävä se manuaalisesti Unimicroon, jotta tiedot pysyvät oikeina.

Voinko kirjata loman, joka ulottuu kahdelle kalenterivuodelle?

Et yhtenä poissaolona. Unimicro ei salli loman kirjaamista kahdelle eri kalenterivuodelle. Loma 29. joulukuuta–3. tammikuuta on siksi kirjattava Humaan kahtena poissaolona: yksi, joka päättyy 31. joulukuuta, ja toinen, joka alkaa 1. tammikuuta.

Jos loma kirjataan yhtenä poissaolona, se hylätään ennen kuin mitään lähetetään Unimicroon. Unimicro-integraatiosivun virheloki kertoo, mitä tehdä.

⚠️ Jos muutat olemassa olevaa lomaa niin, että se ulottuu kahdelle kalenterivuodelle, vanha poissaolokirjaus on edelleen Unimicrossa. Virheloki näyttää, mistä kirjauksesta on kyse. Poista se manuaalisesti Unimicrosta ja kirjaa loma uudelleen yhtenä poissaolona vuotta kohden.

💡 Tämä koskee vain poissaolotyyppejä, jotka on yhdistetty Unimicrossa lomaan. Muut poissaolotyypit, kuten sairauspoissaolo ja virkavapaa, voidaan edelleen kirjata vuodenvaihteen yli yhtenä poissaolona.