SFTP-rajapinta
Huomaattehan, että Suomi.fi-viestien vanhat rajapinnat ovat ylläpitotilassa, eikä niihin lähtökohtaisesti enää tuoteta uusia toiminnallisuuksia. Kaikki vanhat rajapinnat suljetaan 1.1.2027. Tämä tarkoittaa sitä, että kaikkien Suomi.fi-viestejä käyttävien palvelujen pitää siirtyä käyttämään uutta REST-rajapintaa ennen vuotta 2027.
SFTP-rajapinnan avulla organisaationne voi lähettää aineistoa (tiedostoja ja dokumentteja) loppukäyttäjille. SFTP-rajapinnan käyttö edellyttää aina tulostussopimusta ja se mahdollistaa aineiston jakelun sekä sähköisessä muodossa että paperipostilla.
Kun loppukäyttäjä on henkilö, ohjaustietoihin (XML-tiedosto) lisätään henkilötunnus (SSN). Sen avulla tarkistetaan, onko loppukäyttäjällä Suomi.fi-viestit käytössä:
- <Recipient emailAddress="recipient1@nnn.nn" customerCode="1111" phoneNumber="11111111" SSN="111111-1111">
Kun loppukäyttäjä on yritys, ohjaustietoihin (XML-tiedosto) lisätään henkilötunnuksen sijaan OVT-tunnus (ovtID). OVT-tunnuksen sisältämästä Y-tunnuksesta tarkistetaan, onko loppukäyttäjällä Suomi.fi-viestit käytössä:
- <Recipient …ovtID="003712345678"...</Recipient>
Viestejä pystyy lähettämään vain suomalaisille yrityksille (OVT-tunnuksen alkuosa on 0037). OVT-tunnus (0037NNNNNNNTBBBBB) ja sen sisältämä Y-tunnus (NNNNNNN-T) validoidaan, mutta Y-tunnuksen olemassaoloa ei tarkisteta yritys- ja yhteisötietojärjestelmästä.
Niille loppukäyttäjille, jotka eivät käytä Suomi.fi-viestejä, viranomaisviestit lähetetään edelleen perinteisesti paperipostilla.
Organisaationne järjestelmä saa SFTP-siirron päätteeksi teknisen kuittauksen siitä, että tiedosto on otettu vastaan Valtorin Yhteisen integraatioalustan (VIA) FTP-palveluun. Jotta Suomi.fi-viestit voi lähettää sähköisten viestien tilatietoja organisaatiollenne, tarvitsee SFTP-rajapinta rinnalleen toisen ominaisuutta tukevan rajapinnan.
