Dokumentation

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 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.

 Tillämpningsanvisningar för datainnehållet i löner och förmåner
Löner – senaste tillämpningsanvisningar Senaste ändringar

Tillämpningsanvisning för informationsinnehållet i anmälan om löneuppgifter 2026 (pdf)

  • Publicerades 6.11.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 2027 (pdf)

  • Publicerades 6.11.2025

Dokumentet för år 2026:

  • 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.
Förmåner – senaste tillämpningsanvisning 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)

  • Publicerades 27.10.2025

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).
Tidigare tillämpningsanvisningar

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 (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 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.
  • Förklaringen till inkomstlag 366 (Ersättning för upphovsrätt som förvärvsinkomst) har preciserats.

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 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.
  • 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 2026 (xls)

  • Publicerades 8.10.2025
  • Koduppsättningen innehåller koduppsättningar som används i inkomstregistrets tekniska gränssnitt.

Koduppsättningar 2027 (xls)

  • Publicerades 27.10.2025

Dokumentet för år 2026:

  • Följande värde har lagts till i koduppsättningen Materialets schemaversion (QueryDataSchemaVersion): Schemat för distributionen av alla betalare.
  • 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)
  • Värden 225. 226, 227 och 228 har lagts till i koduppsättningen Kollektivavtal som tillämpas (CBACode).
  • Värden 4 och 187 har tagits bort från koduppsättningen Kollektivavtal som tillämpas (CBACode).
  • 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 från Materialets ägares materialreferens till Hämtning av arbetsgivares separata anmälningar.

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.
  • 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 2026 (xls)

  • Publicerades 6.11.2025
  • Koduppsättningen innehåller förklaringar till felkoder för det tekniska gränssnittet.

Koduppsättningar – Felkoder 2027 (xls)

  • Publicerades 6.11.2025

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:

  • 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.
 
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 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)

  • Publicerades 27.10.2025

Dokumentet för år 2026:

  • 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.
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.

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

Sändning av uppgifter – Scheman – Anmälningar om löneuppgifter 2026 (pdf)

  • Publicerade 6.11.2025
  • 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)

  • Publicerade 6.11.2025

Dokumentet för år 2026:

  • 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.

Sandning av uppgifter – Scheman – Arbetsgivarens separata änmalningar 2026 (pdf)

  • Publicerades 4.7.2025
  • I dokumentet beskrivs schemat PayerSummaryReportsToIR, med vilket arbetsgivarens separata anmälningar lämnas in till inkomstregistret.

 

  • Tillagd teckenuppsättning för white space (1.2)

Sändning av uppgifter – Scheman – Anmälningar om förmånsuppgifter 2026 (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 2027 (pdf)

  • Publicerades 27.10.2025

Dokumentet för år 2026:

  • 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 2026 (pdf)

  • Publicerades 4.7.2025
  • I dokumentet beskrivs schemat InvalidationsToIR, med vilket anmälningar om inkomstuppgifter, materialbeställningar och material annulleras i inkomstregistret.
  • 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 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)

  • Publicerades 27.10.2025

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)

  • Publicerades 27.10.2027

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)

  • Publicerades 27.10.2025

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 2026 (pdf)

  • Publicerades 27.5.2025
  • I dokumentet beskrivs schemat WageReportSummaryFromIR, med vilket materialet Sammandrag över betalarens löneuppgifter (312/313) distribueras ur inkomstregistret.
  • Materialet är avsett för prestationsbetalare.
  • 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 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
    • 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)

  • Publicerades 27.10.2025

Dokumentet för år 2026:

  • 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)

  • Publicerades 27.10.2025

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
Sidan har senast uppdaterats 2.1.2026