Fortnox-integraatio
Yhdistä Huma Fortnoxiin, niin työntekijäprofiilit, työsuhteen päivämäärät ja poissaolot pysyvät synkronoituina
Sisällysluettelo
- Roolit ja käyttöoikeudet
- Näin tiedot siirtyvät
- Ennen kuin aloitat
- Integraation määrittäminen
- Kun integraatio on aktiivinen
- Tuetut kentät
- Virheloki ja vianmääritys
- Usein kysytyt kysymykset
Roolit ja käyttöoikeudet
| Rooli Humassa | Järjestelmärooli, jolla on täydet oikeudet Organisaatioon |
| Fortnoxissa | Aktiivinen integraatiolisenssi ja Fortnox-käyttäjä, joka voi hyväksyä yhteyden Humaan. Huma pyytää pääsyä palkka- ja yritystietoihin. |
💡 Etkö ole varma, mitä rooleja tarvitset Fortnoxissa? Ota yhteyttä Fortnoxin tukeen.
Näin tiedot siirtyvät
| Tieto | Huma → Fortnox | Fortnox → Huma | Milloin |
|---|---|---|---|
| Profiilin kentät | ✅ Automaattisesti | ✅ Vain manuaalisesti | Humassa tehdyt muutokset lähetetään reaaliajassa. Fortnoxissa tehdyt muutokset tuodaan, kun valitset «Synkronoi käyttäjät». |
| Uudet työntekijät | ✅ Vain manuaalisesti | ✅ Vain manuaalisesti | Kun valitset «Synkronoi käyttäjät» |
| Työsuhteen päivämäärät | ✅ Automaattisesti | ❌ | Kun tehtävä luodaan, sitä muutetaan tai se poistetaan Humassa |
| Poissaolot | ✅ Automaattisesti | ❌ | Kun poissaolo on hyväksytty Humassa ja sillä on päättymispäivä |
| Palkka | ❌ | ❌ | Ei tuettu |
⚠️ Historiallisia tietoja ei siirretä. Fortnoxiin lähetetään vain tehtävät ja poissaolot, jotka luodaan tai joita muutetaan sen jälkeen, kun integraatio on aktiivinen.
Ennen kuin aloitat
- Sinulla on Humassa järjestelmärooli, jolla on täydet oikeudet Organisaatioon.
- Fortnox-tililläsi on integraatiolisenssi. Katso vaihe 1.
- Molemmissa järjestelmissä olevilla työntekijöillä on sama sähköpostiosoite Humassa ja Fortnoxissa. Huma yhdistää työntekijät vain sähköpostiosoitteen perusteella.
- Jos haluat synkronoida poissaolot:
- Poissaolot on ensin määritettävä Humassa (poissaolotyypit tai työaika-asetukset).
- Kaikilla työntekijöillä on oltava voimassa oleva työaikataulu Fortnoxissa. Poissaolotunnit lasketaan sen perusteella.
Integraation määrittäminen
Vaihe 1: Ota integraatiolisenssi käyttöön Fortnoxissa
Fortnox vaatii aktiivisen integraatiolisenssin, jotta siihen voi yhdistää kolmannen osapuolen järjestelmiä. Yksi lisenssi riittää kaikille integraatioille. Jos sinulla on jo lisenssi, voit ohittaa tämän vaiheen.
- Kirjaudu Fortnoxiin.
- Siirry kohtaan «Administrera användare» (Käyttäjien hallinta).
- Valitse «Lägg till licenser» (Lisää lisenssejä).
- Vieritä alas kohtaan «Integration: Integrera Fortnox med ett annat system» (Integroi Fortnox toiseen järjestelmään).
- Valitse «Lägg till» (Lisää).
💡 Jos sinulla on kysyttävää lisensseistä tai Fortnoxin API:sta, ota yhteyttä Fortnoxiin.



Vaihe 2: Yhdistä Huma Fortnoxiin
- Siirry Humassa kohtaan «Integraatiot» ja valitse «Fortnox».
- Lue välilehdet «Yleiskatsaus» ja «Tiedot».
- Valitse oikeasta yläkulmasta «Määritä».
- Anna yhteydelle nimi.
- Valitse, ketkä kuuluvat yhteyteen: kaikki tai tietty tiimi, toimipiste tai yritys.
- Hyväksy ehdot ja valitse «Jatka».
- Valitse asetukset (katso vaihe 3) ja valitse «Tallenna».
- Fortnox-ikkuna avautuu. Kirjaudu tarvittaessa sisään ja valitse «Godkänn behörighet» (Hyväksy käyttöoikeus).
🔗 Tarvitsetko useamman yhteyden, esimerkiksi yhden yritystä kohden? Katso Useat integraatiot.


Vaihe 3: Valitse synkronoitavat tiedot
Fortnoxissa on yksi asetus. Voit muuttaa sitä myöhemmin.
| Asetus | Kun asetus on käytössä | Kun asetus ei ole käytössä |
|---|---|---|
| Poissaolot: Luo, päivitä ja poista Fortnox -järjestelmässä, kun ne on päivitetty Humaan | Hyväksytyt poissaolot lähetetään Fortnoxiin poissaolotapahtumina. | Poissaoloja ei lähetetä. |
💡 Työsuhteen päivämäärät lähetetään aina. Niille ei ole asetusta.

Vaihe 4: Yhdistä poissaolotyypit
Tämä vaihe tehdään vain, jos poissaolojen synkronointi on käytössä.
- Käy läpi jokainen Human poissaolotyyppi.
- Valitse vastaava poissaolon syy Fortnoxissa.
- Jätä yhdistämättä tyypit, joita et halua lähettää.
- Valitse «Tallenna».
⚠️ Fortnoxissa on vain yksi sairauspoissaolon tyyppi, kun taas Humassa on sekä «Sairauspoissaolo omalla ilmoituksella» että «Sairauspoissaolo». Suosittelemme, että yhdistät molemmat Fortnoxin tyyppiin «Sjukfrånvaro» (Sairauspoissaolo).
⚠️ Jos yhdistät poissaolotyypin myöhemmin eri syyhyn, jo Fortnoxiin lähetettyjä poissaoloja ei enää päivitetä Humasta. Jos haluat yhdistää ne uudelleen, muuta kyseiset merkinnät Fortnoxissa uuteen syyhyn.

Vaihe 5: Synkronoi käyttäjät integraation aktivoimiseksi
Määrittämisen 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 eroavia tai puuttuvia arvoja.
- Valitse kussakin tapauksessa, päivitetäänkö Huma Fortnoxin arvolla, Fortnox Human arvolla vai jätetäänkö arvo 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: Fortnox → Huma tai Huma → Fortnox.
- 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 puuttuvat arvot on lisätty.




Kun integraatio on aktiivinen

Mitä tapahtuu automaattisesti
- Humassa tuettuihin profiilin kenttiin tehdyt muutokset lähetetään Fortnoxiin reaaliajassa.
- Työsuhteen päivämäärät päivitetään Fortnoxiin, kun tehtävä luodaan, sitä muutetaan tai se poistetaan Humassa.
- Poissaolot lähetetään, kun ne muuttuvat Humassa, jos poissaolojen synkronointi on käytössä.
Milloin synkronoit manuaalisesti
Valitse «Synkronoi käyttäjät», kun:
- olet muuttanut tuettua kenttää Fortnoxissa ja haluat muutoksen Humaan.
- olet lisännyt Fortnoxiin työntekijöitä, jotka pitää luoda Humaan.
- olet lisännyt Humaan työntekijöitä, jotka pitää luoda Fortnoxiin. Uusia työntekijöitä ei koskaan luoda Fortnoxiin automaattisesti.
Humasta luodut uudet työntekijät
- Työntekijä saa Fortnoxissa henkilöstötyypin «TJM» (toimihenkilö).
- Työsuhteen päivämäärät haetaan työntekijän tehtävistä Humassa.
- Työntekijä saa työaikataulun, jossa on 0 tuntia. Kaikki poissaolot ovat silloin 0 tuntia. Määritä voimassa oleva työaikataulu Fortnoxin välilehdellä «Anställning» (Työsuhde).
Kun työntekijä lähtee
Deaktivoitu Humassa:
- Työntekijää ei deaktivoida Fortnoxissa.
- Työntekijä lukitaan integraation päivityksiltä.
Poistettu Humasta:
- Työntekijää ei poisteta Fortnoxista.
- Seuraavassa synkronoinnissa ehdotetaan työntekijän luomista uudelleen Humaan.
- Työntekijää ei voi synkronoida, jos häntä on muutettu Fortnoxissa sen jälkeen, kun hänet poistettiin Humasta.
💡 Jos haluat kirjata työsuhteen päättymisen Fortnoxiin, aseta sopimuksen päättymispäivä työntekijän viimeiselle tehtävälle Humassa.
Asetusten muuttaminen
- Siirry Humassa Fortnox-integraatioon.
- Valitse oikeasta yläkulmasta ···.
- Valitse jokin vaihtoehto:
- «Muokkaa yhteysasetuksia», jos haluat ottaa poissaolojen synkronoinnin käyttöön tai poistaa sen käytöstä.
- «Muokkaa yhteystietoja», jos haluat muuttaa nimeä tai sitä, ketkä kuuluvat yhteyteen.
- «Yhdistä poissaolotyypit», jos haluat muuttaa poissaolotyyppien yhdistämistä.
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
Profiilin kentät
Humassa tehdyt muutokset lähetetään automaattisesti. Fortnoxissa tehdyt muutokset tuodaan toiminnolla «Synkronoi käyttäjät».
| Human kenttä | Kenttä Fortnoxissa | Pakollinen | Huomioita |
|---|---|---|---|
| Etunimi | Förnamn | API-nimi: Employee.FirstName |
|
| Sukunimi | Efternamn | API-nimi: Employee.LastName |
|
| Sähköpostiosoite | E-post | ✅ | Käytetään työntekijöiden yhdistämiseen. Oltava yksilöllinen Humassa. API-nimi: Employee.Email |
| Puhelinnumero | Telefon 1 | Oltava yksilöllinen Humassa. Jos Fortnoxin numerossa ei ole maatunnusta, käytetään Ruotsin maatunnusta (+46). API-nimi: Employee.Phone1 |
|
| Työntekijätunnus | Anställningsnummer | ✅ | Oltava yksilöllinen Humassa. Lähetetään vain, kun työntekijä luodaan Fortnoxiin, eikä sitä päivitetä sen jälkeen. Jos muutat sitä Humassa, työntekijän yhteys integraatioon katkeaa. API-nimi: Employee.EmployeeId |
| Pankkitili | Clearingnummer / Kontonummer | Vain ruotsalaiset pankkitilit. Kansainvälisiä tilejä ei tueta. API-nimet: Employee.ClearingNo, Employee.BankAccountNo |
|
| Osoite | Adress 1, Adress 2, Postnummer, Ort, Land | Maa lähetetään ruotsinkielisellä nimellä. API-nimet: Employee.Address1, Employee.Address2, Employee.PostCode, Employee.City, Employee.Country |
Työsuhteen päivämäärät (Huma → Fortnox)
| Human kenttä | Kenttä Fortnoxissa | Pakollinen | Huomioita |
|---|---|---|---|
| Sopimuksen alkamispäivä | Anställningsdatum | Käyttää työntekijän ensimmäisen tehtävän sopimuksen alkamispäivää Humassa. API-nimi: Employee.EmploymentDate |
|
| Sopimuksen päättymispäivä | Anställd t.o.m. | Käyttää työntekijän viimeisen tehtävän sopimuksen päättymispäivää Humassa. API-nimi: Employee.EmployedTo |
Poissaolot (Huma → Fortnox)
| Human kenttä | Kenttä Fortnoxissa | Pakollinen | Huomioita |
|---|---|---|---|
| Poissaolotyyppi | Orsak | ✅ | Määritetään vaiheessa 4. API-nimi: AbsenceTransaction.CauseCode |
| Ajanjakso | Datum | ✅ | Yksi poissaolotapahtuma jokaista poissaolopäivää kohden. Enintään 50 työpäivää poissaoloa kohden. API-nimi: AbsenceTransaction.Date |
| Prosentti | Omfattning | ✅ | Tunnit lasketaan työntekijän Fortnox-työaikataulun perusteella. API-nimi: AbsenceTransaction.Extent |
💡 Human poissaolon muistiinpanoja ei lähetetä Fortnoxiin.
Virheloki ja vianmääritys
Mistä löydät virhelokin
- Siirry Humassa Fortnox-integraatioon.
- Avaa välilehti «Error log».
Virheet on ryhmitelty päivittäin. Jokaisessa merkinnässä näkyy viesti, aika, työntekijä, jota se koskee, ja taso:
| Taso | Merkitys |
|---|---|
| 🔴 Virhe | Jotain jäi lähettämättä Fortnoxiin. Sinun on toimittava. |
| 🟡 Varoitus | Jokin vaatii huomiotasi. |
| 🔵 Info | Tiedoksi. Toimenpiteitä ei tarvita. |
Integraation tila
| Tila integraatiosivulla | Mitä teet |
|---|---|
| Tämä integrointi on konfiguroitu, mutta se ei ole aktiivinen | Aktivoi integraatio valitsemalla «Synkronoi käyttäjät». |
| Yhdistetty ja aktiivinen | Kaikki toimii. |
Yleisimmät ongelmat
| Ongelma | Mitä se tarkoittaa | Näin korjaat |
|---|---|---|
| Poissaolo on 0 tuntia Fortnoxissa | Työntekijällä ei ole Fortnoxissa työaikataulua, tai sen tuntimäärä on 0. | Määritä voimassa oleva työaikataulu Fortnoxin välilehdellä «Anställning». |
| Yli 50 työpäivän poissaolo puuttuu Fortnoxista | Huma ei voi luoda, muuttaa tai poistaa Fortnoxissa poissaoloa, joka on yli 50 työpäivää pitkä. | Kirjaa poissaolo Fortnoxiin manuaalisesti tai jaa se Humassa lyhyempiin jaksoihin. |
| Email mismatch when trying to update | Fortnoxin 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». |
| Rate limit exceeded for request… | Huma lähetti Fortnoxiin liian monta pyyntöä lyhyessä ajassa. | Odota hetki ja yritä uudelleen. |
| Yhteys Fortnoxiin lakkaa toimimasta | Hyväksyntä Fortnoxissa on vanhentunut tai poistettu, tai integraatiolisenssi ei ole enää aktiivinen. | Tarkista integraatiolisenssi Fortnoxissa. Yhdistä sitten integraatio uudelleen Humassa ja hyväksy käyttöoikeus Fortnoxissa uudelleen. |
Kun Fortnox hylkää poissaolon
Jos Fortnox hylkää poissaolon, asianosaiset työntekijät ja esihenkilöt saavat ilmoituksen, ja virhe kirjataan. Avaa «Error log», niin näet Fortnoxin viestin.
Usein kysytyt kysymykset
Miksi Fortnoxissa tekemäni muutokset eivät näy Humassa?
Muutokset siirtyvät automaattisesti vain Humasta Fortnoxiin. Jos haluat tuoda muutokset Fortnoxista Humaan, valitse «Synkronoi käyttäjät».
Mitä tehtävätietoja Fortnoxiin lähetetään?
Vain työsuhteen päivämäärät. Ensimmäisen tehtävän sopimuksen alkamispäivä lähetetään työsuhteen alkamispäivänä ja viimeisen tehtävän sopimuksen päättymispäivä päättymispäivänä. Muita tehtäväkenttiä, kuten sopimustyyppiä ja työaikaprosenttia, ei lähetetä.
Milloin poissaolo luodaan, päivitetään tai poistetaan Fortnoxissa?
Luodaan: kun poissaolo on hyväksytty, sillä on päättymispäivä ja sen tyyppi on yhdistetty Fortnoxin syyhyn.
Päivitetään: kun prosentti muuttuu. Jos päivämäärät tai tyyppi muuttuvat, Huma poistaa poissaolon Fortnoxista ja luo sen uudelleen.
Poistetaan: kun poissaolo poistetaan Humasta, sen päättymispäivä poistetaan tai se ei ole enää hyväksytty.
Huma yhdistää poissaolot työntekijän, tyypin ja ajanjakson perusteella.
Miten poissaolotunnit lasketaan?
Fortnox laskee tunnit työntekijän työaikataulun perusteella välilehdellä «Anställning». Humasta luodut työntekijät saavat 0 tunnin aikataulun, joten varmista, että kaikilla on voimassa oleva aikataulu.
Miksi palkkaa ei lähetetä Fortnoxiin?
Fortnox-integraatio ei tue palkkaa. Kirjaa palkkamuutokset Fortnoxiin manuaalisesti.
Voinko siirtää historiallisia poissaoloja tai tehtäviä?
Et. Vain integraation aktivoinnin jälkeen luodut tai muutetut tiedot lähetetään. Jos haluat historialliset poissaolot Fortnoxiin, kirjaa ne Humaan ja hyväksy ne, kun integraatio on aktiivinen.
Tarvitsenko Fortnoxissa useamman kuin yhden integraatiolisenssin?
Et. Yksi integraatiolisenssi riittää kaikille Fortnox-tilisi integraatioille.