Överföring av Suomi.fi-meddelanden till REST-gränssnittet – vad innebär övergången för de organisationer som använder tjänsten?

Under de kommande åren kommer användningen av Suomi.fi-meddelanden att övergå till det nya REST-gränssnittet. Detta innebär tekniska och administrativa åtgärder för organisationer som använder Suomi.fi-meddelanden.

I det här blogginlägget går vi igenom:

• Vad innebär REST-gränssnittet och varför görs övergången?
• Hur skiljer sig olika gränssnitt (WS, SMTP, SFTP) från varandra och hur vet du vilket gränssnitt din organisation använder?
• Tidtabell för övergången och vad organisationen ska göra till näst.

Vad är ett gränssnitt?

Ett gränssnitt är en teknisk lösning som möjliggör integrationer mellan system. Numera använder organisationerna olika gränssnitt för Suomi.fi-meddelanden, såsom WS, SMTP (e-postgränssnitt) och SFTP.

Nu ersätts dessa gamla gränssnitt med REST-gränssnittet. REST är ett modernt gränssnitt som möjliggör kommunikation mellan olika system genom ett HTTP-protokoll. Det är utformat för att vara enkelt och flexibelt.

POST-gränssnittet, dvs. POST-blanketterna eller de elektroniska blanketterna för Suomi.fi-meddelanden är tillgängliga även i fortsättningen. POST-gränssnittet behöver ett annat gränssnitt vid sin sida så att Suomi.fi-meddelandet går ända fram till organisationen. I fortsättningen ska även detta gränssnitt vara REST.

Varför görs övergången till REST-gränssnittet?

I och med REST-gränssnittet är alla Suomi.fi-meddelandens egenskaper tillgängliga via ett gränssnitt. Detta förenklar ibruktagandet av tjänsten och minskar behovet av att jämföra olika gränssnitt med organisationens behov. Dessutom gör REST-gränssnittet förmedlingen av Suomi.fi-meddelanden effektivare och gör det möjligt att reagera snabbare på eventuella felsituationer.

Vad är skillnaden mellan WS-, SMTP- och SFTP-gränssnitt?

Hur vet jag vilket gränssnitt som används i min organisation?

Om ni inte är säkra på vilket gränssnitt er organisation använder kan ni ta reda på det till exempel så här:

• Kontrollera hur meddelanden förmedlas
• Om meddelanden skickas från organisationens system använder er organisation eventuellt WS eller SFTP.
• Om meddelanden skickas per e-post används SMTP-gränssnittet.
• Om blanketter för Suomi.fi-meddelanden skickas per e-post används POST-gränssnittet i kombination med SMTP-gränssnittet.
•  
• Fråga ICT-experterna i din organisation eller den programleverantör som upprätthåller programmet.
• Man kan också be Myndigheten för digitalisering och befolkningsdata om hjälp med att utreda gränssnittet: viestit-kayttoonotot@dvv.fiÖppnas i ett nytt fönster.

Tidtabell för övergången

Myndigheten för digitalisering och befolkningsdata (MDB) har fastställt en tidtabell för att avstå från de gamla kopplingarna. Varje organisation som använder Suomi.fi-meddelanden ska övergå till att använda det nya REST-gränssnittet senast den 1 januari 2027.

Övergången sker stegvis och de gamla gränssnitten tas ur bruk enligt följande:

1.1.2025: Nya kopplingar görs inte längre till gamla gränssnitt. Alla nya ibruktagningar görs för REST-gränssnittet.
1.1.2026: Nya tjänster kan inte längre läggas till befintliga kopplingar till gamla gränssnitt. Gäller särskilt programlösningar som tillhandahålls av ICT-tjänsteleverantörer.
1.1.2027: Alla gamla gränssnitt tas ur bruk.

Reservera tillräckligt med tid för övergången. Den tekniska och administrativa övergången samt förbättrade eller helt nya ibruktagningar kan ta flera månader. Därför är det viktigt att börja planera i tid.

Vad ska organisationen göra till näst?

Gränssnittet som används avgör vilka åtgärder som ska vidtas. Er organisation kan ha flera tjänster i Suomi.fi-meddelanden som fungerar via olika gränssnitt. Er organisation ska alltså först reda ut vilka alla gränssnitt som används.

WS- och SFTP-gränssnittens tekniska övergång

Det lönar sig att börja planera integrationen genom att bekanta sig med dokumentationen på webbplatsen Suomi.fi för tjänsteutvecklare och skicka den ifyllda Servicedatablanketten till Myndigheten för digitalisering och befolkningsdata (blanketten och anvisningarna finns under punkt 3).

Övergången från WS- och SFTP-gränssnitten till REST-gränssnittet är i allmänhet enklare. Om ni använder WS-gränssnittet kan ni alltid testa och exportera en slutpunkt åt gången. Övergången från SFTP-gränssnittet sker enklast genom att använda REST-gränssnittets slutpunkt med flera kanaler/messages-slutpunkten. Meddelanden som förmedlas per post ska skickas som en utskrivbar PDF-fil, men i ett elektroniskt meddelande kan det vara bättre att skriva innehållet i meddelandet. Med REST-gränssnittet är det också möjligt att utforma elektroniskt meddelandeinnehåll med Markdown-symboler.

En betydande ändring jämfört med tidigare anslutningssätt är att uppföljningen av statusuppgifterna för de meddelanden ni skickat och mottagandet av Suomi.fi-meddelanden från slutanvändare inte längre sker via returkanalen i REST-gränssnittet. Ert system måste däremot aktivt söka information om ändringar i meddelandens status och eventuella meddelanden som skickats av slutanvändarna genom att regelbundet anropa events-slutpunkten i REST-gränssnittet. För att söka statusuppgifter ska ert system spara det senaste continuationToken-värdet för Suomi.fi-meddelanden som REST-gränssnittet /events-slutpunkten returnerat.

I samband med ändringarna är det alltid på sin plats att testa alla funktioner som ni använder mot Suomi.fi-meddelandens QA-miljö med hjälp av våra testanvisningar. När allt är klart, fyll i och returnera Checklistan för ibruktagande till Myndigheten för digitalisering och befolkningsdata (checklistan och anvisningen finns under punkt 6 på webbplatsen Suomi.fi för tjänsteutvecklare). Ange samtidigt datumet då produktionsanvändningen inleddes. Checklistan hjälper Myndigheten för digitalisering och befolkningsdata och er själva att säkerställa att allt nödvändigt har beaktats innan produktionsanvändningen inleds.

Om ni har tagit i bruk Suomi.fi-meddelanden via ett program som tillhandahålls av en annan ICT-systemleverantör, kontakta er egen systemleverantör som ansvarar för den tekniska övergången och tidsplanen och ta själva hand om eventuella administrativa åtgärder.

Om ni själva bygger upp REST-gränssnittet i ert eget system, gå vidare enligt anvisningarna och kontakta vid behov Ibruktagande av Suomi.fi-meddelanden (viestit-kayttoonotot@dvv.fiÖppnas i ett nytt fönster.).

WS- och SFTP-gränssnittens administrativa övergång

Om tjänsterna som använder Suomi.fi-meddelanden i er organisation inte ändras behöver man inte ansöka om ett nytt användningstillstånd. Om nya tjänster kommer med måste man ansöka om ett nytt användningstillstånd för dem i Suomi.fi-serviceadministrationen enligt våra anvisningar.

Exempel: En organisation använder ett system för småbarnspedagogik där Suomi.fi-meddelanden är integrerade och som använder WS-gränssnittet. Organisationen har redan sedan tidigare användningstillstånd för Suomi.fi-meddelanden för tjänster inom småbarnspedagogik. Systemleverantören gör en REST-övergång i systemet och i fortsättningen använder organisationen fortsättningsvis Suomi.fi-meddelanden som en del av systemet för småbarnspedagogik. Organisationen behöver inte ansöka om ett nytt användningstillstånd, eftersom tjänsten förblir densamma även om gränssnittet ändras i bakgrunden.

Även om det inte skulle ske några ändringar i de tjänster som ni har kopplat till Suomi.fi-meddelanden, har det kommit många nya preciseringar i bruksanvisningarna för Suomi.fi-meddelanden. Säkerställ i och med övergången att er organisations användningssätt i fortsättningen följer anvisningarna. Dessutom erbjuder REST-gränssnittet nya funktioner som ni kan använda för att göra kundprocesserna i er organisation smidigare.

Kontrollera åtminstone följande:

• Formulering av meddelandet eller notifikationen: På sidan Formulering av elektroniska meddelanden och notifikationer på webbplatsen Suomi.fi för tjänsteutvecklare hittar du anvisningar och exempel på hur ett meddelande och tillhörande notifikation ska formuleras så att era kunder förstår meddelandet de fått och kan sköta sitt ärende.
• Förhållandet mellan e-tjänster och Suomi.fi-meddelanden: Förhållandet mellan e-tjänsterna och Suomi.fi-meddelanden har preciserats. I många situationer har kunden mest nytta av ett meddelande som i sig innehåller all nödvändig information. Vid behov kan ni också i meddelandet hänvisa kunden vidare till er e-tjänst. Då ska meddelandeinnehållet ha en länk till rätt ställe i e-tjänsten och tydliga anvisningar om hur man önskar att kunden ska agera där.
• Det är informationssäkert att skicka länkar och bilagor till Suomi.fi-meddelanden, vilket det inte är i e-postprogram. Utomstående kan inte skicka nätfiskemeddelanden eller virusfiler till Suomi.fi-meddelanden eftersom avsändarna är säkrade och en skyddad förbindelse används när meddelandena skickas.
• Namngivning av tjänsten: Vid övergången lönar det sig också att noggrant bedöma den befintliga tjänstens namn, det namn som visas för kunderna. Namnet på tjänsten ska vara så tydligt som möjligt och till exempel kunna kopplas till en viss tjänst eller näringsgren. Namnet på tjänsten syns till exempel i notifikationen Nytt meddelande och i postlådan för Suomi.fi-meddelanden. Slutanvändaren ser också tjänstens namn när hen skriver ett nytt Suomi.fi-meddelande till organisationen (om organisationen har möjliggjort att slutanvändare kan skicka meddelanden till organisationen). På sidan Administrativt underhåll finns anvisningar om ändring av organisationens eller tjänstens namn.

Beakta också andra mångsidiga funktioner

REST-gränssnittet erbjuder alla funktioner som funnits i de gamla gränssnitten och dessutom har helt nya funktioner utvecklats. Suomi.fi-meddelanden är särskilt avsedda för myndighetsdelgivningar, men tjänsten gör det också möjligt att skicka andra meddelanden i anslutning till ärendestigen på ett behändigt och kostnadseffektivt sätt.

Om ni till exempel skickar en kvittering av mottagande eller uppdaterad information om ärendets behandlingsskede till era kunder kan ni begränsa sändningen av dem till endast sådana personer till vilka informationen kan skickas elektroniskt. I sådana meddelanden kan man dessutom om man så önskar koppla bort påminnelser om olästa meddelanden.

De nya funktionerna i REST-gränssnittet gör det möjligt att uppdatera användningssättet eller processerna i anslutning till användningen av Suomi.fi-meddelanden. I REST kan man till exempel skicka samma meddelande med olika innehåll beroende på om det skickas till mottagaren som elektroniskt meddelande eller som papperspost. Brevet som skickas med papperspost kan till exempel innehålla närmare anvisningar om hur kunden ska agera i pappersvärlden och i elektroniska meddelanden en direkt länk till vidare behandling av ärendet.

Sammanfattning:

• Kontrollera om er organisation använder WS- eller SFTP-gränssnittet.
• Kontakta ICT-experten eller programleverantören – finns det planer på REST-stöd i det önskade systemet och med vilken tidtabell?
• Gör upp en tidtabell för övergången i god tid.
• Gå igenom de nya funktionerna som REST-gränssnittet erbjuder och planera om er kundprocess. Se också till att kommunikationen är fungerande och utbilda er kundtjänstpersonal.
• Fundera på om er organisation har andra tjänster som också kan dra nytta av ibruktagandet av Suomi.fi-meddelanden.

Slopande av SMTP-gränssnittet och ibruktagande av REST

Om er organisation har använt SMTP-gränssnittet (=e-postanslutning) erbjuder Suomi.fi-meddelanden i fortsättningen inte längre e-postintegration. Suomi.fi-meddelanden har inte heller något användargränssnitt för tjänsten riktat till kundorganisationer. Nedan berättar vi vilka alternativ som finns i stället för SMTP-gränssnittet.

Om ni använder POST-blanketter som kommer till som e-post via SMTP-gränssnittet i er organisation ska ni kontakta den systemleverantör som erbjuder blankettjänsten. Elektroniska blanketter från kunder kan i fortsättningen till exempel styras direkt till ärendehanteringssystemet eller e-tjänsten.

Alternativ till SMTP-gränssnittet

Det är bra om er organisation går igenom vad SMTP-gränssnittet hittills har använts till och vad man i fortsättningen vill ha i dess ställe. På sidan Färdigprogram och Ibruktagande av meddelanden har man samlat ärendehanteringssystem och andra standardprogram som Myndigheten för digitalisering och befolkningsdata känner till och som erbjuder integration i Suomi.fi-meddelanden. På sidan finns också tips på hur man beaktar kraven i Suomi.fi-meddelanden i samband med konkurrensutsättningar av system.

Er organisation behöver inte nödvändigtvis ansöka om ett nytt användningstillstånd om ni tar i bruk Suomi.fi-meddelanden i REST-gränssnittet i samma tjänst.

Exempel: En organisation har använt SMTP-gränssnittet för tjänster inom småbarnspedagogiken. Nu integrerar organisationen Suomi.fi-meddelanden i systemet för småbarnspedagogik med REST-gränssnittet. Således använder organisationen fortfarande Suomi.fi-meddelanden för tjänster inom småbarnspedagogiken. Organisationen behöver inte ansöka om ett nytt användningstillstånd, eftersom användningsändamålet är samma tjänst även om gränssnittet i bakgrunden byttes ut och ett nytt system kom i dess ställe.

I anvisningarna för ibruktagande av Suomi.fi-meddelanden har man samlat heltäckande och detaljerade anvisningar för organisationerna ur både ett administrativt och tekniskt perspektiv.

Om det inte är möjligt att övergå till REST-gränssnittet

Det är förståeligt att det kan uppstå utmaningar som gör att REST-övergången inte lyckas eller att er organisation av någon annan anledning inte kan utnyttja Suomi.fi-meddelanden.

Organisationer inom den offentliga förvaltningen har sedan 2016 varit skyldiga att använda Suomi.fi-meddelanden (Lagen om förvaltningens gemensamma stödtjänster för e-tjänster 571/2016). Om Suomi.fi-meddelanden av grundad anledning inte längre kan användas ska en användningsskyldig organisation ansöka om dispens.

Om er organisation inte är skyldig att använda Suomi.fi-meddelanden och ni vill sluta använda Suomi.fi-meddelanden räcker det att ni gör en skriftlig notifikation om avslutande av användningen av Suomi.fi-meddelanden. Närmare anvisningar finns på sidan Avsluta användningen av Suomi.fi-meddelanden.

I och med projektet Prioritera digitalt övergår man i Finland huvudsakligen till digital myndighetskommunikation från början av 2026. Då skickas myndighetsbeslut och andra delgivningar elektroniskt till Suomi.fi-meddelanden för alla som uträttar ärenden hos myndigheterna. För dem som ännu inte använder Suomi.fi-meddelanden tas tjänsten automatiskt i bruk när de identifierar sig i någon myndighets e-tjänst. Denna ändring ska beaktas även i de organisationer som inte skickar sina delgivningar till sina kunder elektroniskt. Då ska den organisation som är skyldig att använda Suomi.fi-meddelanden utöver dispens också planera hur den i fortsättningen i första hand skickar elektroniska delgivningar, såsom beslut, om Suomi.fi-meddelanden inte används för detta.

Suomi.fi-meddelanden når allt fler personer digitalt

För närvarande använder ca 1,5 miljoner medborgare Suomi.fi-meddelanden. År 2026 når Suomi.fi-meddelanden en allt större del av medborgarna digitaltÖppnas i ett nytt fönster.. I fortsättningen kommer användarna av tjänsten inte att bara vara de personer med de bästa digitala färdigheterna, utan användarna har mer varierande digital kompetens. Det är bra att beakta detta när ni formulerar innehållet i de meddelanden som ni skickar och ger användarna anvisningar om uträttande av ärenden.

Det är bra att senast nu granska hur tydliga och smidiga kundstigarna i den digitala världen är, samt säkerställa att det är möjligt för alla att uträtta ärenden digitalt med myndigheterna på ett smidigt sätt.

Genom att anmäla dig till distributionslistan för projektet Prioritera digitaltÖppnas i ett nytt fönster. säkerställer du att du alltid får aktuell information om hur projektet framskrider.

Tillsammans skapar vi bättre myndighetskommunikation och en smidig ärendehantering!

Maria Juka-Lahdenperä, Tjänsteägare för Suomi.fi-meddelanden, Myndigheten för digitalisering och befolkningsdata