Brontekst bekijken van Lab:V3.0.0 FHIR Lab2zorg

__NOINDEX__

{{DISPLAYTITLE:FHIR Lab2zorg V2.0.0}}
{{underconstruction}} 

<imagemap>Bestand:functioneel-technisch-banner_00_alle.png|center|240px|alt=Functioneel-Technisch   
circle 204 216 215 [[Lab:V2.0.0_Ontwerp_Lab2zorg|Functional]]
circle 990 216 215 [[Lab:V2.0.0_FHIR_Lab2zorg|Technical]]
desc none                         
</imagemap>

__NUMBEREDHEADINGS__

=Introduction=
[[Bestand:Functioneel-02.png|link=Lab:V2.0.0_Ontwerp_Lab2zorg|100px|rechts|Functional design|Go to functional design]]

This page describes the technical design of Lab2Zorg (Lab2Healthcare) as a subset of the '''[[Lab:V3.0.0 Ontwerp Laboverdacht|Information standard lab exchange]]'''. This technical specification is implementer centric and complements the '''[[Lab:V2.0.0_Ontwerp_Lab2zorg|functional design]]'''. This page uses various terms as defined in the [[Lab:V3.0.0 Ontwerp Laboverdacht#Begrippenlijst|glossary]] (NL: Begrippenlijst). This page implements general principles applicable to FHIR as outlined by a central [[FHIR:Vdraft_FHIR_IG_R4|FHIR IG for R4]]. Please make sure you familiarize yourself with both the functional design and the FHIR IG for full appreciation of the context of this page.

Many laboratory results have important relationships to other observations and need to be grouped together. [http://hl7.org/fhir/observation.html#10.1.4.1 The FHIR specification] defines several structures to do this: 

* {{fhir|Observation}} and one or more {{fhir|Observation.hasMember}} elements.
** Each {{fhir|.hasMember}} element references another Observation and the Observation with {{fhir|.hasMember}} elements thus serves as grouper for all Observation it references. Each Observation can be accessed individually. This is useful for panels and/or batteries of tests. This is what [https://zibs.nl/wiki/LaboratoryTestResult-v4.6(2020EN)#12870 NL-CM:13.1.3 LaboratoryTest] maps into.
** Note that while FHIR Observation also allows reference of resource types MolecularSequence | QuestionnaireResponse, there is no identified use case for that at time of writing.
** An Observation without {{fhir|.hasMember}} elements is expected to be an individual result and has a value when one can be/is determined.
* {{fhir|Observation}} and one or more {{fhir|Observation.derivedFrom}} elements.
** Each {{fhir|.derivedFrom}} element references another Observation references related measurements the observation is made from. This is what [https://zibs.nl/wiki/LaboratoryTestResult-v4.6(2020EN)#12849 NL-CM:13.1.33 RelatedResult::LaboratoryTestResult] maps into.
** Note that while FHIR Observation also allows reference of resource types DocumentReference | ImagingStudy | Media | QuestionnaireResponse | MolecularSequence, there is no identified use case for those at time of writing.
* {{fhir|Observation}} and one or more {{fhir|Observation.component}} elements.
** components of an Observation are not accessible individually. Whenever you access the Observation, you also access all its components. This is mostly useful when certain context is provided around the result. For lab observations this is expected to be less common. An example outside of the lab realm could be BloodPressure where systolic, diastolic, and cuff size are all in 1 Observation with 3 components.

This FHIR implementation guide assumes that systems (XIS) are able to make a connection to the right systems. It does not provide information on finding the right XIS nor does it provide information about security including authentication and authorization. Finding the right system, and security aspects of the connection are dealt with by the infrastructure. Any relevant infrastructure is expected to have a framework in place to deal with this. The only assumption/requirement for an infrastructure is that this allows RESTful FHIR based exchange as specified here.

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| rowspan="2" | Lab Professional
| rowspan="2" | The user of a LIS
| rowspan="2" | LIS
| rowspan="2" | Laboratory information system
| [[Bestand: Verwijzing.png| 20px]] {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/lab2healthcare-labclientcapabilities|nictiz.fhir.nl.r4.zib2020|title=CapabilityStatement: Lab Client}}
| Lab2Healthcare LIS client requirements
|-
| [[Bestand: Verwijzing.png| 20px]] {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/lab2healthcare-labservercapabilities|nictiz.fhir.nl.r4.zib2020|title=CapabilityStatement: Lab Server}}
| Lab2Healthcare LIS server requirements 
|-
| rowspan="2" | Healthcare professional
| rowspan="2" | The user of a XIS
| rowspan="2" | XIS
| rowspan="2" | (Any) Healthcare information system
| [[Bestand: Verwijzing.png| 20px]] {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/lab2healthcare-xisclientcapabilities|nictiz.fhir.nl.r4.zib2020|title=CapabilityStatement: XIS Client}}
| Lab2Healthcare XIS client requirements
|-
| [[Bestand: Verwijzing.png| 20px]] {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/lab2healthcare-xisservercapabilities|nictiz.fhir.nl.r4.zib2020|title=CapabilityStatement: XIS Server}}
| Lab2Healthcare XIS server requirements
|}

=Use case: Health professional retrieves lab results=
==Introduction==
Healthcare professionals need to be able to retrieve laboratory results directly from a LIS of XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve laboratory results(PULL)
|style="background-color: white;vertical-align:top;" rowspan="2"|Retrieve laboratory results request
|style="background-color: white;vertical-align:top;"|Labspecialist (using an LIS)
|style="background-color: white;vertical-align:top;"|Send laboratory results to a XIS
|-
|style="background-color: white;vertical-align:top;"|Healthcare professional (using an XIS)
|style="background-color: white;vertical-align:top;"|Send laboratory results to another XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve laboratory results response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using an XIS)
|style="background-color: white;vertical-align:top;"|Receive laboratory results from a LIS or another XIS
|}

==Invocations==
===XIS: request message===
The request message represents an HTTP GET parameterized query from the XIS to the XIS/ LIS.

====Trigger events====
When the healthcare professional wants to obtain laboratory results, it issues a retrieve laboratory request message.

====Message semantics====
The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification against the XIS's Observation endpoint. This search query URL is configurable by the PHR and has the following format:

<pre>GET [base]/Observation{?_include=...&_include:iterate=...}</pre>

query parameters:
* Date (get last (x) months) (effective)
**vanaf X
** tot en met X
* testcode (observation.code)
* onderzoek (observation.code)
* identificatienummer (subject)

(At this point in time, there are no use cases for filter parameters on the query. The stated query will return a Bundle with all known administered immunizations. Each immunization is conveyed in an Immunization resource. The Immunization resource will contain references to actors such as the Patient and the Health Professional/Organization. If those references are not in the Bundle, a client SHALL be able to resolve them at the source. The client may wish to have these references resolved in the Bundle by specifying the [http://hl7.org/fhir/R4/search.html#include {{fhir|_include}}] parameter on the query. The server SHALL support this {{fhir|_include}} parameter. It MAY include referenced resources even if the client doesn't ask for them if it doesn't support read operations for these resources.)

=====Expected actions=====
The XIS SHALL process the query to retrieve patient's (Laboratory results / Observation resources) and the included referenced resources.

===XIS/LIS: response message===
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching information.

====Trigger events====
The XIS/LIS completed processing of the retrieve vaccinations request message.

====Message semantics====
The returned data to the PHR should conform to the profiles listed in the table below. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the {{fhir|.meta.profile}} element in order to show compliance. 

{| class="wikitable"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
| FHIR Profiles||FHIR Resources||Based on zib (NL)||Based on zib (EN)
|-style="vertical-align:top; background-color: #E3E3E3; 
|-
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-LaboratoryTestResult|nictiz.fhir.nl.r4.zib2020|pkgVersion=0.3.0-beta1|title=nl-core-LaboratoryTestResult}}
| rowspan="2" | Observation
| LaboratoriumTest
| LaboratoryTest
|-
| LaboratoriumUitslag
| TestResult
|-
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-LaboratoryTestResult.Specimen|nictiz.fhir.nl.r4.zib2020|pkgVersion=0.3.0-beta1|title=nl-core-LaboratoryTestResult.Specimen}}
| | Specimen
| Monster
| Specimen
|-
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.zib2020|pkgVersion=0.3.0-beta1|title=nl-core-Patient}}
| Patient
| Patient
| Patient
|-
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.zib2020|pkgVersion=0.3.0-beta1|title=nl-core-HealthProfessional-Practitioner}}
| Practitioner
| rowspan="2" | Zorgverlener
| rowspan="2" | HealthProfessional
|-
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.zib2020|pkgVersion=0.3.0-beta1|title=nl-core-HealthProfessional-PractitionerRole}}
| PractionerRole
|-
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.zib2020|pkgVersion=0.3.0-beta1|title=nl-core-HealthcareProvider-Organization}}
| Organization 
| rowspan="2" | Zorgaanbieder
| rowspan="2" | HealthcareProvider
|-
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.zib2020|pkgVersion=0.3.0-beta1|title=nl-core-HealthcareProvider}}
| Location
|-
|}

====Expected actions====
The PHR SHALL process the results. The PHR SHOULD contain all the resources that match the query and all the reference resources that are included in the Bundle.

=Use case: Health professional sends lab results to other health professional=
The functional design distinguishes two use cases where lab results may be sent with something else or separate. The process of 'sending' things in FHIR works by means of a [http://hl7.org/fhir/r4/http.html#create RESTful 'create'] action. You could create a single Observation on another system using {{fhir|POST Observation}} and the appropriate Observation in the request body. When you have multiple Observations to create, you could do that for every single Observation, or by means of a Bundle with all resources. This same Bundle approach works for one Observation too. 

The added benefit from a Bundle lies in having a solution for all other resources you may want to send, e.g. MedicationRequest, and referenced resources, e.g. Patient and PractitionerRole | Practitioner | Organization. Sending the Observation without the things it references would only work if the receiving server can resolve those. They should then already exist on that server, with references to them or they should be accessible on the source. Without access to the references in the Observation, the target server may not know which patient is involved or what lab this result came from.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Send Laboratory Results(PUSH)
|style="background-color: white;vertical-align:top;"|Send laboratory results
|style="background-color: white;vertical-align:top;"|Healthcare professional (using an XIS)
|style="background-color: white;vertical-align:top;"|Send laboratory results to another XIS
|-
|style="background-color: white;vertical-align:top;"|Send laboratory results
|style="background-color: white;vertical-align:top;"|Healthcare professional (using an XIS)
|style="background-color: white;vertical-align:top;"|Receive laboratory results from another XIS
|}

==Invocations==
===XIS: request message===
The send lab results request message uses the HTTP POST method on the target XIS's base. Note that lab results may or may not be sent in tandem with other resources like MedicationRequest. The same principles apply with or without these other resources. The server can only process the incoming request correctly if it understands what is being sent which includes being able to resolve references.

====Trigger Events====
This message is invoked when the XIS needs to send one or more lab results observations to another XIS.

====Message Semantics====
Because sending laboratory results will most likely consist of multiple Observations, a {{fhir|batch}} operation is used. This allows for creating a set of resources in a single interaction and makes it possible to [[FHIR:Vdraft_FHIR_IG_R4#Referring_other_resources_when_sending_information|include referenced secondary resources]] if needed.

A {{term|batch}} interaction is performed by an HTTP POST command as shown:

<pre>POST [base]</pre>

The body of the post submission is a Bundle with {{fhir|Bundle.type}}={{term|batch}}. Each entry carries request details ({{fhir|Bundle.entry.request}}) that provides the HTTP details of the action in order to inform the system processing the batch or what to do for the entry. (Note: {{fhir|.request}} SHALL be present, even for the resources which aren't Observations. See [[FHIR:Vdraft_FHIR_IG_R4#Referring_other_resources_when_sending_information|the overarching principles]] for more information.)

'''Identification:'''

Sending systems SHALL have a stable identifier in the {{fhir|.identifier}} element for all Observation resources. Having stable identification is essential in detection of duplicates and potential clinical decision making issues deriving from duplicates. For more information on dealing with identifiers, see the [[FHIR:Vdraft_FHIR_IG_R4#Usage_of_the_.id.2C_.identifier_and_.fullUrl_elements_in_FHIR_instances|general FHIR IG]].

'''Links:'''

* [http://hl7.org/fhir/R4/http.html#batch batch]
* [http://hl7.org/fhir/R4/http.html#create create]

The laboratory result data sent to the XIS SHALL conform to the matching LaboratoryResult based profile. The table below lists profiles that represent applicable zibs for laboratory result information exchange.

{{MedMij:V2020.01/NoteBoxPackage|p1=nictiz.fhir.nl.r4.zib2020|v1=0.3.0-beta1}}

{| class="wikitable" 
|-style="background-color: #1F497D; color: white; font-weight: bold; "
| FHIR Profiles||FHIR Resources||style="width:150px;"|Based on zib (NL)||style="width:150px;"|Based on zib (EN)
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-patient|nictiz.fhir.nl.r4.zib2020|pkgVersion=0.3.0-beta1|title=nl-core-Patient}} ||Patiënt||Patient (M)||Patient
|-
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-healthprofessional-practitioner|pkgVersion=0.3.0-beta1|nictiz.fhir.nl.r4.zib2020|title=nl-core-HealthProfessional-Practitioner}}<br/> {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-healthprofessional-practitionerrole|nictiz.fhir.nl.r4.zib2020|pkgVersion=0.3.0-beta1|title=nl-core-HealthProfessional-PractitionerRole}}||Practitioner||Zorgverlener (M)||HealthProfessional
|-
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-laboratorytest|nictiz.fhir.nl.r4.zib2020|pkgVersion=0.3.0-beta1|title=nl-core-laboratorytest}} ||Observation||LaboratoriumUitslag(M)||LaboratoryTestResult
|}

=====Expected Actions=====
On receipt of the submission, the XIS SHALL:

* process creation of all Observation resources successfully or process no Observation
* match Patient, Practitioner(Role), Organization to pre-existing resources on that server
** The server MAY update pre-existing information with the incoming information
** The server MAY keep its pre-existing matching resources as-is
** The server SHALL create new resources if no matching resource is found (unknown patient, new physician in otherwise known organization, etc.)
* decide if any available Specimen resources are relevant
** If the server decides to ignore Specimen information, it SHALL not keep the {{fhir|Observation.specimen}} reference
* respond using HTTP 200 and a Bundle with detail in case of success. See [[FHIR:Vdraft_FHIR_IG_R4#Handling_errors|FHIR IG Handling Errors]] for response options in case of errors
** Note that the response Bundle with type {{term|batch-response}} SHALL be specific about how the server handled the request Bundle.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing outcome and returns a Bundle, of type {{term|batch-response}}, that contains one entry for each entry in the request, in the same order, with the outcome of processing the entry.

====Trigger Events====
The XIS completed processing of the send laboratory results request message.

====Message Semantics====
The XIS SHALL return a Bundle with type set to batch-response that contains one entry for each entry in the request, in the same order, with the outcome of processing the entry.

A client may use the returned Bundle to track the outcomes of processing the entry, and the identities assigned to the resources by the server. Each entry element SHALL contain a response element which details the outcome of processing the entry - the HTTP status code, and the location and ETag header values, which are used for identifying and versioning the resources. In addition, a resource may be included in the entry, as specified by the Prefer header.

Read more:
[http://hl7.org/fhir/R4/http.html#create create]
[http://hl7.org/fhir/R4/http.html#batch batch]

====Expected Actions====
The XIS server processes the results according to application-defined rules.

====Handling Errors====
The server may be unable to accept a Bundle due to errors or because of business rules (e.g. because of an unsupported code value in an Observation resource). Refer to the [FHIR:Vdraft_FHIR_IG_R4#Handling_errors#Handling_errors Handling Errors section] in the FHIR IG for more information.

=Use case: Health professional reports result leading into a notification "new lab results" for subscribed healthcare professional(s)=
'''DO'''