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: Valueset-appointmentstatus - FHIR v5.0.0	"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
supportingInformation	X	Contained ressurs av type Location som gir oppmøtested.	address.text: "Skiringssalveien 20, Sandefjord"	Nei	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
slot		Referanse til innslaget i timebok.	identifier:system: "urn:ietf:rfc:3986" identifier.value: "c12cc3a3-56cd-4c1d-afbe-24620f6c2a94"	Nei
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
participant.actor			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>