Draft - Timenotifikasjon. Ny nasjonal timeløsning

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 (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 må 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 NHN ønsker at service kategori blir brukt, men forstår at det kan være vanskelig for enkelte aktører. (Det må fortsatt vurderes om feltet skal settes med kardinalitet 1..1)

0..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 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

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

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

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

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

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

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 må referer til:

• Mandatory kommunikasjonspart som er avsender av timen (her-id nivå 2). Organization se https://simplifier.net/hl7norwayno-basis/kommunikasjonspart-organization ) 1..1 

1..*

suppressNotification

Suppress notification. Varsling undertrykkes. Hvis ikke til sted undertrykkes ikke varsling

reminder

Avsender skal kunne velge mellom "Ingen", "Standard" som styrer når det sendes påminnelser om timen. Default standard

HasAppointmentDetails

Angir at det fins ytterligere timedetaljer som kan hentes. Helsenorge henter kun disse dersom HasAppointmentDetails er satt til true. Dersom denne er satt må avsender støtte kall for henting av timedetaljer.

supportPatientDialog

ChildParentRestriction

Er timen tilgjengelig for​ barnet selv, foreldrene eller begge. 1 Barnet selv, 2 Foreldrene til barnet

Identifier.value

Unik identifikator 

1..1

Identifier.assigner

Id for underliggende system/tjeneste

Identifier.system

Id for aktør som leverer dataene

appointment

Referanse til appointment. Profilen er begrenset til å bruke logisk referanse.

1..1

actor

Logisk ressursreferanse av type Patient. Identifikatoren er fødselsnummer/d-nummer. (Type identifikator er fra kodeverk volven 8268 men begrenset til FNR og DNR med bruk av value set. ) Patient er eneste type actor som er aktuell for denne profilen.

Kun logisk referanse er støttet.

1..1

participantStatus

accepted | declined | tentative | needs-action. Ikke noen begrensning på hvilken status er brukt. I føreste omgang vil portalen måtte sende accepted eller declined. I fremtiden vil tentative også kunne brukes hvis pasient ønsker å flytte eller eller endre på time

"FHIR: Participation status of the participant. When the status is declined or tentative if the start/end times are different to the appointment, then these times should be interpreted as a requested time change. When the status is accepted, the times can either be the time of the appointment (as a confirmation of the time) or can be empty."

shortNotice

Extension fra no-basis-appointmentResponse. Innbygger kan signalisere at innbygger kan komme på kort varsel hvis det finnes time tidligere.

comment

Kan brukes for å be om endring på time eller annen kommentar

changeConferenceType

X

Her legges inn ønsket møteform.  

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

Oppdatert appointment sendes med mulig oppmøte informasjon, ny start og slutt eller link/informasjon som trengs for timen. 

start

Brukes hvis pasient ønsker ett annet starttidspunkt (hvis annet tidspunkt en i appointment) i kombinasjon med partisipantStatus. Se beskrivelse i partisipantStatus.

"FHIR: This may be either the same as the appointment request to confirm the details of the appointment, or alternately a new time to request a re-negotiation of the start time."

identifier.value

Unik identifier. 

1..1

identifier.assignar

Id for underliggende system/tjeneste 
(no-citizenportal-sourcesystem)
^{Anvendes i spørringer}

0..1

identifier.system

Id for aktør som leverer dataene
(no-citizenportal-client)
^{Anvendes i spørringer}

0..1

status

active | inactive | entered-in-error. Default active

1..1

statusPeriod

X

Extension på status: Perioden kan brukes for å sette valid fra/til tidspunkt for flag 

0..1

category

Flagg kan kategoriseres inn i forskjellige kategorier som klinisk, administrativ osv. Kategori er ment å bli brukt som et middel for å filtrere hvilke flagg som vises for en bestemt bruker eller i en gitt kontekst. 

0..*

code

Kode - eller tekst som viser beskjed til innbygger. Eget lokalt kodeverk for koder som brukes for code i hn-basis-appointment-flag. "hn-appointment-flag-code-cs" kodeverket er extendable. I profilen er kode mandatory og det kan ikke brukes ren tekst.

1..1

subject

Subjekt for flag. Ikke noen begrensing på referanse type men vanligvis pasient. I de tilfeller som pasient ikke er kjent som referanse brukes identifier og type

1..1

periode.start

Start tidspunkt for flag

0..1

period.end

I internasjonal basis profil skal ikke end tidspunkt settes hvis flag er aktiv. For å sette periode for status når status er aktiv bruk statusPeriod

0..1

encounter

Mulig referanse til kontakt (encounter).

0..1

author

Hvem har opprettet flag. 

0..1

cancel

Innbygger kan kansellere timen

canChangeAppointmentDialog

Innbygger kan be om endret time

canUseShortNotice

Innbygger kan komme på kort varsel

canCancelServiceRequest

Innbygger kan be om at behandlingsløp avsluttes

canChangeConferenceType

Innbygger kan be om endret konferanse type - eksempel be om virtuell konferanse i stedet for fysisk

canAcknowledge

Timen/opphold kan bekreftes av innbygger. 

Dersom denne er satt må avsender av timen støtte Appointment Response kall for bekreftelse

canChangeAppointment

identifier.value

Unik identifier. 

1..1

identifier.assignar

Id for underliggende system/tjeneste 
(no-citizenportal-sourcesystem)
^{Anvendes i spørringer}

0..1

identifier.system

Id for aktør som leverer dataene
(no-citizenportal-client)
^{Anvendes i spørringer}

0..1

serviceCategory

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

1..1

appointmentType

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

identifier.value

Unik identifier. 

1..1

identifier.assignar

Id for underliggende system/tjeneste 
(no-citizenportal-sourcesystem)
^{Anvendes i spørringer}

0..1

identifier.system

Id for aktør som leverer dataene
(no-citizenportal-client)
^{Anvendes i spørringer}

0..1

serviceCategory

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

1..1

actor.type

1..1

comment

Max 200 char