Brontekst bekijken van hg:Vprepub-1 FHIR ELZ

__NOINDEX__
{{Vdraft/InformationBox|This FHIR IG is currently under development and can not be considered stable and ready for use. For questions and change requests regarding this IG, please create a ticket in [{{VersieInfo|BITS|release=V1|namespace=hg}} BITS].}}

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:FHIR Implementation Guide ELZ {{VersieInfo|ELZ|release=V1|namespace=hg}}}}

[[Bestand:Icoon_Nictiz_Cirkel_Eerstelijnszorg_Oranje.svg|link=|100px|ELZ|rechts]] 

<div class="toclimit-3">__TOC__</div>

=Introduction=

This is the implementation guide for ELZ (Dutch: Eerstelijnszorg, English: Primary care). The functional specification can be found [[hg:Vprepub-1_Ontwerp_ELZ|here]] and is implemented using [https://www.hl7.org/fhir/R4/ HL7 FHIR R4]. This implementation guide assumes that the reader is familiar with both the functional specification and the FHIR standard. 

This IG is inspired by the [https://build.fhir.org/ig/HL7/bser/ BSeR IG], developed and published by the HL7 Public Health work group. The goal is to align with this IG where possible and Nictiz is participating in this work group for further development and international alignment of the BSeR IG.

Apart from this document, the guidelines as specified in the [[FHIR:V1.0_FHIR_IG_R4|general FHIR Implementation Guide]] apply.

=Workflow and message structure - referral use cases=

==Overview==
The use cases described in this IG are limited in sense of workflow: events are handled on a per use case basis where the sender does not explicitly requests a response (e.g. a status update). Future insights might contain more (use case overarching) workflow. To prepare for this workflow mechanism, the Task resource is used as the entry point for all exchanges.

==Task==
===Task requirements===
The requirements for the Task resource in the ELZ context are specified using the {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/hg-ReferralTask|nictiz.fhir.nl.r4.elz|pkgVersion=0.2.0-beta.1}} profile. This profile SHALL be used for the ELZ referral use cases.

The Task instance SHALL be hosted on the server of the sending XIS. Both the sending and the receiving XIS need to be able to update the Task. The sending XIS MAY use business rules to reject an update, for example if invalid status change is used.

Both the sending and the receiving XIS SHALL monitor the Task resource for changes. It is expected that the sending XIS will use a notification mechanism to inform the receiving XIS of creation or updates of the Task, but the receiving XIS could use a polling mechanism as well.

===Task invocations===
The receiving XIS can query the Task at the sending XIS by using the {{fhir|Task.id}} which is communicated in the notification:
  GET [base]/Task/[Task.id]

'''Note''': It is up to the receiving XIS to determine if this is a new Task or an update to an existing Task, and if it is an update, what the change entails.

The receiving XIS can update a Task hosted by the sending XIS using a PUT operation:

  PUT [base]/Task/[Task.id]

The body should be the original Task with the needed modifications. The sending XIS SHOULD check the update for errors and inconsistencies. If the update is rejected, the sending XIS SHALL response with an HTTP 422 status code and an OperationOutcome detailing the problem.

{{Vdraft/InformationBoxSmall|A notification/transaction mechanism for this IG is currently under a broader (international) discussion and therefore not yet specified, it is however aimed to align with this initiative.}}

==ServiceRequest==
A ServiceRequest resource is used to represent a (request for) referral. The requirements for the ServiceRequest resource in the context of this IG are specified using the {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/hg-ReferralServiceRequest|nictiz.fhir.nl.r4.elz|pkgVersion=0.2.0-beta.1}} profile. This profile SHALL be used in referral use cases.

Each referral SHALL be captured by a dedicated ServiceRequest. When a referral is sent to multiple parties, each party receives its own unique ServiceRequest. Revoking referrals after a certain period of time based on whether action is taken or not is out of scope of this IG.

The ServiceRequest is referenced from {{fhir|Task.focus}}.

===ServiceRequest invocations===
The receiving XIS MAY use the following mechanism to retrieve the ServiceRequest:
<pre>GET [base]/ServiceRequest/[ServiceRequest.id]</pre>

==Composition==
A Composition resource is used to capture relevant data that supports the referral, for instance the reason for referral or guidance noted down by the general practitioner. This data is either directly included in the Composition as unstructured text or included as referenced resources. The requirements for IG are specified using the {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/hg-ReferralComposition|nictiz.fhir.nl.r4.elz|pkgVersion=0.2.0-beta.1}} profile. This profile SHALL be used in referral use cases.

The Composition is referenced from {{fhir|ServiceRequest.supportingInfo}}.

===Composition invocations===
The receiving XIS MAY use either of the following mechanisms to retrieve the Composition and individual FHIR resources referenced in the Composition:

; As a Document: The receiving XIS uses the {{fhir|$document}} operation to retrieve both the Composition ''and'' all referenced resources as a single document Bundle.<br/><pre>GET [base]/Composition/[Composition.id]/$document</pre>'''Note''': The sending XIS SHALL produce a complete Bundle containing not only the Composition and the resources listed directly in the Composition, but all the indirectly referenced resources as well.
; Individual requests: The receiving XIS first retrieves the Composition resource:<br/><pre>GET [base]/Compositon/[Composition.id]</pre>Then the necessary other resources referenced can be fetched using <code>GET</code> interactions.

The sending XIS SHALL support both mechanisms.

===Handling unstructured text concepts===
Some concepts in the data set are of data type string, as some of the relevant data is entered manually by the referrer in the context of a specific referral. This data is often not represented as a persistent object in EHRs but more likely stored as a form or a questionnaire entry. In order to send this data within the Composition, the extension {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/ext-TextValue}} is used on {{fhir|Composition.section}}, accompanied by a distinctive code on {{fhir|Composition.section.code}}. The {{fhir|Composition.section.text}}, which provides a human-readable narrative, is mandatory when the {{fhir|Composition.section}} does not contain an entry or sub-section. Also see [http://hl7.org/fhir/R4/composition-definitions.html#Composition.section.text invariant cmp-1].

Example:
<syntaxhighlight lang="xml" style="max-height:400px; overflow: auto;">
<Composition>
...
<section>
    <extension url="http://nictiz.nl/fhir/StructureDefinition/ext-TextValue">
        <valueString value="paracetamol indien nodig"/>
    </extension>
    <title value="Ingestelde behandeling"/>
    <code>
        <coding>
            <system value="http://snomed.info/sct"/>
            <code value="108631000146107"/>
            <display value="behandeling lopende (situatie)"/>
        </coding>
    </code>
    <text>
        <status value="extensions"/>
        <div xmlns="http://www.w3.org/1999/xhtml">Ingestelde behandeling: paracetamol indien nodig</div>
    </text>
</section>
...
</Composition>
</syntaxhighlight>

=Use cases=
{{Vdraft/InformationBoxSmall|Currently this IG only covers the [[#Use_case:_Referral_from_general_practitioner_to_allied_health_professional]] but omits the transfer of relevant medical record entries. As development moves on, this use case will be extended and more use cases will be added.}}

==Use case: Referral from general practitioner to allied health professional==
This is the technical counterpart of [[hg:Vprepub-1_Ontwerp_ELZ#Usecase:_Huisarts_verwijst_naar_paramedicus]] as described in the functional design.

===Actors involved===
{| class="wikitable"
! colspan="2" | Actors
! colspan="4" | Systems
! colspan="2" | FHIR CapabilityStatements
|-
! Name
! Description
! Name
! Actor
! System role
! Description
! Name
! Description
|-
| General practitioner
| The user of a HIS
| HIS
| Sending XIS (server)
| HZP-VPS
| General practitioner information system
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/hg-Referral-GeneralPractitionerToAlliedHealthProfessional|nictiz.fhir.nl.r4.elz|pkgVersion=0.2.0-beta.1}}
| rowspan="2" | FHIR client/server requirements
|-
| Allied health professional
| The user of a PARIS
| PARIS
| Receiving XIS (client)
| HZP-VPO
| Allied health professional information system
|}

===Relations between resources===
[[Bestand:230523_Resources_verwijzing.png|1000px|link=]]

=FHIR profiles=

{{hg:Vprepub-1_NoteBoxPackage|p1=nictiz.fhir.nl.r4.elz|v1=0.2.0-beta.1|p2=nictiz.fhir.nl.r4.nl-core|v2=0.9.0-beta.1}}

{{Vdraft/InformationBoxSmall|The FHIR profiles defined for zib publication 2020 are currently in beta status. Although major changes are not to be expected, users should be aware that these profiles might be subject to incompatible changes before a stable version is reached. Therefore, these profiles should not be regarded fit for use for real-world data exchange.}}

{| class="wikitable"
! Profile name
! FHIR Resource
! Canonical URL
|-
| hg-ReferralTask
| Task
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/hg-ReferralTask|nictiz.fhir.nl.r4.elz|pkgVersion=0.2.0-beta.1}}
|-
| hg-ReferralServiceRequest
| ServiceRequest
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/hg-ReferralServiceRequest|nictiz.fhir.nl.r4.elz|pkgVersion=0.2.0-beta.1}}
|-
| hg-ReferralComposition
| Composition
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/hg-ReferralComposition|nictiz.fhir.nl.r4.elz|pkgVersion=0.2.0-beta.1}}
|-
| nl-core-Patient
| Patient
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
|-
| nl-core-HealthProfessional-PractitionerRole
| PractitionerRole
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
|-
| nl-core-HealthProfessional-Practitioner
| Practitioner
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
|-
| nl-core-HealthcareProvider
| Location
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
|-
| nl-core-HealthcareProvider-Organization
| Organization
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
|-
| nl-core-Problem
| Condition
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Problem|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
|}

=Release notes=
Release notes can be found on the [[hg:Vprepub-1_Ontwerp_ELZ#Release_notes| functional design page]].