Behandlingen av arbetstid och reseräkningar är uppdelad i följande funktioner:
| Integration | HTTP-metod | Resurs | DTD | Exempel |
| Importera reseräkning | POST | tripexpense.nv | tripexpense.dtd | Ladda ner |
| Import av arbetstidsuppgifter | POST | workday.nv | workday.dtd | Ladda ner |
| Hämta arbetstidsuppgifter | GET | getworkday.nv | Ladda ner |
Observera artikeln om rekommenderad praxis för HRM-integrationer.
Importera reseräkning
Resurs: tripexpense.nv
Löntagaren måste ha Resor-tjänsten aktiverad för att kunna importera en reseräkning över gränssnittet.
Data som ska importeras skickas med anropet som XML (POST-data) enligt vidstående beskrivning:
| Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
| Root | root | Aggregat | 1 | ||
| 1 | tripexpense | Aggregat | 1 | ||
| 2 | header | Teckensträng | 1 | Reseräkningens rubrik | Kundmöte |
| 2 | description | Teckensträng | 0...1 | Fri beskrivning av reseräkning | |
| 2 | customlines | Aggregat | 0...1 | ||
| 3 | customline | Aggregat | 1...n | ||
| 4 | employeeidentifier | Teckensträng | 1 | Kundens länkningauppgift, antingen personbeteckning eller nummer | 140785-xxxx |
| Attr. | type | Teckensträng | 0...1 | Antingen number (löntagarens nummer) eller finnishpersonalidentifier (finsk personbeteckning) | finnishpersonalidentifier |
| 4 | ratio | Teckensträng | 1 | Kostnadsslag Inställningen för anropets header X-Netvisor-Interface-Language=FI påverkar namnet på använd ration | logikostnader |
| Attr. | type | Teckensträng | 1 | Kostnadsslagets länkningssätt name | name |
| 4 | amount | Numerisk | 1 | Styckeantal | 1,00 |
| 4 | customlineunitprice | Numerisk | 1 | Enhetspris | 150,00 |
| Attr. | iso4217currencycode | Teckensträng | 0...1 | Använd valuta | EUR |
| Attr. | currencyrate | Numerisk | 0...1 | Valutans växelkurs | |
| 4 | vatpercentage | Numerisk | 0...1 | Momsprocent | 24 |
| 4 | linedescription | Teckensträng | 1 | Radförklaring | Hotellräkning |
| 4 | begindate | Datum | 1 | Begynnelsedatum | 2018-10-05 |
| 4 | enddate | Datum | 1 | Slutdatum | 2018-10-05 |
| 4 | crmprocessidentifier | Teckensträng | 0...1 | CRM-uppdragets ID-uppgift | |
| 4 | customeridentifier | Teckensträng | 0...1 | Kundens länkningsuppgift, antingen id eller kundkod | NV#12345 |
| Attr. | type | Teckensträng | 0...1 | Kundlänkningssätt, antingen netvisor eller customer | customer |
| 4 | expenseaccountnumber | Numerisk | 0...1 | Kostnadens kontonummer. Åsidosätter det kontonummer som givits bakom kostnadsslaget | 7010 |
| 4 | linestatus | Teckensträng | 0...1 | Reseräkningsradens statusuppgift. Ges bara om betald | Paid |
| 4 | dimension | Aggregat | 0...n | ||
| 5 | dimensionname | Teckensträng | 1 | Räkenskapsobjektets rubrik, om det inte finns en rubrik grundar systemet den | Projekt 1 |
| 5 | dimensionitem | Teckensträng | 1 | Räkenskapsobjekt, om objektet inte hittas grundar systemet det. | Resekostnader |
| Attr. | fatherid | Numerisk | 0...1 | ||
| 4 | tripexpenseattachments | Aggregat | 0...1 | ||
| 5 | tripexpenseattachment | Aggregat | 1...n | ||
| 6 | mimetype | Teckensträng | 1 | Bilagans MIME-typ | Application/pdf |
| 6 | attachmentdescription | Teckensträng | 1 | Bilagans beskrivning | Hotellräkningskopia |
| 6 | filename | Teckensträng | 1 | Bilagans filnamn | Faktura.pdf |
| 6 | documentdata | Teckensträng | 1 | Base64-kodad fils data | S89O3Ly1Lr59NB |
| 2 | travellines | Aggregat | 0...1 | ||
| 3 | travelline | Aggregat | 1...n | ||
| 4 | employeeidentifier | Teckensträng | 1 | Arbetstagarens länkningsuppgift, nummer eller personbeteckning | 1342 |
| Attr. | type | Teckensträng | 0...1 | länkningstyp, antingen number eller finnishpersonalidentifier | number |
| 4 | traveltype | Teckensträng | 1 | Resetyp, tillåtna värden: 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 | Numerisk | 1 | Antal resenärer | 2 |
| 4 | kilometeramount | Numerisk | 1 | Kilometerantal | 300 |
| 4 | unitprice | Numerisk | 0...1 | Enhetspris, om inte angivet hämtas det från systemet på basis av kilometerersättningens typ | |
| 4 | linedescription | Teckensträng | 1 | Radförklaring | Resa till Helsingfors |
| 4 | traveldate | Datum | 1 | Resedag | 2014-10-17 |
| 4 | routedescription | Teckensträng | 1 | Ruttbeskrivning | Valtatie 6 |
| 4 | crmprocessidentifier | Teckensträng | 0...1 | CRM-uppdragets ID-uppgift | |
| 4 | customeridentifier | Teckensträng | 0...1 | Kundens länkningsuppgift, antingen id eller kundkod | |
| Attr. | type | Teckensträng | 0...1 | länkningsuppgiftens typ netvisor eller customer | customer |
| 4 | dimension | Aggregat | 0...n | ||
| 5 | dimensionname | Teckensträng | 1 | Räkenskapsobjektsrubrik | |
| 5 | dimensionitem | Teckensträng | 1 | Räkenskapsobjekt | |
| Attr. | fatherid | Numerisk | 0...1 | ||
| 4 | tripexpenseattachments | Aggregat | 0...1 | ||
| 5 | tripexpenseattachment | Aggregat | 1...n | ||
| 6 | mimetype | Teckensträng | 1 | Bilagans MIME-typ | Application/pdf |
| 6 | attachmentdescription | Teckensträng | 1 | Bilagans beskrivning | |
| 6 | filename | Teckensträng | 1 | Bilagans filnamn | |
| 6 | documentdata | Teckensträng | 1 | Bilagans data base64-kodade | |
| 2 | dailycompensationlines | Aggregat | 0...1 | ||
| 3 | dailycompensationline | Aggregat | 1...n | ||
| 4 | employeeidentifier | Teckensträng | 1 | Arbetstagarens länkning, antingen nummer eller personbeteckning | 140785-xxxx |
| Attr. | type | Teckensträng | 0...1 | Länkningstyp, antingen number eller finnishpersonalidentifier | finnishpersonalidentifier |
| 4 | compensationtype | Teckensträng | 1 | Dagtraktamentets typ, domesticfull, domestichalf eller foreign | DomesticFull |
| 4 | amount | Numerisk | 1 | Dagtraktamentets belopp | 1 |
| 4 | unitprice | Numerisk | 0...1 | Enhetspris | 500,00 |
| 4 | linedescription | Teckensträng | 1 | Radförklaring | En dag i Helsingfors |
| 4 | timeofdeparture | Datum och tid | 1 | Avresetid | 2014-10-03 8:00:00 |
| 4 | returntime | Datum och tid | 1 | Returtid | 2014-10-03 18:00:00 |
| 4 | crmprocessidentifier | Teckensträng | 0...1 | CRM-uppdragets ID-uppgift | NV#12345 |
| 4 | customeridentifier | Teckensträng | 0...1 | Kundens länkningsuppgift, antingen id eller nummer | |
| Attr. | type | Teckensträng | 0...1 | Länkningsuppgiftens typ netvisor eller customer | netvisor |
| 4 | dimension | Aggregat | 0...n | ||
| 5 | dimensionname | Teckensträng | 1 | Räkenskapsobjektsrubrik | |
| 5 | dimensionitem | Teckensträng | 1 | NULL | |
| Attr. | fatherid | Numerisk | 0...1 | ||
| 4 | tripexpenseattachments | Aggregat | 0...1 | ||
| 5 | tripexpenseattachment | Aggregat | 1...n | ||
| 6 | mimetype | Teckensträng | 1 | Bilagans MIME-typ | |
| 6 | attachmentdescription | Teckensträng | 1 | Bilagans beskrivning | |
| 6 | filename | Teckensträng | 1 | Bilagans filnamn | |
| 6 | documentdata | Teckensträng | 1 | Bilagans data base64-kodade |
Import av arbetstidsuppgifter
Resurs: workday.nv
Import av arbetstidsuppgifter till Netvisor. Arbetstid kan importeras antingen i timmar (workdayhour) eller enligt klockslag (workdaytime).
Data som ska importeras skickas med anropet som XML (POST-data) enligt vidstående beskrivning:
| Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
| Root | root | Aggregat | 1 | ||
| 1 | workday | Aggregat | 1 | ||
| 2 | date | Datum | 1 | Den dag då timbokningarna görs | 2018-10-01 |
| Attr. | format | Teckensträng | 1 | Datumformat, alltidansi | ansi |
| Attr. | method | Teckensträng | 0...1 | Importens typ för dagen, replace eller increment. Som standard replace. | replace |
| 2 | employeeidentifier | Teckensträng | 1 | Löntagarens länkningsuppgift | 1407 |
| Attr. | type | Teckensträng | 0...1 | Länkningsuppgiftens typ, number eller personalidentificationnumber | number |
| Attr. | defaultdimensionhandlingtype | Teckensträng | 0...1 | Standard för räkenskapsobjektets hantering: none tai usedefault Respekteras standardräkenskapsobjekt som ställts in för löntagaren eller inte | usedefault |
| 2 | workdayhour | Aggregat | 0...n | ||
| 3 | hours | Numerisk | 1 | Arbetstidsregistreringens timmar (* , Netvisor avrundar till två decimaler | 7,5 |
| 3 | collectorratio | Teckensträng | 1 | Bokföringsslag, slaget måste finnas i Netvisor | 11 |
| Attr. | type | Teckensträng | 0...1 | Bokföringsslagets länkningsuppgifts typ, alltid number | number |
| 3 | acceptancestatus | Teckensträng | 1 | Arbetstidsbokföringsrads status, antingen confirmed (kvitterad) eller accepted (godkänd) | confirmed |
| 3 | description | Teckensträng | 1 | Beskrivning av arbetstidsbokföringsrad | Vanliga arbetsuppgifter |
| 3 | crmprocessidentifier | Teckensträng | 0...1 | CRM-uppgiftens länkningsuppgift | NV#4321 |
| Attr. | billingtype | Teckensträng | 1 | Faktureringstyp, billable eller unbillable | billable |
| 3 | invoicingproductidentifier | Teckensträng | 0...1 | ||
| 3 | invoicingcustomeridentifier | Teckensträng | 0...1 | Faktureringskund | Testkund |
| Attr. | type | Teckensträng | 1 | netvisor eller customer. | netvisor |
| 3 | dimension | Aggregat | 0...n | ||
| 4 | dimensionname | Teckensträng | 1 | Räkenskapsobjektets rubrik, om det inte finns en rubrik grundas den | Projekt |
| 4 | dimensionitem | Teckensträng | 1 | Räkenskapsobjekt, om det inte finns ett objekt grundas det | Löneberäkning |
| Attr. | fatherid | Numerisk | 0...1 | 33 | |
| 2 | workdaytime | Aggregat | 0...n | ||
| 3 | starttimeofday | Numerisk | 1 | Arbetstidsbokföringens begynnelsetid | 08:00 |
| 3 | endtimeofday | Numerisk | 1 | Arbetstidsbokföringens sluttid | 16:00 |
| 3 | breaktime | Numerisk | 1 | Paustid i minuter | 30 |
| Attr. | type | Teckensträng | alltid minutes | minutes | |
| 3 | collectorratio | Teckensträng | 1 | Bokföringsslagets länkningsuppgifts typ, alltid number | 11 |
| Attr. | type | Teckensträng | 0...1 | alltid number | number |
| 3 | acceptancestatus | Teckensträng | 1 | Arbetstidsbokföringsradens status, antingen confirmed (kvitterad) eller accepted (godkänd) | confirmed |
| 3 | description | Teckensträng | 1 | Beskrivning av arbetstidsbokföringsrad | |
| 3 | invoicingproductidentifier | Teckensträng | 0...1 | ||
| 3 | dimension | Aggregat | 0...n | ||
| 4 | dimensionname | Teckensträng | 1 | Räkenskapsobjektets rubrik, om det inte finns en rubrik grundas den | Projekt |
| 4 | dimensionitem | Teckensträng | 1 | Räkenskapsobjekt, om det inte finns ett objekt grundas det | Löneberäkning |
*) Med resursen kan du även hämta arbetstidsuppgifter, vars bokföringsslags enhet är 'Dag', såsom semesterdagar. I det här fallet måste du för elementet hours ställa in värdet i antal dagar (exempelvis 1, varvid en dag bokförs i arbetstidsuppgifterna). För att Netvisors semesterberäkning ska fungera korrekt bör semesterdagarna alltid importeras med värdet 1.
Hämta arbetstidsuppgifter
Resurs: getworkday.nv
Hämtningen returnerar timposterna för en löntagare för en arbetsdag. Sökning sker alltid med löntagarens nummer.
| Parameter | Förekomster | Beskrivning | Exempel |
| employeenumber | 1 | Löntagarens nummer I Netvisors löntagares uppgifter | 1407 |
| workhourdate | 1 | Datum | 2017-06-20 |
Svar:
| Nivå | Element | Form | Förekomst | Beskrivning | Exempel |
| root | Root | Aggregat | 1 | ||
| 1 | Workday | Aggregat | 1 | ||
| 2 | Date | Datum | 1 | Datum | 2017-06-20 |
| 2 | WorkdayHour | Aggregat | 0...n | ||
| 3 | Hours | Decimaltal | 1 | Timantal | 7,5 |
| 3 | CollectorRatio | Text | 1 | Bokföringsslag | Normalt timarbete |
| Attr. | Number | Heltal | 1 | Bokföringsslagets nummer | 1 |
| 3 | AcceptanceStatus | Text | 1 | Öppen, Kvitterad och Godkänd | Godkänd |
| 3 | Description | Text | 1 | Förklaring | |
| 3 | CrmProcessName | Text | 1 | Till timposter länkad CRM-uppgifts namn | |
| 3 | Dimension | Aggregat | 0...n | ||
| 4 | DimensionName | Text | 1 | Räkenskapsobjektsrubrik | Projekt |
| 4 | DimensionItem | Text | 1 | NULL | Projekt 1 |
Hjälpte det här svaret? Ja Nej
Send feedbackSynd att vi inte kunde vara till hjälp. Hjälp oss förbättra denna artikel med din feedback.