12.5.2025 alkaen Suomi.fi-viestien käyttöönottoa ehdotetaan henkilöille, jotka tunnistautuvat vahvasti viranomaisten sähköisiin asiointipalveluihin, kuten positiiviseen luottotietorekisteriin. Lisätietoja Suomi.fi-viestien käyttöönotosta Digi ensin -hanke | Digi- ja väestötietoviraston verkkosivuilla.

Tuotannon dokumentaatio

Tältä sivulta löydät rekisterin tällä hetkellä käytössä olevaa tuotantoympäristöä kuvaavan dokumentaation. Rekisteriä kehitetään jatkuvasti, ja tulevat muutokset on kerrottu sivulla Dokumentaatio kohdassa "Tulossa olevat muutokset".

Tällä sivulla on julkaistu tuotannossa voimassa oleva dokumentaatio. Jos etsit toisen vaiheen dokumentaatiota, siirry sivulle Toisen vaiheen dokumentaatio.

Rajapintakuvaukset

Rajapintakuvauksissa kuvataan ilmoitettava tietosisältö sekä rajapintaan lähetettävän sanoman ja rajapinnasta palautuvan vastaussanoman rakenne.

Rajapinnan käsittelysäännöt ja virhekoodisto

Tässä dokumentissa kuvataan yksityiskohtaisesti jokaisen rekisteriin ilmoitettavan tiedon käsittelysäännöt sekä virhekoodit, jotka rajapinta antaa erilaisissa virhetilanteissa.

Sanomaesimerkit

Tutustu myös sanomaesimerkkeihin, joissa annetaan esimerkit eri rajapintoihin lähetettävistä sanomista:

Skeemakuvaukset

Skeemakuvauksissa kuvataan, missä muodossa ja mitä sisältöä sanomat sisältävät, sekä yksinkertaisimmat pakollisuussäännöt. Kuvaukset eivät sisällä tietokenttien ehdollisia pakollisuussääntöjä eivätkä monimutkaisempia validointeja, jotka liittyvät järjestelmän tietosisältöön. Nämä löydät rajapintakuvauksista.

Sivu on viimeksi päivitetty 8.5.2025