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

Oppdatert 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 på https://simplifier.net/hl7norwayno-basis

Generelt 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 resurser.

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 ikke alle attributter men attributter som kan være av spesiell interesse for Mitt Timevalg og Mine Timer prosjektene eller som er som er profilerte. SupportingInformation i appointment brukes for å gi ekstra informasjon som er assosiert med avtale. Der må her-id på nivå to legges ut som kommunikasjons part med bruk av nasjonale profilen: kommunikasjonspart-Organization. Andre resurser som er aktuelle for referanse fra supportingInformation er basis og/eller nasjonale profiler for DocumentReference og endpoint samt ny hn profil for Flag.

Profilen kan brukes både for timeavtaler og timer. Den siste kolonnen i oversikten viser hvilken informasjonselementer er forventet brukt i timeavtaler og hvilken element er forventet brukt for timer. Det er ikke alle system som bruker kombinasjon mellom timeavtale og underliggende timer i de tilfeller kan man se burt i fra denne informasjonen. Forventet bruk forhindrer ikke det å legge inn data andre plasser. Som eksempel kan pasient legges inn i timetype men den nye timeløsningen forholder seg til pasientinformasjon på timeavtale nivå.

...

Navn

...

Extension

...

Beskrivelse og kommentar

...

Kardinalitet

...

Timeavtaler (ATA) v timer (ATn)

...

Identifier.value

...

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

Appointment: Metadata

Se generelt bruk av metadata for FHIR resurser på helsenorge: Meta informasjon som kan benyttes for alle FHIR ressurser Følgende metadata er aktuelt å bruke som metadata for appointment profilen.

...

Metadata

...

Beskrivelse

...

suppressNotification

...

Se beskrivelse i Meta informasjon som kan benyttes for alle FHIR ressurser

...

reminder

...

Se beskrivelse i Meta informasjon som kan benyttes for alle FHIR ressurser

...

ChildParentRestriction

...

Se beskrivelse i Meta informasjon som kan benyttes for alle FHIR ressurser

...

“NotificationOrganization (tidligere sensitiveSender)”

...

Se beskrivelse i Meta informasjon som kan benyttes for alle FHIR ressurser

AppointmentResponse: hn-basis-appointmentResponse

Profilen er en implementert profil og er basert på nasjonal appointmentResponse profil som er foreløpig i draft (no-basis-appointmentResponse). Tabellen viser ikke alle de attributter som er av mulig interesse for Mitt Timevalg og Mine Timer prosjektene men attributter som kan være av spesiell interesse eller som er som 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 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."

Flag: hn-basis-flag

Profilen er en implementert profil og er basert på Flag resursen http://hl7.org/fhir/R4/flag.html . Tabellen viser ikke alle de attributter som er av mulig interesse for Mitt Timevalg og Mine Timer prosjektene men attributter som kan være av spesiell interesse eller som er allerede profilerte. Flag har vanligvis kun en periode når flag er aktivt. I hn-basis-appointment brukes FHIR flag for å vise  hvilken muligheter innbygger har til å styre/ha effekt på egen time. Flag referes fra appointment.supportingInformation. Flag kan enten være inline i appointment resursen eller som egen resurs i en bundle i lag med appointment. Flag kan også hentes via REST men det er ikke anbefalt foreløpig.

Generelt for profilen gjelder at der det brukes coding skal også system og display brukes i tillegg til code.

I noen tilfeller er nødvendig å legge inn periode som gir frist til den som skal reagere på flag - det kan for eksempel være nødvendig for å sett frist på hvor lenge en innbygger skal ha mulighet til å kansellere time. Det er derfor lagt til en extension statusPeriod som setter valid periode for statusDen 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: Draft IG

Den oppdaterte implementasjonsguiden for nasjonale profiler av appointment og appointmentResponse er tilgjengelig på https://simplifier.net/hl7norwayno-basis.

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 versjon og baserer seg på den nasjonale appointment-profilen. Tabellen viser ikke alle attributter unntatt de som kan være av spesiell interesse for prosjektene "Mitt Timevalg" og "Mine Timer", og/eller de som er profilerte.

"SupportingInformation" i appointment brukes til å gi ekstra informasjon som er assosiert med avtalen. Her skal "her-id" på nivå 2 legges ut som kommunikasjonspart ved bruk av https://norskhelsenett.github.io/nyTimelosningPages/StructureDefinition-kommunikasjonspart-Organization.html Den nasjonale profilen https://simplifier.net/hl7norwayno-basis/kommunikasjonspart-organization er fortsatt i draft og kan ikke brukes foreløpig, men profil som er på IG er identisk med den og peker på den som profil.. For spesialist helse skal Her-id på nivå 1 legges ut som identifier på managing organization for lokasjon av type HOSP.

Andre ressurser som er aktuelle å referere til fra "SupportingInformation", er basis- og/eller nasjonale profiler for "DocumentReference", samt den nye "Helsenorge"-profilen for "Flag" og endpoint for mulig uthopp til eksternt system.

Profilen kan brukes både for timeavtaler og timer. Den siste kolonnen i oversikten viser hvilke informasjonselementer som er forventet brukt i timeavtaler, og hvilke elementer som er forventet brukt for timer. Det er ikke alle systemer som bruker kombinasjonen mellom timeavtale og underliggende timer. I slike tilfeller kan man se bort fra denne informasjonen. Forventet bruk forhindrer ikke innlegging av data andre steder i profilen, men disse vil i stor grad bli ignorert (med mindre noe annet er avtalt).

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

Organisasjon som opprettet og er ansvarlig for identifikator.

Se https://hl7.org/fhir/R4/datatypes-definitions.html#Identifier.assigner
Anvendes i spørringer

1..1

ATA, ATn

identifier.value

Unik timeidentifikator for time/timeavtale (appointment)
Anvendes for å unikt identifisere timer
Anvendes i spørringer

1..1

ATA, ATn

Identifier.system

Id for system som publiserer timeavtale/time (appointment) informasjon
Anvendes i spørringer

1..1

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

Foreløpig valueset:

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

1..1

ATA, ATn

appointmentType

For timenotifikasjon vil NHN støtte valueset basert på 2 koder fra 7617, 4 koder fra 8406 og nytt kodeverk som er under utvikling.

1..1

ATA, ATn

description

Kort beskrivelse av hva timen gjelder. Begrensning 100 char. Lengdebegrensning er under evaluering

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. Lengdebegrensning er under evaluering

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.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 eller er en del av bundle.

Foreløpige støttede profiler: no-basis-Practitioner

ATA/ATn

participant.location

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

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: no-basis-Location

ATA/ATn

participant.PractitionerRole

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

Foreløpig støttede profiler: no-basis-PractitionerRole

ATA/ATn

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

Kommentar: Det vurderes om attribut trenges i denne profilen og hvis det trengs en attribute om den ikke heller bør gnerelt bør reflektere endring i stedet for kun uttsettelse.

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 no-basis-DocumentReference. Document resursen kan inneholde selve brevet som attachment eller som url (path til dokument eller peker til XDS dokument)

  • flag: flag er resurs som inneholder informasjon om hva innbygger og andre kan gjøre i forhold til appointment

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

SupportingInformation referer til:

1..*

ATA, ATn

Appointment: Metadata

Se generelt bruk av metadata for FHIR resurser på helsenorge: Meta informasjon som kan benyttes for alle FHIR ressurser Følgende metadata er aktuelt å bruke som metadata for appointment profilen.

Metadata

suppressNotification

reminder

ChildParentRestriction

“NotificationOrganization (tidligere sensitiveSender)”

AppointmentResponse: hn-basis-appointmentResponse

Profilen er en implementert profil og er basert på nasjonal appointmentResponse profil som er foreløpig i draft (no-basis-appointmentResponse). Tabellen viser ikke alle de attributter som er av mulig interesse for Mitt Timevalg og Mine Timer prosjektene men attributter som kan være av spesiell interesse eller som er som er profilerte. Generelt gjelder for all koding at når coding.code er brukt skal coding.code.system.

Navn

Extension

Beskrivelse og kommentar

Kardinalitet

identifier

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 tekstSubjekt for flag

identifikator. Se FHIR ressursens "id" vs "identifier" - Helsenorge - Confluence (atlassian.net) 

1..1

Identifier.assigner

Assigner. HN vil ikke sende med en assigner. Appointment som appointmentResponse er for er i appointmentResponse.appointment

0..1

Identifier.system

Se FHIR ressursens "id" vs "identifier" - Helsenorge - Confluence (atlassian.net)

1..1

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. Patient er eneste type actor som er aktuell for denne profilen. (appointment.actor = appointment.participant.actor av type patient)

Kun logisk referanse er støttet.

1..1

subject

participantStatus

accepted | declined | tentative | needs-action. 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

Lokalt kodesystem: hn-appointment-flag-code-cs

...

Code

...

Display

...

Definition

...

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

...

Innbygger kan som 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

...

canHaveAppointmentDetails

...

Det finnes 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.

...

canInitiateDialog

Slot: hn-basis-slot

...

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

Flag: hn-basis-flag

Profilen er en implementert profil og er basert på Flag resursen http://hl7.org/fhir/R4/flag.html . Tabellen viser ikke alle de attributter som er av mulig interesse for Mitt Timevalg og Mine Timer prosjektene men attributter som kan være av spesiell interesse eller som er allerede profilerte. Flag har vanligvis kun en periode når flag er aktivt. I hn-basis-appointment brukes FHIR flag for å vise  hvilken muligheter innbygger har til å styre/ha effekt på egen time. Flag referes fra appointment.supportingInformation. Flag kan enten være inline i appointment resursen eller som egen resurs i en bundle i lag med appointment. Flag kan også hentes via REST men det er ikke anbefalt foreløpig.

Generelt for profilen gjelder at der det brukes coding skal også system brukes i tillegg til code.

I noen tilfeller er nødvendig å legge inn periode som gir frist til den som skal reagere på flag - det kan for eksempel være nødvendig for å sett frist på hvor lenge en innbygger skal ha mulighet til å kansellere time. Det er derfor lagt til en extension statusPeriod som setter valid periode for status.

identifier. 

Navn

Extension

Beskrivelse og kommentar

Kardinalitet

identifier.value

Unik

status

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

1..1

statusPeriod

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 Nytt valueset basert på kodeverket:

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

1..1

appointmentType

Nytt valueset basert på 7617

  • "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"

I Slot profilen er derfor kun det valusettes som brukes for appointmentType

1..1

Schedule: hn-basis-schedule

Profilen er en implementert profil og er basert på Schedule resursen http://hl7.org/fhir/R4/schedule.html . Tabellen viser ikke alle de attributter som er av mulig interesse for Mitt Timevalg og Mine Timer prosjektene men attributter som kan være av spesiell interesse eller som er som 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 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 . Nytt valuesett basert på kodeverket.

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

1..1

actor.type

1..1

comment

Max 200 char

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

Lokalt kodesystem: hn-appointment-flag-code-cs

Code

Display

Definition

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

Innbygger kan som 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

canHaveAppointmentDetails

Det finnes 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.

canInitiateDialog