Vejledning til import af data til Visma Enterprise

Dette dokument indeholder en detaljeret beskrivelse af felterne i XML-stamdatafilen, som eADM importerer fra Visma Enterprise HRM (VEP). Det er beregnet til teknisk personale, der har ansvaret for opsætning og vedligeholdelse af integrationen.

Filen leveres som en <personsXML> dokument, der indeholder én <person> element pr. medarbejder. Hver medarbejderpost indeholder identitetsoplysninger, kontaktoplysninger og et eller flere <employment> oplysninger om medarbejderens stillinger, organisatoriske placering og løn.

Advarsel: Kildefilen kan indeholde følsomme oplysninger, herunder lønoplysninger, skatteoplysninger, bankkontonumre og oplysninger om pårørende. Læs vejledningen »Filtrering og omformning af importdata«, inden du importerer en ufiltreret fil, og fjern alle elementer, der ikke er nødvendige for integrationen.

Medarbejderoplysninger

Eksempel på medarbejderoplysninger

Nedenfor ses et anonymiseret eksempel på en <person> oplysninger om en enkelt medarbejder. Alle identificerende oplysninger (navn, CPR-nummer, kontaktoplysninger, organisationsnummer) er blevet erstattet med pladsholderdata.

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>

Bemærk: En person kan have flere <employment> poster (f.eks. én pr. arbejdsgiver i en struktur med flere virksomheder), og hvert ansættelsesforhold kan omfatte flere <position> oplysninger. Der markeres kun én stilling pr. ansættelse isPrimaryPosition="true".

Identitets-, godkendelses- og kontaktfelter

XML-sti	Beskrivelse	Datatype	Obligatorisk	Anvendelse
`person@personIdHRM`	Internt Visma Enterprise-person-ID.	Heltal	Ja	Identificerer personoplysningerne entydigt; anvendes som kildenøgle til sammenkobling under synkronisering.
`ssn`	Norsk personnummer (fødselsnummer).	Streng	Ja	Primær identifikator, der bruges til at matche personen på tværs af eADM, Active Directory og Feide.
`givenName` / `familyName`	Fornavn og efternavn.	Streng	Ja	Bruges til at oprette visningsnavne og e-mailadresser i målsystemerne.
`authentication/username`	Det fulde navn, som det er registreret til login.	Streng	Nej	Referencefelt; bruges normalt ikke direkte.
`authentication/alias`	Alias for brugernavn.	Streng	Nej	Kan bruges som en foreslået værdi for brugernavnet i målsystemet (f.eks. `sAMAccountName`).
`dateOfBirth`	Fødselsdato.	Dato	Nej	Kan anvendes i aldersbaserede regelsæt.
`genderCode`	Køn (`MALE` / `FEMALE`).	Streng	Nej	Anvendes sjældent i adgangsregler.
`careerInfo/jobTitle`	Jobtitel (fri tekst).	Streng	Nej	Kan eksporteres til målsystemer som en beskrivende titel; anvendes ikke til adgangskontrol.
`contactInfo/email`, `privateEmail`	Arbejds- og privat e-mailadresse.	Streng	Nej	Anvendes i notifikationsforløb, især før der findes en arbejdskonto.
`contactInfo/workPhone`, `privateMobilePhone`	Arbejds- og private telefonnumre.	Streng	Nej	Anvendes i katalogsynkronisering og notifikationsforløb.
`postalAddress`	Hjemmeadresse.	Streng	Nej	Bruges sjældent; overvej at filtrere det fra (se advarslen ovenfor).

Felt for ansættelse og stilling

XML-sti	Beskrivelse	Datatype	Obligatorisk	Anvendelse
`employment/employeeId`	Medarbejdernummer for dette specifikke ansættelsesforhold.	Heltal	Ja	En person kan have flere ansættelser; dette identificerer hver enkelt af dem entydigt.
`employment/category`	Kode og beskrivelse af ansættelseskategori (f.eks. `F3` / "Hurtig tilsætning – udvidet").	Streng	Nej	Skelner mellem faste, midlertidige og timelønnede ansættelsesformer; anvendes i regelsæt.
`employment/company`	Arbejdsgiveren (navn og organisationsnummer).	Streng	Nej	Anvendes ved import af data fra flere virksomheder (se »Import af data fra flere virksomheder«).
`employment/employmentPercentage`	Den samlede beskæftigelsesprocent for alle stillinger.	Decimal	Nej	Bruges til at skelne mellem fuldtids- og deltidsansættelse.
`position@isPrimaryPosition`	Angiver den primære position.	Boolsk	Ja	Bestemmer, hvilken stilling der er afgørende for brugerens hovedkonto, afdeling og leder. Se »Brug af stillingsfilteret«.
`position/chart/unit`	Den organisatoriske enhed, som stillingen hører under.	Streng / ID	Ja	Bruges til at placere brugeren i organisationshierarkiet og til at tildele gruppemedlemskaber.
`position/chart/unit/manager`	Afdelingsleder for enheden.	Streng / ID	Nej	Anvendes til opslag af ledere, godkendelsesforløb og meddelelser om ansættelse og fratrædelse.
`position/positionInfo/positionCode`	Intern stillingskode og stillingsbetegnelse.	Streng	Nej	Anvendes til rollebaseret adgangskontrol.
`position/positionInfo/positionType`	Kode for stilling eller ansættelsesstatus (f.eks. `F` "Hurtig" [permanent], `PF` "Forældrepermisjon" [forældreorlov], `PU` "Perm u/lønn" [ulønnet orlov], `V` "Vikar" [midlertidig vikar]).	Streng	Nej	Kildefelt for eADM’er `QualificationCode` attribut. Se »Om attributten QualificationCode« nedenfor.
`position/positionInfo/publicPositionCode`	Lovbestemt stillingskode (KS-tarif, »KSSKODE«).	Streng	Nej	Anvendes til takstbaserede regler og lovpligtig rapportering.
`position/positionPercentage`	Den procentdel, som denne specifikke stilling udgør.	Decimal	Nej	Anvendes i positionsfiltre. Se »Brug af positionsfilteret«.
`position/positionStartDate`, `positionEndDate`, `@validFromDate`	Angiv gyldighedsperioden.	Dato	Nej	Bruges til at aktivere og deaktivere adgang knyttet til stillingen.
`position/costCentres/dimensionX`	Omkostningscenter / budgetdimension.	Streng	Nej	Anvendes til organisatorisk rapportering; anvendes sjældent til adgangskontrol.
`position/leave`	Ferieperiode, type og procentdel.	Streng / Dato	Nej	Kan bruges til at suspendere eller justere adgangsrettighederne under længerevarende orlov.

Områderne løn, skat og statistik

XML-sti	Beskrivelse	Datatype	Obligatorisk	Anvendelse
`position/salaryInfo/basicSalary`, `yearlySalary`	Løntal.	Decimal	Nej	Anvendes ikke til adgangskontrol. Meget følsomt; det anbefales at filtrere det fra inden import (se advarslen ovenfor).
`position/positionStatistics/workClassification`	Standardklassifikation af erhverv (STYRK).	Streng	Nej	Anvendes til lovpligtig statistikrapportering, ikke til adgangskontrol.
`statistics/paiEducation`	Registreret uddannelsesniveau (PAI/SSB-uddannelseskode).	Streng	Nej	Lovpligtigt rapporteringsfelt; et begreb, der adskiller sig fra eADM’s `QualificationCode` attribut, se nedenfor.
`employment/taxDetails`	Oplysninger om skatteindholdelse (skattekort, procentdel).	Streng / Decimal	Nej	Følsom; anvendes ikke af eADM. Det anbefales at filtrere den fra.
`dependents/dependent`	Familiemedlemmer, der er registreret med henblik på løn eller forsikring.	Streng	Nej	Følsomt; det anbefales at udelade dette, medmindre det specifikt kræves.

Organisationshierarki

Organisationshierarkiet leveres separat fra medarbejderdataene, som en <charts> fil, der indeholder én <chart> element med en flad liste over <unit> elementer. Hver enhed henviser til sin overordnede enhed, så hierarkiet rekonstrueres af det importerende system i stedet for at være indlejret i XML-koden.

Eksempel på organisationsdata

Nedenfor ses et anonymiseret eksempel, der viser en enhed på øverste niveau og en af dens underenheder.

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>

Bemærk: Den øverste ledende stilling (her »Kommunedirektør«) har parentid="0". Hver anden enheds parentid henviser til kode af dets moderselskab, ikke moderselskabets id. Forveksling af disse to attributter er en almindelig årsag til fejl i hierarkiet; se »Vismas anbefalede organisationsstruktur og dens indvirkning på eADM«.

Beskrivelser af organisatoriske områder

XML-sti	Beskrivelse	Datatype	Obligatorisk	Anvendelse
`chart@id`, `chart@name`	Identifikationskode og navn på organisationsdiagrammet (typisk kommunen eller virksomheden).	Heltal / Streng	Ja	Rod i det importerede hierarki.
`unit@id`	Internt Visma Enterprise-enheds-ID.	Streng	Ja	Kampe `position/chart/unit@id` i medarbejderfilen, der bruges til at placere medarbejdere i hierarkiet.
`unit@kode`	Kort numerisk skema-kode for enheden.	Heltal	Ja	»Henvist af underenheder« `parentid` for at opbygge hierarkiet. Se bemærkningen ovenfor.
`unit@parentid`	Den `kode` af moderenheden (`0` (for enheden på øverste niveau).	Heltal	Ja	Opretter organisationens overordnede-underordnede struktur.
`unit@name`	Afdelings- eller enhedsnavn.	Streng	Ja	Vises i målsystemer og bruges til at oprette gruppenavne.
`unit@unitType`	Enhedstype (f.eks. »Kommunedirektør«, »Kommunalområde«, »Enhed«, »Team«, »Ikke ansat«).	Streng	Nej	Kan anvendes i regelsæt til at skelne mellem organisationsniveauer. Se »Vismas anbefalede organisationsstruktur og dens indvirkning på eADM«.
`unit@company`	Det firma-ID, som enheden tilhører.	Heltal	Nej	Anvendes ved import af data fra flere virksomheder.
`manager@id`, `manager@name`	Afdelingslederen.	Streng	Nej	Anvendes til opslag af ledere, godkendelsesforløb og meddelelser om ansættelse og fratrædelse.
`tasks/task`	En opgave med et navn (f.eks. »Attesterar«, »Godkjenne fråvær«), hvor medarbejderne – og eventuelt en leder – er tildelt opgaven.	Streng	Nej	Anvendes til at tildele opgavespecifik adgang, f.eks. godkendelses- eller faktureringsrettigheder, uafhængigt af den formelle stilling.
`roles/role`	En navngivet rolle (f.eks. »Leiar«, »BI-adgang«), hvortil der er tildelt medarbejdere og eventuelt en overordnet.	Streng	Nej	Anvendes til at tildele rollebaserede adgangsrettigheder uafhængigt af den formelle stilling.
`contactInfo/*`	Enhedens postadresse, besøgsadresse, telefonnummer og e-mailadresse.	Streng	Nej	Er i praksis som regel tom; bruges sjældent.

En gennemgang af attributten »QualificationCode«

I HR-systemer som Visma Enterprise er en kvalifikationskode en standardiseret betegnelse, der bruges til at registrere en medarbejders formelle uddannelse, certifikater og kompetencer.

I stedet for at indtaste fri tekst bruger HR disse standardkoder, så systemet automatisk kan anvende oplysningerne til tre hovedformål:

Løn og takster: Links til jobkoder for at sikre korrekt lønplacering (f.eks. medfører registrering af en ny uddannelse automatisk, at medarbejderen markeres til en lønforhøjelse).
Ressourcehåndtering: Giver ledere mulighed for nemt at holde styr på, hvem der har tilladelse til at udføre bestemte opgaver (f.eks. at kontrollere, hvem der har en gyldig sundhedslicens eller et certifikat til betjening af tungt maskineri).
Rapportering og overholdelse af lovkrav: Leverer pålidelige data til intern kompetencekortlægning og lovpligtig rapportering til myndighederne (f.eks. til Statistisk Sentralbyrå).

Typiske eksempler: »Bachelorgrad«, »HPR-godkendelse (sundhedssektoren)« eller »førstehjælpsbevis«.

Senest opdateret: 20. juli 2026