Resurs: employee.nv
HTTP-metod: POST
Import eller redigering av löntagare. Se instruktioner för användning av resursen i slutet av tabellen.
Parametrar som används i anropet:
| Parameter | Förekomster | Exempel | Beskrivning |
| --- | --- | --- | --- |
| Method | 1 | Add | Typ av import, Add eller Edit |
| useonlyexistingdimensions
| 0...1 | 1 | Förhindrar automatisk skapning av nya kostnadsobjektrubriker och kostnadsobjekt. Returnerar ett fel om angivet kostnadsobjekt inte finns.
1=spärr aktiverad |
Vid redigering av löntagarens uppgifter används Method=Edit och som allokering används XML-meddelandets element employeeidentifier (finsk löntagare) eller identifier (utländsk löntagare).
Uppgifter som importeras skickas med anropet som xml enligt beskrivningen nedan (POST-data):
| Nivå | Element | Format och längd | Före-
komster | Beskrivning
| Exempel |
| --- | --- | --- | --- | --- | --- |
| Root | root | Aggregat | 1 | | |
| 1 | employee | Aggregat | 1 | | |
| 2 | employeebaseinformation | Aggregat | 1 | | |
| 3 | foreignemployeeidentification | Aggregat | 0..1 | Utländsk löntagare | Om elementet anges,
anges inte uppgiften employeeidentifier |
| 4 | identifier | Sträng | 1 | Identifieringsuppgift | 23011970 |
| Attr. | type | Sträng | 1 | Typ av identifieringsuppgift, tillåtna värden:
taxidentificationnumber
foreignpersonalidentifier
other
| foreignpersonalidentifier |
| 4 | issuingcountry | Sträng | 1 | Land | AF |
| Attr. | type | Sträng | 1 | Format på landsuppgift | ISO-3166 |
| 4 | gender | Sträng | 1 | Kön,
male
female | male |
| 4 | dateofbirth | Datum | 1 | Födelsedatum | 1970-10-20 |
| Attr. | format | Sträng | 1 | Datumformat | ansi |
| 3 | employeeidentifier | Sträng | 1 | Löntagarens finska personbeteckning | 010277-xxxp |
| 3 | companyidentifier | Sträng | 0..1 | Företagets FO-nummer,
När företag importeras som löntagare
| 0174564-5 |
| 3
| companyname | Sträng | 0..1 | Företagets namn | Testi Yritys |
| 3 | firstname | Sträng, max 50 | 1 | Löntagarens förnamn | Anna |
| 3 | lastname | Sträng, max 50 | 1 | Löntagarens efternamn | Ammattilainen |
| 3 | phonenumber | Sträng, max 50 | 1 | Löntagarens telefonnummer | 050 123 456 |
| 3 | email | Sträng, max 100 | 1 | Löntagarens e-postadress | [email protected] |
| 2 | employeepayrollinformation | Aggregat | 1 | | |
| 3 | streetaddress | Sträng, max 255 | 1 | Löntagarens gatuadress | Keisarinnankatu 1 |
| 3 | postnumber | Sträng, max 50 | 1 | Löntagarens postnummer | 56120 |
| 3 | city | Sträng, max 255 | 1 | Löntagarens postanstalt | Lappeenranta |
| 3 | municipality | Sträng, max 255 | 0..1 | Löntagarens hemkommun | Lappeenranta |
| 3 | country | Sträng, max 2 | 0..1 | Kod för löntagarens hemland, standard fi | fi |
| 3 | nationality | Sträng, max 2 | 0..1 | Löntagarens medborgarskap, standard fi | se |
| 3 | language | Sträng, max 2 | 0..1 | Språk som löntagaren använder, standard fi | fi |
| 3 | employeenumber | Numerisk, max 10 | 0..1 | Löntagarens individuella identifieringsnummer | 13
|
| 3 | profession | Sträng, max 255 | 0..1 | Löntagarens yrkesbeteckning | Testaaja |
| 3 | jobbegindate | Sträng, max 10 | 0..1 | Löntagarens anställnings startdatum | 2017-11-09 |
| Attr. | format | Sträng | | Startdatumets format, alltid ansi | ansi |
| 3 | payrollrulegroupname | Sträng, max 50 | 1 | Löntagarens lönemodells namn | Kuukausipalkkalaiset |
| 3 | bankaccountnumber | Sträng, max 34 | 0..1 | Löntagarens bankkontonummer, IBAN-kontonummer. Om endast bankkontonummer importeras beräknas BIC-koden utgående från kontonumret | FI71 7997 9580 0073 35 |
| 3 | bankidentificationcode | Sträng. max 20 | 0..1 | Bankens BIC-kod | NDEAFIHH |
| 3 | accountingaccountnumber | Numerisk | 0..1 | Löntagarens skuldkontonummer | 1751 |
| 3 | hierarchy | Sträng | 0..1 | Hierarkinivå | Oy Yritys Ab
|
| Attr. | type | Sträng | 1 | Hierarkins länkningstyp
| netvisor - Netvisors kod
eller
customer - Om identifiering sker med namn
måste det vara unikt
Läs om företagshierarki
|
| 3 | dimension | Aggregat | 0..n | | Standardkostnadsobjekt |
| 4 | dimensionname | Sträng | 1 | Kostnadsobjektrubrikens namn.
Skapas vid behov | Kustannuspaikat |
| 4 | dimensionitem | Sträng | 1 | Kostnadsobjektets namn.
Skapas vid behov | DevOps |
| 4 | code
| Sträng | 0...1 | Kostnadsobjektets kod | P001
När angiven åsidosätter den befintligt dimensionitem-fält.
|
| 4 | displayname
| Sträng | 0...1 | Kostnadsobjektets namn | Verkkosivuston uudistus
När angiven åsidosätter den befintligt dimensionitem-fält.
|
| Attr. | fatherid | Numerisk | 0..1 | Kostnadsobjektets "förälder" (parent)
kod. ID:n kan hämtas med denna resurs
| 1 |
| 3 | payslipdeliverymethod | Sträng | 0..1 | Lönespecifikationens leveranssätt | 1 = lokal utskrift
2 = utskriftstjänst
3 = e-lön |
| Attr. | type | Sträng | 1 | Leveranssättets länkningstyp
| Attributet type är alltid netvisor,
dvs Netvisors kod |
| 3 | isjointowner | Numerisk | 0..1 | Delägare i betalaren | 1=ja
0=nej |
| 3 | isathlete | Numerisk | 0..1 | Idrottare | 1=ja
0=nej |
| 3 | isperformingartist | Numerisk | 0..1 | Uppträdande konstnär | 1=ja
0=nej |
| 3 | employeeinsurancetype | Numerisk | 0..1 | Typ av arbetspensionsförsäkring | 1=Tyel
2=MYEL
3=YEL
4=Inte pensionsförsäkrad |
| 3 | ispersonworkingonaroadferryonalandislands | Numerisk | 0..1 | Person som arbetar på landsvägsfärja på Åland | 1=ja
0=nej |
| 3 | isentrepreneurwithoptionalyelormyel | Numerisk | 0..1 | Företagare utan skyldighet till YEL- eller MYEL-försäkring | 1=ja
0=nej
1 kan endast anges om employeeinsurancetype=4 |
| 3 | ispersonreceivingeppoinsurancesalary | Numerisk | 0..1 | Person som får försäkringslön enligt EPPO-lagen | 1=ja
0=nej |
| 3 | isinvoicingserviceuserwithoutbusinessid | Numerisk | 0..1 | Person som använder faktureringstjänst och saknar FO-nummer | 1=ja
0=nej |
| 3 | nosocialsecuritypayment | Numerisk | 0..1 | Inte underlag för arbetsgivarens sjukförsäkringsavgift | 1=ja
0=nej
Standard 0 |
| 3 | receivessalaryfromdiplomaticembassy | Numerisk | 0..1 | Person som får lön från diplomatisk beskickning | 1=ja
|
| 3 | activity | Numerisk | 0..1 | Aktivitet | 1=ja
0=nej
Standard 1 |
| 3 | foreclosure | Numerisk | 0..1 | Utsökning | 1=ja
0=nej
Standard 0 |
| 3 | foreclosuremaitenancepersons | Numerisk | 0..1 | Personer underhållsberättigade i utsökning | Måste anges om foreclosure = 1 |
| 3 | taxnumber | Sträng | 0..1 | Löntagarens skattenummer | 123456798912 |
| 3 | placeofbusiness | Sträng | 0..1 | Verksamhetsställe till inkomstregistret (namn) | Pääkonttori |
| 2 | employmentperiods | Aggregat | 0..1 | Anställningar | |
| 3 | employmentperiod | Aggregat | 1..n | Anställning | |
| 4 | companystartdate | Datum | 0..1 | Inträdesdag i sammanslutningen | 2017-01-01 |
| Attr. | format | Sträng | 1 | Datumformat | ansi |
| 4 | startdate | Datum | 1 | Startdatum | 2017-01-01 |
| Attr. | format | Sträng | 1 | Datumformat | ansi |
| 4 | probationenddate | Datum | 0..1 | Slutdatum för prövotid | 2017-04-01 |
| Attr. | format | Sträng | 1 | Datumformat | ansi |
| 4 | employmentmode | Numerisk | 0..1 | Anställningsform | 1 = anställd
2 = uthyrd arbetstagare
3 = yrkesutövare eller motsvarande
4 = praktikant
5 = talkoarbete |
| Attr. | type | Sträng | 1 | Anställningens länkningstyp
| Attributet type är alltid netvisor,
dvs Netvisors kod |
| 4 | profession | Sträng, max 250
| 1 | Yrkesbeteckning | Testaaja |
| 4 | comment | Sträng, max 500 | 0..1 | Kommentar | Uusi osaava tyyppi
|
| 4 | enddate | Datum | 0..1 | Slutdatum | 2017-12-31 |
| Attr. | format | Sträng | 1 | Datumformat | ansi |
| 4 | endreason | Numerisk | 0..1 | Orsak till avslut | 2=Arbetstagarens ålderspension
4=Arbetstagarens egen begäran
5=Orsak hänförlig till arbetstagaren
6=Tidsbunden anställning
11=Företagets produktions- och ekonomiska orsaker
12=Anställningens upphörande genom ömsesidigt avtal
13=Annan orsak
(Följande har utgått:
1 = Normal anställnings upphörande
3 = Arbetstagarens död
7 = Anställningens upphörande under prövotid
8 = Anställningens upplösning
9 = Företagets konkurs
10 = Ägarbyte i företag) |
| Attr. | type | Sträng | 1 | Länkningstyp för avslut
| Attributet type är alltid netvisor,
dvs Netvisors kod |
| 4 | occupationclassification | Sträng | 0..1 | Yrkesklass | Yrkesklassens TK10-kod |
| Attr. | type | Sträng | 1 | Länkningstyp | Attributet type är alltid isco
|
| 4 | employmentcontract | Numerisk | 0..1 | Anställningens giltighet | 1 = Gäller tills vidare
2 = Tidsbunden
Obs: för tidsbunden
anställning måste
slutdatum anges
|
| Attr. | type | Sträng | 1 | Länkningstyp | Attributet type är alltid netvisor,
dvs Netvisors kod |
| 4 | employmentform | Numerisk | 0..1 | Anställningens typ | 1 = Heltid
2 = Deltid
3 = uppgift ej tillgänglig |
| Attr. | type | Sträng | 1 | Länkningstyp | Attributet type är alltid netvisor,
dvs Netvisors kod |
| 4 | parttimepercent | Numerisk | 0..1 | Deltidsprocent | Tillåtet värde, decimaltal mellan 0-100
Avrundning till två decimaler
Obs: Elementet får inte anges om anställningstypen är annan än deltid. employmentform måste vara 2
|
| 4 | regularworkinghours | Numerisk | 0..1 | Regelbunden arbetstid | Tillåtet värde, decimaltal mellan 0-168
Avrundning till två decimaler |
| 4 | groundsforemployment | Numerisk | 0..1 | Grund för anställning | 0=Annat skäl
1=Anställning eller tjänsteförhållande |
| 4 | kevaprofessionalclasscode | Numerisk | 0..1 | Keva yrkesklasskod, max 20 tecken.
KEVA-uppgifter kan ges endast om företaget i löneberäkningens inställningar har ”Företagets arbetspensionsförsäkrare är Keva”. | Kevas yrkesklasskoder:
Keva: Ammattinimikkeiden haku |
| 4 | kevaemploymentregistration | Numerisk | 0..1 | Keva registrering av tjänsteförhållande, max 2 tecken. | Kevas registreringskoder:
Keva: Tulorekisterin koodisto |
| Attr. | type | Sträng | 1 | alltid keva | keva |
| Attr. | pensionprovidercode | Numerisk | 0..1 | Kod för arbetspensionsbolagets bolagsnummer. Om inte angiven används som standard
värdet ”20”.
Avgör vilka värden som godkänns i fältet
kevaemploymentregistration. | Värdet finns i KEVAs kodlista
Keva: Tulorekisterin koodisto
Vid felaktigt värde listas tillåtna värden.
|
| 4 | ispaymenttypemonthlywage | Numerisk | 0..1 | Löneform: Månadslön | 1=ja
0=nej |
| 4 | ispaymenttypehourlywage | Numerisk | 0..1 | Löneform: Timlön | 1=ja
0=nej |
| 4 | ispaymenttypepiecewage | Numerisk | 0..1 | Löneform: Ackord | 1=ja
0=nej |
| 4 | workercategory | Aggregat | 0..1 | Arbetstagargrupp. Arbetstagargrupp avser rapportering om lönetransparens. Instruktion finns här. | Hantering av arbetstagargrupper Lön > Inställningar > Löneberäkningens inställningar > Inställningar för lönetransparensrapportering > Hantering av arbetstagargrupper |
| 4 | name | Sträng | 0..1 | Arbetstagargruppen måste vara tillagd i Netvisor | Esimerkkiryhmä |
| 4 | collectiveagreement | Numerisk | 0..1 | Kollektivavtal | Inkomstregistrets koder för kollektivavtal:
Tulorekisteri: Koodistot |
| Attr. | type | Sträng | 1 | alltid cbacode | cbacode |
| 4 | stateemploymentfund | Numerisk | 0..1 | Sysselsatt med statliga sysselsättningsmedel | 1=ja
0=nej |
| 4 | carbenefityear | Numerisk | 0..1 | Bilförmånsbilens ibruktagningsår, max 4 tecken | 2012 |
| 4 | isabroadcarbenefit | Numerisk | 0..1 | Bilförmån har erhållits utomlands | 1=ja
0=nej |
| 4 | caremissionsvalue | Numerisk | 0..1 | Bilens utsläppsvärde, heltal mellan 0-100 | 85 |
| 2 | employeesettings | Aggregat | 0..1 | Löntagarens inställningar | |
| 3 | payrollservice | Sträng | 0..1 | Löneberäkningstjänst | enabled eller disabled |
| 3 | resourcemanagement | Sträng | 0..1 | Resurshantering | enabled eller disabled |
| 2 | employeesettlementpoints | Aggregat | 0..1 | Redovisningsenheter | |
| 3 | employeeworkpensioninsurance | Aggregat | 0..1 | Arbetspensionsförsäkring | |
| 4 | type | Sträng | 0..1 | Redovisningsenhetens hantering | nohandling=Ingen hantering
automatichandling=
Automatisk hantering
under17yearsold=Under 17 år
17to52yearsold=17-52 år
53to62yearsold=53-62 år
63to67yearsold=63-67 år
over68yearsold=över 68 år |
| 4 | name | Sträng | 0..1 | Försäkringsspecifik redovisningsenhet (* | TyEL |
| 3 | employeeunemploymentinsurance | Aggregat | 0..1 | Arbetslöshetsförsäkring | |
| 4 | type | Sträng | 0..1 | Redovisningsenhetens hantering | nohandling=Ingen hantering
automatichandling=
Automatisk hantering
under17yearsold=Under 17 år
17to64yearsold=17-64 år
over65yearsold=över 65 år
partowner=delägare |
| 4 | name | Sträng | 0..1 | Försäkringsspecifik redovisningsenhet (* | Työttömyysvakuutus |
| 3 | employeeaccidentinsurance | Aggregat | 0..1 | Olycksfallsförsäkring | |
| 4 | type | Sträng | 0..1 | Redovisningsenhetens hantering | nohandling eller attachedtosettlementpoint |
| 4 | name | Sträng | 0..1 | Försäkringsspecifik redovisningsenhet (*
| Tapaturmavakuutus
|
| 3 | employeegrouplifeinsurance | Aggregat | 0..1 | Gruppensionsförsäkring | |
| 4 | type | Sträng | 0..1 | Redovisningsenhetens hantering | nohandling eller attachedtosettlementpoint |
| 4 | name | Sträng | 0..1 | Försäkringsspecifik redovisningsenhet (* | Ryhmähenkivakuutus |
| 3 | employeeotherinsurance | Aggregat | 0..1 | Annan försäkring | |
| 4 | type | Sträng | 0..1 | Redovisningsenhetens hantering | nohandling eller attachedtosettlementpoint |
| 4 | name | Sträng | 0..1 | Försäkringsspecifik redovisningsenhet (* | Muu vakuutus |
| 3 | employeeunionmembershipfee | Aggregat | 0..1 | Fackföreningsavgift | |
| 4 | type | Sträng | 0..1 | Redovisningsenhetens hantering | nohandling eller attachedtosettlementpoint |
| 4 | name | Sträng | 0..1 | Försäkringsspecifik redovisningsenhet (* | Fackföreningsavgift |
| 3 | employeeforeclosure | Aggregat | 0..1 | Utmätning | |
| 4 | type | Sträng | 0..1 | Redovisningsenhetens hantering | nohandling eller attachedtosettlementpoint |
| 4 | name | Sträng | 0..1 | Försäkringsspecifik redovisningsenhet (* | Ulosotto |
| 2 | employeeeducationalinformation | Aggregat | 0..1 | Löntagarens utbildningsinformation | |
| 3 | degree | Aggregat | 0..n | Examen | |
| 4 | name | Sträng | 1 | Examens namn | Ylioppilas |
| 4 | school | Sträng | 1 | Skolans namn | Lyseon lukio |
| 4 | graduationyear | Numerisk | 1 | Utexamineringsår | 2022 |
| 4 | primarydegree | Numerisk | 1 | Huvudexamen | 1=ja
0=nej |
| 2 | employeeadditionalinformation | Aggregat | 0..1 | Löntagarens tilläggsinformation | |
| 3 | additionalinformationfield | Aggregat | 0..n | Löntagarens tilläggsinformation | |
| 4 | name | Sträng | 1 | Namn på tilläggsinformationsfältet | Allergiat |
| 4 | value | Sträng | 1 | Värde för tilläggsinformationsfältet | Kala |
*) Redovisningsenheter: Lön > Löneberäkning > Förpliktelser > Redovisningar
Att observera vid användning av resursen:
Redigering av löntagare är möjlig även när löntagarens anställning inte är i kraft
Resursen ställer inte in löntagarens semestersaldon. Detta ställs in i användargränssnittet.
För en enskild löntagare kan uppgiften uppdateras på löntagarens informationssida
För flera löntagare kan uppgiften sättas massvis i hantering av semesterrätt, Lön - Inställningar för semesterberäkning, där man väljer löntagare som ska behandlas och i menyn "Behandla valda" väljer "Ställ in regel för semestersaldo" samt önskad ackumuleringsregel
Om elementet employmentperiods är definierat måste minst en anställning importeras
Elementen startdate och profession är alltid obligatoriska
Om enddate är definierat är även endreason obligatorisk
Om elementet employmentperiods är definierat skriver anställningsuppgifterna över definitionerna i employeepayrollinformation
Om elementet employmentperiods inte är definierat bestäms löntagarens anställning via employeepayrollinformation > profession och jobbegindate
Om anställningar importeras via gränssnittet raderas löntagarens eventuella befintliga anställningar
Om företag importeras som löntagare anges då inte individuella uppgifter för vanlig löntagare såsom:
employeeidentifier
firstname
lastname
elementet foreignemployeeidentification
Denna artikel har översatts med hjälp av ett AI-baserat översättningsverktyg. Innehållet eller formuleringen i dessa instruktioner kan avvika från dem i andra instruktioner eller i programvaran.