Överföringstjänsten för av analysuppgifter är avsedd för överföring av uppgifter om provet samt analysresultat från laboratoriernas informationssystem till system som använder analysuppgifterna, såsom datasystemet Vati. Det nya gränssnittet för analysdataöverföring, dvs. Analys-API, har tagits i bruk den 24 september 2025. Det nya gränssnittet använder nyare teknik och förbättrar analysöverföringens användbarhet och kvaliteten på informationens kvalitet.
Övergångsperiod
Det gamla gränssnittet för att lämna in provuppgifter till Vati används fram till den 30 april 2026. Fram till detta kan laboratorierna skicka materialet antingen via det gamla gränssnittet eller via det nya Analys-API. Det gamla gränssnittet tas ur bruk den 30 april 2026, och då ska det nya gränssnittet ska vara i bruk.
Tjänsten för överföring av analysuppgifter består under övergångsperioden av två applikationsdelar:
- Analys-API (ny applikation): HTTP-REST-gränssnitt. Kan användas från september 2025.
- Överföring av analyser (gammal applikation): SOAP-gränssnitt. Kan användas fram till april 2026. Förmedlar meddelandet till det nya API-gränssnittet, och därför motsvarar det informationsinnehåll som det gamla gränssnittet tidigare godkänt inte nödvändigtvis de nya kraven på informationsinnehåll.
Certifikat
De laboratorier som har ett giltigt certifikat till överföringstjänsten för analysuppgifter har fått en ny användarrättighet som ger tillgång till Analys-API. De laboratorier som har en certifikatkod som består av registrering i gammal form behöver dock ansöka om ett nytt certifikat under slutet av 2025 även om certifikatet är i kraft. De nya certifikatkoderna slutar på @ruokavirasto.fi.
Ansökan om certifikat sker på samma sätt som tidigare, anvisningen finns på Livsmedelsverkets webbplats.
Att konvertera och validera uppgifter
De uppgifter som laboratorierna har levererat till det nuvarande gränssnittet har konverterats till ett format som det nya gränssnittet godkänner. Detta gäller material som levererats inom de senaste två månaderna från konverteringen (dvs. 24.9.2025). Äldre material än detta används inte längre i gränssnittet.
Ändringar i kraven på material redan nu
Material som skickats till det gamla gränssnittet konverteras automatiskt till ett format som godkänts av det nya gränssnittet Analys-API. Detta ställer redan nu en del nya krav på materialet.
Materialets beteckningar
Materialets beteckningar har blivit kortare. Tidigare har en beteckning i storleksklassen 600 000 returnerats efter en lyckad registrering. För närvarande returneras materialets beteckningar i storleksklassen 5 000.
Identifikationsuppgifter
Alla prover ska ha identifieringsuppgifter med hjälp av vilka provet kan identifieras och riktas rätt i Vati. Alla prover ska ha någon numerisk identifikationsuppgift (verksamhetsställets kod, objektets beteckning eller beteckning för provtagningsstället), provtagningsplatsens adress eller provtagningsställets koordinater. Om alla identifikationsuppgifter saknas kan materialet inte skickas.
Sökning av analyser
Det går inte längre att söka analyser med namn. Analyskoden hämtas antingen med analyskodens kod (fältet "Id"/”Tunnus” i kodsystemet) eller med analyskodens värde (fältet "Värde"/”Arvo” i kodsystemet). Analysen kan inte längre skickas med variabelns namn, till exempel "ODOUR".
Värdetyper för analyskoderna
Resultatvärdets form ska motsvara analyskodens typ, dvs. fältet "Värdetyp" i analyskodsystemet. Värdetypen kan vara av typen siffra, text eller konstaterad.
När värdetypen är siffra kan även resultatet endast vara en siffra. I stället för noll (0) får ett streck (-) inte användas. Det maximala antalet tecken i en siffra är 12.
När värdetypen har konstaterats kan man endast välja "konstaterad"/”todettu” eller "ej konstaterad"/”ei todettu”.
När värdetypen är text ska även resultatet vara en textbeskrivning. Texten kan vara högst 50 tecken lång. Värdet i textform får inte bestå av enbart siffror.
OBS! För prover enligt hälsoskyddslagen godkänns endast en värdetyp, om analyskoden innehåller flera värdetyper.
Provtagningstidpunkt
Provtagningens datum och klockslag är obligatoriska. Provtagningstiden ska skickas i ISO 8601-format (YYYY-MM-DDTHH:MM:SS). Tiden kan inte vara i framtiden.
Foodex-koder
Livsmedelsprover (även ytrenhets- och materialprover enligt livsmedelslagen) ska ges en Foodex-kod. Koden ska vara giltig i Foodex2-kodsystemet.
Enheter
Gränssnittet godkänner endast de resultatenheter som är kopplade till analyskoderna i analyskodsystemet. Formuleringen kan också ha betydelse, till exempel godkändes inte skrivsättet MPN/100ml i dataöverföringen, men skrivsättet mpn/100ml rättade till saken.
Anvisningar och mer information
Anvisningen för användning av det nya gränssnittet har publicerats i Pikantti för laboratorierna. Rättigheter till sidan Pikantti kan begäras på laboratorium(at)ruokavirasto.fi
Problem med Vati och dess gränssnitt, frågor av användarna och andra meddelanden behandlas i stödet för användningen av Vati, dit man kommer via Pikantti. Stödet för användning av Vati har en egen punkt "Överföringstjänsten för av analysuppgifter", som det lönar sig att välja när man gör en stödbegäran. I meddelanden i anslutning till felsituationer är det viktigt att bifoga den felkod som analytiska dataöverföringens gränssnitt returnerar till stödbegäran.
Mer information: Lotta Kivikoski, Valvira, fornamn.efternamn(at)valvira.fi