Ilmoittakaa Digi- ja väestötietovirastolle, että haluatte näyttää Suomi.fi-viesteissä olevat viranomaisviestit omassa digipostipalvelussanne.
Näin liitytte Suomi.fi-viestien digipostitoimijaksi
Mikä on digipostitoimija?
Digipostitoimija on palveluntarjoaja, joka tarjoaa loppukäyttäjille oman digipostipalvelun tai katseluohjelman Suomi.fi-viesteissä olevien viranomaisten tiedoksiantojen ja muiden viestien lukemiseen.
Digipostitoimija:
- tarjoaa palvelun suoraan loppukäyttäjille
- tunnistaa käyttäjän vahvasti
- pyytää käyttäjältä luvan viranomaisviestien näyttämiseen palvelussaan
- näyttää käyttäjälle Suomi.fi-viesteissä olevat viranomaisviestit Digi- ja väestötietoviraston (DVV) tarjoamien rajapintojen avulla
- vastaa oman palvelunsa käyttäjäviestinnästä, asiakasohjauksesta ja asiakastuesta.
Huom. Tämä ohje on tarkoitettu digipostipalveluita tarjoaville organisaatioille. Jos toimitte viestien lähettäjänä, järjestelmätoimittajana tai teknisenä integraatiokumppanina toiselle organisaatiolle, ette ole tässä tarkoitettu digipostitoimija.
Digipostitoimijana toimii aina loppukäyttäjälle palvelua tarjoava organisaatio, joka tekee sopimuksen Digi- ja väestötietoviraston kanssa.
1. Ilmoittakaa kiinnostuksestanne
Ottakaa yhteyttä Digi- ja väestötietovirastoon sähköpostilla osoitteeseen viestit-kayttoonotot@dvv.fi ja ilmoittakaa halukkuudestanne alkaa näyttää Suomi.fi-viesteissä olevia viranomaisviestejä omassa digipostipalvelussanne.
Yhteydenoton jälkeen saatte lisätietoa:
- liittymisprosessista
- vaatimuksista
- sopimuksista
- testauksesta
- käyttöönoton etenemisestä.
2. Arvioikaa täyttääkö palvelunne vaatimukset
Varmistakaa, että palvelunne täyttää kaikki digipostitoimijalle ja digipostipalvelulle asetetut vaatimukset.
Perehtykää aineistoon:
- Rajapintakuvaukset (api.messages.suomi.fi)Avautuu uuteen ikkunaan.
- Käyttöehdot ja sopimusasiakirjat (julkaistaan myöhemmin tällä sivulla)
Arvioikaa erityisesti:
Toiminnallisuudet käyttäjälle
- käyttäjien vahva tunnistaminen
- viranomaisviestien turvallinen näyttäminen
- käyttäjän luvan hallinta
- käyttäjän mahdollisuus saada riittävät tiedot palvelun käytöstä
Tietoturva ja tietosuoja
- henkilötietojen käsittely
- lokitus ja jäljitettävyys
- tietoturvan hallintakäytännöt
- häiriötilanteisiin varautuminen
Viestintä, käytön tuki ja asiakaspalvelu
- käyttäjien neuvonta
- asiakasohjaus eri tilanteissa
- viranomaisviestejä koskevien kysymysten käsittely
- häiriöiden viestintä käyttäjille
3. Tehkää sopimus Digi- ja väestötietoviraston kanssa
Digipostitoimija tekee sopimuksen DVV:n kanssa ennen tuotantokäytön aloittamista.
Sopimus koostuu seuraavista dokumenteista (julkaistaan myöhemmin tällä sivulla):
Asiakirja | Kuvaus |
|---|---|
Digipostitoimijan sopimus (pääsopimus) | Määrittelee osapuolten vastuut, oikeudet ja velvollisuudet. |
Liite: Turvallisuusliite | Kuvaa turvallisuusjärjestelyt, salassapidon, tietosuojan ja muun tietoturvallisuuden kattaen digipostipalvelun elinkaaren, digipostitoimijan toiminnan sekä palvelutuotannon jatkuvuuden erilaisissa häiriötilanteissa. |
Liite: Yhteistyöliite | Kuvaa yhteistyön, jota edellytetään DVV:n hyväksymänä digipostipalveluna toimivilta sopimuskumppaneilta. |
Liite: Vaatimustaulukko | Kuvaa tekniset, toiminnalliset ja turvallisuusvaatimukset, jotka digipostipalvelun täytyy täyttää. |
Liite: Testaus-, tarkastus- ja hyväksymisprosessi | Kuvaa digipostipalvelua koskevat testaus‑, tarkastus‑ ja hyväksyntämenettelyt, joita sovelletaan ennen palvelun hyväksymistä tuotantokäyttöön sekä sopimuskauden aikaisiin muutoksiin. |
Liite: Palvelukuvaus | Kuvaa Suomi.fi-viesteihin liitetyn, palveluntarjoajan tuottaman hyväksytyn digipostipalvelun, joka toimii viestinvälityspalvelun käyttöliittymänä sähköistä tiedoksianto- ja muuta viestintätoimintaa varten. |
4. Toteuttakaa integraatio ja testatkaa
Kun sopimusprosessi on käynnissä, voitte aloittaa integraation toteuttamisen.
Rajapinnat
DVV tarjoaa rajapinnat:
- käyttäjän luvan hallintaan
- viestien listaamiseen
- viestien näyttämiseen liittyvien tietojen välittämiseen
- viestien lukukuittausten ja vahvistusten välittämiseen.
Rajapintadokumentaatio (api.messages.suomi.fi).Avautuu uuteen ikkunaan.
Testaus
DVV voi myöntää pääsyn testausympäristöön ja yhteistyökanaviin, kun digipostitoimija on toimittanut tiimin jäsenten yhteystiedot ja allekirjoittanut tarvittavat NDA-sopimukset sekä tarvittavat turvaselvitykset on tehty.
Ennen tuotantokäyttöä:
- toteutus testataan DVV:n ohjeiden mukaisesti
- vaatimusten täyttyminen varmistetaan
- mahdolliset puutteet korjataan.
5. Valmistautukaa viestintään, asiakasohjaukseen ja tukeen
Käyttäjän informointi
Digipostitoimijan tulee varmistaa, ettei käyttäjälle synny virheellistä kuvaa digitaalisten viranomaisviestien toimintalogiikasta. Tavoitteena on, että käyttäjä saa saman käsityksen oikeuksistaan ja velvollisuuksistaan riippumatta siitä, miltä osapuolelta informaatio tulee ja käyttääkö hän Suomi.fi-viestejä vai digipostipalvelua. DVV ei toteuta mainoskampanjoita yhdessä digipostitoimijoiden kanssa.
Digipostitoimija voi hyödyntää DVV:n suosimia termejä varmistaakseen yhdenmukaisuutta asiakasviestinnässä.
- Suomi.fi-viestit on keskitetty ratkaisu julkishallinnon organisaatioiden viestinvälitykseen henkilöille ja yrityksille.
- Digipostipalvelun kautta voi lukea Suomi.fi-viesteissä olevia viestejä sekä muuta digipostia eri lähettäjiltä.
- Viesti, eli sähköinen viranomaisviesti on Suomi.fi-viesteissä oleva viesti, jonka voi lukea kaikissa hyväksytyissä digipostipalveluissa. Henkilölle voi saapua sähköisiä viestejä viranomaisilta myös muuta kautta kuin Suomi.fi-viesteihin. HUOM: Itse viestistä ei koskaan käytetä nimitystä "Suomi.fi-viesti".
- Lupa viestien näyttämiseen on käyttäjän digipostipalvelulle antama lupa, jonka perusteella Suomi.fi-viesteissä olevat viestit voidaan näyttää digipostipalvelussa. Käyttäjä antaa luvan digipostipalvelun kautta ja sen voi poistaa Suomi.fi-viestien asetuksissa.
Suomi.fi-viestien sanasto Suomi.fi-yhteentoimivuusalusta-palvelussa.Avautuu uuteen ikkunaan.
Asiakaspalvelu
Lukekaa lisää asiakastuen järjestämisestä yhteistyössä DVV:n kanssa (Suomi.fi kehittäjille).
6. Aloittakaa tuotantokäyttö
Sopikaa tuotantokäytön aloituksen yksityiskohdista DVV:n kanssa.
Liittymisen vaiheet
1. Ilmoittakaa kiinnostuksestanne
2. Arvioikaa täyttääkö palvelunne vaatimukset
Perehtykää aineistoon ja varmistakaa, että palvelunne täyttää kaikki vaatimukset.
3. Tehkää sopimus Digi- ja väestötietoviraston kanssa
Valmistautukaa allekirjoittamaan sopimus DVV:n kanssa.
4. Toteuttakaa integraatio ja testatkaa
Toteuttakaa toiminnallisuudet DVV:n tarjoamien rajapintojen avulla ja testatkaa toteutus.
5. Valmistautukaa viestintään, asiakasohjaukseen ja tukeen
Varmistakaa, että käyttäjä saa riittävät tiedot ja tuen palvelun käyttöönottoon ja käyttöön.
6. Aloittakaa tuotantokäyttö
Sopikaa tuotantokäytön aloituksen yksityiskohdista DVV:n kanssa.
Päivitetty: 30.9.2026