Siirry sisältöön
  • Ehdotuksia ei ole, koska hakukenttä on tyhjä.

Netvisor-integraatio

Yhdistä Huma Netvisoriin, niin työntekijäprofiilit ja työsuhdejaksot pysyvät synkronoituina

 

Sisällysluettelo

 


 

Johdanto

Netvisor-integraatio pitää työntekijätiedot Humassa ja Netvisorissa synkronoituina. Hallitset työntekijöitä ja tehtäviä Humassa, ja Huma lähettää muutokset Netvisoriin.

Integraatio tukee seuraavia tietoja, ja tiedot liikkuvat näin:

Tieto Huma → Netvisor Netvisor → Huma Milloin
Työntekijätiedot ✅ Automaattisesti ✅ Vain manuaalisesti Humassa tehdyt muutokset lähetetään reaaliajassa. Netvisorissa tehdyt muutokset haetaan, kun valitset «Synkronoi käyttäjät».
Uudet työntekijät ✅ Vain manuaalisesti ✅ Vain manuaalisesti Kun valitset «Synkronoi käyttäjät»
Tehtävät (työsuhdejaksot) ✅ Automaattisesti, jos asetus on käytössä ❌ Kun tehtävä luodaan, sitä muutetaan tai se poistetaan Humassa
Poissaolot ❌ ❌ Ei tuettu
Palkka ❌ ❌ Ei tuettu

 

⚠️ Aiempia tietoja ei siirretä. Vain tehtävät, jotka luodaan, joita muutetaan tai jotka poistetaan integraation käyttöönoton jälkeen, lähetetään Netvisoriin.

💡 Tarvitsetko useamman yhteyden, esimerkiksi yhden jokaiselle yritykselle? Katso Useita yhteyksiä.

 

 

Roolit ja käyttöoikeudet

Käyttöoikeus Rooli
Integraation määrittäminen ja hallinta Humassa Järjestelmärooli, jolla on täydet oikeudet Organisaatioon
API-tunnisteen luominen ja API-resurssien käyttöoikeuksien muuttaminen Netvisorissa Pääkäyttäjä Netvisorissa

 

💡 Etkö ole varma, mitä rooleja tarvitset Netvisorissa? Ota yhteyttä Netvisorin pääkäyttäjään tai Netvisorin tukeen.

 

 

Ota integraatio käyttöön

Ennen kuin aloitat

  • Sinulla on Humassa järjestelmärooli, jolla on täydet oikeudet Organisaatioon.
  • Sinä tai kollegasi voitte kirjautua Netvisoriin pääkäyttäjänä.
  • Molemmissa järjestelmissä olevilla työntekijöillä on sama sähköpostiosoite Humassa ja Netvisorissa. Huma yhdistää työntekijät vain sähköpostiosoitteen perusteella.
  • Työntekijöillä, jotka haluat luoda Humasta Netvisoriin, on suomalainen henkilötunnus ja Humassa vähintään yksi tehtävä, jolla on alkamispäivä ja tehtävänimike.

 

 

Vaihe 1: Luo API-tunniste Netvisorissa

  1. Kirjaudu Netvisoriin pääkäyttäjänä.
  2. Avaa yritysvalikko ja valitse «API identifiers».
  3. Luo uusi API-tunniste oikealla olevalla painikkeella.
  4. Kopioi «User ID» ja «Key» talteen myöhempää käyttöä varten.

Salli API-resurssit

  1. Avaa yritysvalikko ja valitse «API resource access rights».
  2. Vieritä alas «Salaries»-osioon.
  3. Salli nämä resurssit, jos niitä ei ole jo sallittu:
    • employee.nv
    • getemployee.nv
    • getemployees.nv
    • patchemployee.nv
    • addjobperiod.nv, editjobperiod.nv ja deletejobperiod.nv, jos lähetät tehtäviä Netvisoriin

Salaries-osio

Hae Business ID

  1. Avaa yritysvalikko ja valitse «Service Management».
  2. Kopioi «Business ID» talteen myöhempää käyttöä varten.

 

Vaihe 2: Yhdistä Huma Netvisoriin

  1. Siirry Humassa kohtaan «Integraatiot» ja valitse «Netvisor».
  2. Lue välilehdet «Yleiskatsaus» ja «Tiedot».
  3. Valitse oikeasta yläkulmasta «Määritä».
  4. Anna yhteydelle nimi.
  5. Valitse, ketkä kuuluvat yhteyteen: kaikki tai tietty tiimi, sijainti tai yritys.
  6. Valitse «Jatka».
  7. Liitä Netvisorin User ID, Key ja Business ID.
  8. Vahvista, että sinulla on valtuudet hyväksyä ehdot organisaatiosi puolesta.
  9. Valitse «Jatka».

 

Vaihe 3: Valitse, mitä synkronoidaan

Netvisorissa on yksi asetus. Voit muuttaa sitä myöhemmin. Katso Muuta integraation asetuksia.

Asetus Kun asetus on käytössä Kun asetus ei ole käytössä
Tehtävät: Luo, päivitä ja poista Humassa luodut, muutetut tai poistetut tehtävät luovat, muuttavat tai poistavat vastaavan työsuhdejakson Netvisorissa. Tehtävätietoja ei lähetetä Netvisoriin.

 

💡 Suosittelemme, että otat tehtävät käyttöön ennen kuin alat hallita tehtäviä Humassa.

 

Vaihe 4: Synkronoi käyttäjät ja ota integraatio käyttöön

Määrityksen jälkeen integraatiosivulla lukee «Tämä integrointi on konfiguroitu, mutta se ei ole aktiivinen». Mitään ei lähetetä ennen kuin olet synkronoinut käyttäjät. Katso Synkronoi työntekijät.

 

 

Synkronoi työntekijät

«Synkronoi käyttäjät» vertaa Human ja Netvisorin työntekijöitä. Sinä päätät, mitä päivitetään ja mitkä työntekijät luodaan. Ensimmäinen synkronointi myös aktivoi integraation.

Näin synkronoit käyttäjät

  1. Siirry Humassa Netvisor-integraatioon ja valitse «Synkronoi käyttäjät».
  2. Yhteiset käyttäjät ovat työntekijöitä, joilla on sama sähköpostiosoite molemmissa järjestelmissä.
    • Katso, missä kentissä on eri arvot tai puuttuvia arvoja.
    • Valitse jokaisessa tapauksessa, päivitetäänkö Huma Netvisorin arvolla, päivitetäänkö Netvisor Human arvolla vai jätetäänkö tieto ennalleen.
    • Valitse «Seuraava».
  3. Eroavat käyttäjät ovat työntekijöitä, jotka ovat vain toisessa järjestelmässä.
    • Valitse, luodaanko kaikki, vain valitsemasi vai ei yhtään.
    • Valitse suunta: Netvisor → Huma tai Huma → Netvisor.
  4. Valitse «Synkronoi käyttäjät».

Tilaksi vaihtuu «Yhdistetty ja aktiivinen». Saat tuloksesta sähköpostin.

💡 Päätä ennen synkronointia, kummassa järjestelmässä on ajantasaisimmat tiedot. Tässä tekemäsi valinnat korvaavat tietoja.

⚠️ Käyttäjiä, joilta puuttuu pakollisia kenttiä, kuten Henkilöllisyys-tiedon maa, ei synkronoida ennen kuin arvot on täytetty. Jotta työntekijä voidaan luoda Netvisoriin, hänellä on oltava suomalainen henkilötunnus ja Humassa tehtävä, jolla on alkamispäivä ja tehtävänimike.

 

Milloin synkronoit käyttäjät

Humassa tehdyt muutokset lähetetään Netvisoriin automaattisesti. Valitse «Synkronoi käyttäjät», kun:

  • Olet juuri ottanut integraation käyttöön ja haluat aktivoida sen.
  • Olet muuttanut tuettua kenttää Netvisorissa ja haluat muutoksen Humaan.
  • Olet lisännyt Netvisoriin työntekijöitä, jotka pitää luoda Humaan.
  • Olet lisännyt Humaan työntekijöitä, jotka pitää luoda Netvisoriin. Uusia työntekijöitä ei koskaan luoda Netvisoriin automaattisesti.

 

Tärkeää tietoa palkanlaskijalle

Kun työntekijöitä luodaan Humasta Netvisoriin, tarkista nämä kentät Netvisorissa manuaalisesti 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ää päivitetään. Valitse sopiva työeläkevakuutus.

 

Kun työntekijä lähtee

Deaktivoitu Humassa:

  • Työntekijää ei deaktivoida Netvisorissa.
  • Työntekijä lukitaan integraation päivityksiltä.

Poistettu Humassa:

  • Työntekijää ei poisteta Netvisorista.
  • Kun seuraavan kerran valitset «Synkronoi käyttäjät», sinulle ehdotetaan työntekijän luomista uudelleen Humaan.

💡 Jos haluat merkitä työsuhteen päättyneeksi Netvisorissa, aseta tehtävälle päättymispäivä ja päättymisen syy Humassa. Katso Tehtävätiedot.

 

 

Työntekijätiedot

Humassa tehdyt muutokset lähetetään automaattisesti. Netvisorissa tehdyt muutokset haetaan valitsemalla «Synkronoi käyttäjät».

Kenttä Humassa Kenttä Netvisorissa Pakollinen Huomiot
Sähköpostiosoite E-mail ✅ Käytetään työntekijöiden yhdistämiseen. Arvon on oltava yksilöllinen Humassa. Kun muutat sähköpostiosoitteen Humassa, se päivittyy Netvisoriin.
API-nimi: employeebaseinformation.email
Henkilöllisyys Personal identity code ✅ Kelvollinen suomalainen henkilötunnus vaaditaan, kun työntekijöitä luodaan Netvisoriin. Muiden maiden henkilötunnukset hyväksytään, kun työntekijöitä tuodaan Netvisorista Humaan. Integraatio ei voi päivittää tai tyhjentää arvoa.
API-nimi: employeebaseinformation.employeeidentifier
Etunimi First name ✅ API-nimi: employeebaseinformation.firstname
Sukunimi Last name ✅ API-nimi: employeebaseinformation.lastname
Osoite Street address, Municipality, Post number, Country ✅ Kaikki neljä on täytettävä Netvisorissa, jotta osoite synkronoidaan Humaan.
API-nimet: streetaddress, municipality, postnumber, country
Työntekijätunnus Employee number   Arvon on oltava yksilöllinen. Arvon on oltava numero. Enintään 10 merkkiä.
API-nimi: employeepayrollinformation.employeenumber
Puhelinnumero Phone number   Arvon on oltava yksilöllinen Humassa.
API-nimi: employeebaseinformation.phonenumber
Kansallisuus Nationality   Jos kansallisuus puuttuu Humasta, käytetään suomalaista. Integraatio voi päivittää arvon, mutta ei tyhjentää sitä.
API-nimi: employeebaseinformation.nationality
Sukupuoli Gender   Johdetaan Netvisorissa henkilötunnuksesta. Tuodaan vain Humaan. Integraatio ei voi päivittää tai tyhjentää arvoa.
API-nimi: employeebaseinformation.gender
Syntymäaika Date of birth   Johdetaan Netvisorissa henkilötunnuksesta. Tuodaan vain Humaan. Integraatio ei voi päivittää tai tyhjentää arvoa.
API-nimi: employeebaseinformation.dateofbirth
Tilinumero IBAN account number ja Bank's BIC code   Vain kansainvälisessä muodossa (IBAN ja BIC).
API-nimet: bankaccountnumber, bankidentificationcode

 

 

Tehtävätiedot

Tehtävät liikkuvat yhteen suuntaan: Humasta Netvisoriin työsuhdejaksoina. Ne lähetetään vain, kun «Tehtävät: Luo, päivitä ja poista» on käytössä.

Näin tehtävät lähetetään

  • Huma yhdistää tehtävät Netvisorin työsuhdejaksoihin alkamispäivän ja tehtävänimikkeen perusteella.
  • Kun lisäät tehtävän Humassa, Netvisoriin luodaan uusi työsuhdejakso. Jos jakso, jolla on sama alkamispäivä ja tehtävänimike, on jo olemassa, uutta ei luoda.
  • Kun muutat tehtävää, Huma etsii jakson, jolla on tehtävän alkamispäivä ja tehtävänimike ennen muutosta. Jos sitä ei löydy, muutosta ei lähetetä, ja virhelokiin tulee virhe.
  • Kun poistat tehtävän, Huma poistaa vastaavan jakson Netvisorista. Jos sitä ei löydy, mitään ei poisteta.
  • Netvisor ei salli päällekkäisiä työsuhdejaksoja. Uutta tai muutettua tehtävää, joka on päällekkäin toisen jakson kanssa, ei lähetetä, ja virhelokiin tulee virhe.
  • Kun työntekijä luodaan Netvisoriin, hänen ensimmäisestä Human tehtävästään tulee ensimmäinen työsuhdejakso.

💡 Kun muokkaat ensimmäistä tehtävää, jonka Huma loi automaattisesti työsuhdehistorian käyttöönoton yhteydessä, varmista, että alkamispäivä ja tehtävänimike vastaavat Netvisorin jaksoa. Voit myös tehdä muutokset, tallentaa ne ja valita «Luo uusi tehtävä».

 

Kenttä Humassa Kenttä Netvisorissa Huomiot
Sopimuksen alkamispäivä Start date ja Company start date Pakollinen. Käytetään tehtävänimikkeen kanssa jakson yhdistämiseen. Ei voi tyhjentää Netvisorissa.
API-nimet: startdate, companystartdate
Tehtävänimike Profession Pakollinen. Käytetään alkamispäivän kanssa jakson yhdistämiseen. Ei voi tyhjentää Netvisorissa.
API-nimi: profession
Sopimuksen päättymispäivä End date API-nimi: enddate
Koeajan päättymispäivä Probation end date API-nimi: probationenddate
Työaikaprosentti Employment form ja Part-time percent 100 % lähetetään kokoaikaisena. Muut prosentit lähetetään osa-aikaisena prosentin kanssa.
API-nimet: employmentform, parttimepercent
Sopimustyyppi Employment method Katso alla oleva taulukko.
API-nimi: employmentmode
Päättymisen syy End reason Katso alla oleva taulukko.
API-nimi: endreason

 

Sopimustyypit

Sopimustyyppi Humassa Lähetetään Netvisoriin arvona
Vakituinen, Määräaikainen, Kausiluonteinen, Tilapäinen, Työharjoitteluohjelma Employed
Konsultti, Freelance, Kolmas osapuoli Leased employee
Harjoittelija Trainee
Muu Ei lähetetä

 

Employment method Netvisorissa Tuodaan Humaan arvona
Employed, Self employed Vakituinen
Leased employee Konsultti
Trainee Harjoittelija
Voluntary work Määräaikainen

 

Päättymisen syyt

Päättymisen syy Humassa Lähetetään Netvisoriin arvona
Työntekijä on irtisanoutunut Employee's own request
Työnantaja on irtisanonut työntekijän Reason attributable to the employee
Sopimus, toimeksianto tai määräaikaisuus on päättynyt Fixed-term employment
Organisaatiorakenteen muutos tai sisäinen työpaikan siirto Other reason
Muuttunut palkanlaskentajärjestelmä tai kirjanpitäjä Other reason
Muu Other reason

 

⚠️ «Työnantaja on irtisanonut työntekijän» lähetetään arvona «Reason attributable to the employee» (työntekijästä johtuva syy). Jos irtisanominen johtui taloudellisista tai tuotannollisista syistä, korjaa päättymisen syy Netvisorissa.

 

 

Poissaolotiedot

Netvisor-integraatio ei tue poissaoloja. Poissaoloja ei lähetetä Human ja Netvisorin välillä.

 

 

Palkkatiedot

Netvisor-integraatio ei tue palkkoja. Palkkoja ei lähetetä Human ja Netvisorin välillä.

 

 

Muuta integraation asetuksia

  1. Siirry Humassa Netvisor-integraatioon.
  2. Valitse oikeasta yläkulmasta ···.
  3. Valitse vaihtoehto:
    • «Muokkaa yhteysasetuksia», jos haluat muuttaa asetusta tai User ID:tä, Keytä ja Business ID:tä.
    • «Muokkaa yhteystietoja», jos haluat muuttaa nimeä tai sitä, ketkä kuuluvat yhteyteen.

Asetus on selitetty kohdassa Vaihe 3: Valitse, mitä synkronoidaan.

 

Yhteyden katkaiseminen tai poistaminen

  • Katkaise yhteys: Synkronointi pysähtyy, mutta määritykset säilyvät.
  • Poista: Synkronointi pysähtyy ja kaikki tallennetut määritykset poistetaan.

 

 

Virheloki

Mistä löydät virhelokin

  1. Siirry Humassa Netvisor-integraatioon.
  2. Avaa välilehti «Error log».

Virheet on ryhmitelty päivittäin. Jokaisessa merkinnässä näkyy viesti, ajankohta, työntekijä, jota se koskee, ja taso:

Taso Merkitys
🔴 Virhe Jotain ei lähetetty Netvisoriin. Sinun on tehtävä jotain.
🟡 Varoitus Jokin vaatii huomiotasi.
🔵 Info Tiedoksi. Sinun ei tarvitse tehdä mitään.

 

Integraation tila

Tila integraatiosivulla Mitä teet
Tämä integrointi on konfiguroitu, mutta se ei ole aktiivinen Ota integraatio käyttöön valitsemalla «Synkronoi käyttäjät».
Yhdistetty ja aktiivinen Kaikki toimii.

 

Yleiset virheet

Ongelma Mitä se tarkoittaa Näin korjaat sen
User must have a position with contract start date to create employee in netvisor Työntekijällä ei ole Humassa tehtävää, jolla on alkamispäivä. Lisää Humaan tehtävä, jolla on alkamispäivä, ja valitse «Synkronoi käyttäjät».
Netvisor does not allow overlapping employment periods Tehtävä on päällekkäin toisen Netvisorin työsuhdejakson kanssa. Muuta päivämäärät niin, etteivät jaksot ole päällekkäin.
Vastaavaa tehtävää ei löytynyt Netvisorissa ei ole työsuhdejaksoa, jolla on tehtävän alkamispäivä ja tehtävänimike ennen muutosta. Vertaa Netvisorin jaksoa Human tehtävään ja tee muutos manuaalisesti Netvisorissa.
Email mismatch when trying to update Netvisorin sähköpostiosoite ei enää vastaa Human työntekijää. Varmista, että sähköpostiosoite on sama molemmissa järjestelmissä, ja valitse «Synkronoi käyttäjät».
Virhe päivitettäessä Humasta luotua työntekijää TyEL on Netvisorissa asetettu arvoon «No handling». Valitse sopiva työeläkevakuutus Netvisorissa.
Yhteys Netvisoriin lakkaa toimimasta API-tunniste ei enää toimi tai API-resurssien käyttöoikeudet puuttuvat. Tarkista API-tunniste ja käyttöoikeudet Netvisorissa ja päivitä ne kohdassa «Muokkaa yhteysasetuksia».

 

 

Usein kysytyt kysymykset

Miksi Netvisorissa tekemäni muutokset eivät näy Humassa?
Muutokset siirtyvät automaattisesti vain Humasta Netvisoriin. Jos haluat hakea Netvisorin muutokset Humaan, valitse «Synkronoi käyttäjät».

 

Miksi Humaan lisättyä uutta työntekijää ei luoda Netvisoriin?
Työntekijöitä ei koskaan luoda automaattisesti. Valitse «Synkronoi käyttäjät» ja valitse, että työntekijä luodaan Netvisoriin. Työntekijällä on oltava suomalainen henkilötunnus ja tehtävä, jolla on alkamispäivä ja tehtävänimike.

 

Voivatko työsuhdejaksot olla päällekkäisiä?
Eivät. Netvisor ei salli päällekkäisiä työsuhdejaksoja. Tehtäviä, joiden päivämäärät ovat päällekkäin, ei lähetetä.

 

Mitä Netvisorissa tapahtuu, kun poistan tehtävän Humassa?
Huma poistaa työsuhdejakson, jolla on sama alkamispäivä ja tehtävänimike. Jos sitä ei löydy, mitään ei poisteta.

 

Voinko synkronoida poissaoloja tai palkkoja Netvisorin kanssa?
Et. Netvisor-integraatio tukee vain työntekijätietoja ja tehtäviä.

 

Voiko aiempia tehtäviä siirtää?
Ei. Vain tehtävät, jotka luodaan, joita muutetaan tai jotka poistetaan integraation käyttöönoton jälkeen, lähetetään.

 

Voiko minulla olla useampi Netvisor-yhteys?
Voi. Voit esimerkiksi määrittää yhden yhteyden yritystä kohden. Katso Useita yhteyksiä.