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.
På denna webbsida
Behöver du exempel eller närmare anvisningar för anmälan? Se våra detaljerade anvisningar
Förklaringar på inkomstslag och koduppsättningar
I koduppsättningarna för inkomstslag beskrivs inkomstslag för löner och förmåner och deras användningsändamål. Dessutom förtecknas koduppsättningen 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 2026 (xlsx)
- Publicerades 25.3.2026
- I koduppsättningen beskrivs
- inkomstslagen i anmälan om löneuppgifter som används i inkomstregistret
- koder för inkomstslag och poster 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 och förklaringar för inkomstslag i arbetsgivarens separata anmälan.
Löner – Koduppsättningar – Inkomstslag 2027 (xlsx)
|
Dokumentet för år 2026:
- Uppdaterad läsanvisningar.
Dokumentet för år 2027:
- En version av dokumentet med ändringar av datainnehållet för 2027 har publicerats. Förändringarna tillämpas då inkomstens betalningsdag är 1.1.2027 eller därefter.
- Tagit bort följande inkomstslag:
- 410 Kollektiv tilläggspensionsförsäkringsavgift som betalats av arbetsgivaren
- 411 Andel av kollektiv tilläggspensionsförsäkringsavgift som betalats av arbetsgivaren och som debiteras arbetstagaren
- 418 Försäkringsavgift för en individuell, frivillig pensionsförsäkring.
- Följande inkomstslag har lagts till:
- 344 Arvode för familjehemsvårdare
- 345 Arvode som betalats till stödfamilj
- 346 Arvode för avlösare för närståendevårdare
- Den gamla beskrivningen har tagits bort, och en ny beskrivning har lagts till för inkomstslag 319 och 328.
|
|
Förmåner – Koduppsättningar – Inkomstslag 2026 (xlsx)
- Publicerades 25.3.2026
- I koduppsättningen beskrivs
- förmåner och pensioner som ska anmälas till inkomstregistret
- koder för inkomstslag 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.
Förmåner – Koduppsättningar – Inkomstslag 2027 (xlsx)
|
Dokumentet för år 2026:
- Följande inkomstslag har lagts till: 1447 Allmänt stöd på grund av arbetslöshet (landskapet Åland)"
- Uppdaterad läsanvisningar och förklaring av inkomstslagen 1018, 1019 och 1021.
Dokumentet för år 2027:
- Följande inkomstslag har tagits bort:
- 1109 Partiell ålderspension (frivillig arbetspensionsförsäkring)
- 1112 Deltidspension (gruppensionsförsäkring)
- 1113 Arbetslöshetspension (pensionskassor och -stiftelser)
- 1319 Extra familjepension (tidigare tjänste- eller befattningsinnehavare vid Försvarsmakten)
- 1342 Deltidspension (frivillig arbetspensionsförsäkring)
- 1417 Arbetslivspension (frivillig arbetspensionsförsäkring)
- 1418 Arbetslivspension (direkt tilläggspensionsarrangemang)
- 1419 Partiell förtida ålderspension (frivillig arbetspensionsförsäkring)
- 1421 Avkastning av en frivillig pensionsförsäkring som betalas som engångsbelopp
- Beskrivningarna för inkomstslagen 1062, 1271, 1336 och 1378 har uppdaterats så att det framgår att dessa inkomstslag även kan vara skattefria.
- Kontrollera alla ändringar för år 2027 i dokumentets versionshistoria.
|
|
Koduppsättningar 2026 (xlsx)
- Publicerades 25.2.2026
- Koduppsättningen innehåller koduppsättningar som används i inkomstregistrets tekniska gränssnitt.
Koduppsättningar 2027 (xlsx)
|
Dokumentet för år 2026:
- Följande värde har lagts till i koduppsättningen Kollektivavtal som tillämpas (CBACode). Gäller från och med den 1 april 2026:
- 237 Kollektivavtal för tjänsteinnehavare mellan Medieförbundet och Fackförbundet Pro samt Viestintäalan toimihenkilöt Grafinet ry
- Följande kodvärden i koderna 'Kollektivavtal som tillämpas’ (CBACode) är inte giltiga efter den 31 mars 2026:
- 175 Kollektivavtal för tjänstemän mellan Medieförbundet rf och Fackförbundet Pro
- 179 Kollektivavtal för tjänstemän mellan Medieförbundet och Industrifacket samt Viestintäalan toimihenkilöt Grafinet ry
- Förklaringen till kod 73 (CBACode) har korrigerats.
Dokumentet för år 2027:
- Följande värde har lagts till i koduppsättningen Materialets typ, delas ut från inkomstregistret (QueryDataType):
- 325 - Anmälningar om löneuppgifter som saknas – flera betalare (xml)
- 326 - Anmälningar om löneuppgifter som saknas – flera betalare, flera inkomsttagare (xml)
- 327 - Anmälningar om förmånsuppgifter som saknas – flera betalare (xml)
- 328 - Anmälningar om förmånsuppgifter som saknas – flera betalare, flera inkomsttagare (xml)
- 412 - Anmälningar om löneuppgifter som saknas – en betalare (WS i realtid, xml)
- 413 - Anmälningar om löneuppgifter som saknas – en betalare, en inkomsttagare (WS i realtid, xml)
- 414 - Anmälningar om förmånsuppgifter som saknas – en betalare, en inkomsttagare (WS i realtid, xml)
- Kontrollera alla ändringar för år 2027 i dokumentets versionshistoria.
|
|
Koduppsättningar – Felkoder 2026 (xlsx)
- Publicerades 6.11.2025
- Koduppsättningen innehåller förklaringar till felkoder för det tekniska gränssnittet.
Koduppsättningar – Felkoder 2027 (xlsx)
|
Dokumentet för år 2026:
- Felkoden AV0430 har avlägsnats.
- Felkoden TRVA0440 har lagts till. Felkodens förklaring av TRVA0420 har ändrats.
Dokumentet för år 2027:
- Följande felkoder har lagts till: AV0430, AV0440, TIVA0060, BEV0550, REDV0130, BEV0570, BEV0560, INTDV0060, IEOV0060, IEV0150, IEV0160, IEV0170, EG0010–EG0120, REDV0140, REDV0150, AV0450, AV0460 and DDVS0310.
- Kontrollera alla ändringar för år 2027 i dokumentets versionshistoria.
|
|
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.
|
|
| Tidigare koduppsättningar |
|
|
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 tillämpningsanvisningen beskrivs punkt för punkt vilka uppgifter som uppges med anmälan om löneuppgifter, arbetsgivarens separata anmälan och anmälan om förmånsuppgifter.
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.
Tillämpningsanvisningar och innehållsbeskrivningar för sändning av uppgifter
| Löner – senaste tillämpningsanvisningar |
Senaste ändringar |
|
Tillämpningsanvisning för informationsinnehållet i anmälan om löneuppgifter 2026 (pdf)
- Publicerades 18.2.2026
- 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 2027 (pdf)
|
Dokumentet för år 2026:
- Beskrivningen för betalartypen ‘Utländskt koncernbolag’ i datagruppen Övriga uppgifter om betalaren (PayerOther) har korrigerats.
Dokumentet för år 2027:
- Till datagruppen Inkomsttagarens verksamhetsställe (PlaceOfBusiness) har ett nytt datafält lagts till: Statistikcentralens arbetsställeskod (StatisticsFinlandId).
- En ny behandlingsregel har lagts till i datagruppen Uppgifter om anställningsförhållandet (Employment): Slutdatum (EndDate) är obligatoriskt om anställningens avslutsorsak är pensionering.
- Nya behandlingsregler har lagts till i datagruppen ”Paid absence (PaidAbsence)”: Startdatum måste vara den första dagen i månaden och slutdatum måste vara den sista dagen i månaden om betalningstypen är ”FPA, ersättning för semesterkostnader”.
- En behandlingsregel har lagts till för uppgiften Förskottsinnehållning på det återkrävda beloppet i datagruppen Tilläggsuppgifter om återkrav (RecoveryData):
Beloppet måste vara 0 om datumet för återkravet infaller senare än 30.4 det år som följer på året för den ursprungliga betalningsdagen.
- Tillagd behandlingsregel för uppgiften ”Begränsat skattskyldig” i datagruppen Internationella situationer (InternationalData): Typ av tilläggsuppgift om inkomsttagaren får inte vara 4 om inkomsttagaren är begränsat skattskyldig
- En behandlingsregel har lagts till för uppgiften Ursprunglig löneutbetalningsperiod i datagruppen Tilläggsuppgifter om återkrav (RecoveryData):Start- och slutdatum ska infalla under samma kalenderår om ingen betalningsdag har angetts.
- En behandlingsregel har lagts till för uppgiften Landskod för stat där personen är bosatt i datagruppen Internationella situationer (InternationalData): en begränsat skattskyldigs landskod får inte vara Finland."
- En behandlingsregel har lagts till för uppgiften Ursprunglig löneutbetalningsperiod i datagruppen Tilläggsuppgifter om återkrav (RecoveryData): Det kan finnas endast en ursprunglig löneutbetalningsperiod.
- Nya behandlingsregler har lagts till i datagruppen Paid absence (PaidAbsence): För en deltidsanställd timarbetare måste antalet betalda frånvarodagar vara minst hälften av frånvaroperiodens längd, men högst lika många som det totala antalet dagar i frånvaroperioden.
- Nya behandlingsregler har lagts till i datagruppen Försäkringsuppgifter (InsuranceData): Försäkringsuppgiftens typ måste vara 1 eller 5 om i anmälan har angetts inkomstslag 210, 214, 215 eller 308, uppgiften I anställningsförhållande är ”true” och i anmälan inte har angetts något av värdena 1, 5, 6 eller 9 som Typ av undantagssituation för försäkring.
- Tillagd behandlingsregel för uppgiften ”Begränsat skattskyldig” i datagruppen Internationella situationer (InternationalData): Om man i anmälan angett inkomstslaget 404 och Typ av tilläggsuppgift om inkomsttagaren inte är Nyckelperson, måste uppgiften Begränsat skattskyldig vara ”true”.
En valideringsregel har lagts till för fältet E-postadress i datagruppen (Kontaktpersoner).
- Kontrollera alla ändringar för år 2027 i dokumentets versionshistoria.
|
|
Sändning av uppgifter – Scheman – Anmälningar om löneuppgifter 2026 (pdf)
- Publicerade 6.2.2026
- 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 2027 (pdf)
|
Dokumentet för år 2026:
- En behandlingsregel av Underskrift (Signature) har uppdaterats:
Elementet är inte tillåtet för material som lämnas in via laddningstjänsten.
Dokumentet för år 2027:
- En behandlingsregel av Underskrift (Signature) har uppdaterats: Elementet är inte tillåtet för material som lämnas in via laddningstjänsten.
- Kontrollera alla ändringar för år 2027 i dokumentets versionshistoria.
|
| Arbetsgivarens separata anmälningar – senaste anvisningar |
Senaste ändringar |
|
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.
Tillämpningsanvisning för arbetsgivarens separata anmälan 2027 (pdf)
|
Dokumentet för år 2026:
- Inlägd av Inledning och Läsanvisning.
Dokumentet för år 2027:
- En ny instruktion har lagts till för uppgifter om inkomstslag (Transactions). En ny datagrupp har lagts till för arbetstagargrupper (EmployeeGroups).
|
|
Sändning av uppgifter – Scheman – Arbetsgivarens separata anmälningar 2026 (pdf)
- Publicerades 6.2.2026
- I dokumentet beskrivs schemat PayerSummaryReportsToIR, med vilket arbetsgivarens separata anmälningar lämnas in till inkomstregistret.
Sändning av uppgifter – Scheman – Arbetsgivarens separata anmälningar 2027 (pdf)
|
Dokumentet för år 2026:
- En behandlingsregel av Underskrift (Signature) har uppdaterats:
- Elementet är inte tillåtet för material som lämnas in via laddningstjänsten.
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 datagrupp, Arbetstagargrupper, har lagts till.
Behandlingsregeln för Transactions datagruppen har ändrats. Instruktioner för Rapporteringsperiod (PaymentMonth) förtydligas.
- En valideringsregel har lagts till för fältet E-postadress i datagruppen (Kontaktpersoner).
|
| Förmåner – senaste anvisning |
Senaste ändringar |
|
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).
|
|
Sändning av uppgifter – Scheman – Anmälningar om förmånsuppgifter 2026 (pdf)
- Publicerades 6.2.2026
- 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 2027 (pdf)
|
Dokumentet för år 2026:
- En behandlingsregel av Underskrift (Signature) har uppdaterats:
- Elementet är inte tillåtet för material som lämnas in via laddningstjänsten.
Dokumentet för år 2027:
- En behandlingsregel har lagts till för uppgiften Landskod för stat där personen är bosatt i datagruppen Internationella situationer (InternationalData): en begränsat skattskyldigs landskod får inte vara Finland.
- En behandlingsregel har lagts till för uppgiften Förskottsinnehållning på återbetalning beloppet i datagruppen Tilläggsuppgifter om återbetalning (RecoveryData): Beloppet måste vara 0 om datumet för återbetalningen infaller senare än 30.4 det år som följer på året för den ursprungliga prestationens betalningsdag.
- En behandlingsregel har lagts till för uppgiften Begränsat skattskyldig i datagruppen Internationella situationer (InternationalData): Inkomsttagaren ska vara begränsat skattskyldig om inkomstslaget 1267 har anmälts i anmälningen.
- En valideringsregel har lagts till för fältet E-postadress i datagruppen (Kontaktpersoner).
- Kontrollera alla ändringar för år 2027 i dokumentets versionshistoria.
|
| Sändning av uppgifter – senaste innehållsbeskrivningar |
Senaste ändringar |
|
Sändning av uppgifter – Scheman – Materialbeställningar 2026 (pdf)
- Publicerades 6.2.2026
- I dokumentet beskrivs schemat SubscriptionsToIR, med vilket materialbeställningar lämnas in till inkomstregistret.
|
- En version med datainnehållsändringarna för 2026 har publicerats.
|
|
Sändning av uppgifter – Scheman – Makuleringsuppgifter 2026 (pdf)
- Publicerades 6.2.2026
- I dokumentet beskrivs schemat InvalidationsToIR, med vilket anmälningar om inkomstuppgifter, materialbeställningar och material annulleras i inkomstregistret.
|
- En behandlingsregel av Underskrift (Signature) har uppdaterats:
- Elementet är inte tillåtet för material som lämnas in via laddningstjänsten.
|
|
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 tillämpningsanvisningar och innehållsbeskrivningar |
|
|
Rapporter och betalarens material
Man kan beställa olika rapporter ur inkomstregistret. I rapporternas innehållsbeskrivningar beskrivs rapporter som kan beställas och deras beräkningsregler.
Innehållsbeskrivningar för rapporter och betalarens material
| Rapporter – senaste innehållsbeskrivningar |
Senaste ändringar |
|
Rapporter och material från inkomstregistret 2026 (pdf)
- Publicerades 28.1.2026
- 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 2026:
- Avsnitt 3.1 och 8.2: Beräkningsreglerna för materialet 500 Inkomstregisterutdrag för inkomsttagare (pdf) har ändrats. Prestationer som anmälts för inkomstslagen 321–325 inkluderas inte på inkomsttagarens inkomstregisterutdrag. Prestationer som uppgetts för inkomstslagen 322–324 räknas med i de summorna för inkomstslaget 363 som har anmälts med samma anmälning.
Dokumentet för år 2027:
- Följande nya avsnitt har lagts till:
- 6.23 Anmälningar om löneuppgifter som saknas – flera betalare (xml)
- 6.24 Anmälningar om löneuppgifter som saknas – flera betalare, flera inkomsttagare (xml)
- 6.25 Anmälningar om förmånsuppgifter som saknas – flera betalare (xml)
- 6.26 Anmälningar om förmånsuppgifter som saknas – flera betalare, flera inkomsttagare (xml)
- 7.12 Anmälningar om löneuppgifter som saknas – en betalare (WS i realtid, xml)
- 7.13 Anmälningar om löneuppgifter som saknas – en betalare, en inkomsttagare (WS i realtid, xml)
- 7.14 Anmälningar om förmånsuppgifter som saknas – en betalare, en inkomsttagare (WS i realtid, xml)
- Nya materialtyper 325, 326, 327, 328, 412, 413, 414 har lagts till i avsnitt 1.3 Material som distribueras från inkomstregistret.
- För rapporterna 700 och 701:
- I avsnittet rapportens uppgifter har en notering lagts till om att Uppgifter inte räknas för materialtyperna 325, 326, 327, 328, 412, 413 och 414.
- För materialtyperna 321, 322, 323, 324, 410 och 411 har uppgiften åtkomstprofil (QueryProfile) lagts till i uppgifterna för delbeställningen (Subscription). Dessutom har logiken för startögonblicket för det hämtningsintervall som används vid hämtning av dessa materialtyper preciserats så att antingen skapandetid eller angivet tidsintervall beaktas vid hämtningen.
- Ändringen gäller följande avsnitt:
- Avsnitt: 6.19 Anmälningar om löneuppgifter som saknas – alla inkomsttagare (xml)
- Avsnitt: 6.20 Anmälningar om löneuppgifter som saknas – flera inkomsttagare (xml)
- Avsnitt: 6.21 Anmälningar om förmånsuppgifter som saknas – alla inkomsttagare (xml)
- Avsnitt: 6.22 Anmälningar om förmånsuppgifter som saknas – flera inkomsttagare (xml)
- Avsnitt: 7.10 Anmälningar om löneuppgifter som saknas – en inkomsttagare (xml)
- Avsnitt: 7.11 Anmälningar om förmånsuppgifter som saknas – en inkomsttagare (xml)
- Kontrollera alla ändringar för år 2027 i dokumentets versionshistoria.
|
|
Datadistribution – Scheman – Sammandrag över betalarens löneuppgifter 2026 (pdf)
- Publicerades 8.1.2026
- I dokumentet beskrivs schemat WageReportSummaryFromIR, med vilket materialet Sammandrag över betalarens löneuppgifter (312/313) distribueras ur inkomstregistret.
- Materialet är avsett för prestationsbetalare.
|
- ”Summauppgifter för arbetsgivarens separata anmälningar per rapporteringsperiod” har uppdaterats i schemats översta tabell och i schemats bild.
- Behandlingsregeln för Antalet objekt som hämtats (NrOfReports) har ändrats så att den även inkluderar antalet arbetsgivarens separata anmälningar.
|
| Rapporter – 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 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 |
|
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:
- Till datagruppen Inkomsttagarens verksamhetsställe (PlaceOfBusiness) har nya datafält lagts till: Statistikcentralens arbetsställeskod (StatisticsFinlandId) och Statistikcentralens arbetsställeskod bestrids
(StatisticsFinlandIdDenied)
- Kontrollera alla ändringar för år 2027 i dokumentets versionshistoria.
|
|
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.
Datadistribution – Scheman – Arbetsgivarens separata anmälningar 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 datagrupp, Arbetstagargrupper, har lagts till.
|
|
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.
|
|
|
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 – 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 29.5.2026
- I dokumentet beskrivs schemat MissingWageReportsFromIR, med vilket skickas information om anmälningar av löneuppgifter som saknas från inkomstregistret.
|
- Ett nytt dataelement, Åtkomstprofil (QueryProfile), har lagts till i avsnitt 2.1 Uppgifter om materialbeställningen (Subscription).
- Datagruppen Uppgifter om betalaren (Payer) har ändrats från obligatorisk till frivillig.
- Uppgifterna Typ av identifierare (Type) och Identifierare (Code) som ingår i datagruppen Betalarens identifierare (PayerId) har ändrats från obligatoriska till frivilliga.
|
|
Datadistribution – Scheman – Anmälningar om förmånsuppgifter som saknas – 2027 (pdf)
- Publicerades 29.5.2026
- I dokumentet beskrivs schemat MissingBenefitReportsFromIR, med vilket skickas information om anmälningar av förmånsuppgifter som saknas från inkomstregistret.
|
- Ett nytt dataelement, Åtkomstprofil (QueryProfile), har lagts till i avsnitt 2.1 Uppgifter om materialbeställningen (Subscription).
- Datagruppen Uppgifter om betalaren (Payer) har ändrats från obligatorisk till frivillig.
- Uppgifterna Typ av identifierare (Type) och Identifierare (Code) som ingår i datagruppen Betalarens identifierare (PayerId) har ändrats från obligatoriska till frivilliga.
|
| 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 för sändning och distribution av uppgifter 2026 (pdf)
- Publicerades 27.2.2026
- I dokumentet beskrivs
- principerna för genomförandet av inkomstregistrets tekniska gränssnitt med tanke på den som genomför systemintegrationen
- 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
- 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
- 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 2026:
- Följande kombinationer av kryptoalgoritmer (cipher suite) har tagits bort från TLS‑krypteringsinställningarna:
- TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
- TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
- TLS_DHE_DSS_WITH_AES_256_CBC_SHA256
- TLS_DHE_DSS_WITH_AES_128_CBC_SHA256
Dokumentet för år 2027:
- Uppdaterad i kapitel 10.2.4 Begränsning av behandlingen av personuppgifter och i dess underavsnitt 10.2.4.1 Bestridande av anmäld uppgift, 10.2.4.2 Bestridande av saknad uppgift i anmälan samt 10.2.4.3 Uteblivna anmälningar och de regler för distribution av bestridsmarkeringar som beskrivs.
- Terminologin i kapitlen 10.2.4 och 13.2 har uppdaterats i fråga om bestridsmarkeringar.
- Beskrivningen av uppgifterna startögonblick och slutögonblick för hämtningsintervallet för ändringar (ModifiedTimespanStart, ModifiedTimespanEnd) i avsnitt 13.2.2 Allmänna uppgifter om huvudbeställningen har uppdaterats med avseende på bestridsmarkeringar. Ett exempel på distribution av bestridsmarkeringar har lagts till.
- Beskrivningen av uppgiften Hämtning av alla versioner (IncludeAllVersions) i avsnitt 13.2.4 Allmänna uppgifter om underbeställningen har uppdaterats. Beskrivningen beaktar nu även distributionen av bestridsmarkeringar.
- Kontrollera alla ändringar för år 2027 i dokumentets versionshistoria.
|
|
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:
- Uppdaterad med ändringar i schemat DataRequestToIR.xsd som hör till datainnehållsändringarna för 2027.
- Kontrollera alla ändringar för år 2027 i dokumentets versionshistoria.
|
|
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 |
|
|