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 feedback