26.03.2026 - Uutta massatulostuspalvelussa: Kivra-kanava ja JSON API -metodi

1. Kivra digitaalisena toimituskanavana

27.4.2026 alkaen massatulostuspalvelun kirjeitä voi toimittaa myös Kivran kautta.

Mikä on Kivra?

Kivra on digitaalinen postilaatikkopalvelu, jonka kautta kuluttajat voivat vastaanottaa kirjeitä, laskuja ja muita asiakirjoja sähköisesti. Palvelu on ollut osana Maventan kuluttajalaskujen reititystä jo jonkin aikaa, ja nyt se laajenee myös massatulostuspalveluun. Toimitus Kivraan on nopeampaa, vastaanottajalle kätevämpää ja lähettäjälle huomattavasti edullisempaa kuin perinteinen postitus.

Lue lisää Kivrasta

Miten Kivra toimii?

Ennen kuin kirje lähetetään tulostuskumppanille, Maventa tekee automaattisen haun Kivran kuluttajarekisteristä vastaanottajan tiedoilla. Jos vastaanottaja löytyy Kivrasta, kirje toimitetaan suoraan Kivra-postilaatikkoon tulostamisen ja postittamisen sijaan. Muussa tapauksessa kirje etenee normaalisti tulostusreitille.

Haku tehdään vastaanottajan tiedoilla seuraavassa järjestyksessä:

1. Henkilötunnus
2. Sähköpostiosoite
3. Koko nimi + katuosoite + postinumero + postitoimipaikka
4. Koko nimi + puhelinnumero

Kun yritys lähettää ensimmäisen kirjeensä Kivran kautta, Maventa luo yritykselle automaattisesti lähettäjätilin Kivraan, jos sellaista ei vielä ole. Lähettäjätilin ansiosta vastaanottajat näkevät keneltä posti tulee ja voivat halutessaan hallita toimitusasetuksiaan lähettäjäkohtaisesti.

Vaatiiko Kivran käyttö toimenpiteitä lähettäjältä? 

Ei. Kivra-haku toimii automaattisesti, koska nykyinen integraatio välittää jo vastaanottajan nimen ja postiosoitteen. Kivra-osumia voi kuitenkin parantaa siirtymällä uuteen JSON API -metodiin, jonka kautta vastaanottajasta voi välittää lisätietoja kuten henkilötunnuksen, sähköpostiosoitteen tai puhelinnumeron.

Jos yksittäinen kirje pitää toimittaa paperisena, esimerkiksi arkistointisyistä, rajapintakutsussa voi asettaa prevent_digital_post -parametrin arvoon true. Tällöin Kivra- ja OmaPosti-toimitus ohitetaan kyseisen kirjeen osalta.

Huomioithan, että Kivrassa PDF-tiedoston enimmäiskoko on 10 Mt. Jos kirje ylittää tämän rajan, se ohjataan automaattisesti normaalille tulostusreitille.

Kivra-tapahtuman laskutus

Kivra-tapahtumat laskutetaan samalla hinnalla kuin laskukanavan kautta kulkevat Kivra-tapahtumat – muutoksia nykyiseen hinnoitteluun ei tule. Laskutustapahtuman nimi on:

EINVOICE_KIVRA_FI

2. Uusi JSON API -metodi

Massatulostuskirjeiden lähettämiseen on tarjolla myös uusi, helpompi tapa: JSON API -metodi. PDF-kirje ja tarvittavat tiedot lähetetään yksinkertaisena multipart form -pyyntönä eikä erillistä IPOSTXML-tiedostoa tai ZIP-paketointia enää tarvita.

JSON API -metodin kautta voi myös välittää lisätietoja vastaanottajasta, mikä parantaa Kivra-osumia, sekä muokata vastaanottajalle näkyvää kirjeen aihetta:

Lisätiedot löytyvät massatulostuspalvelun dokumentaatiosta.

Yhteenveto

Jos sinulla on kysyttävää, ota rohkeasti yhteyttä.

Ystävällisin terveisin,

Maventa-tiimi