Handleiding voor het importeren van gegevens in Visma Enterprise

Dit document bevat een gedetailleerde beschrijving van de velden in het XML-stamgegevensbestand dat eADM uit Visma Enterprise HRM (VEP) importeert. Het is bedoeld voor technisch personeel dat verantwoordelijk is voor het opzetten en onderhouden van de integratie.

Het bestand wordt geleverd als een <personsXML> document dat één bevat <person> element per medewerker. Elk persoonsrecord bevat identiteitsgegevens, contactgegevens en één of meer <employment> gegevens waarin de functies, de plaats binnen de organisatie en de beloning van de werknemer worden beschreven.

Waarschuwing: Het bronbestand kan gevoelige informatie bevatten, zoals salarisgegevens, belastinggegevens, bankrekeningnummers en gegevens over personen ten laste. Lees de handleiding ‘Importgegevens filteren en transformeren’ voordat u een ongefilterd bestand importeert, en verwijder alle elementen die niet nodig zijn voor de integratie.

Personeelsgegevens

Voorbeeld van werknemersgegevens

Hieronder volgt een geanonimiseerd voorbeeld van een <person> gegevens van één medewerker. Alle identificerende gegevens (naam, nationaal identiteitsnummer, contactgegevens, organisatienummer) zijn vervangen door tijdelijke gegevens.

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>

Opmerking: Iemand kan er meerdere hebben <employment> gegevens (bijvoorbeeld één per werkgever binnen een structuur met meerdere bedrijven), en elk dienstverband kan meerdere <position> gegevens. Per dienstverband wordt slechts één functie aangeduid isPrimaryPosition="true".

Identiteit, authenticatie en contactgegevens

XML-pad	Beschrijving	Gegevenstype	Verplicht	Gebruik
`person@personIdHRM`	Interne Visma Enterprise-persoons-ID.	Integer	Ja	Identificeert het persoonsrecord op unieke wijze; wordt gebruikt als bronsleutel voor het koppelen van gegevens tijdens de synchronisatie.
`ssn`	Noors persoonsnummer (fødselsnummer).	String	Ja	Primaire identificatiecode die wordt gebruikt om de persoon te koppelen in eADM, Active Directory en Feide.
`givenName` / `familyName`	Voornaam en achternaam.	String	Ja	Wordt gebruikt om weergavennamen en e-mailadressen in doelsystemen samen te stellen.
`authentication/username`	Volledige naam zoals geregistreerd voor het inloggen.	String	Geen	Referentieveld; wordt doorgaans niet rechtstreeks gebruikt.
`authentication/alias`	Alias voor gebruikersnaam.	String	Geen	Kan worden gebruikt als voorstel voor de gebruikersnaam op het doelsysteem (bijv. `sAMAccountName`).
`dateOfBirth`	Geboortedatum.	Datum	Geen	Kan worden gebruikt in op leeftijd gebaseerde regelsets.
`genderCode`	Geslacht (`MALE` / `FEMALE`).	String	Geen	Wordt zelden gebruikt in toegangsregels.
`careerInfo/jobTitle`	Functietitel (vrije tekst).	String	Geen	Kan naar doelsystemen worden geëxporteerd als een beschrijvende titel; wordt niet gebruikt voor toegangscontrole.
`contactInfo/email`, `privateEmail`	E-mailadres voor werk en privé.	String	Geen	Wordt gebruikt in meldingsprocessen, met name wanneer er nog geen werkaccount bestaat.
`contactInfo/workPhone`, `privateMobilePhone`	Telefoonnummers voor werk en privé.	String	Geen	Wordt gebruikt bij de synchronisatie van adreslijsten en meldingsstromen.
`postalAddress`	Thuisadres.	String	Geen	Wordt zelden gebruikt; overweeg om dit weg te filteren (zie de waarschuwing hierboven).

Werk- en functiegebieden

XML-pad	Beschrijving	Gegevenstype	Verplicht	Gebruik
`employment/employeeId`	Personeelsnummer voor deze specifieke arbeidsrelatie.	Integer	Ja	Iemand kan meerdere banen hebben; elke baan wordt op unieke wijze geïdentificeerd.
`employment/category`	Code en omschrijving van de functiecategorie (bijv. `F3` / "Snel toevoegen - uitbreiden").	String	Geen	Maakt onderscheid tussen vaste, tijdelijke en uurloonbanen; wordt gebruikt in regelsets.
`employment/company`	Werkgever (naam en organisatienummer).	String	Geen	Wordt gebruikt bij het importeren van gegevens uit meerdere bedrijven (zie „Gegevens uit meerdere bedrijven importeren”).
`employment/employmentPercentage`	Totaal percentage van de werkgelegenheid voor alle functies.	Decimaal	Geen	Wordt gebruikt om een onderscheid te maken tussen een voltijdbaan en een deeltijdbaan.
`position@isPrimaryPosition`	Geeft de primaire positie aan.	Booleaans	Ja	Bepaalt welke functie bepalend is voor het hoofdaccount, de afdeling en de leidinggevende van de gebruiker. Zie „Het functiefilter gebruiken”.
`position/chart/unit`	Organisatie-eenheid waartoe de functie behoort.	Tekenreeks / ID	Ja	Wordt gebruikt om de gebruiker in de organisatiestructuur in te delen en groepslidmaatschappen toe te wijzen.
`position/chart/unit/manager`	Lijnmanager van de afdeling.	Tekenreeks / ID	Geen	Wordt gebruikt voor het opzoeken van managers, goedkeuringsprocessen en meldingen bij indiensttreding en uittreding.
`position/positionInfo/positionCode`	Interne functiecode en functietitel.	String	Geen	Wordt gebruikt voor op rollen gebaseerde toegangscontrole.
`position/positionInfo/positionType`	Code voor functie of dienstverband (bijv. `F` "Snel" [permanent], `PF` "Foreldrepermisjon" [ouderschapsverlof], `PU` "Perm u/lønn" [onbetaald verlof], `V` "Vikar" [tijdelijke vervanger]).	String	Geen	Bronveld voor eADM’s `QualificationCode` attribuut. Zie „Uitleg over het QualificationCode-attribuut” hieronder.
`position/positionInfo/publicPositionCode`	Wettelijke positiecode (KS-tarief, „KSSKODE“).	String	Geen	Wordt gebruikt voor op tarieven gebaseerde regels en wettelijk verplichte rapportage.
`position/positionPercentage`	Het percentage dat deze specifieke functie inneemt.	Decimaal	Geen	Wordt gebruikt in positiefilters. Zie „Het positiefilter gebruiken”.
`position/positionStartDate`, `positionEndDate`, `@validFromDate`	Geldigheidsdata van de functie.	Datum	Geen	Wordt gebruikt om de toegang die aan de functie is gekoppeld in en uit te schakelen.
`position/costCentres/dimensionX`	Kostenplaats / begrotingsdimensie.	String	Geen	Wordt gebruikt voor rapportage binnen de organisatie; wordt zelden gebruikt voor toegangscontrole.
`position/leave`	Vakantieperiode, soort en percentage.	Tekenreeks / Datum	Geen	Kan worden gebruikt om de toegang op te schorten of aan te passen tijdens langdurig verlof.

De sectoren beloning, belastingen en statistiek

XML-pad	Beschrijving	Gegevenstype	Verplicht	Gebruik
`position/salaryInfo/basicSalary`, `yearlySalary`	Salarisgegevens.	Decimaal	Geen	Wordt niet gebruikt voor toegangscontrole. Zeer gevoelig; het wordt aanbevolen dit vóór het importeren eruit te filteren (zie de waarschuwing hierboven).
`position/positionStatistics/workClassification`	Standaardberoepscategorieën (STYRK).	String	Geen	Wordt gebruikt voor wettelijk verplichte statistische rapportage, niet voor toegangscontrole.
`statistics/paiEducation`	Geregistreerd opleidingsniveau (PAI / SSB-opleidingscode).	String	Geen	Verplicht rapportageveld; een ander begrip dan dat van eADM’s `QualificationCode` attribuut, zie hieronder.
`employment/taxDetails`	Gegevens over de bronheffing (belastingkaart, percentage).	Tekenreeks / Decimaal	Geen	Gevoelig; wordt niet gebruikt door eADM. Aanbevolen om uit te filteren.
`dependents/dependent`	Familieleden die zijn geregistreerd voor loon- of verzekeringsdoeleinden.	String	Geen	Gevoelig; het wordt aanbevolen dit uit te filteren, tenzij dit specifiek vereist is.

Organisatorische hiërarchie

De organisatiestructuur wordt los van de personeelsgegevens geleverd, als een <charts> bestand met één <chart> element met een platte lijst van <unit> elementen. Elke eenheid verwijst naar zijn bovenliggende element, zodat de hiërarchie door het importerende systeem wordt gereconstrueerd in plaats van in de XML te zijn genest.

Voorbeeld van organisatorische gegevens

Hieronder staat een geanonimiseerd voorbeeld waarin een eenheid op het hoogste niveau en een van haar onderliggende eenheden worden weergegeven.

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>

Opmerking: De hoogste functie (in dit geval „Kommunedirektør“) heeft parentid="0". Die van alle andere eenheden parentid verwijst naar de code van de moedermaatschappij, niet van de moedermaatschappij zelf id. Het door elkaar halen van deze twee kenmerken is een veelvoorkomende oorzaak van fouten in de hiërarchie; zie „De door Visma aanbevolen organisatiestructuur en de gevolgen daarvan voor eADM”.

Beschrijvingen van organisatorische gebieden

XML-pad	Beschrijving	Gegevenstype	Verplicht	Gebruik
`chart@id`, `chart@name`	Identificatiecode en naam van het organigram (meestal de gemeente of het bedrijf).	Geheel getal / Tekst	Ja	Hoofdelement van de geïmporteerde hiërarchie.
`unit@id`	Interne Visma Enterprise-eenheids-ID.	String	Ja	Wedstrijden `position/chart/unit@id` in het personeelsdossier, dat wordt gebruikt om medewerkers in de hiërarchie in te delen.
`unit@kode`	Korte numerieke codering voor de eenheid.	Integer	Ja	'Verwezen door onderliggende eenheden' `parentid` om de hiërarchie op te bouwen. Zie de opmerking hierboven.
`unit@parentid`	De `kode` van het hoofdapparaat (`0` (voor de eenheid op het hoogste niveau).	Integer	Ja	Stelt de hiërarchische structuur van de organisatie op.
`unit@name`	Naam van de afdeling of eenheid.	String	Ja	Wordt weergegeven in doelsystemen en gebruikt om groepsnamen samen te stellen.
`unit@unitType`	Type eenheid (bijv. „Kommunedirektør”, „Kommunalområde”, „Eining”, „Team”, „Ikkje tilsett”).	String	Geen	Kan in regelsets worden gebruikt om onderscheid te maken tussen organisatieniveaus. Zie „De door Visma aanbevolen organisatiestructuur en de invloed daarvan op eADM”.
`unit@company`	Bedrijfs-ID van de eenheid waartoe de eenheid behoort.	Integer	Geen	Wordt gebruikt bij het importeren van gegevens van meerdere bedrijven.
`manager@id`, `manager@name`	De manager van de afdeling.	String	Geen	Wordt gebruikt voor het opzoeken van managers, goedkeuringsprocessen en meldingen bij indiensttreding en uittreding.
`tasks/task`	Een taak met een naam (bijv. „Attesterar”, „Godkjenne fråvær”) waaraan de medewerkers, en eventueel een leidinggevende, zijn toegewezen.	String	Geen	Wordt gebruikt om taakspecifieke toegangsrechten toe te kennen, zoals goedkeurings- of factureringsrechten, los van de formele functie.
`roles/role`	Een rol met een naam (bijv. „Leiar”, „BI-toegang”) waaraan medewerkers en eventueel een leidinggevende zijn toegewezen.	String	Geen	Wordt gebruikt om rolspecifieke toegangsrechten toe te kennen, los van de formele functie.
`contactInfo/*`	Postadres, bezoekadres, telefoonnummer en e-mailadres van de afdeling.	String	Geen	In de praktijk meestal leeg; wordt zelden gebruikt.

Uitleg over het attribuut ‘QualificationCode’

In HR-systemen zoals Visma Enterprise is een kwalificatiecode een gestandaardiseerde aanduiding die wordt gebruikt om de formele opleiding, certificaten en vaardigheden van een medewerker vast te leggen.

In plaats van vrije tekst in te voeren, gebruikt HR deze standaardcodes, zodat het systeem de gegevens automatisch voor drie belangrijke doeleinden kan gebruiken:

Salarisadministratie en tarieven: Koppelingen naar functiecodes om een correcte salarisindeling te garanderen (bijvoorbeeld: wanneer een nieuwe opleiding wordt geregistreerd, wordt de medewerker automatisch in aanmerking genomen voor een salarisverhoging).
Personeelsbeheer: Hiermee kunnen managers eenvoudig bijhouden wie bevoegd is om bepaalde taken uit te voeren (bijvoorbeeld controleren wie in het bezit is van een geldige vergunning voor de gezondheidszorg of een certificaat voor het besturen van zware machines).
Rapportage en naleving: Levert betrouwbare gegevens voor het in kaart brengen van interne competenties en wettelijk verplichte rapportage aan overheidsinstanties (zoals Statistics Norway).

Typische voorbeelden: „bachelordiploma”, „HPR-bevoegdheid (gezondheidszorg)” of „EHBO-certificaat”.

Laatst bijgewerkt: 20 juli 2026