Suomi.fi-viestien vanhat rajapinnat suljetaan 1.1.2027 – varmista organisaationne toimenpiteet

Lähettääkö organisaationne Suomi.fi-viestejä?

Jos lähettää, nyt on tärkeää selvittää, mitä rajapintoja viestien lähettämisessä käytetään. Vanhat WS-, SFTP- ja SMTP-rajapinnat poistuvat käytöstä 1.1.2027.

Jokainen Suomi.fi-viestejä lähettävä palvelu käyttää jotain rajapintaa. Organisaationne tulee tunnistaa viestejä lähettävät palvelut ja selvittää, käytetäänkö niissä vanhoja rajapintoja.

Jos palvelu käyttää vanhaa rajapintaa, se on siirrettävä käyttämään REST-rajapintaa. Vaihtoehtoisesti palvelun käytöstä on luovuttava, jos käyttötarvetta ei ole. Tarvittavat toimenpiteet on tehtävä viimeistään joulukuun 2026 aikana.

Organisaatiolla voi olla Suomi.fi-viesteissä käytössä yksi tai useampi palvelu. Eri palvelut voivat käyttää eri rajapintoja.

Mitä organisaationne tulee tehdä nyt?

Käykää läpi kaikki organisaationne Suomi.fi-viestien palvelut ja varmistakaa jokaisen osalta:

• onko palvelu edelleen käytössä
• mitä rajapintaa palvelu käyttää
• mitä palvelulle tehdään ennen 1.1.2027
• onko tarvittavat toimenpiteet jo käynnistetty
• kuka vastaa toimenpiteiden etenemisestä organisaatiossanne

Jos toimenpiteitä ei ole vielä aloitettu, ne tulisi aloittaa viimeistään nyt.

Selvittäkää, onko palvelu edelleen käytössä

Jokainen Suomi.fi-viestien palvelu kuuluu käytännössä jompaankumpaan seuraavista tilanteista.

Tilanne 1: Palvelu on aktiivisessa käytössä

Jos palvelu on aktiivisessa käytössä ja sen käyttöä tarvitaan myös vuoden 2027 jälkeen, sille on tehtävä tarvittavat toimenpiteet ennen 31.12.2026. Toimenpiteet riippuvat siitä, mitä rajapintaa palvelu käyttää.

Jos palvelu käyttää WS- tai SFTP-rajapintaa

Jos WS- tai SFTP-rajapintaa hyödyntävän palvelun käyttöä halutaan jatkaa, se on siirrettävä REST-rajapinnalla tuotantokäyttöön viimeistään joulukuun 2026 aikana.

Jos käytätte Suomi.fi-viestejä järjestelmätoimittajan tarjoaman ratkaisun kautta, varmistakaa järjestelmätoimittajaltanne mahdollisimman pian:

• onko järjestelmässä tuki Suomi.fi-viestien REST-rajapinnalle
• milloin REST-rajapinta on käytettävissä
• milloin siirtymä voidaan toteuttaa
• mitä toimenpiteitä organisaatioltanne tarvitaan
• ehtiikö siirto tuotantokäyttöön viimeistään joulukuussa 2026.

Teknisesti siirto voi olla nopea, mutta siirron yhteydessä vaaditaan erilaisia hallinnollisia toimenpiteitä myös organisaatioltanne. Siksi siirtoon on varattava riittävästi aikaa ja aloitettava tarvittavat toimet mahdollisimman pian.

Jos palvelu käyttää SMTP-rajapintaa (sähköpostiliityntä)

SMTP-rajapintaa ei voi siirtää eikä muuntaa REST-rajapinnaksi. SMTP-rajapinnan käyttö päättyy vanhojen rajapintojen sulkeutuessa 1.1.2027. Tämän jälkeen viestejä ei ole enää mahdollista lähettää tai vastaanottaa organisaation sähköpostiohjelman kautta.

Jos organisaatiollanne on aktiivisessa käytössä SMTP-rajapintaa hyödyntävä palvelu, selvittäkää mihin sitä käytetään tällä hetkellä. Tämän jälkeen teidän on päätettävä, miten sama käyttötarve ratkaistaan jatkossa.

Mahdollisia ratkaisuja voivat olla esimerkiksi:

• Suomi.fi-viestien käytön jatkaminen toteuttamalla REST-rajapintaintegraatio johonkin käytössä olevaan järjestelmään
• siirtyminen järjestelmään tai valmisratkaisuun, jossa REST-tuki on olemassa
• muu organisaation käyttämä sähköisen viestinnän ratkaisu
• nykyisen käyttötavan lopettaminen, jos sille ei enää ole tarvetta

SMTP-rajapinnan kohdalla kyse ei ole teknisestä siirrosta REST-rajapintaan. Organisaation on ratkaistava, miten nykyinen käyttötarve hoidetaan, kun SMTP-rajapinta poistuu käytöstä. Jos palvelun käyttö päättyy SMTP-rajapinnan poistuessa käytöstä, ilmoittakaa asiasta etukäteen DVV:lle. Jatkotoimenpiteet ja mahdolliset korvaavat ratkaisut voitte suunnitella organisaation omassa aikataulussa.

Tilanne 2: Palvelu ei ole aktiivisessa käytössä tai sitä ei enää tarvita

Kaikkia organisaatiollenne avattuja Suomi.fi-viestien palveluita ei välttämättä enää käytetä.

Palvelu voi esimerkiksi:

• liittyä järjestelmään, joka on poistunut käytöstä
• liittyä palveluun, jota ei enää tarjota
• olla aikoinaan avattu tuotannossa, mutta sitä ei ole koskaan käytetty
• olla jäänyt tarpeettomaksi organisaation toiminnan muuttuessa
• olla sellainen, jonka sulkeminen ei vaikuta organisaation toimintaan.

Tällaisessa tilanteessa palvelua ei tarvitse siirtää REST-rajapintaan eikä sille tarvitse toteuttaa korvaavaa ratkaisua.

Ilmoittakaa käyttämättömästä palvelusta DVV:lle, jotta tällaiset palvelut voidaan sulkea jo ennen määräaikaa. Ilmoituksen voi tehdä osoitteeseen: viestit-kayttoonotot@dvv.fi.

Miksi käyttämättömästä palvelusta pitää ilmoittaa DVV:lle?

Käyttämätöntä palvelua ei ole tarkoituksenmukaista pitää avoinna pelkästään varmuuden vuoksi. Palvelun avoinna pitäminen ei vähennä työmäärää tilanteessa, jossa organisaatio päättää myöhemmin ottaa Suomi.fi-viestit käyttöön järjestelmässä REST-rajapinnan kautta. Käyttöönoton edellyttämät toimenpiteet on tehtävä joka tapauksessa.

Ilmoitus asiasta on DVV:lle on tärkeä, sillä tiedon avulla DVV voi sulkea käyttämättömiä palveluita hallitusti jo ennen määräaikaa. Samalla sekä organisaatiolla että DVV:llä säilyy mahdollisimman ajantasainen käsitys tilanteesta. DVV voi kohdistaa yhteydenotot niihin palveluihin, joissa toimenpiteitä vielä tarvitaan ja organisaationne välttyy tarpeettomilta lisäselvityksiltä sellaisen liitynnän osalta, jonka käyttö on jo päättynyt tai jonka kohtalo on jo tiedossa.

Jos siis tiedätte, että jokin liityntä voidaan sulkea, ilmoittakaa siitä DVV:lle: viestit-kayttoonotot@dvv.fi.

Näin etenette

Käykää organisaationne Suomi.fi-viestien palvelut läpi seuraavien kysymysten avulla.

1. Onko palvelu edelleen aktiivisessa käytössä?

Jos palvelu ei ole käytössä, ilmoittakaa DVV:lle, että se voidaan sulkea.

Jos palvelu on käytössä, jatkakaa seuraavaan kysymykseen.

2. Mitä rajapintaa palvelu käyttää?

Jos liityntä käyttää WS- tai SFTP-rajapintaa, se on siirrettävä REST-rajapintaan ennen 31.12.2026.

Jos liityntä käyttää SMTP-rajapintaa, sitä ei voi siirtää REST-rajapintaan. Selvittäkää, toteutetaanko tilalle REST-järjestelmäintegraatio, muu sähköisen viestinnän ratkaisu vai luovutaanko käyttötavasta kokonaan.

3. Onko organisaatioltanne vaadittavat toimenpiteet jo käynnissä?

Jos muutokset ovat jo käynnissä, varmistakaa aikataulu, vastuuhenkilöt, vaadittavat toimenpiteet ja tuotantoon siirtymisen ajankohta. Huolehtikaa, että organisaatiollanne on riittävä käyttölupa. Täyttäkää palvelutietolomake ja käyttöönoton tarkistuslista huolellisesti. Palauttakaa dokumentit DVV:lle, jotta siirto etenee aikataulussa.

Jos toimenpiteitä ei ole aloitettu, aloittakaa ne mahdollisimman pian.

4. Onko järjestelmätoimittajan aikataulu varmistettu?

Jos käytätte järjestelmätoimittajan ratkaisua, varmistakaa toimittajalta, että tarvittavat muutokset valmistuvat ajoissa. Kaikilla järjestelmätoimittajilla ei välttämättä ole vielä valmista REST-toteutusta. Tämän vuoksi aikataulu on syytä varmistaa mahdollisimman pian.

Tarkistuslista organisaatioille

• Olemme käyneet läpi organisaatiomme Suomi.fi-viestien liitynnät.
• Tiedämme, mitkä liitynnät ovat edelleen käytössä.
• Tiedämme, mitä rajapintaa kukin käytössä oleva liityntä käyttää.
• WS- ja SFTP-liityntöjen REST-siirtymät on käynnistetty.
• SMTP-liityntöjen jatkoratkaisu on päätetty.
• Järjestelmätoimittajan aikataulu on varmistettu.
• Olemme ilmoittaneet DVV:lle liitynnöistä, joita ei enää käytetä tai tarvita.
• Kaikki tarvittavat toimenpiteet valmistuvat viimeistään 31.12.2026.

Näin varmistatte, että organisaationne tarvitsemat Suomi.fi-viestien liitynnät toimivat myös vuoden 2027 jälkeen ja että tarpeettomat liitynnät voidaan sulkea hallitusti jo ennen määräaikaa.

Huomioittehan myös muut rajapintauudistukset

Yllä oleva ohje koskee vain Suomi.fi-viestit -palvelun rajapintoja. DVV:n muissa palveluissa on myös meneillään rajapintauudistuksia, joissa saatetaan puhua myös REST-rajapintaan siirtymisestä. Varmistattehan oikeat toimenpiteet ja aikataulut eri palveluiden osalta.

Esimerkiksi VTJ ylläpidon rajapintojen käyttöönottoaikataulusta löydätte lisätietoja Väestötietojärjestelmän -sivuilta (dvv.fi)Avautuu uuteen ikkunaan..