Netvisor-integraatio
Yhdistä Huma Netvisoriin, niin työntekijäprofiilit ja työsuhdejaksot pysyvät synkronoituina
Sisällysluettelo
- Johdanto
- Roolit ja käyttöoikeudet
- Ota integraatio käyttöön
- Synkronoi työntekijät
- Työntekijätiedot
- Tehtävätiedot
- Poissaolotiedot
- Palkkatiedot
- Muuta integraation asetuksia
- Virheloki
- Usein kysytyt kysymykset
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
- Kirjaudu Netvisoriin pääkäyttäjänä.
- Avaa yritysvalikko ja valitse «API identifiers».
- Luo uusi API-tunniste oikealla olevalla painikkeella.
- Kopioi «User ID» ja «Key» talteen myöhempää käyttöä varten.
Salli API-resurssit
- Avaa yritysvalikko ja valitse «API resource access rights».
- Vieritä alas «Salaries»-osioon.
- 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

Hae Business ID
- Avaa yritysvalikko ja valitse «Service Management».
- Kopioi «Business ID» talteen myöhempää käyttöä varten.
Vaihe 2: Yhdistä Huma Netvisoriin
- Siirry Humassa kohtaan «Integraatiot» ja valitse «Netvisor».
- Lue välilehdet «Yleiskatsaus» ja «Tiedot».
- Valitse oikeasta yläkulmasta «Määritä».
- Anna yhteydelle nimi.
- Valitse, ketkä kuuluvat yhteyteen: kaikki tai tietty tiimi, sijainti tai yritys.
- Valitse «Jatka».
- Liitä Netvisorin User ID, Key ja Business ID.
- Vahvista, että sinulla on valtuudet hyväksyä ehdot organisaatiosi puolesta.
- 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
- Siirry Humassa Netvisor-integraatioon ja valitse «Synkronoi käyttäjät».
- 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».
- 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.
- 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 | ✅ | 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
- Siirry Humassa Netvisor-integraatioon.
- Valitse oikeasta yläkulmasta ···.
- 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
- Siirry Humassa Netvisor-integraatioon.
- 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ä.