Integration

HTTP-metod

Resurs

DTD

Exempel

Importera löntagare

POST

employee.nv

employee.dtd

Ladda ner

Hämtning av löntagares lönegrund

GET

getemployeesalaryparameters.nv

Ladda ner

Import löntagarens lönegrunder

POST

employeesalaryparameters.nv

employeesalaryparameters.xsd

Ladda ner

Hämta löneslag

GET

payrollratiolist.nv

Ladda ner

Importera lönespecifikation

POST

payrollpaycheckbatch.nv

payrollpaycheckbatch.dtd

Ladda ner

Importera löneperiodsspecifik registreringsrad

POST

payrollperiodcollector.nv

payrollperiodcollector.dtd

Ladda ner

Importera löneförskott

POST

payrolladvance.nv

payrolladvance.dtd

Ladda ner

Import av externt löneutbetalningsmaterial

POST

payrollexternalsalarypayment.nv

payrollexternalsalarypayment.dtd

Ladda ner

Parameter

Förekomster

Exempel

Beskrivning

Method

1

Add

Importtyp, Add eller Edit

Nivå

Element

Form och längd

Före-
​
komster

Beskrivning

Exempel

Root

root

Aggregat

1

1

employee

Aggregat

1

2

employeebaseinformation

Aggregat

1

3

foreignemployeeidentification

Aggregat

0...1

Utländsk löntagare

Om elementet anges,
​
anges inteemployeeidentifier-uppgift

4

identifier

Teckensträng

1

Identifieringsuppgift

23011970

Attr.

type

Teckensträng

1

Identifierarens typ, tillåtna värden:
​
​taxidentificationnumber
​
​foreignpersonalidentifier
​
​other

foreignpersonalidentifier

4

issuingcountry

Teckensträng

1

Land

AF

Attr.

type

Teckensträng

1

Landsuppgiftens format

ISO-3166

4

gender

Teckensträng

1

Kön
​
​male
​
​female

male

4

dateofbirth

Datum

1

Födelsedatum

1970-10-20

Attr.

format

Teckensträng

1

Datumformat

ansi

3

employeeidentifier

Teckensträng

1

Löntagarens finska personbeteckning

010277-xxxp

3

companyidentifier

Teckensträng

0...1

Företagets FO-nummer,
​
När företaget importeras som löntagare

0174564-5

3

companyname

Teckensträng

0...1

Företagets namn

Test Företag

3

firstname

Teckensträng, max. 50

1

Löntagarens förnamn

Ge

3

lastname

Teckensträng, max. 50

1

Löntagarens efternamn

Yrkesperson

3

phonenumber

Teckensträng, max. 50

1

Löntagarens telefonnummer

050 123 456

3

email

Teckensträng, max. 100

1

Löntagarens e-postadress

[email protected]

2

employeepayrollinformation

Aggregat

1

3

streetaddress

Teckensträng, max. 255

1

Löntagarens gatuadress

Kejsarinnegatan 1

3

postnumber

Teckensträng, max. 50

1

Löntagarens postnummer

56120

3

city

Teckensträng, max. 255

1

Löntagarens postanstalt

Villmanstrand

3

municipality

Teckensträng, max. 255

0...1

Löntagarens bostadsort

Villmanstrand

3

country

Teckensträng, max. 2

0...1

Löntagarens hemlands kod, som standard fi

fi

3

nationality

Teckensträng, max. 2

0...1

Löntagarens medborgarskap, som standard fi

se

3

language

Teckensträng, max. 2

0...1

Löntagarens språk, som standard fi

fi

3

employeenumber

Numerisk, max. 10

0...1

Löntagarens indivuella identifierarnummer

13

3

profession

Teckensträng, max. 255

0...1

Löntagarens yrkesbeteckning

Testare

3

jobbegindate

Teckensträng, max. 10

0...1

Löntagarens anställningsförhållandes begynnelsedatum

2017-11-09

Attr.

format

Teckensträng

1

Begynnelsedagens format, alltidansi

ansi

3

payrollrulegroupname

Teckensträng, max. 50

1

Löntagarens lönemalls namn

Månadsavlönade

3

bankaccountnumber

Teckensträng, max. 34

0...1

Löntagarens bankkontonummer, IBAN-kontonummer. Om du hämtar
​
ett bankkontonummer ska du även importera BIC-koden (bankidentificationcode).

FI71 7997 9580 0073 35

3

bankidentificationcode

Teckensträng. max. 20

0...1

Bankens BIC-kod

NDEAFIHH

3

accountingaccountnumber

Numerisk

0...1

Löntagarens skuldkontonummer

1751

3

hierarchy

Teckensträng

0...1

Hierarkinivå

Oy Företag Ab

Attr.

type

Teckensträng

1

Hierarkins länkningstyp

netvisor – Netvisors identifierare
​
eller
​
​customer – Om ett namn specificeras
​
måste det vara unikt
​
​Läs om företagshierarkin

3

dimension

Aggregat

0...n

Standardräkenskapsobjekt

4

dimensionname

Teckensträng

1

Räkenskapsobjektsrubikens namn.
​
Skapas vid behov

Kostnadsställen

4

dimensionitem

Teckensträng

1

Räkenskapsobjektets namn.
​
Skapas vid behov

DevOps

Attr.

fatherid

Numerisk

0...1

Räkenskapsobjektets "förälders" (parent)
​
kod. ID:n kan hämtas med den här resursen

1

3

payslipdeliverymethod

Teckensträng

0...1

Leveransmetod för lönebeskedet

1 = lokal utskrift
​
2 = utskriftstjänst
​
3 = nätlön

Attr.

type

Teckensträng

1

Leveranssättets länkningstyp

Attribute type är alltid netvisor,
​
eller NetvisorID

3

isjointowner

Numerisk

0...1

I delägarförhållande till betalaren

1=ja
​
0=nej

3

isathlete

Numerisk

0...1

Idrottare

1=ja
​
0=nej

3

isperformingartist

Numerisk

0...1

Uppträdande artist

1=ja
​
0=nej

3

employeeinsurancetype

Numerisk

0...1

Typ av arbetspension

1=ArpL
​
2 = MYEL
​
3 = YEL
​
4=Inte pensionförsäkrad

3

ispersonworkingonaroadferryonalandislands

Numerisk

0...1

Person som arbetar på Ålands landsvägsfärja

1=ja
​
0=nej

3

isentrepreneurwithoptionalyelormyel

Numerisk

0...1

Företagare, inte FÖPL- eller LFÖPL-försäkringsskyldig

1=ja
​
0=nej
​
kan endast anges om employeeinsurancetype=4

3

nosocialsecuritypayment

Numerisk

0...1

Omfattas inte av arbetsgivarens sjukförsäkringsavgift

1=ja
​
0=nej
​
Som standard 0

2

employmentperiods

Aggregat

0...1

Anställningsförhållanden

3

employmentperiod

Aggregat

1...n

Anställningsförhållande

4

companystartdate

Datum

0...1

Begynnelsedatum för oavbrutet anställningsförhållande

2017-01-01

Attr.

format

Teckensträng

1

Datumformat

ansi

4

startdate

Datum

1

Begynnelsedag

2017-01-01

Attr.

format

Teckensträng

1

Datumformat

ansi

4

probationenddate

Datum

0...1

Provtidens slutdatum

2017-04-01

Attr.

format

Teckensträng

1

Datumformat

ansi

4

employmentmode

Numerisk

0...1

Anställningssätt

1 = anställd
​
2 = arbetstagare som hyrs ut av bemanningsföretag
​
3 = näringsidkare eller motsvarande
​
4 = provanställning
​
5 = talkoarbete

Attr.

type

Teckensträng

1

Arbetsförhållandets länkningstyp:

Attributtype är alltid netvisor,
​
eller NetvisorID

4

profession

Teckensträng, max. 250

1

Yrkesbeteckning

Testare

4

comment

Teckensträng, max. 500

0...1

Kommentar

Ny kompetent typ

4

enddate

Datum

0...1

Slutdatum

2017-12-31

Attr.

format

Teckensträng

1

Datumformat

ansi

4

endreason

Numerisk

0...1

Orsak till upphörande

2=Arbetstagarens ålderspension
​
4=Arbetstagarens egen begäran
​
5=Uppsägning på grund av den anställda
​
6=Tidsbegränsad anställning
​
11=Företagets ekonomiska orsaker och produktionsorsaker
​
12=Uppsägning av anställningsförhållandet enligt gemensam överenskommelse
​
13=Annan orsak
​
(Följande har tagits ur bruk:
​
1 = Normalt upphörande av anställningsförhållande
​
3 = Arbetstagarens död
​
7 = Upphörande av anställningsförhållande under prövotid
​
8 = Hävning av arbetsavtal
​
9 = Företagets konkurs
​
10 = Företagets ägarbyte)

Attr.

type

Teckensträng

1

Upphörandets länkningstyp

Attributtype är alltid netvisor,
​
eller NetvisorID

4

occupationclassification

Teckensträng

0...1

Yrkeskategori

Yrkesklassificering Yrkesklassens TK10-kod

Attr.

type

Teckensträng

1

Länkningstyp

Attributtype är alltid isco

4

employmentcontract

Numerisk

0...1

Anställningsförhållandets längd

1 = Giltigt tills vidare:
​
2 = Tidsbestämt
​
Obs: För ett tidsbestämt
​
anställningsförhållande måste ett
​
slutdatum anges

Attr.

type

Teckensträng

1

Länkningstyp

Attributtype är alltid netvisor,
​
eller NetvisorID

4

employmentform

Numerisk

0...1

Typ av anställning

1 = på heltid
​
2 = på deltidn

Attr.

type

Teckensträng

1

Länkningstyp

Attributtype är alltid netvisor,
​
eller NetvisorID

4

parttimepercent

Numerisk

0...1

Andel deltid

Tillåtet värde, decimaltal mellan 0–100
​
Obs: employmentform måste vara 2
​
för att inställningen ska iakttas
​
Avrundning till närmaste två decimaler

4

regularworkinghours

Numerisk

0...1

Regelbunden arbetstid

Tillåtet värde, decimaltal mellan 0–168
​
Avrundning till närmaste två decimaler

4

groundsforemployment

Numerisk

0...1

Grund för arbetsförhållandet

0=Annan grund
​
1 = Anställnings- eller tjänsteförhållande

4

kevaprofessionalclasscode

Numerisk

0...1

Keva Yrkesklassens kod, max. 20 tecken.
​
KEVA-uppgifter kan endast lämnas om företaget har valt
​
"Företagets arbetspensionsförsäkringsgivare är Keva" i löneinställningarna.

Kevas yrkesklassers koder:
​
(Keva) Sök yrkesbeteckning

4

kevaemploymentregistration

Numerisk

0...1

Keva Registrera anställningsförhållande, max. 2 tecken.

Registreringskoder för Keva anställningsförhållande:
​
(Keva) Inkomstregistrets koder

Attr.

type

Teckensträng

1

alltid keva

keva

Attr.

pensionprovidercode

Numerisk

0...1

Arbetspensionsanstaltens bolagskod. Som standard används värdet "20"
​
om inget annat anges.
​
Anger vilka värden som accepteras i fältet.
​
kevaemploymentregistration.

Värdet finns i KEVAs koder
​
​Keva: Inkomstregistrets koder
​
Ett felaktigt värde listar de tillåtna värdena.

4

ispaymenttypemonthlywage

Numerisk

0...1

Avlöningsform: Månadslön

1=ja
​
0=nej

4

ispaymenttypehourlywage

Numerisk

0...1

Avlöningsform: Timlön

1=ja
​
0=nej

4

ispaymenttypepiecewage

Numerisk

0...1

Avlöningsform: Entreprenad

1=ja
​
0=nej

4

collectiveagreement

Numerisk

0...1

Kollektivavtal

Inkomstregistrets kollektivavtalskoder:
​
Inkomstregistret: Koder

Attr.

type

Teckensträng

1

alltid cbacode

cbacode

4

stateemploymentfund

Numerisk

0...1

Sysselsatt med statsanslag för sysselsättning

1=ja
​
0=nej

4

carbenefityear

Numerisk

0...1

Bilförmånsbilens ibruktagningsår, max. 4 tecken

2012

4

isabroadcarbenefit

Numerisk

0...1

Bilförmån erhållen utomlands

1=ja
​
0=nej

2

employeesettings

Aggregat

0...1

Löntagarens inställningar

3

payrollservice

Teckensträng

0...1

Löneberäkningstjänst

enabled eller disabled

3

resourcemanagement

Teckensträng

0...1

Resurshantering

enabled eller disabled

2

employeesettlementpoints

Aggregat

0...1

Redovisningsenheter

3

employeeworkpensioninsurance

Aggregat

0...1

Arbetspensionsförsäkring

4

type

Teckensträng

0...1

Hantera redovisningsenhet

nohandling=Ingen behandling
​
automatichandling=
​
Automatisk hantering
​
under17yearsold=Under 17-åring
​
17to52yearsold=17–52-åring
​
53to62yearsold=53–62-åring
​
63to67yearsold=63–67-åring
​
over68yearsold=över 68-åring

4

name

Teckensträng

0...1

Definiera försäkringsspecifik redovisningsenhet (*

ArPL

3

employeeunemploymentinsurance

Aggregat

0...1

Arbetslöshetsförsäkring

4

type

Teckensträng

0...1

Hantera redovisningsenhet

nohandling=Ingen behandling
​
automatichandling=
​
Automatisk hantering
​
under17yearsold=Under 17-åring
​
17to64yearsold=17–64-åring
​
over65yearsold=över 65-åring
​
partowner=delägare

4

name

Teckensträng

0...1

Definiera försäkringsspecifik redovisningsenhet (*

Arbetslöshetsförsäkring

3

employeeaccidentinsurance

Aggregat

0...1

Olycksfallsförsäkring

4

type

Teckensträng

0...1

Hantera redovisningsenhet

nohandling eller attachedtosettlementpoint

4

name

Teckensträng

0...1

Definiera försäkringsspecifik redovisningsenhet (*

Olycksfallsförsäkring

3

employeegrouplifeinsurance

Aggregat

0...1

Grupplivförsäkring

4

type

Teckensträng

0...1

Hantera redovisningsenhet

nohandling eller attachedtosettlementpoint

4

name

Teckensträng

0...1

Definiera försäkringsspecifik redovisningsenhet (*

Grupplivförsäkring

3

employeeotherinsurance

Aggregat

0...1

Annan försäkring

4

type

Teckensträng

0...1

Hantera redovisningsenhet

nohandling eller attachedtosettlementpoint

4

name

Teckensträng

0...1

Definiera försäkringsspecifik redovisningsenhet (*

Annan försäkring

3

employeeunionmembershipfee

Aggregat

0...1

Fackförbundets medlemsavgift

4

type

Teckensträng

0...1

Hantera redovisningsenhet

nohandling eller attachedtosettlementpoint

4

name

Teckensträng

0...1

Definiera försäkringsspecifik redovisningsenhet (*

Fackförbundets medlemsavgift

3

employeeforeclosure

Aggregat

0...1

Utmätning

4

type

Teckensträng

0...1

Hantera redovisningsenhet

nohandling eller attachedtosettlementpoint

4

name

Teckensträng

0...1

Definiera försäkringsspecifik redovisningsenhet (*

Utmätning

Parameter

Förekomster

Beskrivning

identifiertype

1

Värde: pin = löntagarens personbeteckning eller number = löntagarens nummer

identifier

1

Identifierare enligt typ: löntagarens personbeteckning eller löntagarens nummer

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

root

root

Aggregat

1

1

employeesalaryparameters

Aggregat

1

2

parameters

Aggregat

1

3

parameter

Aggregat

0...n

4

rationumber

Nummer

1

Lönegrundens löneslags nummer (företagsspecifika löneslag)

123

4

value

Decimaltal

1

Lönegrundens värde

12,34

Nivå

Element

Form och längd

Förekomster

Beskrivning

Exempel

Root

root

Aggregat

1

1

employeesalaryparameters

Aggregat

1

2

employeeidentification

Text

1

Löntagar-ID

123456-123A

Attr.

Type

Text

1

Typ av löntagar-ID:
​
​pin eller number

pin

2

salaryparameters

Aggregat

1

3

salaryparameter

Aggregat

1...24

4

rationumber

Nummer

1

Lönegrundens löneslags nummer (företagsspecifika löneslag). Löneslagets källa i Netvisor ska vara "Löntagarens basuppgifter"

123

4

value

Decimaltal

0...1

Lönegrundens värde

12,30

Parameter

Förekomster

Exempel

Beskrivning

source

1...n

collectorratiolines

Begränsas med löneartens typ som måste vara en eller flera av följande:
​
- tripexpensecustomlines = reseräkning, kostnadsrader
​
- taxingrules = skattekort
​
- collectorratiolines = löneintervallsspecifika poster
​
- userparameters = löntagarens basuppgifter
​
- companyparameters = företagets basuppgifter
​
- userformula = användarens formel
​
- tabledata = tabelldata
​
- foreclosure = utmätning
​
- lowsalarysupport = låglönestöd

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

Root

root

Aggregat

1

1

PayrollRatios

Aggregat

1

2

PayrollRatio

Aggregat

0...n

3

Names

Aggregat

0...n

4

Name

Text

1-3

Löneslagets namn

Dagtraktamente för utlandet

Attr.

ISO639-1Code

Text

1

Språkuppgift för löneslagets namn: fi, sv, en

fi

Identifier

Nummer

1

Löneslagets ID

1

4

Source

Text

1

Löneslagets typ

Reseräkning, kostnadsrader

4

RatioNumber

Nummer

1

Löneslagets nummer

123

4

DefaultDebitAccountNumber

Nummer

1

Bokföringens debetkonto

7890

4

DefaultCreditAccountNumber

Nummer

1

Bokföringens kreditkonto

2961

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

Root

root

Aggregat

1

1

payrollcheckbatch

Aggregat

1

2

employeeidentifier

Teckensträng

1

Uppgift med vilken löntagaren länkas *1)

140785-xxxx

Attr.

type

Teckensträng

1

Länkningstyp, employeenumber eller finnishpersonalidentifier

finnishpersonalidentifier

2

rulegroupperiodstart

Datum

1

Löneintervallets begynnelsedatum

2009-12-31

Attr.

format

Teckensträng

1

Datumformat, alltid ansi

ansi

2

rulegroupperiodend

Datum

1

Löneintervallets slutdatum

2009-12-31

Attr.

format

Teckensträng

1

Datumformat, alltid ansi

ansi

2

freetextbeforelines

Teckensträng

0...1

Fritext före lönespecifikationsrader

2

freetextafterlines

Teckensträng

0...1

Fritext efter rader

2

duedate

Datum

0...1

Förfallodag

2009-12-31

Attr.

format

Teckensträng

1

Datumformat, alltid ansi

ansi

2

valuedate

Datum

0...1

2009-12-31

Attr.

format

Teckensträng

1

Datumformat, alltid ansi

ansi

2

payrollpaycheckbatchline

Aggregat

1...n

3

payrollratioidentifier

Teckensträng

1

Uppgift med vilken löneslaget länkas till raden. *3)

1

Attr.

type

Teckensträng

1

Länkningstyp: tills vidare endast rationumber

rationumber

3

units

Numerisk

1

Radens styckantal

2

3

unitamount

Numerisk

1

Enhetspris

1500

3

linesum

Numerisk

1

Radsumma, räknas inte automatiskt. Vi rekommenderar import med högst två decimalers precision.

3000,00

3

linedescription

Teckensträng

0...1

Radbeskrivning

3

dimension

Aggregat

0...n

4

dimensionname

Teckensträng

1

Räkenskapsobjektsrubrik

Projekt

4

dimensionitem

Teckensträng

1

Räkenskapsobjekt

Löneutbetalning

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

Root

Root

Aggregat

1

1

payrollperiodcollector

Aggregat

1

2

date

Datum

1

Datum inom öppet löneintervall enligt löntagarens lönemall

Attr.

format

Teckensträng

1

Alltid ansi

2

employeeidentifier

Teckensträng

1

Löntagarens ID. Löntagare som bokföringsraderna skapas för

Attr.

type

Teckensträng

1

Antingen number (löntagarens nummer) eller personalidentificationnumber (personbeteckning)

2

payrollratioline

Aggregat

1...n

3

amount

Numerisk

1

Löneperiodsspecifik bokföringsrads antal/summa

3

payrollratio

Numerisk

1

Löneslagets nummer Ett nummer måste ha angetts för löneslaget

Attr.

type

Teckensträng

0...1

Alltid number

3

dimension

Aggregat

0...n

4

dimensionname

Teckensträng

1

Räkenskapsobjektsrubikens namn. Skapas vid behov

4

dimensionitem

Teckensträng

1

Räkenskapsobjektets namn. Skapas vid behov

Attr.

fatherid

Numerisk

0...1

Räkenskapsobjektets "förälders" (parent) kod.

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

Root

Root

Aggregat

1

1

payrolladvance

Aggregat

1

2

description

Teckensträng

0...1

Transaktionsbeskrivning. Fritt formulerad förklaring om förskottsbetalning

2

employeeidentifier

Teckensträng

1

Löntagarens identifierare, vem man utbetalar förskott till

Attr.

type

Teckensträng

0...1

Antingen number (löntagarens nummer) eller finnishpersonalidentifier (finsk personbeteckning)

2

paymentdate

Datum

1

Förskottets utbetalningsdag. Kan inte vara tidigare än dagens datum

Attr.

format

Teckensträng

0

Alltid ansi (Obs! Fel i DTD, om ett attribut läggs till orsakas ett fel)

2

advancesum

Numerisk

1

Löneförskottets belopp

Attr.

paymentstatus

Teckensträng

0...1

ispaid eller notpaid
​
Ett löneförskott som har betalats/markerats som betalt uppdateras automatiskt på löntagarens nästa lönespecifikation och avdras från den betalade summan. Du behöver inte se till att avdra löneförskottet från lönespecifikationen.
​
Ett reseförskott som har betalats/markerats som betalt uppdateras automatiskt i betalningsvyn (HRM > Arbetstider och reseräkningar > Girering) i löntagarens uppgifter. I betalningsvyn kan ett reseförskott kopplas till en eller flera framtida reseräkningar.

2

paymenttype

Teckensträng

1

payroll eller tripexpence, det vill säga löneförskott eller reseförskott

Nivå

Element

Form

Förekomster

Beskrivning

Exempel

Root

Root

Aggregat

1

1

payrollexternalsalarypayment

Aggregat

1

2

description

Teckensträng

0...1

Transaktionsbeskrivning. Fritt formulerad förklaring. För löntagaren är lönetransaktionens förklaring alltid "Lön".

Extern betalning

2

paymentdate

Datum

1

Betalningsdagen (paymentdate) = lönedag, löneutbetalning är på löntagarens konto (alternativt element till duedate).

2017-01-01

Attr.

format

Teckensträng

ansi

ansi

2

duedate

Datum

1

Förfallodag, lönen debiteras från företagets konto (alternativt element till paymentdate)

2017-01-01

Attr.

format

Teckensträng

ansi

ansi

2

externalpaymentsum

Decimaltal

1

Betalningsbelopp (0.01 < sum < 10000000.0)

100,0

2

iban

Teckensträng

1

Löntagarens bankförbindelse, det vill säga bankkontonummer

FI21 1234 xxxx xxxx xx

2

bic

Teckensträng

1

Bankens identifierare

NDEAFIHH

2

personnummer

Teckensträng

1

Finsk personbeteckning

140785-xxyy

2

realname

Teckensträng

1

Löntagarens namn

Erik Exempel