Opas Visma Enterprise -tietojen tuontiin

Tässä asiakirjassa kuvataan yksityiskohtaisesti ne kentät, jotka sisältyvät XML-perustietotiedostoon, jonka eADM tuo Visma Enterprise HRM:stä (VEP). Asiakirja on tarkoitettu integroinnin määrittämisestä ja ylläpidosta vastaavalle tekniselle henkilöstölle.

Tiedosto toimitetaan muodossa <personsXML> asiakirja, joka sisältää yhden <person> elementti työntekijää kohden. Jokaisessa henkilötietueessa on henkilöllisyystiedot, yhteystiedot sekä yksi tai useampi <employment> tiedot, joissa kuvataan työntekijän tehtävät, organisaatiossa oleva asema ja palkkaus.

Varoitus: Lähdetiedosto voi sisältää luottamuksellisia tietoja, kuten palkkatietoja, verotietoja, pankkitilinumeroita ja huollettavien tietoja. Tutustu oppaaseen ”Tuontitietojen suodattaminen ja muokkaaminen” ennen suodattamattoman tiedoston tuomista ja poista kaikki elementit, joita integraatio ei vaadi.

Työntekijän tiedot

Esimerkki työntekijän tiedoista

Alla on nimettömäksi muokattu esimerkki <person> yksittäistä työntekijää koskeva tieto. Kaikki tunnistettavat tiedot (nimi, henkilötunnus, yhteystiedot, organisaationumero) on korvattu paikkamerkillä.

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>

Huom: Yhdellä henkilöllä voi olla useita <employment> tietueita (esim. yksi kutakin työnantajaa kohti moniyritysrakenteessa), ja jokaisessa työsuhteessa voi olla useita <position> tietueet. Jokaisesta työsuhteesta on merkitty vain yksi tehtävä isPrimaryPosition="true".

Tunnistetiedot, todennus ja yhteystiedot

XML-polku	Kuvaus	Tietotyyppi	Pakollinen	Käyttö
`person@personIdHRM`	Visma Enterprise -järjestelmän sisäinen henkilötunnus.	Kokonaisluku	Kyllä	Tunnistaa henkilötietueen yksilöllisesti; sitä käytetään lähdeavaimena tietojen täsmäyttämisessä synkronoinnin aikana.
`ssn`	Norjan henkilötunnus (fødselsnummer).	merkkijono	Kyllä	Ensisijainen tunniste, jota käytetään henkilön tunnistamiseen eADM-, Active Directory- ja Feide-järjestelmissä.
`givenName` / `familyName`	Etunimi ja sukunimi.	merkkijono	Kyllä	Käytetään näyttönimien ja sähköpostiosoitteiden muodostamiseen kohdejärjestelmissä.
`authentication/username`	Kirjautumiseen rekisteröity täydellinen nimi.	merkkijono	Ei	Viitekenttä; ei yleensä käytetä suoraan.
`authentication/alias`	Käyttäjätunnuksen lempinimi.	merkkijono	Ei	Voidaan käyttää kohdejärjestelmän käyttäjätunnuksen ehdokasarvona (esim. `sAMAccountName`).
`dateOfBirth`	Syntymäaika.	Päivämäärä	Ei	Voidaan käyttää ikään perustuvissa sääntöjoukoissa.
`genderCode`	Sukupuoli (`MALE` / `FEMALE`).	merkkijono	Ei	Käytetään harvoin pääsyoikeussäännöissä.
`careerInfo/jobTitle`	Vapaamuotoinen työnimike.	merkkijono	Ei	Voidaan viedä kohdejärjestelmiin kuvaavana otsikkona; sitä ei käytetä pääsynvalvontaan.
`contactInfo/email`, `privateEmail`	Työ- ja yksityinen sähköpostiosoite.	merkkijono	Ei	Käytetään ilmoitusprosesseissa, erityisesti ennen kuin työtili on luotu.
`contactInfo/workPhone`, `privateMobilePhone`	Työ- ja yksityispuhelinnumerot.	merkkijono	Ei	Käytetään hakemistojen synkronoinnissa ja ilmoitusvirroissa.
`postalAddress`	Kotiosoite.	merkkijono	Ei	Käytetään harvoin; harkitse sen poistamista (katso yllä oleva varoitus).

Työ- ja tehtäväkentät

XML-polku	Kuvaus	Tietotyyppi	Pakollinen	Käyttö
`employment/employeeId`	Tämän nimenomaisen työsuhteen henkilöstönumero.	Kokonaisluku	Kyllä	Yhdellä henkilöllä voi olla useita työpaikkoja; tämä tunnistaa kunkin työpaikan yksilöllisesti.
`employment/category`	Työluokan koodi ja kuvaus (esim. `F3` / "Lisää nopeasti laajennus").	merkkijono	Ei	Erottaa toisistaan vakituisen, määräaikaisen ja tuntipalkkaisen työsuhteen; käytetään sääntöjoukoissa.
`employment/company`	Työnantaja (nimi ja organisaationumero).	merkkijono	Ei	Käytetään, kun tuodaan tietoja useista yrityksistä (katso ”Tietojen tuominen useista yrityksistä”).
`employment/employmentPercentage`	Kaikkien tehtävien yhteenlaskettu työllisyysprosentti.	Desimaali	Ei	Käytetään erottamaan kokopäivätyö osa-aikatyöstä.
`position@isPrimaryPosition`	Merkitsee ensisijaista sijaintia.	Boolen	Kyllä	Määrittää, mikä tehtävä määrittää käyttäjän päätilin, osaston ja esimiehen. Katso kohta ”Tehtäväsuodattimen käyttö”.
`position/chart/unit`	Organisaatioyksikkö, johon toimi kuuluu.	Merkkijono / Tunnus	Kyllä	Käytetään käyttäjän sijoittamiseen organisaation hierarkiassa ja ryhmäjäsenyyksien määrittämiseen.
`position/chart/unit/manager`	Yksikön linjajohtaja.	Merkkijono / Tunnus	Ei	Käytetään esimiehen hakuihin, hyväksymisprosesseihin sekä työsuhteen aloittamista ja päättymistä koskeviin ilmoituksiin.
`position/positionInfo/positionCode`	Sisäinen tehtäväkoodi ja nimike.	merkkijono	Ei	Käytetään roolipohjaiseen pääsynhallintaan.
`position/positionInfo/positionType`	Toimenkuva- tai työsuhdekoodi (esim. `F` "Nopea" [pysyvä], `PF` "Foreldrepermisjon" [vanhempainvapaa], `PU` "Perm u/lønn" [palkaton loma], `V` "Vikar" [tilapäinen sijainen]).	merkkijono	Ei	eADM-tietueiden lähdekenttä `QualificationCode` attribuutti. Katso kohta ”QualificationCode-attribuutin selitys” jäljempänä.
`position/positionInfo/publicPositionCode`	Lakisääteinen asemakoodi (KS-tariffi, ”KSSKODE”).	merkkijono	Ei	Käytetään tariffipohjaisissa säännöissä ja lakisääteisessä raportoinnissa.
`position/positionPercentage`	Tämän tietyn tehtävän osuus prosentteina.	Desimaali	Ei	Käytetään sijaintisuodattimissa. Katso kohta ”Sijaintisuodattimen käyttö”.
`position/positionStartDate`, `positionEndDate`, `@validFromDate`	Tehtävän voimassaoloajat.	Päivämäärä	Ei	Käytetään kyseiseen tehtävään liittyvän käyttöoikeuden aktivoimiseen ja deaktivoimiseen.
`position/costCentres/dimensionX`	Kustannuspaikka / budjettidimensio.	merkkijono	Ei	Käytetään organisaation raportointiin; käytetään harvoin pääsynvalvontaan.
`position/leave`	Lomakausi, lomatyyppi ja prosenttiosuus.	Merkkijono / Päivämäärä	Ei	Tätä voidaan käyttää käyttöoikeuden keskeyttämiseen tai muuttamiseen pitkäaikaisen poissaolon aikana.

Palkkaus-, vero- ja tilastoalat

XML-polku	Kuvaus	Tietotyyppi	Pakollinen	Käyttö
`position/salaryInfo/basicSalary`, `yearlySalary`	Palkkatiedot.	Desimaali	Ei	Ei käytetä pääsynhallintaan. Erittäin herkkä; suositellaan suodatettavaksi pois ennen tuontia (katso yllä oleva varoitus).
`position/positionStatistics/workClassification`	Vakiintunut ammattiluokitus (STYRK).	merkkijono	Ei	Käytetään lakisääteiseen tilastoraportointiin, ei kulunvalvontaan.
`statistics/paiEducation`	Ilmoitettu koulutustaso (PAI / SSB-koulutuskoodi).	merkkijono	Ei	Lakisääteinen raportointikenttä; erillinen käsite eADM:n kentistä `QualificationCode` attribuutti, katso alla.
`employment/taxDetails`	Veronpidätystiedot (verokortti, prosenttiosuus).	Merkkijono / Desimaali	Ei	Herkkä; eADM ei käytä tätä. Suositellaan suodatettavaksi pois.
`dependents/dependent`	Palkka- tai vakuutustarkoituksessa rekisteröidyt perheenjäsenet.	merkkijono	Ei	Herkkä tieto; suositellaan suodatettavaksi pois, ellei sitä nimenomaisesti vaadita.

Organisaation hierarkia

Organisaatiorakenne toimitetaan erillään henkilöstötiedoista, nimittäin <charts> tiedosto, joka sisältää yhden <chart> elementti, jossa on tasainen luettelo <unit> elementit. Jokainen yksikkö viittaa yläelementtiinsä, joten hierarkia rakennetaan uudelleen tuovassa järjestelmässä sen sijaan, että se olisi sisäkkäin XML-koodissa.

Esimerkki organisaatiotiedoista

Alla on nimettömäksi tehty esimerkki, jossa näkyy ylätason yksikkö ja yksi sen alayksiköistä.

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>

Huom: Ylimmän tason virkamiehellä (tässä tapauksessa ”Kommunedirektør”) on parentid="0". Joka toisen yksikön parentid viittaa koodi emoyhtiönsä, ei emoyhtiön id. Näiden kahden ominaisuuden sekoittaminen on yleinen syy hierarkiaan liittyviin virheisiin; katso ”Visman suosittelema organisaatiorakenne ja sen vaikutus eADM:ään”.

Organisaatioiden toiminta-alueiden kuvaukset

XML-polku	Kuvaus	Tietotyyppi	Pakollinen	Käyttö
`chart@id`, `chart@name`	Organisaatiokaavion tunniste ja nimi (yleensä kunta tai yritys).	Kokonaisluku / Merkkijono	Kyllä	Tuodun hierarkian juuritaso.
`unit@id`	Visma Enterprise -järjestelmän sisäinen yksikkötunnus.	merkkijono	Kyllä	Ottelut `position/chart/unit@id` henkilöstötiedostossa, jota käytetään työntekijöiden sijoittamiseen hierarkiaan.
`unit@kode`	Yksikön lyhyt numeerinen koodi.	Kokonaisluku	Kyllä	Viitataan alayksiköistä `parentid` hierarkian rakentamiseksi. Katso yllä oleva huomautus.
`unit@parentid`	The `kode` emoyksikön (`0` (ylimmän tason yksikön osalta).	Kokonaisluku	Kyllä	Luo organisaation hierarkkisen rakenteen.
`unit@name`	Osaston tai yksikön nimi.	merkkijono	Kyllä	Näytetään kohdejärjestelmissä ja niitä käytetään ryhmien nimien muodostamiseen.
`unit@unitType`	Yksikön tyyppi (esim. ”Kommunedirektør”, ”Kommunalområde”, ”Eining”, ”Team”, ”Ikkje tilsett”).	merkkijono	Ei	Voidaan käyttää sääntöjoukoissa organisaatiotasojen erottelemiseen. Katso ”Visman suosittelema organisaatiorakenne ja sen vaikutus eADM:ään”.
`unit@company`	Yritystunnus, johon yksikkö kuuluu.	Kokonaisluku	Ei	Käytetään, kun tuodaan tietoja useilta yrityksiltä.
`manager@id`, `manager@name`	Yksikön johtaja.	merkkijono	Ei	Käytetään esimiehen hakuihin, hyväksymisprosesseihin sekä työsuhteen aloittamista ja päättymistä koskeviin ilmoituksiin.
`tasks/task`	Tehtävä, jolla on nimi (esim. ”Attesterar”, ”Godkjenne fråvær”) ja johon on määritetty työntekijät sekä tarvittaessa esimies.	merkkijono	Ei	Käytetään tehtäväkohtaisten käyttöoikeuksien myöntämiseen, kuten hyväksymis- tai laskutusvaltuuksiin, virallisesta asemasta riippumatta.
`roles/role`	Nimetty rooli (esim. ”Leiar”, ”BI-käyttöoikeus”), johon on määritetty työntekijöitä ja mahdollisesti myös esimies.	merkkijono	Ei	Käytetään roolikohtaisten käyttöoikeuksien myöntämiseen virallisesta asemasta riippumatta.
`contactInfo/*`	Yksikön postiosoite, vierailuosoite, puhelinnumero ja sähköpostiosoite.	merkkijono	Ei	Käytännössä yleensä tyhjä; käytetään harvoin.

QualificationCode-attribuutin ymmärtäminen

Visma Enterprise-kaltaisissa henkilöstöhallintojärjestelmissä pätevyyskoodi on standardoitu tunniste, jota käytetään työntekijän muodollisen koulutuksen, lupien ja osaamisen kirjaamiseen.

Sen sijaan, että kirjoitettaisiin vapaamuotoista tekstiä, henkilöstöhallinto käyttää näitä vakiintuneita koodeja, jotta järjestelmä voi hyödyntää tietoja automaattisesti kolmeen pääasialliseen tarkoitukseen:

Palkkahallinto ja palkkaluokat: Linkit työkoodeihin, joilla varmistetaan oikea palkkaluokitus (esim. uuden tutkinnon rekisteröinti merkitsee automaattisesti työntekijän palkankorotuksen kohteeksi).
Resurssienhallinta: Antaa johtajille mahdollisuuden seurata helposti, kenellä on valtuudet suorittaa tiettyjä tehtäviä (esim. tarkistaa, kenellä on voimassa oleva terveydenhuollon toimilupa tai raskaiden koneiden käyttöoikeus).
Raportointi ja säännösten noudattaminen: Tarjoaa puhtaita tietoja sisäistä osaamiskartoitusta ja lakisääteistä viranomaisraportointia (kuten Norjan tilastokeskukselle) varten.

Tyypillisiä esimerkkejä: ”kandidaatin tutkinto”, ”HPR-valtuutus (terveydenhuolto)” tai ”ensiapukoulutustodistus”.

Viimeksi päivitetty: 20. heinäkuuta 2026