Yksi rajapinta tarjoaa kaikki Suomi.fi-viestien ominaisuudet käyttöön

Suomi.fi-viestien käyttöönotto ja palvelun monipuolinen käyttö muuttuu nyt entistä helpommaksi, kun palveluun on valmistunut uusi REST-rajapinta. Tämän uuden rajapinnan kautta on mahdollista saada käyttöön kaikki ne ominaisuudet, jotka ovat olleet aiemmin Suomi.fi-viesteissä eri rajapintojen ominaisuuksina. Jatkossa palvelua käyttävän tai käyttöönottavan organisaation ei siis tarvitse vertailla eri rajapintoja ja arvioida, mikä niistä olisi paras organisaation käyttötarpeisiin nähden. Kaikki ominaisuudet löytyvät yhden rajapinnan takaa. 

”Haluamme, että julkisen hallinnon organisaatioiden olisi mahdollisimman yksinkertaista siirtyä lähettämään viranomaispostinsa sähköisesti Suomi.fi-viestien kautta. Jatkossa Suomi.fi-viestien toiminnallisuudet löytyvät yhden rajapinnan alta ja kaikki tarvittavat ominaisuudet ovat organisaation käytettävissä yhdellä integraatiolla. Tämä helpottaa organisaatioita uusien ominaisuuksien käyttöönotoissa”, kertoo palveluomistaja Maria Juka-Lahdenperä Digi- ja väestötietovirastosta.

Kaikki uudet käyttöönotot uuden rajapinnan kautta

Uusi rajapinta ei vaadi välittömästi muutoksia vanhoihin, aiemmin tehtyihin liityntöihin, eikä Suomi.fi-viestejä jo käyttävien organisaatioiden ole pakko siirtyä käyttämään uutta REST-rajapintaa välittömästi. Kaikki uudet Suomi.fi-viestien käyttöönotot tehdään kuitenkin jatkossa vain REST-rajapinnan kautta. Vanhoista rajapinnoista tullaan luopumaan tulevaisuudessa. Digi- ja väestötietovirasto kartoittaa parhaillaan sopivaa aikataulua ja siirtymäaikaa vanhoista rajapinnoista luopumiselle. 

”Suosittelemme kuitenkin jo nyt, että jos organisaationne on tekemässä muutoksia Suomi.fi-viestien käyttöön, niin samassa yhteydessä kannattaa siirtyä käyttämään uutta REST-rajapintaa”, Juka-Lahdenperä kannustaa.

Tehokasta viestinvälitystä ja uusia ominaisuuksia

Uusi rajapinta tehostaa viestien välittämistä vastaanottajille. Se myös tekee lähetyksessä mahdollisesti ilmenneiden virhetilanteiden korjaamisesta yksinkertaisempaa.

”Tämän lisäksi olemme tuoneet Suomi.fi-viesteihin uusia ominaisuuksia, joiden myötä palvelua voidaan käyttää entistä monipuolisemmin. Olemme esimerkiksi kehittäneet muistutusviestejä siten, että vastaanottaja saa muistutukset hänellä lukemattomana olevista viesteistä viestikohtaisesti. Samalla muistutusten viestisisältöä on selkeytetty. REST-rajapintaan on myös tuotu ominaisuus, jolla voidaan kytkeä muistutus pois päältä esimerkiksi lisäarvopalveluna tuotetuista viesteistä, joita vastaanottaja osaa odottaa. Tällaisia voivat olla esimerkiksi erilaiset kuitit tai vahvistusviestit, joita vastaanottajan ei ole välttämättä tarve käydä avaamassa Suomi.fi-viesteissä. Tämä uusi toiminnallisuus korvaa aiemmin palvelussa käytettävät ilmoitusviestit”, kertoo Juka-Lahdenperä.

Muutoksia on tullut myös viestien tilatietojen ja loppukäyttäjien lähettämien viestien toimitustapaan. Jatkossa organisaation lähettämien viestien tilatiedot ja vastaanottajien lähettämät viestit liitteineen voidaan hakea REST-rajapinnasta. Myös todisteellinen tiedoksianto on nyt mahdollista lähettää vastaanottajalle yhdellä lähetyksellä riippumatta siitä, vastaanotetaanko se sähköisesti vai paperilla. 

REST-rajapinnan kautta on tarjolla seuraavat uudet ominaisuudet:

• mahdollisuus eriyttää viestisisältöä sen mukaan, meneekö viesti vastaanottajalle sähköisessä muodossa vai paperipostina
• yhtenäinen toimitustapa sähköisessä kanavassa ja paperipostina toimitettavassa todisteellisessa tiedoksiannossa 
• sähköposti-ilmoitusten hallinta:
  • mahdollisuus piilottaa lähettäjän nimi sähköposti-ilmoituksesta
  • mahdollisuus lisätä organisaation personoimaa tekstiä uudesta saapuneesta viestistä kertovan sähköposti-ilmoituksen vakiosisältöön
  • mahdollisuus säätää viestikohtaisesti, lähteekö vastaanottajalle muistutus hänellä olevasta lukemattomasta viestistä 
• mahdollisuudet muotoilla sähköisen viestin sisältöä. Jatkossa sähköisissä viesteissä mahdollisuus käyttää seuraavia muotoiluja: 
  • kahden tasoiset otsikot
  • numeroidut ja numeroimattomat listat 
  • lihavointi 
  • tekstikappaleet (tuettu aiemmin)
  • linkit (tuettu aiemmin)
• Suomi.fi-viestien tulostus-, kuoritus- ja jakelupalvelussa (TKJ) on käytettävissä väritulostus ja vaakasuuntaiset sivut, jotka aiemmin löytyivät WS-rajapinnasta. Lisäksi uutena tulee mukaan mahdollisuus yksipuoliseen tulostukseen.

Lisätietoja

Lue lisää Viestien REST-rajapinnan uusista ja vanhoista toiminnallisuuksista Suomi.fi kehittäjille -sivuilta: https://kehittajille.suomi.fi/palvelut/viestit/toiminnallisuudet

Digi- ja väestötietovirasto, Organisaatioiden asiakaspalvelu, [email protected], p. 0295 535 115 (puhelinpalvelu arkipäivisin klo 9–15)