Programutvecklare

Inkomstregistrets gränssnitt

Med gränssnitt avses en elektronisk förbindelse som upprättas mellan olika system och inkomstregistret.

Inkomstregistret har tekniskta gränssnitt för både uppgiftslämnare och informationsanvändare. Dataformatet för inkomstregistrets tekniska gränssnitt är XML och dess scheman är engelskspråkiga.

Programvaruutvecklarna ska se till att den tjänst som upprättas överensstämmer med den tekniska dokumentationen och tidsramarna för inkomstregistret. Du ska ta hänsyn till följande:

• Vi bearbetar materialet i den ordning som det inkommer.
• Behandlingstiden beror på bland annat hur stort material som har skickats. Vi rekommenderar att du skickar material med högst 3 000 anmälningar till inkomstregistret.
• Avsändaren av materialet ska med hjälp av behandlingsresponsen försäkra sig om att anmälan lyckats. Vi rekommenderar att du reserverar minst fem minuter mellan utskicket av materialet och begäran om behandlingsrespons.
• Om behandlingsresponsen inte är färdig inom fem minuter, rekommenderar vi att du väntar i minst fem minuter till innan du skickar en ny begäran. På så sätt undviker du onödiga försök till begäran.
• Om du inte får behandlingsrespons inom två timmar, trots att du iakttog den rekommenderade tiden på fem minuter, eller fick felkoden "GEN0010 Oväntat tekniskt fel" som fel på meddelandenivå (MessageErrors), ska du kontakta oss genom att fylla i observationsblanketten.

Ta del av rekommendationerna för användning av gränssnittet i innehållsbeskrivningarna om sändning av uppgifter till inkomstregistret och datadistribution från inkomstregistret.

Gränssnitt för betalare

Du kan lämna uppgifter via det realtida eller det asynkroniska Web Service-gränssnittet och via SFTP-gränssnittet.

Via realtida WS lämnas anmälningarna till inkomstregistret en åt gången. Gränssnittet är avsett för uppladdning av ett litet antal anmälningar och för situationer där behandlingsresponsen behövs genast.

Om antalet anmälningar som ska lämnas till inkomstregistret på en gång blir stort, är det bättre att ladda upp dem via asynkroniska WS eller SFTP-gränssnittet. I dem kan du ladda upp flera anmälningar i samma batch.

Betalarna, det vill säga informationsproducenterna, ansöker om ibruktagande av det tekniska gränssnittet i e-tjänsten för Skatteförvaltningens certifikattjänst.

Gör en ansökan om gränssnitt och beställ ett certifikat i Skatteförvaltningens certifikattjänst

Gränssnitt för informationsanvändare

Endast myndigheter och andra instanser med lagstadgad behörighet har åtkomst till uppgifter som införts i inkomstregistret.

De gränssnitt som används för distribution av uppgifter från inkomstregistret är SFTP och realtids WS.

Informationsanvändarna gör ansökan om ibruktagande av det tekniska gränssnittet genom att fylla i informationsanvändarens anmälan för uppgiftstillstånd. Verkställande av uppgiftstillståndet aktiverar beställningen av det första certifikatet. En organisation kan beställa flera certifikat till gränsnittet i e-tjänsten för Skatteförvaltningens certifikattjänst då det har ett giltigt uppgiftstillstånd.