Suomi.fi-viestien viestityyppejä tullaan käsittelemään osittain eri tavoin REST-rajapinnassa. Tällä sivulla käsitellään viestityyppejä yleisesti sekä niihin suunniteltuja muutoksia. 

Normaali viesti

Normaali viesti (tukipalvelulain määrittämä tiedoksianto) on Suomi.fi-viestien välittämä viesti loppukäyttäjän ja asiakasorganisaation välillä. Normaalit viestit muodostavat viestien "perustason", jota muut viestityypit muuttavat tarpeen mukaan. Normaali viesti voi sisältää liitteitä tai olla liitteetön. 

REST mahdollistaa normaalien viestien lähettämisen.

Muutokset

Ei merkittäviä muutoksia. REST mahdollistaa normaalien viestien lähettämisen, kuten Suomi.fi-viestien aikaisemmat WS- ja SFTP- ja SMTP-liityntätavat.

Todisteellinen tiedoksianto

Todisteellinen tiedoksianto tarkoittaa organisaation lähettämää päätöstä tai muuta asiakirjaa, joka vastaanottajan on kuitattava vastaanotetuksi ennen kuin viestin voi avata. Viesti katsotaan toimitetuksi vastaanottajalle, kun se on kuitattu vastaanotetuksi. Vastaanottokuittausta vaaditaan useimmiten viestissä, joka sisältää päätöksen, jonka tiedoksisaannista alkaa kulua muutoksenhakuaika tai muu määräaika. Vastaanottokuittausta voidaan käyttää myös, jos se on tarpeen henkilön oikeuksien turvaamiseksi. 

Jos loppukäyttäjä ei ole kuitannut viestiä vastaanotetuksi seitsemän päivän kuluessa sen toimittamisesta sähköisesti Suomi.fi-viesteihin, on viestin lähettänyt organisaatio velvollinen toimittamaan tiedoksiannon postitse saantitodistusta vastaan. 

REST tulee mahdollistamaan todisteellisten tiedoksiantojen sähköisen ja paperisen lähetyksen sekä niiden kuittauksien vastaanottamisen sähköisesti. Lisätietoa paperisten todisteellisten tiedoksiantojen toimituksen seurannasta voi lukea osiosta Paperiposti.

Muutokset

Tällä hetkellä Suomi.fi-viestit mahdollistaa sekä sähköisten että paperisten todisteellisten tiedoksiantojen lähettämisen, mutta lähettämiseen käytetyt liityntätavat eivät ole yhdenmukaiset. Alla on kaavio todisteellisen tiedoksiannon lähettämisestä nykyisillä liityntätavoilla: 

Tällä hetkellä vain iPost/SFTP-liityntätavalla on mahdollista lähettää sekä sähköisiä että paperisia todisteellisia tiedoksiantoja. Liityntätavalla ei kuitenkaan voi vastaanottaa sähköisten todisteellisten tiedoksiantojen kuittauksia, vaan nämä saadakseen organisaation on toteutettava liityntä toisella liityntätavalla (WS tai SMTP). Mikään vanhoista liityntätavoista ei myöskään mahdollista paperisten todisteellisten tiedoksiantojen kuittausten sähköistä vastaanottamista — tämä rakennetaan vain REST-rajapintaan. RESTin avulla asiakasorganisaatiot voivat täten vastaanottaa sekä sähköisten että paperisten todisteellisten tiedoksiantojen kuittaukset samaa reittiä hyödyntäen, mikä keventää kuittausten käsittelyä.  

Ilmoitusviesti

Ilmoitusviesti on normaalille viestille rinnakkainen viestityyppi, jolla mahdollistetaan asiakasorganisaation lisäpalvelu-tyyppinen viestintä loppukäyttäjille. Ilmoitusviesti voi olla esimerkiksi muistutus lähestyvästä vastaanottoajasta tai muistutus passin/ajokortin vanhenemisesta. Ilmoitusviestit ovat tyypiltään tiedoksiantoja, joiden perillemeno ei ole yhtä keskeisessä asemassa kuin muilla viestityypeillä. 

Ilmoitusviesteillä on erityispiirteitä, jotka erottavat ne muista viestityypeistä. Ilmoitusviestit ovat esimerkiksi samansisältöisiä sekä loppukäyttäjälle lähetettävässä ilmoituksessa uudesta viestistä sekä itse viestissä Suomi.fi-viesteissä. Lisäksi ilmoitusviesteistä ei lähetetä loppukäyttäjälle muistutusta, jos viesti jää lukematta. 

REST-rajapinnan ei ole suunniteltu mahdollistavan ilmoitusviestien lähettämistä. Sen sijaan rajapintaan suunnitellaan ominaisuuksia, joiden avulla viestin lähettäjäorganisaatio voi halutessaan säätää viestiään niin, että se käyttäytyy ilmoitusviestin tyyppisesti (ks. lukematon viesti -ilmoituksen konfigurointi). 

Muutokset

REST-rajapinta ei tule mahdollistamaan ilmoitusviestien lähettämistä, kuten WS-rajapinnan LisaaKohteita-operaatio nyt tekee. 

Näkyvyydeltään rajattu viesti

Viestin näkyvyyden rajaus on erityistoiminnallisuus, joka tarjoaa mahdollisuuden lähettää vastaanottajalle sellaisen viestin, jonka sisältöä ei näytetä henkilölle, jolla on oikeus asioida käyttäjän puolesta. Ominaisuus on olennainen sellaisille lähetystilanteille, joissa viesti on esimerkiksi lakimäärityksien johdosta sallittua toimittaa vain ja ainoastaan kohdehenkilölle, ei kenellekään muulle. 

REST-rajapinnan kehityksen alkuvaiheessa ominaisuudesta tehdään MVP-toteutus ja sitä pilotoidaan yhden asiakasorganisaation kanssa. Yksityiskohdat tulevat tarkentumaan kehitysprojektin edetessä. 

Muutokset

Viestin näkyvyyden rajaaminen on uusi toiminnallisuus Suomi.fi-viesteissä, ja se tullaan tarjoamaan vain REST-liityntätavassa.