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

Finago-integraatio

Yhdistä Huma Finagoon (aiemmin 24SevenOffice), niin työntekijäprofiilit ja työsuhteet pysyvät synkronoituina

 

Sisällysluettelo

 


 

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

  1. Kirjaudu Finagoon.
  2. Avaa päävalikosta «Settings».
  3. Siirry «Misc»-välilehdelle.
  4. Luo sivun alareunassa uusi API-avain.
  5. Kopioi API-avain.

 

Finago access token

 

 

Vaihe 2: Yhdistä Huma Finagoon

  1. Siirry Humassa kohtaan «Integraatiot» ja valitse «Finago».
  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ä Finagosta kopioimasi API-avain.
  8. Vahvista, että sinulla on valtuudet hyväksyä ehdot organisaatiosi puolesta.
  9. Valitse «Jatka».

 

🔗 Tarvitsetko useita yhteyksiä, esimerkiksi yhden yritystä kohden? Katso Useat yhteydet.

 

Finago API key

 

 

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».

 

Tehtävien synkronointi

 

 

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.

  1. 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 Finagon arvolla, päivitetäänkö Finago 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: Finago → Huma tai Huma → Finago.
  4. 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.

 

Finago synkronointi

 

 

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.

 

Finago aktiivinen

 

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.

 

Finago manuaalinen synkronointi

 

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

  1. Siirry Humassa Finago-integraatioon.
  2. Valitse oikeasta yläkulmasta ···.
  3. 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 Email ✅ 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

  1. Siirry Humassa Finago-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 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

🔗 Useat yhteydet