Resurs: getemployee.nv
HTTP-metod: GET
Resursen returnerar en löntagare
Parametrar som används i anropet:
Parameter | Förekomster | Exempel | Beskrivning |
netvisorkey | 0...1 | 1 | Löntagarens netvisorkey, om angiven ange inte parametern employeenumber |
employeenumber | 0...1 | 100 | Löntagarens nummer, om angiven ange inte parametern netvisorkey |
employmentperiods | 0...1 | 1 = ja | |
0 = nej | Anges om löntagarens anställningar ska hämtas. Hämtas inte om det inte är definierat. | ||
employeepayrollinformation | 0...1 | 1 = ja | |
0 = nej | Anges om löntagarens löneberäkningsuppgifter ska hämtas. Hämtas inte om det inte är definierat. | ||
educationalinformation | 0...1 | 1 = ja | |
0 = nej | Anges om löntagarens utbildningsinformation ska hämtas. Hämtas inte om det inte är definierat. | ||
additionalinformationfields | 0...1 | 1 = ja | |
0 = nej | Anges om löntagarens tilläggsinformationsfält ska hämtas. Hämtas inte om det inte är definierat. | ||
employeesettlementpoints | 0...1 | 1 = ja | |
0 = nej | Anges om löntagarens redovisningsenheter ska hämtas. Hämtas inte om det inte är definierat. |
Svar:
| Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
| --- | --- | --- | --- | --- | --- |
| Root | root | Aggregat | 1 | | |
| 1 | employee | Aggregat | 1 | | |
| 2 | employeebaseinformation | Aggregat | 1...n | | |
| 3 | netvisorkey | Heltal | 1 | Löntagarens netvisorkey | 8 |
| 3 | employeenumber | Heltal | 1 | Löntagarens nummer | 123 |
| 3 | employeeidentifier | Sträng | 1 | Löntagarens identifieringstyp: finnishidentifier, foreignidentifier, companyidentifier | foreignidentifiertype |
| Attr. | foreignidentifiertype | Sträng | 1 | Identifieringstyp för en utländsk person: taxidentificationnumber, foreignpersonalidentifier, other. Om personen inte är utländsk returneras ingen typ. | taxidentificationnumber |
| 3 | issuingcountry | Sträng max 2 | 1 | Utländsk persons land. | |
| Attr. | type | Sträng | 1 | Datatyp för landsuppgiften | ISO-3166 |
| 3 | firstname | Sträng max 50 | 1 | Löntagarens förnamn | Anna |
| 3 | lastname | Sträng max 50 | 1 | Löntagarens efternamn | Ammattilainen |
| 3 | fullname | Sträng | 1 | Löntagarens fullständiga namn | Ammattilainen Anna |
| 3 | payrollservice | Heltal | 1 | Löneberäkningstjänst | 1 = ja 0 = nej |
| 3 | resourcemanagement | Heltal | 1 | Resor | 1 = ja 0 = nej |
| 3 | lunchbenefit
| Heltal | 1 | Lunchförmån i bruk | 1 = ja 0 = nej |
| 3 | nationality | Sträng, max. 2 | 1 | Löntagarens medborgarskap, standard fi | se |
| Attr. | type | Sträng | 1 | Sträng | ISO-3166 |
| 3 | language | Sträng, max. 2 | 1 | Löntagarens språk, standard fi | |
| Attr. | type | Sträng | | Datatyp för språkuppgiften | ISO-3166 |
| 3 | municipality | Sträng, max. 255 | 1 | Löntagarens hemkommun | Lappeenranta |
| 3 | gender | Sträng | 1 | Kön: male, female | male |
| 3 | dateofbirth | Datum | 1 | Födelsedatum | 1970-10-20 |
| 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 | country | Sträng, max. 2 | 1 | Löntagarens hemlandskod | fi |
| Attr. | type | Sträng | 1 | Datatyp för landsuppgiften | ISO-3166 |
| 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] |
| 3 | bankaccountnumber | Sträng, max. 34 | 1 | Löntagarens bankkontonummer, IBAN-kontonummer | FI71 7997 9580 0073 35 |
| 3 | bankidentificationcode | Sträng. max. 20 | 1 | Bankens BIC-kod | NDEAFIHH |
| 3 | activity | Heltal | | Löntagarens aktivitet. Detta ska inte blandas ihop med om löntagaren för närvarande har en aktiv anställning. | 1 = ja
0 = nej |
| 2 | employmentperiods | Aggregat | 0...1 | Anställningar | |
| 3 | employmentperiod | Aggregat | 0...n | Anställning | |
| 4 | netvisorkey | Heltal | 1 | Anställningens identifierare | 3 |
| 4 | companystartdate | Datum | 1 | Startdatum för en sammanhängande anställning | 2017-01-01 |
| Attr. | format | Sträng | 1 | Datumformat | ansi |
| | startdate | Datum | 1 | Startdatum | 2017-01-01 |
| Attr. | format | Sträng | 1 | Datumformat | ansi |
| 4 | probationenddate | Datum | 1 | Provanställningens slutdatum | 2017-04-01 |
| Attr. | format | Sträng | 1 | Datumformat | ansi |
| 4 | employmentmode | Heltal | 1 | Anställningsform | 1 = anställd
2 = uthyrd arbetstagare
3 = yrkesutövare eller motsvarande
4 = praktikant
5 = talkoarbete |
| Attr. | type | Sträng | 1 | Länkningstyp för anställningen | Attributet type är alltid netvisor,
alltså Netvisors identifierare |
| 4 | profession | Sträng, max. 250 | 1 | Yrkesbeteckning | Testare |
| 4 | comment | Sträng, max. 500 | 1 | Kommentar | Ny kunnig typ |
| 4 | enddate | Datum | 1 | Slutdatum | 2017-12-31 |
| Attr. | format | Sträng | 1 | Datumformat | ansi |
| 4 | endreason | Heltal | 1 | Orsak till avslut | 2=Arbetstagarens ålderspension
4=På arbetstagarens egen begäran
5=Orsak som beror på arbetstagaren
6=Tidsbegränsad anställning
11=Företagets produktionsmässiga och ekonomiska orsaker
12=Anställningen avslutas genom ömsesidigt avtal
13=Annan orsak
(Följande har tagits ur bruk:
1 = Normal anställningens upphörande
3 = Arbetstagarens död
7 = Anställningen upphör under prövotid
8 = Anställningens upplösning
9 = Företagets konkurs
10 = Byte av företagsägare) |
| Attr. | type | Sträng | 1 | Länkningstyp för avslutet | Attributet type är alltid netvisor,
alltså Netvisors identifierare |
| 4 | occupationclassification | Sträng | 1 | Yrkesklass | Yrkesklassens TK10-kod |
| Attr. | type | Sträng | 1 | Länkningstyp | Attributet type är alltid isco |
| 4 | employmentcontract | Heltal | 1 | Anställningens giltighet | 1 = Giltig tills vidare
2 = Tidsbegränsad |
| Attr. | type | Sträng | 1 | Länkningstyp | Attributet type är alltid netvisor,
alltså Netvisors identifierare |
| 4 | employmentform | Heltal | 1 | Anställningens typ | 1 = Heltid
2 = Deltid |
| Attr. | type | Sträng | 1 | Länkningstyp | Attributet type är alltid netvisor,
alltså Netvisors identifierare |
| 4 | parttimepercent | Deltidsprocent | 1 | Deltidsprocent | Decimaltal mellan 0-100 |
| 4 | regularworkinghours | Heltal | 1 | Ordinarie arbetstid | Decimaltal mellan 0-168 |
| 4 | groundsforemployment | Heltal | 1 | Grund för anställning | 0=Annan grund
1=Anställnings- eller tjänsteförhållande |
| 4 | kevaprofessionalclasscode | Heltal | 1 | Keva yrkesklasskod, max 20 tecken | Keva: Ammattinimikkeiden haku |
| 4 | kevaemploymentregistration | Heltal | 1 | Keva registrering av tjänsteförhållande, max 2 tecken. | Keva: Tulorekisterin koodisto |
| Attr. | type | Sträng | 1 | alltid keva | keva |
| Attr. | pensionprovidercode | Heltal | 1 | Arbetspensionsanstaltens bolagskod. | Keva: Tulorekisterin koodisto |
| 4 | ispaymenttypemonthlywage | Heltal | 1 | Löneform: Månadslön | 1=ja
0=nej |
| 4 | ispaymenttypehourlywage | Heltal | 1 | Löneform: Timlön | 1=ja
0=nej |
| 4 | ispaymenttypepiecewage | Heltal | 1 | Löneform: Ackord | 1=ja
0=nej |
| 4 | collectiveagreement | Heltal | 1 | Kollektivavtal | Tulorekisteri: Koodistot |
| Attr. | pensionprovidercode | Sträng | 1 | alltid cbacode | cbacode |
| 4 | stateemploymentfund | Heltal | 1 | Sysselsatt med statliga sysselsättningsanslag | 1=ja
0=nej |
| 4 | carbenefityear | Heltal | 1 | Bilförmånsbilens ibruktagningsår | 2012 |
| 4 | isabroadcarbenefit | Heltal | 1 | Bilförmån har erhållits utomlands | 1=ja
0=nej |
| 4 | caremissionvalue | Heltal | 1 | Bilens utsläppsvärde | Värde mellan 0-100 |
| 4 | workercategory | Aggregat | 1 | Arbetstagarkategori för lönetransparensrapportering | |
| 4 | name | Sträng | 1 | Gruppens namn | Testgrupp |
| 2 | employeepayrollinformation | Aggregat | 0...1 | Löneberäkningsuppgifter | |
| 3 | payrollrulegroup | Aggregat | 1 | Lönemodell | |
| 4 | netvisorkey | Heltal | 1 | Lönemodellens netvisorkey | 2 |
| 4 | name | Sträng | 1 | Löntagarens lönemodells namn | Månadslönade |
| 3 | taxnumber | Heltal | 1 | Skattenummer | 123456789101 |
| 3 | foreclosure | Heltal | 1 | Utsökning | 1=ja
0=nej |
| 3 | foreclosuremaintenancepersons | Heltal | 1 | Antal personer i underhåll vid utsökning | 3 |
| 3 | nosocialsecuritypayment | Heltal | 1 | Underlag för Arbetsgivarens sjukförsäkringsavgift | 1=ja
0=nej |
| 3 | accountingaccount | Aggregat | 1 | Förskottsskuldskonto | |
| 4 | netvisorkey | Heltal | 1 | Identifierare för förskottsskuldskonto | |
| 4 | name | Sträng | 1 | Namn på förskottsskuldskontot | Fordringar hos arbetstagare |
| 4 | number | Heltal | 1 | Förskottsskuldskontots nummer | 1751 |
| 3 | hierarchy | Aggregat | 1 | Hierarkisk nivå | |
| 4 | netvisorkey | Heltal | 1 | Identifierare för hierarkisk nivå | 4 |
| 4 | name | Sträng | 1 | Namn på hierarkisk nivå | Oy Yritys Ab |
| 3 | placeofbusiness | Sträng | 1 | Verksamhetsställe till inkomstregistret | Huvudkontor |
| 3 | defaultdimensions | Aggregat | 0...1 | Standardkostnadsobjekt | |
| 4 | defaultdimension | Aggregat | 0...n | Standardkostnadsobjekt | |
| 5 | dimensionname | Sträng | 1 | Namn på kostnadsobjektets rubrik. | Kostnadsställen |
| 5 | dimensionitem | Sträng | 1 | Kostnadsobjektets namn.
Om ett kostnadsobjekt har en identifierare returneras ett kombinationsnamn, dvs. identifierare + namn, t.ex. "P001 Verkkosivuston uudistus" | DevOps |
| 5 | dimensionitemname | Sträng
| 0...1 | Kostnadsobjektets namn | Verkkosivuston uudistus |
| 5 | dimensionitemcode | Sträng | 0...1 | Kostnadsobjektets identifierare | P001 |
| 3 | payslipdeliverymethod | Sträng | 1 | Lönespecifikationens leveranssätt | 1 = lokal utskrift
2 = utskriftstjänst
3 = e-lön |
| 3 | type | Sträng | 1 | Länkningstyp för leveranssättet | Attributet type är alltid netvisor,
alltså Netvisors identifierare |
| 3 | isjointowner | Heltal | 1 | Delägare i förhållande till betalaren | 1=ja
0=nej |
| 3 | isathlete | Heltal | 1 | Idrottare | 1=ja
0=nej |
| 3 | isperformingartist | Heltal | 1 | Uppträdande konstnär | 1=ja
0=nej |
| 3 | employeeinsurancetype | Heltal | 1 | Typ av arbetspensionsförsäkring | 1=Tyel
2=MYEL
3=YEL
4=Inte pensionsförsäkrad |
| 3 | ispersonworkingonaroadferryonalandislands | Heltal | 1 | Person som arbetar på en landsvägsfärja på Åland | 1=ja
0=nej |
| 3 | isentrepreneurwithoptionalyelormyel | Heltal | 1 | Företagare | 1=ja
0=nej |
| 3 | receivessalaryfromdiplomaticembassy
| Heltal
| 1 | Person som får lön från en diplomatisk representation
| 1=ja
0=nej
|
| 3 | ispersonreceivingeppoinsurancesalary
| Heltal | 1 | Person som får försäkringslön enligt EPPO-lagen
| 1=ja
0=nej
|
| 3 | isinvoicingserviceuserwithoutbusinessid
| Heltal | 1 | Fakturerande person som inte har fo-nummer | 1=ja
0=nej
|
| 2 | employeeeducationalinformation | Aggregat | 0...1 | Examen | |
| 3 | degree | Aggregat | 0...n | Examen | |
| 4 | name | Sträng | 1 | Examens namn | Merkonom |
| 4 | school | Heltal | 1 | Läroanstalt | Handelsläroverk |
| 4 | graduationyear | Heltal | 1 | Utexamineringsår | 2021 |
| 4 | isprimarydegree | Heltal | 1 | Huvudexamen | 1=ja
0=nej |
| 2 | employeeadditionalinformationfields | Aggregat | 0...1 | Tilläggsinformationsfält | |
| 3 | additionalinformationfield | Aggregat | 0...n | Tilläggsinformationsfält | |
| 4 | netvisorkey | Heltal | 1 | Heltal | 1 |
| 4 | name | Sträng | 1 | Namn på tilläggsinformationsfältet | Födoämnesallergier |
| 4 | value | Sträng | 1 | Värde på tilläggsinformationsfältet | fisk |
| Attr. | type | Sträng | 1 | text, datetime | text |
| 4 | group | Sträng | 1 | 1=Basinformation
2=Kontaktinformation
3=Utbildningsinformation | 1 |
| Attr. | type | Sträng | 1 | Attributet type är alltid netvisor, alltså Netvisors identifierare | netvisor |
| 2 | employeesettlementpoints | Aggregat | 0...1 | Redovisningsenheter | |
| 3 | employeeunemploymentinsurance | Aggregat | 0...n | Arbetslöshetsförsäkring | |
| 4 | netvisorkey | Heltal | 1 | Redovisningsenhetens identifierare | 1 |
| 4 | type | Sträng | 1 | Behandling av redovisningsenhet | automatichandling=
Automatisk behandling
under17yearsold=Under 17 år
17to64yearsold=17-64 år
over65yearsold=över 65 år
partowner=delägare |
| 4 | name | Sträng | 1 | Försäkringsspecifik redovisningsenhet | Arbetslöshetsförsäkring |
| 3 | employeeaccidentinsurance | Aggregat | 0...n | Olycksfallsförsäkring | |
| 4 | netvisorkey | Heltal | 1 | Redovisningsenhetens identifierare | 2 |
| 4 | type | Sträng | 1 | Behandling av redovisningsenhet | attachedtosettlementpoint |
| 4 | name | Sträng | 1 | Försäkringsspecifik redovisningsenhet | Försäkringsspecifik redovisningsenhet |
| 3 | employeegrouplifeinsurance | Aggregat | 0...n | Gruppensionsförsäkring | |
| 4 | netvisorkey | Heltal | 1 | Redovisningsenhetens identifierare | 3 |
| 4 | type | Sträng | 1 | Behandling av redovisningsenhet | attachedtosettlementpoint |
| 4 | name | Sträng | 1 | Försäkringsspecifik redovisningsenhet | Gruppensionsförsäkring |
| 3 | employeeunionmembershipfee | Aggregat | 0...n | Fackföreningsavgift | |
| 4 | netvisorkey | Heltal | 1 | Redovisningsenhetens identifierare | 4 |
| 4 | type | Sträng | 1 | Behandling av redovisningsenhet | attachedtosettlementpoint |
| 4 | name | Sträng | 1 | Försäkringsspecifik redovisningsenhet | Fackföreningsavgift |
| 3 | employeeotherinsurance | Aggregat | 0...n | Annan försäkring | |
| 4 | netvisorkey | Heltal | 1 | Redovisningsenhetens identifierare | 5 |
| 4 | type | Sträng | 1 | Behandling av redovisningsenhet | attachedtosettlementpoint |
| 4 | name | Sträng | 1 | Försäkringsspecifik redovisningsenhet | Annan försäkring |
| 3 | employeeworkpensioninsurance | Aggregat | 0...n | Arbetspensionsförsäkring | |
| 4 | netvisorkey | Heltal | 1 | Redovisningsenhetens identifierare | |
| 4 | type | Sträng | 1 | Behandling av redovisningsenhet | automatichandling=
Automatisk behandling
under17yearsold=Under 17 år
17to52yearsold=17-52 år
53to62yearsold=53-62 år
63to67yearsold=63-67 år
over68yearsold=över 68 år |
| 4 | name | Sträng | 1 | Försäkringsspecifik redovisningsenhet | TyEL |
| 3 | employeeforeclosure | Aggregat | 0...n | Utsökning | |
| 4 | netvisorkey | Heltal | 1 | Heltal | 6 |
| 4 | type | Sträng | 1 | Behandling av redovisningsenhet | attachedtosettlementpoint |
| 4 | name | Sträng | 1 | Försäkringsspecifik redovisningsenhet | Utsökning |
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.
