Anvisningar för Kodtjänsten – Distributionsplattformar

Alla som vill kan använda Kodservern fritt.

Bläddringsanvändare är alla användare som inte loggar in i systemet. De kan bläddra i de olika dataspecifikationerna eller enskilda koder samt ladda ner publicerade dataspecifikationer och klassifikationer i Excel-, text- eller XML-format till sin egen enhet.

Kodserverns startsida listar alla gällande dataspecifikationer som finns tillgängliga på Kodservern. En mer detaljerad sökning, till exempel efter en enskild dataspecifikation, kan göras med hjälp av kodserverns sökfunktioner.

• Anvisningar för hur man bläddrar i kodsystem finns på kodservern under knappen "Hjälp"
  Kodservern
• Koder inom en enskild dataspecifikation kan sökas genom att vid den aktuella versionen välja "Avancerad sökning". Även i detta sammanhang finns det mer vägledning om sökningar under knappen "Hjälp".

Informationssystemen uppdaterar sina dataspecifikationer genom att använda kodserverns REST- eller Web Services-gränssnitt eller genom att hämta filpublikationer.

Sätt att hämta dataspecifikationer:

• Webbgränssnitt, förfrågan
• REST, förfrågan/uppdatering
• Web Services, förfrågan
• Filer (publikationer), förfrågan

Den tekniska driften av Kodservern ansvaras av FPA.

Ansvariga aktörer och kontaktuppgifter för den tekniska driften av den nationella Kodtjänsten, servicetider samt övriga frågor som gäller tillhandahållandet av tjänsten beskrivs i följande dokument:
Kanta-tjänster. Nationella kodtjänsten – tjänstebeskrivning version 1.15 (på finska)

Anvisningar för datasystemutvecklare om de grundläggande principerna för anslutning till den nationella Kodtjänsten, anslutningsuppgifter samt stöd för testning och problemsituationer finns i följande anvisning:
Den nationella kodtjänstens gränssnitt samt anslutningsanvisning (Kanta)

Den specifikation som publicerats av HL7 Finland innehåller tekniska anvisningar för dataöverföring i kodtjänsten samt XML-gränssnittsspecifikationer för överföring och förfrågning av kodsystem:
Teknisk anvisning för dataöverföring i Kodtjänsten v. 2.2, 2014 (på finska, HL7 Finland)

Ny dataspecifikation

Som grund för strukturen för en ny dataspecifikation kan du använda Excel-filen av en publicerad dataspecifikation vars struktur i möjligaste mån motsvarar ditt behov. Hämta Excel-filen från Kodservern via fliken "Publikationer” vid den dataspecifikation som är lämplig.

Vid beredningen av dataspecifikationens struktur är följande datafält obligatoriska: kodens identifierare (CodeId), förkortning (Abbreviation), långt namn på finska (LongName) och dess svenska översättning (LångtNamn), kort namn (ShortName), giltighet börjar (BeginningDate) och giltighet upphör (ExpiringDate).

Vid behov läggs följande datafält till: kodens beskrivning (Description) på finska och dess svenska översättning (Beskrivning) samt i hierarkiska klassifikationer den överordnade koden för varje kod (ParentId). Frivilliga datafält kan läggas till enligt behov.

Dataspecifikation som uppdateras

Som grund för en dataspecifikation som ska uppdateras ska den senaste Excel-publikationen för just den dataspecifikationen hämtas från kodservern.

Vid beredningen av strukturen för en dataspecifikation som uppdateras är det viktigt att tydligt markera de celler som ändras, till exempel genom färgmarkering.

Skapa tre flikar i Excel-filen:

• Nya: koder som införs som nya
• Ändrade: koder där någon uppgift ändras
• Avslutade: koder vars giltighet avslutas

Dataspecifikationens struktur beror på typen av specifikation. Till exempel har följande delvis olika strukturer:

• Klassifikation och tekniska kodsystem
• Klassifikation av organisationstyper
• Specifikation av informationsinnehåll
• Formulärstruktur
• Test- och mätstruktur
• Värdemängd

Mer information om principerna för utformning av dataspecifikationens struktur:
Tekniska principer för utarbetande av kodsystem i Kodtjänsten för social- och hälsovården – Teknisk anvisning för beredare (på finska, Julkari)

För mer information kan du kontakta experterna vid Kodtjänsten per e-post: koodistopalvelu(snabel-a)thl.fi

Till Kodtjänstens lagstadgade verksamhet hör även terminologiskt arbete, genom vilket man säkerställer språklig korrekthet i olika dataspecifikationer, innehållsmässig enhetlighet samt användning av gemensamma begrepp och termer.

När du bereder en ny dataspecifikation eller uppdaterar en befintlig, ska du också ta del av anvisningen Språkliga och terminologiska principer för utarbetande av dataspecifikationer (endast på finska).

THL har publicerat en anvisning om språklig och terminologisk kvalitetssäkring för beredare och expertgrupper som ansvarar för dataspecifikationer. Anvisningen kan även användas av experter som arbetar inom Kodtjänsten samt av andra sakkunniga som deltar i processerna kring hantering av specifikationer.

Användare och tillämpare av dataspecifikationer får genom anvisningen grundläggande information som hjälper till att tolka specifikationernas användningsändamål och användningen av enskilda koder.

Språkliga och terminologiska principer för utarbetande av dataspecifikationer i Kodtjänsten för social- och hälsovården. Anvisningar för beredare och expertgrupper 11/2025 (på finska, Yhteistyötilat)

Informationsinnehåll publiceras i Termeta som dokumentstrukturer och datakomponenter. 

De specifikationer av informationsinnehåll för hälso- och sjukvården som tidigare publicerats i kodservern överförs stegvis till Termeta. Överföringen görs i mån av möjlighet i samband med nästa uppdatering av respektive informationsinnehåll. Klassifikationer och tekniska kodsystem kommer även i fortsättningen att finnas på Kodservern.

I Termeta kan du ta del av dokumentstrukturer och datakomponenter samt ge respons på dem. Du kan söka dokumentstrukturer och datakomponenter enligt olika sökgrupperingar eller utifrån strukturens namn. Du kan också ladda ner strukturerna som Excel-filer eller som maskinläsbara filer i JSON-format.

Utifrån uppgifterna i Termeta producerar FPA de tekniska specifikationer (CDA/FHIR) som används vid lagring i Kanta-tjänsterna och publicerar dem på webbplatsen Kanta.fi.

Mer detaljerade anvisningar för användningen av Termeta finns i följande utbildningsmaterial:

• Termeta-utbildning för användare av datastrukturer (på finska, Julkari)
• Termeta-utbildning för användare av datastrukturer - videoinspelning 30.1.2023 (på finska, Youtube)

Kontaktuppgifter: sotetiedonhallinta(snabel-a)thl.fi

I Sosmeta-tjänsten visas strukturerna för alla de klienthandlingar som är avsedda att användas nationellt när organisationerna ansluter sig till Kanta-tjänsterna och börjar lagra strukturerade klienthandlingar i Klientdatabasen för socialvården.

I Sosmeta-tjänsten presenteras klienthandlingsstrukturerna, deras kontextuppgifter samt de datakomponenter som utnyttjas i strukturerna. Sosmeta-tjänsten innehåller också uppgifter om ändringshistorik för klienthandlingsstrukturerna och kontextuppgifterna samt information om kommande ändringar.

Via Sosmeta-tjänsten kan man även ta del av Ordlista för informationshantering inom socialvården.

På Sosmetas startsida kan du granska klienthandlingsstrukturer, enskilda datakomponenter samt Ordlista för informationshantering inom socialvården. Via startsidan kan du också ge respons på datastrukturerna.

Anvisningar för användning av Sosmeta-tjänsten och för tolkning av klienthandlingar finns i Handbok om Kanta-tjänsterna för aktörer inom socialvården (kapitel 10).

Handbok om Kanta-tjänsterna för aktörer inom socialvården (Yhteistyötilat)

Kontaktuppgifter: sotetiedonhallinta(snabel-a)thl.fi