Guide till dataimport i Visma Enterprise

Detta dokument innehåller en detaljerad beskrivning av fälten i XML-stamdatafilen som eADM importerar från Visma Enterprise HRM (VEP). Det är avsett för teknisk personal som ansvarar för att konfigurera och underhålla integrationen.

Filen levereras som en <personsXML> dokument som innehåller ett <person> element per anställd. Varje personpost innehåller identitetsuppgifter, kontaktinformation och en eller flera <employment> uppgifter som beskriver den anställdes befattningar, organisatoriska placering och ersättning.

Varning: Källfilen kan innehålla känslig information, bland annat löneuppgifter, skatteuppgifter, bankkontonummer och uppgifter om anhöriga. Läs igenom guiden ”Filtrering och omvandling av importdata” innan du importerar en ofiltrerad fil, och ta bort alla uppgifter som inte krävs för integrationen.

Uppgifter om anställda

Exempel på medarbetardata

Nedan följer ett anonymiserat exempel på en <person> uppgifter för en enskild anställd. Alla identifierande uppgifter (namn, personnummer, kontaktuppgifter, organisationsnummer) har ersatts med platshållardata.

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>

Obs! En person kan ha flera <employment> poster (t.ex. en per arbetsgivare inom en koncern) och varje anställning kan omfatta flera <position> poster. Endast en befattning per anställning markeras isPrimaryPosition="true".

Identitet, autentisering och kontaktuppgifter

XML sökväg	Beskrivning	Typ av data	Obligatoriskt	Användning
`person@personIdHRM`	Internt person-ID i Visma Enterprise.	Heltal	Ja	Identifierar personposten på ett unikt sätt; används som källnyckel för matchning vid synkronisering.
`ssn`	Norskt personnummer (fødselsnummer).	Sträng	Ja	Primär identifierare som används för att matcha personen i eADM, Active Directory och Feide.
`givenName` / `familyName`	Förnamn och efternamn.	Sträng	Ja	Används för att skapa visningsnamn och e-postadresser i målsystemen.
`authentication/username`	Fullständigt namn enligt registreringen för inloggning.	Sträng	Nej	Referensfält; används normalt inte direkt.
`authentication/alias`	Användarnamn (alias).	Sträng	Nej	Kan användas som ett föreslaget värde för användarnamnet i målsystemet (t.ex. `sAMAccountName`).
`dateOfBirth`	Födelsedatum.	Datum	Nej	Kan användas i åldersbaserade regeluppsättningar.
`genderCode`	Kön (`MALE` / `FEMALE`).	Sträng	Nej	Används sällan i åtkomstregler.
`careerInfo/jobTitle`	Jobbets benämning (fritt formulerad).	Sträng	Nej	Kan exporteras till målsystem som en beskrivande titel; används inte för åtkomstkontroll.
`contactInfo/email`, `privateEmail`	Arbets- och privat e-postadress.	Sträng	Nej	Används i meddelandeflöden, särskilt innan ett arbetskonto har skapats.
`contactInfo/workPhone`, `privateMobilePhone`	Telefonnummer till jobbet och privat.	Sträng	Nej	Används vid katalogsynkronisering och meddelandeflöden.
`postalAddress`	Hemadress.	Sträng	Nej	Används sällan; överväg att filtrera bort det (se varningen ovan).

Arbets- och befattningsområden

XML sökväg	Beskrivning	Typ av data	Obligatoriskt	Användning
`employment/employeeId`	Personnummer för just detta anställningsförhållande.	Heltal	Ja	En person kan ha flera anställningar; detta ger varje anställning en unik identifiering.
`employment/category`	Kod och beskrivning för anställningskategori (t.ex. `F3` / ”Tillsätt snabbt utvidgning”).	Sträng	Nej	Skillnad mellan fasta, tillfälliga och timanställningar; används i regeluppsättningar.
`employment/company`	Arbetsgivarens namn och organisationsnummer.	Sträng	Nej	Används vid import av data från flera företag (se ”Importera data från flera företag”).
`employment/employmentPercentage`	Den totala sysselsättningsgraden i procent för alla befattningar.	Decimal	Nej	Används för att skilja mellan heltids- och deltidsanställning.
`position@isPrimaryPosition`	Markerar den primära positionen.	Boolesk	Ja	Avgör vilken befattning som styr användarens huvudkonto, avdelning och chef. Se ”Använda befattningsfiltret”.
`position/chart/unit`	Den organisatoriska enhet som tjänsten tillhör.	Sträng / ID	Ja	Används för att placera användaren i organisationshierarkin och för att tilldela gruppmedlemskap.
`position/chart/unit/manager`	Enhetens närmaste chef.	Sträng / ID	Nej	Används för att söka efter chefer, godkännandeprocesser samt meddelanden om anställningsstart och avslutad anställning.
`position/positionInfo/positionCode`	Intern befattningskod och befattningsbeteckning.	Sträng	Nej	Används för rollbaserad åtkomstkontroll.
`position/positionInfo/positionType`	Kod för befattning eller anställningsstatus (t.ex. `F` "Snabb" [permanent], `PF` "Föräldraledighet", `PU` "Perm u/lønn" [obetald ledighet], `V` "Vikar" [tillfällig ersättare]).	Sträng	Nej	Källfält för eADM:er `QualificationCode` attribut. Se ”Om attributet QualificationCode” nedan.
`position/positionInfo/publicPositionCode`	Lagstadgad positionskod (KS-tariff, ”KSSKODE”).	Sträng	Nej	Används för tullbaserade regler och lagstadgad rapportering.
`position/positionPercentage`	Den andel som just denna position utgör.	Decimal	Nej	Används i positionsfilter. Se ”Använda positionsfiltret”.
`position/positionStartDate`, `positionEndDate`, `@validFromDate`	Giltighetsperioder för befattningar.	Datum	Nej	Används för att aktivera och inaktivera åtkomst som är kopplad till befattningen.
`position/costCentres/dimensionX`	Kostnadsställe / budgetdimension.	Sträng	Nej	Används för organisationsrapportering; används sällan för åtkomstkontroll.
`position/leave`	Ledighetsperiod, typ och procentandel.	Sträng / Datum	Nej	Kan användas för att tillfälligt upphäva eller justera åtkomsten under en längre ledighet.

Områdena ersättning, skatt och statistik

XML sökväg	Beskrivning	Typ av data	Obligatoriskt	Användning
`position/salaryInfo/basicSalary`, `yearlySalary`	Lönesiffror.	Decimal	Nej	Används inte för åtkomstkontroll. Mycket känslig information; rekommenderas att filtreras bort före import (se varningen ovan).
`position/positionStatistics/workClassification`	Standardklassificering av yrken (STYRK).	Sträng	Nej	Används för lagstadgad statistikrapportering, inte för åtkomstkontroll.
`statistics/paiEducation`	Registrerad utbildningsnivå (PAI/SSB-utbildningskod).	Sträng	Nej	Fält för lagstadgad rapportering; ett begrepp som skiljer sig från eADM:s `QualificationCode` attribut, se nedan.
`employment/taxDetails`	Uppgifter om källskatt (skattekort, procentsats).	Sträng / Decimal	Nej	Känslig; används inte av eADM. Rekommenderas att filtreras bort.
`dependents/dependent`	Familjemedlemmar som är registrerade för löne- eller försäkringsändamål.	Sträng	Nej	Känslig information; rekommenderas att utelämnas om det inte uttryckligen krävs.

Organisationshierarki

Organisationshierarkin levereras separat från personaluppgifterna, i form av en <charts> fil som innehåller en <chart> element med en platt lista över <unit> element. Varje enhet hänvisar till sin överordnade enhet, vilket innebär att hierarkin återskapas av det importerande systemet istället för att vara inbäddad i XML-koden.

Exempel på organisationsdata

Nedan följer ett anonymiserat exempel som visar en enhet på högsta nivån och en av dess underordnade 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>

Obs! Den högsta befattningen (här ”Kommunedirektör”) har parentid="0". Varannan enhets parentid avser kod hos dess moderbolag, inte hos moderbolaget id. Att blanda ihop dessa två egenskaper är en vanlig orsak till fel i hierarkin; se ”Vismas rekommenderade organisationsstruktur och dess inverkan på eADM”.

Beskrivningar av organisationsområden

XML sökväg	Beskrivning	Typ av data	Obligatoriskt	Användning
`chart@id`, `chart@name`	Organisationsschemat (vanligtvis kommunen eller företaget) – identifierare och namn.	Heltal / Sträng	Ja	Rotnivån i den importerade hierarkin.
`unit@id`	Internt enhets-ID för Visma Enterprise.	Sträng	Ja	Matcher `position/chart/unit@id` i personalakten, som används för att placera medarbetare i hierarkin.
`unit@kode`	Kort numerisk tabellkod för enheten.	Heltal	Ja	”Refereras av underordnade enheter” `parentid` för att bygga upp hierarkin. Se anmärkningen ovan.
`unit@parentid`	Den `kode` hos moderenheten (`0` (för enheten på högsta nivån).	Heltal	Ja	Skapar organisationens hierarkiska struktur.
`unit@name`	Avdelningens eller enhetens namn.	Sträng	Ja	Visas i målsystemen och används för att skapa gruppnamn.
`unit@unitType`	Enhetstyp (t.ex. ”Kommundirektör”, ”Kommunalområde”, ”Enhet”, ”Team”, ”Ej anställd”).	Sträng	Nej	Kan användas i regeluppsättningar för att skilja mellan organisationsnivåer. Se ”Vismas rekommenderade organisationsstruktur och dess inverkan på eADM”.
`unit@company`	Företags-ID för den enhet som enheten tillhör.	Heltal	Nej	Används vid import av data från flera företag.
`manager@id`, `manager@name`	Enhetens chef.	Sträng	Nej	Används för att söka efter chefer, godkännandeprocesser samt meddelanden om anställningsstart och avslutad anställning.
`tasks/task`	En namngiven uppgift (t.ex. ”Attesterar”, ”Godkjenne fråvær”) med de anställda – och eventuellt en chef – tilldelade till den.	Sträng	Nej	Används för att bevilja uppgiftsspecifik åtkomst, till exempel behörigheter för godkännande eller fakturering, oberoende av formell befattning.
`roles/role`	En namngiven roll (t.ex. ”Leiar”, ”BI-åtkomst”) med de anställda – och eventuellt en chef – tilldelade till den.	Sträng	Nej	Används för att bevilja rollspecifika åtkomsträttigheter oberoende av formell befattning.
`contactInfo/*`	Enhetens postadress, besöksadress, telefonnummer och e-postadress.	Sträng	Nej	I praktiken oftast tomt; används sällan.

Att förstå attributet QualificationCode

I HR-system som Visma Enterprise är en kvalifikationskod en standardiserad beteckning som används för att registrera en medarbetares formella utbildning, certifikat och kompetenser.

I stället för att skriva in fri text använder HR dessa standardkoder så att systemet automatiskt kan använda uppgifterna för tre huvudsakliga syften:

Löner och lönegrader: Kopplingar till befattningskoder för att säkerställa korrekt löneplacering (t.ex. leder registreringen av en ny examen automatiskt till att den anställde blir aktuell för en löneförhöjning).
Resurshantering: Gör det möjligt för chefer att enkelt hålla reda på vilka som har behörighet att utföra specifika arbetsuppgifter (t.ex. kontrollera vilka som har en giltig vårdlicens eller ett certifikat för tung maskin).
Rapportering och efterlevnad: Tillhandahåller korrekta data för intern kompetenskartläggning och lagstadgad rapportering till myndigheter (t.ex. till Statistisk sentralbyrå).

Typiska exempel: ”Kandidatexamen”, ”HPR-behörighet (hälso- och sjukvård)” eller ”första hjälpen-certifikat”.

Senast uppdaterad: 20 juli 2026