Anläggningsprojekt för ett nationellt inkomstregister TESTANVISNING FÖR E-TJÄNSTEN Bilaga 9 till testplanen för intressentgrupper

Transkript

1 1(21) INNEHÅLLSFÖRTECKNING 1 Allmänt om testningen av e-tjänsten Påbörjande av testningen Testavtal Testningen av laddningstjänsten för e-tjänsten påbörjas Testmaterial Allmänt om testkoderna Inkomstregistrets testkundsmaterial Tillägg av intressentgruppernas egna testkunder i miljön för intressentgruppstestningen för inkomstregistret Bildning av material som ska sändas Koduppsättningar Testning av laddningstjänsten Vem kan testa laddningstjänsten? Kraven på filformatet Tjänster som används i laddningstjänsten Tjänster för informationsproducenter Tjänster för informationsanvändare Laddningstjänstens funktioner Felsituationer i laddningstjänsten Informationsproducent Informationsproducentens testkoder Informationsproducentens inloggning på laddningstjänsten Suomi.fi-identifikation Ärendehantering för den egna organisationen Informationsproducentens fullmakter Suomi.fi-fullmakter Ärendehantering för kunden i laddningstjänsten (till exempel bokföringsbyrå) Specialgrupper och befullmäktigande i Katso-tjänsten Informationsanvändare Informationsanvändarens testkoder Informationsanvändarens fullmakter Testprocess Rapportering av observationer Anvisning om ifyllande av fälten i observationsblanketten Exempel på registrerade observationer Styrning av observationen till korrigering Ett fel som utgör ett hinder för testningen... 20

2 2(21) 8.5 Ändringsbegäran Leveransbeskrivning Den senaste publiceringen i miljön för intressentgruppstestningen Avslutande av testningen Närmare information VERSIONSHISTORIA Version Datum Beskrivning Dokumentet har publicerats. CENTRALA TERMER OCH FÖRKLARINGAR AV DEM Term Kundmaterial Förklaring Avidentifierat material som används i intressentgruppstestningen för inkomstregistret och som består av testkundernas uppgifter. Organisation som genomför testningen Företag eller organisation som deltar i intressentgruppstestningen för inkomstregistret. Kontaktperson för testningen Den primära kontaktpersonen hos organisationen som genomför testningen i ärenden som gäller inkomstregistertestningen. Det kan finnas endast en kontaktperson för testningen, men testningen kan genomföras av flera personer. Till kontaktpersonen för testningen skickas meddelanden och förfrågningar som hänför sig till testningen samt testmaterial och testadresser som behövs i testningen. Informationsanvändare Aktörer som har lagstadgad rätt att få inkomstuppgifter eller annan information från inkomstregistret för att sköta sina arbetsuppgifter. I det första skedet från och med är informationsanvändarna Skatteförvaltningen, FPA, Arbetslöshetsförsäkringsfonden och arbetspensionsanstalterna samt PSC. I det andra skedet från och med omfattar informationsanvändarna dessutom bland annat Statistikcentralen, Utbildningsfonden, skadeförsäkringsanstalterna, arbetslöshetskassorna, ANM:s förvaltningsområde, kommunerna och arbetarskyddsmyndigheten.

3 3(21) Informationsproducenter Alla företag och andra aktörer som är skyldiga att anmäla information om löner, pensioner eller förmåner i Finland för någon användare av inkomstregistret. Testavtal Ett avtal som en intressentgrupp ingår med Skatteförvaltningen för att testa inkomstregistrets gränssnitt och e-tjänsten i testmiljön för intressentgrupper. Informationsanvändarna ingår ett separat testavtal. Informationsproducenternas testavtal ingås genom att godkänna användarvillkoren för miljön för intressentgruppstestningen. 1 ALLMÄNT OM TESTNINGEN AV E-TJÄNSTEN Inkomstregistrets e-tjänst testas i två faser. I den första fasen publiceras inkomstregistrets laddningstjänst i intressentgruppstestningen. E-tjänstens övriga funktioner publiceras för intressentgruppernas test Fokus i denna testanvisning ligger på åtgärderna som behövs för testningen av laddningstjänsten. För testningen av e-tjänsten publiceras en separat testplan för intressentgrupper i maj Testningen kan påbörjas av dem som producerar löneuppgifter samt de organisationer för användarna av uppgifterna i inkomstregistret som börjar använda löneuppgifterna vid införandet Dessa intressentgrupper kan börja testa e-tjänstens övriga funktioner De övriga intressentgrupperna börjar testa laddningstjänsten och e-tjänsten stegvis mellan och PÅBÖRJANDE AV TESTNINGEN 2.1 Testavtal I fråga om innehållet är testavtalen sinsemellan olika beroende på huruvida intressentgruppen ingår testavtalet i egenskap av informationsproducent eller informationsanvändare. Separata avtal ska ingås om producenttest och användartest, om en intressentgrupp verkar som både producent och användare. Med informationsanvändarna kommer man separat överens om test och avtal. I testavtalet kommer man överens om användningen av både gränssnitten och e-tjänsten. Informationsproducenterna anmäler sig som testare av inkomstregistret genom att sända ett undertecknat och inskannat avtal till adressen YHT_Tulorekisteri_testaus@vero.fi. Avtalsmallen som ska fyllas i finns på webbplatsen inkomstregister.fi. Inkomstregisterprojektet sänder en kvittering per e-post när avtalet har mottagits. När avtalet har behandlats av inkomstregisterprojektet skickas uppgifterna som behövs för testningen per e-post till den kontaktperson för testningen som uppgetts i avtalet. Avtalet ska ingås två veckor före det planerade påbörjandet av testningen.

4 4(21) 2.2 Testningen av laddningstjänsten för e-tjänsten påbörjas Testaren kan logga in på laddningstjänsten när organisationen som deltar i testningen har vidtagit följande åtgärder: - Organisationen som deltar i testningen har godkänt användarvillkoren för miljön för intressentgruppstestningen av inkomstregistret. - Den kontaktperson för testningen som utsetts i testavtalet har per e- post på adressen yht_tulorekisteri_testaus@tulorekisteri.fi begärt testkoder som hen använder för att identifiera sig i miljön för testningen av e-tjänsten. - Testkoderna skickas till kontaktpersonen för testningen inom tre dagar räknat från datum för begäran från och med Det kundmaterial som används i testningen skickas till kontaktpersonen för testningen i samband med att testkoderna skickas. - Organisationen som deltar i testet har gett de nödvändiga fullmakterna. 3 TESTMATERIAL 3.1 Allmänt om testkoderna I testningen av laddningstjänsten kan löner anmälas endast på de konstgjorda FO-nummer för vilka testaren har fullmakter i Suomi.fi- eller Katso-tjänsten. För testningen av laddningstjänsten skickas två FOnummer till varje organisation som testar anmälan av löneuppgifter. Med dessa kan laddningstjänsten testas. Om en löneuppgiftsproducent deltar i gränssnittstestningen, använder producenten som ett andra FO-nummer också i testningen av laddningstjänsten samma FO-nummer som användes i certifikatet för gränssnittet. För testningen av laddningstjänsten får producenten en personbeteckning som anknyter till detta FO-nummer samt ett annat FOnummer och en annan personbeteckning. Den organisation som deltar i testningen får en eller två personbeteckningar för att testa fullmakterna. Till informationsproducenterna som endast testar laddningstjänsten skickas två konstgjorda FO-nummer och anknytande personbeteckningar. Den organisation som deltar i testningen får en eller två personbeteckningar för att testa fullmakterna. Informationsanvändarna använder i testningen av laddningstjänsten det konstgjorda FO-nummer som getts för gränssnittstestningen och den anknytande personbeteckningen. Informationsanvändaren får dessutom en eller två personbeteckningar för att testa fullmakterna. Till de informationsanvändare som endast testar laddningstjänsten skickas ett konstgjort FO-nummer, den anknytande personbeteckningen och en eller två personbeteckningar för att testa fullmakterna.

5 5(21) En beskrivning av de praktiska åtgärderna för att få koderna finns i kapitlen 5 och Inkomstregistrets testkundsmaterial Inkomstregisterprojektets testkundsmaterial består av såväl personbeteckning till vilka förnamn och efternamn har fogats som FOnummer som innehåller den juridiska personens (t.ex. Ab, Abp) namnuppgift. Testkundsmaterialet har omvandlats i oidentifierbar form så att testkundsmaterialet inte kan återskapas i sin ursprungliga form med hjälp av ett värde eller exempelvis en krypteringsnyckel. Testkundsmaterialet uppfyller således kraven i GPDR (=den EUomfattande dataskyddsförordningen, EU general data protection regulation 2016/679, som träder i kraft ), och på basis av dessa uppgifter kan man inte genom att använda tilläggsuppgifter koppla en identifierbar fysisk person till uppgifterna. Testkundernas personbeteckningar och FOnummer har avidentifierats så att de formellt sett är av rätt typ och klarar kontroller. Anvisningar om avidentifiering av testmaterialet finns i Bilaga 7. De avidentifierade FO-nummer och personbeteckningar, inklusive namnuppgifter, som används i testningen skickas per e-post (PDF-fil) till den av intressentgruppen meddelade kontaktpersonen för testningen när testavtalet har behandlats. Det krävs inte att samma namn används för att skicka anmälningar om löneuppgifter, men det rekommenderas ändå att de namn som getts av inkomstregisterprojektet används. Intressentgrupperna kan själva välja hur många löntagare varje betalare med FO-nummer har. Till varje intressentgrupp som deltar i testningen skickas 200 konstgjorda personbeteckningar när avtalet har ingåtts. Informationsproducenten använder dessa konstgjorda personbeteckningar som löntagare i testningen. Om informationsproducenten dessutom önskar använda sina egna konstgjorda personbeteckningar i testningen, ska dessa inkluderas i testmiljön för inkomstregistret. Mer information finns i avsnitt 3.3. Tillägg av intressentgruppernas egna testkunder i miljön för intressentgruppstestningen för inkomstregistret. 3.3 Tillägg av intressentgruppernas egna testkunder i miljön för intressentgruppstestningen för inkomstregistret I början av testningen skickar inkomstregisterprojektet testkunder till intressentgruppen. Efter behov kan inkomstregisterprojektet också föra in intressentgruppens egna avidentifierade testkunder, dvs. löntagare, i miljön för intressentgruppstestningen för inkomstregistret. Ett måttligt antal egna testkunder kan skickas. För detta ändamål sänder intressentgruppen kunduppgifter i CSV-format till inkomstregisterprojektet. Filerna sänds till adressen YHT_Tulorekisteri_testaus@vero.fi. De testkunder som sänts i filen står till förfogande senast den tredje vardagen efter mottagningsdagen.

6 6(21) Om en testkund som meddelats av intressentgruppen redan finns i miljön för intressentgruppstestningen för inkomstregistret (till exempel samma personbeteckning med annat namn), ändras inte den existerande testkundens uppgifter i miljön för intressentgruppstestningen för inkomstregistret. Numret finns också i fortsättningen med uppgifterna som användes för att första gången inkluderas i testmiljön. Intressentgruppen får ett meddelande om vilka av de testkunder den sänt som har inkluderats i miljön för intressentgruppstestningen för inkomstregistret och vilka beteckningar eller nummer som eventuellt redan fanns i miljön för intressentgruppstestningen. Ange vilken organisation som sänder material i namnet på filen som sänds så att det blir lättare att hantera testkundsmaterialet. Bilda namnet på filen som sänds på följande sätt: organisationens namn typ av nummer eller beteckningar testkunder. Exempel: Kela_henkilötunnukset_testiasiakkaat1.csv / Arek_y_tunn_testiasiakkaat1.csv Ge filen som sänds ett nummer så att man efter behov kan sända mer testkundsmaterial av samma typ i fortsättningen Bildning av material som ska sändas Personbeteckningarna sänds som filer för att bilda intressentgruppens eget testmaterial. Filformatet är CSV, och teckenuppsättningen UTF-8. Alla testkunders material anges på separata rader (radbyte = CRLF) i denna ordningsföljd: ASTUNNUS = testkundens FO-nummer eller personbeteckning NIMI = organisationens/företagets namn (används endast för företag med FOnummer) ETUNIMI = testkundens förnamn SUKUNIMI = testkundens efternamn TONIMI = firmans/rörelseidkarens namn LUONN_LY = fysisk persons FO-nummer (t.ex. i firma) De fält som inte fylls i markeras som tomma skiljetecken. Varje rad ska innehålla alla uppgiftsfält så att strukturen förblir intakt. Om ingen uppgift anges i ett fält, ska detta markeras som en serie med två konsekutiva citattecken som skiljs åt med ett kommatecken. Privatkunder För testkunder som har en personbeteckning uppges endast följande uppgifter: ASTUNNUS ETUNIMI SUKUNIMI TONIMI (om man känner till det, kan också lämnas tomt) LUONN_LY

7 7(21) Exempel på personbeteckning: ASTUNNUS,"NIMI","ETUNIMI","SUKUNIMI","TONIMI","LUONN_LY" B,"","Aarno Ilmari","Pokkanen","","" E,"","Helmi","Tahti","","" A818U,"","Maria","Päki","","" 3.4 Koduppsättningar En beskrivning av inkomstregistrets koduppsättningar som används i intressentgruppstestningen finns i dokumentet Koduppsättningar (PDF). En förteckning över koderna för de olika inkomstslagen finns i dokumentet Koduppsättningar Inkomstslag (PDF). Då det gäller de externa koduppsättningarna används samma koduppsättningar både i fasen med intressentgruppstestningen och i produktionen. Koduppsättningarna som används i olika situationer beskrivs i beskrivningarna av innehållet i schemana. Beskrivningar av innehållet i schemana finns på webbplatsen inkomstregister.fi:s dokumentation. 4 TESTNING AV LADDNINGSTJÄNSTEN I laddningstjänsten för inkomstregistrets e-tjänster kan informationsproducenten ladda upp XML-filer enligt inkomstregistrets gränssnittsdokument och scheman för att sparas i inkomstregistret. Inkomstregistrets informationsanvändare kan beställa material i laddningstjänsten. Inkomstregistrets laddningstjänst är en enkelriktad tjänst där intressentgruppen skickar filer till inkomstregistret. Informationsanvändare kan testa materialbeställningar i laddningstjänsten. Det beställda materialet sänds genom SFTP-gränssnittet till informationsanvändaren. Material som laddas genom laddningstjänsten behöver inte signeras med ett certifikat. 4.1 Vem kan testa laddningstjänsten? Laddningstjänsten kan testas av alla producenter av löneinformation, till exempel bokföringsbyråer, företag samt kommuner, föreningar, sammanslutningar och utländska organisationer. Utländska organisationer som inte har förts in i handelsregistret eller där personerna med firmateckningsrätt inte har en finländsk personbeteckning kan börja testa laddningstjänsten för e-tjänsten

8 8(21) Laddningstjänsten kan också testas av inkomstregistrets informationsanvändare som gör materialbeställningar genom laddningstjänsten. 4.2 Kraven på filformatet En fil som ska laddas i laddningstjänsten ska vara i XML-format. En beskrivning av de mer exakta kraven som ställs på en fil finns i inkomstregistrets schemakrav Tjänster som används i laddningstjänsten Tjänster för informationsproducenter Anmälan om löneuppgifter, ny och ersättande anmälan Makulering av anmälan om löneuppgifter Makulering av material som innehåller anmälningar om löneuppgifter Arbetsgivarens separata anmälan, ny och ersättande anmälan Makulering av arbetsgivarens separata anmälan Makulering av material som innehåller arbetsgivarens separata anmälningar Tjänster för informationsanvändare Materialbeställning, ny beställning Makulering av materialbeställning Makulering av material som innehåller materialbeställningar 4.4 Laddningstjänstens funktioner I laddningstjänsten kan följande funktioner testas: Testaren kan skicka olika slags material till miljön för intressentgruppstestningen för inkomstregistret. Från sin dator kan testaren välja en eller flera filer för sändning. Testaren kan lägga till filer och ta bort enstaka filer innan materialet skickas, eller tömma hela listan över valda filer. Testaren kan för laddningstjänsten välja flera olika typer av filer och sända dessa på en gång till laddningstjänsten. Filerna i en sändning kan vara olika företags material. Ett material kan endast innehålla en betalningsomgång och en typ av anmälningar för ett enda företag. Löneuppgiftsmaterialet innehåller anmälningar om löneuppgifter, materialet i de separata anmälningarna innehåller separata anmälningar och materialbeställningsmaterialet innehåller materialbeställningar. Gränsen för materialvolymen är den samma som för material som skickas genom gränssnittet, dvs. 50 MB. När testaren klickar på tangenten Sänd filer :

9 9(21) Materialet överförs till förteckningen Sänt material. Status för materialet ändras till Behandlas. En tidsupsskattning för när behandlingen är färdig visas. Testaren kan lämna sidan eller stänga webbläsaren utan att det påverkar behandlingen. Testaren kan sända nytt material också när materialet i den föregående sändningen ännu behandlas. När materialet har behandlats ändras status för materialet till Sparat i inkomstregistret, om inget fel har upptäckts i materialet. Om det finns fel i materialinnehållet, ändras status för materialet till antingen Avvisad eller Delvis avvisad beroende på huruvida hela eller en del av materialet avvisades. I raduppgifterna visas mottagningstidpunkten och en länk till behandlingsresponsen. Förteckningen töms på material tre månader efter att materialet mottagits. 4.5 Felsituationer i laddningstjänsten Om testaren försöker ladda en felaktig fil i laddningstjänsten, får han en felanmälan om följande situationer: Felaktigt filformat: om testaren försöker sända en fil som slutar på något annat än.xml eller om filformatet är felaktigt på något annat sätt, får testaren meddelandet Ogiltig fil i laddningstjänsten. I detta fall har tangenten Sänd filer inte aktiverats. XML-filen går inte igenom schemavalideringen: om testaren försöker sända en XML-fil vars innehåll inte svarar mot inkomstregistrets schema, får testaren meddelandet Det gick inte att läsa filen i laddningstjänsten. Som ytterligare information får testaren länken Ladda ner tekniskt felmeddelande. Felanmälan är i textformat, och i denna visas felen i schemavalideringen. I detta fall har tangenten Sänd filer inte aktiverats. Testaren har inte rätt att sända material: om testaren försöker sända material som testaren inte har rätt att sända, får testaren i laddningstjänsten ett meddelande om ett fullmaktsfel. I detta fall har tangenten Sänd filer inte aktiverats. Den sända filen innehåller fel: om testaren sänder materialet genom att klicka på tangenten Sänd filer och det finns fel i materialet, visas länken Ladda ner behandlingsrespons för testaren. Behandlingsresponsen svarar mot inkomstregistrets schema för behandlingsrespons, och i denna framläggs de av inkomstregistret returnerade felkoderna, inklusive beskrivningar. Många filer av vilka en del är felaktiga: om testaren ska sända flera filer av vilka en del är felaktiga och en del felfria, kan testaren sända de felfria filerna genom laddningstjänsten till inkomstregistret. I detta fall är tangenten Sänd filer aktiv, och endast felfria filer sänds till inkomstregistret. Felaktiga filer blir kvar i förteckningen.

10 10(21) 5 INFORMATIONSPRODUCENT 5.1 Informationsproducentens testkoder En organisation som testar e-tjänsten får på basis av testavtalet som ingåtts testkoder. Med testkoderna kan man använda tjänsterna Suomi-fiidentifikation och Suomi.fi-fullmakter i intressentgruppstestningen för inkomstregistret. Testaren testar endast e-tjänsten Till organisationens kontaktperson för testningen sänder inkomstregisterprojektet konstgjorda FO-nummer och personbeteckningar för testningen av e-tjänsten när testavtalet har behandlats. Testkoderna sänds på begäran till kontaktpersonen för testningen från och med Testaren har påbörjat intressentgruppstestningen med ett test av de tekniska gränssnitten Till organisationens kontaktperson för testningen sänder inkomstregisterprojektet på begäran konstgjorda FO-nummer och personbeteckningar för testningen av e-tjänsten. Begäran sänds till adressen yht_tulorekisteri_testaus@vero.fi. Testkoderna sänds till kontaktpersonen för testningen från och med Om en organisation önskar genomföra testningen som någon av parterna i följande förteckning, ska detta uppges separat vid begäran om testkoder eller sändning av testavtalet, om organisationen som deltar i testningen testar endast e-tjänsten. Testningen kan påbörjas o o o o o o o o o kommun församling läroanstalt förening stiftelse näringssammanslutning dödsbo offentlig myndighet utländskt företag OBS! Parter som med utländska företagsnummer deltar i testningen identifierar sig med Katso-testkoder. Katso-testkoder delas ut på begäran, och testningen börjar Informationsproducentens inloggning på laddningstjänsten Inloggningen på testmiljön och laddningstjänsten för inkomstregistrets e- tjänst sker på webbplatsen tulorekisteri.fi (Programutvecklare Intressentgruppstestning).

11 11(21) Inloggning på den svenska testmiljön för e-tjänsten sker på webbplatsen inkomstregister.fi och på den engelska testmiljön på webbplatsen incomesregister.fi. Testaren väljer Logga in till testmiljön 5.3 Suomi.fi-identifikation När testaren har valt Logga in till testmiljön väljer hen i menyn för Suomi.fi-identifikation som identifieringssätt Testidentifierare och övergår med hjälp av denna till testidentifikationen på Suomi.fi-identifikation.

12 12(21) På skärmen testidentifierare anger testaren den konstgjorda personbeteckning som inkomstregisterprojektet skickat i fältet personbeteckning, och en testare som identifierat sig loggar in på laddningstjänsten för miljon för intressentgruppstestningen för inkomstregistret. Förutsättningen är att testaren har tillräckliga fullmakter för att logga in på e-tjänsten (se avsnitt Suomi.fi-fullmakter eller avsnitt Specialgrupper och befullmäktigande i Katso-tjänsten). Testidentifikation Testidentifierare konstgjord personbeteckning 5.4 Ärendehantering för den egna organisationen Ärendehanteringen i testmiljön för laddningstjänsten för e-tjänsten i egenskap av representant med firmateckningsrätt för företaget kan skötas utan separat fullmakt. Testaren (informationsproducenten och informationsanvändaren) använder testkoden (personbeteckning) hen fått från inkomstregisterprojektet för att logga in på testmiljön för inkomstregistrets e-tjänst, och Suomi.fi-fullmakter meddelar på förstasidan för e-tjänsten fullmaktsuppgifterna för den konstgjorda organisationen som kopplats till personbeteckningen. Roller som ger rätt till att uträtta ärenden för ett företag/en organisation: Verkställande direktör Verkställande direktörens ställföreträdare Vice verkställande direktör Styrelseordförande Styrelseledamot Utredningsman Disponent Heltidsanställd disponent Näringsidkare Ansvarig bolagsman (Kb)

13 13(21) Bolagsman (Öb) Befullmäktigad Prokurist Mer information om identifiering och befullmäktigande finns på sidan Kanaler för anmälan till inkomstregistret. 5.5 Informationsproducentens fullmakter Informationsproducenten, dvs. prestationsbetalaren, kan befullmäktiga sina anställda eller någon annan organisation att för sin räkning sköta ärenden i testmiljön för inkomstregistrets e-tjänst endast med konstgjorda personbeteckningar eller FO-nummer som skickats till intressentgrupperna. Fullmakterna ges i princip i testmiljön för tjänsten Suomi.fi-fullmakter. En del av informationsproducenterna (specialgrupperna) beviljar fullmakter i Katso-testtjänsten på grund av att alla organisationsformer ännu inte har möjliggjorts i Suomi.fi-tjänsten. Dessa så kallade specialgrupper omfattar parter för vars personer med firmateckningsrätt det inte finns information i handelsregistret eller FODS. Dessa aktörer omfattar exempelvis kommuner, församlingar, läroanstalter, föreningar, stiftelser, näringssammanslutningar, dödsbon och offentliga myndigheter. Dessa parter skapar fullmakter i Katso-tjänsten, men kan använda en Suomi.fi-identifikation för identifiering. Specialförfarandet gäller dessutom utländska organisationer som inte har förts in i handelsregistret eller vars person med firmateckningsrätt inte har en finländsk personbeteckning. Utländska organisationer använder Katsotjänsten för både identifiering och fullmakter Suomi.fi-fullmakter Syftet med testkoderna som beviljats för informationsproducenter är att möjliggöra beviljande av fullmakter i testmiljön för tjänsten Suomi.fifullmakter så att den som producerar löneuppgifter kan testa laddningstjänsten och e-tjänsten. I användningen av inkomstregistret gäller fullmaktskoderna för en testare som verkar för en organisation för Anmäla löneuppgifter och Granska löneuppgifter. Fullmakt kan samtidigt ges för båda rollerna, trots att e-tjänsten börjar testas stegvis 2.5 och Anmäla löneuppgifter

14 14(21) Med denna fullmakt kan den befullmäktigade göra följande på fullmaktsgivarens vägnar i samband med löneuppgifter: upprätthålla fullmaktsgivarens basuppgifter och anmälningar om löneuppgifter skicka anmälningar om löneuppgifter som fullmaktsgivaren har skapat (i användning ) beställa rapporter som beror fullmaktsgivaren skicka meddelanden. Fullmakten Anmäla löneuppgifter innehåller också fullmakten Granska löneuppgifter. Granska löneuppgifter Med denna fullmakt kan den befullmäktigade granska följande i samband med löneuppgifter: fullmaktsgivarens basuppgifter anmälningar om löneuppgifter som fullmaktsgivaren har skapat rapporter som berör fullmaktsgivaren meddelanden som fullmaktsgivaren har skickat och tagit emot. Suomi.fi-fullmakter beviljas på adressen (Suomi.fi, fullmakter, kundtestningsmiljö). Välj typ av fullmakt: Fullmakt jag befullmäktigar en annan part att uträtta valda ärenden för mig (Oy AB har befullmäktigat arbetstagare A). Fullmaktsrätt jag ger personerna rätt att skapa fullmakter i detta företags namn i valda ärenden. Genom att välja detta kan fullmaktsrätt ges för sådana arbetstagare inom den egna organisationen som

15 15(21) kan bevilja fullmakter i den egna organisationens ärenden (Oy AB har gett fullmakt för arbetstagare A att befullmäktiga arbetstagare B). Representationsfullmakt jag ger personerna rätt att uträtta valda ärenden enligt fullmakterna som beviljats detta företag (till exempel Oy AB har befullmäktigat Bokföringsbyrå AB, och bokföringsbyrån har vidare befullmäktigat sin arbetstagare C som kan sköta Oy AB:s ärenden). Representantens fullmaktsrätt jag ger personerna rätt att i detta företags namn befullmäktiga andra personer att uträtta valda ärenden enligt fullmakterna detta företag fått. Genom att välja detta kan du ge en annan person fullmaktsrätt, och denna person kan i sin tur bevilja rättigheter att på företagets vägnar uträtta ärenden (Oy AB har befullmäktigat Bokföringsbyrå AB, och bokföringsbyrån ger arbetstagare A rätt att befullmäktiga andra personer som kan sköta Oy AB:s ärenden). Fullmaktsparter lägg till en person (konstgjord personbeteckning) eller lägg till ett företag (konstgjort FO-nummer). Giltighetstid giltigheten är alltid tidsbestämd.

16 16(21) Skapa en fullmakt: Välj ett ärende för fullmakten från förteckningen Ärendekategori: Inkomst Fullmaktskoder: Anmäla löneuppgifter och Granska löneuppgifter 5.6 Ärendehantering för kunden i laddningstjänsten (till exempel bokföringsbyrå) En part som fått fullmakt, till exempel en bokföringsbyrå, kan sköta flera kunders ärenden i laddningstjänsten. För alla de kundföretag som befullmäktigat en bokföringsbyrå kan bokföringsbyrån sända material. Med en enda identifiering kan flera olika kunders filer sändas på samma gång. En fil kan dock innehålla endast en kunds löneuppgiftsmaterial. Ärendehanteringsfullmakterna kontrolleras i samband med sändningen av uppgifter Specialgrupper och befullmäktigande i Katso-tjänsten En del av informationsproducenterna beviljar fullmakter för testningen i Katso-testtjänsten på grund av att alla organisationsformer ännu inte har möjliggjorts i Suomi.fi-tjänsterna.

17 17(21) Specialgrupperna omfattar parter för vars personer med firmateckningsrätt det inte finns information i handelsregistret eller FODS. Dessa aktörer omfattar exempelvis kommuner, församlingar, läroanstalter, föreningar, stiftelser, näringssammanslutningar, dödsbon och offentliga myndigheter. Katso-testkoder används för att identifiera sig i tjänsten. En testare som hör till en specialgrupp ska för sin egen del skapa en Katso-testkod (huvudanvändarroll) för att kunna bevilja fullmakter för andra organisations representanter, en arbetstagare hos en underorganisation eller någon annan organisation. Huvudanvändarroll samt en Katso-testkod skapas och fullmakter beviljas på adressen: (adress för Katso-testtjänsten) Utländska organisationer Specialförfarandet gäller också utländska organisationer som inte har förts in i handelsregistret eller vars person med firmateckningsrätt inte har en finländsk personbeteckning. I identifieringen använder utländska organisationer Katso-testkoder som används i Katso-testtjänsterna. Testaren skapar en huvudanvändarroll för Katso-testtjänsten i testjänsten ( och beviljar organisationens arbetstagare fullmakter för testning av laddningstjänsten för inkomstregistrets intressentgruppstestning eller befullmäktigar något annat företag att verka på sina vägnar på adressen (Katso-testtjänstens adress). Utländska organisationer kan använda en Katso-identifiering för att logga in på intressentgruppstestningen från och med INFORMATIONSANVÄNDARE 6.1 Informationsanvändarens testkoder Inkomstregistrets informationsanvändare ska begära testkoder på adressen yht_tulorekisteri_testaus@vero.fi. Testkoderna sänds till kontaktpersonen för testningen från och med Testkoderna gäller så länge testavtalet är i kraft. Om det uppstår problem med testkoderna, kontakta adressen yht_tulorekisteri_testaus@vero.fi. 6.2 Informationsanvändarens fullmakter En beskrivning av informationsanvändarens identifiering och informationsanvändarens roller finns i en separat anvisning som sänds till informationsanvändarens kontaktperson för testningen i maj 2018.

18 Inkomstregisterprojektet Intressentgrupp 18(21) 7 TESTPROCESS När åtgärderna för att påbörja intressentgruppstestningen har vidtagits kan intressentgruppen påbörja testningen. På följande bild finns en beskrivning av hur testningen förlöper när intressentgruppstestningen framskrider. Processen med intressentgruppstestning Avslutande Påbörja testningen Observationer om testningen? Ja Anmäl dessa på observationsblanketten Nej Frågor eller precisioner? Ja Sänd ett e-postmeddelande Svar per e-post Kvittering på observationer och information om vidare behandling Identifierare för fel (Id) Begäran om tilläggsuppgifter Anvisningar Nej Fortsätt testningen Avsluta testningen Skicka en anmälan om avslutandet per e-post E-post Responsförfrågan Observationsblankett YHT_Tulorekisteri_ testaus@vero.fi Intressentgruppstestning Fel som påverkar intressentgruppstestningen Leveransbeskrivning (innehållet i publikationen) YHT_Tulorekisteri_ testaus@vero.fi Processen med intressentgruppstestning 8 RAPPORTERING AV OBSERVATIONER För observationer om testningen används observationsblanketten som skickas till inkomstregisterprojektet Blanketten är enkelriktad, och meddelande om en anmäld observation sänds i fortsättningen per e-post. Kontaktpersonen för testningen får per e-post än länk till observationsblanketten när testavtalet har behandlats. 8.1 Anvisning om ifyllande av fälten i observationsblanketten Störning som hindrar användningen av systemet (ja): Om du stöter på en allvarlig störning under testningen av inkomstregistret, välj alternativet "ja". Inkomstregistrets testningsorganisation bedömer störningens svårighetsgrad. I allvarliga störningar avbryts testningen av inkomstregistret. Störningens omfattning och tidtabellen för dess reparation meddelas av inkomstregistret för de organisationer som deltar i testningen. Rubrik: En rubrik som beskriver observationen så bra som möjligt. Felklass: Fyrstegsskala för att beskriva hur kritiskt felet är. Anvisningar om hur en felklass ska användas finns i dokumentet Testplan för intressentgrupper (PDF) i avsnittet Klassificering av fel. Observatörens namn: Testarens namn Organisationens namn: Testarens organisation Observatörens e-post: E-postadress för parten som registrerat observationen: Observationstidpunkt: Datum och klockslag då situationen observerades. Kanal: Välj den kanal som användes för testningen (Realtidsgränssnittet Web Service / Det asynkroniska gränssnittet Web Service / SFTP / Laddningstjänst). Tjänster: Välj tjänst som testades.

19 19(21) Bilaga: XML för sänt meddelande. Ett meddelande eller något felmeddelande som eventuellt returneras i situationen ska också fogas till denna. Beskrivning av observationen: Vilken tjänst testades? (T.ex. Anmälan om löneuppgifter, ny/ersättande/makulering) Vilken kanal testades? (Realtids-/asynkronisk Web Service, SFTP, Laddningstjänst) Vad gjorde testaren? Vad hände i testningen? Vilket var det förväntade slutresultatet, vad borde ha hänt? 8.2 Exempel på registrerade observationer Rubrik: Ny anmälan om löneuppgifter med inkomstslag 404 Källskatt godkänner inte negativt värde Felklass: 3 Medium/Medelsvår Observatörens namn: Hemmo Testaaja Organisationens namn: Programvaruhus X Observatörens e-post: hemmo.testaaja@ohjelmistotalox.fi Observationstidpunkt: kl Kanal: Laddningstjänst Tjänster: Sändning av anmälningar om löneuppgifter (WageReportsToIR) Bilaga: 404_palkkatietoilmoitus.xml, 404_response.xml Beskrivning av observationen: Sändning av en ny anmälan om löneuppgifter testades i laddningstjänsten. Sändning av ny anmälan om löneuppgifter med inkomstslag 404 angivet belopp = -89,15. I StatusResponse-meddelandet gavs svaret "Negativt värde inte tillåtet i fältet amount". Anmälan om löneuppgifter borde ha gått igenom till inkomstregistret. Med inkomstslag 404 är ett negativt belopp tillåtet. Inom 1 2 arbetsdagar får den som gjort observationen en kvittering per e- post på att observationen mottagits. Om observationen gäller ett fel, sänds också felidentifieraren (ID) i e-postmeddelandet. Därefter sänder den som gjort observationen de eventuella kommentarerna som anknyter till observationen per e-post och anger felidentifieraren i meddelanderubriken. 8.3 Styrning av observationen till korrigering Observationen behandlas i inkomstregisterprojektet. Fel behandlas i enlighet med projektets process för hantering av fel. Alla observationer som har klassificerats som fel och mottagits av inkomstregisterprojektet behandlas i felrådet där man fastställer ordningsföljden för korrigering av fel. Inkomstregisterprojektet kontaktar den som gjort observationen, om felrådet för inkomstregisterprojektet ändrar felklassen eller om man behöver mer information om observationen. Information om fel som påverkar intressentgruppstestningen publiceras på webbplatsen inkomstregister.fi.

20 20(21) 8.4 Ett fel som utgör ett hinder för testningen Den som gör en observation väljer som felklass 1 Critical/Kritiskt, om observationen gäller ett fel som utgör ett hinder för intressentgruppstestningens framskridande. I detta fall prioriterar inkomstregisterprojektet behandlingen av denna observation. Ett kritiskt fel styrs till korrigering, om felrådet väljer att inte ändra felklassen. Kritiska fel styrs till korrigering förbi den normala felhanteringsprocessen. Den som gjort observationen får information om att felet styrts till korrigering samt den uppskattade tiden för att korrigera felet. På webbplatsen inkomstregister.fi publiceras dessutom information om felsituationen. Inkomstregisterprojektet kan dessutom sänka felklassen från nivå 1, och då behandlas felet i enlighet med den normala felhanteringsprocessen. I detta fall får parten som gjort observationen ett meddelande från inkomstregisterprojektet om att felklassen ändras. Exempel på kritiskt fel (felklass 1): Det går inte att sända anmälningar om löneuppgifter i laddningstjänsten. Motiveringar: kritiskt fel på grund av att detta hindrar sändningen av anmälningar om löneuppgifter helt och hållet genom en kanal. Förhindrar testningen helt och hållet för löneuppgiftsproducenter som använder laddningstjänsten. Exempel på något annat fel än ett kritiskt fel (felklasserna 2 4): Anmälan om löneuppgifter: En anmälan om löneuppgifter kan inte makuleras med betalarens anmälningsreferens, men med inkomstregistrets anmälningsreferens. Motiveringar: ett fel som inte är kritiskt hindrar inte testningens fortskridande. Makuleringen kan göras med inkomstregistrets anmälningsreferens, och testningen kan fortsätta. 8.5 Ändringsbegäran Om man i samband med testningen lägger märke till ett ändringsbehov, ska en blankett för ändringsbegäran fyllas i och sändas per e-post till inkomstregisterprojektet. Inkomstregisterprojektet informerar den som har lämnat en ändringsbegäran om hur behandlingen av ändringsbegäran framskrider. En blankett för ändringsbegäran kan begäras per e-post på adressen YHT.Tulorekisteri_toiminnallinen@vero.fi. Den ifyllda blanketten returneras till samma adress. 8.6 Leveransbeskrivning När en korrigering av fel har gjorts och testats i inkomstregisterprojektet ska den sändas till miljön för intressentgruppstestning i samband med den följande publiceringen. Inkomstregisterprojektet sammanställer en leveransbeskrivning innan en ny version installeras. Leveransbeskrivningen

21 21(21) innehåller en förteckning över korrigeringarna och ändringarna som finns i versionen. Leveransbeskrivningen skickas till kontaktpersonen för intressentgruppstestningen på torsdagen före publiceringen. Dessutom publiceras leveransbeskrivningarna på inkomstregister.fi. Bilaga 8 till testplanen för intressentgrupper innehåller en beskrivning av tidsplanen för publiceringen av versionerna: Publiceringsschema (PDF) 8.7 Den senaste publiceringen i miljön för intressentgruppstestningen Sådana fel i inkomstregistret som en intressentgrupp önskar att ska behandlas och åtgärdas före införandet ska anmälas till inkomstregisterprojektet senast Det sista korrigeringspaketet installeras i testmiljön Därefter korrigeras endast kritiska fel som förhindrar produktionen. Testmiljön fungerar även därefter, och observationer kan fortfarande skickas till inkomstregisterprojektet. Observationer som skickats efter behandlas, men korrigeringarna sker efter införandet vid en tidpunkt som meddelas separat. 9 AVSLUTANDE AV TESTNINGEN När en intressentgrupp har avslutat sin testning av e-tjänsten ska intressentgruppen per e-post informera inkomstregisterprojektet om detta på adressen YHT_Tulorekisteri_testaus@vero.fi. Testningen kan anses ha avslutats när intressentgruppen har konstaterat att förbindelserna mellan det egna systemet och inkomstregistret fungerar samt inte känner till några fel som kunde hindra påbörjandet av produktionsanvändningen. Efter detta meddelande får intressentgruppen fortsätta testningen i miljön för intressentgruppstestningen för inkomstregistret gällande exempelvis regressionstest, ny utveckling av systemet eller korrigering av fel av lägre prioritet. Syftet med meddelandet om avslutande av testningen är att för inkomstregisterprojektets beredskapsutvärdering ge information om att intressentgruppen anser att de förverkligade anslutningarna är klara för produktionsanvändning. 10 NÄRMARE INFORMATION Testplan för intressentgrupper (PDF) Koduppsättningar Inkomstslag (PDF) Publiceringsschema (PDF) Koduppsättningar (PDF) Inkomstregistrets dokumentation Certifikattjänst Allmän beskrivning (PDF) Certifikattjänst Beskrivning av gränssnittet (PDF) Tekniskt gränssnitt för certifikattjänsten ZIP För applikationsutvecklarna Tekniskt gränssnitt - Tillämpningsanvisning