Vuodenvaihde lähestyy: onko organisaationne valmis Suomi.fi-viestien REST-siirtymään?

Suomi.fi-viesteihin lähetettävät viestit  kulkevat 1.1.2027 alkaen REST-rajapinnan kautta. Jos organisaationne hyödyntää Suomi.fi-viestejä, nyt on korkea aika varmistaa, että siirtymään liittyvät toimenpiteet on suunniteltu ja aikataulutettu. Näin varmistatte, että lähettämänne tärkeät viestit kulkevat asiakkaille myös jatkossa Suomi.fi-viesteihin.

Mitä muutos tarkoittaa organisaatioille?

Jos REST-rajapinta ei ole organisaatiollanne jo käytössä tai sitä ei aiota ottaa käyttöön, organisaationne ei voi käyttää Suomi.fi-viestejä enää vuoden 2027 alusta lähtien.

Tämän vuoksi organisaationne kannattaa varmistaa hyvissä ajoin, että REST-siirtymä on suunniteltu ja aikataulutettu. Muuten sähköisen viranomaisviestinnän järjestämiseen täytyy miettiä toinen ratkaisu. On myös hyvä muistaa, että viranomaisilla ja julkista hallintotehtävää hoitavilla organisaatioilla on lakisääteinen velvollisuus käyttää Suomi.fi-viestejä tiedoksiannoissa. Jos palvelua ei käytetä, organisaation tulee hakea poikkeuslupa.

REST-siirtymää ei kannata jättää viime tinkaan, sillä käyttöönotto, testaus ja mahdolliset korjaukset vievät aikaa. Siirtymän suunnittelussa kannattaa hyödyntää Suomi.fi kehittäjille -sivuston REST-siirtymäohjetta.

Vaikka siirtymä onkin pakollinen tekninen muutos, se tarjoaa samalla hyvän mahdollisuuden tarkastella organisaation sähköistä viestintää kokonaisuutena ja laajentaa Suomi.fi-viestien käyttöä uusiin palveluihin.

Viisi asiaa, jotka kannattaa tehdä viimeistään nyt:

1. Tehkää REST-siirtymälle suunnitelma ja aikataulu.
2. Käykää siirtymään liittyvät vastuut läpi järjestelmätoimittajanne kanssa.
3. Varatkaa aikaa käyttöönotolle, testaukselle ja tuotantoon siirtymiselle.
4. Arvioikaa mahdollisuudet laajentaa Suomi.fi-viestien käyttöä. REST-siirtymä tarjoaa hyvän mahdollisuuden tarkastella, voisiko Suomi.fi-viestejä hyödyntää nykyistä laajemmin organisaation palveluissa ja prosesseissa.
5. Muistakaa viestiä muutoksista. Jos käyttöä laajennetaan tai toimintatapoihin tulee muutoksia, viestikää niistä henkilöstölle, asiakaspalvelulle, palveluiden omistajille ja tarvittaessa myös asiakkaille.

Suunnittelu kannattaa aloittaa tutustumalla Suomi.fi-viestien hallinnollinen käyttöönotto -ohjeeseen.

Päättäkää ainakin seuraavat asiat:

• Kuka vastaa siirtymästä?
• Milloin REST-siirtymä toteutetaan?
• Voisiko samalla laajentaa Suomi.fi-viestien käyttöä uusiin palveluihin?

Mitä REST-siirtymä edellyttää?

Mitä aikaisemmin REST-siirtymän valmistelu aloitetaan, sitä hallitummin siirtymä voidaan toteuttaa.

Sujuvan siirtymän varmistamiseksi organisaationne kannattaa käydä järjestelmätoimittajan kanssa kokonaisuus hyvissä ajoin läpi. Järjestelmätoimittaja hoitaa WS- ja SFTP-rajapinnoista REST-rajapintaan siirtymiseen liittyvät järjestelmämuutokset.

SMTP-rajapintaa eli sähköpostiliityntää ei voi siirtää eikä muuntaa REST-rajapinnaksi. Voitte lukea lisää SMTP-rajapintaan liittyvistä muutoksista Suomi.fi kehittäjille -sivustolta.

REST-siirtymä edellyttää toimenpiteitä myös organisaatiolta itseltään. Organisaation täytyy

• toimittaa käyttöönottoon liittyvät tiedot palvelulomakkeella Digi- ja väestötietovirastolle (mikä järjestelmä ja mitkä palvelut siirtyvät REST-rajapintaan)
• osallistua testaukseen sekä
• varmistaa ennen tuotantoon siirtymistä, että palvelu toimii omissa prosesseissa suunnitellusti.

Teknisen liitynnän varmistamisen lisäksi kannattaa tarkistaa myös se, että viestit, liitteet, palvelunimet ja muut keskeiset toiminnallisuudet toimivat toivotulla tavalla.

Tarvittaessa tukea saa Digi- ja väestötietoviraston Suomi.fi-viestien käyttöönottotiimiltä (viestit-kayttoonotot@dvv.fi).

Suomi.fi-viestien REST-siirtymän aikataulusta on viestitty vuodesta 2024 lähtien. Uusia liityntöjä vanhoihin rajapintoihin ei ole tehty enää vuoden 2025 alun jälkeen, eikä vanhoihin liityntöihin lisätty uusia palveluja vuoden 2026 alun jälkeen.

Niina Viitanen, erityisasiantuntija, Digi- ja väestötietovirasto