Anleitung zum Datenimport in Visma Enterprise

Dieses Dokument enthält eine detaillierte Beschreibung der Felder in der XML-Stammdatendatei, die eADM aus Visma Enterprise HRM (VEP) importiert. Es richtet sich an technische Mitarbeiter, die für die Einrichtung und Wartung der Integration zuständig sind.

Die Datei wird als <personsXML> Dokument, das eines enthält <person> Element pro Mitarbeiter. Jeder Personeneintrag enthält Identitätsdaten, Kontaktinformationen und ein oder mehrere <employment> Unterlagen, aus denen die Positionen, die organisatorische Einordnung und die Vergütung des Mitarbeiters hervorgehen.

Warnung: Die Quelldatei kann vertrauliche Informationen enthalten, darunter Gehaltsangaben, Steuerdaten, Bankkontonummern und Angaben zu unterhaltsberechtigten Personen. Lesen Sie vor dem Import einer ungefilterten Datei den Leitfaden „Filtern und Transformieren von Importdaten“ durch und entfernen Sie alle Elemente, die für die Integration nicht erforderlich sind.

Mitarbeiterdaten

Beispiel für Mitarbeiterdaten

Nachfolgend finden Sie ein anonymisiertes Beispiel für ein <person> Datensatz für einen einzelnen Mitarbeiter. Alle identifizierenden Werte (Name, nationale Identifikationsnummer, Kontaktdaten, Organisationsnummer) wurden durch Platzhalterdaten ersetzt.

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>

Hinweis: Eine Person kann mehrere haben <employment> Datensätze (z. B. einen pro Arbeitgeber in einer Struktur mit mehreren Unternehmen), und jedes Beschäftigungsverhältnis kann mehrere <position> Datensätze. Pro Beschäftigungsverhältnis wird nur eine Position markiert. isPrimaryPosition="true".

Identitäts-, Authentifizierungs- und Kontaktfelder

XML-Pfad	Beschreibung	Datentyp	Obligatorisch	Verwendung
`person@personIdHRM`	Interne Visma Enterprise-Personen-ID.	Ganzzahl	Ja	Identifiziert den Personendatensatz eindeutig; wird als Quellschlüssel für den Abgleich bei der Synchronisation verwendet.
`ssn`	Norwegische Personenkennnummer (fødselsnummer).	Zeichenkette	Ja	Primäre Kennung, die zum Abgleich der Person zwischen eADM, Active Directory und Feide verwendet wird.
`givenName` / `familyName`	Vorname und Nachname.	Zeichenkette	Ja	Wird zur Erstellung von Anzeigenamen und E-Mail-Adressen in Zielsystemen verwendet.
`authentication/username`	Vollständiger Name, wie er für die Anmeldung registriert ist.	Zeichenkette	Nein	Referenzfeld; wird normalerweise nicht direkt verwendet.
`authentication/alias`	Benutzername (Alias).	Zeichenkette	Nein	Kann als vorgeschlagener Wert für den Benutzernamen im Zielsystem verwendet werden (z. B. `sAMAccountName`).
`dateOfBirth`	Geburtsdatum.	Datum	Nein	Kann in altersbasierten Regelsätzen verwendet werden.
`genderCode`	Geschlecht (`MALE` / `FEMALE`).	Zeichenkette	Nein	Wird in Zugriffsregeln selten verwendet.
`careerInfo/jobTitle`	Freitext-Stellenbezeichnung.	Zeichenkette	Nein	Kann als beschreibender Titel in Zielsysteme exportiert werden; wird nicht für die Zugriffskontrolle verwendet.
`contactInfo/email`, `privateEmail`	E-Mail-Adresse für berufliche und private Zwecke.	Zeichenkette	Nein	Wird in Benachrichtigungsabläufen verwendet, insbesondere bevor ein Arbeitskonto existiert.
`contactInfo/workPhone`, `privateMobilePhone`	Dienst- und private Telefonnummern.	Zeichenkette	Nein	Wird bei der Verzeichnissynchronisierung und in Benachrichtigungsabläufen verwendet.
`postalAddress`	Wohnadresse.	Zeichenkette	Nein	Wird selten verwendet; erwägen Sie, dies herauszufiltern (siehe Warnung oben).

Berufs- und Stellenfelder

XML-Pfad	Beschreibung	Datentyp	Obligatorisch	Verwendung
`employment/employeeId`	Mitarbeiter-Nummer für dieses konkrete Arbeitsverhältnis.	Ganzzahl	Ja	Eine Person kann mehrere Beschäftigungsverhältnisse haben; jedes davon ist eindeutig identifiziert.
`employment/category`	Code und Beschreibung der Beschäftigungsart (z. B. `F3` / „Schnell hinzufügen – erweitern“).	Zeichenkette	Nein	Unterscheidet zwischen unbefristeten, befristeten und stundenweisen Beschäftigungsverhältnissen; wird in Regelsätzen verwendet.
`employment/company`	Arbeitgeber (Name und Organisationsnummer).	Zeichenkette	Nein	Wird beim Importieren von Daten aus mehreren Unternehmen verwendet (siehe „Daten aus mehreren Unternehmen importieren“).
`employment/employmentPercentage`	Gesamtbeschäftigungsquote über alle Positionen hinweg.	Dezimal	Nein	Wird verwendet, um zwischen Vollzeit- und Teilzeitbeschäftigung zu unterscheiden.
`position@isPrimaryPosition`	Kennzeichnet die Hauptposition.	Boolesch	Ja	Legt fest, welche Planstelle für das Hauptkonto, die Abteilung und den Vorgesetzten des Benutzers maßgeblich ist. Siehe „Verwendung des Planstellenfilters“.
`position/chart/unit`	Organisationseinheit, zu der die Stelle gehört.	Zeichenkette / ID	Ja	Dient dazu, den Benutzer in die Organisationshierarchie einzuordnen und ihm Gruppenzugehörigkeiten zuzuweisen.
`position/chart/unit/manager`	Direkter Vorgesetzter der Abteilung.	Zeichenkette / ID	Nein	Wird für die Suche nach Vorgesetzten, Genehmigungsabläufe sowie Benachrichtigungen zum Onboarding und Offboarding verwendet.
`position/positionInfo/positionCode`	Interner Stellencode und Stellenbezeichnung.	Zeichenkette	Nein	Wird für die rollenbasierte Zugriffskontrolle verwendet.
`position/positionInfo/positionType`	Code für die Position oder den Beschäftigungsstatus (z. B. `F` „Schnell“ [dauerhaft], `PF` „Foreldrepermisjon“ [Elternzeit], `PU` „Perm u/lønn“ [unbezahlter Urlaub], `V` „Vikar“ [Vertretung]).	Zeichenkette	Nein	Quellfeld für eADMs `QualificationCode` Attribut. Siehe „Das Attribut ‚QualificationCode‘ verstehen“ weiter unten.
`position/positionInfo/publicPositionCode`	Gesetzlicher Positionscode (KS-Tarif, „KSSKODE“).	Zeichenkette	Nein	Wird für tarifbasierte Regeln und die gesetzlich vorgeschriebene Berichterstattung verwendet.
`position/positionPercentage`	Prozentualer Anteil, den diese bestimmte Position ausmacht.	Dezimal	Nein	Wird in Positionsfiltern verwendet. Siehe „Verwendung des Positionsfilters“.
`position/positionStartDate`, `positionEndDate`, `@validFromDate`	Gültigkeitszeiträume der Stellen.	Datum	Nein	Dient zum Aktivieren und Deaktivieren der mit der Position verbundenen Zugriffsrechte.
`position/costCentres/dimensionX`	Kostenstelle / Budgetdimension.	Zeichenkette	Nein	Wird für die betriebliche Berichterstattung verwendet; kommt bei der Zugriffskontrolle nur selten zum Einsatz.
`position/leave`	Urlaubszeitraum, Art und Prozentsatz.	Zeichenkette / Datum	Nein	Kann verwendet werden, um den Zugriff während einer längeren Abwesenheit auszusetzen oder anzupassen.

Bereiche Vergütung, Steuern und Statistik

XML-Pfad	Beschreibung	Datentyp	Obligatorisch	Verwendung
`position/salaryInfo/basicSalary`, `yearlySalary`	Gehaltsangaben.	Dezimal	Nein	Wird nicht für die Zugriffskontrolle verwendet. Sehr sensibel; es wird empfohlen, diese vor dem Import herauszufiltern (siehe Warnung oben).
`position/positionStatistics/workClassification`	Standard-Berufsklassifikation (STYRK).	Zeichenkette	Nein	Wird für die gesetzlich vorgeschriebene statistische Berichterstattung verwendet, nicht für die Zugriffskontrolle.
`statistics/paiEducation`	Angegebener Bildungsabschluss (PAI-/SSB-Bildungscode).	Zeichenkette	Nein	Gesetzlich vorgeschriebenes Berichtsfeld; ein von den eADM-Feldern unabhängiges Konzept `QualificationCode` Attribut, siehe unten.
`employment/taxDetails`	Angaben zur Quellensteuer (Steuerkarte, Prozentsatz).	Zeichenkette / Dezimalzahl	Nein	Vertraulich; wird von eADM nicht verwendet. Es wird empfohlen, diese Daten herauszufiltern.
`dependents/dependent`	Familienangehörige, die zu Gehalts- oder Versicherungszwecken gemeldet sind.	Zeichenkette	Nein	Vertraulich; es wird empfohlen, diese Informationen herauszufiltern, sofern sie nicht ausdrücklich benötigt werden.

Organisationshierarchie

Die Organisationshierarchie wird getrennt von den Mitarbeiterdaten bereitgestellt, und zwar als <charts> Datei, die eine enthält <chart> Element mit einer flachen Liste von <unit> Elemente. Jede Einheit verweist auf ihre übergeordnete Einheit, sodass die Hierarchie vom importierenden System rekonstruiert wird und nicht im XML verschachtelt ist.

Beispiel für Organisationsdaten

Nachfolgend finden Sie ein anonymisiertes Beispiel, das eine Einheit der obersten Ebene und eine ihrer untergeordneten Einheiten zeigt.

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>

Hinweis: Die oberste Führungsebene (hier „Kommunedirektør“) hat parentid="0". Bei jeder zweiten Einheit parentid bezieht sich auf die Code der Muttergesellschaft, nicht der Muttergesellschaft selbst id. Die Verwechslung dieser beiden Merkmale ist eine häufige Ursache für Hierarchiefehler; siehe „Die von Visma empfohlene Organisationsstruktur und ihre Auswirkungen auf eADM“.

Beschreibungen der Organisationsbereiche

XML-Pfad	Beschreibung	Datentyp	Obligatorisch	Verwendung
`chart@id`, `chart@name`	Kennung und Name des Organigramms (in der Regel der Gemeinde oder des Unternehmens).	Ganzzahl / Zeichenfolge	Ja	Stamm der importierten Hierarchie.
`unit@id`	Interne Visma Enterprise-Einheits-ID.	Zeichenkette	Ja	Spiele `position/chart/unit@id` in der Personalakte, dient dazu, Mitarbeiter in der Hierarchie einzuordnen.
`unit@kode`	Kurzer numerischer Chart-Code für die Einheit.	Ganzzahl	Ja	„Von untergeordneten Einheiten referenziert“ `parentid` um die Hierarchie aufzubauen. Siehe Hinweis oben.
`unit@parentid`	Die `kode` der übergeordneten Einheit (`0` (für die oberste Einheit).	Ganzzahl	Ja	Erstellt die über- und untergeordnete Struktur der Organisation.
`unit@name`	Name der Abteilung oder des Referats.	Zeichenkette	Ja	Wird in Zielsystemen angezeigt und zur Bildung von Gruppennamen verwendet.
`unit@unitType`	Art der Einheit (z. B. „Kommunedirektør“, „Kommunalområde“, „Eining“, „Team“, „Ikkje tilsett“).	Zeichenkette	Nein	Kann in Regelsätzen verwendet werden, um Organisationsebenen zu unterscheiden. Siehe „Von Visma empfohlene Organisationsstruktur und deren Auswirkungen auf eADM“.
`unit@company`	Unternehmens-ID, zu der die Einheit gehört.	Ganzzahl	Nein	Wird beim Importieren von Daten aus mehreren Unternehmen verwendet.
`manager@id`, `manager@name`	Der Leiter der Abteilung.	Zeichenkette	Nein	Wird für die Suche nach Vorgesetzten, Genehmigungsabläufe sowie Benachrichtigungen zum Onboarding und Offboarding verwendet.
`tasks/task`	Eine benannte Aufgabe (z. B. „Attesterar“, „Godkjenne fråvær“), der Mitarbeiter und optional ein Vorgesetzter zugewiesen sind.	Zeichenkette	Nein	Wird verwendet, um aufgabenbezogene Zugriffsrechte, wie beispielsweise Genehmigungs- oder Rechnungsstellungsrechte, unabhängig von der formellen Position zu gewähren.
`roles/role`	Eine benannte Rolle (z. B. „Leiar“, „BI-Zugriff“), der Mitarbeiter und optional ein Vorgesetzter zugewiesen sind.	Zeichenkette	Nein	Wird verwendet, um rollenspezifische Zugriffsrechte unabhängig von der formellen Position zu gewähren.
`contactInfo/*`	Postanschrift, Besuchsadresse, Telefonnummer und E-Mail-Adresse der Abteilung.	Zeichenkette	Nein	In der Praxis meist leer; wird selten verwendet.

Das Attribut „QualificationCode“ verstehen

In HR-Systemen wie Visma Enterprise ist ein Qualifikationscode eine standardisierte Kennung, mit der die formale Ausbildung, Lizenzen und Fähigkeiten eines Mitarbeiters erfasst werden.

Anstatt Freitext einzugeben, verwendet die Personalabteilung diese einheitlichen Codes, damit das System die Daten automatisch für drei Hauptzwecke nutzen kann:

Lohnabrechnung und Tarife: Verknüpfungen zu Stellencodes, um eine korrekte Einstufung in die Gehaltsstufe zu gewährleisten (z. B. führt die Erfassung eines neuen Abschlusses automatisch dazu, dass der Mitarbeiter für eine Gehaltserhöhung vorgemerkt wird).
Ressourcenmanagement: Ermöglicht es Führungskräften, auf einfache Weise nachzuverfolgen, wer zur Ausübung bestimmter Aufgaben berechtigt ist (z. B. zu überprüfen, wer über eine gültige Zulassung im Gesundheitswesen oder einen gültigen Befähigungsnachweis für den Umgang mit schweren Maschinen verfügt).
Berichterstattung und Compliance: Liefert einheitliche Daten für die interne Kompetenzkartierung und die gesetzlich vorgeschriebene Berichterstattung an Behörden (z. B. an Statistics Norway).

Typische Beispiele: „Bachelor-Abschluss“, „HPR-Zulassung (Gesundheitswesen)“ oder „Erste-Hilfe-Zertifikat“.

Zuletzt aktualisiert: 20. Juli 2026