Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Ny nasjonal timeløsning inneholder bruk av flere FHIR profiler. Det inkluderer nye profiler for Appointment, AppointmentResponse, Slot, Flag og Endpoint. Disse profilene er i draft og vil kunne forandres underveis. FHIR versjon R4

Appointment: hn-basis-appointment

Profilen er en implementert profil og er basert på nasjonal appointment profil som er foreløpig i draft (no-basis-appointment). Tabellen viser kun de felt som er av mulig interesse for Mine Timevalg og Mine Timer prosjektene og er profilerte.

Generelt gjelder for all koding at når coding.code er brukt skal coding.code.system og coding.code.display også brukes.

Navn

Extension

Beskrivelse og kommentar

Kardinalitet

Identifier.value

Unik timeidentifikator 
Anvendes for å unikt identifisere timer
Anvendes i spørringer

1..1

Identifier.assigner

Id for underliggende system/tjeneste som
leverer timeavtalen
(no-citizenportal-sourcesystem)
Anvendes i spørringer

Identifier.system

Id for aktør som leverer dataene
(no-citizenportal-client)
Anvendes i spørringer
Kan anvendes for å finne endepunkt
dersom ytterligere detaljer om timen skal hentes.

Status

Status på timen http://hl7.org/fhir/R4/valueset-appointmentstatus.html

cancelationReason

Kanselleringsårsak (cancelationReason). Kodeverk urn:oid:2.16.578.1.12.4.1.1.8445 (preferred) men urn:oid:2.16.578.1.12.4.1.1.9179 kan også brukes. Kanselleringsårsak settes når status = cancelled og serviceCategory = 27 (Specialist Medical) dvs. spesialist helsetjenesten

serviceCategory

Timens tjenestekategori. http://hl7.org/fhir/R4/codesystem-service-category.html

1..1

appointmentType

 I no-basis-appointment er det 3 forskjellige kodeverk som er foreslått brukt. Disse er: 2.16.578.1.12.4.1.1.8406, 2.16.578.1.12.4.1.1.8432, 2.16.578.1.12.4.1.1.7617.

NHN ønsker mest mulig bruk av valueset basert på 7617 følgende koder er foreslått som del av valueset og kan brukes:

  • "Poliklinisktime"( ny kode)

  • "Polikliniskbehandling" (ny kode)

  • "Innleggelse" (ny kode)"

  • “Behandling" (ny kode)

  • "Konsultasjon"

  • "Hjemmebesøk"(ny kode)

  • "Hastetime"

  • “Time for vaksine"

  • "Time på lab"

  • "Bildediagnostikk"

Resterende koder i 7617 fases ut i valueset. AppointmentType i no-basis-appointment er en open slice.

1..1

description

Tittel på timeavtalen. - Blir generert av NHN hvis ikke levert fra sender. Begrensing på 100 char.

start

Start-tidspunktet. Hvis det brukes appointment hierarki (partOf) er start for timeavtale oppmøtetidspunkt og start for enkelt avtaler - tidspunkt for time/avtale.

end

Slutt-tidspunktet

slot

Referanse til innslaget i timebok.

patientInstruction

Beskrivelse om timen som vil vises i detaljvisningen. Begrensning på 500 char.

participant.actor.Patient

Logisk ressursreferanse av type Patient. Identifikatoren er fødselsnummer eller d-nummer.

I reference  settes kardinalitet 0..0 for å hindre bruk av element

identifier 1..1 

identifier.type for pasient kun lov med DNR/FNR

type : http://hl7.org/fhir/resource-types

participant.actor.Patient.type

“Patient”

1..1

participant.actor.Patient.identifier

Logisk referanse brukes for partisipant av type patient

1..1

participant.actor.Patient.reference

Literal referanse brukes ikke for partisipant av type patient

0..0

participant.actor.practitioner

Resurs kan legge in som contained/inline resurs eller som en del av bundle. Helsenorge vi foreløpig ikke støtte resurs som krever eksternt kall. Resurs kan også legest inn som en logisk referanse

Støttede profiler: Practitioner | no-basis-Practitioner

participant.location

Resurs kan legge in som contained/inline resurs eller som en del av bundle. Helsenorge vi foreløpig ikke støtte resurs som krever eksternt kall. Resurs kan også legest inn som en logisk referanse hvis ikke noen "parent" resurs skal også brukes

Lokasjon brukes oftest som en fysisk plassering for kontakten eller opphold. Lokasjon kan være en del av en annen lokasjon. Denne må da være contained i lokasjons resursen eller som en del av same bundle og referert fra "child" lokasjon

Støttede profiler: Location | no-basis-Location

participant.PractitionerRole

Resurs kan legge in som contained/ inline resurs eller som en del av bundle. Helsenorge vi foreløpig ikke støtte resurs som krever eksternt kall. Resurs kan også legest inn som en logisk referanse

Støttede profiler: PractitionerRole | no-basis-PractitionerRole

partOf

partOf er extension i no-basis-appointment og kan brukes for å peke til timeavtale for avtaler/timer. Kan også brukes for timer som er steg og peker da på overordnet appointment

urlToExtSystem

endpoint i supportingInformation og ikke en egen attributt

Lenke URL uthopp til eksterne systemer

Når Endpoint er i bruk refereres det til i appointment.supportingInformation.

basedOn

basedOn referer til Henvisning. Standard attributt i appointment og kan både være logisk eller literal referanse

VirtualService

Profil er oppdatert med VirtualService

Handterer behov for møteform.

The VirtualService er basert på VirtualServiceDetail struktur from R5 og definerer detaljer for virtuell avtale/møte/time. VirtualService er extension i no-basis-appointment

  • channelType: Coding: The type of virtual service to connect to.

    • Eksempel:

      • valueCoding.system : …vs-hn-basis-virtualService,

      • valueCoding.code: “ms-teams”

      • valueCoding.display: “Microsoft Teams”

  • virtualAddress: string, url, ContactPoint: What address or number needs to be used for a user to connect to the virtual service to join.

    • Eksempel:

      • valueUrl: "Url-address-for-ms-team-call"

  • additionalInfo: url: Address to see alternative connection details.

  • maxPartisipants: positiveInt: Maximum number of participants supported by the virtual service.

  • sessionKey: string: Session Key required by the virtual service.

Følgende value sett er definert av NHN og anbefales brukt for channelType

ValueSet: vs-hn-basis-virtualService

Include all codes defined in http://hl7.org/fhir/virtual-service-type
Include all codes defined in http://hl7.org/fhir/ValueSet/contact-point-system

recurring

X

Extension som viser om timen er av typen regelmessig 

group

Extension fra no-basis-appointement som viser om appointment er gruppetime/gruppe avtale

NotificationOrganization

(tidligere sensitiveSender)

X

Extension: String som er en del av informasjon fra sender

minutesDuration

Timens varighet i antall minutter. Hvis denne ikke inneholder noen verdi, vil timens varighet være differansen mellom starttidspunkt og sluttidspunkt

consultationType

X

Extension: Volven 9505 (Preferred). System: https://volven.no/produkt.asp?id=501187&catID=3&subID=8

Dette kodeverket inneholder koder som benyttes for å identifisere de faste alderstrinn (intervall) som er relevante i forbindelse med arbeidet på helsestasjoner og i skolehelsetjenesten.

postponmentReason

X

Extension: Utsettelseskode .  Kodeverk: urn:oid:2.16.578.1.12.4.1.1.8446 (preferred). Denne extension var tidligere del av forslag til no-basis-appointment profilen men er nå fjernet der og leggs inn som del av hn-basis-appointment

Hvis ny time/opphold skal opprettes og status = "cancelled" kan postponmentReason brukes for å gi informasjon om utsettelsen

supportingInformation

Kan inkludere brev (DocumentReference | no-basis-DocumentReference  ), 0..*

Inkluderer HER-id nivå 2 (profil kommunikasjonspart-Organization se https://simplifier.net/hl7norwayno-basis/kommunikasjonspart-organization) 1..1 

Kan Inkludere urlToExtSystem

(endpoint) 0..1

Kan inkludere Flag

Kan brukes for å støtte referanse til brev og/eller annen informasjon. OBS: Document resursen kan også inneholde selve brevet som attachment

-------------------------------------------

Brukes for mandatory endpoint for kommunikasjonspart  som er avsender av timen (HER-id nivå 2). 

---------------------------------------------

Lenke URL uthopp til eksterne systemer

Trenger vi andre eksterne lenker?

https://simplifier.net/hl7norwayno-basis/nobasisendpoint

---------------------------------------------