Ennakkotietoa Suomi.fi-viestien TKJ-toimittajan vaihtumiseen liittyvistä muutoksista
Julkaistu 29.10.2026
Suomi.fi-viestien tulostus-, kuoritus- ja jakelupalvelun (TKJ) toimittajaksi vaihtuu Edita Prima. Toimittajavaihdos tapahtuu vuoden 2027 alkupuolella. Tekniset muutokset edellyttävät organisaatioltanne tai käyttämältänne järjestelmätoimittajalta joitakin toimenpiteitä, jos TKJ-palvelu on käytössä.
Mitä toimittajanvaihdos tarkoittaa käytännössä?
Normaalissa kirjepostissa TKJ-toimittajaksi vaihtuu Edita Prima
- Edita Primaa varten tarvitaan uudet TKJ-tunnukset ja salasana, jotka on päivitettävä lähettäviin järjestelmiin. Saatte näiden osalta myöhemmin erilliset ohjeet DVV:ltä.
- Normaalissa kirjepostissa ikkunallisen kirjekuoren osoiteikkunan sijainti muuttuu Editan käyttämän standardin mukaiseksi. Osoitesivun muutoksista kerrotaan lisää alempana.
- Normaalissa kirjepostissa hinnat laskevat jonkin verran.
- Tavoitteena on, että organisaatiot pystyisivät lähettämään paperikirjeet Edita Priman tarjoaman palvelun kautta maaliskuun 2027 loppuun mennessä.
Paperisessa todisteellisessa tiedoksiannossa toimittajana jatkaa Posti Messaging
- Paperisia todisteellisia tiedoksiantoja lähetettäessä nykyiset Posti Messaging TKJ-tunnukset ja salasanat säilyvät ennallaan.
- Paperisessa todisteellisessa tiedoksiannossa ikkunallisen kirjekuoren osoiteikkunan sijainti pysyy nykyisten Postin vaatimusten mukaisena.
- Paperisten todisteellisten tiedoksiantojen hinnat nousevat hieman.
Millaisia teknisiä muutoksia on odotettavissa?
Edita Priman rajapinta julkaistaan tuotannossa alkuvuodesta 2027. DVV suosittelee perehtymään tuleviin muutoksiin jo ennakkoon ja varaamaan niiden toteuttamiselle riittävästi aikaa.
Normaali kirjeposti (Edita Prima)
Tällä hetkellä paperipostin välittämiseen käytetään REST-rajapinnan päätepisteitä:
- /v2/messages
- /v2/paper-mail-without-id
Nämä päätepisteet välittävät paperipostin Posti Messagingin tulostus-, kuoritus- ja jakelupalveluun.
"printingAndEnvelopingService": {
"costPool": "XUEY3CX5MDDU07S",
"postiMessaging": {
"contactDetails": {
"email": "str@ing.com"
},
"password": "stri",
"username": "string"
}
Vuoden 2027 alkupuolella Edita Priman käyttö tulee mahdolliseksi uusien päätepisteversioiden kautta. Tavoitteena on, että kaikki TKJ-palvelua käyttävät organisaatiot siirtyvät käyttämään v3-päätepisteversioita siirtymäajan jälkeen maaliskuun loppuun mennessä:
- /v3/messages
- /v3/paper-mail-without-id
"printingAndEnvelopingService": {
"costPool": "XUEY3CX5MDDU07S",
"editaPrima": {
"contactDetails": {
"email": "str@ing.com"
},
"password": "pass1234Word!",
"username": "user5Name"
}
Paperinen todisteellinen tiedoksianto (Posti Messaging)
Paperisten todisteellisten tiedoksiantojen päätepisteiden /v3-versioissa postiMessaging-määritys säilyy samana kuin nykyisissä /v2-päätepisteissä. Tätä kautta ei ole mahdollista lähettää enää muuta kuin paperisia todisteellisia tiedoksiantoja.
Kun lähetätte paperisen todisteellisen tiedoksiannon:
- paperMail –elementin alla olevan messageServiceType -elementin arvon tulee olla Verifiable.
- printingAndEnvelopingService -elementin alla saa olla vain postiMessaging-elementti alielementteineen.
Muutokset osoitesivuun normaalissa kirjepostissa
Paperipostina lähetettävä sisältö toimitetaan Suomi.fi-viesteihin yhtenä PDF-tiedostona.
Osoitesivu voidaan muodostaa kahdella tavalla. Organisaationne joko
- tekee osoitetietojen asettelun itse tai
- pyytää Suomi.fi-viestejä tekemään osoitetietojen asettelun puolestanne, jos viesti ohjautuu paperipostiin. Tämä onnistuu asettamalla createAddressPage – elementin arvoksi “true”.
Selvittäkää, kumpaa toimintatapaa käytätte tällä hetkellä.
- Jos organisaationne muodostaa osoitesivun itse, osoitetietojen sijainti ja asettelu on päivitettävä Edita Priman vaatimusten mukaiseksi, kun lähetätte normaalia kirjepostia. Paperisia todisteellisia tiedoksiantoja lähetettäessä noudatetaan nykyisiä Postin vaatimuksia.
- Jos käytätte Suomi.fi-viestien osoitetietojen asettelua, muutokset eivät edellytä toimenpiteitä organisaatioltanne osoitesivun suhteen.
Uusiin osoitesivuvaatimuksiin voi tutustua ennakkoon tästä: Edita Priman vaatimukset osoitesivun asettelulle (PDF, 447,22 kt)Avautuu uuteen ikkunaan.
Uusi rajapinta ja uudet osoiteasettelut voidaan ottaa käyttöön vasta, kun rajapinta julkaistaan alkuvuodesta 2027 ja kun se on ensin testattu käyttämässänne järjestelmässä. DVV suosittelee kuitenkin aloittamaan muutosten suunnittelun ja valmistelun hyvissä ajoin.
Lisätietoja:
Suomi.fi-viestien organisaatioiden käyttöönottojen tuki
viestit-kayttoonotot@dvv.fi