Referansedokument meldingsimplementering

Transkript

1 Tema: Revisjonshistorikk Dato Kommentar Ansvarlig Publisert AA Dette notatet inngår i en samling av referansedokumenter som inneholder generelle råd, tips og veiledning til bruk og implementering av ML-meldinger i helsevesenet. Dette notatet viser konkrete ML-eksempler på hvordan organisasjon og person kan oppgis i Helsetjenesteenhet. Notatet inneholder også generelle retningslinjer for anbefalt og påkrevd innhold, avhengig av spesialiseringen. Eksemplene benytter testaktører som er beskrevet i notatet Testaktører som ligger under Test- og godkjenning/testmateriale på 1. Generelle retningslinjer og krav Helsetjenesteenhet benyttes i mange ulike meldinger og med ulike roller. Figuren under viser ulike spesialiseringer av HTErolle og innholdet i Helsetjenesteenhet med UMLnotasjon i følgende meldinger: Henvisning (KITH R17/05) Epikrise (KITH R26/02 og endringsnotat for v1.1) Tilbakemelding på henvisning (KITH R26/03) Svarrapportering av medisinske tjenester (KITH R11/05) Rekvirering av medisinske tjenester (KITH R13/05) Tabellen i neste avsnitt inneholder dokumentasjon av de enkelte ML-elementene og viser hvilke spesialiseringer som forekommer i de ulike meldingene. Detaljeringsnivået på innholdet i Helsetjenesteenhet vil variere både i forhold til hvilken spesialisering som benyttes og hvor mye informasjon avsender ønsker å overføre. Mottaker må kunne håndtere alle varianter av Henvisende instans og tjenesteyter Alle meldingsinstanser skal ha en forekomst av Henvisende instans <Requester> og en forekomst av Tjenesteyter < ServProvider>. Henvisende instans <Requester> og Tjenesteyter <ServProvider> skal oppgis som organisasjoner med identifikator på organisasjonsnivå. Henvisende instans skal også inneholde opplysninger om henvisende lege (eventuelt rekvirerende lege hvis det er en rekvisisjon). Dette oppgis med Person i organisasjonen <HCPerson> i tillegg. Henvisende instans <Requester> og Tjenesteyter <ServProvider> vil være avsender og mottaker i meldingsinstansen. I tillegg kan meldingen sendes til en eller flere kopimottakere <CopyDest>. 1

2 1.2. Hierarkisk organisasjon med mer enn to nivåer Modellen har kun to hierarkiske nivå på organisasjon, men hvis man ønsker å oppgi flere nivåer (for eksempel HF, Avdeling, Seksjon, Post) er det rekkefølgen på forekomster av Avdeling <Dept> som angir det hierarkiske nivået i organisasjonen. (En Institusjon kan ha flere forekomster av Avdeling <Dept> knyttet til seg.) Institusjon vil alltid gjenspeile øverste hierarkiske nivå (for eksempel HF). Første forekomst Avdeling <Dept> vil gjenspeile nest øverste nivå (for eksempel avdeling), neste forekomst neste nivå i organisasjonshierarkiet (se eksempel i avsnitt 1.2.7). Detaljeringsnivå på innhold i øvrige spesialiseringer av helsetjenesteenhet vil være avhengig av sammenhengen. Kopimottakerrolle Type melding/dokument : CS Ønsket kommunikasjonsmetode : CS Aktuelle kommunikasjonsmetode : CS 0..* Tjenesteyter Henvisende instans Kopimottaker Ansvarlig Helsetjenesteenhet Type relasjon : CS Betalingsansvarlig Type betalingsgarantist : ST HTErolle Tilknyttet tjenesteyter TypeRelasjon Opprinnelse til klinisk opplysning Pasientrelatert helsetjenesteenhet Type relasjon : CS Starttidspunkt : TS Sluttidspunkt : TS Helsetjenesteenhet Medisinsk spesialitet : CV (Henvisende instans sin helsetjenesteenhetsid : ST) (Tjenesteyters id av helsetjenesteenhet : ST) Person i helsevesenet Type helseprofesjon : CS Navn : ST Id : ST Type Id : CS Institusjon Navn : ST Id : ST Type Id : CS 0..1 Adresse Type : CS Gateadresse : ST Postnummer : ST Poststed : ST Fylke/kommune : CS Land : CS Bydel : CS Telekommunikasjon : SET<URL> Person i organisasjon Navn : ST Id : ST Type Id : CS 0..* 0..* Avdeling Type : CS Navn : ST Id : ST Type Id : CS 0..* 0..* 0..* 0..* Alternativ Id (from Pakke for gjenbrukbare klasser) Alle meldinger Epikrise, henvisning og tilbakemelding Svar og rekvirering av medisinske tjenester 2

3 Anbefalt minimumssett av opplysninger som skal overføres for henvisende instans <Requester> Merk: TypeId kan være HER-id eller annen aktuell ID som entydig identifiserer organisasjonen. Riktig type id må da angis. <Requester> <Name>Kattskinnet legesenter</name> <Id> </Id> <TypeId V="ENH" DN="Organisasjonsnummer i Enhetsregister"/> <HCPerson> <Name>August September</Name> <Id> </Id> <TypeId V="HPR"/> </HCPerson> </Requester> Henvisende instans uten ID på person<requester> Merk: Har her tatt med navn på rekvirerende lege. <HCPerson> kan utelates hvis det ikke er naturlig å sende med denne opplysningen. <Requester> <Name>Kattskinnet legesenter</name> <Id> </Id> <TypeId V="ENH" DN="Organisasjonsnummer i Enhetsregister"/> <HCPerson> <Name>August September</Name> </HCPerson> </Requester> Eksempel på rekvirent som benytter både HPR-nr og HER-id <Requester> <Name>Kattskinnet legesenter</name> <Id> </Id> <TypeId V="ENH" DN=" Organisasjonsnummer i Enhetsregister"/> <HCPerson> <Name>August September</Name> <Id> </Id> <TypeId V="HPR" DN="Helsepersonellnummer"/> <AdditionalId> <Id> </Id> <Type V="HER" DN="Identifikator fra Helsetjeesteenhetsregisteret "/> </AdditionalId> </HCPerson> </Requester> 3

4 Lovlig minimumssett av opplysninger som skal overføres for tjenesteyter <ServProvider> <ServProvider> <Name>Køfri sykehus HF</Name> <Id> </Id> <TypeId V="ENH" DN="Organisasjonsnummer i Enhetsregister"/> Minimumssett av opplysninger for øvrige spesialiseringer for person i organisasjon Benyttes for eksempel for å angi opplysninger om Tilknyttet tjenesteyter eller Pasientrelatert helsetjenesteenhet. I noen sammenhenger vil det være viktig at ID oppgis i tillegg til navn, men dette vil være avhengig av sammenhengen. <Name>Kattskinnet legesenter</name> <HCPerson> <Name>August September</Name> </HCPerson> Minimumssett av opplysninger for øvrige spesialiseringer for helsepersonell uten angivelse av organisasjon Benyttes for eksempel hvis man ønsker å overføre opplysninger om utførende radiolog ved en radiologisk undersøkelse. <HCProf> <Name>August September </Name> </ HCProf > Eksempel på en hierarkisk organisasjon med flere nivåer Balsam sykehus, Mikrobiologisk laboratorium, Seksjon for mykobakterier <ServProvider> <Name>Balsam sykehus HF</Name> <Id> </Id> <TypeId V="ENH" DN="Organisasjonsnummeret i Enhetsregister"/> <Dept> <Name>Mikrobiologisk laboratorium</name> <Id>8510</Id> <TypeId V="LAV" DN="Lokal identifikator for avdelinger"/> </Dept> <Dept> <Name>Seksjon for mykobakterier</name> <Id>11</Id> <TypeId V="LAV" DN="Lokal identifikator for avdelinger"/> </Dept> 4

5 </ServProvider> Eksempel på helsetjenesteenhet med adresseopplysninger og kommunenummer Vanligvis overføres ikke adresseopplysninger for kjente aktører i meldingen, men eksempelet er tatt med for å vise hvordan dette kan gjøres. <Name>Kattskinnet legesenter</name> <Id> </Id> <TypeId V="ENH" DN="Organisasjonsnummer i Enhetsregister"/> <HCPerson> <Name>August September</Name> <Id> </Id> <TypeId V="HPR"/> </HCPerson> <Address> <Type V="PST" DN="Postadresse"/> <StreetAdr>Erling Skakkes gate 75</StreetAdr> <PostalCode>7012</PostalCode> <City>Trondheim</City> <TeleAddress V="tel: "/> </Address> 1.3. Alle UML-navn (ML-elementer) sortert klassevis og hierarkisk Tabellen under gir en kortfattet oversikt over alle ML-elementer (UML-klasser og tilhørende UML-attributter), sortert klassevis, og delvis hierarkisk. Informasjonsinnholdet er detaljert beskrevet i de respektive implementasjonsguidene. Kolonnen UML-navn (ML-element) inneholder klassenavn eller attributtnavn fra UMLmodellen, med ML elementnavn (kortnavn) i parentes. Kolonnen O angir hvor mange forekomster man skal/kan ha av UML-klassen eller UMLattributtet (ML-elementet). Kolonnen Datatype inneholder datatypen for attributtet. Kolonnen Innhold /Eksempel viser eksempel på innhold eller informasjon om lovlig innhold. Kolonnen Dokumentasjon inneholder en kortfattet forklaring til informasjonselementet. Kolonnen E v1.0 viser hvilke ML-element som er med i epikrise v1.0 Kolonnen E v1.1 viser hvilke ML-element som er med i epikrise v1.1 Kolonnen H viser hvilke ML-element som er med i henvisning Kolonnen T viser hvilke ML-element som er med i Tilbakemelding på henvisning Kolonnen S viser hvilke ML-element som er med i svarrapport av medisinske tjenester Kolonnen R viser hvilke ML-element som er med i rekvirering av medisinske tjenester Spesialisering (Choise i ML) er markert med en C et hjørne og rød bakgrunnsfarge. 5

6 UML-navn (ML-element) O Datatype Innhold /Eksempel Dokumentasjon H E E T S R Tjenesteyter (ServProvider) 1 Helsetjenesteenhet som yter tjenester i forbindelse med undersøkelse eller behandling av pasient. Rolle (Role) 0..1 CS Fast verdi SPR Kode for helsetjenesteenhet som tjenesteyter. Ref Helsetjenesteenhet (HCP) 1 Henvisende instans (Requester) 1 Helsetjenesteenhet som henviser pasient til undersøkelse eller behandling. Rolle (Role) 0..1 CS Fast verdi REQ Kode for helsetjenesteenhet som henvisende instans. Ref Helsetjenesteenhet (HCP) 1 Kopimottaker (CopyDest) 0..* Helsetjenesteenhet som får eller som skal ha kopi av et dokument eller melding. En kopimottaker kan både være den som får kopi av den aktuelle henvisningen/rekvisisjonen og den parten som skal ha kopi av den resulterende svarrapporten/epikrisen når denne foreligger. Rolle (Role) 0..1 CS Fast verdi COP (Kopimottaker) Kode for helsetjenesteenhet som kopimottaker. Kopimottakerrolle (CopyDestRole) 0..* Rolle til aktuelle kopimottaker (hvilken type melding/dokument parten skal ha kopi av) Type melding/dokument 1 CS Kodeverk: 8236 Meldingstype - Kode for type melding eller dokument som parten (MsgType) rekvisisjon og svar har fått eller skal ha kopi av. Ønsket 0..1 CS Kodeverk: 8235 Kode for kommunikasjonsmetode som foreslått av kommunikasjonsmetode Kommunikasjonsmetode henvisende instans. (ReqComMethod) Aktuelle kommunikasjonsmetode (ActComMethod) Ansvarlig Helsetjenesteenhet(ResponsibleHcp) 0..1 CS Kodeverk: 8235 Kommunikasjonsmetode Kode for kommunikasjonsmetode som blir eller ble benyttet. Ref Helsetjenesteenhet (HCP) Helsetjenesteenhet som er ansvarlig for behandlingen av en pasient, f.eks. institusjon der pasienten er innlagt. Rolle (Role) 0..1 CS Fast verdi REP (Ansvarlig Kode for helsetjenesteenhet som ansvarlig helsetjenesteenhet) helsetjenesteenhet. Type relasjon (Relation) 0..1 CS Kodeverk: 7319 Pasientrelasjon Rollen aktuell helsetjenesteyter har i relasjon til pasienten. Ref Helsetjenesteenhet (HCP) 1 6

7 UML-navn (ML-element) O Datatype Innhold /Eksempel Dokumentasjon H E E T S R Betalingsansvarlig (PaymentResponsible) Helsetjenesteenhet som er ansvarlig for betalingen. Benyttes kun når betalingsansvarlig ikke fremgår direkte fra attributtet betalingskategori i klassen Rekvisisjon/Henvisning (ServReq) Rolle (Role) 0..1 CS Fast verdi: Kode for helsetjenesteenhet som PRP Betalingsansvarlig betalingsansvarlig. Type betalingsgarantist 1 ST Identifiserer betalingsansvarliges rolle, f.eks. navn (TypeGuarantor) på forskningsprogram. Ref Helsetjenesteenhet (HCP) 1 Tilknyttet tjenesteyter (RelServProv) 0..1 Helsetjenesteenhet som er tilknyttet undersøkelsesresultatet. Rolle (Role) 0..1 CS Fast verdi: RSP Tilknyttet tjenesteyter Tilknyttet tjenesteyters rolle. Type relasjon (Relation) CS Kodeverk: 8254 Type relasjon til tilknyttet tjenesteyter Tilknyttet tjenesteyters relasjon til en hendelse, resultat eller svar. Ref Helsetjenesteenhet (HCP) 1 Pasientrelatert helsetjenesteenhet (PatRelHCP) Helsetjenesteenhet som er involvert i å yte helsetjeneste til en pasient og som ikke er spesielt relatert til en gitt hendelse. Rolle (Role) 0..1 CS Fast verdi: PRH Pasientrelatert helsetjenesteenhet Kode for helsetjeneseteenhet som pasientansvarlig part. Type relasjon (Relation) 1 CS Kodeverk: 7319 Pasientrelasjon Rollen aktuelle helsetjenesteyter har i relasjon til pasienten. Sluttidspunkt (StartDateTime) 0..1 TS (Start-)Tidspunkt for den aktuelle relasjonen. Starttidspunkt (EndDateTime) 0..1 TS Sluttidspunkt for den aktuelle relasjonen. Ref Helsetjenesteenhet (HCP) 1 7

8 UML-navn (ML-element) O Datatype Innhold /Eksempel Dokumentasjon H E 1.0 E 1.1 Opprinnelse til klinisk opplysning 0..1 Helsetjenesteenhet som er kilde til en (eller flere) (Origin) klinisk(e) opplysning(er). Rolle (Role) 0..1 CS Fast verdi: OCI Opprinnelse til klinisk opplysning Kode for helsetjenesteenhet som opprinnelse til klinisk opplysning. T S R Ref Helsetjenesteenhet (HCP) 1 Klasser som benyttes flere steder Helsetjenesteenhet (HCP) 1 Opplysninger om en helsetjenesteenhet. En helsetjenesteenhet kan være en institusjon (eventuelt en avdeling ved en institusjon), en aktør (person) i helsevesenet eller en aktør ved en institusjon/avdeling, for eksempel praktiserende lege, sykehus, overlegen ved kirurgisk avdeling på et sykehus. Medisinsk spesialitet (MedSpeciality) 0..1 CV Kode for medisinsk spesialitet for den aktuelle helsetjenesteenhet i henhold til kodeverk for fagområde. En helsetjenesteenhet kan ha flere medisinske spesialiteter, men kun den som er av interesse i den gitte sammenhengen tas med her. Kodeverk: 8451 Fagområde Henvisende instans sin helsetjenesteenhetsid (Party IdByRequester) Tjenesteyters id av helsetjenesteenhet (PartyIdByServProv) ST ST NB! Bruk Alternativ ID (AdditionalId) i stedet. NB! Bruk Alternativ ID (AdditionalId) i stedet. Henvisende instans sin identifikasjon av helsetjenesteenhet. Tjenesteyters identifikasjon av helsetjenesteenhet. Ref Adresse (Address) 0..1 C Institusjon 1 Institusjon i helsevesenet Navn (Name) 0..1 ST Sykehuset Østfold HF Navn på institusjon angitt som offisielt navn. Id (Id) 0..1 ST Organisasjonsnr eller HER-ID Identifikator for institusjonen. skal fortrinnsvis benyttes Må benyttes sammen med "Type id". Type Id (TypeId) 0..1 CS Kode for type identifikator. Må angis dersom "Id" er angitt. Avdeling (Dept) 0..* Opplysninger om avdeling. Forutsetter at institusjon er angitt. 8

9 UML-navn (ML-element) O Datatype Innhold /Eksempel Dokumentasjon H E E T S R Type (Type) 0..1 CS Kode for type avdeling (sengeavdeling, serviceavdeling etc.). Benyttes foreløpig ikke. Navn (Name) 0..1 ST Navn på avdeling angitt som offisielt navn. Id (Id) 0..1 ST Identifikator for avdelingen. Må benyttes sammen med "Type id". Type Id (TypeId) 0..1 CS Kun kodeverdier som er aktuelle Kode for type identifikator. for organisasjoner skal benyttes. Kodeverk: 8268 Type identifikator Må angis dersom "Id" er angitt. Ref Alternativ Id 0..* (AdditionalId) Person i organisasjon 0..* Person i helsevesenet som er del av en institusjon (HCPerson) eller avdeling. Navn (Name) 0..1 ST Overlege Rita Lin Navn på person i organisasjon. Id (Id) 0..1 ST Identifikator for personen. C Type Id (TypeId) 0..1 CS Kun kodeverdier som er aktuelle for personer skal benyttes. Kodeverk: 8268 Type identifikator Ref Alternativ Id (AdditionalId) Må benyttes sammen med "TypeId". Kode for type identifikator. Må angis dersom "Id" er angitt. 0..* Ref Adresse (Address) 0..1 Person i helsevesenet 1 Person i helsevesenet som er involvert direkte (HCProf) eller indirekte i å yte helsetjenester til en pasient. Type helseprofesjon (Type) 0..1 CS Kodeverk: 9060 Kategori Profesjon for aktuelle person i helsevesenet. helsepersonell Navn (Name) 0..1 ST Rita Lin Navnet presenteres som en samlet streng for presentasjon (i motsetning til navn på pasient). Id (Id) 0..1 ST Vanligvis benyttes HPR-nummer. Etter hvert vil HER-id benyttes. Må benyttes sammen med "TypeId". 9

10 UML-navn (ML-element) O Datatype Innhold /Eksempel Dokumentasjon H E E T S R Type Id (TypeId) 0..1 CS Kun kodeverdier som er aktuelle Kode for type identifikator for personen. for personer skal benyttes. Kodeverk: 8268 Type identifikator Må angis dersom "Id" er angitt. Ref Alternativ Id 0..* (AdditionalId) Adresse (Address) 0..1 Adresseopplysninger Type (Type) 1 CS For pasienter benyttes vanligvis Kode for type adresse. bostedsadresse (H). For organisasjoner benyttes postadresse (PST). Kodeverk: 3401 Adressetype Gateadresse(StreetAdr) 0..1 ST Postboks oppgis i dette feltet Gateadresse. hvis det er aktuelt Postnummer (PostalCode) 0..1 ST Postnummer. Poststed(City) 0..1 ST Poststed. Fylke/kommune (County) 0..1 CS Kommunenr i henhold til SSB's Angivelse av kode for fylke og/eller kommune i kodeverk for fylkes/kommunenr. henhold til SSB's kodeverk for fylkes/kommunenr. (4 siffer). Land (Country) 0..1 CS Kodeverk: 9043 Landkoder Kode for land iht. ISO Benyttes vanligvis kun for adresser i utlandet. Bydel (CityDistr) 0..1 CS Bydelsenr. I henhold til SSB Kode for angivelse av administrativ del av by i henhold til SSB sin inndeling av de største byene. Telekommunikasjon (TeleAddress) 0..* URL Tel: Telekommunikasjonsadresse inkludert type. mailto:leg.legesen@test.no Alternativ Id (AdditionalId) Annen identifikasjon av organisatorisk enhet som denne er eller har vært kjent under. Id (Id) 0..1 ST Alternativ identifikasjon. Type (Type) 0..1 CS Kodeverk: 8268 Type identifikator Kode for type alternativ ID. 10