Timenotifikasjon - FHIR v0.9

Dette er timenotifikasjon tatt i bruk for Helseplattformen. Den skal ikke tas i bruk av andre aktører, versjon 1.0 er under utvikling.

 

Appointmentattributt

Extension

Beskrivelse

Eksempel

Påkrevd

Maks lengde

Logikk

GUI

Cancel

X

Valgfritt felt i FHIR-extension communicationoptions, som kan anvendes på timen.

True

Nei



Et ja her gir funksjonalitet/knapp for å kansellere timen.

Vise knapp for avbestill time

CancelTimeUntil

X

(krever at Cancel er true)
NB: ikke i bruk enda

Valgfritt felt i FHIR-extension communicationoptions, som kan anvendes på timen.

2019-06-02T08:30:00.000+01:00

Nei



Sjekkes først hvis Cancel er true. Gir tidspunktet for når timen ikke lengre skal være mulig å kansellere (for eksempel en dag før timen).

Fjerner avbestill-knappen når tidspunktet har passert.

Identifier



Timeidentifikator i avsenders system
(no-citizenportal-instanceidentifier)
Anvendes for å unikt identifisere timer
Anvendes i spørringer

3546c8f7-3cd3-4693-929e-66501642504c

Ja







Identifier

X

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

15-3fb9c0f4-1d9b-44b6-8d64-d36820115274

Ja







Identifier

X

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.

Epic

Ja



Ved mottak valideres denne verdien (timens aktør/kilde) opp mot systemet som kaller APIet (hentes fra token)



Status



Status på timen

Dette er FHIR-kodeverdiene:

https://www.hl7.org/fhir/valueset-appointmentstatus.html

"booked" (ReservertBekreftet), "cancelled" (AvbestiltBekreftet), "entered-in-error" (Feilregistrering), "fulfilled" (Gjennomført)



Ja



"booked" (ReservertBekreftet), "cancelled" (AvbestiltBekreftet), "entered-in-error" (Feilregistrering), "fulfilled" (Gjennomført)

Status (ikon og tekst)

serviceCategory



Timens tjenestekategori



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

Nei



Mappes over til motparttype-verdien.
10 (Dental) mappes over til motparttype 11 (Primarhelsetjeneste).
Defaulter til "Primarhelsetjeneste".



appointmentType



Utvide timetype innbyggerportal

Timetypene er delvis fra ActEncounterCodes og delvis egendefinerte forslag. Markeringene viser forslag. 

Se tabell under

 

Nei



Ordinær = NULL (ingen verdi gir GUI-verdi "Time")

Tittel (en del av teksten)

description



Beskrivelse av timen/timen gjelder





"Oppfølging av kontrolltime"

Nei

500



Timen gjelder

supportingInformation

X

 

 

 

Contained ressurs av type Organization. Definerer tjenesten, og har referanse til organisasjonen.

Identifier definerer HerId-nivå 2
Name definerer tjenestenavnet

partOf.reference.identifier definerer Organisasjonsnummeret
partOf.reference.display definerer organisasjonsnavnet

supportingInformation.type: "Organization"
supportingInformation.reference: #54321

Ja







identifier.system: "urn:oid:2.16.578.1.12.4.1.2"
identifier.value: "140890"

Nei







name: "Allmen tannhelse"

Ja

100



Tittel (en del av teksten)

partOf.reference.type: "Organization"

Ja







partOf.reference.identifier.system: "urn:oid:2.16.578.1.12.4.1.4.101"
partOf.reference.identifier.value: "948554062"

Ja



Behøves for å ha en unik referanse til organisasjonsressursen, men anvendes ikke (lagres ikke).



partOf.reference.display: "SiO Helse"

Ja

100



Tittel (en del av teksten)

supportingInformation

X

Contained ressurs av type Location som gir oppmøtested.

supportingInformation.type: "Location"
supportingInformation.reference: #12345



Nei







address.text: "Skiringssalveien 20, Sandefjord"

100



Oppmøtested
(kan være aktuelt også for videotimer)

start



Start-tidspunktet

2019-06-03T08:00:00.000+01:00

Ja





Starttidspunkt

end



Slutt-tidspunktet

2019-06-03T08:30:00.000+01:00

Ja





Antallvarighet? (brukes i utregning)

slot

 

Referanse til innslaget i timebok.

type: "Slot"



Nei







identifier:system: "urn:ietf:rfc:3986"
identifier.value: "c12cc3a3-56cd-4c1d-afbe-24620f6c2a94"







patientInstruction



Beskrivelse om timen som vil vises i detaljvisningen.

"Husk å utføre forberedelsene til timen før oppmøtet."

Nei

500



Beskrivelse (når en går inn på detaljer om en time)

participant.actor

 

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

actor.type: "Patient"

Ja







identifier.system: "urn:oid:2.16.578.1.12.4.1.4.1"
identifier.value: "13116900216"

Ja



Slår opp ArkivId basert på fødselsnummer/d-nummer



participant.practitioner

 

 

Contained ressurs av typen Practitioner.

actor.type: Practitioner



Nei







name:given: "Careful"

Ja

100



Behandler (en del av teksten)

name:family "Adam"

Nei

100



Behandler (en del av teksten)

urlToExtSystem

X

Lenke URL uthopp til eksterne systemer

Brukes i forbindelse med uthopp til timedetaljer og administrasjon i eksterne systemer

Nei

255



Lenke til eksternt system vises i "uthoppsvindu"

contactPoint

X

URL-videolenke, tlf (ny)



"https://video.videonor.no?id=12343455", "+47 859 74 321"

Nei

255



Lenke til videotime vises på detaljvisning

videoProduct

X

Videoprodukt (ny).

Videoprodukt/leverandør må være godkjent





Nei

255





suppressNotification

X

Suppress notification

Varsling undertrykkes (ny)

Sjekkes, default "true" i dagens AMQP-løsning

True

Nei



Default = false



basedOn



Henvisningsid (ny)

Type Reference(ServiceRequest)

Nei

255



Relatert henvisning

contactType

X

Møteform (ny)



"Video", "Tlf", "Fysisk oppmøte"

Nei

255

Default = "Fysisk oppmøte"



recurring

X

Om timen er av typen regelmessig 

True, False

Nei



Default = False

Vises som regelmessig avtale

group

X

Om det er gruppetime

True, False

Nei



Default = False

Vises om det er en gruppetime

sensitiveSender

X

  • true/false. Hvis sensitivAvsender er false viser vi avsender i varsel om time. Hvis sensitivAvsender er true, viser vi ikke avsender i varsel. 

True, False

Nei



Default = False



reminder

X

Avsender skal kunne velge mellom "Ingen", "Standard", "Video" eller "Forberedelser" som styrer når det sendes påminnelser om timen

Forberedelser

Nei

100

Default = "Standard"



timeframe

X

Forteller at tidspunktene som er angitt på timen, er et tidsvindu og ikke eksakt oppmøtetid

True, False

Nei



Default = False



minutesDuration



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

30

Nei







consultationType

X

I dagens løsnings har vi kalt det konsultasjonstype. Ikke obligatorisk. Avsender kan sende med hvilket kodeverk og hvilken verdi i kodeverket timen "tilhører". F.eks "9505:4A". Her er kodeverket 9505 og verdi 4A som betyr Fireårskontroll. Hvis vi har noe registrert på denne koden i CMS, viser vi tilleggsinformasjon på timen.

"9505:4A"

Nei

100





 

Timetyper - Volven (www.volven.no) kodeverk 7617 skal innen kort tid oppdateres med disse:

Timetyper (visningsnavn)

Kode

Info

Timetyper (visningsnavn)

Kode

Info

Ordinær time

  • fases ut

Ordinærtime

(eksisterende kode)

Ordinær time fases ut og erstattes av Konsultasjon. Se lenger ned.

Poliklinisk time

Poliklinisktime

(foreslått kode)

Dagens spesialist, koden "AMB" benyttes men må erstattes med utv. av Volven

Poliklinisk behandling

Polikliniskbehandling

(foreslått kode)

Dagens spesialist, koden "SS" benyttes, men må erstattes med utv. av Volven

Dagkirurgi

Dagkirurgi

Ny

Dagbehandling

Dagbehandling

Ny

Innleggelse

Innleggelse

(foreslått kode)

Dagens spesialist, koden "IMP" benyttes, men må erstattes med utv. av Volven

Behandling

Behandling

(foreslått kode)

Dagens spesialist, hvilken kode brukes ?

Konsultasjon

Konsultasjon

Ny

Hjemmebesøk

Hjemmebesok

(foreslått kode)

Ny, koden "HH" er foreslått, men må erstattes med utv. av Volven

Hastetime

Hastetime

(eksisterende kode)

Fra gammel primær

Vaksinasjon

Vaksine

Time for vaksine

Laboratorietime

Lab

Time på lab

Bildediagnostikk

Bildediagnostikk



Koronatest

Koronatest

Innført for håndtering av pandemien

Koronavaksine

Koronavaksine

Innført for håndtering av pandemien

Gruppetime

  • fases ut

Gruppe

(eksisterende kode)

Fra gammel primær, beholdes inntil videre, erstattes av timetype + gruppetime-attributt?

Tidsvindu

  • fases ut

Tidsvindu

(eksisterende kode)

Fra gammel primær

Videotime

  • fases ut



Video

(eksisterende kode)

Fra gammel primær, beholdes inntil videre, erstattes av timetype + videotime-attributt

 

Eksempel:

 

<?xml version="1.0" encoding="utf-8"?> <Appointment xmlns="http://hl7.org/fhir"> <id value="a9921640-0574-44ee-b3d0-b4c51c398863"/> <meta> <profile value="http://ehelse.no/fhir/StructureDefinition/hn-appointment"/> </meta> <contained> <Location> <id value="e9d99012-2df1-4400-9b43-0dbb274a584b"/> <meta> <profile value="http://ehelse.no/fhir/StructureDefinition/hn-appointment_containedlocation"/> </meta> <address> <text value="Skiringssalveien 20, Sandefjord"/> </address> </Location> </contained> <contained> <Organization> <id value="7a88d88d-788e-4627-a78f-4e7501922b3c"/> <meta> <profile value="http://ehelse.no/fhir/StructureDefinition/hn-appointment_containedorganization"/> </meta> <identifier> <system value="urn:oid:2.16.578.1.12.4.1.2"/> <value value="1494"/> </identifier> <name value="Allmen tannlege"/> <partOf> <type value="Organization"/> <identifier> <system value="urn:oid:2.16.578.1.12.4.1.4.101"/> <value value="948554062"/> </identifier> <display value="Sio Helse"/> </partOf> </Organization> </contained> <contained> <Practitioner> <id value="26b6c9c2-3190-4505-90ef-62a408c87b32"/> <meta> <profile value="http://ehelse.no/fhir/StructureDefinition/hn-appointment_containedpractitioner"/> </meta> <name> <family value="Careful"/> <given value="Adam"/> <prefix value="Dr"/> </name> </Practitioner> </contained> <extension url="http://ehelse.no/fhir/StructureDefinition/hn-appointment_extension-communicationoptions"> <extension url="Cancel"> <valueBoolean value="true"/> </extension> <extension url="CancelTimeUntil"> <valueDateTime value="2021-03-24T14:00:28.0784362+00:00"/> </extension> <extension url="urlToExtSystem"> <valueUrl value="https://minhelse.no?id=12343455"/> </extension> <extension url="contactPoint"> <valueContactPoint> <system value="url"/> <value value="https://video.videonor.no?id=12343455"/> </valueContactPoint> </extension> <extension url="videoProduct"> <valueString value="Skype"/> </extension> <extension url="suppressNotification"> <valueBoolean value="true"/> </extension> <extension url="contactType"> <valueCode value="Video"/> </extension> <extension url="recurring"> <valueBoolean value="true"/> </extension> <extension url="group"> <valueBoolean value="false"/> </extension> <extension url="sensitiveSender"> <valueBoolean value="true"/> </extension> <extension url="reminder"> <valueCode value="Standard"/> </extension> <extension url="timeframe"> <valueBoolean value="false"/> </extension> <extension url="consultationType"> <valueString value="9505:4A"/> </extension> </extension> <identifier> <system value="http://ehelse.no/fhir/CodeSystem/no-citizenportal-client"/> <value value="Opus"/> </identifier> <identifier> <system value="http://ehelse.no/fhir/CodeSystem/no-citizenportal-instanceidentifier"/> <value value="203"/> </identifier> <identifier> <system value="http://ehelse.no/fhir/CodeSystem/no-citizenportal-sourcesystem"/> <value value="16-3fb9c0f4-1d9b-44b6-8d64-d36820115274"/> </identifier> <status value="booked"/> <serviceCategory> <coding> <system value="http://hl7.org/fhir/ValueSet/service-category"/> <code value="10"/> <display value="Dental"/> </coding> </serviceCategory> <appointmentType> <coding> <system value="urn:oid:2.16.578.1.12.4.1.1.7617"/> <code value="Ordinær"/> <display value="Ordinær time"/> </coding> </appointmentType> <description value="Oppfølging av kontrolltime"/> <supportingInformation> <reference value="#e9d99012-2df1-4400-9b43-0dbb274a584b"/> </supportingInformation> <supportingInformation> <reference value="#7a88d88d-788e-4627-a78f-4e7501922b3c"/> </supportingInformation> <start value="2021-03-24T15:00:28.0760079+01:00"/> <end value="2021-03-24T16:00:28.076441+01:00"/> <minutesDuration value="30"/> <slot> <type value="Slot"/> <identifier> <system value="urn:ietf:rfc:3986"/> <value value="a7e19b21-d89a-4ba4-ba00-1492709bd20a"/> </identifier> </slot> <patientInstruction value="Husk å utføre forberedelsene til timen før oppmøtet."/> <participant> <actor> <type value="Patient"/> <identifier> <system value="urn:oid:2.16.578.1.12.4.1.4.1"/> <value value="13116900216"/> </identifier> </actor> <required value="required"/> <status value="accepted"/> </participant> <participant> <actor> <reference value="#26b6c9c2-3190-4505-90ef-62a408c87b32"/> </actor> <required value="required"/> <status value="accepted"/> </participant> </Appointment>