Informationsspecifikation TS Diabetes v.2.x - nytt intygsformat
Revisionshistorik
Version | Datum | Kommentar |
|---|---|---|
0.9 | 2016-03-16 | Dokumentet skapat. |
0.91 | 2016-06-21 | Ändrat så att inga delsvar med svarstypen boolean har fasta värden. |
1.0 | 2016-11-22 | Uppdaterat inledningen med information om målgrupp och syfte med denna informationsspecifikation. Uppdaterat kapitlet "Struktur för överföring av intyget" med information om syftet med modellen och hur kardinaliteterna ska utläsas. Bytt kod för attributet Intyg.typ från "TSTRK1031 (U06, V02)" (som utgår ur kodverk KV utlåtandetyp intyg) till "TSTRK1031". Uppdaterat beskrivningen för attributet Intyg.version. |
1.0.1 | 2017-06-15 | Lagt till avsnittet "Referenser". Uppdaterat referenser till domänens informationsspecifikation och kodverks- och identifikationsdokument så de inte pekar ut någon speciell version för att slippa uppdatera versionsnr på domänen i detta dokument. Lagt till referens till kodverksdokument för svarsalternativ i intyg. Tagit bort avsnittet exempelmeddelande eftersom vi inte har något exempelmeddelande i dagsläget. Om vi skaffar det kan vi skicka med det utan att skriva om det i detta dokument. |
1.0.2 | 2019-01-25 | Genomfört dokumentationsuppdatering:
|
Referenser
ID | Dokument | Kommentar |
|---|---|---|
Ref1 | IS_clinicalprocess_healthcond_certificate | Informationsspecifikation för tjänstedomänen Intygshantering. Kan laddas ner i releasepaket från http://rivta.se/domains/clinicalprocess_healthcond_certificate.html. |
Ref2 | Kodverk för intyget | Kodverk och identifierare som används i intyget. Finns publicerade på https://riv-ta.atlassian.net/wiki/spaces/KINT/pages/270532953/Kodverk+i+nationella+tj+nsteplattformen |
Ref3 | Kodverk i nationella tjänsteplattformen | Kodverk och identifierare som används i tjänstedomänen Intygshantering finns publicerade på https://riv-ta.atlassian.net/wiki/spaces/KINT/pages/270532953/Kodverk+i+nationella+tj+nsteplattformen |
Inledning
Denna informationsspecifikation avser Transportstyrelsens intyg med namnet ”Läkarintyg Diabetes avseende lämpligheten att inneha körkort m.m.” (TSTRK1031) version 2.6 och 2.8.
Informationsspecifikationen är riktad till leverantörer av journalsystem som integrerar med intygsapplikationen Webcert. Syftet är att beskriva hur ett intyg av typen TSTRK1031 hanteras på det intygsformat som används i domäninformationsmodellen för domänen clinicalprocess:healthcond:certificate version 2.0 och högre, så att journalsystemet vet på vilket format intyget kommuniceras till journalsystemet vid t.ex. statusuppdateringar i Webcert.
Som komplement till det här dokumentet publiceras också:
ett exempel på hur intyget ser ut i XML format
den XML-fil med texter som används för intyget
ett exempel på hur intyget ser ut om det skrivs ut från något av Intygstjänsters system
Alla dessa filer nås på denna länk: Bilagor till TS-diabetes v.2.x
Användningsfall
Användningsfall är generella för hela intygsdomänen oavsett intygsmottagare och beskrivs i domänens informationsspecifikation [Ref1].
Informationssäkerhet
För en komplett beskrivning av informationssäkerhetsaspekter för intyget läses motsvarande kapitel i [Ref1] tillsammans med informationen nedan.
Beskrivning av informationen | |
|---|---|
Översiktlig beskrivning av informationen | Intyget TSTRK1031 avser lämpligheten att inneha körkort för en person som har diabetes. Intyget hanterar personuppgifter och patientdata. När ett intyg av typen TSTRK1031 utfärdas så sparas originalintyget i Webcert (eller annat journalsystem) och en kopia av detta lagras i Intygstjänsten. Informationsinnehållet i intyget beskrivs djupare i kapitlet Informationsmodell. |
Innehåller informationen personuppgifter? | Ja. |
Innehåller informationen känsliga personuppgifter, exempelvis patientuppgifter? | Ja. |
Finns informationsmängder som kräver särskilt hantering och hur ska den ske? | Nej |
Lagrum | |
|---|---|
Har en juridisk analys/rättsutredning gjorts? | Se [Ref1] |
Vilka lagrum reglerar hur informationen får hanteras? | Se [Ref1] |
Vilka specifika lagkrav har identifierats? | Se [Ref1] |
Informationsflöde | |
|---|---|
Hur/mellan vilka parter kommer informationen att flöda? | Information kommer skickas från vårdgivare till Transportstyrelsen samt tillgängliggöras för invånaren i Mina intyg. |
Hanteras överföring av uppgifter (utlämnande) , direktåtkomst (sammanhållen journalföring) och/eller individens direktåtkomst? | Mellan vården och myndigheten sker ett utlämnande. Invånarens åtkomst via Mina intyg sker via individens direktåtkomst. |
Spårbarhet, tillgänglighet och arkivering | |
|---|---|
Vilka krav finns på spårbarhet (loggning)? | Se [Ref1] |
Finns det uttalade krav från verksamheten gällande tillgänglighet? | Nej |
Finns krav på arkivering? | Se [Ref1] |
Krav på den som konsumerar informationen | |
|---|---|
Vilka åtgärder krävs av den part som ansluter till tjänsten i egenskap av informationskonsument? | Se [Ref1] |
Struktur för överföring av intyget
Domäninformationsmodell
Domäninformationsmodellen, som meddelandeinformationsmodellen i nästa avsnitt bygger på, beskrivs i domänens informationsspecifikation [Ref1].
Verksamhetsorienterad meddelandeinformationsmodell (V-MIM)
Meddelandemodellen nedan är en direkt tillämpning av domäninformationsmodellen för intygshantering. Syftet med modellen är att visa hur domäninformationsmodellen ska tillämpas när ett intyg ska överföras från Webcert till ett mottagande system.
Kardinaliteterna som anges gäller för ett komplett ifyllt (enligt Transportstyrelsens regler) och signerat intyg. Då ett intygsutkast som inte är komplett och/eller signerat kommuniceras kan vissa klasser eller attribut saknas.
Beskrivning av klasser och attribut
Vårdgivare, Enhet, HoS-Personal, Patient och Intyg
För information om informationsinnehållet i klasserna Vårdgivare, Enhet, HoS-Personal, Patient och Intyg samt klassernas attribut se domänens informationsspecifikation [Ref1].
I tabellen nedan sammanställs viktiga detaljer för de gemensamma klasserna för just detta intyg.
Namn på informationsklass | Kommentar |
|---|---|
Vårdgivare | Enligt infospec och TKB |
Enhet | Det icke-obligatoriska attributet e-post används i de fall där enheten har en adress registrerad i HSA. |
HoS-Personal | De icke-obligatoriska attributen befattning och specialistkompetens används i de fall där användaren har dessa registrerade i HSA. Attributet legitimerat yrke används inte i intyget. |
Patient | Personnummer, namn och adressuppgifter sparas i intyget. |
Intyg | intygstyp = TSTRK1031 codesystem = f6fb361a-e31d-48b8-8657-99b63912dd9b version = 2.x |
Metadata
Dessutom kan ett intyg ha metadata i form av klassen Status (markerade i orange i modellen nedan). Även dessa klasser beskrivs i detalj i domäninformationsspecifikationen [Ref1].
Svar
Samtliga instanser av klassen Svar utelämnas från denna beskrivning av klasser och attribut, då de bara innehåller information som framgår av bilden av informationsmodellen ovan.
Attributet instans anger instansnummer och används då en och samma fråga kan besvaras med fler än ett svar. Instansnummer räknas upp från och med 1.
Intyget avser behörighet (Delsvar)
Klassen håller information om vilken/vilka behörigheter som intyget avser.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 1.1 |
värde | Värde på det svar som angetts i intyget. | CD.CV | 1 | KV intyget avser Urval: [IAV1-IAV9, IAV11-IAV17] |
Identitet styrkt genom (Delsvar)
Klassen håller information om hur patienten har styrkt sin identitet.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 2.1 |
värde | Värde på det svar som angetts i intyget. | CD.CV | 1 | KV id kontroll Urval: [IDK1-IDK6] |
År då diabetesdiagnosen ställdes (Delsvar)
Klassen håller information om vilket år som diagnosen diabetes mellitus ställdes.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 35.1 |
värde | Värde på det svar som angetts i intyget. | TS.DATE | 1 | Årtal på formatet YYYY. |
Typ av diabetes (Delsvar)
Klassen håller information om vilken typ (typ 1 eller typ 2) av diabetes mellitus patienten har.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 18.1 |
värde | Värde på det svar som angetts i intyget. | CD.CV | 1 | ICD-10-SE Urval: [E10, E11] |
Kostbehandling (Delsvar)
Klassen håller information om huruvida patienten behandlas med enbart kost för sin diabetes.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 19.1 |
värde | Värde på det svar som angetts i intyget. | BL | 1 |
Tablettbehandling (Delsvar)
Klassen håller information om huruvida patienten behandlas med tabletter för sin diabetes.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 19.2 |
värde | Värde på det svar som angetts i intyget. | BL | 1 |
Insulinbehandling (Delsvar)
Klassen håller information om huruvida patienten behandlas med insulin för sin diabetes.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 19.3 |
värde | Värde på det svar som angetts i intyget. | BL | 1 |
Insulinbehandling sedan år (Delsvar)
Klassen håller information om huruvida patienten behandlas med insulin för sin diabetes.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 19.4 |
värde | Värde på det svar som angetts i intyget. | TS.DATE | 1 | Årtal på formatet YYYY. |
Annan behandling (Delsvar)
Klassen håller information om vilken typ av annan behandling som patienten har för sin diabetes.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 19.5 |
värde | Värde på det svar som angetts i intyget. | ST | 1 |
Kunskap om lämpliga åtgärder vid hypoglykemi (Delsvar)
Klassen håller information om huruvida patienten har kunskap om lämpliga åtgärder vid hypoglykemi.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 36.1 |
värde | Värde på det svar som angetts i intyget. | BL | 1 |
Förekomst av hypoglykemier med tecken på nedsatt hjärnfunktion som kan innebära en trafiksäkerhetsrisk (Delsvar)
Klassen håller information om huruvida det hos patienten förkommer hypoglykemier med tecken på nedsatt hjärnfunktion (neroglukopena symptom).
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 37.1 |
värde | Värde på det svar som angetts i intyget. | BL | 1 |
Saknar förmåga att känna varningstecken (Delsvar)
Klassen håller information om huruvida patienten saknar förmåga att känna varningstecken på hypoglykemi (”unawareness”).
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 38.1 |
värde | Värde på det svar som angetts i intyget. | BL | 1 |
Förekomst av allvarlig hypoglykemi under det senaste året (Delsvar)
Klassen håller information om huruvida det hos patienten har förekommit allvarlig hypoglykemi (som krävt hjälp av annan för att hävas) under det senaste året.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 39.1 |
värde | Värde på det svar som angetts i intyget. | BL | 1 |
Antal episoder av allvarlig hypoglykemi under det senaste året (Delsvar)
Klassen håller information om antal episoder av allvarlig hypoglykemi (som krävt hjälp av annan för att hävas) som patienten haft under det senaste året.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 39.2 |
värde | Värde på det svar som angetts i intyget. | ST | 1 |
Förekomst av allvarlig hypoglykemi i trafiken under det senaste året (Delsvar)
Klassen håller information om huruvida det hos patienten har förekommit allvarlig hypoglykemi i trafiken under det senast året.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 40.1 |
värde | Värde på det svar som angetts i intyget. | BL | 1 |
Antal episoder och tidpunkt för allvarlig hypoglykemi i trafiken under det senaste året (Delsvar)
Klassen håller information om antal episoder av allvarlig hypoglykemi (som krävt hjälp av annan för att hävas) som patienten haft i trafiken under det senaste året och när de inträffade.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 40.2 |
värde | Värde på det svar som angetts i intyget. | ST | 1 |
Egenkontroller av blodsocker (Delsvar)
Klassen håller information om huruvida patienten utför egenövervakning av blodklukos.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 41.1 |
värde | Värde på det svar som angetts i intyget. | BL | 1 |
Förekomst av allvarlig hypoglykemi under vaken tid det senaste året (Delsvar)
Klassen håller information om huruvida det hos patienten har förekommit allvarlig hypoglykemi (som krävt hjälp av annan för att hävas) under vaken tid det senaste året.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 42.1 |
värde | Värde på det svar som angetts i intyget. | BL | 1 |
Tidpunkt för allvarlig hypoglykemi under det senaste året (Delsvar)
Klassen håller information om när patienten haft allvarlig hypoglykemi (som krävt hjälp av annan för att hävas) under vaken tid det senaste året.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 42.2 |
värde | Värde på det svar som angetts i intyget. | TS.DATE.FULL | 1 |
Ögonläkarintyg skickas in separat (Delsvar)
Klassen håller information om huruvida ögonläkarintyg skickas in separat.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 43.1 |
värde | Värde på det svar som angetts i intyget. | BL | 1 |
Synfältsprövning enligt Donder utan anmärkning (Delsvar)
Klassen håller information om huruvida patientens synfältsprövning är utan anmärkning.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 44.1 |
värde | Värde på det svar som angetts i intyget. | BL | 1 |
Höger öga utan korrektion (Delsvar)
Klassen håller information om patientens synskärpa på höger öga utan korrektion.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 8.1 |
värde | Värde på det svar som angetts i intyget. | REAL | 1 |
Vänster öga utan korrektion (Delsvar)
Klassen håller information om patientens synskärpa på vänster öga utan korrektion.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 8.2 |
värde | Värde på det svar som angetts i intyget. | REAL | 1 |
Binokulärt utan korrektion (Delsvar)
Klassen håller information om patientens synskärpa binokulärt (på både vänster och höger öga) utan korrektion.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 8.3 |
värde | Värde på det svar som angetts i intyget. | REAL | 1 |
Höger öga med korrektion (Delsvar)
Klassen håller information om patientens synskärpa på höger öga med korrektion.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 8.4 |
värde | Värde på det svar som angetts i intyget. | REAL | 1 |
Vänster öga med korrektion (Delsvar)
Klassen håller information om patientens synskärpa på vänster öga med korrektion.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 8.5 |
värde | Värde på det svar som angetts i intyget. | REAL | 1 |
Binokulärt med korrektion (Delsvar)
Klassen håller information om patientens synskärpa binokulärt (på både vänster och höger öga) med korrektion.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 8.6 |
värde | Värde på det svar som angetts i intyget. | REAL | 1 |
Dubbelseende (Delsvar)
Klassen håller information om huruvida det hos patienten förekommer dubbelseende.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 6.1 |
värde | Värde på det svar som angetts i intyget. | BL | 1 |
Uppfyller krav för behörighet (Delsvar)
Klassen håller information om de körkortsbehörigheter som intygsutfärdaren bedömer att patienten uppfyller kraven (enligt Transportstyrelsens föreskrifter och allmänna råd om medicinska krav för innehav av körkort m.m.) för.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 33.1 |
värde | Värde på det svar som angetts i intyget. | CD.CV | 1 | KV körkortsbehörighet Urval: [VAR1-VAR9, VAR11-VAR18] |
Lämplig att inneha behörighet med hänsyn till aktuella körningar och arbetsformer (Delsvar)
Klassen håller huruvida intygsutfärdaren bedömer att patienten är lämplig att inneha specificerad behörighet med hänsyn till de körningar och arbetsformer som är aktuella vid sådana innehav.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 45.1 |
värde | Värde på det svar som angetts i intyget. | BL | 1 |
Övriga kommentarer (Delsvar)
Klassen håller information om övriga kommentarer som är relevanta att tillföra utlåtandet.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 32.1 |
värde | Värde på det svar som angetts i intyget. | ST | 1 |
Bör undersökas av specialistläkare (Delsvar)
Klassen håller information om den specialistläkarkompetens som intygsutfärdaren bedömer att patienten bör undersökas av före ärendets avgörande.
Attribut | Beskrivning | Format | Mult | Kodverk/värdemängd |
|---|---|---|---|---|
delfråge-id | Identitetsbeteckning för delfrågan som delfrågan som besvaras. | ST | 1 | Fixt värde: 34.1 |
värde | Värde på det svar som angetts i intyget. | ST | 1 |
Validering av innehåll
Validering av att innehållet uppfyller Transportstyrelsens krav sker i Intygstjänsten innan det kommuniceras till det integrerande journalsystemet.
Förklaring av datatyper
Datatyperna nedan följer ISO-standarden 21090:2011 Hälso- och sjukvårdsinformatik – Harmoniserade datatyper för informationsutbyte om inte annat anges.
Förkortning | Benämning | Beskrivning |
|---|---|---|
BL.NONNULL | Datatyp som kan anta värdena True eller False. Kan dock aldrig vara NULL. | Motsvarar i XML: boolean |
REAL | Datatyp som håller tal med decimal noggrannhet. | Motsvarar i XML: decimal |
För en beskrivning av resterande datatyper som används i meddelandeinformationsmodellen se domänens informationsspecifikation [R1].
Kodverk och identifierare
Kodverk som används för olika svarsalternativ i intyget beskrivs i kodverksdokumentet för intyg [Ref2].
Övriga kodverk och identifierare som hanteras i informationsutbytet beskrivs i domänens kodverks- och identifikationsdokument [Ref3].