Finago-integraatio
Yhdistä Huma Finagoon (aiemmin 24SevenOffice), niin työntekijäprofiilit ja työsuhteet pysyvät synkronoituina
Sisällysluettelo
- Roolit ja käyttöoikeudet
- Näin tiedot liikkuvat
- Ennen kuin aloitat
- Integraation määrittäminen
- Kun integraatio on aktiivinen
- Tuetut kentät
- Virheloki ja vianmääritys
- Usein kysytyt kysymykset
- Aiheeseen liittyvät artikkelit
Roolit ja käyttöoikeudet
| Rooli Humassa | Järjestelmärooli, jolla on täydet oikeudet Organisaatioon |
| Rooli Finagossa | Pääsy asetuksiin, jotta voit luoda API-avaimen |
💡 Etkö ole varma, mitä rooleja tarvitset Finagossa? Ota yhteyttä Finagon järjestelmänvalvojaan tai Finagon tukeen.
Näin tiedot liikkuvat
| Tieto | Huma → Finago | Finago → Huma | Milloin |
|---|---|---|---|
| Profiilikentät | ✅ Automaattisesti | ✅ Vain manuaalisesti | Humassa tehdyt muutokset lähetetään reaaliajassa. Finagossa 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ösuhteet) | ✅ Automaattisesti, jos asetus on käytössä | ❌ | Kun tehtävä luodaan tai sitä päivitetään Humassa |
| Poissaolot | ❌ | ❌ | Ei tuettu |
| Palkka | ❌ | ❌ | Ei tuettu |
⚠️ Aiempia tietoja ei siirretä. Vain tehtävät, jotka luodaan tai joita päivitetään integraation käyttöönoton jälkeen, lähetetään Finagoon.
Ennen kuin aloitat
- Sinulla on Humassa järjestelmärooli, jolla on täydet oikeudet Organisaatioon.
- Sinä tai kollegasi voitte kirjautua Finagoon ja luoda API-avaimen.
- Molemmissa järjestelmissä olevilla työntekijöillä on sama sähköpostiosoite Humassa ja Finagossa. Huma yhdistää työntekijät vain sähköpostiosoitteen perusteella.
- Tiedät, onko Finagossa oleva yritys norjalainen vai ruotsalainen. Huma valitsee yrityksen maan perusteella, mitkä sopimustyypit ja päättymisen syyt lähetetään.
Integraation määrittäminen
Vaihe 1: Luo API-avain Finagossa
- Kirjaudu Finagoon.
- Avaa päävalikosta «Settings».
- Siirry «Misc»-välilehdelle.
- Luo sivun alareunassa uusi API-avain.
- Kopioi API-avain.

Vaihe 2: Yhdistä Huma Finagoon
- Siirry Humassa kohtaan «Integraatiot» ja valitse «Finago».
- 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ä Finagosta kopioimasi API-avain.
- Vahvista, että sinulla on valtuudet hyväksyä ehdot organisaatiosi puolesta.
- Valitse «Jatka».
🔗 Tarvitsetko useita yhteyksiä, esimerkiksi yhden yritystä kohden? Katso Useat yhteydet.

Vaihe 3: Valitse, mitä synkronoidaan
Finagossa on yksi asetus. Voit muuttaa sitä myöhemmin.
| Asetus | Kun asetus on käytössä | Kun asetus ei ole käytössä |
|---|---|---|
| Tehtävät: Luo, päivitä ja poista | Uusi tehtävä Humassa luo uuden työsuhteen Finagoon. Humassa tehtävään tehdyt muutokset päivittävät vastaavan työsuhteen Finagossa. | Tehtävätietoja ei lähetetä Finagoon. |
⚠️ Humassa poistettuja tehtäviä ei poisteta Finagosta. Integraatio ei voi poistaa työsuhdetta Finagosta, vaikka asetuksessa mainitaan poistaminen.
💡 Suosittelemme, että otat tehtävät käyttöön ennen kuin alat hallita tehtäviä Humassa.
💡 Humaan lisättyjä uusia työntekijöitä ei luoda automaattisesti Finagoon. Luo heidät Finagoon valitsemalla «Synkronoi käyttäjät».

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 tehnyt tämän vaiheen.
- 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 Finagon arvolla, päivitetäänkö Finago 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: Finago → Huma tai Huma → Finago.
- Valitse «Synkronoi käyttäjät».
Tilaksi vaihtuu «Yhdistetty ja aktiivinen». Saat tuloksesta sähköpostin.
💡 Huomaa
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ä, ei synkronoida ennen kuin arvot on täytetty.

Kun integraatio on aktiivinen
Tämä tapahtuu automaattisesti
- Humassa tuettuihin profiilikenttiin tehdyt muutokset lähetetään Finagoon reaaliajassa.
- Jos tehtävät ovat käytössä, Humassa uudet ja päivitetyt tehtävät lähetetään Finagoon.

Milloin sinun on synkronoitava manuaalisesti
Valitse «Synkronoi käyttäjät», kun:
- Olet muuttanut tuettua kenttää Finagossa ja haluat muutoksen Humaan.
- Olet lisännyt Finagoon työntekijöitä, jotka pitää luoda Humaan.
- Olet lisännyt Humaan työntekijöitä, jotka pitää luoda Finagoon.

Näin tehtävät yhdistetään
- Finago sallii päällekkäiset työsuhteet. Jokainen uusi tehtävä Humassa luo uuden työsuhteen Finagoon.
- Kun päivität tehtävää, Huma etsii Finagosta työsuhteen, jolla on sama alkamispäivä kuin tehtävällä oli ennen muutosta.
- Jos Finagossa ei ole työsuhdetta, jolla on tämä alkamispäivä, päivitystä ei lähetetä, ja virhelokiin tulee virhe.
- Jos lisäät päättymispäivän ilman päättymisen syytä, Finagoon lähetetään päättymisen syyksi «Arbeidstaker har sagt opp selv» (työntekijä on irtisanoutunut).
💡 Kun muokkaat ensimmäistä tehtävää, jonka Huma loi automaattisesti työsuhdehistorian käyttöönoton yhteydessä, varmista, että alkamispäivä vastaa Finagon työsuhdetta. Voit myös tehdä muutokset, tallentaa ne ja valita «Luo uusi tehtävä».
Kun työntekijä lähtee
Deaktivoitu Humassa:
- Työntekijää ei deaktivoida Finagossa.
- Työntekijä lukitaan integraation päivityksiltä.
Poistettu Humassa:
- Työntekijää ei poisteta Finagosta.
- Kun seuraavan kerran valitset «Synkronoi käyttäjät», sinulle ehdotetaan työntekijän luomista uudelleen Humaan.
💡 Jos haluat merkitä työsuhteen päättyneeksi Finagossa, aseta tehtävälle päättymispäivä ja päättymisen syy Humassa.
Asetusten tai API-avaimen muuttaminen
- Siirry Humassa Finago-integraatioon.
- Valitse oikeasta yläkulmasta ···.
- Valitse vaihtoehto:
- «Muokkaa yhteysasetuksia», jos haluat muuttaa asetusta tai liittää uuden API-avaimen.
- «Muokkaa yhteystietoja», jos haluat muuttaa nimeä tai sitä, ketkä kuuluvat yhteyteen.
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.
Tuetut kentät
Profiilikentät
Humassa tehdyt muutokset lähetetään automaattisesti. Finagossa tehdyt muutokset haetaan valitsemalla «Synkronoi käyttäjät».
| Kenttä Humassa | Kenttä Finagossa | Pakollinen | Huomiot |
|---|---|---|---|
| Sähköpostiosoite | ✅ | Käytetään työntekijöiden yhdistämiseen. Arvon on oltava yksilöllinen Humassa ja Finagossa. Kun muutat sähköpostiosoitteen Humassa, se päivittyy Finagoon. API-nimi: email |
|
| Etunimi | First name | ✅ | API-nimi: firstname |
| Sukunimi | Last name | ✅ | API-nimi: lastname |
| Puhelinnumero | Phone | Arvon on oltava yksilöllinen Humassa. API-nimi: telefon |
|
| Osoite | Address, Postal code, City, Country | Osoiterivit lähetetään yhtenä rivinä pilkuilla erotettuina. API-nimet: postaddress, zipcode, city, countryCode |
|
| Henkilöllisyys | Personal number ja International ID | Finagossa on tilaa kahdelle tunnisteelle. Norjalainen henkilötunnus tallennetaan henkilönumeroksi. Yksi muu tunniste tallennetaan kansainväliseksi tunnisteeksi. Muita tunnisteita ei lähetetä. Henkilönumero tyhjennetään Finagossa, kun poistat sen Humassa. Integraatio ei voi tyhjentää kansainvälistä tunnistetta. Virhelokiin tulee varoitus, ja tunniste on poistettava Finagossa manuaalisesti. API-nimet: personnr, internationalID.ID, internationalID.countryCode, internationalID.type |
|
| Tilinumero | Account number, Clearing number, BIC | Norjalainen tili: tilinumero. Ruotsalainen tili: clearing-numero ja tilinumero. Kansainvälinen tili: IBAN ja BIC. Tilin on oltava muodoltaan kelvollinen. API-nimet: account, clearingno, bic |
Tehtäväkentät (Huma → Finago)
Lähetetään vain, kun «Tehtävät: Luo, päivitä ja poista» on käytössä.
| Kenttä Humassa | Kenttä Finagossa | Pakollinen | Huomiot |
|---|---|---|---|
| Sopimuksen alkamispäivä | Start date | Käytetään päivitysten yhdistämiseen oikeaan työsuhteeseen. Ei voi tyhjentää Finagossa. API-nimi: startdate |
|
| Sopimuksen päättymispäivä | End date | Tyhjennetään Finagossa, kun poistat sen Humassa. API-nimi: enddate |
|
| Työaikaprosentti | Employment rate | Ei voi tyhjentää Finagossa. API-nimi: employment_rate |
|
| Sopimustyyppi | Employment form | Katso alla oleva taulukko. Ei voi tyhjentää Finagossa. API-nimi: employment_form |
|
| Päättymisen syy | End date reason | Katso alla oleva taulukko. Jos päättymispäivä on asetettu mutta syytä ei ole, lähetetään «Arbeidstaker har sagt opp selv». API-nimi: enddate_reason |
Sopimustyypit
| Sopimustyyppi Humassa | Norjalainen yritys Finagossa | Ruotsalainen yritys Finagossa |
|---|---|---|
| Vakituinen | Fast | Tillsvidare |
| Määräaikainen | Midlertidig | Tidsbegränsad |
| Kausiluonteinen | Midlertidig | Behovsanställd |
| Tilapäinen | Midlertidig ansatt som tilkallingsvikar | Behovsanställd |
| Harjoittelija | Midlertidig | Tidsbegränsad |
| Työharjoitteluohjelma | Midlertidig | Tidsbegränsad |
Päättymisen syyt
| Päättymisen syy Humassa | Norjalainen yritys Finagossa | Ruotsalainen yritys Finagossa |
|---|---|---|
| Työntekijä on irtisanoutunut | Arbeidstaker har sagt opp selv | Egen begäran |
| Työnantaja on irtisanonut työntekijän | Arbeidsgiver har sagt opp arbeidstaker | Uppsagd arbetsbrist |
| Sopimus, toimeksianto tai määräaikaisuus on päättynyt | Kontrakt, engasjement eller vikariat er utløpt | Tidsbegränsad anställning |
| Organisaatiorakenteen muutos tai sisäinen työpaikan siirto | Endring i organisasjonsstruktur eller byttet jobb internt | Annan orsak |
| Muuttunut palkanlaskentajärjestelmä tai kirjanpitäjä | Byttet lønnssystem eller regnskapsfører | Annan orsak |
| Muu | Arbeidsforholdet skulle aldri vært rapportert | Annan orsak |
⚠️ Norjalaisille yrityksille päättymisen syy «Muu» lähetetään muodossa «Arbeidsforholdet skulle aldri vært rapportert» (työsuhdetta ei olisi pitänyt ilmoittaa). Valitse tarkempi päättymisen syy aina kun voit.
Virheloki ja vianmääritys
Mistä löydät virhelokin
- Siirry Humassa Finago-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 Finagoon. 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 |
|---|---|---|
| We couldn't find a matching position … | Finagossa ei ole työsuhdetta, jolla on sama alkamispäivä kuin Humassa päivittämälläsi tehtävällä. | Tarkista, että työsuhde on Finagossa samalla alkamispäivällä. Korjaa alkamispäivä toisessa järjestelmässä tai luo Humassa uusi tehtävä. |
| An identification could not be removed from Finago | Integraatio ei voi tyhjentää kansainvälistä tunnistetta. | Poista kansainvälinen tunniste Finagossa manuaalisesti. |
| Email mismatch when trying to update | Finagon 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». |
| Yhteys Finagoon lakkaa toimimasta | API-avain ei enää toimi, esimerkiksi koska se on poistettu Finagosta. | Luo uusi API-avain Finagossa ja liitä se kohtaan «Muokkaa yhteysasetuksia». |
Usein kysytyt kysymykset
Miksi Finagossa tekemäni muutokset eivät näy Humassa?
Muutokset siirtyvät automaattisesti vain Humasta Finagoon. Jos haluat hakea Finagon muutokset Humaan, valitse «Synkronoi käyttäjät».
Miksi Humaan lisättyä uutta työntekijää ei luoda Finagoon?
Finagossa ei ole asetusta työntekijöiden automaattiseen luomiseen. Valitse «Synkronoi käyttäjät» ja valitse, että työntekijä luodaan Finagoon.
Mitä Finagossa tapahtuu, kun poistan tehtävän Humassa?
Ei mitään. Integraatio ei voi poistaa työsuhteita Finagosta. Poista työsuhde tarvittaessa Finagossa manuaalisesti.
Miksi saan virheen, kun päivitän tehtävää?
Huma yhdistää tehtävän Finagon työsuhteeseen alkamispäivän perusteella. Jos millään työsuhteella ei ole samaa alkamispäivää, päivitys epäonnistuu. Tarkista alkamispäivä molemmista järjestelmistä.
Voinko synkronoida poissaoloja tai palkkoja Finagon kanssa?
Et. Finago-integraatio tukee vain profiilikenttiä ja tehtäviä.
Voiko aiempia tehtäviä siirtää?
Ei. Vain tehtävät, jotka luodaan tai joita päivitetään integraation käyttöönoton jälkeen, lähetetään. Jos haluat lähettää vanhemman tehtävän, päivitä se Humassa integraation käyttöönoton jälkeen.
Aiheeseen liittyvät artikkelit