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 Schedule. Disse profilene er i draft og vil kunne forandres underveis. FHIR versjon R4.Imlementasjonsguide finnes her:https://norskhelsenett.github.io/nyTimelosningPages/index.htmlOppdatert implementasjonsguid for draft nasjonale profiler av appointment og appointmentResponse finnes her: https://hl7norway.github.io/NoBasisAppointment/ og implementasjons guid for andre ressurser og artifacts som er profilert i Norge og er aktuelle for ny timeløsning er Den nye nasjonale timeløsningen inkluderer bruk av flere FHIR-profiler. Dette omfatter nye profiler for Appointment, AppointmentResponse, Slot, Flag og Schedule. Disse profilene er foreløpig utkast og kan bli endret underveis. Versjonen som benyttes er FHIR R4.

Implementasjonsguide finner du her: XXXX

Den oppdaterte implementasjonsguiden for nasjonale profiler av appointment og appointmentResponse er tilgjengelig https://simplifier.net/hl7norwayno-basisGenerelt gjelder for all koding at når coding.code er brukt skal coding.code.system og coding.code.display også brukes. Det gjelder også generelt at profilene kan ikke inneholde inline resurser / contained. NHN kjem ikke til å støtte containd resurserbasis.

Når appointment brukes for å avtale tider eller detaljere tidsavtaler, blir de refererte ressursene inkludert ("contained") i ressursen selv. Løsningen støtter for øyeblikket ikke samling av ressurser i bundle. Ved opprettelse eller endring av en timeavtale som blir sendt ("pushet") til Helsenorge via et REST API, brukes PUT-metoden uavhengig av om det dreier seg om en ny avtale eller en endring i en eksisterende avtale.

Appointment: hn-basis-appointment

Profilen er en implementert profil versjon og er basert på nasjonal appointment profil som er foreløpig i draft (no-basis-appointment)baserer seg på den nasjonale appointment-profilen. Tabellen viser ikke alle attributter men attributter unntatt de som kan være av spesiell interesse for prosjektene "Mitt Timevalg" og "Mine Timer prosjektene eller som er ", og/eller de som er profilerte. "SupportingInformation" i appointment brukes for til å gi ekstra informasjon som er assosiert med avtale. Der må avtalen. Her "her-id" på nivå to legges ut som kommunikasjons part med kommunikasjonspart ved bruk av den nasjonale profilen : "kommunikasjonspart-Organization". Andre resurser ressurser som er aktuelle for referanse fra supportingInformation å referere til fra "SupportingInformation", er basis- og/eller nasjonale profiler for "DocumentReference og endpoint samt ny hn profil for Flag", samt den nye "Helsenorge"-profilen for "Flag".

Profilen kan brukes både for timeavtaler og timer. Den siste kolonnen i oversikten viser hvilken hvilke informasjonselementer som er forventet brukt i timeavtaler, og hvilken element hvilke elementer som er forventet brukt for timer. Det er ikke alle system systemer som bruker kombinasjon kombinasjonen mellom timeavtale og underliggende timer i de . I slike tilfeller kan man se burt i bort fra denne informasjonen. Forventet bruk forhindrer ikke det å legge inn innlegging av data andre plasser. Som eksempel kan pasient legges inn i timetype men den nye timeløsningen forholder seg til pasientinformasjon på timeavtale nivåsteder i profilen, men disse vil i stor grad bli ignorert (med mindre noe annet er avtalt).

Identifier.value

Navn

Extension

Beskrivelse og kommentar

Kardinalitet

Timeavtaler (ATA) v timer (ATn)

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

1..1

ATA, ATn

Identifier.assigner

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

ATA, ATn

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.

ATA, ATn

Status

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

ATA, ATn

cancelationReason

Kanselleringsårsak (cancellationReason). 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

ATA

serviceCategory

Valueset basert på http://hl7.org/fhir/R4/codesystem-service-category.html Helsenorgehar ikke mulighet å finne ut tjenestekategorien derfor settes valgt valueset som mandatory. ServiceCategory brukes i Helsenorge får å bestemme på hvilken måte timer vises og handteres i grensesnittet.

Valueset:

10 (Dental)
27 (Specialist Medical)
17 (General Practice)
7 (Community Health Care)

1..1

ATA, ATn

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 via open slice. Men for timenotifikasjon vil NHN støtte valueset basert på 7617 med noen nye koder. Endelig valueset er fortsatt under utarbeiding.

  • "Poliklinisktime"( ny kode) - Behandling som gjøres uten innleggelse

  • "Innleggelse" (ny kode) - Innleggelse

  • "Konsultasjon"

  • "Hjemmebesøk"(ny kode)

  • “Time for vaksine"

  • "Time på lab"

  • "Bildediagnostikk"

1..1

ATA, ATn

description

Kort beskrivelse av hva timen gjelder. Begrensning 100 char.

ATA, ATn

start

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

ATA, ATn

end

Slutt-tidspunktet

ATA, ATn

slot

Referanse til innslaget i timebok.

ATA (ATn)

patientInstruction

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

ATA

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

eksempel:

Code Block
<type value="Patient" />
<identifier>
   <system value="urn:oid:2.16.578.1.12.4.1.4.1" />
   <value value="13116900216" />
</identifier>

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

ATA, ATn

participant.actor.Patient.type

“Patient”

1..1

ATA

participant.actor.Patient.identifier

Logisk referanse brukes for partisipant av type patient

1..1

ATA

participant.actor.Patient.reference

Litteral referanse brukes ikke for partisipant av type patient

0..0

participant.actor.practitioner

Resurs kan kun legges in som en del av bundle. Helsenorge vi foreløpig ikke støtte resurs som krever eksternt kall.

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

ATA

participant.location

Resurs kan kun legges in som en del av bundle. Helsenorge vi foreløpig ikke støtte resurs som krever eksternt kall.

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 del av same bundle og referert fra "child" lokasjon

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

ATA

participant.PractitionerRole

Resurs kan kun legges in som en del av bundle. Helsenorge vi foreløpig ikke støtte resurs som krever eksternt kall.

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

ATA

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

ATn

basedOn

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

ATA

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

ATA

recurring

X

Extension som viser om timen er av typen regelmessig 

ATA

group

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

ATA

minutesDuration

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

ATA, ATn

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.

ATA

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

ATA

supportingInformation

supportingInformation er ment å brukes for å referere til resurser / informasjon som støtter under avtalen. Kommunikasjonspart må legges på supportingInformation.

Eksempel på foreslått bruk i den nye timeløsningen er at supportingInformation kan referer til:

  • dokument inkludert brev med referanse til DocumentReference | no-basis-DocumentReference. Dokument kan da være inline, i bundle eller som url. NHN ønsker i utgangspunktet enten at dokument refereres med url eller som referanse til en documentReference i bundle. OBS: Document resursen kan også inneholde selve brevet som attachment

  • flag: flag er resurs som inneholder informasjon om hva innbygger og andre kan gjøre i forhold til appointment (se beskrivelse av flag resursen og kodeverk)

  • endpoint: endpoint | no-basis-endpoint kan brukes for ekstern endpoint - eksempel for uthopp til eksternt system

Eksempel på foreslått bruk i den nye timeløsningen er at supportingInformation referer til:

1..*

ATA, ATn

...