På denna webbsida samlas inkomstregistrets gällande tekniska anvisningar och schemabeskrivningar för programutvecklare. Årtalet i anvisningens rubrik anger från och med vilket år anvisningen har gällt.
För närmare anvisningar om anmälning, se inkomstregistrets detaljerade anvisningar.
Tillämpningsanvisningar för datainnehållet i löner
I anvisningen för inkomstslag beskrivs inkomstslag för löner och deras användningsändamål. I tillämpningsanvisningen beskrivs punkt för punkt vilka uppgifter som uppges med anmälan om löneuppgifter och arbetsgivarens separata anmälan.
Tillämpningsanvisningar för datainnehållet i löner
| Löner – senaste tillämpningsanvisningar |
Senaste ändringar |
Löner – Förklaringar på inkomstslag och poster som ska dras av från inkomsterna 2025 (pdf)
- Publicerades 25.11.2024
- I dokumentet beskrivs
- inkomstslagen i anmälan om löneuppgifter som används i inkomstregistret samt kodvärden för inkomstslagen och förklaringar
- verkställande av förskottsinnehållning och betalning av socialförsäkringsavgifter för varje inkomstslag
- situationer där inkomstslagen i anmälan om löneuppgifter används.
|
Dokumentet för år 2025:
- Inkomstslagets namn för följande inkomstslag har preciserats:
- Inkomstslagets 313 namn "Bruksersättning som förvärvsinkomst" ändrades till "Bruksavgift som förvärvsinkomst"
- Inkomstslagets 314 namn "Bruksersättning som kapitalinkomst" ändrades till "Bruksavgift som kapitalinkomst"
- Förklaringar för följande inkomstslag har preciserats:
- 201 Tidlön
- 216 Annat betalt tillägg
- 224 Penningersättning från arbetstidsbank
- 317 Övriga naturaförmåner
- 328 Arvode för familjevårdare
- 336 Arbetsersättning
- 353 Skattepliktig kostnadsersättning
Dokumentet för år 2026:
- En ny dokumentet Löner – Koduppsättningar – Inkomstslag 2026 har publicerats, som kombinerar informationsinnehållet från följande tidigare dokument:
- Löner – Förklaringar på inkomstslag och poster som ska dras av från inkomsterna 2025
- Löner – Koduppsättningar – Inkomstslag 2025
|
Tillämpningsanvisning för informationsinnehållet i anmälan om löneuppgifter 2025 (pdf)
- Publicerades 8.10.2025
- I dokumentet beskrivs informationsinnehållet i anmälan om löneuppgifter och vad som anmäls i varje enskild punkt av informationsinnehållet.
Tillämpningsanvisning för informationsinnehållet i anmälan om löneuppgifter 2026 (pdf)
Tillämpningsanvisning för informationsinnehållet i anmälan om löneuppgifter 2027 (pdf)
|
Dokumentet för år 2025:
- Förkläring av kod 9 Alterneringsledighet i kodupssätningen Orsak till oavlönad frånvaro (UnpaidAb-senceCauseCode) har ändrats till Alterneringsledighet (före 1.4.2025).
Dokumentet för år 2026:
- 8.10.2025:
- En version av dokumentet med ändringar av datainnehållet för 2026 och övriga Inkomstregisteren-hetens uppdateringar har publicerats. Förändringarna tillämpas då inkomstens betalningsdag är 1.1.2026 eller därefter.
- Två nya typer av tilläggsuppgifter om inkomsttagaren har lagst till Tilläggsuppgifter om inkomsttagaren (IncomeEarnerTypes):
- Hyrd arbetstagare som bor utomlands, (och) arbetar på ett finskt luftfartyg
- Hyrd arbetstagare som bor utomlands, (och) arbetar på ett finskt fartyg
- Ett nytt värde (Partiell särskild graviditetsledighet) har lagts till i Avlönad frånvaro och Oavlönad frånvaro.
Regeln för Uppgifter för ansökan om ersättning har uppdaterats med ett nytt värde.
- 6.11.2025:
- Regeln för Uppgifter för ansökan om ersättning har uppdaterats genom att Avlönad frånvaro Partiell särskild graviditetsledighet har tagits bort.
- Beskrivningen av Bilens utsläppsvärde har uppdaterats.
Dokumentet för år 2027:
- 27.10.2025:
- En version av dokumentet med ändringar av datainnehållet för 2027 och övriga Inkomstregisterenhetens uppdateringar har publicerats. Förändringarna tillämpas då inkomstens betalningsdag är 1.1.2027 eller därefter.
- Ny uppgift Referens för begäran om rättelse har lagts till i datagruppen Tjänstens uppgifter (ReportData).
- 6.11.2025:
- Beskrivningen av Bilens utsläppsvärde har uppdaterats.
|
|
Tillämpningsanvisning för arbetsgivarens separata anmälan 2022 (pdf)
- Publicerades 27.12.2022
- I dokumentet beskrivs informationsinnehållet i arbetsgivarens separata anmälan och vad som anmäls i varje enskild punkt av informationsinnehållet.
|
- Inlägd av Inledning och Läsanvisning.
|
| Löner – tidigare tillämpningsanvisningar |
|
|
Tillämpningsanvisningar för datainnehållet i förmåner
I anvisningen för inkomstslag beskrivs inkomstslag för förmåner och deras användningsändamål. I tillämpningsanvisningen beskrivs punkt för punkt vilka uppgifter som uppges med anmälan om förmånsuppgifter.
Tillämpningsanvisningar för datainnehållet i förmåner
| Förmåner – senaste tillämpningsanvisningar |
Senaste ändringar |
Förmåner – Förklaringar på inkomstslag och poster som ska dras av från inkomsterna 2025 (pdf)
- Publicerades 8.10.2025
- I dokumentet beskrivs
- förmåner och pensioner som ska anmälas till inkomstregistret jämte förklaringar och kodvärden
- situationer där inkomstslagen i anmälan om förmånsuppgifter används.
|
Dokumentet för år 2025:
- Uppdaterad förklaring av inkomstslagen 1024 och 1424.
Dokumentet för år 2026:
- En ny dokumentet Förmåner – Koduppsättningar – Inkomstslag 2026 har publicerats, som kombinerar informationsinnehållet från följande tidigare dokument:
- Förmåner – Förklaringar på inkomstslag och poster som ska dras av från inkomsterna 2025
- Förmåner – Koduppsättningar – Inkomstslag 2025
|
|
Tillämpningsanvisning för informationsinnehållet i anmälan om förmånsuppgifter 2025 (pdf)
- Publicerades 27.6.2025
- I dokumentet beskrivs informationsinnehållet i anmälan om förmånsuppgifter och vad som anmäls i varje enskild punkt av informationsinnehållet.
Tillämpningsanvisning för informationsinnehållet i anmälan om förmånsuppgifter 2027 (pdf)
|
Dokumentet för år 2025:
- Dokumentversionen för år 2025 innehållande datainnehållsändringar har publicerats. Ändringarna tillämpas då utbe-talningsdagen för inkomsten är 1.1.2025 eller senare.
- I kapitel Grundläggande uppgifter om den ställföreträdande mottagaren värdet Kommun eller annan social välfärds-organisation på koduppsättningen Typ av ställföreträdande mottagare (IncomeBeneficiaryType) har ändrats till Väl-färdsområde.
Dokumentet för år 2027:
- En version om dokumentet med datainnehållsändringarna för 2027 har publicerats. Ändringarna tillämpas då inkoms-tens betalningsdag är 1.1.2027 eller därefter.
- Ny uppgift Referens för begäran om rättelse har lagts till i datagruppen Tjänstens uppgifter (ReportData).
|
| Förmåner – tidigare tillämpningsanvisningar |
|
|
Koduppsättningar
I koduppsättningarna förtecknas inkomstslag för löner och förmåner, koduppsättningar för det tekniska gränssnittet, felkoder samt inkomstregistrets yrkesklassificering (TK10). Till värdena för dessa koduppsättningar hänvisas bland annat i den allmänna beskrivningen av det tekniska gränssnittet samt i schemadokumenten.
Koduppsättningar
| Koduppsättningar – senaste koduppsättningar |
Senaste ändringar |
|
Löner – Koduppsättningar – Inkomstslag 2025 (xls)
Löner – Koduppsättningar – Inkomstslag 2025 (pdf)
- Publicerades 8.1.2025
- Koduppsättningen innehåller
- koder för inkomstslag och andelar som ska dras av från inkomsterna i anmälan om löneuppgifter, anmälningssätt och i inkomstslagen antagna socialförsäkringsavgifter
- koder för inkomstslag i arbetsgivarens separata anmälan.
Löner – Koduppsättningar – Inkomstslag 2026 (xls)
- Publicerades 13.10.2025
- I koduppsättningen beskrivs
- inkomstslagen i anmälan om löneuppgifter som används i inkomstregistret
- koder för inkomstslag och andelar som ska dras av från inkomsterna, förklaringar och anmälningssätt
- verkställande av förskottsinnehållning och betalning av socialförsäkringsavgifter för varje inkomstslag
- situationer där inkomstslagen i anmälan om löneuppgifter används
- koder för inkomstslag i arbetsgivarens separata anmälan.
|
Dokumentet för år 2025:
- Inkomstslagets namn för följande inkomstslag har preciserats:
- Inkomstslagets 313 namn "Bruksersättning som förvärvsinkomst" ändrades till "Bruksavgift som förvärvsinkomst"
- Inkomstslagets 314 namn "Bruksersättning som kapitalinkomst" ändrades till "Bruksavgift som kapitalinkomst"
- Inkomstslagets 363 namn ”Skattefri andel av cykelförmånen” ändrades till Skattefri andel av cykelförmån
- Inkomstslagets 364 namn ”Andel av cykelförmånen som betraktas som lön” ändrades till Andel av cykelförmån som betraktas som lön
Dokumentet för år 2026:
- 19.6.2025:
- En ny version av dokumentet har publicerats, som kombinerar informationsinnehållet från följande tidigare dokument:
- Löner – Förklaringar på inkomstslag och poster som ska dras av från inkomsterna 2025
- Löner – Koduppsättningar – Inkomstslag 2025
- 13.10.2025:
- Förklaringen till inkomstlag 366 (Ersättning för upphovsrätt som förvärvsinkomst) har preciserats.
|
|
Förmåner – Koduppsättningar – Inkomstslag 2025 (xls)
Förmåner – Koduppsättningar – Inkomstslag 2025 (pdf)
- Publicerades 5.11.2024
- Koduppsättningen innehåller koder för inkomstslagen i anmälan om förmånsuppgifter och poster som ska dras av från inkomsterna, anmälningssätt och obligatoriska tilläggsuppgifter.
Förmåner – Koduppsättningar – Inkomstslag 2026 (xls)
- Publicerades 8.10.2025
- I koduppsättningen beskrivs
- förmåner och pensioner som ska anmälas till inkomstregistret
- koder för inkomstslagen i anmälan om förmånsuppgifter och poster som ska dras av från inkomsterna, förklaringar, anmälningssätt och obligatoriska tilläggsuppgifter
- situationer där inkomstslagen i anmälan om förmånsuppgifter används.
|
Dokumentet för år 2025:
- Uppdaterade namnet på inkomstslag 1218.
Dokumentet för år 2026:
- 27.5.2025:
- En ny version av dokumentet har publicerats, som kombinerar informationsinnehållet från följande tidigare dokument:
- Förmåner – Förklaringar på inkomstslag och poster som ska dras av från inkomsterna 2025
- Förmåner – Koduppsättningar – Inkomstslag 2025
- Versionen av dokumentet som innehåller ändringarna i datainnehållet för 2026 har publicerats. Ändringarna ska tillämpas när betalningsdagen för inkomsten infaller 1.1.2026 eller senare.
- 8.10.2025:
- Uppdaterad förklaring av inkomstslagen 1024 och 1424.
- Följande inkomstslag har lagts till 1445 Allmänt stöd (arbetslös).
- Följande inkomstslag har lagts till 1446 Partiell särskild graviditetspenning.
|
|
Koduppsättningar 2025 (xls)
Koduppsättningar 2025 (pdf)
- Publicerades 8.10.2025
- Koduppsättningen innehåller koduppsättningar som används i inkomstregistrets tekniska gränssnitt.
Koduppsättningar 2026 (xls)
Koduppsättningar 2027 (xls)
|
Dokumentet för år 2025:
- Följande värde har lagts till i koduppsättningen Materialets typ, delas ut från inkomstregistret (QueryDataType):
- 320 Anmälningar om löneuppgifter - alla betalare (xml)
- Följande värde har lagts till i koduppsättningen Materialets schemaversion (QueryDataSchemaVersion):
- Schemat för distributionen av alla betalare
- Följande värden har lagts till i koduppsättningen Kollektivavtal som tillämpas (CBACode):
- 225 Kollektivavtal för administrativ personal och stödpersonal vid yrkesinriktade vuxenutbildningscenter
- 226 Kollektivavtal för undervisningspersonal på yrkesinriktade vuxenutbildningscenter
- 227 Kollektivavtal för administrativ personal- och stödpersonal inom den privata undervisningssektorn
- 228 Kollektivavtal för undervisningspersonal inom den privata undervisningssektorn
Dokumentet för år 2026:
- 28.5.2025:
- Versionen av dokumentet som innehåller ändringarna i datainnehållet för 2026 har publicerats. Ändringarna ska tillämpas när betalningsdagen för inkomsten infaller 1.1.2026 eller senare.
- Följande värde har lagts till i koduppsättningen Typ av tilläggsuppgifter om inkomsttagaren (IncomeEarnerType):
- 18 Hyrd arbetstagare på ett finskt luftfartyg som bor utomlands
- 19 Hyrd arbetstagare på ett finskt fartyg som bor utomlands
- Följande värde har lagts till i koduppsättningen Typ av hämtningsvillkor för materialbeställning (ParameterType):
- 30 Materialets ägares materialreferens
- 7.7.2025:
- Förklaringar för värden 18 och 19 Typ av tilläggsuppgifter om inkomsttagaren (Etableringsanmälan för hyrd arbetstagare) har korrigerats;
- Med värdet 18 Hyrd arbetstagare på ett finskt luftfartyg som bor utomlands -> Hyrd arbetstagare som bor utomlands, (och) arbetar på ett finskt luftfartyg
- Med värdet 19 Hyrd arbetstagare på ett finskt fartyg som bor utomlands -> Hyrd arbetstagare som bor utomlands, (och) arbetar på ett finskt fartyg
- 8.10.2025:
- Följande värde har lagts till i koduppsättningen Materialets schemaversion (QueryDataSchemaVersion):
Följande värde har lagts till i koduppsättningen Materialets typ, delas ut från inkomstregistret (QueryDataType):
- 320 Anmälningar om löneuppgifter – alla betalare (xml)
- Följande värden har lagts till i koduppsättningen Kollektivavtal som tillämpas (CBACode):
- 225 Kollektivavtal för administrativ personal och stödpersonal vid yrkesinriktade vuxenutbildningscenter
- 226 Kollektivavtal för undervisningspersonal på yrkesinriktade vuxenutbildningscenter
- 227 Kollektivavtal för administrativ personal- och stödpersonal inom den privata undervisningssektorn
- 228 Kollektivavtal för undervisningspersonal inom den privata undervisningssektorn
- Följande värden har tagits bort från koduppsättningen Kollektivavtal som tillämpas (CBACode):
- 4 Kollektivavtal för yrkesinriktade vuxenutbildningscenter
- 187 Kollektivavtal för den privata undervisningssektorn
- Följande värde har lagts till i koduppsättningen Orsak till oavlönad frånvaro:
- 18 (Partiell särskild graviditetsledighet)
- Följande värde har lagts till i koduppsättningen Orsak till avlönad frånvaro:
- 24 (Partiell särskild graviditetsledighet)
- Förklaringen för värden 30 Typ av hämtningsvillkor för materialbeställning (ParameterType) har korrigerats:
Materialets ägares materialreferens -> Hämtning av arbetsgivares separata anmälningar
Dokumentet för år 2027:
- 27.10.2025:
- Versionen av dokumentet som innehåller ändringarna i datainnehållet för 2027 har publicerats. Ändringarna ska tillämpas när betalningsdagen för inkomsten infaller 1.1.2027 eller senare.
- Versionen av dokumentet som innehåller ändringarna i datainnehållet för 2027 har publicerats. Ändringarna ska tillämpas när betalningsdagen för inkomsten infaller 1.1.2027 eller senare.
Följande värde har lagts till i koduppsättningen 2.1 Materialets schemaversion (QueryDataSchemaVersion):
- Schemat för distributionen av anmälningar om löneuppgifter som saknas
- Schemat för distributionen av anmälningar om förmånsuppgifter som saknas
- Följande värde har lagts till i koduppsättningen 2.5 Materialets typ, delas ut från inkomstregistret (QueryDataType):
- 321 Anmälningar om löneuppgifter som saknas - alla inkomsttagare (xml)
- 322 Anmälningar om löneuppgifter som saknas - flera inkomsttagare (xml)
- 323 Anmälningar om förmånsuppgifter som saknas - alla inkomsttagare (xml)
- 324 Anmälningar om förmånsuppgifter som saknas - flera inkomsttagare (xml)
- 410 Anmälningar om löneuppgifter som saknas – en inkomsttagare (WS i realtid, xml)
- 411 Anmälningar om förmånsuppgifter som saknas – en inkomsttagare (WS i realtid, xml)
- Följande typer av hämtningsvillkor för materialbeställning (ParameterType)
har lagts till:
- 33 Endast anmälningar med bestridsmarkering
- 34 Visning av bestridda uppgifter och uppgifter som saknas i anmälan
- Följande nya koduppsättningar har lagts till:
- Typ av saknade uppgifter (MissingDataType)
- Bestrids status (DisputeStatus)
- Endast anmälningar med bestridsmarkering (OnlyReportsWithDispute)
- Visning av bestridda uppgifter och uppgifter som saknas i anmälan (ShowDisputeInformation)
|
Koduppsättningar – Felkoder 2025 (xls)
- Publicerades 8.10.2025
- Koduppsättningen innehåller förklaringar till felkoder för det tekniska gränssnittet.
Koduppsättningar – Felkoder 2026 (xls)
Koduppsättningar – Felkoder 2027 (xls)
|
Dokumentet för år 2025:
- Texten i felkoden BEV0540 har ändrats.
Dokumentet för år 2026:
- 28.5.2025:
- Ett dokument för 2026 har publicerats.
Följande felkod har lagts till: AV0390, AV0400, AV0410, EV0180, EV0190, IDV0140, IDV0150, IDV0160, IDV0170, IDV0180, IEBV0090, IEOV0040, IEOV0050, TBVA0240, TBVA0241, TBVA0242, TBVA0243, TBVA0244. Följande felkoders förklaring har ändrats: EV0070, EV0110, EV0130, EV0140, TBVA0240, WPIDV0020.
- 13.8.2025:
- Följande felkod har lagts till: BEV0540
- Följande felkod har lagts till: WPIDV0040.
- Följande felkoders förklaring har ändrats: WPIDV0020.
- 8.10.2025:
- Följande felkod har lags till: AV0420.
- Följande felkod har lags till: AV0430.
- Texten i felkoden BEV0540 har ändrats.
- 6.11.2025:
- Felkoden AV0430 har avlägsnats.
- Felkoden TRVA0440 har lagts till. Felkodens förklaring av TRVA0420 har ändrats.
Dokumentet för år 2027:
- 27.10.2025:
- Ett dokument för 2027 har publicerats.
- Följande felkod har lags till: RDV0100, RDV0110
- 6.11.2025:
- Felkoden TRVA0440 har lagts till. Felkodens förklaring av TRVA0420 har ändrats.
|
|
Inkomstregistrets yrkesklassificering (TK10) (stat.fi)
- Inkomstregistrets egen yrkesklassificering heter "Inkomstregistrets yrkesklassificering (TK10)", men i inkomstregistrets system används fortfarande det gamla namnet "Statistikcentralens yrkesklassificering (TK10)".
- Klassificering finns på Statistikcentralens webbplats.
|
|
| Koduppsättningar – tidigare koduppsättningar |
|
|
Rapporter
Man kan beställa olika rapporter ur inkomstregistret. I rapporternas innehållsbeskrivningar beskrivs rapporter som kan beställas och deras beräkningsregler.
Rapporters innehållsbeskrivningar
| Rapporter – senaste innehållsbeskrivningar |
Senaste ändringar |
|
Rapporter ur inkomstregistret 2025 (pdf)
- Publicerades 8.10.2025
- I dokumentet beskrivs de rapporter som kan produceras ur inkomstregistret för informationsproducenterna, informationsanvändarna och inkomsttagarna.
Rapporter och material från inkomstregistret 2026 (pdf)
- Publicerades 8.10.2025
- I dokumentet beskrivs
- de rapporter och material som kan produceras ur inkomstregistret för informationsproducenterna, informationsanvändarna och inkomsttagarna
- hämtningsvillkor för material som distribueras på basis av materialbeställningen
- hur uppgifterna i inkomstregistrets rapporter beräknas.
Rapporter och material från inkomstregistret 2027 (pdf)
|
Dokumentet för år 2025:
- En begränsning har lagts till för rapport 701: antalet anmälningar räknas inte för materialtypen 320.
Dokumentet för år 2026:
- 19.6.2025:
- En ny version av dokumentet har publicerats. I det nya dokumentet har innehåll från följande tidigare dokument sammanställts:
- Rapporter ur inkomstregistret 2025
- Inkomstuppgifter – Beräkningsregler 2023
- Tekniskt gränssnitt – Datadistribution från inkomstregistret 2025 (innehållsbeskrivning av materialet)
- Dokumentet innehåller helheter som gäller årsändringarna 2026:
- Avsnitt 4.10: En ny datagrupp har lagts till för materialen 312 och 313 (Sammandrag av betalarens löneuppgifter) ”Summauppgifter i arbetsgivarens separata anmälningar”.
- Avsnitt 9.2: En ny beräkningsregel har lagts till: Det sammanlagda antalet anmälningar "ingen lönebetalning" (NoWages).
- 8.10.2025:
- Typ 320 - alla betalare (xml) har lagts till i tabellen i introduktionen. Ett nytt kapitel 6.8 Anmälningar om löneuppgifter - alla betalare (xml) har lagts till.
Dokumentet för år 2027:
- En version om dokumentet med datainnehållsändringarna för 2027 har publicerats. Ändringarna tillämpas då inkomstens betalningsdag är 1.1.2027 eller därefter.
- Följande nya avsnitt har lagts till:
- 1.3 Material som distribueras från inkomstregistret
- 6.19 Anmälningar om löneuppgifter som saknas – alla inkomsttagare (xml)
- 6.20 Anmälningar om löneuppgifter som saknas – flera inkomsttagare (xml)
- 6.21 Anmälningar om förmånsuppgifter som saknas – alla inkomsttagare (xml)
- 6.22 Anmälningar om förmånsuppgifter som saknas – flera inkomsttagare (xml)
- 7.10 Anmälningar om löneuppgifter som saknas – en inkomsttagare (xml)
- 7.11 Anmälningar om förmånsuppgifter som saknas – en inkomsttagare (xml)
- För rapporterna 700 och 701:
- I avsnittet rapportens uppgifter har en notering lagts till om att Uppgifter räknas inte för materialtyperna 321, 322, 323, 324, 410 och 411.
- För rapporterna 702 och 710:
- I avsnittet rapportens uppgifter har en notering lagts till som förklarar hur uppgifterna visas om åtgärdens mål är Period med saknade uppgifter.
- Nya urvalsvillkor 33 – Endast anmälningar med bestridsmarkering och 34 – Visning av bestridda uppgifter och uppgifter som saknas i anmälan har lagts till för materialtyperna 300–305 och 314–319 samt 400–402 och 406–409.
|
Inkomstuppgifter – Beräkningsregler 2025 (pdf)
- Publicerades 13.8.2024
- I dokumentet beskrivs hur uppgifterna i inkomstregistrets rapporter beräknas.
|
Dokumentet för år 2025:
- Dokumentversionen för år 2025 innehållande datainnehållsändringar har publicerats. Ändringarna tillämpas då utbetalningsdagen för inkomsten är 1.1.2025 eller senare.
- Två beräkningsregler som har preciserats:
- I regel 2.2.7 har namnet på inkomstslag 413 "Arbetspensionsförsäkringsavgift för arbetstagare" ändrats till "Arbetstagarens arbetspensionsförsäkringsavgift"
- I regel 2.2.8 har namnet på inkomstslag 414 "Arbetstagarens arbetslöshetsförsäkringsavgift" ändrats till "Arbetstagarens arbetslöshetsförsäkringspremie"
Dokumentet för år 2026:
- En ny dokumentet Rapporter och material från inkomstregistret 2026 (pdf) har publicerats. I det nya dokumentet har innehåll från följande tidigare dokument sammanställts:
- Rapporter ur inkomstregistret 2025
- Inkomstuppgifter – Beräkningsregler 2025
- Tekniskt gränssnitt – Datadistribution från inkomstregistret 2025 (innehållsbeskrivning av materialet)
|
| Rapporter – tidigare innehållsbeskrivningar |
|
|
Sändning av uppgifter
Uppgifter kan anmälas till inkomstregistret via det tekniska gränssnittet. Då talar man om att lämna in uppgifter. Utöver anmälningar kan man i gränssnittet skicka materialbeställningar och makulera uppgifter.
I den allmänna beskrivningen av sändning av uppgifter beskrivs principerna för att anmäla via gränssnittet. I Schemadokumenten beskrivs meddelandenas tekniska struktur och behandlingsregler, dvs. de automatiska kontroller som inkomstregistret genomför på de uppgifter som tas emot.
Även det material som lämnas in via laddningstjänsten i e-tjänsten ska motsvara dessa schemabeskrivningar.
Innehållsbeskrivningar för sändning av uppgifter
| Sändning av uppgifter – senaste innehållsbeskrivningar |
Senaste ändringar |
|
Tekniskt gränssnitt – Sändning av uppgifter till inkomstregistret 2021 (pdf)
- Publicerades 6.6.2022
- I dokumentet beskrivs
- inlämnande av uppgifter via det tekniska gränssnittet och laddningstjänsten på allmän nivå
- de tjänster som tar emot information i inkomstregistret och strukturen för det material som sänds
- rekommendationer i anslutning till sändning av uppgifter.
|
Dokumentet för år 2021:
- Beskrivningen av makuleringen och avslutandet av en materialbeställning i avsnitt 9.3.2 har preciserats.
Dokumentet för år 2026:
|
Sändning av uppgifter – Scheman – Anmälningar om löneuppgifter 2025 (pdf)
- Publicerades 3.6.2024
- I dokumentet beskrivs schemat WageReportsToIR, med vilket anmälan om löneuppgifter lämnas in till inkomstregistret.
Sändning av uppgifter – Scheman – Anmälningar om löneuppgifter 2026 (pdf)
Sändning av uppgifter – Scheman – Anmälningar om löneuppgifter 2027 (pdf)
|
Dokumentet för år 2025:
- En version om dokumentet med datainnehållsändringarna för 2025 har publicerats. Ändringarna tillämpas då inkomstens betalningsdag är 1.1.2025 eller därefter.
- En behandlingsregel har lagts till för uppgiften Ursprunglig betalningsperiod (OrigPaymentPeriod) i datagruppen Tilläggsuppgifter om återkrav (RecoveryData):
- Inkomstslagets kod för prestationen som är återkrav eller återbäring på eget initiativ måste vara giltig delvis eller helt under den alla ursprungliga betalningsperioder eller betalningsdagar.
- Nya värde har lags till behandlingsregel för uppgiften Typ av betalningsuppgift (PaymentType) i datagruppen Avlönad frånvaro (PaidAbsence): 2 (partiell sjukfrånvaro)
- En behandlingsregel har lagts till för uppgiften Typ av identifierare (Type) i datagruppen Arbetsolycksfallsförsäkring (AccidentInsurance):
- Typ av identifierare får inte vara “Finskt personbeteckning" eller “Utländsk personbeteckning”
- Ett nytt värde "3 (FPA, ersättning för semesterkostnader)" har lags till följande behandlingsreglerna för:
- uppgifterna E-postadress (Email) och Ansvarsområde (ResponsibilityCode) i datagruppen Kontaktpersoner för materialet (ContactPersons)
- uppgiften Typ av identifierare (Type) i datagruppen Betalarens identifierare (PayerIds)
- uppgiften Typ av identifierare (Type) i datagruppen Inkomsttagarens identifierare (IncomeEarnerIds)
- uppgifterna Startdatum (StartDate), Anställningsförhållandets giltighet (EmploymentPeriods), Avlöningsformer (PaymentTypes), Avlöningsform (PaymentType) och Anställningsförhållandets typ (EmploymentCode) i datagruppen Uppgifter om anställningsförhållandet (Employment)
- uppgiftena Slutdatum (EndDate) och Uppgifter om betalningen (ReimbPayment) i datagruppen Avlönad frånvaro (PaidAbsence).
- En behandlingsregel har lagts till för uppgiften Typ av betalningsuppgift (PaymentType) i datagruppen Avlönad frånvaro (PaidAbsence):
- Om "Typ av betalningsuppgift" = 3 (FPA, ersättning för semesterkostnader), ska "Orsak till frånvaro” vid avlönad frånvaro vara 23 (ersättning för semesterkostnader).
Dokumentet för år 2026:
- 27.5.2025:
- En version om dokumentet med datainnehållsändringarna för 2026 har publicerats. Ändringarna tillämpas då inkomstens betalningsdag är 1.1.2026 eller därefter.
Arbetspensionsanstaltens bolagskod 27 har lagts till i datagrupper Anställningsförhållandets giltighet (EmploymentPeriods) och Avslutande av anställningsförhållande (EmploymentEndings). En ny behandlingsregel ”Arbetspensionsanstaltens bolagskod” är 27, ska det på anmälan finnas en orsak till upphörandet enligt orsakskoduppsättningen ”Finlands Banks koder”. På anmälan ska det därtill alltid finnas en orsak till avslutandet enligt orsakskoduppsättningen ”Inkomstregistrets koder.” har lagts till för uppgiften Avslutande av anställningsförhållande (EmploymentEndings) i datagrupp Orsak till avslutande av anställningsförhållande (EmploymentEnding). En ny behandlingsregel ”En uppsägningsgrund enligt orsakskodgruppen Keva-koder och en uppsägningsgrund enligt orsakskodgruppen Finlands Bank får inte ges på samma anmälan.” har lagts till för uppgiften Avslutande av anställningsförhållande (EmploymentEndings) i datagrupp Orsak till avslutande av anställningsförhållande (EmploymentEnding). Behandlingsregel ”En inkomsttagare kan ha flera registreringsgrunder men endast ett värde enligt den bestämda uppgiften Typ av registreringsgrund.” togs bort från Registreringsgrund (EmploymentReg) från datagrupp Registrering av anställningsförhållande (EmploymentRegs). En ny behandlingsregel ”En inkomsttagare kan bara ha en registreringsgrund på anmälan.” har lagts till för uppgiften Registreringsgrund (EmploymentReg) i datagrupp Registrering av anställningsförhållande (EmploymentRegs).
- Behandlingsregeln "Om "Typ av identifierare" är "Annan identifierare", får identifieraren inte vara ett finländskt FO-nummer eller en finländsk personbeteckning." har tagits bort i följande datagrupperna:
- Betalarens identifierare (PayerIds)
- Arbetsgivarens identifierare (EmployerId)
- Representantens identifierare (RepresentativeIds)
- Uppdragsgivarens identifierare (FinServiceRecipientIds)
- Uppdragsgivarens identifierare (ServiceRecipientIds)
- En behandlingsregel "Om "Typ av identifierare" är någon annan än "FO-nummer" eller "Finsk personbeteckning", ska identifieraren inte vara en finländsk personbeteckning eller ett FO-nummer" har lagts till för uppgiften "Identifierare" i följande datagrupperna:
- Materialets ägare (DeliveryDataOwner)
- Betalarens identifierare (PayerIds)
- Arbetsgivarens identifierare (EmployerId)
- Inkomsttagarens identifierare (IncomeEarnerIds)
- Arbetsolycksfallsförsäkringsbolagets identifierare (AccInsProvId)
- Representantens identifierare (RepresentativeIds)
- Uppdragsgivarens identifierare (FinServiceRecipientIds)
- Uppdragsgivarens identifierare (ServiceRecipientIds)
- En behandlingsregel "Landskoden "FI" får inte anges om den angivna "Typ av identifierare" är en annan än "Fo-nummer", "Finsk personbeteckning" eller "Annan identifierare"" har lagts till för uppgiften "Landskod" i följande datagrupperna:
- Materialets ägare (DeliveryDataOwner)
- Betalarens identifierare (PayerIds)
- Arbetsgivarens identifierare (EmployerId)
- Inkomsttagarens identifierare (IncomeEarnerIds)
- Arbetsolycksfallsförsäkringsbolagets identifierare (AccInsProvId)
- Representantens identifierare (RepresentativeIds)
- Uppdragsgivarens identifierare (FinServiceRecipientIds)
- Uppdragsgivarens identifierare (ServiceRecipientIds)
- En behandlingsregel har lagts till för uppgiften Inkomstslagets kod (TransactionCode) i data gruppen Allmänna uppgifter om inkomstslaget (TransactionBasic): Om "Inkomstlagets kod" är 321-325 och en Typ av undantagssituationer för försäkring som motsvarar den valda inkomstlag kan inte anges i samma anmälan.
- Inkomstslag 321 och Typ av undantagssituation för försäkring Ingen försäkringsskyldighet (arbetspensions-, sjuk-, arbetslöshets- eller arbetsolycksfalls- och yrkessjukdomsförsäkring), Ingen försäkringsskyldighet (arbetspensionsförsäkring), Ingen försäkringsskyldighet (arbetslöshetsförsäkring), Ingen försäkringsskyldighet (arbetsolycksfalls- och yrkessjukdomsförsäkring) eller Ingen försäkringsskyldighet (sjukförsäkring) kan inte rapporteras samtidigt i samma anmälan
- Inkomstlag 322 och Typ av undantagssituation för försäkring Ingen försäkringsskyldighet (arbetspensionsförsäkring) kan inte rapporteras samtidigt i samma anmälan.
- Inkomstlag 323 och Typ av undantagssituation för försäkring Ingen försäkringsskyldighet (arbetslöshetsförsäkring) kan inte rapporteras samtidigt i samma anmälan.
- Inkomstlag 324 och Typ av undantagssituation för försäkring Ingen försäkringsskyldighet (arbetsolycksfalls- och yrkessjukdomsförsäkring) kan inte rapporteras samtidigt i samma anmälan.
- Inkomstlag 325 och Typ av undantagssituation för försäkring Ingen försäkringsskyldighet (sjukförsäkring) kan inte rapporteras samtidigt i samma anmälan.
- Lagts till en ny behandlingsregel "Om flera identifierare har angetts i datagruppen kan identifieringstyperna inte vara detsamma. Samma kombination av identifieringstyp och landskod kan inte anges flera gånger. Det kan bara finnas en identifieringstyp av "Finländsk personbeteckning" eller "FO-nummer" i datagruppen." till följande datagrupper:
- Betalarens identifierare (PayerIds)
- Inkomsttagarens identifierare (IncomeEarnerIds)
- Representantens identifierare (RepresentativeIds)
- Uppdragsgivarens identifierare (FinServiceRecipientIds)
- Uppdragsgivarens identifierare (ServiceRecipientIds)
- Behandlingsregeln ”Om inkomsttagaren beviljats flera finska personbeteckningar ska alla beteckningar ha samma födelsedatum som fastställs utifrån beteckningarna.” togs bort från datagruppen Inkomsttagarens identifierare (IncomeEarnerIds). Lagts till en ny behandlingsregel "Om "Typ av identifierare" är inställd som "Finländsk personbeteckning" eller "FO-nummer" kan landskoden bara vara "FI". till landskods uppgift (CountryCode) i följande datagrupper:
- Materialets ägare (DeliveryDataOwner)
- Materialets avsändare (DeliveryDataSender)
- Materialets skapare (DeliveryDataCreator)
- Betalarens identifierare (PayerIds)
- Arbetsgivarens identifierare (EmployerId)
- Inkomsttagarens identifierare (IncomeEarnerIds)
- Arbetsolycksfallsförsäkringsbolagets identifierare (AccInsProvId)
- Representantens identifierare (RepresentativeIds)
- Uppdragsgivarens identifierare (FinServiceRecipientIds)
- Uppdragsgivarens identifierare (ServiceRecipientIds)
- En ny behandlingsregel "Värdet får inte vara över 29 tecken." har lagts till för uppgiften Betalningens specifikation (PaymentSpecifier) i datagrupp Avlönad frånvaro (PaidAbsence).
- En ny behandlingsregel "Värdet får inte vara över 20 tecken." har lagts till för uppgiften Betalningens referensnummer (PaymentRef) i datagrupp Avlönad frånvaro (PaidAbsence).
Behandlingsregel "Uppgiften ska vara ett icke-negativt tal." togs bort från datagrupp Avlönad frånvaro (PaidAbsence). En ny behandlingsregel "Värdet måste vara större än 0" har lagts till för uppgiften Lönebelopp för avlönad frånvaro (Amount) i datagrupp Avlönad frånvaro (PaidAbsence).
- Nya behandlingsregler har lagts till för Typ av tilläggsuppgifter om inkomsttagaren (IncomeEarnerType): Samma anmälan om löneuppgifter kan endast ha ett av följande värden för Typ av tilläggsuppgifter om inkomsttagaren:
- Hyrd arbetstagare som bor utomlands
- Hyrd arbetstagare på ett finskt luftfartyg som bor utomlands
- Hyrd arbetstagare på ett finskt fartyg som bor utomlands
- Inkomsttagaren har vistats högst 183 dagar i Finland under den tidsperiod som avses i skatteavtalet
- Obligatorisk datagrupp om anmälan innehåller en "Typ av blankett" för "Etableringsanmälan för hyrd arbetstagare".
I detta fall måste ett av följande värden för Typ av tilläggsuppgifter om inkomsttagaren anges:
- Hyrd arbetstagare som bor utomlands
- Hyrd arbetstagare på ett finskt luftfartyg som bor utomlands
- Hyrd arbetstagare på ett finskt fartyg som bor utomlands
- Två nya typer av tilläggsuppgifter om inkomsttagaren har lagts till i behandlingsregeln för Arbetsperioder i Finland (WorkPeriodsInFinland):
"Hyrd arbetstagare på ett finskt luftfartyg som bor utomlands" och "Hyrd arbetstagare på ett finskt fartyg som bor utomlands". Lagts till en ny behandlingsregel "Uppgiften får inte börja eller sluta med ett blanksteg som inte skrivs ut, och uppgiften får inte innehålla blanksteg som inte skrivs ut, exklusive ett mellanslag. Förbjudna tecken listas i kapitel 1.2 Teckentabell." till följande datagrupper:
- Materialets ägare (DeliveryDataOwner)
- Betalarens identifierare (PayerIds)
Arbetsgivarens identifierare (EmployerId)
- Inkomsttagarens identifierare (IncomeEarnerIds)
- Arbetsolycksfallsförsäkringsbolagets identifierare (AccInsProvId)
- Representantens identifierare (RepresentativeIds)
- Uppdragsgivarens identifierare (FinServiceRecipientIds)
- Uppdragsgivarens identifierare (ServiceRecipientIds)
- 7.7.2025:
- Förklaringar för värden 18 och 19 Typ av tilläggsuppgifter om inkomsttagaren (Etableringsanmälan för hyrd arbetstagare) har korrigerats;
- Med värdet 18 Hyrd arbetstagare på ett finskt luftfartyg som bor utomlands -> Hyrd arbetstagare som bor utomlands, (och) arbetar på ett finskt luftfartyg
- Med värdet 19 Hyrd arbetstagare på ett finskt fartyg som bor utomlands -> Hyrd arbetstagare som bor utomlands, (och) arbetar på ett finskt fartyg
- Förklaringen av white space kodsystemet har uppdaterats; kodsystemet gäller både arbetsolycksfallsförsäkringens försäkringsnummer och identifierare.
- 8.10.2025:
- Nytt värde (3=Ackorsdlön) har lagts till i Paymenttype kodsystemet
- En behandlingsregel av avlönad frånvaro (PaidAbsence) har uppdaterats:
- Det nya värdet 24 (partiell särskild graviditetsledighet) har lagts till i listan över giltiga Payment type värden i det fall att 'Payment data type' = 1 (FPA, ansökan om dagpenning).
- 6.11.2025:
- Uppgiftens namn ”Intyg över socialskydd (A1- intyg)” har rättats: ”Intyg över socialskydd ((PostedCertCode)”
- En behandlingsregel av avlönad frånvaro (PaidAbsence) har uppdaterats:
Värdet 24 (partiell särskild graviditetsledighet) har tagits bort från listan över giltiga Payment type värden i det fall att 'Payment data type' = 1 (FPA, ansökan om dagpenning).
- En behandlingsregel av bilens utläppsvärde (EmissionsValue) har uppdaterats: värdet kan vara 0, om prestationens betalningsdag eller annan anmälningsdag infaller åren 2026–2029.
Dokumentet för år 2027:
- 27.10.2025:
- En version om dokumentet med datainnehållsändringarna för 2027 har publicerats. Ändringarna tillämpas då inkomstens betalningsdag är 1.1.2027 eller därefter.
- I datagruppen Uppgifter om tjänsten (ReportData) har lagts till en ny frivillig datagrupp Referensuppgifterna för begäran om rättelse (DemandForRectificationIds).
- Uppgiftens namn ”Intyg över socialskydd (A1- intyg)” har rättats: ”Intyg över socialskydd (PostedCertCode)”.
- 6.11.2025:
- En behandlingsregel av bilens utläppsvärde (EmissionsValue) har uppdaterats: värdet kan vara 0, om prestationens betalningsdag eller annan anmälningsdag infaller åren 2026–2029.
|
Sändning av uppgifter – Scheman – Arbetsgivarens separata anmälningar 2025 (pdf)
- Publicerades 3.6.2024
- I dokumentet beskrivs schemat PayerSummaryReportsToIR, med vilket arbetsgivarens separata anmälningar lämnas in till inkomstregistret.
Sandning av uppgifter – Scheman – Arbetsgivarens separata änmalningar 2026 (pdf)
|
Dokumentet för år 2025:
- Versionen av dokumentet som innehåller ändringarna i datainnehållet för 2025 har publicerats. Ändringarna ska tillämpas när betalningsdagen för inkomsten infaller 1.1.2025 eller senare.
- En behandlingsregel har lagts till för uppgiften Typ av identifierare (Type) i datagruppen Arbetsolycksfallsförsäkring (AccidentInsurances):
- Typ av identifierare får inte vara “Finskt personbeteckning" eller “Utländsk personbeteckning”.
Dokumentet för år 2026:
27.5.2025:
- En version om dokumentet med datainnehållsändringarna för 2026 har publicerats. Ändringarna tillämpas då inkomstens betalningsdag är 1.1.2026 eller därefter.
- Behandlingsregeln "Om "Typ av identifierare" är "Annan identifierare", får identifieraren inte vara ett finländskt FO-nummer eller en finländsk personbeteckning." har tagits bort i följande datagrupperna:
- Betalarens identifierare (PayerIds)
- En behandlingsregel "Om "Typ av identifierare" är någon annan än "FO-nummer" eller "Finsk personbeteckning", ska identifieraren inte vara en finländsk personbeteckning eller ett FO-nummer" har lagts till för uppgiften "Identifierare" i följande datagrupperna:
- Materialets ägare (DeliveryDataOwner)
- Betalarens identifierare (PayerIds)
- Arbetsolycksfallsförsäkringsbolagets identifierare (AccInsProvId)
- En behandlingsregel "Landskoden "FI" får inte anges om den angivna "Typ av identifierare" är en annan än "Fo-nummer", "Finsk personbeteckning" eller "Annan identifierare"" har lagts till för uppgiften "Landskod" i följande datagrupperna:
- Materialets ägare (DeliveryDataOwner)
- Betalarens identifierare (PayerIds)
- Arbetsolycksfallsförsäkringsbolagets identifierare (AccInsProvId)
- Lagts till en ny behandlingsregel "Om flera identifierare har angetts i datagruppen kan identifieringstyperna inte vara detsamma. Samma kombination av identifieringstyp och landskod kan inte anges flera gånger. Det kan bara finnas en identifieringstyp av "Finländsk personbeteckning" eller "FO-nummer" i datagruppen.":
- Lagts till en ny behandlingsregel "Om "Typ av identifierare" är inställd som "Finländsk personbeteckning" eller "FO-nummer" kan landskoden bara vara "FI". till landskods uppgift (CountryCode) i följande datagrupper:
- Materialets ägare (DeliveryDataOwner)
- Materialets avsändare (DeliveryDataSender)
- Materialets skapare (DeliveryDataCreator)
- Betalarens identifierare (PayerIds)
- Arbetsolycksfallsförsäkringsbolagets identifierare (AccInsProvId)
- Lagts till en ny behandlingsregel "Uppgiften får inte börja eller sluta med ett blanksteg som inte skrivs ut, och uppgiften får inte innehålla blanksteg som inte skrivs ut, exklusive ett mellanslag.” till följande datagrupper:
- Materialets ägare (DeliveryDataOwner)
- Betalarens identifierare (PayerIds)
- Arbetsolycksfallsförsäkringsbolagets identifierare (AccInsProvId)
- 4.7.2025:
- Tillagd teckenuppsättning för white space (1.2)
|
Sändning av uppgifter – Scheman – Anmälningar om förmånsuppgifter 2025 (pdf)
- Publicerades 8.10.2025
- I dokumentet beskrivs schemat BenefitReportsToIR, med vilket anmälningar om förmånsuppgifter lämnas in till inkomstregistret.
Sändning av uppgifter – Scheman – Anmälningar om förmånsuppgifter 2026 (pdf)
Sändning av uppgifter – Scheman – Anmälningar om förmånsuppgifter 2027 (pdf)
|
Dokumentet för år 2025:
- 3.6.2024:
- Versionen av dokumentet som innehåller ändringarna i datainnehållet för 2025 har publicerats. Ändringarna ska tillämpas när betalningsdagen för inkomsten infaller 1.1.2025 eller senare.
- En behandlingsregel har lagts till för uppgiften Ursprunglig betalningsperiod (OrigEarningPeriod) i datagruppen Tilläggsuppgifter om återkrav (RecoveryData):
- Inkomstslagets kod för prestationen som är återkrav eller återbäring på eget initiativ måste vara giltig delvis eller helt under den ursprungliga betalningsperioden eller betalningsdag.
- Uppgiften Den ställföreträdande mottagarens adress (Address) i datagruppen Den ställföreträdande mottagarens adress (Address) har ändrats obligatorisk i följande fall:
- I datagruppen ”Den ställföreträdande mottagarens identifierare” har en identifierare, där ”Typ av identifierare” är ”FO-nummer” eller ”Finsk personbeteckning” inte angetts.
- Uppgiften "Den ställföreträdande mottagaren saknar kundnummer" är "true".
- 13.8.2025:
- En behandlingsregel har lagts till för uppgiften Avdrag (Deductions) i datagruppen Kod för inkomstslaget för avdraget (DeductionTransactionCode):
- Koden för inkomstslaget för avdraget ska helt eller delvis vara i kraft under förmånens ursprungliga intjäningsperiod eller prestationens betalningsdag.
- En behandlingsregel har lagts till för uppgiften Avdrag (Deductions) i datagruppen Intjäningsperiod för den ursprungliga förmånen (OrigBenefitEarningPeriod):
- Koden för inkomstslaget för avdraget ska helt eller delvis vara i kraft under förmånens ursprungliga intjäningsperiod eller prestationens betalningsdag.
- 8.10.2025:
- Preciserade den föregående regeln:
Koden för inkomstslaget för avdraget ska helt eller delvis vara i kraft under förmånens ursprungliga intjäningsperiod eller ”Prestationens betalningsdag eller annan anmälningsdag (PaymentDate)" som angetts i datagruppen "Uppgifter om materialet (DeliveryData)".
Dokumentet för år 2026:
- 4.7.2025:
- En version om dokumentet med datainnehållsändringarna för 2026 har publicerats. Ändringarna tillämpas då inkomstens betalningsdag är 1.1.2026 eller därefter.
- En behandlingsregel "Om "Typ av identifierare" är någon annan än "FO-nummer" eller "Finsk personbeteckning", ska identifieraren inte vara en finländsk personbeteckning eller ett FO-nummer" har lagts till för uppgiften "Identifierare" i följande datagrupperna:
- Materialets ägare (DeliveryDataOwner)
- Betalarens identifierare (PayerIds)
- Inkomsttagarens identifierare (IncomeEarnerIds)
- Försäkringstagarens identifierare (InsurancePolicyHolderIds)
- Den ställföreträdande mottagarens identifierare (IncomeBeneficiaryIds)
- En behandlingsregel "Landskoden "FI" får inte anges om den angivna "Typ av identifierare" är en annan än "Fo-nummer", "Finsk personbeteckning" eller "Annan identifierare"" har lagts till för uppgiften "Landskod" i följande datagrupperna:
- Materialets ägare (DeliveryDataOwner)
- Betalarens identifierare (PayerIds)
- Inkomsttagarens identifierare (IncomeEarnerIds)
- Försäkringstagarens identifierare (InsurancePolicyHolderIds)
- Den ställföreträdande mottagarens identifierare (IncomeBeneficiaryIds)
- Lagts till en ny behandlingsregel "Om flera identifierare har angetts i datagruppen kan identifieringstyperna inte vara detsamma. Samma kombination av identifieringstyp och landskod kan inte anges flera gånger. Det kan bara finnas en identifieringstyp av "Finländsk personbeteckning" eller "FO-nummer" i datagruppen." till följande datagrupper:
- Betalarens identifierare (PayerIds)
- Inkomsttagarens identifierare (IncomeEarnerIds)
- Försäkringstagarens identifierare (InsurancePolicyHolderIds)
- Den ställföreträdande mottagarens identifierare (IncomeBeneficiaryIds)
- Behandlingsregeln ”Om inkomsttagaren beviljats flera finska personbeteckningar ska alla beteckningar ha samma födelsedatum som fastställs utifrån beteckningarna.” togs bort från datagrupperna Inkomsttagarens identifierare (IncomeEarnerIds), Försäkringstagarens identifierare (InsurancePolicyHolderIds) och Den ställföreträdande mottagarens identifierare (IncomeBeneficiaryIds).
- Lagts till en ny behandlingsregel "Om "Typ av identifierare" är inställd som "Finländsk personbeteckning" eller "FO-nummer" kan landskoden bara vara "FI". till landskods uppgift (CountryCode) i följande datagrupper:
- Materialets ägare (DeliveryDataOwner)
- Materialets avsändare (DeliveryDataSender)
- Materialets skapare (DeliveryDataCreator)
- Betalarens identifierare (PayerIds)
- Inkomsttagarens identifierare (IncomeEarnerIds)
- Försäkringstagarens identifierare (InsurancePolicyHolderIds)
- Den ställföreträdande mottagarens identifierare (IncomeBeneficiaryIds)
- Lagts till en ny behandlingsregel "Uppgiften får inte börja eller sluta med ett blanksteg som inte skrivs ut, och uppgiften får inte innehålla blanksteg som inte skrivs ut, exklusive ett mellanslag.” till följande datagrupper:
- Materialets ägare (DeliveryDataOwner)
- Betalarens identifierare (PayerIds)
- Inkomsttagarens identifierare (IncomeEarnerIds)
- Försäkringstagarens identifierare (InsurancePolicyHolderIds)
- Den ställföreträdande mottagarens identifierare (IncomeBeneficiaryIds)
- Lagts till en ny behandlingsregel "Om inkomsttagaren/försäkringstagaren/ställföreträdandet har tilldelats både ett FO-nummer och en finländsk personbeteckning, ska identifierarna avse samma kund." till följande datagrupper:
- Inkomsttagarens identifierare (IncomeEarnerIds)
- Försäkringstagarens identifierare (InsurancePolicyHolderIds)
- Den ställföreträdande mottagarens identifierare (IncomeBeneficiaryIds)
- Tillagd teckenuppsättning för white space (1.2)
- 13.8.2025:
- En behandlingsregel har lagts till för uppgiften Avdrag (Deductions) i datagruppen Kod för inkomstslaget för avdraget (DeductionTransactionCode):
- Koden för inkomstslaget för avdraget ska helt eller delvis vara i kraft under förmånens ursprungliga intjäningsperiod eller prestationens betalningsdag.
- En behandlingsregel har lagts till för uppgiften Avdrag (Deductions) i datagruppen Intjäningsperiod för den ursprungliga förmånen (OrigBenefitEarningPeriod):
- Koden för inkomstslaget för avdraget ska helt eller delvis vara i kraft under förmånens ursprungliga intjäningsperiod eller prestationens betalningsdag.
- 8.10.2025:
- Preciserade den föregående regeln:
Koden för inkomstslaget för avdraget ska helt eller delvis vara i kraft under förmånens ursprungliga intjäningsperiod eller ”Prestationens betalningsdag eller annan anmälningsdag (PaymentDate)" som angetts i datagruppen "Uppgifter om materialet (DeliveryData)".
Dokumentet för år 2027:
- En version om dokumentet med datainnehållsändringarna för 2027 har publicerats. Ändringarna tillämpas då inkomstens betalningsdag är 1.1.2027 eller därefter.
- I datagruppen Uppgifter om tjänsten (ReportData) har lagts till en ny frivillig datagrupp Referensuppgifterna för begäran om rättelse (DemandForRectificationIds).
|
|
Sändning av uppgifter – Scheman – Materialbeställningar 2025 (pdf)
- Publicerades 24.11.2025
- I dokumentet beskrivs schemat SubscriptionsToIR, med vilket materialbeställningar lämnas in till inkomstregistret.
|
- En version med datainnehållsändringarna för 2025 har publicerats.
- Läggs till Materialets ägarens (DeliveryDataOwner) behandlingsregel; Organisationen ska ha ett kundnummer. Om kundnumret för skaparen av materialet skiljer sig från kundnumret för ägaren av materialet, används skaparens åtkomsträttigheter vid hämtningen av materialet.
|
|
Sändning av uppgifter – Scheman – Makuleringsuppgifter 2025 (pdf)
- Publicerades 8.1.2025
- I dokumentet beskrivs schemat InvalidationsToIR, med vilket anmälningar om inkomstuppgifter, materialbeställningar och material annulleras i inkomstregistret.
Sändning av uppgifter – Scheman – Makuleringsuppgifter 2026 (pdf)
|
Dokumentet för år 2025:
- Dokumentversionen för år 2025 innehållande datainnehållsändringar har publicerats. Ändringarna tillämpas då utbetalningsdagen för inkomsten är 1.1.2025 eller senare.
- Kompletterat beskrivningen av sektionen "Makulering eller avslutning av en materialbeställning" i datagruppen Objekt som ska makuleras (flera) (Items).
Dokumentet för år 2026:
- 28.5.2025:
- Dokumentversionen för år 2026 innehållande datainnehållsändringar har publicerats. Ändringarna tillämpas då utbetalningsdagen för inkomsten är 1.1.2026 eller senare.
- Lagts till en ny behandlingsregel "Uppgiften får inte börja eller sluta med ett blanksteg som inte skrivs ut, och uppgiften får inte innehålla blanksteg som inte skrivs ut, exklusive ett mellanslag." till datagrupp Uppgifter om materialet (DeliveryData).
- 4.7.2025:
- Tillagd teckenuppsättning för white space (1.2)
|
|
Sändning av uppgifter – Scheman – Mottagningskvittering 2024 (pdf)
- Publicerades 3.6.2024
- I dokumentet beskrivs schemat AckFromIR, med vilket inkomstregistret sänder ett mottagningskvitto till material som skickats till inkomstregistret.
- Schemat används i det asynkroniska gränssnittet Web Service.
|
- I datagruppen Allmänna uppgifter om mottaget material (DeliveryData) har uppgiften Materialets ägares materialreferens (DeliveryId) korrigerats till frivillig (F).
|
|
Sändning av uppgifter – Scheman – Förfrågan om behandlingsrespons 2021 (pdf)
- Publicerades 6.6.2022
- I dokumentet beskrivs schemat StatusRequestToIR, med vilket den som sänt materialet kan be om respons om behandling till material som sänts till inkomstregistret.
- Schemat används i det asynkroniska gränssnittet Web Service.
|
- I datagrupperna Materialets ägare (DeliveryDataOwner), Materialets skapare (DeliveryDataCreator) och Materialets avsändare (DeliveryDataSender) har uppgiften Typ korrigerats: Typen ”mtirt:Id” har ändrats till ”smt:Id”. Korrigeringen påverkar inte genomförandet.
|
|
Sändning av uppgifter – Scheman – Behandlingsrespons 2024 (pdf)
- Publicerades 3.6.2024
- I dokumentet beskrivs schemat StatusResponseFromIR, med vilket inkomstregistret sänder respons om behandling till material som sänts till inkomstregistret.
|
- I datagruppen Allmänna uppgifter om mottaget material (DeliveryData) har uppgiften Materialets ägares materialreferens (DeliveryId) korrigerats till frivillig (F).
|
| Sändning av uppgifter – tidigare innehållsbeskrivningar |
|
|
Datadistribution
Dokumenten gällande datadistribution är i huvudsak avsedda för inkomstregistrets informationsanvändare. Endast myndigheter och andra instanser med lagstadgad behörighet får använda uppgifter som införts i inkomstregistret.
Uppgifterna distribueras via e-tjänsten och det tekniska gränssnittet. I den allmänna beskrivningen av datadistributionen beskrivs principerna för hur uppgifterna används i gränssnittet. I schemadokumenten beskrivs meddelandenas tekniska struktur och behandlingsregler, vilka bestämmer vilka uppgifter som distribueras i varje element.
Innehållsbeskrivningar för datadistribution
| Datadistribution – senaste innehållsbeskrivningar |
Senaste ändringar |
|
Tekniskt gränssnitt – Datadistribution från inkomstregistret 2025 (pdf)
- Publicerades 8.10.2025
- I dokumentet beskrivs
- datadistributionen ur inkomstregistret via det tekniska gränssnittet på allmän nivå
- de tjänster som distribuerar information ur inkomstregistret och strukturen för det material som distribueras
- hämtningsvillkor för material som distribueras på basis av materialbeställningen
- rekommendationer gällande distribution
- materialet Sammandrag över betalarens löneuppgifter (312/313) som är avsett för prestationsbetalare.
|
Dokumentet för år 2025:
-
- Typ 320 - alla betalare (xml) har lagts till i tabellen i introduktionen. Ett nytt kapitel 6.8 Anmälningar om löneuppgifter - alla betalare (xml) har lagts till.
Dokumentet för år 2026:
|
|
Datadistribution – Scheman – Anmälningar om löneuppgifter 2024 (pdf)
- Publicerades 11.9.2023
- I dokumentet beskrivs schemat WageReportsFromIR, med vilket anmälan om löneuppgifter distribueras ur inkomstregistret.
Datadistribution – Scheman – Anmälningar om löneuppgifter 2027 (pdf)
|
Dokumentet för år 2024:
- En behandlingsregel har lagts till för uppgiften Betalarens identifierare (PayerIds) i datagruppen Betalarens identifierare (Id): Betalaren kan ha upp till tre identifierare.
Dokumentet för år 2027:
- En version om dokumentet med datainnehållsändringarna för 2027 har publicerats. Ändringarna tillämpas då inkomstens betalningsdag är 1.1.2027 eller därefter
- En ny uppgift har lagts till i flera olika informationsgrupper för att ange om uppgiften har bestridits av den registrerade.
- Följande nya informationsgrupper har lagts till under punkt 2.17 Uppgifter om tjänsten:
- Referensuppgifterna för begäran om rättelse (DemandForRectificationIds)
- Bestridande som gäller anmälan (ReportDisputes)
- Ny informationsgrupp Anmälans saknade uppgifter (MissingData) har lagts till i punkt 2.60.
|
|
Datadistribution – Scheman – Arbetsgivarens separata anmälningar 2024 (pdf)
- Publicerades 11.9.2023
- I dokumentet beskrivs schemat PayerSummaryReportsFromIR, med vilket arbetsgivarens separata anmälningar distribueras ur inkomstregistret.
|
- En behandlingsregel har lagts till för uppgiften Betalarens identifierare (PayerIds) i datagruppen Betalarens identifierare (Id): Betalaren kan ha upp till tre identifierare.
|
|
Datadistribution – Scheman – Anmälningar om förmånsuppgifter 2024 (pdf)
- Publicerades 11.9.2023
- I dokumentet beskrivs schemat BenefitReportsFromIR, med vilket anmälningar om förmånsuppgifter distribueras ur inkomstregistret.
Datadistribution – Scheman – Anmälningar om förmånsuppgifter 2027 (pdf)
|
Dokumentet för år 2024:
- En behandlingsregel har lagts till för uppgiften Betalarens identifierare (PayerIds) i datagruppen Betalarens identifierare (Id): Betalaren kan ha upp till tre identifierare.
Dokumentet för år 2027:
- Versionen av dokumentet som innehåller ändringarna i datainnehållet för 2027 har publicerats. Ändringarna ska tillämpas när betalningsdagen för inkomsten infaller 1.1.2027 eller senare.
- En ny uppgift har lagts till i flera olika informationsgrupper för att ange om uppgiften har bestridits av den registrerade.
- Följande nya informationsgrupper har lagts till under punkt 2.14 Uppgifter om tjänsten:
Referensuppgifterna för begäran om rättelse (DemandForRectificationIds) Bestridande som gäller anmälan (ReportDisputes)
- Ny informationsgrupp Anmälans saknade uppgifter (MissingData) har lagts till i punkt 2.38.
|
|
Datadistribution – Scheman – Tjänstebegäran 2021 (pdf)
- Publicerades 1.6.2020
- I dokumentet beskrivs schemat DataRequestToIR, med vilket informationsanvändare i inkomstregistret begär en tjänst, dvs. begär uppgifter ur inkomstregistret.
- Schemat används i realtidsgränssnittet Web Service.
|
- Dokumentets innehåll motsvarar dokumentet för 2020.
|
|
Datadistribution – Scheman – Loggdata 2025 (pdf)
- Publicerades 8.1.2025
- I dokumentet beskrivs schemat LogDataFromIR, med vilket loggdata distribueras ur inkomstregistret.
Datadistribution – Scheman – Loggdata 2027 (pdf)
|
Dokumentet för år 2025:
- Ett dokument för 2025 har publicerats.
- Nya uppgiften har lags till datagruppen Loggaktiviteter (LogEvents):
- Användarens namn
- Informationsanvändarens roll
Dokumentet för år 2027:
- Ett dokument för 2027 har publicerats.
- En ny datagrupp 'Period med saknade uppgifter' (MissingDataPeriodTargetItem) har lagts till i avsnitt 2.5 Loggaktivitetens objekt (flera).
|
|
Datadistribution – Scheman – Sammandrag över betalarens löneuppgifter 2021 (pdf)
- Publicerades 6.6.2022
- I dokumentet beskrivs schemat WageReportSummaryFromIR, med vilket materialet Sammandrag över betalarens löneuppgifter (312/313) distribueras ur inkomstregistret.
- Materialet är avsett för prestationsbetalare.
Datadistribution – Scheman – Sammandrag över betalarens löneuppgifter 2026 (pdf)
|
Dokumentet för år 2021:
- Till den allmänna strukturen som beskrivs i avsnitt 2 Sammandrag över betalarens löneuppgifter (WageReportSummaryFromIR)
har lagts till uppgifterna Typ som saknats i datagrupperna. Korrigeringen påverkar inte genomförandet.
Dokumentet för år 2026:
- Versionen av dokumentet som innehåller ändringarna i datainnehållet för 2026 har publicerats. Ändringarna ska tillämpas när betalningsdagen för inkomsten infaller 1.1.2026 eller senare.
- Ändringar i dokumentet:
En ny datagrupp har lags till i materialet: Summauppgifter för arbetsgivarens separata anmälningar per rapporteringsperiod.
|
|
Datadistribution – Scheman – Förkastade anmälningar som lämnats in på pappersblankett 2024 (pdf)
- Publicerades 11.9.2023
- I dokumentet beskrivs schemat RejectedPaperReportsFromIR, med vilket materialet Förkastade anmälningar inlämnade med pappersblankett (950) distribueras ut inkomstregistret. Materialet innehåller förkastade anmälningar om löneuppgifter och arbetsgivarens separata anmälningar som lämnats in med pappersblankett.
|
- En behandlingsregel har lagts till för uppgiften Betalarens identifierare (PayerIds) i datagruppen Betalarens identifierare (Id): Betalaren kan ha upp till tre identifierare
|
|
Datadistribution – Schema – Alla betalare 2025 (pdf)
- Publicerades 8.10.2025
- I dokumentet beskrivs schemat WageReportPayersFromIR, med vilket skickas ett sammandrag av identifierare för betalare, ställföreträdande betalare och egentlig arbetsgivare som lämnat in anmälningar till inkomstregistret under intervallet för betalningsdagen.
|
- Versionen för år 2025 har publicerats.
- Ett nytt schema har skapats.
|
|
Datadistribution – Scheman – Anmälningar om löneuppgifter som saknas – 2027 (pdf)
- Publicerades 27.10.2025
- I dokumentet beskrivs schemat MissingWageReportsFromIR, med vilket skickas information om anmälningar av löneuppgifter som saknas från inkomstregistret.
|
- Dokumentet har publicerats.
|
|
Datadistribution – Scheman – Anmälningar om förmånsuppgifter som saknas – 2027 (pdf)
- Publicerades 27.10.2025
- I dokumentet beskrivs schemat MissingBenefitReportsFromIR, med vilket skickas information om anmälningar av förmånsuppgifter som saknas från inkomstregistret.
|
- Dokumentet har publicerats.
|
| Datadistribution – tidigare innehållsbeskrivningar |
|
|
Anvisningar för applikationsutvecklare
Anvisningarna för applikationsutvecklare är tekniska anvisningar för den som genomför gränssnitt.
Anvisningar för applikationsutvecklare
| Anvisningar för applikationsutvecklare – senaste anvisningar |
Senaste ändringar |
|
Tekniskt gränssnitt – Tillämpningsanvisning 2024 (pdf)
- Publicerades 12.12.2023
- I dokumentet beskrivs principerna för genomförandet av inkomstregistrets tekniska gränssnitt med tanke på den som genomför systemintegrationen.
Tekniskt gränssnitt – Tillämpningsanvisning för sändning och distribution av uppgifter 2026 (pdf)
- Publicerades 8.10.2025
- I dokumentet beskrivs
- principerna för genomförandet av inkomstregistrets tekniska gränssnitt med tanke på den som genomför systemintegrationen
- de tjänster som tar emot information i inkomstregistret och strukturen för det material som sänds
- inlämnande av uppgifter via det tekniska gränssnittet och laddningstjänsten på allmän nivå
- de tjänster som distribuerar information ur inkomstregistret och strukturen för det material som distribueras
- datadistributionen ur inkomstregistret via det tekniska gränssnittet på allmän nivå
- rekommendationer gällande sändning av uppgifter och datadistribution.
Tekniskt gränssnitt – Tillämpningsanvisning för sändning och distribution av uppgifter 2027 (pdf)
|
Dokumentet för år 2024:
- En ny version av dokumentet med ändringarna i datainnehåller för 2024 har publicerats.
- Uppgifter om distribution av materialen 312 och 313 till SFTP-mappen för den som skapat materialet har lagts till kapitel 4.1.1.
Dokumentet för år 2026:
- 8.10.2025
- En ny version av dokumentet har publicerats. I det nya dokumentet har innehåll från följande tidigare dokument sammanställts:
- Tekniskt gränssnitt – Sändning av uppgifter till inkomstregistret 2021
- Tekniskt gränssnitt – Datadistribution från inkomstregistret 2025
- Tekniskt gränssnitt – Tillämpningsanvisning 2024
Dokumentet för år 2027:
- En version om dokumentet med datainnehållsändringarna för 2027 har publicerats.
- Styckena 10.1.5 koduppsättningar och 10.2.5 koduppsättningar har tagits bort, och innehållet som beskrivs i dessa stycken har flyttats till kapitel 10 Allmänt om sändning och distribution av uppgifter.
- Tillägg till dokumentet:
- Stycke 6 har kompletterats med maximistorlekar för material enligt de nya distributionsschemana samt tillåtna rotelement.
- Stycke 5.2.2 har kompletterats med nya Web Service-tjänster som kan användas för att göra förfrågningar om saknade anmälningar om löne- eller förmånsuppgifter.
- Stycke 9.1 har kompletterats med nya tjänster för informationsanvändare (321–324, 410, 411), som kan användas för att göra förfrågningar om saknade anmälningar om löne- eller förmånsuppgifter.
- Stycke 9.5.2 har kompletterats med nya distributionsscheman för att hämta saknade anmälningar om löne- eller förmånsuppgifter.
- Texten i stycke 10.2.3 har uppdaterats gällande principen för härledda uppgifter.
- Ett nytt stycke 10.2.4 Begränsning av behandlingen av personuppgifter har lagts till.
- Stycke 12.2.3 har kompletterats med en ny uppgift: Referens för begäran om rättelse.
|
|
Tekniskt gränssnitt – ZIP – fil för applikationsutvecklare 2025 (zip)
Tekniskt gränssnitt – ZIP – fil för applikationsutvecklare 2025 (pdf)
- Publicerades 8.1.2024
- Zip-fil, som innehåller schemanas xsd-beskrivningar och tjänsternas WSDL-beskrivningar.
- I pdf-dokumentet beskrivs zip-filens innehåll.
Tekniskt gränssnitt – ZIP – fil för applikationsutvecklare 2027 (zip)
Tekniskt gränssnitt – ZIP – fil för applikationsutvecklare 2027 (pdf)
|
Dokumentet för år 2025:
- En version om dokumentet med datainnehållsändringarna för 2025 har publicerats.
- En beskrivning av ändringarna i innehållet har lagts till.
Dokumentet för år 2027:
- En version om dokumentet med datainnehållsändringarna för 2027 har publicerats.
- Tillagda nya tjänster i WSDL-beskrivningarna:
- MissingWageReportQueryService
- MissingBenefitReportQueryService
- Tillagda nya scheman i XSD-schemafilerna:
- MissingBenefitReportsFromIR.xsd
- MissingBenefitReportsFromIRTypes.xsd
- MissingWageReportsFromIR.xsd
- MissingWageReportsFromIRTypes.xsd
|
|
Tekniskt gränssnitt – underteckning av meddelande, exempelgenomförande (zip)
Tekniskt gränssnitt – underteckning av meddelande, exempelgenomförande (pdf)
- Publicerades 23.3.2018
- Zip-filen innehåller genomförandet av ett kundgränssnitt (client) på .Net/C#-språket på kallelse av Echo-tjänsten (EchoService) och ett meddelande om begäran om underskrift som ska sändas.
- I pdf-dokumentet beskrivs zip-filens innehåll.
|
|
| Anvisningar för applikationsutvecklare – tidigare anvisningar |
|
|