15.07.2025 - Tiedote koskien Massatulostuspalvelu (Payslip) API:a

Hyvä Massatulostuspalvelua käyttävä asiakkaamme,

Haluamme muistuttaa suositellusta ja tuetusta tavasta lähettää tiedostoja Massatulostuspalvelun (Payslip) API:n kautta:

Vaikka API toimii edelleen kuten aiemminkin, olemme havainneet, että osa vanhemmista integraatioista lähettää tiedostoja edelleen Base64-koodattuna merkkijonona joko query parametrina tai JSON-muodossa. Tämä ei ole optimaalisin ratkaisu ja voi aiheuttaa haasteita esimerkiksi tiedostokoko rajoitusten tai palvelun yleisen toimintavarmuuden suhteen.

Jotta tiedostojen käsittely olisi sujuvampaa ja virheettömämpää, suosittelemme vahvasti käyttämään multipart/form-data -muotoa tiedostojen lähetykseen jatkossa.

Mitä sinun kannattaa tehdä?

Tarkista nykyinen integraatiosi ja päivitä se käyttämään multipart-lähetystä, jos käytössä on vielä Base64-muoto.

Miksi multipart on parempi?

• Tehokkaampi ja luotettavampi tiedostojen käsittely

• Pienempi riski virheille

• Parempi tuki suurille tiedostoille

• Selkeämpi erottelu tiedoston ja metatietojen välillä

• Kestävämpi ja yhteensopivampi ratkaisu pitkällä aikavälillä

Jos käytät jo multipart-lähetystä, mitään muutoksia ei tarvita.

Mikä on Massatulostuspalvelu?

Maventan massatulostuspalvelun avulla voit lähettää PDF-tiedostoja kirjeinä tulostuspalvelun kautta Suomessa. Alun perin palkkalaskelmien toimittamiseen suunniteltua palvelua voidaan käyttää kaikenlaisten kirjeiden lähettämiseen, kunhan tulostuspalvelun vaatimukset täyttyvät (esimerkiksi vastaanottajan osoitetietojen sijoittaminen oikeaan kohtaan PDF-dokumentissa). Palvelu soveltuu hyvin esimerkiksi tiedotteiden, kokouskutsujen tai suoramaksuilmoitusten lähettämiseen – sekä kotimaahan että ulkomaille.

Lisätietoja palvelusta löydät Maventan ohjesivustolta ja integraatio dokumentaatiosta. 

Jos sinulla on kysyttävää, autamme mielellämme! 

Ystävällisin kesäterveisin,

Maventan asiakaspalvelu