Skip to content
English
  • There are no suggestions because the search field is empty.

Visma.net Payroll Integration

Slik kobler du Visma.net Payroll til Huma for å aktivere automatisk synkronisering ansattdata

 
 

Innholdsfortegnelse

Sett opp integrasjon

Aktiv integrasjon

Generelle spørsmål

 

*This article is in norwegian. 

 

Visma.Net Payroll

Visma-integrasjonen i Huma er utviklet for å koble Huma HR-systemet ditt til Visma.net Payroll. Denne integrasjonen gjør at du automatisk kan synkronisere ansattdata og fravær mellom Huma og lønnssystemet ditt.

  • For å konfigurere en integrasjon i Huma må du ha en systemrolle med full tilgang til «Organization».

  • Hvis du er usikker på hvilke roller som kreves i Visma.net for å fullføre oppsettet av integrasjonen, ber vi deg kontakte Visma.net-support for veiledning.

 
 
 

 

 

Flere tilkoblinger

Hvis du trenger å konfigurere flere integrasjonsinstanser, følger du veiledningen for oppsett her.

 

 

 

1. Hent Tenant ID fra Visma.net Payroll

  1. Logg inn i Visma.net Payroll som "Administrator" (med tilgang til App Store).

  2. Gå til "Visma.net App Store", finn og åpne "Huma HR-appen".

  3. Klikk på "Angi tillatelser" nederst på Huma-siden i App Store under "Aktiver tjenesten nå".

  4. .Sørg for at både «Read employees» og «Write employees» er aktivert før du klikker"Integrer"

  5. Hvis du ønsker at Huma skal overføre fravær, må «Calendar API» og være huket av med «Read employees» og «Write employees». 

  6. Klikk på navnet ditt øverst til høyre og kopier "Tenant ID" til utklippstavlen.




Screenshot 2025-11-11 at 10.52.27





2a. Koble Huma til Visma.net Payroll

For å sette opp integrasjoner i Huma, må brukeren ha "Systemrolle med full tilgang til Organisasjon". 

  1. Logg inn i Huma og gå til "Integrasjoner", velg Visma.
  2. Les all informasjon om Visma-integrasjonen før du går videre
    1. «Oversikt»
    2. «Detaljer»
  3. Klikk "Sett opp" øverst til høyre.
  4. Gi tilkoblingen et navn og velg hvem som bør være en del av denne tilkoblingen (alle/teams/lokasjoner/selskap). 
  5. Trykk "Fortsett" og lim inn den opprettede "Tenant ID" fra Visma, og huk av for at du har nødvendig autoritet. 
  6. Klikk "Fortsett" og huk av for ønskede innstillinger. Les mer om innstillingene her, i neste steg.
  7. Trykk "Sett opp", og tilkoblingen mellom systemene er nå etablert.

 

Screenshot 2026-01-27 at 12.57.57

Screenshot 2026-01-26 at 16.38.11

 




2b. Konfigurer integrasjonsinnstillinger

  • Aktiver "Oppdater lønnsdata i Visma.Net Payroll når de oppdateres i Huma" hvis du ønsker å overføre lønnsdata

    • All nyopprettet eller oppdatert lønnsdata i Huma vil automatisk bli overført til Visma.net Payroll. Hvis en lønns startdato ikke samsvarer med en eksisterende stilling i Visma.net Payroll, vil det bli opprettet en ny.

    • Lønnsdata vil kun bli sendt fra Huma til Visma.net Payroll.

    • Kun lønn opprettet eller oppdatert etter at integrasjonen er aktivert vil bli overført til Visma.net Payroll.


  • Aktiver "Opprett fravær i Visma.Net Payroll når det legges til i Huma" for å overføre fravær
    • Kun godkjent fravær registrert som arbeidsdager overføres.
    • Endringer eller sletting i Huma vil også oppdateres/slettes i Visma.
    • Fravær i Huma synkroniseres til Kalender i Visma. 

 

  • Klikk "Lagre" for å fullføre oppsettet.

 Screenshot 2026-01-27 at 13.01.09






2c. Koble fraværstyper

Hvis du har valgt å synkronisere fravær fra Huma til Visma.Net Payroll, må du koble fraværstyper:

  1. Gå gjennom alle fraværstyper
  2. Velg tilsvarende fraværstype (kode) i Visma
  3. Ekskluder typer du ikke ønsker å overføre

 

Les mer om hvordan fravær håndteres i integrasjoner generelt og her for Visma. 

 

Screenshot 2026-01-27 at 13.15.45

 

 


3. Synkroniser brukere og håndter konflikter

Etter at du klikker "Lagre", kommer du til forsiden for tilkoblingen. For å aktivere integrasjonen, må man "Synkronisere brukere".

  1. Trykk "Synkroniser brukere"

  2. Matchende brukere: brukere vi finner i både Huma og Visma (lik e-post i begge systemene)
    1. Trykk på "Se brukere" for å se hvilke støttende felter som ikke matcher, eller mangler. 
    2. Håndter "ikke-matchende" eller "manglende verdier". 
    3. Klikk "Neste"
  3. Ikke-matchende brukere: brukere som kun eksisterer i ett av systemene.
    1. Velg mellom å opprette "alle/valgte brukere/ikke opprett". 
    2. Velg hvordan brukere skal opprettes:
      1. Visma > Huma : legg til i Huma. 
      2. Huma > Visma : legg til i Visma. 
  4. Klikk "Synkroniser brukere". Du mottar en e-post med resultatet.
Merk
  • Brukere som ikke har utfylt "Påkrevde felter", vil ikke bli synkronisert. 
  • Kun brukere med en *Startdato i Visma som er i dag eller tidligere vil bli opprettet i Huma.
  • Brukere med en *Start dato i fremtiden vil vises når du utfører en manuell synkronisering i Huma, men vil ikke bli opprettet.

  • Brukere som synkroniseres fra Huma til Visma går inn i «Utkast-modus» i Visma, og påkrevde felter i Visma må oppdateres for at brukeren skal få status «aktiv». Klikk "Endre utkast" for å gjennomgå og fullføre alle påkrevde felter. Har du spørsmål om hvilke felter det gjelder, kontakt Visma Support. 



Screenshot 2026-01-27 at 13.22.48

Screenshot 2026-01-27 at 13.23.12


Utkast-modus i Visma

Screenshot 2025-11-11 at 10.41.05







4. Tilkoblingen mellom Huma og Visma.Net Payroll er aktiv

  • Endringer i støttede felter i Huma oppdateres automatisk i Vismai sanntid.

  • Endringer gjort i Visma  oppdateres ikke automatisk i Huma, og man må da gjøre manuell synkronisering, "Synkroniser brukere". 


Screenshot 2026-01-27 at 13.25.17

 

 

Hvordan synkronisere brukere

Bruk «Synkroniser brukere» når du har oppdatert ett av de støttede feltene i Fortnox, eller når du vil opprette nye brukere. For at synkronisering av brukere skal fungere, må e‑postadressen til enhver tid være lik i begge systemene.

  1. Gå til Visma-integrasjonen i Huma
  2. Klikk "Synkroniser brukere"
  3. Følg stegene. Les mer om stegene her.


Merk

Hvis du har opprettet en bruker i Huma må du gjøre en "Manuell synkronisering" for å opprette brukeren i Visma gjennom integrasjonen. 



Deaktiverte eller slettede brukere

Når en bruker deaktiveres i Huma …

  • blir brukeren ikke deaktivert i Visma.

  • blir brukeren låst for oppdateringer.

 

Når en bruker slettes i Huma …

  • blir brukeren ikke slettet i Visma.

  • ved manuell synkronisering blir du bedt om å opprette denne brukeren i Huma dersom den kun finnes i Visma og ikke i den andre integrasjonen.

  • kan brukeren ikke synkroniseres hvis det er gjort endringer på brukeren i Visma etter at den ble slettet i Huma.


 

Støttende felter - Ansattfelter som synkroniseres

Endringer som gjøres i støttede felter i Huma (listet opp nedenfor) blir automatisk oppdatert i Visma.net Payroll i sanntid. Endringer som gjøres i Visma må derimot synkroniseres manuelt i Huma.

 

Huma felt Visma felt
E-postadresse emails[].address

Huma krever at dette feltets verdi er unik.

Vil oppdatere jobb‑e‑post 

Hvis det finnes en «Bedriftens e-post» i Visma som samsvarer med e‑postadressen i Huma, vil brukeren bli inkludert i synkroniseringsprosessen.

Hvis det kun finnes en «Privat e-post» i Visma og brukeren allerede er synkronisert, vil oppdatering av brukerens e‑post i Huma opprette en «Jobb e-post»-oppføring i Visma.
Ansettelses-ID* (PÅKREVD) number

Oppdateres kun i Visma.net for ansatte som er i utkastmodus.

Huma krever at dette feltets verdi er unik.

Visma.net Payroll tillater maks 12 tegn i dette feltet, lengre ID-er vil bli avvist.

Kan ikke endres i Visma.net Payroll.
Fornavn personNames[].firstName

Synkronisering fra Huma til Visma
Setter en sluttdato på nåværende navn i Visma og legger til et nytt fra og med i dag.
Etternavn personNames[].lastName

Syncing Visma to Huma
Current name will be used.
Telefonnummer

phones[].number

Oppdaterer "Bedriftens telefon"

Telefonnummeret i Huma må samsvare med «Bedriftens telefon» i Visma for at synkronisering skal fungere.
Adresse

address.streetName

address.zipCode

address.cityName

address.countryCode

Andre linje i adressen i Huma vil ikke bli synkronisert til Visma.net Payroll.

 
Bankkontonummer

salaryPaymentMethod

Kun norske nasjonale bankkontonumre sendes til Visma. Andre land rapporteres som «Kontant». Bruk internasjonalt bankkontonummer for andre land.
Ansettelsesdato* (PÅKREVD)

positions[].activeStart

Synkronisering fra Huma til Visma
Vil sette activeStart for den valgte stillingen* lik Ansettelsesdato i Huma.

Synkronisering fra Visma til Huma
Vil sette Ansettelsesdato i Huma lik activeStart for den valgte stillingen*.
Sluttdato for ansettelsesforholdet

positions[].activeEnd

Synkronisering fra Huma til Visma
Setter activeEnd for den valgte stillingen* lik Sluttdato for ansettelsesforholdet i Huma.

Synkronisering fra Visma til Huma
Setter Sluttdato for ansettelsesforholdet i Huma lik activeEnd for den valgte stillingen*.
Identifikasjoner

personIds[].personId.id

personIds[].personId.typeOfId

personIds[].personId.country

SSN - social security number  

Integrasjonen kan ikke fjerne dette feltets verdi i Visma.net Payroll når verdien fjernes i Huma.

Kun norske personnummer og D-nummer støttes i Visma.net Payroll. Personens fødselsdato må samsvare med datoen som er angitt i nummerets seks første sifre.
Selected Postion*

Hvis den ansatte har en nåværende stilling, vil denne bli valgt.

Hvis den ansatte ikke har en nåværende stilling, vil den siste stillingen bli valgt.

Hvis den ansatte ikke har en nåværende eller tidligere stilling, vil en framtidig stilling bli valgt.

 
 
 

Hvorfor sender Huma bare sluttdato for ansettelsesforholdet når Visma.net Payroll også krever «Sluttårsak» ved registrering av siste arbeidsdag?

For "ordinære kontrakter" og "maritime ansettelsestyper" i Visma er det påkrevd å fylle ut sluttårsak for stillingen når activeEnd settes. I slike tilfeller vil sluttårsak for stillingen bli satt til «Den ansatte har sagt opp sin stilling».

Tilsvarende vil vi, når sluttdato for ansettelsesforholdet i Huma fjernes, også fjerne sluttårsak for stillingen i Visma.

 


 

FAQ: Visma og Huma fraværsintegrasjon

🏖️ Les mer om hvordan fravær til integrasjon fungerer generelt

⛓️‍💥 Vær oppmerksom på at aktivering av integrasjonen eller å slå på «fraværssync» ikke overfører tidligere registrerte fravær til Visma. Fraværsdata synkroniseres kun til integrasjonen når et fravær blir godkjent med en sluttdato i Huma. Fraværssynkroniseringen fungerer kun fra Huma til Visma.

 

Støttende felter - fraværsfelter som synkroniseres

Dette er fraværsfeltene som vil bli synkronisert fra Huma til Visma:

Huma felt Visma felt
Fraværstype* (PÅKREVD) eventcode
Tidsperiode* (PÅKREVD) startDate

endDate
Prosentandel* (PÅKREVD) inputType

properties.percent
Merknader comment

 

 

 

Hvordan kan jeg aktivere fraværssynkronisering mellom Huma og Visma.net Payroll?

Du kan når som helst aktivere synkronisering av fravær etter at integrasjonen er satt opp.

  1. Gå til integrasjonssiden for Visma i Huma
  2. Trykk på de tre prikkene i høyre topphjørne
  3. Klikk "Rediger tilkoblingsinnstillinger
  4. Huk av for "juridisk myndighet" og klikk "Fortsett"
  5. Skru på "Opprett fravær i Visma.Net payroll når de legges til i Huma" og "Tilknytt fraværstyper"
  6. Husk å trykke "Koble til på nytt" på forsiden for integrasjonen etter denne endringen er utført

 

Screenshot 2026-01-27 at 15.08.41
Screenshot 2026-01-27 at 15.08.53

 Screenshot 2026-01-27 at 15.17.04



Hvordan kobler jeg fraværstyper mellom Huma og Visma.net Payroll?

Start med å gå gjennom alle fraværstypene som er opprettet i Huma. For hver av disse velger du tilsvarende hendelseskode i Visma for å sikre korrekt synkronisering. Ekskluder fraværstyper i Huma som ikke er relevante eller nødvendige å overføre til Visma. Riktig kobling er viktig for at kun relevante data deles, og for å opprettholde integriteten og kvaliteten på fraværsregistreringene i begge systemer.

  1. Gå til integrasjonssiden for Visma i Huma
  2. Trykk på de tre prikkene i høyre topphjørne
  3. Klikk "Tilknytt fraværstyper"
  4. Trykk "Lagre"

 

Screenshot 2026-01-27 at 15.15.49

 



Hvordan henger fravær sammen mellom Huma og Visma.net Payroll?

Fravær kobles basert på hvilken ansatt det gjelder, start- og sluttdato, samt fraværstype. Sørg for at kalenderinnstillingene i Visma og Huma er justert likt for korrekt beregning av fridager og helligdager.

Sørg for at «Calendar API» er aktivert i Huma-appen, under Visma i App Store.

Merk


 

 

 

Hva utløser overføring av fravær fra Huma til Visma.net Payroll?

Når fravær er registrert med sluttdato og godkjent i Huma, overføres det automatisk til Visma.net Payroll og knyttes til tilsvarende fraværstyper/hendelseskoder.

 

Hva skjer med fravær i Visma.net Payroll når det gjøres endringer i Huma?

Alle oppdateringer eller slettinger som gjøres på et fravær i Huma vil føre til tilsvarende endringer eller slettinger i Visma.

Du kan enten godkjenne fraværet direkte i Visma eller sende det videre til lønnsavdelingen for behandling. Hvis du har spørsmål om disse innstillingene, ber vi deg ta kontakt med Visma for hjelp.

 

Hvordan beregnes fraværstid i Visma.net Payroll?

Fraværstid beregnes basert på arbeidsplaninnstillingene i Visma. Fravær med full stillingsprosent registreres som hele dager, mens fravær med lavere stillingsprosent justeres tilsvarende.

 

Hva skjer hvis en hendelseskode i Visma.net Payroll ikke støtter gradering?

Hvis en Visma‑hendelseskode er inkompatibel med gradering, vil Huma merke fraværet som avvist, varsle relevante parter og loggføre feilen.

Visma tillater ikke gradert «Ferie».

 

Hvordan håndteres sykefravær mellom Huma og Visma.net Payroll?

Når «sykefravær» opprettes i Huma, vil alternativet for legeerklæring i Visma aktiveres, og startdatoen på sykmeldingen vil samsvare med startdatoen for fraværet i Huma.

«Egenmelding» registrert i Huma vil derimot ikke aktivere legeerklæringsfeltet i Visma. Dersom det er satt en grense for antall forekomster på den tilknyttede hendelseskoden, og fraværet registrert i Huma overskrider denne grensen, vil fraværet bli avvist, loggføre en feil og varsle relevante parter.

 

Hva skjer hvis et fravær slettes i Huma?

Hvis et fravær slettes i Huma, vil det også bli fjernet i Visma for å holde begge systemene synkronisert.

 

Kan fraværstyper endres i Visma.net Payroll?

Ja, du kan endre fraværstyper i Visma for å tilpasses ulike behov i organisasjonen din. Sørg for at disse endringene også gjenspeiles i innstillingene for fraværstyper i Huma for å sikre korrekt dataoverføring.

 

Blir fravær uten sluttdato overført til Visma.net Payroll?

Nei – et fravær må ha en sluttdato for å bli overført til Visma.

 

Hvorfor blir enkelte fravær avvist når de registreres i Huma?

Fravær kan bli avvist av ulike årsaker. Vanlige årsaker er at brukeren ikke har en aktiv ansettelse på tidspunktet for fraværet, er markert som inaktiv, eller har en fremtidig startdato på ansettelsen. Det kan også være begrensninger i hendelseskode-innstillingene i Visma.

  • I tillegg kan konflikter med eksisterende fravær som allerede er registrert i Visma føre til avvisning.

  • Ansatte må også ha fått tildelt korrekt informasjon under på sitt ansattkort i Visma  (f.eks. lønn og arbeidstid).

  • Husk å tildele riktige fraværstyper og saldoer i Kalender i Visma. 

  • Ansatte må også ha en deltidsfaktor på over 0 % i feltet «Stilingsprosent» på profilkortet sitt i Visma.

For en detaljert forklaring av konkrete feil, sjekk integrasjonsfeilloggen på integrasjonssiden i Huma. Der finner du beskrivelser av hva som har gått galt. Har du andre spørsmål til profilkortet og felter i Visma, kontakt Visma. 

 

Hvorfor kan jeg ikke registrere fravær som «Sykt barn»?

For å registrere fraværet «Sykt barn» i Huma og synkronisere det til Visma, må du fylle ut "Barn" i Visma. Dette er fordi at Huma støtter ikke synkronisering av «Barn» til Visma, så dette feltet må fylles ut manuelt i Visma.

 

Jeg har lagt inn notater i detaljene for fraværet. Blir dette også overført til Visma?

Ja, hvis du legger inn et «notat» i detaljene for fraværet, vil notatet vises når du godkjenner fraværet i Visma.

 

Blir fravær fra Huma automatisk godkjent i Visma?

Det avhenger av innstillingene dine i Visma for hver fraværstype (kode). Kontakt Visma hvis du er usikker på oppsettet.  

 

 





FAQ: Visma.net Payroll og Huma lønnsintegrasjon

💰 Vær oppmerksom på at aktivering av integrasjonen eller å slå på «lønnsync» ikke overfører tidligere eller pågående lønnsdata til Visma. Lønnsdata synkroniseres kun til integrasjonen når en lønn opprettes eller redigeres i Huma. Lønnssynkroniseringen fungerer kun fra Huma til Tripletex.

Integrasjonen støtter kun lønn i NOK (norske kroner). Lønnsdata i andre valutaer vil ikke bli overført til Visma, og det vil bli loggført en feil.

 

 

 

Støttende felter - lønnsfelter som synkroniseres

Dette er lønnsfeltene som vil bli sendt fra Huma til Visma.net Payroll:

Huma felt Visma.Net Payroll felt
Fra-dato salaryInformation.activeStart


Hvis ingen verdi er satt, settes dato til infinity i Visma.net.
Til-dato salaryInformation.activeEnd

Hvis ingen verdi er satt, settes dato til infinity i Visma.net.
Lønnsbeløp* (PÅKREVD) salaryInformation.hourlySalary

salaryInformation.monthlySalary

salaryInformation.yearlySalary
Intervall

salaryInformation.contractSalaryType

Hourly → Hourly

Monthly → Monthly

Yearly → Yearly
Intervall salaryInformation.salaryType

Hourly → Variable salary

Monthly, Yearly → Fixed salary

Ukelønn i Huma vil ikke bli sendt til Visma.net Payroll

 

 

 

Hvorfor bør jeg synkronisere lønnsdata lagret i Huma til Visma.net Payroll?

Synkronisering av lønnsdata sikrer at informasjonen i Visma er konsistent med registrene i Huma, og bidrar til å strømlinjeforme HR‑ og lønnsprosessene. Visma krever sammenhengende lønnshistorikk for hvert ansettelsesforhold, og denne integrasjonen hjelper deg med å håndtere oppdateringer automatisk, redusere manuelle feil og sikre korrekt lønnsinformasjon i begge systemer.

 

Hvordan sender jeg lønnsdata automatisk fra Huma til Visma.net Payroll?

For å aktivere automatisk overføring av lønnsdata må du sørge for at integrasjonen er aktivert manuelt i innstillingene dine dersom den ikke ble slått på under første oppsett. Når dette er aktivert, vil lønnsendringer som gjøres i Huma automatisk gjenspeiles i Visma.

Hvis integrasjonen allerede er satt opp, kan du aktivere dette i integrasjonsinnstillingene som du finner under ··· oppe i høyre hjørne og "Rediger tilkoblingsinnstillinger". 

 

 Screenshot 2026-01-27 at 15.51.04

Screenshot 2026-01-27 at 15.51.12

 

 

 

Hva er betingelsene for en vellykket overføring av lønn fra Huma til Visma.net Payroll?

For å kunne overføre en lønnsendring fra Huma til Visma må følgende betingelser være oppfylt:

  • Integrasjonen mot Visma.net Payroll må ha «Oppdater lønn» aktivert.

  • Brukeren må være koblet til Visma.net Payroll‑integrasjonen.

  • En ansettelse må være matchet.

  • Lønnens valuta må være NOK.

 

 

Hvordan håndterer integrasjonen lønnsoppdateringer?

Opprettelse/oppdatering av lønn: Hvis en eksisterende lønn i Visma matcher lønnen som opprettes i Huma, blir den oppdatert. Hvis det ikke finnes noen matchende lønn, opprettes en ny lønn i Visma.

Overlappende lønn: Hvis lønner i Visma overlapper med lønnen fra Huma, vil integrasjonen enten fjerne tomme lønnsrader (dvs. rader med nullverdier) eller justere eksisterende lønn i Visma basert på start- eller sluttdato.

 

Hvordan håndteres overlappende lønn mellom Huma og Visma.net Payroll?

  • Tomme lønnsrader i Visma.net Payroll: Hvis Visma har en tom lønnsrad (alle verdier er satt til null), vil den bli fjernet når en ny lønn fra Huma overlapper perioden.

  • Lønn uten sluttdato i Visma.net Payroll: Hvis en lønn i Visma ikke har sluttdato og en ny lønn starter etter denne, vil lønnen i Visma avsluttes, og den nye lønnen fra Huma legges til.

  • Lønn i Visma.net Payroll uten startdato: Hvis en lønn i Visma mangler startdato og en lønn fra Huma slutter før denne, vil lønnen i Visma få satt en startdato, og den nye lønnen fra Huma legges inn før den.

Hvis ingen av disse betingelsene er oppfylt, logges det en integrasjonsfeil, og ingen endringer blir gjort i Visma.

 

 

Hva skjer hvis det ikke finnes en matchende ansettelse i Visma.net Payroll?

For at Huma skal kunne opprette eller oppdatere lønn i Visma, må det finnes en matchende ansettelse. Integrasjonen vil lete etter en ansettelsesperiode som dekker lønnsperioden. Hvis ingen ansettelse blir funnet, loggføres en feil.

 

 

Hvordan håndterer integrasjonen masseoppdateringer av lønn (lønnsrevisjoner)?

Under en lønnsrevisjon i Huma vil integrasjonen behandle alle lønnsendringer for berørte brukere. Hvis en endring forsøker å påvirke mer enn én Visma‑ansettelse for samme bruker, loggføres en feil, og ingen oppdateringer blir gjort i Visma.

 

Hvordan håndterer integrasjonen ulike valutaer?

Integrasjonen støtter kun lønn i NOK (norske kroner). Lønnsdata i andre valutaer blir ikke overført til Visma, og det loggføres en feil.

 

 

Hva skjer når en lønn slettes i Huma?

Hvis en lønn slettes i Huma, blir den tilsvarende lønnen i Visma også slettet.

 

Tilleggsinformasjon

  • For brukere som ikke er i utkastmodus i Visma, kan ikke lønnshistorikk slettes, men lønnsrader kan tømmes.

  • Visma slår sammen sammenhengende lønnsrader med samme beløp, noe som kan føre til desynkronisering hvis flere identiske lønnsrader opprettes i Huma.