Analyysitietojen siirtopalvelu on tarkoitettu näytteeseen liittyvien tietojen sekä analyysitulosten siirtämiseen laboratorioiden tietojärjestelmistä analyysitietoja käyttäviin järjestelmiin kuten Vati-tietojärjestelmään. Uusi analyysitiedonsiirron rajapinta eli Analyysi-API on otettu käyttöön 24.9.2025. Uusi rajapinta käyttää uudempaa tekniikkaa sekä parantaa analyysisiirron käytettävyyttä ja tiedon laatua.
Siirtymäaika
Vanha rajapinta näytetietojen toimittamiseksi Vatiin on käytössä 30.4.2026 asti. Tähän asti laboratoriot voivat toimittaa aineistot joko vanhaan rajapintaan tai uuteen Analyysi-API:n. Vanha rajapinta poistuu käytöstä 30.4.2026, jolloin uusi rajapinta tulee olla käytössä.
Analyysitietojen siirtopalvelu koostuu siirtymäaikana kahdesta sovellusosasta:
- Analyysi-API (uusi sovellus): HTTP-REST-rajapinta. Käytettävissä syyskuusta 2025 alkaen.
- Analyysisiirto (vanha sovellus): SOAP-rajapinta. Käytettävissä huhtikuuhun 2026 asti. Välittää sanoman uudelle Analyysi-API-rajapinnalle, jonka takia vanhan rajapinnan aiemmin hyväksymä tietosisältö ei välttämättä vastaa uusia tietosisällön vaatimuksia.
Sertifikaatit
Laboratoriot, joilla on voimassa oleva sertifikaatti analyysitietojen siirtopalveluun, ovat saaneet uuden käyttöoikeuden, jolla pääsee käyttämään Analyysi-API:a. Kuitenkin niiden laboratorioiden, joilla on vanhan muotoinen kirjamista muodostuva sertifikaattitunnus, on tarpeen hakea uusi sertifikaatti loppuvuoden 2025 aikana vaikka sertifikaatti olisikin voimassa. Uudet sertifikaattitunnukset ovat @ruokavirasto.fi -päätteisiä.
Sertifikaatin hakeminen tapahtuu samalla tavalla kuin aiemmin, ohje löytyy Ruokaviraston verkkosivulta: https://www.ruokavirasto.fi/laboratoriopalvelut/ruokaviraston-hyvaksymat-laboratoriot/tulosten-sahkoinen-tiedonsiirto/
Tiedon konvertointi ja validointi
Nykyisessä rajapinnassa olevat laboratorioiden toimittamat tiedot on konvertoitu uuden rajapinnan hyväksymään muotoon. Tämä koskee viimeisen kahden kuukauden sisällä konvertoinnista (eli 24.9.2025) toimitettuja aineistoja. Tätä vanhemmat aineistot eivät ole enää rajapinnassa käytössä.
Muutoksia aineistojen vaatimuksiin jo nyt
Vanhaan rajapintaan lähetyt aineistot muunnetaan automaattisesti uuden Analyysi-API rajapinnan hyväksymään muotoon. Tämä aiheuttaa jo nyt joitain uusia vaatimuksia aineistoille.
Aineiston tunnukset
Aineiston tunnukset ovat muuttuneet pienemmiksi. Onnistuneesta tallennuksesta on aiemmin palautunut tunnus, joka oli suuruusluokkaa 600000. Tällä hetkellä palautuu aineiston tunnuksia suuruusluokassa 5000.
Tunnistetiedot
Kaikilla näytteillä tulee olla tunnistetiedot, joiden avulla näyte voidaan tunnistaa ja kohdistaa Vatissa oikein. Kaikilla näytteillä tulee olla jokin numeerinen tunnistetieto (toimipaikkatunnus, kohdetoimintatunnus tai näytteenottopistetunnus), näytteenottopaikan osoite tai näytteenottopisteen koordinaatit. Mikäli kaikki tunnistetiedot puuttuvat, ei aineiston lähetys onnistu.
Analyysien haku
Analyysien haku nimellä ei onnistu enää. Analyysikoodi haetaan joko analyysikoodin tunnuksella (koodistossa kenttä "Tunnus") tai analyysikoodin arvolla (koodistossa kenttä "Arvo"). Analyysiä ei voi enää lähettää muuttujan nimellä, esimerkiksi "ODOUR".
Analyysikoodien arvotyypit
Tulosarvon muodon tulee vastata analyysikoodin tyyppiä eli analyysikoodiston kenttää "Arvotyyppi". Arvotyyppi voi olla numero, teksti tai todettu-tyyppinen.
- Arvotyypin ollessa numero, tulos voi olla vain numero. Nollan (0) tilalla ei saa käyttää viivaa (-). Numeron maksimimerkkimäärä on 12.
- Arvotyypin ollessa todettu, voidaan valita vain "todettu" tai "ei todettu".
- Arvotyypin ollessa teksti, tuloksen tulee olla tekstikuvaus. Tekstin tulee olla korkeintaan 50 merkkiä pitkä. Teksti-muotoinen arvo ei saa sisältää pelkkiä numeroita.
HUOM. Terveydensuojelulain mukaisille näytteille hyväksytään vain yksi arvotyyppi, jos analyysikoodissa on useita arvotyyppejä.
Näytteenottoaika
Näytteenoton päivämäärä ja kellonaika ovat pakollisia. Näytteenottoaika tulee lähettää ISO 8601 -muodossa (YYYY-MM-DDTHH:MM:SS). Aika ei voi olla tulevaisuudessa.
Foodex-koodit
Elintarvikenäytteille (myös elintarvikelain mukaiset pintapuhtaus- ja materiaalinäytteet) on annettava foodex-koodi. Koodin tulee olla voimassa Foodex2-koodistossa.
Yksiköt
Rajapinta hyväksyy vain analyysikoodistossa analyysikoodeihin liittyvät tulosyksiköt. Kirjoitusasulla voi olla myös merkitystä, esimerkiksi kirjoitusasu MPN/100ml ei mennyt tiedonsiirrossa läpi, mutta kirjoitustapa mpn/100ml korjasi asian.
Ohjeet ja lisätietoa
Ohje uuden rajapinnan käyttöön on julkaistu laboratorioiden Pikantti-tilassa. Oikeuksia Pikantti-sivulle voi pyytää osoitteesta laboratoriot(at)ruokavirasto.fi
Vatiin ja sen rajapintojen ongelmiin liittyviä virhetilanteita, käyttäjien kysymyksiä ja muita ilmoituksia käsitellään Vatin käytön tuessa, jonne pääsee Pikantin kautta. Vatin käytön tuessa on oma kohta "Analyysitietojen siirtopalvelu", joka kannattaa valita tukipyyntöä tehdessä. Virhetilanteisiin liittyvissä yhteydenotoissa on tärkeää liittää tukipyyntöön analyysitiedonsiirron rajapinnan palauttama virhetunniste.
Lisätietoja: Lotta Kivikoski, Valvira, etunimi.sukunimi(at)valvira.fi