Työajan ja matkalaskujen käsittelyn toiminnot jakautuvat seuraaviin toimintoihin:
| Integraatio | HTTP-metodi | Resurssi | DTD | Esimerkki |
| Matkalaskun tuonti | POST | tripexpense.nv | tripexpense.dtd | Lataa |
| Työaikatietojen tuonti | POST | workday.nv | workday.dtd | Lataa |
| Työaikatietojen nouto | GET | getworkday.nv | Lataa | |
| Työaikatietojen nouto aikaväliltä | GET | getworkdays.nv | Lataa |
Huomaathan artikkelin HRM-integraatioiden suositelluista toimintamalleista.
Matkalaskun tuonti
Resurssi: tripexpense.nv
Palkansaajalla tulee olla Matkat -palvelu aktiivisena, jotta hänelle voidaan tuoda matkalasku rajapinnan yli.
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 | tripexpense | Aggregaatti | 1 | ||
| 2 | header | Merkkijono | 1 | Matkalaskun otsikko | Asiakastapaaminen |
| 2 | description | Merkkijono | 0...1 | Vapaa kuvaus matkalaskusta | |
| 2 | customlines | Aggregaatti | 0...1 | ||
| 3 | customline | Aggregaatti | 1...n | ||
| 4 | employeeidentifier | Merkkijono | 1 | Palkansaajan linkitystieto, joko henkilötunnus, numero tai netvisorkey | 140785-xxxx |
| Attr. | type | Merkkijono | 0...1 | Joko number (=palkansaajan numero) tai finnishpersonalidentifier (=suomalainen henkilötunnus) | finnishpersonalidentifier |
| 4 | ratio | Merkkijono | 1 | Kululaji Kutsun headerin X-Netvisor-Interface-Language=FI asetus vaikuttaa käytettävän ration nimeen | majoituskulut |
| Attr. | type | Merkkijono | 1 | Kululajin linkitystapa name | name |
| 4 | amount | Numeerinen | 1 | Kappalemäärä | 1,00 |
| 4 | customlineunitprice | Numeerinen | 1 | Yksikköhinta | 150,00 |
| Attr. | iso4217currencycode | Merkkijono | 0...1 | Käytettävä valuutta | EUR |
| Attr. | currencyrate | Numeerinen | 0...1 | Valuutan vaihtokurssi | |
| 4 | vatpercentage | Numeerinen | 0...1 | Alv-prosentti | 24 |
| 4 | linedescription | Merkkijono | 1 | Riviselite | Hotellilasku |
| 4 | begindate | Päivämäärä | 1 | Alkupäivämäärä | 2018-10-05 |
| 4 | enddate | Päivämäärä | 1 | Loppupäivämäärä | 2018-10-05 |
| 4 | crmprocessidentifier | Merkkijono | 0...1 | CRM-tehtävän tunnistetieto | |
| 4 | customeridentifier | Merkkijono | 0...1 | Asiakkaan linkitystieto, joko id tai asiakaskoodi | NV#12345 |
| Attr. | type | Merkkijono | 0...1 | Asiakaslinkityksen tapa, joko netvisor tai customer | customer |
| 4 | expenseaccountnumber | Numeerinen | 0...1 | Kulun tilinumero. Yliajaa kululajin takana annetun tilinumeron | 7010 |
| 4 | linestatus | Merkkijono | 0...1 | Matkalaskurivin tila -tieto. Tilat ovat open (Keskeneräinen), confirmed (Kuitattu), contentsupervisored (Asiatarkastettu), accepted (Hyväksytty) ja paid (maksettu). Mikäli elementtiä ei anneta sanomalla, näkyy se Netvisorissa keskeneräisenä (open). | Paid |
| 4 | dimension | Aggregaatti | 0...n | ||
| 5 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko, jos otsikkoa ei löydy, järjestelmä perustaa sen | Projekti 1 |
| 5 | dimensionitem | Merkkijono | 1 | Laskentakohde, jos kohdetta ei löydy, järjestelmä perustaa sen | Matkakustannukset |
| Attr. | fatherid | Numeerinen | 0...1 | ||
| 4 | tripexpenseattachments | Aggregaatti | 0...1 | ||
| 5 | tripexpenseattachment | Aggregaatti | 1...n | ||
| 6 | mimetype | Merkkijono | 1 | Liitteen MIME tyyppi | Application/pdf |
| 6 | attachmentdescription | Merkkijono | 1 | Liitteen kuvaus | Hotellilaskukopio |
| 6 | filename | Merkkijono | 1 | Liitteen tiedostonimi | Lasku.pdf |
| 6 | documentdata | Merkkijono | 1 | Base64 enkoodattu tiedoston data | S89O3Ly1Lr59NB |
| 2 | travellines | Aggregaatti | 0...1 | ||
| 3 | travelline | Aggregaatti | 1...n | ||
| 4 | employeeidentifier | Merkkijono | 1 | Työntekijän linkitystieto, numero tai henkilötunnus | 1342 |
| Attr. | type | Merkkijono | 0...1 | linkityksen tyyppi, joko number tai finnishpersonalidentifier | number |
| 4 | traveltype | Merkkijono | 1 | Matkustustyyppi, sallitut arvot: car, car_with_trailer, car_with_caravan, car_with_heavy_cargo, car_with_big_machinery, car_with_dog, car_travel_in_rough_terrain, motorboat_max_50hp, motorboat_over_50hp, snowmobile, atv, motorbike, moped, other, carbenefit | car |
| 4 | passengeramount | Numeerinen | 1 | Matkustajien määrä | 2 |
| 4 | kilometeramount | Numeerinen | 1 | Kilometrien määrä | 300 |
| 4 | unitprice | Numeerinen | 0...1 | Yksikköhinta, jos ei annettu, haetaan järjestelmästä kilometrikorvauksen tyypin perusteella | |
| 4 | linedescription | Merkkijono | 1 | Riviselite | Matka Helsinkiin |
| 4 | traveldate | Päivämäärä | 1 | Matkustuspäivä | 2014-10-17 |
| 4 | routedescription | Merkkijono | 1 | Reittikuvaus | Valtatie 6 |
| 4 | crmprocessidentifier | Merkkijono | 0...1 | CRM-tehtävän tunnistetieto | |
| 4 | customeridentifier | Merkkijono | 0...1 | Asiakkaan linkitystieto, joko id tai asiakaskoodi | |
| Attr. | type | Merkkijono | 0...1 | linkitystiedon tyyppi netvisor tai customer | customer |
| 4 | linestatus | Merkkijono | 0...1 | Matkalaskurivin tila -tieto. Tilat ovat open (Keskeneräinen), confirmed (Kuitattu), contentsupervisored (Asiatarkastettu), accepted (Hyväksytty) ja paid (maksettu). Mikäli elementtiä ei anneta sanomalla, näkyy se Netvisorissa keskeneräisenä (open). | Paid |
| 4 | dimension | Aggregaatti | 0...n | ||
| 5 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko | |
| 5 | dimensionitem | Merkkijono | 1 | Laskentakohde | |
| Attr. | fatherid | Numeerinen | 0...1 | ||
| 4 | tripexpenseattachments | Aggregaatti | 0...1 | ||
| 5 | tripexpenseattachment | Aggregaatti | 1...n | ||
| 6 | mimetype | Merkkijono | 1 | Liitteen MIME tyyppi | Application/pdf |
| 6 | attachmentdescription | Merkkijono | 1 | Liitteen kuvaus | |
| 6 | filename | Merkkijono | 1 | Liitteen tiedostonimi | |
| 6 | documentdata | Merkkijono | 1 | Liitteen data base64 enkoodattuna | |
| 2 | dailycompensationlines | Aggregaatti | 0...1 | ||
| 3 | dailycompensationline | Aggregaatti | 1...n | ||
| 4 | employeeidentifier | Merkkijono | 1 | Työntekijän linkitys, joko numero tai henkilötunnus | 140785-xxxx |
| Attr. | type | Merkkijono | 0...1 | Linkityksen tyyppi, joko number tai finnishpersonalidentifier | finnishpersonalidentifier |
| 4 | compensationtype | Merkkijono | 1 | Päivärahan tyyppi, domesticfull, domestichalf tai foreign | DomesticFull |
| 4 | amount | Numeerinen | 1 | Päivärahan määrä | 1 |
| 4 | unitprice | Numeerinen | 0...1 | Yksikköhinta | 500,00 |
| 4 | linedescription | Merkkijono | 1 | Riviselite | Päivä Helsingissä |
| 4 | timeofdeparture | Päivämäärä ja aika | 1 | Lähtöaika | 2014-10-03 8:00:00 |
| 4 | returntime | Päivämäärä ja aika | 1 | Paluuaika | 2014-10-03 18:00:00 |
| 4 | crmprocessidentifier | Merkkijono | 0...1 | CRM-tehtävän tunnistetieto | NV#12345 |
| 4 | customeridentifier | Merkkijono | 0...1 | Asiakakkaan linkitystieto, joko id tai numero | |
| Attr. | type | Merkkijono | 0...1 | Linkitystiedon tyyppi netvisor tai customer | netvisor |
| 4 | linestatus | Merkkijono | 0...1 | Matkalaskurivin tila -tieto. Tilat ovat open (Keskeneräinen), confirmed (Kuitattu), contentsupervisored (Asiatarkastettu), accepted (Hyväksytty) ja paid (maksettu). Mikäli elementtiä ei anneta sanomalla, näkyy se Netvisorissa keskeneräisenä (open). | Paid |
| 4 | dimension | Aggregaatti | 0...n | ||
| 5 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko | |
| 5 | dimensionitem | Merkkijono | 1 | Laskentakohde | |
| Attr. | fatherid | Numeerinen | 0...1 | ||
| 4 | tripexpenseattachments | Aggregaatti | 0...1 | ||
| 5 | tripexpenseattachment | Aggregaatti | 1...n | ||
| 6 | mimetype | Merkkijono | 1 | Liitteen MIME-tyyppi | |
| 6 | attachmentdescription | Merkkijono | 1 | Liiteen kuvaus | |
| 6 | filename | Merkkijono | 1 | Litteen tiedostonimi | |
| 6 | documentdata | Merkkijono | 1 | Liitteen data base64 enkoodattuna |
Työaikatietojen tuonti
Resurssi: workday.nv
Työaikatietojen tuonti Netvisoriin. Työaikaa voidaan tuoda joko tunteina (workdayhour) tai kelloajan mukaan (workdaytime).
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 | workday | Aggregaatti | 1 | ||
| 2 | date | Päivämäärä | 1 | Päivä jolle tuntikirjaukset tehdään | 2018-10-01 |
| Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
| Attr. | method | Merkkijono | 0...1 | Tuonnin tyyppi päivälle, replace tai increment. Oletuksena replace. | replace |
| 2 | employeeidentifier | Merkkijono | 1 | Palkansaajan linkitystieto | 1407 |
| Attr. | type | Merkkijono | 0...1 | Linkitystiedon tyyppi, number tai personalidentificationnumber tai netvisorkey | number |
| Attr. | defaultdimensionhandlingtype | Merkkijono | 0...1 | Laskentakohteen hallinnan oletus: none tai usedefault Kunnioitetaanko palkansaajan taakse asetettuja oletuslaskentakohteita vai ei | usedefault |
| 2 | workdayhour | Aggregaatti | 0...n | ||
| 3 | hours | Numeerinen | 1 | Työaikakirjauksen tunnit (* , Netvisor pyöristää kahteen desimaaliin | 7,5 |
| 3 | collectorratio | Merkkijono | 1 | Kirjauslaji, lajin on löydyttävä Netvisorista | 11 |
| Attr. | type | Merkkijono | 0...1 | Kirjauslajin linkitystiedon tyyppi, aina number | number |
| 3 | acceptancestatus | Merkkijono | 1 | Työaikakirjausrivin tila, joko confirmed (kuitattu) tai accepted (hyväksytty) | confirmed |
| 3 | description | Merkkijono | 1 | Työaikakirjausrivin kuvaus | Tavalliset työtehtävät |
| 3 | crmprocessidentifier | Merkkijono | 0...1 | CRM tehtävän linkitystieto | NV#4321 |
| Attr. | billingtype | Merkkijono | 1 | Laskutustyyppi, billable tai unbillable | billable |
| 3 | invoicingproductidentifier | Merkkijono | 0...1 | ||
| 3 | customeridentifier | Merkkijono | 0...1 | Laskutusasiakas | Testiasiakas |
| Attr. | type | Merkkijono | 1 | netvisor tai customer | netvisor |
| 3 | dimension | Aggregaatti | 0...n | ||
| 4 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko, jos otsikkoa ei löydy, se perustetaan | Projekti |
| 4 | dimensionitem | Merkkijono | 1 | Laskentakohde, jos kohdetta ei löydy, se perustetaan | Palkanlaskenta |
| Attr. | fatherid | Numeerinen | 0...1 | 33 | |
| 2 | workdaytime | Aggregaatti | 0...n | ||
| 3 | starttimeofday | Numeerinen | 1 | Työaikakirjauksen aloitusaika | 08:00 |
| 3 | endtimeofday | Numeerinen | 1 | Työaikakirjauksen lopetusaika | 16:00 |
| 3 | breaktime | Numeerinen | 1 | Taukoaika minuutteina | 30 |
| Attr. | type | Merkkijono | aina minutes | minutes | |
| 3 | collectorratio | Merkkijono | 1 | Kirjauslajin linkitystiedon tyyppi, aina number | 11 |
| Attr. | type | Merkkijono | 0...1 | aina number | number |
| 3 | acceptancestatus | Merkkijono | 1 | Työaikakirjausrivin tila, joko confirmed (kuitattu) tai accepted (hyväksytty) | confirmed |
| 3 | description | Merkkijono | 1 | Työaikakirjausrivin kuvaus | |
| 3 | invoicingproductidentifier | Merkkijono | 0...1 | ||
| 3 | dimension | Aggregaatti | 0...n | ||
| 4 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko, jos otsikkoa ei löydy, se perustetaan | Projekti |
| 4 | dimensionitem | Merkkijono | 1 | Laskentakohde, jos kohdetta ei löydy, se perustetaan | Palkanlaskenta |
*) Voit tuoda resurssilla myös työaikatietoja, joiden kirjauslajin yksikkö on 'Päivä' kuten lomapäiviä. Tällöin tulee elementille hours antaa arvoksi päivien lukumäärä (esim. 1, jolloin työaikatietoihin kirjataan yksi päivä). Että Netvisorin lomalaskenta toimisi oikein, pitäisi lomapäivät tuoda aina arvolla 1.
Työaikatietojen nouto
Resurssi: getworkday.nv
Nouto palauttaa yhden palkansaajan yhden työpäivän tuntikirjaukset. Haku aina palkansaajan numerolla.
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| employeenumber | 1 | Palkansaajan numero Netvisorin palkansaajan tiedoissa Huom! Jos tämä parametri annetaan, älä anna parametriä netvisorkey. | 1407 |
| netvisorkey | 1 | Palkansaajan netvisorkey Huom! Jos tämä parametri annetaan, älä anna parametriä netvisorkey. | 12345 |
| workhourdate | 1 | Päivämäärä | 2017-06-20 |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymä | Kuvaus | Esimerkki |
| root | Root | Aggregaatti | 1 | ||
| 1 | Workday | Aggregaatti | 1 | ||
| 2 | Date | Päivämäärä | 1 | Päivämäärä | 2017-06-20 |
| 2 | WorkdayHour | Aggregaatti | 0...n | ||
| 3 | Hours | Desimaaliluku | 1 | Tuntimäärä | 7,5 |
| 3 | CollectorRatio | Teksti | 1 | Kirjauslaji | Normaali tuntityö |
| Attr. | Number | Kokonaisluku | 1 | Kirjauslajin numero | 1 |
| 3 | AcceptanceStatus | Teksti | 1 | Avoin, Kuitattu ja Hyväksytty | Hyväksytty |
| 3 | Description | Teksti | 1 | Selite | |
| 3 | CrmProcessName | Teksti | 1 | Tuntikirjaukseen linkitetyn CRM- tehtävän nimi | |
| 3 | Dimension | Aggregaatti | 0...n | ||
| 4 | DimensionName | Teksti | 1 | Laskentakohdeotsikko | Projekti |
| 4 | DimensionItem | Teksti | 1 | Laskentakohde | Projekti 1 |
Työaikatietojen nouto aikaväliltä
Resurssi: getworkdays.nv
Nouto palauttaa yhden palkansaajan työaikatiedot valitulta aikajaksolta. Aikajakso voi olla enintään yhden kalenterivuoden mittainen. Haku joko palkansaajan netvisorkey:lla tai palkansaajanumerolla.
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| netvisorkey | 0...1 | Palkansaajan netvisorkey Huom! Jos tämä parametri annetaan, älä anna parametria employeenumber | 1 |
| employeenumber | 0...1 | Palkansaajan numero Netvisorin palkansaajan tiedoissa Huom! Jos tämä parametri annetaan, älä anna parametria employeenumber | 1407 |
| workhourstartdate | 1 | Pakollinen, alkupäivämäärä | 2022-01-01 |
| workhourenddate | 1 | Pakollinen, alkupäivämäärä | 2022-12-31 |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymä | Kuvaus | Esimerkki |
| root | Root | Aggregaatti | 1 | ||
| 1 | Workdays | Aggregaatti | 1 | ||
| 2 | Workday | Aggregaatti | 0...n | ||
| 3 | Date | Päivämäärä | 1 | Päivämäärä | 2022-01-01 |
| 3 | WorkDayHour | Aggregaatti | 0...n | ||
| Attr | Netvisorkey | Merkkijono | 1 | Työaikakirjauksen Netvisorkey | |
| 4 | Hours | Desimaaliluku | 1 | Tuntimäärä | 7,5 |
| 4 | CollectorRatio | Teksti | 1 | Kirjauslaji | Normaali tuntityö |
| Attr. | Number | Kokonaisluku | 1 | Kirjauslajin numero | 1 |
| Attr. | Netvisorkey | Merkkijono | 1 | Kirjauslajin Netvisorkey | |
| 4 | AcceptanceStatus | Teksti | 1 | Avoin, Kuitattu ja Hyväksytty | Hyväksytty |
| 4 | Description | Teksti | 1 | Selite | |
| 4 | CrmProcessName | Teksti | 1 | Tuntikirjaukseen linkitetyn CRM- tehtävän nimi | |
| 4 | Dimension | Aggregaatti | 0...n | ||
| 5 | DimensionName | Teksti | 1 | Laskentakohdeotsikko | Projekti |
| 5 | DimensionItem | Teksti | 1 | Laskentakohde | Projekti 1 |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedbackPahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.