Netvisor-integraatio

Sisällysluettelo

Integraation määrittäminen

• Useat yhteydet
• Vaihe 1: Luo API-tunniste Netvisorissa
• Vaihe 2: Yhdistä Huma Netvisoriin
• Vaihe 3: Ota integraatio käyttöön. Synkronoi käyttäjät ja valitse, miten ristiriidat tai puuttuvat arvot käsitellään
• Vaihe 4: Human ja Netvisorin välinen yhteys on aktiivinen 🥳

Aktiivinen integraatio

• Näin synkronoit käyttäjät
• Deaktivoidut tai poistetut käyttäjät
• Tärkeää tietoa palkanlaskijalle
• Tuetut kentät
• Usein kysytyt kysymykset: Netvisorin ja Human tehtäväintegraatio

Netvisor

Netvisor-integraation avulla voit yhdistää Human Netvisor-tiliisi ja synkronoida työntekijätiedot automaattisesti. Näin säästät aikaa, ja HR- ja palkkatiedot pysyvät oikeina ja ajan tasalla.

• Integraation määrittäminen Humassa edellyttää järjestelmäroolia, jolla on täydet oikeudet organisaatioon.
• Jos et ole varma, mitä rooleja Netvisorissa tarvitaan integraation määrittämiseen, pyydä ohjeita Netvisorin tuesta.

Useat yhteydet

Jos sinun on määritettävä useita integraatioyhteyksiä, noudata näitä ohjeita.

Vaihe 1: Luo API-tunniste Netvisorissa

1. Kirjaudu sisään pääkäyttäjänä.
2. Avaa yritysvalikko > API identifiers.
   
   
   
3. Luo uusi API-tunniste oikealla olevalla painikkeella.
   
   
   
4. Kopioi User ID ja Key erilliseen dokumenttiin tai muistiinpanoon myöhempää käyttöä varten.
   
   
   
5. Varmista, että sinulla on oikeat API-resurssien käyttöoikeudet. Avaa yritysvalikko > API resource access rights.
   
   
   
6. Vieritä alas Salaries-osioon ja salli seuraavat, jos niitä ei ole jo sallittu:
   
   
   
   1. 'employee.nv' – Allow
   2. 'getemployee.nv' – Allow
   3. 'getemployees.nv' – Allow
   4. 'patchemployee.nv' – Allow
7. Hae Business ID. Avaa yritysvalikko > Service Management.
   
   
   
8. Kopioi Business ID erilliseen dokumenttiin tai muistiinpanoon myöhempää käyttöä varten.
   
   

Vaihe 2: Yhdistä Huma Netvisoriin

1. Kirjaudu Humaan ylläpitäjänä.
2. Siirry kohtaan Integraatiot.
3. Avaa Netvisor.
4. Lue dokumentaatio.
5. Valitse oikeasta yläkulmasta Määritä.
6. Päätä, lähetetäänkö tehtävät Netvisoriin, kun niitä luodaan, päivitetään tai poistetaan Humassa.
7. Liitä Netvisor User ID, Key ja Business ID ja vahvista valintaruudulla, että sinulla on tarvittavat valtuudet.

Vaihe 3: Ota integraatio käyttöön. Synkronoi käyttäjät ja valitse, miten ristiriidat tai puuttuvat arvot käsitellään

• Kun valitset Tallenna, siirryt käyttäjien synkronointivaiheeseen.
• Huma kertoo, jos Human ja Netvisorin välillä on ristiriitoja tai epäjohdonmukaisuuksia. Päätä, miten ristiriidat ja/tai puuttuvat arvot käsitellään. Voit valita, päivitetäänkö Netvisor Human arvojen perusteella vai päinvastoin.
  
  
  
• Valitse Seuraava ja päätä, miten käyttäjät synkronoidaan Human ja Netvisorin välillä.
  
  
  
  • Jos Netvisorin käyttäjiä ei ole Humassa, voit lisätä heidät Humaan.
  • Jos Human käyttäjiä ei ole Netvisorissa, voit lisätä heidät Netvisoriin.
• Kun olet tehnyt valinnat, valitse Synkronoi käyttäjät.
• Huma alkaa synkronoida käyttäjiä Netvisorin kanssa. Saat tuloksesta vahvistuksen sähköpostitse.

Vaihe 4: Human ja Netvisorin välinen yhteys on aktiivinen 🥳

• Kaikki Humassa tehdyt muutokset tuettuihin kenttiin (lueteltu alla) päivitetään Netvisoriin automaattisesti reaaliajassa.
• Huomaa, että sinun on synkronoitava käyttäjät saadaksesi uusimmat muutokset Netvisorista. Netvisorissa tehtyjä muutoksia ei päivitetä automaattisesti Humaan.

Näin synkronoit käyttäjät

Käytä toimintoa «Synkronoi käyttäjät» aina, kun olet päivittänyt jonkin tuetuista kentistä Netvisorissa tai kun haluat luoda uusia käyttäjiä. Jotta käyttäjien synkronointi toimii, sähköpostiosoitteen on aina oltava sama molemmissa järjestelmissä.

1. Siirry Humassa Netvisor-integraatioon.
2. Valitse Synkronoi käyttäjät.
3. Noudata vaiheita. Lue lisää vaiheista täältä.

Huomaa

• Jos olet luonut käyttäjän Humassa, sinun on tehtävä manuaalinen synkronointi, jotta käyttäjä luodaan Netvisoriin integraation kautta.
• Jos synkronoinnissa tapahtuu virhe, näet tarkemmat tiedot Human Netvisor-integraatiosivun «Error log» -lokissa.
• Huomaa, että sinun on synkronoitava käyttäjät saadaksesi uusimmat muutokset Netvisorista. Netvisorissa tehtyjä muutoksia ei päivitetä automaattisesti Humaan.

Deaktivoidut tai poistetut käyttäjät

Kun käyttäjä deaktivoidaan Humassa…

• käyttäjää ei deaktivoida Netvisorissa.
• käyttäjä lukitaan päivityksiltä, ja päivitys tapahtuu vain manuaalisen synkronoinnin kautta.

Kun käyttäjä poistetaan Humassa…

• käyttäjää ei poisteta Netvisorista.
• manuaalinen synkronointi pyytää sinua luomaan käyttäjän Netvisoriin, jos käyttäjä ei ole toisessa integraatiossa.
• käyttäjää ei voi synkronoida, jos hänen tietoihinsa on tehty muutoksia Netvisorissa.

Tärkeää tietoa palkanlaskijalle

Varmista, että organisaatiosi palkanlaskija tietää tästä ennen kuin integraatio otetaan käyttöön.

Käyttäjien luominen Netvisoriin synkronoinnin kautta

Jos luot käyttäjiä Netvisoriin synkronoimalla ne Humasta, joitakin kenttiä kannattaa tarkistaa manuaalisesti Netvisorissa.

• Kohdassa ‘Employee’s information’:
  • Payroll information – Salary model -arvoksi asetetaan ‘No salary model’.
  • Settlement points – TyEL-arvoksi asetetaan ’No handling’. Tämä aiheuttaa virheen, kun työntekijää yritetään päivittää. Valitse sopiva työeläkevakuutus.
• Kohdassa ‘Employments’: katso tehtävien lähettämisen tiedot täältä.

Tuetut kentät

employeebaseinformation.email

employeebaseinformation.employeeidentifier

employeebaseinformation.firstname

employeebaseinformation.lastname

employeebaseinformation.dateofbirth

employeepayrollinformation.employeenumber

employeebaseinformation.nationality

employeebaseinformation.gender

employeebaseinformation.streetaddress

employeebaseinformation.municipality

employeebaseinformation.postnumber

employeebaseinformation.country

employeebaseinformation.phonenumber

employeebaseinformation.bankaccountnumber

employeebaseinformation.bankidentificationcode

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

⚠️ Tehtävätiedot lähetetään vain Humasta Netvisoriin, ei Netvisorista Humaan.

⚠️ Aiempia tehtäviä ei siirretä automaattisesti, kun integraatio otetaan käyttöön. Vain tehtävät, jotka luodaan tai päivitetään Humassa käyttöönoton jälkeen, synkronoidaan.

Tuetut kentät – synkronoitavat tehtävätiedot

Integraatio tukee seuraavia tehtäväkenttiä:

⚠️ Jos Työsuhteen aloituspäivä tai Tehtävänimike poistetaan Humassa, integraatio ei voi poistaa arvoa Netvisorista.

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

Kyllä. Suosittelemme vahvasti, että integraatio on aktiivinen ja tehtävien synkronointi on käytössä ennen kuin alat hallita tehtäviä Humassa.

Näin otat sen käyttöön:

1. Siirry Human Netvisor-integraatiosivulle.
2. Valitse oikean yläkulman kolme pistettä ja valitse Muokkaa yhteysasetuksia.
3. Vahvista valtuutesi valintaruudulla ja valitse Jatka.
4. Ota käyttöön Tehtävät: Luo, päivitä ja poista.
   1. Tehtävät lähetetään vain Humasta Netvisoriin, ei Netvisorista Humaan.
   2. Netvisoriin siirretään vain tehtävät, jotka luodaan tai päivitetään integraation käyttöönoton jälkeen.

Miten tehtävät yhdistetään Human ja Netvisorin välillä?

Tehtävät yhdistetään seuraavien tietojen perusteella:

• Sopimuksen alkamispäivä
• Tehtävänimike

Kun tehtävää päivitetään Humassa, integraatio käyttää näiden kenttien aiempia arvoja löytääkseen oikean tehtävän Netvisorista ja päivittääkseen sen.

Jos vastaavaa tehtävää ei löydy, integraatio palauttaa virheen, jotta väärää tietuetta ei päivitetä.

Milloin Netvisoriin luodaan uusi tehtävä?

Uusi tehtävä luodaan, kun:

• työntekijälle lisätään tehtävä Humassa, ja
• Netvisorissa ei ole tehtävää, jolla on sama alkamispäivä ja tehtävänimike.

Tällöin Huma luo työntekijälle Netvisoriin uuden työsuhdejakson.

Tämä tarkoittaa, että kun muokkaat ensimmäistä tehtävää, jonka Huma luo automaattisesti, kun työsuhdehistoria otetaan käyttöön, sinun on joko:

• täsmättävä tehtävän alkamispäivä Netvisorin vastaavan tehtävän kanssa, tai
• tehtävä haluamasi muutokset, tallennettava ne ja valittava sitten Luo uusi tehtävä.

Mitä tapahtuu, kun tehtävää päivitetään Humassa?

Kun tehtävää päivitetään Humassa, integraatio yrittää löytää vastaavan tehtävän Netvisorista seuraavien kenttien aiempien arvojen perusteella:

• Sopimuksen alkamispäivä
• Tehtävänimike

Jos vastaava tehtävä löytyy, Huma päivittää kyseisen työsuhdejakson Netvisoriin uusilla arvoilla.

Jos vastaavaa tehtävää ei löydy, integraatio palauttaa virheen, jotta Netvisorissa ei päivitetä väärää tehtävää.

Mitä tapahtuu, kun tehtävä poistetaan Humassa?

Jos tehtävä poistetaan Humassa, integraatio etsii vastaavaa tehtävää Netvisorista alkamispäivän ja tehtävänimikkeen perusteella.

• Jos vastaava tehtävä löytyy, kyseinen työsuhdejakso poistetaan Netvisorista.
• Jos vastaavaa tehtävää ei löydy, tehtävää ei poisteta, jotta tietoja ei menetetä vahingossa.

Voivatko työsuhdejaksot olla päällekkäisiä?

Eivät. Netvisor ei tue päällekkäisiä työsuhdejaksoja.

Jos Humasta lähetetään päällekkäisiä tehtäväpäivämääriä, integraatio palauttaa virheen eikä päivitys onnistu.

Miksi kaikkia tehtäväkenttiä ei synkronoida?

Huma ja Netvisor jäsentävät työsuhdetiedot eri tavoin. Osa kentistä on vain toisessa järjestelmässä, ja osa tallennetaan eri muodoissa. Näiden erojen ja joidenkin API-rajoitusten vuoksi kaikkia tehtäväkenttiä ei voi synkronoida järjestelmien välillä yksi yhteen.

Työsuhteen tyypin synkronointi (Netvisorissa Employment method)

Humasta Netvisoriin:

Netvisorista Humaan: