Veiledning til Visma Enterprise Data Import

Dette dokumentet inneholder en detaljert beskrivelse av feltene i XML-stamdatafilen som eADM importerer fra Visma Enterprise HRM (VEP). Det er beregnet på teknisk personell som har ansvar for å konfigurere og vedlikeholde integrasjonen.

Filen leveres som en <personsXML> dokument som inneholder én <person> element per ansatt. Hver personoppføring inneholder identitetsopplysninger, kontaktinformasjon og ett eller flere <employment> opplysninger som beskriver den ansattes stillinger, organisatorisk tilhørighet og lønn.

Advarsel: Kildefilen kan inneholde sensitiv informasjon, blant annet lønnsopplysninger, skattedata, bankkontonumre og opplysninger om forsørgede. Les veiledningen «Filtrering og transformering av importdata» før du importerer en ufiltrert fil, og fjern eventuelle elementer som ikke er nødvendige for integrasjonen.

Data om ansatte

Eksempel på medarbeiderdata

Nedenfor følger et anonymisert eksempel på en <person> opplysninger om en enkelt ansatt. Alle identifiserende opplysninger (navn, personnummer, kontaktopplysninger, organisasjonsnummer) er erstattet med plassholderdata.

XML

<person personIdHRM="10023">
    <authentication>
        <initials>KARNOR</initials>
        <userId>1042</userId>
        <username>KARI NORDMANN</username>
        <alias>KARNOR</alias>
    </authentication>
    <careerInfo>
        <jobTitle>Sykepleier</jobTitle>
        <workTasks>Sykepleier</workTasks>
    </careerInfo>
    <contactInfo>
        <email>kari.nordmann@utfjord.kommune.no</email>
        <workPhone>00000000</workPhone>
        <privateMobilePhone>00000000</privateMobilePhone>
        <paycheckByEmail>false</paycheckByEmail>
    </contactInfo>
    <dateOfBirth>1985-01-01</dateOfBirth>
    <dependents/>
    <employments>
        <employment>
            <bankDetails>
                <accountNumber>00000000000</accountNumber>
                <alias>Hovedkonto</alias>
                <nationalityCode>NO</nationalityCode>
            </bankDetails>
            <category id="F3"><description>Fast tilsett utvida</description></category>
            <company>
                <companyId>1</companyId>
                <companyName>Utfjord kommune</companyName>
                <organizationNumber>000000000</organizationNumber>
            </company>
            <companySeniority>2018-01-01</companySeniority>
            <employeeId>10023001</employeeId>
            <employmentPercentage>100.0</employmentPercentage>
            <lastChangedDate>2026-07-01T08:00:00</lastChangedDate>
            <pension name="KLP fellesordning" value="18"/>
            <positions>
                <position isPrimaryPosition="true" validFromDate="2026-01-01">
                    <chart id="5" name="Utfjord kommune">
                        <unit id="1001" name="Helse og omsorg">
                            <manager id="6001" name="Ola Leder"/>
                        </unit>
                    </chart>
                    <costCentres>
                        <dimension2 name="Helse og omsorg" value="2000"/>
                    </costCentres>
                    <employmentPositionPercentage>100.0</employmentPositionPercentage>
                    <positionCategoryNumber>1</positionCategoryNumber>
                    <positionInfo>
                        <positionCode name="Sykepleier" positionCode="7174" positionId="1" tableNr="50"/>
                        <positionType name="Fast" value="F"/>
                        <publicPositionCode name="Sykepleier" value="7174"><set>KS</set><setType>KSSKODE</setType></publicPositionCode>
                    </positionInfo>
                    <positionPercentage>100.0</positionPercentage>
                    <positionStartDate>2018-01-01</positionStartDate>
                    <positionStatistics includeInAA="true" includeInPAI="true">
                        <workClassification name="Sykepleier" value="2223114"/>
                        <workMunicipality name="UTFJORD KOMMUNE" value="0000"/>
                    </positionStatistics>
                    <salaryInfo>
                        <basicSalary>000000.00</basicSalary>
                        <salaryStep>0</salaryStep>
                        <salaryTable name="Kommuneansatte kap. 4" value="4025"/>
                        <yearlySalary>000000.00</yearlySalary>
                    </salaryInfo>
                    <weeklyHours>37.50</weeklyHours>
                </position>
            </positions>
            <taxDetails>
                <taxDeductionCard cardId="0000" cardName="Månedstabell" cardType="M"/>
                <taxPercentage>00.00</taxPercentage>
            </taxDetails>
        </employment>
    </employments>
    <familyName>Nordmann</familyName>
    <genderCode>FEMALE</genderCode>
    <givenName>Kari</givenName>
    <municipality name="UTFJORD KOMMUNE" value="0000"/>
    <nationalityCode>NO</nationalityCode>
    <postalAddress>
        <address1>Eksempelveien 1</address1>
        <countryCode>NO</countryCode>
        <postalArea>UTFJORD</postalArea>
        <postalCode>0000</postalCode>
    </postalAddress>
    <socialSecurityOffice name="NAV UTFJORD" value="0000"/>
    <ssn>00000000000</ssn>
</person>

Merk: En person kan ha flere <employment> oppføringer (f.eks. én per arbeidsgiver i en organisasjon med flere selskaper), og hvert ansettelsesforhold kan inneholde flere <position> oppføringer. Det er kun merket én stilling per ansettelse isPrimaryPosition="true".

Identitet, autentisering og kontaktfelt

XML-sti	Beskrivelse	Datatype	Obligatorisk	Bruk
`person@personIdHRM`	Intern Visma Enterprise-person-ID.	Heltall	Ja	Identifiserer personoppføringen entydig; brukes som kildekode for sammenstilling under synkronisering.
`ssn`	Norsk fødselsnummer.	Streng	Ja	Primær identifikator som brukes til å identifisere personen på tvers av eADM, Active Directory og Feide.
`givenName` / `familyName`	Fornavn og etternavn.	Streng	Ja	Brukes til å opprette visningsnavn og e-postadresser i målsystemene.
`authentication/username`	Fullt navn slik det er registrert for pålogging.	Streng	Nei	Referansefelt; brukes vanligvis ikke direkte.
`authentication/alias`	Alias for brukernavn.	Streng	Nei	Kan brukes som en foreslått verdi for brukernavnet i målsystemet (f.eks. `sAMAccountName`).
`dateOfBirth`	Fødselsdato.	Dato	Nei	Kan brukes i aldersbaserte regelsett.
`genderCode`	Kjønn (`MALE` / `FEMALE`).	Streng	Nei	Brukes sjelden i tilgangsregler.
`careerInfo/jobTitle`	Stillingsbetegnelse (fritt formulert).	Streng	Nei	Kan eksporteres til målsystemer som en beskrivende tittel; brukes ikke til tilgangskontroll.
`contactInfo/email`, `privateEmail`	Arbeids- og privat e-postadresse.	Streng	Nei	Brukes i varslingsprosesser, særlig før det finnes en arbeidskonto.
`contactInfo/workPhone`, `privateMobilePhone`	Arbeidsnummer og private telefonnumre.	Streng	Nei	Brukes i katalogsynkronisering og varslingsprosesser.
`postalAddress`	Hjemmeadresse.	Streng	Nei	Brukes sjelden; vurder å filtrere det bort (se advarselen ovenfor).

Felt for ansettelse og stilling

XML-sti	Beskrivelse	Datatype	Obligatorisk	Bruk
`employment/employeeId`	Ansattnummer for dette konkrete ansettelsesforholdet.	Heltall	Ja	En person kan ha flere ansettelser; dette gir hver enkelt ansettelse en unik identifikasjon.
`employment/category`	Kode og beskrivelse av ansettelseskategori (f.eks. `F3` / «Rask tilsetning – utvidet»).	Streng	Nei	Skiller mellom faste, midlertidige og timelønnede ansettelsesformer; brukes i regelsett.
`employment/company`	Arbeidsgiverenhet (navn og organisasjonsnummer).	Streng	Nei	Brukes ved import av data fra flere selskaper (se «Import av data fra flere selskaper»).
`employment/employmentPercentage`	Samlet sysselsettingsprosent for alle stillinger.	Desimal	Nei	Brukes for å skille mellom heltids- og deltidsansettelse.
`position@isPrimaryPosition`	Angir hovedposisjonen.	Boolsk	Ja	Bestemmer hvilken stilling som er avgjørende for brukerens hovedkonto, avdeling og leder. Se «Bruke stillingsfilteret».
`position/chart/unit`	Organisasjonsenheten som stillingen tilhører.	Streng / ID	Ja	Brukes til å plassere brukeren i organisasjonshierarkiet og til å tildele gruppemedlemskap.
`position/chart/unit/manager`	Linjeleder for avdelingen.	Streng / ID	Nei	Brukes til å søke opp ledere, godkjenningsprosesser og varsler om ansettelse og avskjed.
`position/positionInfo/positionCode`	Intern stillingskode og stillingstittel.	Streng	Nei	Brukes til rollebasert tilgangskontroll.
`position/positionInfo/positionType`	Kode for stilling eller ansettelsesstatus (f.eks. `F` «Rask» [permanent], `PF` «Foreldrepermisjon» [foreldrepermisjon], `PU` «Perm u/lønn» [ulønnet permisjon], `V` «Vikar» [midlertidig vikar]).	Streng	Nei	Kildefelt for eADM-er `QualificationCode` attributt. Se «Om attributtet QualificationCode» nedenfor.
`position/positionInfo/publicPositionCode`	Lovbestemt stillingskode (KS-tariff, «KSSKODE»).	Streng	Nei	Brukes til tariffbaserte regler og lovpålagt rapportering.
`position/positionPercentage`	Prosentandelen denne stillingen utgjør.	Desimal	Nei	Brukes i posisjonsfiltre. Se «Bruk av posisjonsfilteret».
`position/positionStartDate`, `positionEndDate`, `@validFromDate`	Gyldighetsdatoer for stillingen.	Dato	Nei	Brukes til å aktivere og deaktivere tilgang knyttet til stillingen.
`position/costCentres/dimensionX`	Kostnadssted / budsjettdimensjon.	Streng	Nei	Brukes til organisasjonsrapportering; brukes sjelden til tilgangskontroll.
`position/leave`	Ferieperiode, type og prosentandel.	Streng / Dato	Nei	Kan brukes til å suspendere eller justere tilgangen under langvarig fravær.

Lønn, skatt og statistikk

XML-sti	Beskrivelse	Datatype	Obligatorisk	Bruk
`position/salaryInfo/basicSalary`, `yearlySalary`	Lønnstall.	Desimal	Nei	Brukes ikke til tilgangskontroll. Svært sensitivt; det anbefales å filtrere dette bort før import (se advarselen ovenfor).
`position/positionStatistics/workClassification`	Standard yrkesklassifisering (STYRK).	Streng	Nei	Brukes til lovpålagt statistikkrapportering, ikke til adgangskontroll.
`statistics/paiEducation`	Registrert utdanningsnivå (PAI/SSB-utdanningskode).	Streng	Nei	Felt for lovpålagt rapportering; et annet begrep enn eADMs `QualificationCode` attributt, se nedenfor.
`employment/taxDetails`	Opplysninger om skattetrekk (skattekort, prosentandel).	Streng / Desimal	Nei	Sensitiv; brukes ikke av eADM. Det anbefales å filtrere bort.
`dependents/dependent`	Familiemedlemmer som er registrert i forbindelse med lønn eller forsikring.	Streng	Nei	Sensitivt; anbefales å filtrere bort med mindre det er spesifikt nødvendig.

Organisasjonshierarki

Organisasjonshierarkiet leveres separat fra medarbeiderdataene, som en <charts> fil som inneholder én <chart> element med en flat liste over <unit> elementer. Hver enhet refererer til sin overordnede enhet, slik at hierarkiet rekonstrueres av det importerende systemet i stedet for å være innleiret i XML-koden.

Eksempel på organisasjonsdata

Nedenfor følger et anonymisert eksempel som viser en enhet på øverste nivå og en av dens underordnede enheter.

XML

<charts>
    <chart id="5" name="Utfjord kommune">
        <units>
            <unit company="1" kode="40" id="1" name="Kommunedirektør" unitType="Kommunedirektør" parentid="0">
                <manager id="6001" name="Ola Leder">
                    <proprietorType>PERMANENT</proprietorType>
                </manager>
                <contactInfo>
                    <phone/>
                    <email/>
                </contactInfo>
                <tasks>
                    <task id="8" description="Tilvisar">
                        <employees>
                            <employee id="6001" name="Ola Leder">
                                <proprietorType>PERMANENT</proprietorType>
                            </employee>
                        </employees>
                    </task>
                </tasks>
                <roles>
                    <role id="4" description="Leiar">
                        <employees>
                            <employee id="6001" name="Ola Leder">
                                <proprietorType>PERMANENT</proprietorType>
                            </employee>
                        </employees>
                    </role>
                </roles>
            </unit>
            <unit company="1" kode="7" id="200" name="Helse og omsorg" unitType="Kommunalområde" parentid="40">
                <manager id="6002" name="Kari Nordmann">
                    <proprietorType>PERMANENT</proprietorType>
                </manager>
                <contactInfo>
                    <phone/>
                    <email/>
                </contactInfo>
                <tasks/>
                <roles/>
            </unit>
        </units>
    </chart>
</charts>

Merk: Lederen på øverste nivå (her «Kommunedirektør») har parentid="0". Hver annen enhets parentid henviser til kode av sin overordnede enhet, ikke av den overordnede enhetens id. Å forveksle disse to egenskapene er en vanlig årsak til feil i hierarkiet; se «Vismas anbefalte organisasjonsstruktur og dens innvirkning på eADM».

Beskrivelser av organisasjonsområder

XML-sti	Beskrivelse	Datatype	Obligatorisk	Bruk
`chart@id`, `chart@name`	Identifikator og navn på organisasjonskartet (vanligvis kommunen eller selskapet).	Heltall / Streng	Ja	Roten til det importerte hierarkiet.
`unit@id`	Intern enhets-ID i Visma Enterprise.	Streng	Ja	Kamper `position/chart/unit@id` i personalmappen, som brukes til å plassere ansatte i hierarkiet.
`unit@kode`	Kort numerisk tabellkode for enheten.	Heltall	Ja	Referert til av underenheter» `parentid` for å opprette hierarkiet. Se merknaden ovenfor.
`unit@parentid`	Den `kode` av hovedenheten (`0` (for enheten på øverste nivå).	Heltall	Ja	Oppretter organisasjonens overordnede-underordnede struktur.
`unit@name`	Navn på avdeling eller enhet.	Streng	Ja	Vises i målsystemene og brukes til å danne gruppenavn.
`unit@unitType`	Enhetstype (f.eks. «Kommunedirektør», «Kommunalområde», «Enhet», «Team», «Ikke ansatt»).	Streng	Nei	Kan brukes i regelsett for å skille mellom organisasjonsnivåer. Se «Vismas anbefalte organisasjonsstruktur og dens innvirkning på eADM».
`unit@company`	Organisasjonsnummeret til enheten.	Heltall	Nei	Brukes ved import av data fra flere selskaper.
`manager@id`, `manager@name`	Enhetslederen.	Streng	Nei	Brukes til å søke opp ledere, godkjenningsprosesser og varsler om ansettelse og avskjed.
`tasks/task`	En oppgave med navn (f.eks. «Attesterar», «Godkjenne fravær») der de ansatte, og eventuelt en overordnet, er tilordnet oppgaven.	Streng	Nei	Brukes til å gi oppgavespesifikk tilgang, for eksempel godkjennings- eller faktureringsrettigheter, uavhengig av formell stilling.
`roles/role`	En navngitt rolle (f.eks. «Leiar», «BI-tilgang») med de ansatte – og eventuelt en overordnet – tilordnet denne.	Streng	Nei	Brukes til å tildele rollespesifikke tilgangsrettigheter uavhengig av formell stilling.
`contactInfo/*`	Postadresse, besøksadresse, telefonnummer og e-postadresse for enheten.	Streng	Nei	Er vanligvis tom i praksis; brukes sjelden.

Forståelse av attributtet «QualificationCode»

I HR-systemer som Visma Enterprise er en kvalifikasjonskode en standardisert kode som brukes til å registrere en ansattes formelle utdanning, lisenser og ferdigheter.

I stedet for å skrive inn fri tekst bruker HR disse standardkodene, slik at systemet automatisk kan benytte opplysningene til tre hovedformål:

Lønn og satser: Koblinger til stillingskoder for å sikre riktig lønnsplassering (f.eks. fører registrering av en ny utdanning automatisk til at den ansatte blir merket for lønnsøkning).
Ressursstyring: Gjør det mulig for ledere å enkelt holde oversikt over hvem som har Rettighet til å utføre bestemte oppgaver (f.eks. å sjekke hvem som har gyldig helsepersonelllisens eller sertifikat for tungt maskineri).
Rapportering og etterlevelse: Leverer rene data for intern kompetansekartlegging og lovpålagt rapportering til offentlige myndigheter (for eksempel til Statistisk sentralbyrå).

Typiske eksempler: «Bachelorgrad», «HPR-godkjenning (helsevesen)» eller «førstehjelpssertifikat».

Sist oppdatert: 20. juli 2026