Palkansaajien ja palkkalaskelmien käsittelyn toiminnot jakautuvat seuraaviin toimintoihin:
Huomaathan artikkelin HRM-integraatioiden suositelluista toimintamalleista.
Palkansaajien nouto
Resurssi: getemployees.nv
Resurssi palauttaa listauksen palkansaajista ja heidän tunnistetietonsa.
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Esimerkki | Kuvaus |
| includeendedemployments | 0...1 | 1 | Haetaanko myös palkansaajat joiden työsuhde on päättynyt, 1 kyllä 0 ei |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | employees | Aggregaatti | 1 | ||
| 2 | employee | Aggregaatti | 1 | ||
| 3 | employeenumber | Merkkijono | 1 | Palkansaajan numero | 100 |
| 3 | netvisorkey | Merkkijono | 1 | Palkansaajan netvisorkey | 10 |
| 3 | personalid | Merkkijono | 1 | Palkansaajan hetu, y-tunnus | 010277-xxxp |
| Attr. | type | Merkkijono | 1 | PersonalId:n tyyppi | finnishidentifier |
| 3 | firstname | Merkkijono | 1 | Palkansaajan etunimi | Anna |
| 3 | lastname | Merkkijono | 1 | Palkansaajan sukunimi | Ammattilainen |
| 3 | realname | Merkkijono | 1 | Palkansaajan kokonimi | Anna Ammattilainen |
| 3 | employmentstatus | Merkkijono | 1 | Työsuhteen tila | 1 |
| 3 | payrollservice | Merkkijono | 1 | Palkat palvelu | 1 |
| 3 | resourcemanagement | Merkkijono | 1 | Matkat palvelu | 0 |
Yksittäisen palkansaajan nouto
Resurssi: getemployee.nv
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 | 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 | Merkkijono, maks. 100 | 1 | Palkansaajan sähköpostiosoite | anna.ammattilainen@yritys.fi | |
| 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ä | Keva: Ammattinimikkeiden haku |
| 4 | kevaemploymentregistration | Kokonaisluku | 1 | Keva Palvelusuhteen rekisteröinti, max 2 merkkiä. | Keva: Tulorekisterin koodisto |
| Attr. | type | Merkkijono | 1 | aina keva | keva |
| Attr. | pensionprovidercode | Kokonaisluku | 1 | Työeläkelaitoksen yhtiötunnuksen koodi. | Keva: Tulorekisterin koodisto |
| 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 | Tulorekisteri: Koodistot |
| 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. Luodaan tarvittaessa | Kustannuspaikat |
| 5 | dimensionitem | Merkkijono | 1 | Laskentakohteen nimi. Luodaan tarvittaessa | DevOps |
| 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 |
| 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 |
Palkansaajan tuonti
Resurssi: employee.nv
Palkansaajan tuonti tai muokkaus. Katso taulukon lopusta ohjeet resurssin käyttöön.
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Esimerkki | Kuvaus |
| Method | 1 | Add | Tuonnin tyyppi, Add tai Edit |
Palkansaajan tietojen muokkauksessa Method=Edit ja kohdistustietona käytetään XML-sanoman elementtiä employeeidentifier (suomalainen palkansaaja) tai identifier (ulkomainen palkansaaja).
Tuotavat tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena xml:nä (POST-data):
| Taso | Elementti | Muoto ja pituus | Ilmenty- miä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | employee | Aggregaatti | 1 | ||
| 2 | employeebaseinformation | Aggregaatti | 1 | ||
| 3 | foreignemployeeidentification | Aggregaatti | 0..1 | Ulkomainen palkansaaja | Jos elementti annetaan, ei anneta employeeidentifier tietoa |
| 4 | identifier | Merkkijono | 1 | Tunnistustieto | 23011970 |
| Attr. | type | Merkkijono | 1 | Tunnistustiedon tyyppi, sallitut arvot: taxidentificationnumber foreignpersonalidentifier other | foreignpersonalidentifier |
| 4 | issuingcountry | Merkkijono | 1 | Maa | AF |
| Attr. | type | Merkkijono | 1 | Maatiedon muoto | ISO-3166 |
| 4 | gender | Merkkijono | 1 | Sukupuoli, male female | male |
| 4 | dateofbirth | Päivämäärä | 1 | Syntymäaika | 1970-10-20 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto | ansi |
| 3 | employeeidentifier | Merkkijono | 1 | Palkansaajan suomalainen henkilötunnus | 010277-xxxp |
| 3 | companyidentifier | Merkkijono | 0..1 | Yrityksen y-tunnus, Kun tuodaan yritys palkansaajaksi | 0174564-5 |
| 3 | companyname | Merkkijono | 0..1 | Yrityksen nimi | Testi Yritys |
| 3 | firstname | Merkkijono, maks. 50 | 1 | Palkansaajan etunimi | Anna |
| 3 | lastname | Merkkijono, maks. 50 | 1 | Palkansaajan sukunimi | Ammattilainen |
| 3 | phonenumber | Merkkijono, maks. 50 | 1 | Palkansaajan puhelinnumero | 050 123 456 |
| 3 | Merkkijono, maks. 100 | 1 | Palkansaajan sähköpostiosoite | anna.ammattilainen@yritys.fi | |
| 2 | employeepayrollinformation | Aggregaatti | 1 | ||
| 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 | municipality | Merkkijono, maks. 255 | 0..1 | Palkansaajan asuinpaikkakunta | Lappeenranta |
| 3 | country | Merkkijono, maks. 2 | 0..1 | Palkansaajan kotimaan koodi, oletus fi | fi |
| 3 | nationality | Merkkijono, maks. 2 | 0..1 | Palkansaajan kansalaisuus, oletus fi | se |
| 3 | language | Merkkijono, maks. 2 | 0..1 | Palkansaajan käyttämä kieli, oletus fi | fi |
| 3 | employeenumber | Numeerinen, maks. 10 | 0..1 | Palkansaajan yksilöllinen tunnistenumero | 13 |
| 3 | profession | Merkkijono, maks. 255 | 0..1 | Palkansaajan ammattinimike | Testaaja |
| 3 | jobbegindate | Merkkijono, maks. 10 | 0..1 | Palkansaajan työsuhteen alkamispäivä | 2017-11-09 |
| Attr. | format | Merkkijono | Alkamispäivän muoto, aina ansi | ansi | |
| 3 | payrollrulegroupname | Merkkijono, maks. 50 | 1 | Palkansaajan palkkamallin nimi | Kuukausipalkkalaiset |
| 3 | bankaccountnumber | Merkkijono, maks. 34 | 0..1 | Palkansaajan pankkitilinumero, IBAN-tilinumero. Jos tuot pelkästään pankkitilinumeron, lasketaan BIC-koodi tilinumeron perusteella | FI71 7997 9580 0073 35 |
| 3 | bankidentificationcode | Merkkijono. maks. 20 | 0..1 | Pankin BIC-koodi | NDEAFIHH |
| 3 | accountingaccountnumber | Numeerinen | 0..1 | Palkansaajan velkatilinumero | 1751 |
| 3 | hierarchy | Merkkijono | 0..1 | Hierarkiataso | Oy Yritys Ab |
| Attr. | type | Merkkijono | 1 | Hierarkian linkitystyyppi | netvisor - Netvisorin tunniste tai customer - Jos yksilöidään nimellä, täytyy olla uniikki Lue yrityshierarkiasta |
| 3 | dimension | Aggregaatti | 0..n | Oletuslaskentakohteet | |
| 4 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikon nimi. Luodaan tarvittaessa | Kustannuspaikat |
| 4 | dimensionitem | Merkkijono | 1 | Laskentakohteen nimi. Luodaan tarvittaessa | DevOps |
| Attr. | fatherid | Numeerinen | 0..1 | Laskentakohteen "vanhemman" (parent) tunnus. ID:t voi noutaa tällä resurssilla | 1 |
| 3 | payslipdeliverymethod | Merkkijono | 0..1 | Palkkalaskelman toimitustapa | 1 = paikallinen tulostus 2 = tulostuspalvelu 3 = verkkopalkka |
| Attr. | type | Merkkijono | 1 | Toimitustavan linkitystyyppi | Attribuutti type on aina netvisor, eli Netvisorin tunniste |
| 3 | isjointowner | Numeerinen | 0..1 | Osakasasemassa maksajaan | 1=kyllä 0=ei |
| 3 | isathlete | Numeerinen | 0..1 | Urheilija | 1=kyllä 0=ei |
| 3 | isperformingartist | Numeerinen | 0..1 | Esiintyvä taitelija | 1=kyllä 0=ei |
| 3 | employeeinsurancetype | Numeerinen | 0..1 | Työeläkevakuutuksen tyyppi | 1=Tyel 2=MYEL 3=YEL 4=Ei eläkevakuutettu |
| 3 | ispersonworkingonaroadferryonalandislands | Numeerinen | 0..1 | Ahvenanmaan maantielautalla työskentelevä henkilö | 1=kyllä 0=ei |
| 3 | isentrepreneurwithoptionalyelormyel | Numeerinen | 0..1 | Yrittäjä, ei YEL- tai MYEL-vakuuttamisvelvollisuutta | 1=kyllä 0=ei 1 voidaan antaa vain, mikäli employeeinsurancetype=4 |
| 3 | nosocialsecuritypayment | Numeerinen | 0..1 | Ei työnantajan sairausvakuutusmaksun alainen | 1=kyllä 0=ei Oletuksena 0 |
| 3 | activity | Numeerinen | 0..1 | Aktiivisuus | 1=kyllä 0=ei Oletuksena 1 |
| 3 | foreclosure | Numeerinen | 0..1 | Ulosotto | 1=kyllä 0=ei Oletuksena 0 |
| 3 | foreclosuremaitenancepersons | Numeerinen | 0..1 | Ulosotossa elatuksen varassa olevat henkilöt | Annettava, jos foreclosure = 1 |
| 3 | taxnumber | Merkkijono | 0..1 | Palkansaajan veronumero | 123456798912 |
| 3 | placeofbusiness | Merkkijono | 0..1 | Toimipaikka tulorekisteriin (nimi) | Pääkonttori |
| 2 | employmentperiods | Aggregaatti | 0..1 | Työsuhteet | |
| 3 | employmentperiod | Aggregaatti | 1..n | Työsuhde | |
| 4 | companystartdate | Päivämäärä | 0..1 | Yhtymään tulopäivä | 2017-01-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto | ansi |
| 4 | 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ä | 0..1 | Koeajan päättymispäivä | 2017-04-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto | ansi |
| 4 | employmentmode | Numeerinen | 0..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 | 0..1 | Kommentti | Uusi osaava tyyppi |
| 4 | enddate | Päivämäärä | 0..1 | Päättymispäivä | 2017-12-31 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto | ansi |
| 4 | endreason | Numeerinen | 0..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 | 0..1 | Ammattiluokka | Ammattiluokan TK10-koodi |
| Attr. | type | Merkkijono | 1 | Linkitystyyppi | Attribuutti type on aina isco |
| 4 | employmentcontract | Numeerinen | 0..1 | Työsuhteen voimassaolo | 1 = Toistaiseksi voimassa oleva 2 = Määräaikainen Huom: määräaikaiselle työsuhteelle on annettava päättymispäivä |
| Attr. | type | Merkkijono | 1 | Linkitystyyppi | Attribuutti type on aina netvisor, eli Netvisorin tunniste |
| 4 | employmentform | Numeerinen | 0..1 | Työsuhteen tyyppi | 1 = Kokoaikainen 2 = Osa-aikainen 3 = tietoa ei saatavilla |
| Attr. | type | Merkkijono | 1 | Linkitystyyppi | Attribuutti type on aina netvisor, eli Netvisorin tunniste |
| 4 | parttimepercent | Numeerinen | 0..1 | Osa-aikaisuuden prosentti | Sallittu arvo, desimaaliluku väliltä 0-100 Huom: employmentform oltava 2, jotta asetus huomioidaan Pyöristys lähimpään kahteen desimaaliin |
| 4 | regularworkinghours | Numeerinen | 0..1 | Säännöllinen työaika | Sallittu arvo, desimaaliluku väliltä 0-168 Pyöristys lähimpään kahteen desimaaliin |
| 4 | groundsforemployment | Numeerinen | 0..1 | Työsuhteen peruste | 0=Muu peruste 1=Työsuhde tai virkasuhde |
| 4 | kevaprofessionalclasscode | Numeerinen | 0..1 | Keva Ammattiluokan koodi, max 20 merkkiä. KEVA tietoja voi antaa vain jos yrityksellä on valittu palkanlaskennan asetuksista ”Yrityksen työeläkevakuuttaja on Keva”. | Kevan ammattiluokkien koodit: Keva: Ammattinimikkeiden haku
|
| 4 | kevaemploymentregistration | Numeerinen | 0..1 | Keva Palvelusuhteen rekisteröinti, max 2 merkkiä. | Kevan Palvelussuhteen rekisteröintikoodit: Keva: Tulorekisterin koodisto |
| Attr. | type | Merkkijono | 1 | aina keva | keva |
| Attr. | pensionprovidercode | Numeerinen | 0..1 | Työeläkelaitoksen yhtiötunnuksen koodi. Jos ei anneta, käytetään oletuksena arvoa ”20”. Määrää mitä arvoja hyväksytään kenttään kevaemploymentregistration. | Arvo löytyy KEVA:n koodistosta Keva: Tulorekisterin koodisto Virheellisellä arvolla listataan sallitut arvot. |
| 4 | ispaymenttypemonthlywage | Numeerinen | 0..1 | Palkkauksen muoto: Kuukausipalkka | 1=kyllä 0=ei |
| 4 | ispaymenttypehourlywage | Numeerinen | 0..1 | Palkkauksen muoto: Tuntipalkka | 1=kyllä 0=ei |
| 4 | ispaymenttypepiecewage | Numeerinen | 0..1 | Palkkauksen muoto: Urakka | 1=kyllä 0=ei |
| 4 | collectiveagreement | Numeerinen | 0..1 | Työehtosopimus | Tulorekisterin työehtosopimuksen koodit: Tulorekisteri: Koodistot |
| Attr. | type | Merkkijono | 1 | aina cbacode | cbacode |
| 4 | stateemploymentfund | Numeerinen | 0..1 | Valtion työllisyysmäärärahoilla työllistetty | 1=kyllä 0=ei |
| 4 | carbenefityear | Numeerinen | 0..1 | Autoetuauton käyttöönottovuosi, max 4 merkkiä | 2012 |
| 4 | isabroadcarbenefit | Numeerinen | 0..1 | Autoetu on saatu ulkomailla | 1=kyllä 0=ei |
| 4 | caremissionsvalue | Numeerinen | 0..1 | Auton päästöarvo, kokonaisluku väliltä 0-100 | 85 |
| 2 | employeesettings | Aggregaatti | 0..1 | Palkansaajan asetukset | |
| 3 | payrollservice | Merkkijono | 0..1 | Palkanlaskentapalvelu | enabled tai disabled |
| 3 | resourcemanagement | Merkkijono | 0..1 | Resurssinhallinta | enabled tai disabled |
| 2 | employeesettlementpoints | Aggregaatti | 0..1 | Tilityspisteet | |
| 3 | employeeworkpensioninsurance | Aggregaatti | 0..1 | Työeläkevakuutus | |
| 4 | type | Merkkijono | 0..1 | Tilityspisteen käsittely | nohandling=Ei 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 | 0..1 | Vakuutuskohtainen tilityspiste määritys (* | TyEL |
| 3 | employeeunemploymentinsurance | Aggregaatti | 0..1 | Työttömyysvakuutus | |
| 4 | type | Merkkijono | 0..1 | Tilityspisteen käsittely | nohandling=Ei käsittelyä automatichandling= Automaattinen käsittely under17yearsold=Alle 17-vuotias 17to64yearsold=17-64 vuotias over65yearsold=yli 65-vuotias partowner=osaomistaja |
| 4 | name | Merkkijono | 0..1 | Vakuutuskohtainen tilityspiste määritys (* | Työttömyysvakuutus |
| 3 | employeeaccidentinsurance | Aggregaatti | 0..1 | Tapaturmavakuutus | |
| 4 | type | Merkkijono | 0..1 | Tilityspisteen käsittely | nohandling tai attachedtosettlementpoint |
| 4 | name | Merkkijono | 0..1 | Vakuutuskohtainen tilityspiste määritys (* | Tapaturmavakuutus |
| 3 | employeegrouplifeinsurance | Aggregaatti | 0..1 | Ryhmähenkivakuutus | |
| 4 | type | Merkkijono | 0..1 | Tilityspisteen käsittely | nohandling tai attachedtosettlementpoint |
| 4 | name | Merkkijono | 0..1 | Vakuutuskohtainen tilityspiste määritys (* | Ryhmähenkivakuutus |
| 3 | employeeotherinsurance | Aggregaatti | 0..1 | Muu vakuutus | |
| 4 | type | Merkkijono | 0..1 | Tilityspisteen käsittely | nohandling tai attachedtosettlementpoint |
| 4 | name | Merkkijono | 0..1 | Vakuutuskohtainen tilityspiste määritys (* | Muu vakuutus |
| 3 | employeeunionmembershipfee | Aggregaatti | 0..1 | Ammattiliiton jäsenmaksu | |
| 4 | type | Merkkijono | 0..1 | Tilityspisteen käsittely | nohandling tai attachedtosettlementpoint |
| 4 | name | Merkkijono | 0..1 | Vakuutuskohtainen tilityspiste määritys (* | Ammattiliiton jäsenmaksu |
| 3 | employeeforeclosure | Aggregaatti | 0..1 | Ulosmittaus | |
| 4 | type | Merkkijono | 0..1 | Tilityspisteen käsittely | nohandling tai attachedtosettlementpoint |
| 4 | name | Merkkijono | 0..1 | Vakuutuskohtainen tilityspiste määritys (* | Ulosotto |
| 2 | employeeeducationalinformation | Aggregaatti | 0..1 | Palkansaajan koulutustiedot | |
| 3 | degree | Aggregaatti | 0..n | Tutkinto | |
| 4 | name | Merkkijono | 1 | Tutkinnon nimi | Ylioppilas |
| 4 | school | Merkkijono | 1 | Koulun nimi | Lyseon lukio |
| 4 | graduationyear | Numeerinen | 1 | Valmistumisvuosi | 2022 |
| 4 | primarydegree | Numeerinen | 1 | Päätutkinto | 1=kyllä 0=ei |
| 2 | employeeadditionalinformation | Aggregaatti | 0..1 | Palkansaajan lisätietokentät | |
| 3 | additionalinformationfield | Aggregaatti | 0..n | Palkansaajan lisätietokenttä | |
| 4 | name | Merkkijono | 1 | Lisätietokentän nimi | Allergiat |
| 4 | value | Merkkijono | 1 | Lisätietokentän arvo | Kala |
*) Tilityspisteet: Palkat > Palkanlaskenta > Velvoitteet > Tilitykset
Huomioitavaa resurssin käytössä:
- Palkansaajan muokkaaminen on mahdollistettu silloinkin kun ko. palkansaajan työsuhde ei ole voimassa
- Resurssi ei aseta palkansaajalle lomapäivien kertymiä. Tämä asetetaan käyttöliittymässä.
- Yksittäisen palkansaajan osalta tiedon voi päivittää palkansaajan tietojen sivulla
- Useammalle palkansaajalle tieto voidaan asettaa massana lomaoikeuden hallinnasta, Palkat - Lomalaskennan asetukset, jossa valitaan käsiltävät palkansaajat ja "Käsittele valittuja" valikosta valitaan "Aseta lomapäivien kertymäsääntö" sekä haluttu kertymäsääntö
- Jos employmentperiods-elementti on määritelty, vähintään yksi työsuhde on tuotava
- startdate- ja profession-elementit ovat aina pakollisia
- Jos enddate on määritelty, myös endreason on pakollinen
- Jos employmentperiods-elementti on määritelty, työsuhdetiedot yliajavat employeepayrollinformation-määritykset
- Jos employmentperiods-elementtiä ei ole määritelty, palkansaajan työsuhde määritetään employeepayrollinformation > profession ja jobbegindate
- Jos työsuhteita tuodaan rajapinnan kautta, palkansaajan mahdolliset olemassaolevat työsuhteet poistetaan
- Jos yritys tuodaan palkansaajaksi niin tällöin ei anneta tavallisen palkansaajan yksilöiviä tietoja kuten:
- employeeidentifier
- firstname
- lastname
- foreignemployeeidentification -elementti
Palkansaajan perustietojen muokkaus
Resurssi: patchemployee.nv
Resurssilla voi muokata palkansaajan perustietoja. Sanomalla tarvitsee tuoda vain muuttuneet tiedot.
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| identifiertype | 1 | Palkansaajan tunnisteen tyyppi: netvisorkey, number tai personalidentificationnumber | netvisorkey |
| identifier | 1 | Palkansaajan tunniste | 1 |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | Root | Aggregaatti | 1 | ||
| 1 | patchemployee | Aggregaatti | 1 | ||
| 2 | employeebaseinformation | Aggregaatti | 1 | ||
| 3 | companyname | Merkkijono | 0..1 | Yrityksen nimi | Test Company Oy |
| 3 | firstname | Merkkijono, maks. 50 | 0..1 | Palkansaajan etunimi | Anna |
| 3 | lastname | Merkkijono, maks. 50 | 0..1 | Palkansaajan sukunimi | Ammattilainen |
| 3 | phonenumber | Merkkijono, maks. 50 | 0..1 | Palkansaajan puhelinnumero | 0501234567 |
| 3 | Merkkijono, maks.100 | 0..1 | Palkansaajan sähköpostiosoite | anna.ammattilainen@test-company.fi | |
| 2 | employeepayrollinformation | Aggregaatti | 0..1 | ||
| 3 | streetaddress | Merkkijono, maks. 255 | 0..1 | Palkansaajan katuosoite | Keisarinnankatu 1 |
| 3 | postnumber | Merkkijono, maks. 50 | 0..1 | Palkansaajan postinumero | 56120 |
| 3 | city | Merkkijono, maks. 255 | 0..1 | Palkansaajan postitoimipaikka | Lappeenranta |
| 3 | municipality | Merkkijono, maks. 255 | 0..1 | Palkansaajan asuinpaikkakunta | Lappeenranta |
| 3 | country | Merkkijono, maks. 2 | 0..1 | Palkansaajan kotimaan koodi, oletus fi | fi |
| 3 | nationality | Merkkijono, maks. 2 | 0..1 | Palkansaajan kansalaisuus, oletus fi | se |
| 3 | language | Merkkijono, maks. 2 | 0..1 | Palkansaajan käyttämä kieli, oletus fi | fi |
| 3 | employeenumber | Numeerinen | 0..1 | Palkansaajan yksilöllinen tunnistenumero | 12 |
| 3 | payrollrulegroupname | Merkkijono, maks. 50 | 0..1 | Palkansaajan palkkamallin nimi | Kuukausipalkka, perusmalli |
| 3 | bankaccountnumber | Merkkijono, maks. 34 | 0..1 | Palkansaajan pankkitilinumero, IBAN-tilinumero. Jos tuot pankkitilinumeron, tulee tuoda myös BIC-koodi (bankidentificationcode). | FI7179979580007335 |
| 3 | bankidentificationcode | Merkkijono. maks. 20 | 0..1 | Pankin BIC-koodi | NDEAFIHH |
| 3 | accountingaccountnumber | Numeerinen | 0..1 | Palkansaajan velkatilinumero | 1751 |
| 3 | hierarchy | Merkkijono | 0..1 | Hierarkiataso | Test Company Oy |
| Attr. | type | Merkkijono | 0..1 | Hierarkian linkitystyyppi | netvisor - Netvisorin tunniste (netvisorkey) tai customer - Jos yksilöidään nimellä, täytyy olla uniikki. Lue yrityshierarkiasta |
| 3 | payslipdeliverymethod | Merkkijono | 0..1 | Palkkalaskelman toimitustapa | 1 = paikallinen tulostus 2 = tulostuspalvelu 3 = verkkopalkka |
| Attr. | type | Merkkijono | 0..1 | Toimitustavan linkitystyyppi | Attribuutti type on aina netvisor, eli Netvisorin tunniste (netvisorkey) |
| 3 | isjointowner | Numeerinen | 0..1 | Osakasasemassa maksajaan | 1=kyllä 0=ei |
| 3 | isathlete | Numeerinen | 0..1 | Urheilija | 1=kyllä 0=ei |
| 3 | isperformingartist | Numeerinen | 0..1 | Esiintyvä taiteilija | 1=kyllä 0=ei |
| 3 | employeeinsurancetype | Numeerinen | 0..1 | Työeläkevakuutuksen tyyppi | 1=Tyel 2=MYEL 3=YEL 4=Ei eläkevakuutettu |
| 3 | ispersonworkingonaroadferryonalandislands | Numeerinen | 0..1 | Ahvenanmaan maantielautalla työskentelevä henkilö | 1=kyllä 0=ei |
| 3 | isentrepreneurwithoptionalyelormyel | Numeerinen | 0..1 | Yrittäjä, ei YEL- tai MYEL-vakuuttamisvelvollisuutta | 1=kyllä 0=ei 1 voidaan antaa vain, mikäli employeeinsurancetype=4 |
| 3 | ispersonreceivingeppoinsurancesalary | Kokonaisluku | 0..1 | EPPO-lain mukaista vakuutuspalkkaa saaja henkilö | 1=kyllä 0=ei |
| 3 | nosocialsecuritypayment | Numeerinen | 0..1 | Ei työnantajan sairausvakuutusmaksun alainen | 1=kyllä 0=ei |
| 3 | receivessalaryfromdiplomaticembassy | Numeerinen | 0..1 | Diplomaattisen edustuston maksamaa palkkaa saava henkilö | 1=kyllä 0=ei |
| 3 | activity | Numeerinen | 0..1 | Aktiivisuus | 1=kyllä 0=ei |
| 3 | foreclosure | Numeerinen | 0..1 | Ulosotto | 1=kyllä 0=ei |
| 3 | foreclosuremaintenancepersons | Numeerinen | 0..1 | Ulosotossa elatuksen varassa olevat henkilöt | Annettava jos tieto ulosotta annetaan arvolla 1 |
| 3 | taxnumber | Merkkijono | 0..1 | Palkansaajan veronumero | 12345678912 |
| 3 | placeofbusiness | Merkkijono | 0..1 | Toimipaikka tulorekisteriin (nimi) | Pääkonttori |
| 2 | employeesettings | Aggregaatti | 0..1 | Palkansaajan asetukset | |
| 3 | payrollservice | Merkkijono | 0..1 | Palkanlaskentapalvelu | enabled tai disabled |
| 3 | resourcemanagement | Merkkijono | 0..1 | Resurssinhallinta | enabled tai disabled |
Palkansaajan palkkaperusteiden nouto
Resurssi: getemployeesalaryparameters.nv
Jos palkkaperusteella ei ole arvoa, palautuu value-elementti tyhjänä elementtinä (), kun taas nolla-arvo palautuu normaalina arvona (0,0).
Resurssin kautta voi hakea halutun palkansaajan palkkaperusteet. Kutsussa käytettävät parametrit (GET):
| Parametri | Ilmentymiä | Kuvaus |
| identifiertype | 1 | Tunnisteen tyyppi: pin, number tai netvisorkey |
| identifier | 1 | Tyypin mukainen tunniste: palkansaajan HETU tai palkansaajan numero |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| root | root | Aggregaatti | 1 | ||
| 1 | employeesalaryparameters | Aggregaatti | 1 | ||
| 2 | parameters | Aggregaatti | 1 | ||
| 3 | parameter | Aggregaatti | 0..n | ||
| 4 | rationumber | Numero | 1 | Palkkaperusteen palkkalajin numero (yrityskohtaiset palkkalajit) | 123 |
| 4 | value | Desimaaliluku | 1 | Palkkaperusteen arvo | 12,34 |
Palkansaajan palkkaperusteiden tuonti
Resurssi: employeesalaryparameters.nv
Sanomalla voi tuoda osan palkkaperusteista (1-24 kpl kerralla) ja toisella sanomalla eri osan palkkaperusteista. Palkkaperusteisiin joita sanomalla ei ole määritettynä ei tehdä muutoksia.
Jos palkkaperuste halutaan asettaa nollaksi tai sen arvoa halutaan päivittää, annetaan value-elementissä uusi arvo. Mikäli olemassaolevan palkkaperusteen arvo halutaan poistaa kokonaan, value-elementtiä ei anneta sanomalla.
Tämä resurssi vaatii toimiakseen rajapintatunnuskäyttäjältä palkanlaskijan roolin (P-rooli).
Tuotavat tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena xml:nä (POST-data):
| Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | employeesalaryparameters | Aggregaatti | 1 | ||
| 2 | employeeidentification | Teksti | 1 | Palkansaajan tunniste | 123456-123A |
| Attr. | Type | Teksti | 1 | Linkitystyyppi, employeenumber,finnishpersonalidentifier tai netvisorkey | pin |
| 2 | salaryparameters | Aggregaatti | 1 | ||
| 3 | salaryparameter | Aggregaatti | 1..24 | ||
| 4 | rationumber | Numero | 1 | Palkkaperusteen palkkalajin numero (yrityskohtaiset palkkalajit). Palkkalajin lähde tulee olla Netvisorissa "Palkansaajan perustiedot" | 123 |
| 4 | value | Desimaaliluku | 0..1 | Palkkaperusteen arvo | 12,30 |
Palkkalajien nouto
Resurssi: payrollratiolist.nv
Resurssilla voi hakea yrityskohtaiset palkkalajit. Palkkalajeja käytetään matkalaskun ja palkkalaskelman tuonnissa Netvisoriin.
| Parametri | Ilmentymiä | Esimerkki | Kuvaus |
| source | 1..n | collectorratiolines | Rajataan palkkalajin tyypillä joka on oltava yksi tai useampi seuraavista: - tripexpensecustomlines = matkalasku, kulurivit - taxingrules = verokortti - collectorratiolines = palkkajaksokohtainen kirjaus - userparameters = palkansaajan perustiedot - companyparameters = yrityksen perustiedot - userformula = käyttäjän kaava - tabledata = taulukkodata - foreclosure = ulosotto - lowsalarysupport = matalapalkkatuki |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | PayrollRatios | Aggregaatti | 1 | ||
| 2 | PayrollRatio | Aggregaatti | 0..n | ||
| 3 | Names | Aggregaatti | 0..n | ||
| 4 | Name | Teksti | 1-3 | Palkkalajin nimi | Ulkomaan päiväraha |
| Attr. | ISO639-1Code | Teksti | 1 | Palkkalajin nimen kielitieto: fi,se, en | fi |
| Identifier | Numero | 1 | Palkkalajin ID | 1 | |
| 4 | Source | Teksti | 1 | Palkkalajin tyyppi | Matkalasku, kulurivit |
| 4 | RatioNumber | Numero | 1 | Palkkalajin numero | 123 |
| 4 | DefaultDebitAccountNumber | Numero | 1 | Kirjanpidon debet-tili | 7890 |
| 4 | DefaultCreditAccountNumber | Numero | 1 | Kirjanpidon kredit-tili | 2961 |
Palkkalaskelman tuonti
Resurssi: payrollpaycheckbatch.nv
Valmiin palkkalaskelman tuonti Netvisoriin. Sanomalla voi tuoda valmiita palkkalaskelmia Netvisoriin. Jos laskelmalla tuotuja palkkatietoja on tarkoitus täydentää tai muuten muokata vielä Netvisorissa, on suositeltavaa käyttää yksittäisiä resursseja palkkatietojen tuontiin. Voit lukea tarkemmin palkkalaskelman tuonnin rajoitteista täältä.
Tuotavat tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena xml:nä (POST-data):
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | payrollcheckbatch | Aggregaatti | 1 | ||
| 2 | employeeidentifier | Merkkijono | 1 | Tieto, jolla työntekijä linkitetään *1) | 140785-xxxx |
| Attr. | type | Merkkijono | 1 | Linkitystyyppi, employeenumber, finnishpersonalidentifier tai netvisorkey | finnishpersonalidentifier |
| 2 | rulegroupperiodstart | Päivämäärä | 1 | Palkkajakson alkupäivämäärä *1) | 2022-12-31 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto aina ansi | ansi |
| 2 | rulegroupperiodend | Päivämäärä | 1 | Palkkajakson loppupäivämäärä *2) | 2022-12-31 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 2 | freetextbeforelines | Merkkijono | 0..1 | Vapaa teksti ennen palkkalaskelman rivejä | |
| 2 | freetextafterlines | Merkkijono | 0..1 | Vapaa teksti rivien jälkeen | |
| 2 | duedate | Päivämäärä | 0..1 | Eräpäivä | 2022-12-31 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 2 | valuedate | Päivämäärä | 0..1 | 2022-12-31 | |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 2 | payrollpaycheckbatchline | Aggregaatti | 1..n | ||
| 3 | payrollratioidentifier | Merkkijono | 1 | Tieto, jolla palkkalaji linkitetään riviin. *3) | 1 |
| Attr. | type | Merkkijono | 1 | Linkitystyyppi, toistaiseksi vain rationumber | rationumber |
| 3 | units | Numeerinen | 1 | Rivin kappalemäärä | 2 |
| 3 | unitamount | Numeerinen | 1 | Yksikköhinta | 1500 |
| 3 | linesum | Numeerinen | 1 | Rivisumma, ei lasketa automaattisesti. Suositeltava tuoda max 2 desimaalin tarkkuudella. | 3000,00 |
| 3 | linedescription | Merkkijono | 0..1 | Rivikuvaus | |
| 3 | earningperiodstartdate | Päivämäärä | 0..1 | Ansaintakauden alkupäivämäärä. Jos alku- ja loppupäivä jätetään pois, muodostuu Ansaintakaudeksi palkkajakson päivämäärät. | 2022-12-01 |
| Attr. | type | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 3 | earningperiodenddate | Päivämäärä | 0..1 | Ansaintakauden loppupäivämäärä | 2022-12-31 |
| Attr. | type | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 3 | dimension | Aggregaatti | 0..n | ||
| 4 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko | Projekti |
| 4 | dimensionitem | Merkkijono | 1 | Laskentakohde | Palkanmaksu |
*1) Palkansaaja pitää olla perustettuna Netvisoriin ja palkaasaajalla täytyy olla määritetty palkkamalli.
*2) Jos jaksoa ei löydy järjestelmästä, se perustetaan, jos kyseessä on palkkamallin ensimmäinen jakso tai se alkaa heti edellisen jakson jälkeen.
*3) Nämä palkkalajit löytyvät Netvisorissa näkymästä: Palkat > Palkanlaskenta > Palkkamallien hallinta > Yrityskohtaiset palkkalajit
Palkkajaksokohtainen kirjausrivin tuonti
Resurssi: payrollperiodcollector.nv
Hakee palkansaajan palkkamallin mukaisen avoimen palkkajakson annetun päivämäärän perusteella ja lisää palkkajaksokohtaiset kirjausrivit. Asettaa laskentakohteet ja luo ne tarvittaessa.
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | Root | Aggregaatti | 1 | ||
| 1 | payrollperiodcollector | Aggregaatti | 1 | ||
| 2 | date | Päivämäärä | 1 | Päivämäärä, jolle palkansaajan palkkamallin mukainen avoin palkkajakso osuu | |
| Attr. | format | Merkkijono | 1 | Aina ansi | |
| 2 | employeeidentifier | Merkkijono | 1 | Linkitystyyppi, employeenumber, finnishpersonalidentifier tai netvisorkey | |
| Attr. | type | Merkkijono | 1 | Joko number tai personalidentificationnumber, eli palkansaajan numero tai henkilötunnus | |
| 2 | payrollratioline | Aggregaatti | 1..n | ||
| 3 | amount | Numeerinen | 1 | Palkkajaksokohtaisen kirjausrivin määrä/summa | |
| 3 | payrollratio | Numeerinen | 1 | Palkkalajin numero. Numero on oltava syötettynä palkkalajilla | |
| Attr. | type | Merkkijono | 0..1 | Aina number | |
| 3 | dimension | Aggregaatti | 0..n | ||
| 4 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikon nimi. Luodaan tarvittaessa | |
| 4 | dimensionitem | Mekkijono | 1 | Laskentakohteen nimi. Luodaan tarvittaessa | |
| Attr. | fatherid | Numeerinen | 0..1 | Laskentakohteen "vanhemman" (parent) tunnus |
Palkkaennakon tuonti
Resurssi: payrolladvance.nv
Palkkaennakkoa maksettaessa ei lasketa palkan sivukuluja, jotka käsitellään vasta ennakkoa vähennettäessä palkkalaskelmalla. Laskenta ei näin ollen tapahdu verottajan ohjeistuksen mukaisesti. Asiakas on vastuussa mahdollisista selvityspyynnöistä ja seuraamuksista.
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | Root | Aggregaatti | 1 | ||
| 1 | payrolladvance | Aggregaatti | 1 | ||
| 2 | description | Merkkijono | 0..1 | Tapahtuman kuvaus. Vapaamuotoinen selite ennakon maksamisesta | |
| 2 | employeeidentifier | Merkkijono | 1 | Palkansaajan tunnus, kenelle ennakkoa maksetaan | |
| Attr. | type | Merkkijono | 0..1 | Linkitystyyppi, employeenumber, finnishpersonalidentifier tai netvisorke | |
| 2 | paymentdate | Päivämäärä | 1 | Päivämäärä, jolloin ennakko lähtee maksuun. Ei voi olla kuluvaa päivää aikaisempi | |
| Attr. | format | Merkkijono | 0 | Aina ansi (Huom! DTDssä virhe, jos attribuutti lisätään, aiheuttaa virheen) | |
| 2 | advancesum | Numeerinen | 1 | Palkkaennakon määrä | |
| Attr. | paymentstatus | Merkkijono | 0...1 | ispaid tai notpaid Palkkaennakko, joka on maksettu/merkitty maksetuksi päivittyy automaattisesti ao. palkansaajan seuraavalle palkkalaskelmalle ja vähentää maksettavaa summaa. Käyttäjän ei tarvitse huolehtia palkkaennakon vähentämisestä palkkalaskelmalta. Matkaennakko, joka on maksettu/merkitty maksetuksi päivittyy automaattisesti maksatusnäkymään (HRM > Työaika ja matkalaskut > Maksatus) ao. palkansaajan tietoihin. Maksatusnäkymässä matkaennakko voidaan kohdistaa tulevalle tai tuleville matkalaskuille. | |
| 2 | paymenttype | Merkkijono | 1 | payroll tai tripexpence, eli palkkaennakko tai matkaennakko |
Ulkoisen palkanmaksuaineiston tuonti
Resurssi: payrollexternalsalarypayment.nv
Käytetään ulkoisen palkanmaksuaineiston tuontiin. Ei tarvitse tuoda koko palkkalaskelmaa, vaan ainoastaan maksuaineisto. Aineiston ei tarvitse linkittyä Netvisorista löytyvään palkansaajaan. Maksu tapahtuu Netvisorista, resurssi siis hyvin vastaava kuin tilisiirron tuonti.
Ulkoisen palkanmaksuaineistolla annetaan jompi kumpi tieto paymentdate tai duedate. Elementtien (paymentdate, duedate) terminologia on SEPA-tilisiirtostandardin mukainen: SEPA Palkat Tiedote Tammikuu 2009
- Maksupäivä (paymentdate) = palkkapäivä, palkanmaksu on silloin palkansaajan tilillä.
Ei tehdä pankkipäivien tulkintaa tässä vaiheessa, vaan tulkitaan maksatuksessa. - Eräpäivänä (duedate) = palkka veloitetaan yrityksen tililtä. Eräpäivään lisätään yksi pankkipäivä, jotta saadaan maksupäivä = palkkapäivä. Jos eräpäivä esim. perjantai lisätään 3 päivää jolloin eräpäiväksi tulee maanantai.
- Eräpäivän tulee olla pankkipäivä ja sen on oltavan palkkapäivää edeltävä pankkipäivä, jos maksupäivän sijasta maksutoimeksiannolla annetaan maksajan tilin veloituspäivä eli eräpäivä. Tämän perusteella pankit huolehtivat, että palkat ja eläkkeet ovat saajien tileillä kaikissa Suomessa toimivissa pankeissa palkkapäivänä.
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | Root | Aggregaatti | 1 | ||
| 1 | payrollexternalsalarypayment | Aggregaatti | 1 | ||
| 2 | description | Merkkijono | 0...1 | Tapahtuman kuvaus. Vapaamuotoinen selite. Palkansaajalla palkkatapahtuman selite on aina "Palkka". | Ulkoinen maksu |
| 2 | paymentdate | Päivämäärä | 1 | Maksupäivä = palkkapäivä, palkanmaksu on silloin palkansaajan tilillä (vaihtoehtoinen elementti duedate, käytä vain toista näistä) | 2022-09-01 |
| Attr. | format | Merkkijono | ansi | ansi | |
| 2 | duedate | Päivämäärä | 1 | Eräpäivä, palkka veloitetaan yrityksen tililtä (vaihtoehtoinen elementti paymentdate, käytä vain toista näistä) | 2022-01-01 |
| Attr. | format | Merkkijono | ansi | ansi | |
| 2 | externalpaymentsum | Desimaaliluku | 1 | Maksun määrä (0.01 < sum < 10000000.0) | 100,0 |
| 2 | iban | Merkkijono | 1 | Palkansaajan pankkiyhteys eli pankkitilinumero | FI21 1234 xxxx xxxx xx |
| 2 | bic | Merkkijono | 1 | Pankin tunniste | NDEAFIHH |
| 2 | hetu | Merkkijono | 0...1 | Suomalainen henkilötunnus | 140785-xxyy |
| 2 | realname | Merkkijono | 1 | Palkansaajan nimi | Erkki Esimerkki |
Palkkalaskelmalistauksen nouto
Resurssi: getpayrollpaycheckbatchlist.nv
Resurssi palauttaa yrityksen palkkalaskelmat halutulta päivämääräväliltä, maksimissaan 30 päivän ajalta.
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| startdate | 1 | Pakollinen, alkupäivämäärä | 2023-01-01 |
| enddate | 0..1 | Vapaaehtoinen, loppupäivämäärä. Jos tätä ei anneta, noudetaan vain yhden (startdate) maksupäivän tiedot | 2023-01-31 |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | PayrollPaycheckBatches | Aggregaatti | 1 | ||
| 2 | PayrollPaycheckBatch | Aggregaatti | 0..n | ||
| 3 | Netvisorkey | Numero | 1 | Palkkalaskelman netvisorkey | 1 |
| 3 | PaymentDate | Päivämäärä | 1 | Palkkalaskelman maksupäivä | 2023-01-31 |
| 3 | PayrollRuleGroupPeriod | Aggregaatti | 1 | Palkkajakson tiedot | |
| 4 | Netvisorkey | Numero | 1 | Palkkajakson netvisorkey | 3 |
| 4 | StartDate | Päivämäärä | 1 | Palkkajakson alkupäivämäärä | 2023-01-01 |
| 4 | EndDate | Päivämäärä | 1 | Palkkajakson loppupäivämäärä | 2023-01-31 |
| 3 | PayrollRuleGroup | Aggregaatti | 1 | Palkkamallin tiedot | |
| 4 | Netvisorkey | Numero | 1 | Palkkamallin netvisorkey | 15 |
| 4 | Name | Teksti | 1 | Palkkamallin nimi | Kuukausipalkka, perusmalli |
| 3 | Employee | Aggregaatti | 1 | Palkansaajan tiedot | |
| 4 | Name | Teksti | 1 | Palkansaajan nimi | Matti Meikäläinen |
| 4 | EmployeeNumber | Numero | 1 | Palkansaajan numero | 111 / tyhjä |
| 4 | Netvisorkey | Numero | 1 | Palkansaajan netvisorkey | 12 |
| 3 | Status | Numero | 1 | Palkkalaskelman tila | 1=Avoin, 2=Kuitattu/Hyväksytty, 3= Maksettu |
| 3 | StatusDescription | Teksti | 1 | Palkkalaskelman tila tekstimuodossa | Maksettu |
Palkkalaskelman nouto
Resurssi: getpayrollpaycheckbatch.nv
Resurssi palauttaa yksittäisen palkkalaskelman tiedot. Noudettavan palkkalaskelman netvisorkeyn (tunnisteen) saa noudettua resurssilla palkkalaskelmalistauksen nouto (getpayrollpaycheckbatchlist.nv).
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| netvisorkey | 1 | Pakollinen, palkkalaskelman tunniste | 23 |
Vastaus:
| Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | payrollpaycheckbatch | Aggregaatti | 1 | ||
| 2 | paymentdate | Päivämäärä | 1 | Palkanmaksupäivä | 2023-03-31 |
| 2 | payrollrulegroupperiod | Aggregaatti | 1 | Palkkajakso | |
| 3 | netvisorkey | Numero | 1 | Palkkajakson tunniste | 123 |
| 3 | startdate | Päivämäärä | 1 | Palkkajakson aloituspäivämäärä | 2023-03-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän formaatti | ansi |
| 3 | enddate | Päivämäärä | 1 | Palkkajakson lopetuspäivämäärä | 2023-03-31 |
| Attr. | format | Merkkijono | 1 | Päivämäärän formaatti | ansi |
| 2 | payrollrulegroup | Aggregaatti | 1 | Palkkamalli | |
| 3 | netvisorkey | Numero | 1 | Palkkamallin tunniste | 123 |
| 3 | name | Merkkijono | 1 | Palkkamallin nimi | Kuukausipalkka |
| 2 | employee | Aggregaatti | 1 | Palkansaaja | |
| 3 | netvisorkey | Numero | 1 | Palkansaajan tunniste | 123 |
| 3 | name | Merkkijono | 1 | Palkansaajan nimi | Malli Maisa |
| 3 | employeenumber | Numero | 1 | Palkansaajan numero | 123 / tyhjä |
| 2 | status | Numero | 1 | Palkkalaskelman tila | Palkkalaskelman tila: 1=Avoin 2=Kuitattu/Hyväksytty 3= Maksettu |
| 2 | vouher | Aggregaatti | 0..1 | Tosite | |
| 3 | netvisorkey | Numero | 1 | Tositteen tunniste | 123 |
| 3 | class | Merkkijono | 1 | Tositelaji | PA Palkka |
| 3 | number | Numero | 1 | Tositenumero | 123 |
| 3 | date | Päivämäärä | 1 | Tositteen päiväys | 2023-03-31 |
| Attr. | format | Merkkijono | 1 | Päivämäärän formaatti | ansi |
| 2 | allocationcurves | Aggregaatti | 0..1 | Palkkalaskelman jakokäyrä | |
| 3 | allocationcurve | Aggregaatti | 1..n | Jakokäyrän prosenttijakauma | |
| Attr. | percent | Numero | 1 | Jakauman prosentti | 61 |
| 4 | dimensions | Aggregaatti | 1 | Laskentakohteet | |
| 5 | dimension | Aggregaatti | 1..n | Laskentakohde | |
| 6 | dimensionname | Merkkijono | 1 | Laskentakohteen otsikko | Toimipiste |
| Attr. | netvisorkey | Numero | 1 | Tunniste | 123 |
| 6 | dimensionitem | Merkkijono | 1 | Laskentakohteen nimi | Lappeenranta |
| 2 | freetextbeforelines | Merkkijono | 1 | Teksti ennen palkkalaskelmarivejä | Muista toimittaa verokortti / tyhjä |
| 2 | freetextafterlines | Merkkijono | 1 | Teksti palkkalaskelmarivien jälkeen | Hyvää pääsiäistä / tyhjä |
| 2 | holidayrecords | Aggregaatti | 1 | Lomapäivät noutohetkellä | |
| 3 | availableholidays | Numero | 1 | Kirjattavissa olevat lomapäivät noutohetkellä | 25 |
| 3 | newaccrualofholidays | Desimaaliluku | 1 | Uusi lomakertymä noutohetkellä | 7,5 |
| 2 | payrollpaycheckbatchlines | Aggregaatti | 1 | Palkkalaskelmarivit | |
| 3 | payrollpaycheckbatchline | Aggregaatti | 1..n | Palkkalaskelmarivi | |
| 4 | payrollratio | Aggregaatti | 1 | Palkkalaji | |
| 5 | netvisorkey | Numero | 1 | Tunniste | 123 |
| 5 | number | Numero | 0..1 | Palkkalajin numero | 123 |
| 5 | name | Merkkijono | 1 | Palkkalajin nimi | Kuukausipalkka |
| 5 | isvisible | Numero | 1 | Palkkalajin näkyvyys palkkalaskelmalla | 1=yes, 0=no |
| 5 | costobjectsource | Merkkijono | 1 | Palkkalajin laskentakohteiden lähde | DimensionCurve = Jakokäyrä, PaycheckBatchLine = Palkkalaskelmarivi, EmployeeDimensions = Palkansaajan oletuslaskentakohteet, None = Ei kirjausta, SelectedDimensions = Valitut laskentakohteet |
| 4 | units | Numero | 1 | Määrä | 2 / tyhjä |
| 4 | unitamount | Numero | 1 | Yksikköhinta | 200 / tyhjä |
| 4 | linesum | Numero | 1 | Summa | 400 |
| 4 | earningperiods | Aggregaatti | 1 | Ansaintakaudet | |
| 5 | earningperiod | Aggregaatti | 1...n | Ansaintakausi | |
| 6 | startdate | Päivämäärä | 1 | Ansaintakauden alkupäivä | 2023-03-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän formaatti | ansi |
| 4 | enddate | Päivämäärä | 1 | Ansaintakauden loppupäivä | 2023-03-31 |
| Attr. | format | Merkkijono | 1 | Päivämäärän formaatti | ansi |
| 4 | incometype | Aggregaatti | 0...1 | Tulolaji | |
| 5 | netvisorkey | Numero | 1 | Tunniste | 123 |
| 5 | name | Merkkijono | 1 | Tulolajin nimi | Aikapalkka |
| 4 | accountingdata | Aggregaatti | 1 | Tiliöinnit | |
| 5 | debetaccountnetvisorkey | Numero | 1 | Tunniste | 123 / tyhjä |
| 5 | debetaccountnumber | Numero | 1 | Tiliöinnin debet -tilin numero | 5000 / tyhjä |
| 5 | debetaccountname | Merkkijono | 1 | Tiliöinnin debet -tilin nimi | Työntekijäpalkat / tyhjä |
| 5 | kreditaccountnetvisorkey | Numero | 1 | Tunniste | 123 / tyhjä |
| 5 | kreditaccountnumber | Numero | 1 | Tiliöinnin kredit -tilin numero | 2961 / tyhjä |
| 5 | kreditaccountname | Merkkijono | 1 | Tiliöinnin kredit -tilin nimi | Palkkamenot(siirtovelat) / tyhjä |
| 4 | dimensions | Aggregaatti | 0..1 | Laskentakohteet | |
| 5 | dimension | Aggregaatti | 1..n | Laskentakohde | |
| Attr. | percent | Numero | 1 | Laskentakohteen prosentti | 25 |
| 6 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikon nimi | Toimipiste |
| Attr. | netvisorkey | Numero | 1 | Tunniste | 123 |
| 6 | dimensionitem | Merkkijono | 1 | Laskentakohteen nimi | Lappeenranta |
| Attr. | netvisorkey | Numero | 1 | Tunniste | 123 |
| 4 | linedescription | Merkkijono | 1 | Selite |
Palkansaajan työsuhteen lisäys
Resurssi: addjobperiod.nv
Resurssilla voi lisätä palkansaajalle uusia työsuhdetietoja.
Kutsussa käytettävän parametrit:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| employeeidentifier | 1 | Palkansaajan netvisorkey | 12 |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | employmentperiods | Aggregaatti | 1 | Työsuhteet | |
| 2 | employmentperiod | Aggregaatti | 1..n | Työsuhde | |
| 3 | companystartdate | Päivämäärä | 0..1 | Yhtäjaksoisen työsuhteen alkupäivä | 2022-01-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto | ansi |
| 3 | startdate | Päivämäärä | 1 | Alkamispäivä | 2022-01-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto | ansi |
| 3 | probationenddate | Päivämäärä | 0..1 | Koeajan päättymispäivä | 2022-04-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto | ansi |
| 3 | employmentmode | Numeerinen | 0..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, aina netvisor eli Netvisorin tunniste | netvisor |
| 3 | profession | Merkkijono, maks. 250 | 1 | Ammattinimike | Specialist |
| 3 | comment | Merkkijono, maks. 500 | 0..1 | Kommentti | Uusi osaava tyyppi |
| 3 | enddate | Päivämäärä | 0..1 | Päättymispäivä | 2022-12-31 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto | ansi |
| 3 | endreason | Numeerinen | 0..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 | Linkitystyyppi, aina netvisor eli Netvisorin tunniste | netvisor |
| 3 | occupationclassification | Merkkijono | 0..1 | Ammattiluokka | Ammattiluokan TK10-koodi |
| Attr. | type | Merkkijono | 1 | Linkitystyyppi | Attribuutti type on aina isco |
| 3 | employmentcontract | Numeerinen | 0..1 | Työsuhteen voimassaolo | 1 = Toistaiseksi voimassa oleva 2 = Määräaikainen Huom: määräaikaiselle työsuhteelle on annettava päättymispäivä |
| Attr. | type | Merkkijono | 1 | Linkitystyyppi, aina netvisor eli Netvisorin tunniste | netvisor |
| 3 | employmentform | Numeerinen | 0..1 | Työsuhteen tyyppi | 1 = Kokoaikainen 2 = Osa-aikainen |
| Attr. | type | Merkkijono | 1 | Linkitystyyppi, aina netvisor eli Netvisorin tunniste | netvisor |
| 3 | parttimepercent | Numeerinen | 0..1 | Osa-aikaisuuden prosentti | Sallittu arvo, desimaaliluku väliltä 0-100 Huom: employmentform oltava 2, jotta asetus huomioidaan Pyöristys lähimpään kahteen desimaaliin |
| 3 | regularworkinghours | Numeerinen | 0..1 | Säännöllinen työaika | Sallittu arvo, desimaaliluku väliltä 0-168 Pyöristys lähimpään kahteen desimaaliin |
| 3 | groundsforemployment | Numeerinen | 0..1 | Työsuhteen peruste | 0=Muu peruste 1=Työsuhde tai virkasuhde |
| 3 | kevaprofessionalclasscode | Numeerinen | 0..1 | Keva Ammattiluokan koodi, max 20 merkkiä. KEVA tietoja voi antaa vain jos yrityksellä on valittu palkanlaskennan asetuksista ”Yrityksen työeläkevakuuttaja on Keva”. | Kevan ammattiluokkien koodit: Keva: Ammattinimikkeiden haku |
| Attr. | type | Merkkijono | 1 | Aina keva | keva |
| Attr. | pensionprovidercode | Numeerinen | 0..1 | Työeläkelaitoksen yhtiötunnuksen koodi. Jos ei anneta, käytetään oletuksena arvoa ”20”. Määrää mitä arvoja hyväksytään kenttään kevaemploymentregistration. | Arvo löytyy KEVA:n koodistosta. Keva: Tulorekisterin koodisto Virheellisellä arvolla listataan sallitut arvot. |
| 3 | ispaymenttypemonthlywage | Numeerinen | 0..1 | Palkkauksen muoto: Kuukausipalkka | 1=kyllä 0=ei |
| 3 | ispaymenttypehourlywage | Numeerinen | 0..1 | Palkkauksen muoto: Tuntipalkka | 1=kyllä 0=ei |
| 3 | ispaymenttypepiecewage | Numeerinen | 0..1 | Palkkauksen muoto: Urakka | 1=kyllä 0=ei |
| 3 | collectiveagreement | Numeerinen | 0..1 | Työehtosopimus | Tulorekisterin työehtosopimuksen koodit: Tulorekisteri: Koodistot |
| Attr. | type | Merkkijono | 1 | aina cbacode | cbacode |
| 3 | stateemploymentfund | Numeerinen | 0..1 | Valtion työllisyysmäärärahoilla työllistetty | 1=kyllä 0=ei |
| 3 | carbenefityear | Numeerinen | 0..1 | Autoetuauton käyttöönottovuosi, max 4 merkkiä | 2022 |
| 3 | isabroadcarbenefit | Numeerinen | 0..1 | Autoetu on saatu ulkomailla | 1=kyllä 0=ei |
Palkansaajan työsuhteen muokkaus
Resurssi: editjobperiod.nv
Resurssilla voi muokata palkansaajan yhtä työsuhdetietoa. Sanomalla tarvitsee tuoda vain muuttuneet tiedot.
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| netvisorkey | 1 | Työsuhteen netvisorkey | 2 |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | employmentperiods | Aggregaatti | 1 | Työsuhteet | |
| 2 | employmentperiod | Aggregaatti | 1 | Työsuhde | |
| 3 | companystartdate | Päivämäärä | 0..1 | Yhtäjaksoisen työsuhteen alkupäivä | 2022-01-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto | |
| 3 | startdate | Päivämäärä | 0..1 | Alkamispäivä | 2022-01-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto | |
| 3 | probationenddate | Päivämäärä | 0..1 | Koeajan päättymispäivä | 2022-04-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto | |
| 3 | employmentmode | Numeerinen | 0..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 |
| 3 | profession | Merkkijono, maks. 250 | 0..1 | Ammattinimike | Specialist |
| 3 | comment | Merkkijono, maks. 500 | 0..1 | Kommentti | Uusi osaava tyyppi |
| 3 | enddate | Päivämäärä | 0..1 | Päättymispäivä | 2022-12-31 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto | ansi |
| 3 | endreason | Numeerinen | 0..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 |
| 3 | occupationclassification | Merkkijono | 0..1 | Ammattiluokka | Ammattiluokan TK10-koodi |
| Attr. | type | Merkkijono | 1 | Linkitystyyppi | Attribuutti type on aina isco |
| 3 | employmentcontract | Numeerinen | 0..1 | Työsuhteen voimassaolo | 1 = Toistaiseksi voimassa oleva 2 = Määräaikainen Huom: määräaikaiselle työsuhteelle on annettava päättymispäivä |
| Attr. | type | Merkkijono | 1 | Linkitystyyppi | Attribuutti type on aina netvisor, eli Netvisorin tunniste |
| 3 | employmentform | Numeerinen | 0..1 | Työsuhteen tyyppi | 1 = Kokoaikainen 2 = Osa-aikainen |
| Attr. | type | Merkkijono | 1 | Linkitystyyppi | Attribuutti type on aina netvisor, eli Netvisorin tunniste |
| 3 | parttimepercent | Numeerinen | 0..1 | Osa-aikaisuuden prosentti | Sallittu arvo, desimaaliluku väliltä 0-100 Huom: employmentform oltava 2, jotta asetus huomioidaan Pyöristys lähimpään kahteen desimaaliin |
| 3 | regularworkinghours | Numeerinen | 0..1 | Säännöllinen työaika | Sallittu arvo, desimaaliluku väliltä 0-168 Pyöristys lähimpään kahteen desimaaliin |
| 3 | groundsforemployment | Numeerinen | 0..1 | Työsuhteen peruste | 0=Muu peruste 1=Työsuhde tai virkasuhde |
| 3 | kevaprofessionalclasscode | Numeerinen | 0..1 | Keva Ammattiluokan koodi, max 20 merkkiä. KEVA tietoja voi antaa vain jos yrityksellä on valittu palkanlaskennan asetuksista ”Yrityksen työeläkevakuuttaja on Keva”. | Kevan ammattiluokkien koodit: Keva: Ammattinimikkeiden haku |
| 3 | kevaemploymentregistration | Numeerinen | 0..1 | Keva Palvelusuhteen rekisteröinti, max 2 merkkiä. | Kevan Palvelussuhteen rekisteröintikoodit: Keva: Tulorekisterin koodisto |
| Attr. | type | Merkkijono | 1 | Aina keva | keva |
| Attr. | pensionprovidercode | Numeerinen | 0..1 | Työeläkelaitoksen yhtiötunnuksen koodi. Jos ei anneta, käytetään oletuksena arvoa ”20”. Määrää mitä arvoja hyväksytään kenttään kevaemploymentregistration. | Arvo löytyy KEVA:n koodistosta Keva: Tulorekisterin koodisto Virheellisellä arvolla listataan sallitut arvot |
| 3 | ispaymenttypemonthlywage | Numeerinen | 0..1 | Palkkauksen muoto: Kuukausipalkka | 1=kyllä 0=ei |
| 3 | ispaymenttypehourlywage | Numeerinen | 0..1 | Palkkauksen muoto: Tuntipalkka | 1=kyllä 0=ei |
| 3 | ispaymenttypepiecewage | Numeerinen | 0..1 | Palkkauksen muoto: Urakka | 1=kyllä 0=ei |
| 3 | collectiveagreement | Numeerinen | 0..1 | Työehtosopimus | Tulorekisterin työehtosopimuksen koodit: Tulorekisteri: Koodistot |
| Attr. | type | Merkkijono | 1 | aina cbacode | cbacode |
| 3 | stateemploymentfund | Numeerinen | 0..1 | Valtion työllisyysmäärärahoilla työllistetty | 1=kyllä 0=ei |
| 3 | carbenefityear | Numeerinen | 0..1 | Autoetuauton käyttöönottovuosi, max 4 merkkiä | 2022 |
| 3 | isabroadcarbenefit | Numeerinen | 0..1 | Autoetu on saatu ulkomailla | 1=kyllä 0=ei |
Palkansaajan työsuhteen poisto
Resurssi: deletejobperiod.nv
Resurssilla voi poistaa palkansaajan yksittäisen työsuhteen. Palkansaajan työsuhteen netvisorkeyn saa noudettua palkansaajan nouto resurssilla (getempolyee.nv).
| Parametri | Ilmentymiä | Esimerkki | Kuvaus |
| netvisorkey | 1 | Pakollinen, työsuhteen netvisorkey | 12 |
Tilityspisteiden nouto
Resurssi: getpayrollparties.nv
Resurssi palauttaa yrityksen tilityspisteet.
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | payrollparties | Aggregaatti | 1 | ||
| 2 | party | Aggregaatti | 0..n | ||
| 3 | netvisorkey | Kokonaisluku | 1 | Tilityspisteen netvisorkey | 8 |
| 3 | name | Merkkijono | 1 | Tilityspisteen nimi | TyEL |
| 3 | partyinternaltype | Merkkijono | 1 | Tilityspisteen sisäinen tyyppi employeeworkpensioninsurance = Työeläkevakuutus employeeunemploymentinsurance = Työttömyysvakuutus employeeaccidentinsurance = Tapaturmavakuutus employeegrouplifeinsurance = Ryhmähenkivakuutus employeeunionmembershipfee = Ay-jäsenmaksu employeeforeclosure = Ulosotto employeeotherinsurance = Muu vakuutus | employeeworkpensioninsurance |
| 3 | useonlyinreporting | Kokonaisluku | 1 | Tilityspistettä käytetään vain raportoinnissa | 1 |
Palkansaajan liittäminen tilityspisteeseen
Resurssi: attachemployeetosettlementpoint.nv
Resurssilla voi liittää palkansaajan valittuun tilityspisteeseen.
Kutsussa käytettävät parametrit:
Joko netvisorkey, number tai personalidentificationnumber on pakollinen.
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| identifiertype | 1 | Sanoma kohdistetaan palkansaajaan joko netvisorkeyllä (netvisorkey), palkansaajanumerolla (number) tai henkilötunnuksella (personalidentificationnumber) | netvisorkey |
| identifier | 1 | Tunnisteen arvo, jolla kohdistus palkansaajaan tehdään | 3 |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | attachemployeetosettlementpoint | Aggregaatti | 1 | ||
| 2 | employeeinsurancetype | Kokonaisluku | 0..1 | Työeläkevakuutuksen tyyppi (Tyel, MYEL,YEL, Ei vakuutettu) | 1 = TyEL 2 = MYEL 3 = YEL 4 = Ei vakuutettu |
| 2 | employeesettlementpoints | Aggregaatti | 1 | ||
| 3 | employeeworkpensioninsurance | Aggregaatti | 0..1 | Työeläkevakuutus | |
| 4 | type | Merkkijono | 1 | Tilityspisteen käsittely | nohandling = Ei 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 | 0..1 | Tilityspisteen nimi (name ja/tai netvisorkey annettava) | TyEL |
| 4 | netvisorkey | Kokonaisluku | 0..1 | Tilityspisteen netvisorkey (name ja/tai netvisorkey annettava) | 8 |
| 4 | reporttoincomeregister | Kokonaisluku | 0..1 | Tilityspiste, joka ilmoitetaan tulorekisteriin (jos palkansaaja kytketty useampaan TyEL-tilityspisteeseen, tulee ilmoittaa, mikä niistä ilmoitetaan tulorekisteriin) | 1 |
| 3 | employeeunemploymentinsurance | Aggregaatti | 0..n | Työttömyysvakuutus | |
| 4 | type | Merkkijono | 1 | Tilityspisteen käsittely | nohandling = Ei käsittelyä automatichandling = Automaattinen käsittely under17yearsold = Alle 17-vuotias 17to64yearsold = 17-64 vuotias over65yearsold = yli 65-vuotias partowner = osaomistaja |
| 4 | name | Merkkijono | 0..1 | Tilityspisteen nimi (name ja/tai netvisorkey annettava) | Työttömyysvakuutus |
| 4 | netvisorkey | Kokonaisluku | 0..1 | Tilityspisteen netvisorkey (name ja/tai netvisorkey annettava) | 9 |
| 3 | employeeaccidentinsurance | Aggregaatti | 0..n | Tapaturmavakuutus | |
| 4 | type | Merkkijono | 1 | Tilityspisteen käsittely | nohandling tai attachedtosettlementpoint |
| 4 | name | Merkkijono | 0..1 | Tilityspisteen nimi (name ja/tai netvisorkey annettava) | Tapaturmavakuutus |
| 4 | netvisorkey | Kokonaisluku | 0..1 | Tilityspisteen netvisorkey (name ja/tai netvisorkey annettava) | 10 |
| 4 | reporttoincomeregister | Kokonaisluku | 0..1 | Tilityspiste, joka ilmoitetaan tulorekisteriin (jos palkansaaja kytketty useampaan TyEL-tilityspisteeseen, tulee ilmoittaa, mikä niistä ilmoitetaan tulorekisteriin) | |
| 3 | employeegrouplifeinsurance | Aggregaatti | 0..n | Ryhmähenkivakuutus | |
| 4 | type | Merkkijono | 1 | ||
| 4 | name | Merkkijono | 0..1 | ||
| 4 | netvisorkey | Kokonaisluku | 0..1 | Tilityspisteen netvisorkey (name ja/tai netvisorkey annettava) | 11 |
| 3 | employeeotherinsurance | Aggregaatti | 0..n | Muu vakuutus | |
| 4 | type | Merkkijono | 1 | Tilityspisteen käsittely | nohandling tai attachedtosettlementpoint |
| 4 | name | Merkkijono | 0..1 | Tilityspisteen nimi (name ja/tai netvisorkey annettava) | Muu vakuutus |
| 4 | netvisorkey | Kokonaisluku | 0..1 | Tilityspisteen netvisorkey (name ja/tai netvisorkey annettava) | 12 |
| 3 | employeeunionmembershipfee | Aggregaatti | 0..n | Ammattiliiton jäsenmaksu | |
| 4 | type | Merkkijono | 1 | Tilityspisteen käsittely | nohandling tai attachedtosettlementpoint |
| 4 | name | Merkkijono | 0..1 | Tilityspisteen nimi (name ja/tai netvisorkey annettava) | Ammattiliiton jäsenmaksu |
| 4 | netvisorkey | Kokonaisluku | 0..1 | Tilityspisteen netvisorkey (name ja/tai netvisorkey annettava) | 13 |
| 3 | employeeforeclosure | Aggregaatti | 0..n | Ulosmittaus | |
| 4 | type | Merkkijono | 1 | Tilityspisteen käsittely | nohandling tai attachedtosettlementpoint |
| 4 | name | Merkkijono | 0..1 | Tilityspisteen nimi (name ja/tai netvisorkey annettava) | Ulosotto |
| 4 | netvisorkey | Kokonaisluku | 0..1 | Tilityspisteen netvisorkey (name ja/tai netvisorkey annettava) | 14 |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedbackPahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.