Rajapinta- ja arkkitehtuuriuudistus

Digi- ja väestötietovirasto on uudistamassa PTV:n arkkitehtuuria. Uudistuksessa selkiytetään ja yksinkertaistetaan PTV:n teknistä toteutusta, tehdään rajapinnoista helpommin hyödynnettävät ja toteutetaan runsaasti vuosien varrella asiakkailta tulleita kehitysehdotuksia.

Uudistuksessa ei muuteta PTV-tietomallia muutamia lisäkenttiä lukuun ottamatta.

Arkkitehtuuriuudistukseen liittyvien infotilaisuuksien ja klinikoiden materiaalit ja tallenteetAvautuu uuteen ikkunaan.

Tekninen dokumentaatio integraation toteuttajalle

Kaikkien integraation toteuttaneiden organisaatioiden on siirryttävä käyttämään rajapintaversiota 12 viimeistään huhtikuussa 2027. Tämä vaatii organisaatioilta toimenpiteitä.

Aikataulu

01/2026

Uuden rajapintaversion 12 hakurajapintametodit (OUT-rajapintametodit) on julkaistu asiakastestiympäristössä (koulutusympäristö) ja niitä pääsee testaamaan.
Käytettävissä on asiakastestiympäristön nykyinen data, ja olemassa oleviin organisaatioihin voi luoda lisää sisältöjä.
Rajapinnoista on haettavissa kaikki eri sisältötyypit, esim. palvelu + asiointikanavat -kokonaisuuden muodostaminen on mahdollista.
Versio 11:n OUT ja IN-rajapinnat ovat yhä käytettävissä.

03–04/2026

Uuden rajapintaversion 12 hakurajapintametodit (OUT) on julkaistu tuotantoympäristössä betana. Tämän jälkeenkin tuotantoon voi vielä tulla muutoksia ennen syksyä 2026.
Tuotannon data on haettavissa, API-avain käytössä.
Versio 11:n OUT ja IN-rajapinnat ovat yhä käytettävissä.

10/2026

Uuden rajapintaversion 12 tuontirajapintametodit (IN-rajapintametodit) julkaistaan asiakastestiympäristössä (entinen nimi koulutusympäristö) ja niitä pääsee testaamaan.
Versio 11:n OUT- ja IN-rajapinnat ovat yhä käytettävissä.

11/2026

Uuden rajapintaversion 12 hakurajapintametodien (OUT) lopulliset versiot julkaistaan tuotantoympäristössä, eikä niihin enää tule rikkovia muutoksia. Rajapintaan voidaan kuitenkin vielä lisätä uusia kenttiä.
Versio 11:n OUT- ja IN-rajapinnat ovat yhä käytettävissä.

Huhtikuu 2027 / Täsmentyy vielä

Uuden rajapintaversion 12 tuontirajapintametodit (IN) julkaistaan tuotantoympäristössä. Kaikki tuontirajapinnan käyttäjät siirtyvät samaan aikaan versio 12:n käyttäjiksi.
V11 rajapinnat (OUT ja IN) poistuvat kokonaan käytöstä huhtikuussa 2027.
Käyttöliittymä siirtyy käyttämään uuden sovelluksen ui-rajapintoja.

Tarkennamme työn etenemisen aikataulua tälle sivulle.