FHIR Schedule

Under etablering- dokumentasjon ikke ferdig

FHIR Schedule brukes for å hente timebøker tilgjengelige for timebestilling for innbygger.

Profilen er basert på R4 https://hl7.org/fhir/R4/schedule.html

Profil for Schedule

Profilen ligger på Github her: https://norskhelsenett.github.io/FHIRCodeAndMore/ExampleIG/output/StructureDefinition-hn-basis-schedule.html

Hvilke felter og hvordan de benyttes er angitt i tabellen under.

identifier (mandatory): En identifikator som identifiserer Schedule uavhengig av ressursens id på en FHIR-server. Skal være en GUID. Kan benyttes for å knytte Schedule sammen med eventuelle etterfølgende oppdateringer. Eksempel på bruk under:

<identifier>
        <!-- GUID satt av den som har generert Schedule.  -->
        <system value="urn:ietf:rfc:3986"/>
        <value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
</identifier>

active (optional): Angir om timeboken er aktiv eller ikke i henhold til FHIR kodeverk.

Kun aktive timebøker i bruk per nå.

<active value="true" />

serviceCategory(optional): Kategorisering av timebok

Bruker FHIR kodeverk https://terminology.hl7.org/5.3.0/CodeSystem-service-category.html

serviceType(mandatory): Type timebok

Kodet med egendefinert kodeverk, benyttes for å gi egne veiledere til innbyggere og angi type timebok

Lab
Vaksine
Koronavaksine
Koronatest
Behandlertimebok
Blodbank
Annen

Eksempel:

<!-- Schedule skal alltid ha denne koden-->
    <ServiceType>
         <coding>
            <system value="http://helsenorge.no/fhir/CodeSystem/hn-schedule-type-cs"/>
            <code value="Lab"/>
            <display value="Lab"/>
        </coding>
    </ServiceType>

Actor (mandatory):

Type ressurs, display er navnet på timeboken slik den vises til innbygger. Id til denne ressursen benyttes for timebestillinger

Healthcareservice: Benyttes for ressurstimebøker
Practitioner : Benyttes for personlige timebøker

<actor>
	<reference value="Practitioner"/>
    <identifier>
		<system value="urn:oid:2.16.578.1.12.4.1.4.4"/>
		<value value="123456789"/>
	</identifier>
	<display value="Fastlege Hans Hansen"/>
</actor>

freeSlotPlanningHorizon (optional): periode det er lagt ut timeavtaler i timebok

start: Tidspunkt for første ledige time i timebok

end: Siste tidspunkt som er lagt ut

Eksempel på bruk under:

<freeSlotPlanningHorizon>
        <start value="2023-11-15T09:00:00Z"/>
        <end value="2023-11-20T15:30:00Z"/>
</freeSlotPlanningHorizon>

comment (optional): Kommentar til timebok, vises til innbygger som beskrivelse av timeboken

<comment>
    <text value="Lab tilbyr blodprøver og andre tester hver dag fra 10-15"/>
</comment>

Eksempel på bruk av Schedule i DIALOG_INNBYGGER_TIMEBOKOVERSIKT

Andre eksempler finnes i https://norskhelsenett.github.io/FHIRCodeAndMore/ExampleIG/output/StructureDefinition-hn-basis-schedule-examples.html

<MsgHead xmlns="http://www.kith.no/xmlstds/msghead/2006-05-24" p1:schemaLocation="http://www.kith.no/xmlstds/msghead/2006-05-24 MsgHead-v1_2.xsd" xmlns:p1="http://www.w3.org/2001/XMLSchema-instance">
	<MsgInfo>
		<Type V="DIALOG_INNBYGGER_TIMEBOKOVERSIKT" DN="Dialog med innbygger – Timebokoversikt"/>
		<MIGversion>v1.2 2006-05-24</MIGversion>
		<GenDate>2021-01-12T11:59:52.6881844+01:00</GenDate>
		<MsgId>4e8b328d-1a45-4b2b-9155-dd111197f484</MsgId>
		<Ack V="N" DN="Nei"/>
		<ConversationRef>
			<RefToParent>a8f5b448-e488-44a6-b11d-bc6cae2e0fa3</RefToParent>
			<RefToConversation>a8f5b448-e488-44a6-b11d-bc6cae2e0fa3</RefToConversation>
		</ConversationRef>
		<Sender>
			<Organisation>
				<OrganisationName>Test virksomhet</OrganisationName>
				<Ident>
					<Id>1</Id>
					<TypeId V="HER" DN="Identifikator fra Helsetjenesteenhetsregisteret (HER-id)" S="2.16.578.1.12.4.1.1.9051"/>
				</Ident>
				<Organisation>
					<OrganisationName>Test Kommunikasjonspart</OrganisationName>
					<Ident>
						<Id>1234</Id>
						<TypeId V="HER" DN="Identifikator fra Helsetjenesteenhetsregisteret (HER-id)" S="2.16.578.1.12.4.1.1.9051"/>
					</Ident>
				</Organisation>
			</Organisation>
		</Sender>
		<Receiver>
			<Organisation>
				<OrganisationName>Norsk Helsenett</OrganisationName>
				<Ident>
					<Id>115851</Id>
					<TypeId V="HER" DN="Identifikator fra Helsetjenesteenhetsregisteret (HER-id)" S="2.16.578.1.12.4.1.1.9051"/>
				</Ident>
				<Organisation>
					<OrganisationName>Digitale innbyggertjenester</OrganisationName>
					<Ident>
						<Id>109989</Id>
						<TypeId V="HER" DN="Identifikator fra Helsetjenesteenhetsregisteret (HER-id)" S="2.16.578.1.12.4.1.1.9051"/>
					</Ident>
				</Organisation>
			</Organisation>
		</Receiver>
		<Patient>
			<Ident>
				<Id>13116900216</Id>
				<TypeId V="FNR" DN="Fødselsnummer" S="2.16.578.1.12.4.1.1.8116"/>
			</Ident>
		</Patient>
	</MsgInfo>
	<Document>
		<ContentDescription>Fhir element</ContentDescription>
		<RefDoc>
			<MsgType V="XML" DN="XML-instans"/>
			<Description>Fhir element</Description>
			<Content>
				<Bundle xmlns="http://hl7.org/fhir" p1:schemaLocation="http://hl7.org/fhir fhir\bundle.xsd">
					<type value="searchset"/>
					<entry>
						<resource>
							<Schedule>
								<meta>
									<profile value="http://helsenorge.no/fhir/StructureDefinition/hn-basis-schedule"/>
								</meta>
								<extension url="http://helsenorge.no/fhir/StructureDefinition/hn-extension-free-slot-planningHorizon">
									<extension url="freePlanningHorizon">
										<valuePeriod>
											<start value="2024-06-08T09:00:00Z"/>
											<end value="2024-11-20T15:30:00Z"/>
										</valuePeriod>
									</extension>
								</extension>
								<identifier>
									<system value="urn:ietf:rfc:3986"/>
									<value value="urn:uuid:d082e865-7a93-46fc-a0a3-681571aed13c"/>
								</identifier>
								<serviceType>
									<coding>
										<system value="http://helsenorge.no/fhir/CodeSystem/hn-schedule-type-cs"/>
										<code value="Personlig"/>
									</coding>
								</serviceType>
								<actor>
									<type value="Practitioner"/>
									<identifier>
										<system value="urn:oid:2.16.578.1.12.4.1.4.4"/>
										<value value="123456789"/>
									</identifier>
									<display value="Fastlege Hans Hansen"/>
								</actor>
								<comment value="Jobber mandag, onsdag og fredag"/>
							</Schedule>
						</resource>
					</entry>
					<entry>
						<resource>
							<Schedule>
								<meta>
									<profile value="http://helsenorge.no/fhir/StructureDefinition/hn-basis-schedule"/>
								</meta>
								<extension url="http://helsenorge.no/fhir/StructureDefinition/hn-extension-free-slot-planningHorizon">
									<extension url="freePlanningHorizon">
										<valuePeriod>
											<start value="2024-06-07T09:00:00Z"/>
											<end value="2024-09-20T15:30:00Z"/>
										</valuePeriod>
									</extension>
								</extension>
								<identifier>
									<system value="urn:ietf:rfc:3986"/>
									<value value="0cd7fe84-94c3-41b8-83f6-3c64451447bc"/>
								</identifier>
								<serviceType>
									<coding>
										<system value="http://helsenorge.no/fhir/CodeSystem/hn-schedule-type-cs"/>
										<code value="Personlig"/>
									</coding>
								</serviceType>
								<actor>
									<type value="Practitioner"/>
									<identifier>
										<system value="urn:oid:2.16.578.1.12.4.1.4.4"/>
										<value value="431001875"/>
									</identifier>
									<display value="Vikar September August"/>
								</actor>
								<comment value="Jobber tirsdag og torsdag"/>
							</Schedule>
						</resource>
					</entry>
					<entry>
						<resource>
							<Schedule>
								<meta>
									<profile value="http://helsenorge.no/fhir/StructureDefinition/hn-basis-schedule"/>
								</meta>
								<extension url="http://helsenorge.no/fhir/StructureDefinition/hn-extension-free-slot-planningHorizon">
									<extension url="freePlanningHorizon">
										<valuePeriod>
											<start value="2024-06-05T09:00:00Z"/>
											<end value="2024-06-09T15:30:00Z"/>
										</valuePeriod>
									</extension>
								</extension>
								<identifier>
									<system value="urn:ietf:rfc:3986"/>
									<value value="03b4a6cf-7c8b-4171-a171-8b7abbec2eaf"/>
								</identifier>
								<serviceType>
									<coding>
										<system value="http://helsenorge.no/fhir/CodeSystem/hn-schedule-type-cs"/>
										<code value="Koronavaksine"/>
									</coding>
								</serviceType>
								<actor>
									<type value="HealthcareService"/>
									<identifier>
										<system value="urn:oid:2.16.578.1.12.4.1.1.9051"/>
										<value value="ABCDEF123456"/>
									</identifier>
									<display value="Koronavaksine"/>
								</actor>
								<comment value="Koronavaksine tilbys til risikopasienter i henhold til retningslinjer fra FHI"/>
							</Schedule>
						</resource>
					</entry>
					<entry>
						<resource>
							<Schedule>
								<meta>
									<profile value="http://helsenorge.no/fhir/StructureDefinition/hn-basis-schedule"/>
								</meta>
								<identifier>
									<system value="urn:ietf:rfc:3986"/>
									<value value="50aa673f-3456-4855-9eec-5f1aea3966a7"/>
								</identifier>
								<serviceType>
									<coding>
										<system value="http://helsenorge.no/fhir/CodeSystem/hn-schedule-type-cs"/>
										<code value="Lab"/>
									</coding>
								</serviceType>
								<actor>
									<type value="HealthcareService"/>
									<identifier>
										<system value="urn:oid:2.16.578.1.12.4.1.1.9051"/>
										<value value="3546c8f7-3cd3-4693-929e-66501642504c"/>
									</identifier>
									<display value="Lab på legekontoret"/>
								</actor>
								<comment value="Lab tilbyr blodprøver og andre tester hver dag fra 10-15"/>
							</Schedule>
						</resource>
					</entry>
				</Bundle>
			</Content>
		</RefDoc>
	</Document>
</MsgHead>