Xledger-integrasjon
Koble Huma til Xledger for å holde ansattprofiler, ansettelsesdetaljer, fravær og lønn synkronisert
Innholdsfortegnelse
- Introduksjon
- Roller og tilgang
- Sett opp integrasjonen
- Synkroniser ansatte
- Ansattdata
- Stillingsdata
- Fraværsdata
- Lønnsdata
- Endre integrasjonsinnstillinger
- Feillogg
- Ofte stilte spørsmål
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
- Logg inn i Xledger som «Administrator».
- Gå til «Administration» › «System Access» › «GraphQL» › «API tokens».
- Lag en ny tilgangstoken og gi den tilgangene i tabellen under.
- Klikk «Generate token».
- Kopier tokenen og ta vare på den.

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
- I Huma, gå til «Integrasjoner» og velg «Xledger».
- Les fanene «Oversikt» og «Detaljer».
- Klikk «Sett opp» øverst til høyre.
- Gi tilkoblingen et navn.
- Velg hvem som skal være med i tilkoblingen: alle, eller et bestemt team, lokasjon eller selskap.
- Klikk «Fortsett».
- Lim inn API-tokenet fra Xledger.
- Bekreft at du har myndighet til å godta vilkårene på vegne av organisasjonen.
- 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.
- Gå gjennom hver fraværstype i Huma.
- Velg tilsvarende fraværskode i Xledger.
- La være å koble typer du ikke vil sende.
- 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
- Gå til Xledger-integrasjonen i Huma og klikk «Synkroniser brukere».
- 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».
- 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.
- 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».

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
- Gå til Xledger-integrasjonen i Huma.
- Klikk ··· øverst til høyre.
- 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.
- Lag en ny API-token i Xledger med alle tilgangene fra steg 1, også tilgangene for fravær og/eller lønn.
- I Huma, gå til Xledger-integrasjonen, klikk ··· og velg «Rediger tilkoblingsinnstillinger».
- Lim inn den nye tokenen.
- 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
- Gå til Xledger-integrasjonen i Huma.
- Å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.