L2p:v2.0.0 FHIR lab2patient - Bewerkingsoverzicht

Michal Ciszewski: /* Patient retrieves laboratory results in their PGO */ Chaining parameters uitleg

2026-06-04T12:47:16Z

‎Patient retrieves laboratory results in their PGO: Chaining parameters uitleg

Michal Ciszewski: links aangepast

2026-06-04T12:45:45Z

links aangepast

Michal Ciszewski: /* Search parameters */

2026-06-04T12:43:32Z

‎Search parameters

Michal Ciszewski: link naar landingspagina aangepast

2026-06-04T10:55:46Z

link naar landingspagina aangepast

Michal Ciszewski op 4 jun 2026 om 10:54

2026-06-04T10:54:27Z

Michal Ciszewski: added a notice about semver

2026-06-04T10:53:36Z

added a notice about semver

Marija Zivlak op 2 jun 2026 om 08:18

2026-06-02T08:18:57Z

Marija Zivlak: Nieuwe pagina aangemaakt met ' {{DISPLAYTITLE: Technical Design Lab2patient v2.0.0-beta.1}} {{IssueBox| The FHIR resource used for the use case described in this technical d...'

2026-06-02T07:24:50Z

Nieuwe pagina aangemaakt met ' {{DISPLAYTITLE: Technical Design Lab2patient v2.0.0-beta.1}} {{IssueBox| The FHIR resource used for the use case described in this technical d...'

Nieuwe pagina

{{DISPLAYTITLE: Technical Design Lab2patient v2.0.0-beta.1}}

{{IssueBox| The FHIR resource used for the use case described in this technical design is DiagnosticReport. DiagnosticReport is not the preferred FHIR resource for the information standard Laboratory exchange. However, this resource has been chosen as it contains information about the order data. Optimally, order data could be linked directly to the preferred FHIR resource Observation via basedOn element. This will be updated in a future version.}}

<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[Lab:V1.0.1-beta.2_Ontwerp_Lab2Patient|Functional]]
circle 1787 230 212 [[Lab:V1.0-b2_FHIR_Lab2Patient|Technical]]
desc none
</imagemap>

<big>For an overview of all current documentation [[Lab:V3.0.0_Ontwerp_Laboverdacht| see information standard lab exchange main page]]</big>

__NUMBEREDHEADINGS__

==Introduction==
[[Bestand:Functioneel-02.png|link=Lab:V1.0.0-beta.2_Ontwerp_Lab2Patient|100px|rechts|Functional design|Go to functional design]]

This is the technical design (TO) for the information standard (IS) Lab2patient. This TO must be used together with the IS functional design, see [[Lab:V1.0.0-beta.2_Ontwerp_Lab2Patient| functional design Lab2patient 1.0.0-beta.2]]. The data exchange format used in this version is: FHIR R4.

=== Support ===
For questions, feedback, or change requests, please contact our support team at [https://nictiz.atlassian.net/servicedesk/customer/portal/4 Nictiz Servicemanagement].

=== Boundaries ===
This information standard may overlap with other standards related to identification, roles, and geographic classifications, requiring careful alignment to ensure consistency and avoid duplication. For more information, see [[Lab:V1.0.0-beta.2_Ontwerp_Lab2Patient| functional design Lab2patient 1.0.0-beta.2]].

=== Prerequisite knowledge ===
The following background information is required for understanding this TO:
* The [[Lab:V1.0.0-beta.2_Ontwerp_Lab2Patient| functional design Lab2patient 1.0.0-beta.2]] accompanying this TO.
* The data exchange format FHIR R4, which you can find here:
** [[FHIR:V1.0 FHIR IG R4|general FHIR R4 Implementation Guide]],
** [[FHIR:V1.0_FHIR_IG_R4#FHIR_Packages|FHIR packages]],
** [[FHIR:V1.0_FHIR_IG_R4#Usage_of_the_.id.2C_.identifier_and_.fullUrl_elements_in_FHIR_instances|usage of the .id, .identifier and .fullUrl]].

== Relationships ==

The diagram below shows the relationships between different FHIR profiles. The arrows indicate an “is referenced in” relationship.

For example, Patient → Laboratory Test means that the Patient is referenced within the Laboratory Test resource.

[[Bestand:FHIR-model-overview-L2P.png]]

==Components==

HL7 FHIR is used to accommodate the Dutch Clinical Information Models (zibs) used in the IS.

=== HL7 FHIR R4 ===
{{NoteBoxNictizR4Package|p1=nictiz.fhir.nl.r4.labexchange|v1=3.0.0-beta.4|p2=nictiz.fhir.nl.r4.nl-core|v2=0.12.0-labtrial.1|p3=nictiz.fhir.nl.r4.zib2020|v3=0.12.0-beta.1}}

==== Artifacts ====

The artifacts of the information standard are presented in the following table:
{| style="text-align: left; background-color: white;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib
! FHIR resource
! FHIR profile

|- style="background-color: #fcf0e9;"
| HealthcareProvider
| Organization
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.12.0-beta.1|title=nl-core-HealthcareProvider-Organization}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional
| Practitioner
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.12.0-beta.1|title=nl-core-HealthProfessional-Practitioner}}

|- style="background-color: #fcf0e9;"
| PractitionerRole
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.12.0-beta.1|title=nl-core-HealthProfessional-PractitionerRole}}

|- style="background-color: #fcf0e9;"
| rowspan="3" | LaboratoryTestResult
| Device
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-LaboratoryTestResult.Specimen.Source|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.7.0-beta.1|title=nl-core-LaboratoryTestResult.Specimen.Source}}

|- style="background-color: #fcf0e9;"
| Observation
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-LaboratoryTestResult|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.12.0-labtrial.1|title=nl-core-LaboratoryTestResult}}

|- style="background-color: #fcf0e9;"
| Specimen
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-LaboratoryTestResult.Specimen|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.12.0-beta.1|title=nl-core-LaboratoryTestResult.Specimen}}

|- style="background-color: #fcf0e9;"
| Patient
| Patient
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.12.0-beta.1|title=nl-core-Patient}}

|- style="background-color: #fcf0e9;"
|
| DiagnosticReport
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/lu-LaboratoryTestResult-DiagnosticReport|nictiz.fhir.nl.r4.labexchange|pkgVersion=3.0.0-beta.4|title=lu-LaboratoryTestResult-DiagnosticReport}}

|- style="background-color: #fcf0e9;"
|
| ServiceRequest
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/lu-OrderData|nictiz.fhir.nl.r4.labexchange|pkgVersion=3.0.0-beta.4|title=lu-OrderData}}
|}

==== Examples of FHIR instances ====
You can find examples of FHIR-instances (filled-in FHIR profiles) in the Nictiz GitHub repository: [https://github.com/Nictiz/HL7-mappings/tree/master/ada_2_fhir-r4/lab/1.0.0-alpha.1 <nowiki>Lab exchange HL7-mappings repository</nowiki>].

== Transactions ==
=== Patient retrieves laboratory results in their PGO ===
==== Involved actors ====
{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! Transaction group || Transaction || Actor || System role code

|- style="background-color: #fcf0e9;"
| rowspan="2" | Retrieve laboratory results (PULL)
| Retrieve laboratory results request || Client || LAB-LRR-PGO

|- style="background-color: #fcf0e9;"
| Retrieve laboratory results response || Server || LAB-LRB-PGO

|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''Abbreviations: LAB = Laboratorium, LRR = Laboratoriumresultaat raadplegend (systeem), LRB = Laboratoriumresultaat beschikbaarstellend (systeem), PGO = Persoonlijke gezondheidsomgeving.''
|}

==== Search parameters ====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! FHIR Search Parameter || Description || FHIR Resource || Example

|- style="color: white; background-color: #eda778;"
! colspan="4" | Retrieve laboratory results (Observation search)

|- style="background-color: #fcf0e9;"
| category || Restrict search to laboratory observations || Observation || <pre>GET [base]/Observation?category=http://terminology.hl7.org/CodeSystem/observation-category|laboratory</pre>

|- style="background-color: #fcf0e9;"
| code || Filter by laboratory test code (LOINC/NHG) || Observation || <pre>GET [base]/Observation?category=http://terminology.hl7.org/CodeSystem/observation-category|laboratory&code=http://loinc.org|14683-7</pre>

|- style="background-color: #fcf0e9;"
| date || Filter results based on observation date || Observation || <pre>GET [base]/Observation?category=http://terminology.hl7.org/CodeSystem/observation-category|laboratory&date=gt2022-03-12&date=lt2022-06-07</pre>

|- style="color: white; background-color: #eda778;"
! colspan="4" | Retrieve latest laboratory results ($lastn operation)

|- style="background-color: #fcf0e9;"
| $lastn || Retrieve most recent lab results using the $lastn operation || Observation || <pre>GET [base]/Observation/$lastn?max=5&category=http://terminology.hl7.org/CodeSystem/observation-category|laboratory&code=http://loinc.org|14683-7</pre>

|- style="color: white; background-color: #eda778;"
! colspan="4" | Retrieve related resources

|- style="background-color: #fcf0e9;"
| _include || Include linked resources (Specimen, Patient, Organization) in the response bundle || Observation || <pre>GET [base]/Observation?category=http://terminology.hl7.org/CodeSystem/observation-category|laboratory&_include=Observation:specimen&_include=Observation:patient&_include=Observation:performer</pre>

|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''All queries are executed in the authenticated patient context as per MedMij Afsprakenstelsel; no patient search parameters are used.''
|}

← Oudere versie		Versie van 4 jun 2026 om 12:47
Regel 181:		Regel 181:

	For the DiagnosticReport search, the parameters {{fhir\|result.category}} SHALL be included within every search request. The parameters {{fhir\|result.code}}, {{fhir\|_include}}, and {{fhir\|_include:iterate}} can be repeated; {{fhir\|result.code}} supports combination with AND or OR, while {{fhir\|_include}} and {{fhir\|_include:iterate}} support combination with AND only. In FHIR search, OR logic is used when multiple values are supplied for the same search parameter (comma-separated), meaning a resource matches if any of the values apply. AND logic is used when a search parameter is to be repeated, meaning the resource must satisfy all of the specified conditions.		For the DiagnosticReport search, the parameters {{fhir\|result.category}} SHALL be included within every search request. The parameters {{fhir\|result.code}}, {{fhir\|_include}}, and {{fhir\|_include:iterate}} can be repeated; {{fhir\|result.code}} supports combination with AND or OR, while {{fhir\|_include}} and {{fhir\|_include:iterate}} support combination with AND only. In FHIR search, OR logic is used when multiple values are supplied for the same search parameter (comma-separated), meaning a resource matches if any of the values apply. AND logic is used when a search parameter is to be repeated, meaning the resource must satisfy all of the specified conditions.
		+
		+	==== Chaining parameters ====
		+
		+	Chained search parameters are used to apply criteria to resources referenced by {{fhir\|DiagnosticReport}}. In this use case, Observation criteria are applied through {{fhir\|DiagnosticReport.result}}, for example by using {{fhir\|result.code}}, {{fhir\|result.category}}, and {{fhir\|result.date}} to search for reports that reference matching Observations. For more information on chaining, consult [https://build.fhir.org/search.html#chaining FHIR specification].

	==== Most recent functionality ====		==== Most recent functionality ====

← Oudere versie		Versie van 4 jun 2026 om 10:54
Regel 1:		Regel 1:
	<!--__NOINDEX__-->		<!--__NOINDEX__-->
−
	{{DISPLAYTITLE: Technical Design Lab2patient v2.0.0-beta.1}}		{{DISPLAYTITLE: Technical Design Lab2patient v2.0.0-beta.1}}

← Oudere versie		Versie van 4 jun 2026 om 10:53
Regel 3:		Regel 3:
	{{DISPLAYTITLE: Technical Design Lab2patient v2.0.0-beta.1}}		{{DISPLAYTITLE: Technical Design Lab2patient v2.0.0-beta.1}}

		+	''The Information Standard Lab Exchange consists of four different components: Lab2Zorg, Lab2Lab, Lab2PublicHealth, and Lab2Patient. These four components were developed independently of each other and are subject to continuous development. This is reflected in the Semantic Versioning (SemVer). Each component undergoes its own development process with its own corresponding numerical publications.''

	{{IssueBox\| The FHIR resource used for the use case described in this technical design is DiagnosticReport. DiagnosticReport is not the preferred FHIR resource for the information standard Laboratory exchange. However, this resource has been chosen as it contains information about the order data. Optimally, order data could be linked directly to the preferred FHIR resource Observation via basedOn element. This will be updated in a future version.}}		{{IssueBox\| The FHIR resource used for the use case described in this technical design is DiagnosticReport. DiagnosticReport is not the preferred FHIR resource for the information standard Laboratory exchange. However, this resource has been chosen as it contains information about the order data. Optimally, order data could be linked directly to the preferred FHIR resource Observation via basedOn element. This will be updated in a future version.}}

@@ Regel 8: / Regel 8: @@
 <imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
 circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
-circle 1013 224 212 [[https://informatiestandaarden.nictiz.nl/wiki/L2p:v2.0.0_ontwerp_lab2patient|Functional]]
+circle 1013 224 212 [[L2p:v2.0.0_ontwerp_lab2patient|Functional]]
-circle 1787 230 212 [[Lab:V1.0-b2_FHIR_Lab2Patient|Technical]]
+circle 1787 230 212 [[L2p:v2.0.0_FHIR_lab2patient|Technical]]
 desc none
 </imagemap>

@@ Regel 125: / Regel 125: @@
 |}
-==== Search parameters ====
+==== FHIR Search parameters ====
-{| style="text-align: left;" cellpadding=5px;
+The search interaction is performed by an HTTP GET in agreement with the [http://hl7.org/fhir/R4/search.html FHIR specification]. The table below lists search parameters for DiagnosticReport resource that SHALL be supported for processing by servers and clients.
 |- style="color: white; background-color: #e7844b;"
-! FHIR Search Parameter || Description || FHIR Resource || Example
+! Variation type || Variation || Permitted values (if limited) || Data type || Description
 |- style="color: white; background-color: #eda778;"
-! colspan="4"  | Retrieve laboratory results (Observation search)
+! colspan="5"  | result.category
 |- style="background-color: #fcf0e9;"
-| category || Restrict search to laboratory observations || Observation || <pre>GET [base]/Observation?category=http://terminology.hl7.org/CodeSystem/observation-category|laboratory</pre>
+| || || {{fhir|<nowiki>https://terminology.hl7.org/CodeSystem/observation-category|laboratory</nowiki>}} || {{fhir|token}} || Search DiagnosticReports that reference laboratory Observations.
 |- style="background-color: #fcf0e9;"
-| code || Filter by laboratory test code (LOINC/NHG) || Observation || <pre>GET [base]/Observation?category=http://terminology.hl7.org/CodeSystem/observation-category|laboratory&code=http://loinc.org|14683-7</pre>
+| code system || LOINC || {{fhir|<nowiki>http://loinc.org|[test code]</nowiki>}} || {{fhir|token}} || Search on the LOINC test code
 |- style="background-color: #fcf0e9;"
-| date || Filter results based on observation date || Observation || <pre>GET [base]/Observation?category=http://terminology.hl7.org/CodeSystem/observation-category|laboratory&date=gt2022-03-12&date=lt2022-06-07</pre>
+| code system || NHG || {{fhir|<nowiki>https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen|[test code]</nowiki>}} || {{fhir|token}} || Search on the NHG test code
 |- style="color: white; background-color: #eda778;"
-! colspan="4" | Retrieve latest laboratory results ($lastn operation)
+! colspan="5"  | result.date
 |- style="background-color: #fcf0e9;"
-| $lastn || Retrieve most recent lab results using the $lastn operation || Observation || <pre>GET [base]/Observation/$lastn?max=5&category=http://terminology.hl7.org/CodeSystem/observation-category|laboratory&code=http://loinc.org|14683-7</pre>
+| prefix || {{fhir|lt}} || || {{fhir|date}} || Search on observation date earlier than the value
 |- style="color: white; background-color: #eda778;"
-! colspan="4" | Retrieve related resources
+! colspan="5"  | _include
 |- style="background-color: #fcf0e9;"
-| _include || Include linked resources (Specimen, Patient, Organization) in the response bundle || Observation || <pre>GET [base]/Observation?category=http://terminology.hl7.org/CodeSystem/observation-category|laboratory&_include=Observation:specimen&_include=Observation:patient&_include=Observation:performer</pre>
+| resource || {{fhir|ServiceRequest}} || {{fhir|DiagnosticReport:basedOn}} || {{fhir|reference}} || Include linked ServiceRequest resources in the response bundle.
-|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''All queries are executed in the authenticated patient context as per MedMij Afsprakenstelsel; no patient search parameters are used.''
+|+ style="align: bottom; caption-side: bottom; text-align: left;" |
 |}

@@ Regel 13: / Regel 13: @@
 </imagemap>
-<big>For an overview of all current documentation [[Lab:V3.0.0_Ontwerp_Laboverdacht| see information standard lab exchange main page]]</big>
+<big>For an overview of all current documentation [[Landingspagina_Labuitwisseling| see information standard lab exchange main page]]</big>
 __NUMBEREDHEADINGS__