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.
|
- 13.8.2024
- En version av dokumentet med ändringar av datainnehållet för 2025 och övriga Inkomstregisterenhetens uppdateringar har publicerats. Förändringarna tillämpas då inkomstens betalningsdag är 1.1.2025 eller därefter.
- Inkomstslagets namn för följande inkomstslag har preciserats:
- Inkomstslagets 413 namn "Arbetspensionsförsäkringsavgift för arbetstagare" ändrades till "Arbetstagarens arbetspensionsförsäkringsavgift"
- Inkomstslagets 414 namn "Arbetstagarens arbetslöshetsförsäkringsavgift" ändrades till "Arbetstagarens arbetslöshetsförsäkringspremie"
- 25.11.2024
- 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
|
Tillämpningsanvisning för informationsinnehållet i anmälan om löneuppgifter 2025 (pdf)
- Publicerades 8.1.2025
- I dokumentet beskrivs informationsinnehållet i anmälan om löneuppgifter och vad som anmäls i varje enskild punkt av informationsinnehållet.
|
- 3.6.2024:
- En version av dokumentet med ändringar av datainnehållet för 2025 och övriga Inkomstregisterenhetens uppdateringar har publicerats. Förändringarna tillämpas då inkomstens betalningsdag är 1.1.2025 eller därefter.
- En ny orsak till frånvaro har lagts till i uppgiften Avlönad frånvaro (PaidAbsence): Ersättning för semesterkostnader
- En ny typ av betalningsuppgift,har lagts till i uppgiften Uppgifter för ansökan om ersättning (ReimbApp): Ersättning för semesterkostnader
- 13.8.2024:
- Förklaringar för följande inkomstslag har preciserats:
- Inkomstslagets 413 förklaring "Arbetspensionsförsäkringsavgift för arbetstagare" ändrades till "Arbetstagarens arbetspensionsförsäkringsavgift"
- Inkomstslagets 414 förklaring "Arbetstagarens arbetslöshetsförsäkringsavgift" ändrades till "Arbetstagarens arbetslöshetsförsäkringspremie"
- 5.11.2024:
- Från uppgiften Typ av tilläggsuppgifter om inkomsttagaren (IncomeEarnerType) har följande typ tagits bort:
- Sysselsatt med statens sysselsättningsanslag
- 8.1.2025:
- De saknade skatteavtalsländerna Albanien och Spanien har lagts till i beskrivningen av inkomst-tagartypen "Hyrd arbetstagare som bor utomlands" i Tilläggsuppgifter om inkomsttagaren (IncomeEarnerTypes). Listan har omorganiserats i alfabetisk ordning.
|
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 5.11.2024
- 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.
|
- 3.6.2024:
- En version av dokumentet innehållande datainnehållsändringarna år 2025 har publicerats.
- Inkomstslagen 1433, 1434, 1435, 1436, 1437, 1438, 1439, 1440, 1441, 1442, 1443 och 1444 har lagts till.
- Giltigheten för följande inkomstslag har upphört 31.12.2024 och de har avlägsnats: 1130, 1131, 1134, 1125, 1126 och 1124.
- Följande inkomstslag har raderats från varje år: 1092 och 1328.
- Uppdaterad förklaring av inkomstslagen 1289 och 1085.
- 5.11.2024:
- Uppdaterade namnet och förklaringen för inkomstslag 1218.
- Uppdaterad förklaring av inkomstslagen 1026, 1043 och 1047.
|
Tillämpningsanvisning för informationsinnehållet i anmälan om förmånsuppgifter 2024 (pdf)
- Publicerades 12.12.2023
- I dokumentet beskrivs informationsinnehållet i anmälan om förmånsuppgifter och vad som anmäls i varje enskild punkt av informationsinnehållet.
|
- Uppgiften Ursprunglig betalningsperiod (OrigEarningPeriod) har preciserats i anvisningen om när återbetalningsdagen eller annan dag under samma månad kan anges som slutdatum för den ursprungliga betalningsperioden.
- Korrigerad definition i typ av ställföreträdande mottagare kommun eller annat socialvårdsorgan, så att kommunen har ändrats till ett välfärdsområde. Ett omnämnande har även lagts till att kommunen kan ha varit ställföreträdande mottagare i anmälningar vars betalningsdag eller annan anmälningsdag är 31.12.2022 eller tidigare.
- Instruktionerna för förmånsenhet, anmälning av enhetsinformation har förtydligats, när det gäller anmälning av partiell föräldrapenning.
|
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.
|
- 13.8.2024:
- En version av dokumentet med ändringar av datainnehållet för 2025 har publicerats. Förändringarna tillämpas då inkomstens betalningsdag är 1.1.2025 eller därefter.
- Förklaringar för följande inkomstslag har preciserats:
- Inkomstslagets 413 namn "Arbetspensionsförsäkringsavgift för arbetstagare" ändrades till "Arbetstagarens arbetspensionsförsäkringsavgift"
- Inkomstslagets 414 namn "Arbetstagarens arbetslöshetsförsäkringsavgift" ändrades till "Arbetstagarens arbetslöshetsförsäkringspremie"
- 8.1.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
|
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.
|
- 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.
- Följande inkomstslag har raderats från varje år: 1092 och 1328.
- Giltigheten för följande inkomstslag har upphört 31.12.2024 och de har avlägsnats: 1130, 1131, 1134, 1125, 1126 och 1124.
- Inkomstlagerna 1433, 1434, 1435, 1436, 1437, 1438, 1439, 1440, 1441, 1442, 1443 och 1444 har lagts till.
- 5.11.2024:
- Uppdaterade namnet på inkomstslag 1218.
|
Koduppsättningar 2025 (xls)
Koduppsättningar 2025 (pdf)
- Publicerades 8.1.2025
- Koduppsättningen innehåller koduppsättningar som används i inkomstregistrets tekniska gränssnitt.
|
- 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.
- Följande värde har lagts till i koduppsättningen Orsak till avlönad frånvaro (PaidAbsenceCauseCode): 23 Ersättning för semesterkostnader
- Följande värde har lagts till i koduppsättningen Typ av betalningsuppgift, ansökan om ersättning (ReimbPaymentType): 3 FPA, ersättning för semesterkostnader
- 5.11.2024:
- Från koden Typ av tilläggsuppgifter om inkomsttagaren (IncomeEarnerType) har följande värde avlägsnats: 1 Sysselsatt med statens sysselsättningsanslag
- Följande värde har lagts till koduppsättningen Kollektivavtal som tillämpas (CBACode): 224 Kollektivavtal för yrkeshögskolor
- 8.1.2025:
- Följande värde har lagts till i koduppsättningen Typ av hämtningsvillkor för materialbeställning (ParameterType):
- 28 Visning av användarnamn
- 29 Mål för åtgärden (kund)
- Följande koduppsättning har lags till:
- Visning av användarnamn (ShowUserIDs)
- Filtyper har lagts till i förkläringar av koder för koduppsätningen Materialets typ, delas ut från inkomstregistret (QueryDataType). Ordet "fil" har tagits bort från förkläringen av kod för kodvärde 630, 632 och 710.
- Till koduppsättningen 'Materialets typ, delas ut från inkomstregistret’ (QueryDataType) har materialtyperna 601 och 631 för stående beställning lagts till.
|
Koduppsättningar – Felkoder 2025 (xls)
- Publicerades 13.8.2024
- Koduppsättningen innehåller förklaringar till felkoder för det tekniska gränssnittet.
|
- 3.6.2024:
- Ett dokument för 2025 har publicerats.
- Följande felkoden har lags till: AV0380, IEV0140, BEV0530.
- Förklaringen för följande felkoder har uppdaterats: AV0230, AV0280, AV0290, AV0300, AV0310, AV0320, AV0330, AV0340, AV0360, EV0070, TRVA0390.
- 13.8.2024:
- Följande felkod har lagts till: PIV0150
|
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.1.2025
- I dokumentet beskrivs de rapporter som kan produceras ur inkomstregistret för informationsproducenterna, informationsanvändarna och inkomsttagarna.
|
- Version av dokumentet som innehåller ändringar i datainnehållet 2025 har publicerats.
- Datafilstyp tillagd i rapportens förklaringar i kapitel 1.1 Kanaler för beställning och distribution av rapporter, 4 Betalarens rapporter och 5 Informationsanvändarens rapporter. Ordet "fil" har tagits bort från namnen på rapporterna 630 Sammandrag över betalarens löneuppgifter (csv) och 632 Sammandrag över betalarens anmälningar om förmånsuppgifter (csv).
- Rapporterna 702 och 710 har kompletterats med nya hämtningsvillkor, Visning av användarnamn och Mål för åtgärden (kund).
- De nya rapportens uppgifterna har lagts till rapporten 702:
- Användarens namn
- Informationsanvändarens roll
- De nya rapportens uppgifterna har lagts till rapporten 710:
- Användarens namn
- Informationsanvändarens roll
- Mål för åtgärden (typ av kundnummer)
- Mål för åtgärden (kundnummer)
- Identifierarens landskod och landets namn
- Lags till rapporterna 702 och 710, uppgifterna i rapporterna kan beställas från 1 januari 2019.
- Tillägg av nya rapporter 601 Sammandrag över betalarens löneuppgifter (engångsbeställning, pdf) och 631 Sammandrag över betalarens löneuppgifter (stående beställning, csv).
|
Inkomstuppgifter – Beräkningsregler 2025 (pdf)
- Publicerades 13.8.2024
- I dokumentet beskrivs hur uppgifterna i inkomstregistrets rapporter beräknas.
|
- 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"
|
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.
|
- Beskrivningen av makuleringen och avslutandet av en materialbeställning i avsnitt 9.3.2 har preciserats.
|
Sändning av uppgifter – Scheman – Anmälningar av 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.
|
- 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).
|
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.
|
- 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”.
|
Sändning av uppgifter – Scheman – Anmälningar om förmånsuppgifter 2025 (pdf)
- Publicerades 3.6.2024
- I dokumentet beskrivs schemat BenefitReportsToIR, med vilket anmälningar om förmånsuppgifter lämnas in till inkomstregistret.
|
- 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".
|
Sändning av uppgifter – Scheman – Materialbeställningar 2021 (pdf)
- Publicerades 1.6.2020
- I dokumentet beskrivs schemat SubscriptionsToIR, med vilket materialbeställningar lämnas in till inkomstregistret.
|
- En version med datainnehållsändringarna för 2021 har publicerats.
- I datagruppen Underbeställningar (Subscriptions) har man lagt till för elementet Typ av material (QueryDataType) en ny möjlig koduppsättningsvärde 950 (Förkastade anmälningar som lämnats in på pappersblankett).
- Omnämningen om att det kan finnas flera hämtningsvillkor har tagits bort från hämtningsvillkoren (SubscriptionParameters). På huvudnivån för datagruppen har man berättat att antalet hämtningsvillkor beror på typ av material.
|
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.
|
- 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).
|
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.1.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.
|
- Version av dokumentet som innehåller ändringar i datainnehållet 2025 har publicerats.
- Filtyper har lagts till i beskrivningen av följande material:
- Anmälningar om löneuppgifter – alla inkomsttagare (xml)
- Anmälningar om löneuppgifter – flera inkomsttagare (xml)
- Anmälningar om löneuppgifter – flera betalare (xml)
- Anmälningar om löneuppgifter – flera betalare, flera inkomsttagare (xml)
- Anmälningar om löneuppgifter – flera arbetspensionsanstalter (xml)
- Anmälningar om löneuppgifter – arbetspensionsarrangemangnummer saknas (xml)
- Arbetsgivarens separata anmälningar – alla betalare (xml)
- Arbetsgivarens separata anmälningar – flera betalare (xml)
- Arbetsgivarens separata anmälningar – flera arbetspensionsanstalter (xml)
- Loggdata om partens användares åtkomstlogg (xml)
- Sammandrag över betalarens löneuppgifter (engångsbeställning) (xml)
- Sammandrag över betalarens löneuppgifter (stående beställning) (xml)
- Anmälningar om löneuppgifter – flera anmälningsreferenser (xml)
- Anmälningar om förmånsuppgifter – alla inkomsttagare (xml)
- Anmälningar om förmånsuppgifter – flera inkomsttagare (xml)
- Anmälningar om förmånsuppgifter – flera betalare, flera inkomsttagare (xml)
- Anmälningar om förmånsuppgifter – flera anmälningsreferenser (xml)
- Anmälningar om förmånsuppgifter – flera betalare (xml)
- Förkastade anmälningar som lämnats in på pappersblankett (xml)
- Anmälningar om löneuppgifter – en inkomsttagare (xml)
- Anmälningar om löneuppgifter – en betalare (xml)
- Anmälningar om löneuppgifter – ett arbetspensionsarrangemangnummer (xml)
- Arbetsgivarens separata anmälningar – en betalare (xml)
- Arbetsgivarens separata anmälningar – ett pensionsarrangemangnummer (xml)
- Anmälningar om löneuppgifter – en betalare, en inkomsttagare (xml)
- Anmälningar om förmånsuppgifter – en inkomsttagare (xml)
- Anmälningar om förmånsuppgifter – en betalare, en inkomsttagare (xml)
- Anmälningar om förmånsuppgifter – en anmälningsreferens (xml)
- Lade till i kapitalen 6.11 Loggdata om partens användares åtkomstlogg: Materialuppgifterna kan beställas från med 1.1.2019.
|
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.
|
-
- 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 – 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.
|
- 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 – 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.
|
- Ett dokument för 2025 har publicerats.
- Nya uppgiften har lags till datagruppen Loggaktiviteter (LogEvents):
- Användarens namn
- Informationsanvändarens roll
|
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.
|
- 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.
|
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 – tidigare innehållsbeskrivningar |
|
Anvisningar för applikationsutvecklare
Anvisningarna för applikationsutvecklare är tekniska anvisningar för den som genomför gränssnitt.