Anslutning av applikationen till hälsoappars gränssnitt

Applikationer och digitala ärendehanteringstjänster kan hämta patientuppgifter från Kanta när de är anslutna till hälsoappars gränssnitt.

Anslutningen av applikationen till gränssnittet sker stegvis och tar uppskattningsvis cirka 2-3 månader.

Applikationerna måste ha en bakgrundstjänst som fungerar i en betrodd miljö. Bakgrundstjänsten hanterar kommunikationen med gränssnittet.

Meddela om ändringar i hälsoappen

Ta del av Institutet för hälsa och välfärds föreskrifter (thl.fi)(öppnas i ett nytt fönster) vid utvecklandet av hälsoappar:

  • THL:s föreskrift 4/2025
  • THL:s föreskrift 5/2024
  • Profilen Hälsoapp som använder kunduppgifter.

Läs också

Här hittar du hjälp för att använda gränssnittet:

Anmäl dig till kundtestmiljön genom att skicka följande blanketter till Kanta-tjänsterna:

Skicka blanketterna per e-post till kanta@kanta.fi.

Efter att FPA har godkänt din ansökan, ansök om ett testservercertifikat hos Myndigheten för digitalisering och befolkningsdata (MDB).

  • Serverbaserade applikationer behöver för kundtestmiljön och för samtestning ett testservicecertifikat för hälsoappar från MDB.
  • Du kan ansöka om ett testservicecertifikat först när applikationen är godkänd för kundtestmiljön och FPA har gett applikationsleverantören en applikationsspecifik organisations-OID.
  • Vi på FPA skickar separat närmare anvisningar om hur du ansöker om ett certifikat.
  • Servicecertifikatet och applikationen kopplas till varandra med OID-koden i fältet serialNumber under Subject i servicecertifikatet.
    • OID-koden är en unik OID-kod som systemleverantören ansöker om för applikationen.
Läs mer om kundrelationen och kundtestmiljön.

Certifieringen av hälsoappen omfattar en samtestning mot Kanta-tjänsterna, en bedömning av informationssäkerheten som utförs av ett bedömningsorgan godkänt av Traficom och registrering av applikationen i Valviras register.

Läs mer om certifiering och väsentliga krav

De funktioner som krävs beskrivs i THL:s föreskrift 5/2024 bilaga 3h (thl.fi)(öppnas i ett nytt fönster).

Med samtestning avses verifiering av applikationens interna testning och dess funktion mot Kanta-tjänsternas kundtestmiljö. Samtestningen är avsedd för att testa slutfasen i utvecklingsarbetet.

Läs mer om samtestningsprocessen

Applikationsleverantören ansvarar för att övrig testning av applikationen görs i tillräcklig omfattning och på en kvalitativt god nivå.

Parter och ansvar vid samtestning

Anmäl dig till samtestningen genom att skicka anmälningsblanketten till tjänsten Hälsoappars gränssnitt till patientuppgifter till FPA. Skicka blanketten med e-post till kanta@kanta.fi(öppnas i ett nytt fönster).

Hälsoappar ska genomgå en bedömning av informationssäkerheten som görs av ett bedömningsorgan som Traficom godkänt.

Läs mer om bedömningen av informationssäkerhet
  1. Anmäl hälsoappen till Valviras register över informationssystem (valvira.fi)(öppnas i ett nytt fönster). Försäkra dig om att hälsoappen efter registreringen finns i Valviras register Astori(öppnas i ett nytt fönster). 
  2. Anmäl behov av att inleda produktionsanvändning till FPA (kanta@kanta.fi). FPA skickar de dokument som behövs för teknisk registrering av tjänsten (steg 4 och 5) till leverantören och meddelar uppgiften om produktionsberedskap till applikationsregistret i THL:s Kodtjänst.
  3. Skaffa MDB:s servercertifikat för produktion (mdb.fi)(öppnas i ett nytt fönster).
    • Serverbaserade applikationer behöver för produktionen ett servicecertifikat för hälsoappar från MDB.
    • Servicecertifikatet och applikationen kopplas till varandra med OID-koden i fältet serialNumber under Subject i servercertifikatet.
    • Hälsoappens bakomliggande system, det vill säga, systemleverantörens serverapp på servern, ansluts till Kanta-tjänsterna. Tjänstens IP-adresser ska vara fasta och höra till den offentliga IP-adressrymden.
    • Hälsoapparnas datakommunikation till Kanta-tjänsterna går via öppna internet.
  4.  Godkänn leveransvillkoren och tjänstebeskrivningen för hälsoappars gränssnitt genom att underteckna förbindelsedokumentet och skicka det till FPA.
  5. Meddela FPA (kanta@kanta.fi) uppgifterna om den applikation som ska publiceras med det blankettdokument som är avsett för anmälan av uppgifterna. FPA skickar en anmälan om godkännande som användare av tjänsten och meddelar applikationsleverantören de tekniska uppgifter som behövs för produktionsanvändning.
    • Applikationen registreras tekniskt i Kanta-tjänsterna i gränssnittstjänsten. Förutsättningen för teknisk registrering är att hälsoappen har publicerats i Valviras register.
    • Applikationen läggs till i applikationsförteckningen på webbplatsen kanta.fi två veckor efter den tekniska registreringen.
  6. Säkerställ att produktionen fungerar och meddela FPA (kanta@kanta.fi) att anslutningen fungerar. Efter det kan du inleda produktionsanvändningen av applikationen.

Anmäl fel och störningar som du upptäcker i hälsoappen eller gränssnitten till FPA (kanta@kanta.fi). För att ett fel ska kunna redas ut ska du till anmälan bifoga hämtnings- och svarsmeddelandena med Access Token och personbeteckningen anonymiserade. Skicka bägge meddelandena i sin helhet (header och body).

I fortsättningen får du inte använda de testpersonbeteckningar som använts vid samtestningen i dina egna tester.

De som använder applikationen kan ta emot sina patientuppgifter i hälsoappen genom att ge applikationen användarrätt till sina patientuppgifter och genom att godkänna informationen om att ta emot patientuppgifter i en hälsoapp (pdf)(öppnas i ett nytt fönster).

Meddela om ändringar genom att skicka en blankett för ändringsanmälan per e-post till kanta@kanta.fi.