Siirry pääsisältöön

Yksittäisen palkansaajan nouto getemployee.nv

Resurssi: getemployee.nv

HTTP-metodi: GET

Resurssi palauttaa yhden palkansaajan

Kutsussa käytettävät parametrit:

Parametri

Ilmentymiä

Esimerkki

Kuvaus

netvisorkey

0...1

1

Palkansaajan netvisorkey, jos annettu älä anna parametria employeenumber

employeenumber

0...1

100

Palkansaajan numero, jos annettu älä anna parametria netvisorkey

employmentperiods

0...1

1 = kyllä
0 = ei

Haetaanko palkansaajan työsuhteet. Ei haeta jos ei ole määritelty.

employeepayrollinformation

0...1

1 = kyllä
0 = ei

Haetaanko palkansaajan palkanlaskennan tiedot. Ei haeta jos ei ole määritelty.

educationalinformation

0...1

1 = kyllä
0 = ei

Haetaanko palkansaajan koulutustiedot. Ei haeta jos ei ole määritelty.

additionalinformationfields

0...1

1 = kyllä
0 = ei

Haetaanko palkansaajan lisätietokentät. Ei haeta jos ei ole määritelty.

employeesettlementpoints

0...1

1 = kyllä
0 = ei

Haetaanko palkansaajan tilityspisteet. Ei haeta jos ei ole määritelty.

Vastaus:

Taso

Elementti

Muoto

Ilmentymiä

Kuvaus

Esimerkki

Root

root

Aggregaatti

1



1

employee

Aggregaatti

1



2

employeebaseinformation

Aggregaatti

1...n



3

netvisorkey

Kokonaisluku

1

Palkansaajan netvisorkey

8

3

employeenumber

Kokonaisluku

1

Palkansaajan numero

123

3

employeeidentifier

Merkkijono

1

Palkansaajan tunnisteen tyyppi: finnishidentifier, foreignidentifier, companyidentifier

foreignidentifiertype

Attr.

foreignidentifiertype

Merkkijono

1

Ulkomaalaisen henkilön tunnisteen tyyppi: taxidentificationnumber, foreignpersonalidentifier, other. Mikäli henkilö ei ole ulkomaalainen, ei tyyppiä tuoda.

taxidentificationnumber

3

issuingcountry

Merkkijono max 2

1

Ulkomaalaisen henkilön maa.


Attr.

type

Merkkijono

1

Maatiedon muoto

ISO-3166

3

firstname

Merkkijono max 50

1

Palkansaajan etunimi

Anna

3

lastname

Merkkijono max 50

1

Palkansaajan sukunimi

Ammattilainen

3

fullname

Merkkijono

1

Palkansaajan koko nimi

Ammattilainen Anna

3

payrollservice

Kokonaisluku

1

Palkanlaskentapalvelu

1 = kyllä 0 = ei

3

resourcemanagement

Kokonaisluku

1

Matkat

1 = kyllä 0 = ei

3

lunchbenefit

Kokonaisluku

1

Lounasetu käytössä

1 = kyllä 0 = ei

3

nationality

Merkkijono, maks. 2

1

Palkansaajan kansalaisuus, oletus fi

se

Attr.

type

Merkkijono

1

Merkkijono

ISO-3166

3

language

Merkkijono, maks. 2

1

Palkansaajan käyttämä kieli, oletus fi


Attr.

type

Merkkijono


Kielitiedon muoto

ISO-3166

3

municipality

Merkkijono, maks. 255

1

Palkansaajan asuinpaikkakunta

Lappeenranta

3

gender

Merkkijono

1

Sukupuoli: male, female

male

3

dateofbirth

Päivämäärä

1

Syntymäaika

1970-10-20

3

streetaddress

Merkkijono, maks. 255

1

Palkansaajan katuosoite

Keisarinnankatu 1

3

postnumber

Merkkijono, maks. 50

1

Palkansaajan postinumero

56120

3

city

Merkkijono, maks. 255

1

Palkansaajan postitoimipaikka

Lappeenranta

3

country

Merkkijono, maks. 2

1

Palkansaajan kotimaan koodi

fi

Attr.

type

Merkkijono

1

Maatiedon muoto

ISO-3166

3

phonenumber

Merkkijono, maks. 50

1

Palkansaajan puhelinnumero

050 123 456

3

email

Merkkijono, maks. 100

1

Palkansaajan sähköpostiosoite

3

bankaccountnumber

Merkkijono, maks. 34

1

Palkansaajan pankkitilinumero, IBAN-tilinumero

FI71 7997 9580 0073 35

3

bankidentificationcode

Merkkijono. maks. 20

1

Pankin BIC-koodi

NDEAFIHH

3

activity

Kokonaisluku


Palkansaajan aktiivisuus. Tätä ei pidä sekoittaa siihen, että onko palkansaajalla tällä hetkellä aktiivisista työsuhdetta.

1 = kyllä
0 = ei

2

employmentperiods

Aggregaatti

0...1

Työsuhteet


3

employmentperiod

Aggregaatti

0...n

Työsuhde


4

netvisorkey

Kokonaisluku

1

Työsuhteen tunniste

3

4

companystartdate

Päivämäärä

1

Yhtäjaksoisen työsuhteen alkupäivä

2017-01-01

Attr.

format

Merkkijono

1

Päivämäärän muoto

ansi


startdate

Päivämäärä

1

Alkamispäivä

2017-01-01

Attr.

format

Merkkijono

1

Päivämäärän muoto

ansi

4

probationenddate

Päivämäärä

1

Koeajan päättymispäivä

2017-04-01

Attr.

format

Merkkijono

1

Päivämäärän muoto

ansi

4

employmentmode

Kokonaisluku

1

Työsuhteen tapa

1 = työsuhteinen
2 = vuokratyöntekijä
3 = ammatinharjoittaja tai muu vastaava
4 = harjoittelija
5 = talkootyö

Attr.

type

Merkkijono

1

Työsuhteen linkitystyyppi

Attribuutti type on aina netvisor,
eli Netvisorin tunniste

4

profession

Merkkijono, maks. 250

1

Ammattinimike

Testaaja

4

comment

Merkkijono, maks. 500

1

Kommentti

Uusi osaava tyyppi

4

enddate

Päivämäärä

1

Päättymispäivä

2017-12-31

Attr.

format

Merkkijono

1

Päivämäärän muoto

ansi

4

endreason

Kokonaisluku

1

Päättymisen syy

2=Työntekijän vanhuuseläke
4=Työntekijän oma pyyntö
5=Työntekijästä johtuva syy
6=Työsuhteen määräaikaisuus
11=Yrityksen tuotannolliset ja taloudelliset syyt
12=Työsuhteen päättyminen yhteisestä sopimuksesta
13=Muu syy
(Seuraavat poistuneet käytöstä:
1 = Normaali työsuhteen päättyminen
3 = Työntekijän kuolema
7 = Työsuhteen päättyminen koeaikana
8 = Työsuhteen purkaminen
9 = Yrityksen konkurssi
10 = Yrityksen omistajan vaihtuminen)

Attr.

type

Merkkijono

1

Päättymisen linkitystyyppi

Attribuutti type on aina netvisor,
eli Netvisorin tunniste

4

occupationclassification

Merkkijono

1

Ammattiluokka

Ammattiluokan TK10-koodi

Attr.

type

Merkkijono

1

Linkitystyyppi

Attribuutti type on aina isco

4

employmentcontract

Kokonaisluku

1

Työsuhteen voimassaolo

1 = Toistaiseksi voimassa oleva
2 = Määräaikainen

Attr.

type

Merkkijono

1

Linkitystyyppi

Attribuutti type on aina netvisor,
eli Netvisorin tunniste

4

employmentform

Kokonaisluku

1

Työsuhteen tyyppi

1 = Kokoaikainen
2 = Osa-aikainen

Attr.

type

Merkkijono

1

Linkitystyyppi

Attribuutti type on aina netvisor,
eli Netvisorin tunniste

4

parttimepercent

Osa-aikaisuuden prosentti

1

Osa-aikaisuuden prosentti

Desimaaliluku väliltä 0-100

4

regularworkinghours

Kokonaisluku

1

Säännöllinen työaika

Desimaaliluku väliltä 0-168

4

groundsforemployment

Kokonaisluku

1

Työsuhteen peruste

0=Muu peruste
1=Työsuhde tai virkasuhde

4

kevaprofessionalclasscode

Kokonaisluku

1

Keva Ammattiluokan koodi, max 20 merkkiä

4

kevaemploymentregistration

Kokonaisluku

1

Keva Palvelusuhteen rekisteröinti, max 2 merkkiä.

Attr.

type

Merkkijono

1

aina keva

keva

Attr.

pensionprovidercode

Kokonaisluku

1

Työeläkelaitoksen yhtiötunnuksen koodi.

4

ispaymenttypemonthlywage

Kokonaisluku

1

Palkkauksen muoto: Kuukausipalkka

1=kyllä
0=ei

4

ispaymenttypehourlywage

Kokonaisluku

1

Palkkauksen muoto: Tuntipalkka

1=kyllä
0=ei

4

ispaymenttypepiecewage

Kokonaisluku

1

Palkkauksen muoto: Urakka

1=kyllä
0=ei

4

collectiveagreement

Kokonaisluku

1

Työehtosopimus

Attr.

pensionprovidercode

Merkkijono

1

aina cbacode

cbacode

4

stateemploymentfund

Kokonaisluku

1

Valtion työllisyysmäärärahoilla työllistetty

1=kyllä
0=ei

4

carbenefityear

Kokonaisluku

1

Autoetuauton käyttöönottovuosi

2012

4

isabroadcarbenefit

Kokonaisluku

1

Autoetu on saatu ulkomailla

1=kyllä
0=ei

4

caremissionvalue

Kokonaisluku

1

Auton päästöarvo

Arvo väliltä 0-100

2

employeepayrollinformation

Aggregaatti

0...1

Palkanlaskennan tiedot


3

payrollrulegroup

Aggregaatti

1

Palkkamalli


4

netvisorkey

Kokonaisluku

1

Palkkamallin netvisorkey

2

4

name

Merkkijono

1

Palkansaajan palkkamallin nimi

Kuukausipalkkalaiset

3

taxnumber

Kokonaisluku

1

Veronumero

123456789101

3

foreclosure

Kokonaisluku

1

Ulosotto

1=kyllä
0=ei

3

foreclosuremaintenancepersons

Kokonaisluku

1

Ulosotossa elatuksen varassa olevien henkilöiden määrä

3

3

nosocialsecuritypayment

Kokonaisluku

1

Työnantajan sairausvakuutusmaksun alainen

1=kyllä
0=ei

3

accountingaccount

Aggregaatti

1

Ennakon velkatili


4

netvisorkey

Kokonaisluku

1

Ennakon velkatilin tunniste


4

name

Merkkijono

1

Ennakon velkatilin nimi

Saamiset työntekijöiltä

4

number

Kokonaisluku

1

Ennakon velkatilin numero

1751

3

hierarchy

Aggregaatti

1

Hierarkiataso


4

netvisorkey

Kokonaisluku

1

Hierarkiatason tunniste

4

4

name

Merkkijono

1

Hierarkiatason nimi

Oy Yritys Ab

3

placeofbusiness

Merkkijono

1

Toimipaikka tulorekisteriin

Pääkonttori

3

defaultdimensions

Aggregaatti

0...1

Oletuslaskentakohteet


4

defaultdimension

Aggregaatti

0...n

Oletuslaskentakohde


5

dimensionname

Merkkijono

1

Laskentakohdeotsikon nimi.

Kustannuspaikat

5

dimensionitem

Merkkijono

1

Laskentakohteen nimi.

Jos laskentakohteelle on määritetty tunniste, palautuu yhdistelmänimi eli tunniste + nimi, esim. "P001 Verkkosivuston uudistus"

DevOps

5

dimensionitemname

Merkkijono

0...1

Laskentakohteen nimi

Verkkosivuston uudistus

5

dimensionitemcode

Merkkijono

0...1

Laskentakohteen tunniste

P001

3

payslipdeliverymethod

Merkkijono

1

Palkkalaskelman toimitustapa

1 = paikallinen tulostus
2 = tulostuspalvelu
3 = verkkopalkka

3

type

Merkkijono

1

Toimitustavan linkitystyyppi

Attribuutti type on aina netvisor,
eli Netvisorin tunniste

3

isjointowner

Kokonaisluku

1

Osakasasemassa maksajaan

1=kyllä
0=ei

3

isathlete

Kokonaisluku

1

Urheilija

1=kyllä
0=ei

3

isperformingartist

Kokonaisluku

1

Esiintyvä taitelija

1=kyllä
0=ei

3

employeeinsurancetype

Kokonaisluku

1

Työeläkevakuutuksen tyyppi

1=Tyel
2=MYEL
3=YEL
4=Ei eläkevakuutettu

3

ispersonworkingonaroadferryonalandislands

Kokonaisluku

1

Ahvenanmaan maantielautalla työskentelevä henkilö

1=kyllä
0=ei

3

isentrepreneurwithoptionalyelormyel

Kokonaisluku

1

Yrittäjä

1=kyllä
0=ei

3

receivessalaryfromdiplomaticembassy

Kokonaisluku

1

Diplomaattisen edustuston maksamaa palkkaa saava henkilö

1=kyllä
0=ei

3

ispersonreceivingeppoinsurancesalary

Kokonaisluku

1

EPPO-lain mukaista vakuutuspalkkaa saaja henkilö

1=kyllä
0=ei

3

isinvoicingserviceuserwithoutbusinessid

Kokonaisluku

1

Laskuttava henkilö, jolla ei ole y-tunnusta

1=kyllä
0=ei

2

employeeeducationalinformation

Aggregaatti

0...1

Tutkinnot


3

degree

Aggregaatti

0...n

Tutkinto


4

name

Merkkijono

1

Tutkinnon nimi

Merkonomi

4

school

Kokonaisluku

1

Oppilaitos

Kauppaoppilaitos

4

graduationyear

Kokonaisluku

1

Valmistumisvuosi

2021

4

isprimarydegree

Kokonaisluku

1

Päätutkinto

1=kyllä
0=ei

2

employeeadditionalinformationfields

Aggregaatti

0...1

Lisätietokentät


3

additionalinformationfield

Aggregaatti

0...n

Lisätietokenttä


4

netvisorkey

Kokonaisluku

1

Kokonaisluku

1

4

name

Merkkijono

1

Lisätietokentän nimi

Ruoka-aine allergiat

4

value

Merkkijono

1

Lisätietokentän arvo

kala

Attr.

type

Merkkijono

1

text, datetime

text

4

group

Merkkijono

1

1=Perustiedot
2=Yhteystiedot
3=Koulutustiedot

1

Attr.

type

Merkkijono

1

Attribuutti type on aina netvisor, eli Netvisorin tunniste

netvisor

2

employeesettlementpoints

Aggregaatti

0...1

Tilityspisteet


3

employeeunemploymentinsurance

Aggregaatti

0...n

Työttömyysvakuutus


4

netvisorkey

Kokonaisluku

1

Tilityspisteen tunniste

1

4

type

Merkkijono

1

Tilityspisteen käsittely

automatichandling=
Automaattinen käsittely
under17yearsold=Alle 17-vuotias
17to64yearsold=17-64 vuotias
over65yearsold=yli 65-vuotias
partowner=osaomistaja

4

name

Merkkijono

1

Vakuutuskohtainen tilityspiste

Työttömyysvakuutus

3

employeeaccidentinsurance

Aggregaatti

0...n

Tapaturmavakuutus


4

netvisorkey

Kokonaisluku

1

Tilityspisteen tunniste

2

4

type

Merkkijono

1

Tilityspisteen käsittely

attachedtosettlementpoint

4

name

Merkkijono

1

Vakuutuskohtainen tilityspiste

Vakuutuskohtainen tilityspiste

3

employeegrouplifeinsurance

Aggregaatti

0...n

Ryhmähenkivakuutus


4

netvisorkey

Kokonaisluku

1

Tilityspisteen tunniste

3

4

type

Merkkijono

1

Tilityspisteen käsittely

attachedtosettlementpoint

4

name

Merkkijono

1

Vakuutuskohtainen tilityspiste

Ryhmähenkivakuutus

3

employeeunionmembershipfee

Aggregaatti

0...n

Ammattiliiton jäsenmaksu


4

netvisorkey

Kokonaisluku

1

Tilityspisteen tunniste

4

4

type

Merkkijono

1

Tilityspisteen käsittely

attachedtosettlementpoint

4

name

Merkkijono

1

Vakuutuskohtainen tilityspiste

Ammattiliiton jäsenmaksu

3

employeeotherinsurance

Aggregaatti

0...n

Muu vakuutus


4

netvisorkey

Kokonaisluku

1

Tilityspisteen tunniste

5

4

type

Merkkijono

1

Tilityspisteen käsittely

attachedtosettlementpoint

4

name

Merkkijono

1

Vakuutuskohtainen tilityspiste

Muu vakuutus

3

employeeworkpensioninsurance

Aggregaatti

0...n

Työeläkevakuutus


4

netvisorkey

Kokonaisluku

1

Tilityspisteen tunniste


4

type

Merkkijono

1

Tilityspisteen käsittely

automatichandling=
Automaattinen käsittely
under17yearsold=Alle 17-vuotias
17to52yearsold=17-52 vuotias
53to62yearsold=53-62 vuotias
63to67yearsold=63-67 vuotias
over68yearsold=yli 68-vuotias

4

name

Merkkijono

1

Vakuutuskohtainen tilityspiste

TyEL

3

employeeforeclosure

Aggregaatti

0...n

Ulosotto


4

netvisorkey

Kokonaisluku

1

Kokonaisluku

6

4

type

Merkkijono

1

Tilityspisteen käsittely

attachedtosettlementpoint

4

name

Merkkijono

1

Vakuutuskohtainen tilityspiste

Ulosotto

Vastasiko tämä kysymykseesi?