Gå til innhold
Norwegian Bokmål
  • Det finnes ingen forslag fordi søkefeltet er tomt.

Xledger-integrasjon

Koble Huma til Xledger for å holde ansattprofiler, ansettelsesdetaljer, fravær og lønn synkronisert

 

Innholdsfortegnelse

 


 

Introduksjon

Xledger-integrasjonen holder ansattinformasjonen i Huma og Xledger synkronisert. Du håndterer ansatte, stillinger, fravær og lønn i Huma, og Huma sender endringene til Xledger.

Dette støtter integrasjonen, og slik går dataene:

Data Huma → Xledger Xledger → Huma Når
Ansattdata ✅ Automatisk ✅ Bare manuelt Endringer i Huma sendes i sanntid. Endringer i Xledger hentes inn når du klikker «Synkroniser brukere».
Nye ansatte ✅ Automatisk, hvis slått på ✅ Bare manuelt Når en ansatt legges til i Huma, eller når du klikker «Synkroniser brukere»
Stillinger (ansettelsesdetaljer) ✅ Automatisk, hvis slått på ❌ Når en stilling opprettes, endres eller slettes i Huma
Fravær ✅ Automatisk, hvis slått på ❌ Når fravær er godkjent i Huma og har en sluttdato
Lønn ✅ Automatisk, hvis slått på (årslønn og timelønn) ❌ Når lønn opprettes, endres eller slettes i Huma

 

⚠️ Historiske data overføres ikke. Bare stillinger, fravær og lønn som opprettes eller endres etter at du har slått på hver innstilling, sendes til Xledger.

💡 Trenger du flere tilkoblinger, for eksempel én per selskap? Se Flere tilkoblinger.

 

 

Roller og tilgang

Tilgang Rolle
Sette opp og administrere integrasjonen i Huma Systemrolle med full tilgang til Organisasjon
Lage en API-token i Xledger «Administrator» i Xledger
Tilganger for API-tokenet Se tabellen i steg 1. Fravær og lønn trenger ekstra tilganger.

 

💡 Usikker på hvilke roller du trenger i Xledger? Kontakt Xledger support.

💡 Når Huma sender data til Xledger, vises navnet på brukeren som lagde API-tokenet, i endringshistorikken i Xledger.

 

 

Sett opp integrasjonen

Før du starter

  • Du har en systemrolle med full tilgang til Organisasjon i Huma.
  • Du, eller en kollega, kan logge inn i Xledger som «Administrator» og lage en API-token.
  • Ansatte som finnes i begge systemene har samme e-postadresse i Huma og Xledger. Huma matcher ansatte kun på e-post.
  • Hvis du vil synkronisere fravær, må fravær være satt opp i Huma først (fraværstyper eller arbeidstidsordninger).
  • Hvis du vil synkronisere lønn, bør du bestemme hvilken stilling som er hovedstilling i Xledger for ansatte med flere stillinger.

 

 

Steg 1: Lag en API-token i Xledger

  1. Logg inn i Xledger som «Administrator».
  2. Gå til «Administration» › «System Access» › «GraphQL» › «API tokens».
  3. Lag en ny tilgangstoken og gi den tilgangene i tabellen under.
  4. Klikk «Generate token».
  5. Kopier tokenen og ta vare på den.

1-Sep-29-2026-12-51-36-2967-PM

Tilganger for API-tokenet

Område (scope) Tilgang Trengs for
Human Resources: Employee Read/write Alle tilkoblinger
Common: Address, Company, Country, Object Value, System Value Read Alle tilkoblinger
Common: Contact, Subledger, Supplier Read/write Alle tilkoblinger
General ledger: Bank Read Alle tilkoblinger
Human Resources: Absence Read/write Synkronisering av fravær
Common: Object Kind Read Synkronisering av fravær
Payroll: PayrollRate Read/write Synkronisering av lønn
Employee: EmployeePosition Read Synkronisering av lønn

 

💡 Legg bare til tilgangene for fravær og lønn hvis du skal bruke disse funksjonene. Tilganger kan endres på en eksisterende token, men det gir ofte feil i tilkoblingen mot Huma. Trenger du flere tilganger senere, anbefaler vi å lage en ny token. Se Slå på fravær eller lønn senere.

 

Steg 2: Koble Huma til Xledger

  1. I Huma, gå til «Integrasjoner» og velg «Xledger».
  2. Les fanene «Oversikt» og «Detaljer».
  3. Klikk «Sett opp» øverst til høyre.
  4. Gi tilkoblingen et navn.
  5. Velg hvem som skal være med i tilkoblingen: alle, eller et bestemt team, lokasjon eller selskap.
  6. Klikk «Fortsett».
  7. Lim inn API-tokenet fra Xledger.
  8. Bekreft at du har myndighet til å godta vilkårene på vegne av organisasjonen.
  9. Klikk «Fortsett».

 

Steg 3: Velg hva som skal synkroniseres

Du kan endre innstillingene senere. Se Endre integrasjonsinnstillinger.

Innstilling Når den er på Når den er av
Brukere: Opprett i Xledger når de legges til i Huma Nye ansatte i Huma opprettes automatisk i Xledger. Nye ansatte opprettes bare i Xledger når du klikker «Synkroniser brukere».
Stillinger: Opprett, oppdater og slett Endringer i stillinger i Huma sendes til Xledger. Stillinger sendes ikke.
Lønn: Opprett, oppdater og slett i Xledger når den oppdateres i Huma Årslønn og timelønn i Huma sendes til Xledger. Krever tilgangene for lønn. Lønn sendes ikke.
Fravær: Opprett, oppdater og slett i Xledger når de oppdateres i Huma Godkjent fravær sendes til Xledger. Krever tilgangene for fravær. Fravær sendes ikke.

 

💡 Skal du legge inn historiske stillinger? Slå av stillingssynkronisering mens du gjør det. Historiske stillinger er ikke ment for lønnssystemet og kan gi feil. Slå den på før du oppretter stillinger som starter i dag eller fram i tid.

 

Steg 4: Koble fraværstyper

Gjør dette steget hvis du har slått på fravær.

  1. Gå gjennom hver fraværstype i Huma.
  2. Velg tilsvarende fraværskode i Xledger.
  3. La være å koble typer du ikke vil sende.
  4. Klikk «Lagre».

⚠️ Noen fraværskoder i Xledger tillater bare hele dager, typisk egenmelding. De avviser gradert fravær, for eksempel gradert sykmelding eller gradert foreldrepermisjon. Koble bare graderte fraværstyper til koder som tar imot prosent. Sjekk med Xledger-administratoren hvilke koder som støtter dette.

 

Steg 5: Synkroniser brukere for å aktivere integrasjonen

Etter oppsettet står det «Denne integrasjonen er satt opp, men ikke aktiv» på integrasjonssiden. Ingenting sendes før du har synkronisert brukere. Se Synkroniser ansatte.

 

 

Synkroniser ansatte

«Synkroniser brukere» sammenligner de ansatte i Huma og Xledger. Du bestemmer hva som skal oppdateres og hvilke ansatte som skal opprettes. Første synkronisering aktiverer også integrasjonen.

Slik synkroniserer du brukere

  1. Gå til Xledger-integrasjonen i Huma og klikk «Synkroniser brukere».
  2. Matchende brukere er ansatte med samme e-post i begge systemene.
    • Klikk «Se brukere» for å se felt med ulike eller manglende verdier.
    • For hvert tilfelle velger du om Huma skal oppdateres med verdien fra Xledger, om Xledger skal oppdateres med verdien fra Huma, eller om du vil la det være.
    • Klikk «Neste».
  3. Ikke-matchende brukere er ansatte som bare finnes i ett av systemene.
    • Velg om du vil opprette alle, bare de du velger, eller ingen.
    • Velg retning: Xledger → Huma, eller Huma → Xledger.
  4. Klikk «Synkroniser brukere».

Statusen endres til «Tilkoblet og aktiv». Du får en e-post med resultatet.

💡 Før du synkroniserer, bør du bestemme hvilket system som har de mest oppdaterte opplysningene. Valgene du gjør her overskriver data.

⚠️ Brukere som mangler påkrevde felt, som land på en identifikasjon, synkroniseres ikke før verdiene er fylt ut.

 

Når du må synkronisere brukere

Endringer i Huma sendes automatisk til Xledger. Klikk «Synkroniser brukere» når:

  • Du nettopp har satt opp integrasjonen og vil aktivere den.
  • Du har endret et støttet felt i Xledger og vil ha det inn i Huma.
  • Du har lagt til ansatte i Xledger som skal opprettes i Huma.
  • Du har lagt til ansatte i Huma, og «Brukere: Opprett i Xledger når de legges til i Huma» er av.

 

Når en ansatt slutter

Deaktivert i Huma:

  • Den ansatte deaktiveres ikke i Xledger.
  • Den ansatte låses for oppdateringer fra integrasjonen.

Slettet i Huma:

  • Den ansatte slettes ikke i Xledger.
  • Neste gang du klikker «Synkroniser brukere», foreslås det å opprette den ansatte i Huma igjen.
  • Den ansatte kan ikke synkroniseres hvis hen er endret i Xledger etter at hen ble slettet i Huma.

💡 For å registrere at arbeidsforholdet avsluttes i Xledger, setter du sluttdato på den siste stillingen til den ansatte i Huma. Se Stillingsdata.

 

 

Ansattdata

Endringer i Huma sendes automatisk. Endringer i Xledger hentes inn med «Synkroniser brukere».

Felt i Huma Felt i Xledger Påkrevd Merknader
E-postadresse E-post (kontakt og reskontro) ✅ Brukes til å matche ansatte. Må være unik i Huma.
API-navn: employee.contact.email, employee.subledger.email
Ansatt-ID Kode   Må være unik i Huma.
API-navn: employee.code
Fornavn Fornavn (kontakt), Beskrivelse (reskontro)   Beskrivelsen på reskontroen er hele navnet.
API-navn: employee.contact.firstName, employee.subledger.description
Etternavn Etternavn (kontakt), Beskrivelse (reskontro)   API-navn: employee.contact.lastName, employee.subledger.description
Telefonnummer Telefon (kontakt og reskontro)   Må være unikt i Huma.
API-navn: employee.contact.phone, employee.subledger.phone
Fødselsdato Fødselsdato   API-navn: employee.contact.birthday
Identifikasjon Personnummer   Bare norske fødselsnumre.
API-navn: employee.contact.socialSec
Bankkonto Bankkonto (reskontro)   Integrasjonen oppdaterer kontonummeret. Den kan ikke oppdatere landet til selskapet på reskontroen.
API-navn: employee.subledger.bankAccount, employee.subledger.company.country
Adresse Adresse (kontakt og reskontro)   Integrasjonen kan ikke fjerne kontaktadressen i Xledger når den fjernes i Huma.
API-navn: contact.address.*, subledger.address.* (streetAddress, zipCode, place, country.code)
Kjønn Kjønn   API-navn: employee.contact.gender

 

 

Stillingsdata

Stillinger går én vei: fra Huma til Xledger. De sendes som ansettelsesdetaljer på den ansatte når «Stillinger: Opprett, oppdater og slett» er slått på.

Felt i Huma Felt i Xledger Påkrevd Merknader
Stillingstittel Job Title (XRM › Contact)   API-navn: employee.contact.jobTitle
Kontraktens startdato Ansatt fra   Bruker startdatoen på den første stillingen til den ansatte i Huma.
API-navn: employee.employmentFrom
Sluttdato for prøvetid Prøvetid til   Bruker verdien fra den ansattes nåværende, kommende eller siste hovedstilling.
API-navn: employee.trialTo
Dato for oppsigelse Oppsigelsesdato   API-navn: employee.noticeDate
Kontraktens sluttdato Ansatt til   Bruker sluttdatoen på den siste stillingen til den ansatte i Huma.
API-navn: employee.employmentTo

 

💡 Xledger har to steder for stillingstittel. Huma oppdaterer feltet «Job Title» på kontakten. Du finner det under XRM › Contact › velg den ansatte.

 

 

Fraværsdata

Fravær går én vei: fra Huma til Xledger. Godkjent fravær med sluttdato sendes på fraværskoden du koblet i steg 4, hvis «Fravær: Opprett, oppdater og slett i Xledger når de oppdateres i Huma» er slått på.

Felt i Huma Felt i Xledger Påkrevd Merknader
Fraværstype Fraværskode ✅ Settes opp i steg 4.
API-navn: absence.absenceCode
Tidsperiode Fra dato / Til dato ✅ API-navn: absence.fromDate, absence.toDate
Prosent Permisjonsprosent ✅ Noen fraværskoder tillater bare hele dager.
API-navn: absence.leavePercent
Notat Tekst   API-navn: absence.text

 

⚠️ Fravær fra Huma kommer inn i Xledger som ikke godkjent og må godkjennes der.

💡 Overlappende fravær støttes.

 

Når Xledger avviser fravær

Hvis Xledger avviser et fravær, for eksempel fordi fraværskoden bare tillater hele dager, logges feilen. Registrer fraværet manuelt i Xledger, eller koble fraværstypen til en kode som tar imot prosent.

 

 

Lønnsdata

Lønn går én vei: fra Huma til Xledger. Den sendes når lønn opprettes, endres eller slettes i Huma, hvis «Lønn: Opprett, oppdater og slett i Xledger når den oppdateres i Huma» er slått på.

Felt i Huma Felt i Xledger Påkrevd Merknader
Fra dato Dato fra ✅ En lønn uten startdato sendes ikke.
API-navn: payrollRate.dateFrom
Til dato Dato til   API-navn: payrollRate.dateTo
Intervall Lønnsart: Årslønn / Timelønn   År → Årslønn. Time → Timelønn. Måned og uke sendes ikke.
API-navn: payrollRate.rateElement
Beløp Sats ✅ Sendes som det er, uten omregning.
API-navn: payrollRate.rate

 

💡 Xledger har ingen lønnsart for måned eller uke. Huma regner ikke om, så månedslønn og ukelønn må registreres manuelt i Xledger.

💡 For å se lønnen i Xledger, gå til «Payroll/Expenses» › «Employees» › «Employees register», klikk på mappeikonet ved den ansatte og velg «Individuell sats».

Individuell sats i Xledger

 

Hvilken stilling lønnen knyttes til

  • Ingen stilling dekker lønnsperioden: lønnen registreres på den ansatte uten stilling.
  • Én stilling dekker perioden: lønnen knyttes til den stillingen.
  • Flere stillinger dekker perioden: Huma bruker stillingen som er merket som hovedstilling i Xledger. Hvis ingen eller flere er merket som hovedstilling, sendes ikke lønnen.

 

 

Endre integrasjonsinnstillinger

  1. Gå til Xledger-integrasjonen i Huma.
  2. Klikk ··· øverst til høyre.
  3. Velg et alternativ:
    • «Rediger tilkoblingsinnstillinger» for å endre synkroniseringsinnstillinger eller lime inn en ny API-token.
    • «Rediger tilkoblingsdetaljer» for å endre navnet eller hvem som er med i tilkoblingen.
    • «Tilknytt fraværstyper» for å endre koblingen av fraværstyper.

Innstillingene er forklart i Steg 3: Velg hva som skal synkroniseres.

 

Slå på fravær eller lønn senere

Hvis du allerede har en aktiv tilkobling, har API-tokenet sannsynligvis ikke tilgangene for fravær eller lønn. Tilganger kan endres på en eksisterende token i Xledger, men det gir ofte feil i tilkoblingen mot Huma. Vi anbefaler derfor å lage en ny token.

  1. Lag en ny API-token i Xledger med alle tilgangene fra steg 1, også tilgangene for fravær og/eller lønn.
  2. I Huma, gå til Xledger-integrasjonen, klikk ··· og velg «Rediger tilkoblingsinnstillinger».
  3. Lim inn den nye tokenen.
  4. Slå på fravær og/eller lønn, og koble fraværstyper ved behov.

💡 Hvis du ser feilmeldingen «This token does not have permission to read and write for type Absence», mangler tokenen tilgangene for fravær.

 

Koble fra eller fjerne

  • Koble fra: Stopper synkroniseringen, men beholder oppsettet.
  • Fjern: Stopper synkroniseringen og sletter alt lagret oppsett.

 

 

Feillogg

Her finner du feilloggen

  1. Gå til Xledger-integrasjonen i Huma.
  2. Åpne fanen «Feillogg».

Feilene er gruppert per dag. Hver oppføring viser en melding, tidspunktet, hvilken ansatt den gjelder og et nivå:

Nivå Betydning
🔴 Feil Noe ble ikke sendt til Xledger. Du må gjøre noe.
🟡 Advarsel Noe trenger oppmerksomheten din.
🔵 Info Til informasjon. Du trenger ikke gjøre noe.

 

Status for integrasjonen

Status på integrasjonssiden Hva du gjør
Denne integrasjonen er satt opp, men ikke aktiv Klikk «Synkroniser brukere» for å aktivere den.
Tilkoblet og aktiv Alt fungerer.
Autorisasjonsfeil: «Noe er galt med din tilkobling til Xledger. Koble til og synkroniser på nytt.» API-tokenet er utløpt eller kan ikke brukes. Lag en ny API-token i Xledger, lim den inn i «Rediger tilkoblingsinnstillinger», og klikk «Synkroniser brukere».

 

Vanlige feil

Feilmeldingene vises på engelsk i feilloggen.

Feilmelding (eller deler av den) Hva den betyr Slik løser du det
Salary not synced to Xledger: Xledger has no monthly/weekly salary rate element… Bare årslønn og timelønn sendes. Registrer lønnen manuelt i Xledger.
Salary not synced to Xledger: the salary has no start date… En lønn må ha startdato for å bli sendt. Legg inn startdato i Huma, eller registrer lønnen manuelt i Xledger.
…several positions covering the salary period and none is marked as the main position Huma kan ikke avgjøre hvilken stilling lønnen skal knyttes til. Merk én stilling som hovedstilling i Xledger, og lagre lønnen i Huma på nytt.
…several positions covering the salary period marked as the main position Mer enn én stilling er merket som hovedstilling. La bare én stilling være hovedstilling i Xledger, og lagre lønnen i Huma på nytt.
Ingen entydig lønnsregistrering i Xledger Huma matcher lønn på ansatt, lønnsart, stilling, startdato og beløp. To like registreringer, eller en registrering som er endret i Xledger, stopper synkroniseringen. Rett lønnen manuelt i Xledger.
This token does not have permission to read and write for type Absence API-tokenet mangler tilgangene for fravær. Lag en ny token med alle tilgangene. Se Slå på fravær eller lønn senere.
Email mismatch when trying to update E-postadressen i Xledger stemmer ikke lenger med den ansatte i Huma. Sørg for at e-postadressen er lik i begge systemene, og klikk «Synkroniser brukere».
Error parsing query: Unterminated string Et profilfelt inneholder et spesialtegn som ikke kan leses. Skriv inn verdien på nytt i Huma, og synkroniser igjen.

 

 

Ofte stilte spørsmål

Hvorfor vises ikke endringer jeg gjør i Xledger i Huma?
Endringer går bare automatisk fra Huma til Xledger. For å hente endringer fra Xledger inn i Huma klikker du «Synkroniser brukere».

 

Hvor oppdateres stillingstittelen i Xledger?
Xledger har to steder for stillingstittel. Huma oppdaterer feltet «Job Title» på kontakten. Du finner det under XRM › Contact › velg den ansatte.

 

Hvilke lønnstyper sendes?
Årslønn og timelønn. Månedslønn og ukelønn sendes ikke og må registreres manuelt i Xledger.

 

Hvor finner jeg lønnen i Xledger?
Gå til «Payroll/Expenses» › «Employees» › «Employees register», klikk på mappeikonet ved den ansatte og velg «Individuell sats». Lønnen vises med rateelement, fra-dato, til-dato og sats.

 

Blir fravær fra Huma godkjent automatisk i Xledger?
Nei. Fraværet kommer inn som ikke godkjent og må godkjennes i Xledger.

 

Jeg har allerede en tilkobling. Hvordan slår jeg på fravær eller lønn?
Vi anbefaler å lage en ny API-token med alle tilgangene. Se Slå på fravær eller lønn senere.

 

Kan jeg overføre historisk fravær, lønn eller stillinger?
Nei. Bare data som opprettes eller endres etter at innstillingen er slått på, sendes.

 

Kan jeg ha flere Xledger-tilkoblinger?
Ja. Du kan for eksempel sette opp én tilkobling per selskap. Se Flere tilkoblinger.