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

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

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.

  1. Kirjaudu Fortnoxiin.
  2. Siirry kohtaan «Administrera användare» (Käyttäjien hallinta).
  3. Valitse «Lägg till licenser» (Lisää lisenssejä).
  4. Vieritä alas kohtaan «Integration: Integrera Fortnox med ett annat system» (Integroi Fortnox toiseen järjestelmään).
  5. Valitse «Lägg till» (Lisää).

 

💡 Jos sinulla on kysyttävää lisensseistä tai Fortnoxin API:sta, ota yhteyttä Fortnoxiin.

 

1-Sep-29-2026-08-24-39-0198-PM

2-Sep-29-2026-08-24-39-0197-PM

3-Sep-29-2026-08-24-39-0432-PM

 

 

Vaihe 2: Yhdistä Huma Fortnoxiin

  1. Siirry Humassa kohtaan «Integraatiot» ja valitse «Fortnox».
  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, toimipiste tai yritys.
  6. Hyväksy ehdot ja valitse «Jatka».
  7. Valitse asetukset (katso vaihe 3) ja valitse «Tallenna».
  8. 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.

 

4-Sep-29-2026-08-25-22-8427-PM

5

 

 

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.

 

1-Sep-29-2026-08-26-43-7296-PM

 

 

Vaihe 4: Yhdistä poissaolotyypit

Tämä vaihe tehdään vain, jos poissaolojen synkronointi on käytössä.

  1. Käy läpi jokainen Human poissaolotyyppi.
  2. Valitse vastaava poissaolon syy Fortnoxissa.
  3. Jätä yhdistämättä tyypit, joita et halua lähettää.
  4. 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.

 

1-Sep-29-2026-08-27-27-1291-PM

 

 

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.

  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 eroavia tai puuttuvia arvoja.
    • Valitse kussakin tapauksessa, päivitetäänkö Huma Fortnoxin arvolla, Fortnox Human arvolla vai jätetäänkö arvo 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: Fortnox → Huma tai Huma → Fortnox.
  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 puuttuvat arvot on lisätty.

 

1-Sep-29-2026-08-28-46-0993-PM

2-Sep-29-2026-08-29-39-9987-PM

3-Sep-29-2026-08-29-39-9987-PM

4-Sep-29-2026-08-28-34-8200-PM

 

 

Kun integraatio on aktiivinen

1-Sep-29-2026-08-30-32-5520-PM

 

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

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

  1. Siirry Humassa Fortnox-integraatioon.
  2. 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.