Resurssit - Palkansaajat, palkkaperusteet ja palkkalaskelmat
Palkansaajien ja palkkalaskelmien käsittelyn toiminnot jakautuvat seuraaviin toimintoihin:
| Integraatio | HTTP-metodi | Resurssi | DTD | Esimerkki |
| Palkansaajan tuonti | POST | employee.nv | employee.dtd | |
| Palkansaajalistauksen nouto palkkaperusteita varten | GET | getemployeesalaryparameterslist.nv | - | |
| Palkansaajan palkkaperusteiden nouto | GET | getemployeesalaryparameters.nv | Lataa | |
| Palkansaajan palkkaperusteiden tuonti | POST | employeesalaryparameters.nv | employeesalaryparameters.xsd | Lataa |
| Palkkalajien nouto | GET | payrollratiolist.nv | Lataa | |
| Palkkalaskelman tuonti | POST | payrollpaycheckbatch.nv | payrollpaycheckbatch.dtd | Lataa |
| Palkkajaksokohtaisen kirjausrivin tuonti | POST | payrollperiodcollector.nv | payrollperiodcollector.dtd | Lataa |
| Palkkaennakon tuonti | POST | payrolladvance.nv | payrolladvance.dtd | |
| Ulkoisen palkanmaksuaineiston tuonti | POST | payrollexternalsalarypayment.nv | payrollexternalsalarypayment.dtd |
Resurssi: employee.nv
Palkansaajan tietojen tuonti Netvisoriin. 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 |
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 | 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 |
| Attribuutti | type | Merkkijono | 1 | Tunnistustiedon tyyppi, sallitut arvot: taxidentificationnumber foreignpersonalidentifier other |
foreignpersonalidentifier |
| 4 | issuingcountry | Merkkijono | 1 | Maa | AF |
| Attribuutti | 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 |
| Attribuutti | 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 | 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 | 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 |
| Attribuutti | format | Merkkijono | 1 | 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 | 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 |
| Attribuutti | 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 |
| Attribuutti | 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 |
| Attribuutti | type | Merkkijono | 1 | Toimitustavan linkitystyyppi |
Attribuutti type on aina netvisor, eli Netvisorin tunniste |
| 3 | isjointowner | Numeerinen | 0...1 |
Osakasasemassa maksajaan
|
1=kyllä |
| 3 | isathlete | Numeerinen | 0...1 | Urheilija
|
1=kyllä |
| 3 | isperformingartist | Numeerinen | 0...1 |
Esiintyvä taitelija
|
1=kyllä |
| 3 | employeeinsurancetype | Numeerinen | 0...1 |
Työeläkevakuutuksen tyyppi
|
1=Tyel |
| 2 | employmentperiods | Aggregaatti | 0...1 | Työsuhteet | |
| 3 | employmentperiod | Aggregaatti | 1...n | Työsuhde | |
| 4 | companystartdate | Päivämäärä | 0...1 | Yhtäjaksoisen työsuhteen alkupäivä | 2017-01-01 |
| Attribuutti | format | Merkkijono | 1 | Päivämäärän muoto | ansi |
| 4 | startdate | Päivämäärä | 1 | Alkamispäivä | 2017-01-01 |
| Attribuutti | 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 |
| Attribuutti | format | Merkkijono | 1 | Päivämäärän muoto | ansi |
| 4 | employmentmode | Numeerinen | 0...1 | Työsuhteen tapa |
1 = työsuhteinen |
| Attribuutti | 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 |
| Attribuutti | format | Merkkijono | 1 | Päivämäärän muoto | ansi |
| 4 | endreason | Numeerinen | 0...1 | Päättymisen syy |
2=Työntekijän vanhuuseläke (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) |
| Attribuutti | type | Merkkijono | 1 | Päättymisen linkitystyyppi |
Attribuutti type on aina netvisor, eli Netvisorin tunniste |
| 4 | occupationclassification | Merkkijono | 0...1 | Ammattiluokka | Ammattiluokan TK10-koodi |
| Attribuutti | 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ä |
| Attribuutti | 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 |
| Attribuutti | 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 |
| 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: https://www.keva.fi/tyonantajalle/elakemaksut/ammattinimikkeiden-haku/
|
| 4 | kevaemploymentregistration | Numeerinen | 0...1 |
Keva Palvelusuhteen rekisteröinti, max 2 merkkiä. |
Kevan Palelussuheen rekisteröinti koodit: https://www.keva.fi/globalassets/2-tiedostot/ta-tiedostot/tyonantajien-ohjeet/kevan-tulorekisteriaikainen-koodisto.pdf |
| Atribuutti | type | Merkkijono | 1 | aina keva | keva |
| Atribuutti | 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 https://www.keva.fi/globalassets/2-tiedostot/ta-tiedostot/tyonantajien-ohjeet/kevan-tulorekisteriaikainen-koodisto.pdf Virheellisellä arvolla listataan sallitut arvot. |
| 4 | ispaymenttypemonthlywage | Numeerinen | 0...1 | Palkkauksen muoto: Kuukausipalkka |
1=kyllä |
| 4 | ispaymenttypehourlywage | Numeerinen | 0...1 | Palkkauksen muoto: Tuntipalkka |
1=kyllä |
| 4 | ispaymenttypepiecewage | Numeerinen | 0...1 | Palkkauksen muoto: Urakka |
1=kyllä |
| 4 | collectiveagreement | Numeerinen | 0...1 | Työehtosopimus | Tulorekisterin työhetosopimuksen koodit: https://www.vero.fi/globalassets/tulorekisteri/koodistot.pdf |
| Atribuutti | 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 |
| 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 | Automaattinen käsittely=automatichandling 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 |
*) 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
Palkansaajalistauksen nouto palkkaperusteita varten
Resurssi: getemployeesalaryparameterslist.nv
Resurssilla on mahdollista hakea listaus palkansaajista, joiden palkkaperusteita voidaan rajapinnan kautta käsitellä. Tarkemman kuvauksen resurssista saat Netvisor kumppanituelta, kumppanit.netvisor@visma.com. Resurssi on kumppanikohtaisesti erikseen päälle kytkettävä.
Palkansaajan palkkaperusteiden nouto
Resurssi: getemployeesalaryparameters.nv
Jos palkkaperusteella ei ole arvoa, palautuu value-elementti tyhjänä elementtinä (<value/>), kun taas nolla-arvo palautuu normaalina arvona (<value>0,0</value>).
Resurssin kautta voi hakea halutun palkansaajan palkkaperusteet. Kutsussa käytettävät parametrit (GET):
| Parametri | Ilmentymiä | Kuvaus |
| identifiertype | 1 | Arvo: pin = palkansaajan HETU tai number = palkansaajan numero |
| 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 | salaryparameters | Aggregaatti | 1 | ||
| 3 | parameter | Aggregaatti | 0...n | ||
| 4 | rationumber | Numero | 1 | Palkkaperusteen kirjauslajin 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 |
| Attribuutti | Type | Teksti | 1 |
Palkansaajan tunnisteen tyyppi: |
pin |
| 2 | salaryparameters | Aggregaatti | 1 | ||
| 3 | salaryparameter | Aggregaatti | 1...24 | ||
| 4 | rationumber | Numero | 1 | Palkkaperusteen kirjauslajin numero (yrityskohtaiset palkkalajit) | 123 |
| 4 | value | Desimaaliluku | 0...1 | Palkkaperusteen arvo | 12,30 |
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: |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | root | Aggregaatti | 1 | ||
| 1 | PayrollRatios | Aggregaatti | 1 | ||
| 2 | PayrollRatio | Aggregaatti | 0...n | ||
| 3 | Name | Teksti | 1-3 | Palkkalajin nimi | Ulkomaan päiväraha |
| Attribuutti | ISO639-1Code | Teksti | 1 | Palkkalajin nimen kielitieto: fi,se, en | fi |
| 3 | Identifier | Numero | 1 | Palkkalajin ID | 1 |
| 3 | Source | Teksti | 1 | Palkkalajin tyyppi | Matkalasku, kulurivit |
| 3 | RatioNumber | Numero | 1 | Palkkalajin numero | 123 |
| 3 | DefaultDebitAccountNumber | Numero | 1 | Kirjanpidon debet-tili | 7890 |
| 3 | DefaultCreditAccountNumber | Numero | 1 | Kirjanpidon kredit-tili | 2961 |
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 |
| Attribuutti | type | Merkkijono | 1 | Linkitystyyppi, employeenumber tai finnishpersonalidentifier | finnishpersonalidentifier |
| 2 | rulegroupperiodstart | Päivämäärä | 1 | Palkkajakson alkupäivämäärä *1) | 2009-12-31 |
| Attribuutti | 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) | 2009-12-31 |
| Attribuutti | 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ä | 2009-12-31 |
| Attribuutti | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| 2 | valuedate | Päivämäärä | 0...1 | 2009-12-31 | |
| Attribuutti | 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 |
| Attribuutti | 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 | 3000 |
| 3 | linedescription | Merkkijono | 0...1 | Rivikuvaus | |
| 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 | |
| Attribuutti | format | Merkkijono | 1 | Aina ansi | |
| 2 | employeeidentifier | Merkkijono | 1 |
Palkansaajan tunnus. Palkansaaja, jolle kirjausrivit luodaan |
|
| Attribuutti | 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 | |
| Attribuutti | 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 | |
| Attribuutti | fatherid | 0...1 | Laskentakohteen "vanhemman" (parent) tunnus |
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.
Palkkaennakon maksun tuonti
| 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 | |
| Attribuutti | type | Merkkijono | 0...1 | Joko number tai finnishpersonalidentifier, eli palkansaajan numero tai suomalainen hetu | |
| 2 | paymentdate | Päivämäärä | 1 | Päivämäärä, jolloin ennakko lähtee maksuun. Ei voi olla kuluvaa päivää aikaisempi | |
| Attribuutti | format | Merkkijono | 0 | Aina ansi (Huom! DTDssä virhe, jos attribuutti lisätään, aiheuttaa virheen) | |
| 2 | advancesum | Numeerinen | 1 | Palkkaennakon määrä | |
| Attribuutti | 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.
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| Root | Root | Aggregaatti | 1 | ||
| 1 | payrollexternalsalarypayment | Aggregaatti | 1 | ||
| 2 | description | Merkkijono | 1 | Tapahtuman kuvaus. Vapaamuotoinen selite |
Ulkoinen maksu |
| 2 | paymentdate | Päivämäärä | 1 | Maksupäivä = palkkapäivä, palkanmaksu on silloin palkansaajan tilillä | 2017-01-01 |
| Attribuutti | format | Merkkijono | ansi | ansi | |
| 2 | duedate | Päivämäärä | 1 | Eräpäivä, palkka veloitetaan yrityksen tililtä | 2017-01-01 |
| Attribuutti | 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 | 1 | Suomalainen henkilötunnus |
140785-xxyy |
| 2 | realname | Merkkijono | 1 | Palkansaajan nimi |
Erkki Esimerkki |
Annetaan jompi kumpi paymentdate tai duedate
Elementtien (paymentdate, duedate) terminologia on SEPA-tilisiirtostandardin mukainen:
SEPA Palkat Tiedote Tammikuu 2009
Maksupäivän sijasta maksutoimeksiannolla annetaan maksajan tilin veloituspäivä, jonka perusteella pankit huolehtivat että palkat ja eläkkeet ovat saajien tileillä kaikissa Suomessa toimivissa pankeissa palkkapäivänä. Tämän eräpäivän tulee olla pankkipäivä ja sen on oltavan palkkapäivää edeltävä pankkipäivä.
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.
Maksupäivä (paymentdate) = palkkapäivä, palkanmaksu on silloin palkansaajan tilillä.
Ei tehdä pankkipäivien tulkintaa tässä vaiheessa, vaan tulkitaan maksatuksessa.