cio:V2.0.0 FHIR CiO: verschil tussen versies

Uit informatiestandaarden
Ga naar: navigatie, zoeken
k (Mappings between profiles and data set)
(Versie 192049 van Luud Slagter (overleg) ongedaan gemaakt)
(Label: Ongedaan maken)
 
(15 tussenliggende versies door dezelfde gebruiker niet weergegeven)
Regel 1: Regel 1:
{{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=V2.0.0|namespace=cio}} BITS].}}
+
{{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=V2.0.0-beta.1|namespace=cio}} BITS].}}
  
 
__NUMBEREDHEADINGS__
 
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:FHIR Implementation Guide CiO version {{VersieInfo|CiO|release=V2.0.0|namespace=cio}}}}
+
{{DISPLAYTITLE:FHIR Implementation Guide CiO version {{VersieInfo|CiO|release=V2.0.0-beta.1|namespace=cio}}}}
  
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard Medicatieproces.svg|link=|100px|CiO|rechts]]  
+
[[Bestand:Icoon Nictiz Cirkel Informatiestandaard Contra-indicaties en Overgevoeligheden (2).svg|link=|100px|CiO|rechts]]  
  
 
<div class="toclimit-3">__TOC__</div>
 
<div class="toclimit-3">__TOC__</div>
Regel 10: Regel 10:
 
= Introduction =
 
= Introduction =
  
This is the implementation guide (IG) for the information standard CiO (Dutch: Contra-indicaties en overgevoeligheden, English: Contraindications and intolerances), version {{VersieInfo|CiO|release=V2.0.0}}. The functional specification can be found [[cio:V2.0.0_Ontwerp_CiO|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 this version of FHIR.
+
This is the implementation guide (IG) for the information standard CiO (Dutch: Contra-indicaties en overgevoeligheden, English: Contraindications and intolerances), version {{VersieInfo|CiO|release=V2.0.0-beta.1}}. The functional specification can be found [[cio:V2.0.0_Ontwerp_CiO|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 this version of FHIR.
  
 
Apart from this document, the guidelines as specified in the [[FHIR:V1.0_FHIR_IG_R4|general FHIR Implementation Guide]] apply. In particular, the reader should take note of the Overarching principles and the use of FHIR packages. Where the general IG uses the term ‘use case’, this IG uses the term ‘transaction’ for the various processes that are described.
 
Apart from this document, the guidelines as specified in the [[FHIR:V1.0_FHIR_IG_R4|general FHIR Implementation Guide]] apply. In particular, the reader should take note of the Overarching principles and the use of FHIR packages. Where the general IG uses the term ‘use case’, this IG uses the term ‘transaction’ for the various processes that are described.
Regel 24: Regel 24:
 
== Building blocks and profiles ==
 
== Building blocks and profiles ==
  
The exchange of data within the CiO standard version {{VersieInfo|CiO|release=V2.0.0}} is partly based on the 2020 publication of the Dutch Health and Care Information Models (Dutch: ‘zorginformatiebouwstenen’ or ‘zibs’), and subsequent changes made that are present in the 2022 prepublication. In particular, the prepublication of 2021 saw the introduction of the Hypersensitivity and Reaction zibs which are based on and still have quite some overlap with the zib AllergyIntolerance that already existed. The functional data set of CiO has further built upon the former two zibs (renaming the first as HypersensitivityDisposition), next to the zib MedicationContraIndication. These objects (which are actually exchanged) are referred to as ‘building blocks’ in the data set, and can thus be seen as ‘extended zibs’ suitable for implementation.
+
The exchange of data within the CiO standard version {{VersieInfo|CiO|release=V2.0.0-beta.1}} is partly based on the 2020 publication of the Dutch Health and Care Information Models (Dutch: ‘zorginformatiebouwstenen’ or ‘zibs’), and subsequent changes made that are present in the 2022 prepublication. In particular, the prepublication of 2021 saw the introduction of the Hypersensitivity and Reaction zibs which are based on and still have quite some overlap with the zib AllergyIntolerance that already existed. The functional data set of CiO has further built upon the former two zibs (renaming the first as HypersensitivityDisposition), next to the zib MedicationContraIndication. These objects (which are actually exchanged) are referred to as ‘building blocks’ in the data set, and can thus be seen as ‘extended zibs’ suitable for implementation.
  
 
Due to new insights, the building blocks HypersensitivityDisposition and Reaction in the functional data set have deviated quite a lot from the zib AllergyIntolerance present in the 2020 publication, making them incompatible in varying degrees from a technical point of view. Therefore it was not possible to implement the FHIR profiles for these building blocks by building on and extending [[FHIR:V1.0_FHIR_IG_R4#Functional_definitions|the nl-core profiles]] based on zib publication 2020. Hence the profiles for these building blocks have been created ‘independently’ from the nl-core profiles, meaning that they are not derived from nl-core-AllergyIntolerance. For the building block MedicationContraIndication on the other hand, the changes made within CiO are quite minimal with respect to its zib 2020 counterpart, making it possible to derive from nl-core-MedicationContraIndication.
 
Due to new insights, the building blocks HypersensitivityDisposition and Reaction in the functional data set have deviated quite a lot from the zib AllergyIntolerance present in the 2020 publication, making them incompatible in varying degrees from a technical point of view. Therefore it was not possible to implement the FHIR profiles for these building blocks by building on and extending [[FHIR:V1.0_FHIR_IG_R4#Functional_definitions|the nl-core profiles]] based on zib publication 2020. Hence the profiles for these building blocks have been created ‘independently’ from the nl-core profiles, meaning that they are not derived from nl-core-AllergyIntolerance. For the building block MedicationContraIndication on the other hand, the changes made within CiO are quite minimal with respect to its zib 2020 counterpart, making it possible to derive from nl-core-MedicationContraIndication.
Regel 37: Regel 37:
 
For both profiling approaches the technical implementation will be explained in this IG, for instance with respect to details within their profiles, or definitions of search requests/parameters in which the underlying FHIR resources are mentioned. After a definitive approach has been chosen, only the relevant sections will remain in subsequent versions of this IG.
 
For both profiling approaches the technical implementation will be explained in this IG, for instance with respect to details within their profiles, or definitions of search requests/parameters in which the underlying FHIR resources are mentioned. After a definitive approach has been chosen, only the relevant sections will remain in subsequent versions of this IG.
  
{{NoteBoxNictizR4Package|p1=nictiz.fhir.nl.r4.cio|v1=2.0.0-beta.1|p2=nictiz.fhir.nl.r4.medicationprocess9|v2=2.0.0-beta.1|p3=nictiz.fhir.nl.r4.nl-core|v3=0.9.0-beta.1}}
+
{{NoteBoxNictizR4Package|p1=nictiz.fhir.nl.r4.cio|v1={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}|p2=nictiz.fhir.nl.r4.medicationprocess9|v2={{VersieInfo|nictiz.fhir.nl.r4.medicationprocess9|release=V2.0.0-beta.1|namespace=cio}}|p3=nictiz.fhir.nl.r4.nl-core|v3={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
  
 
=== Main building blocks ===
 
=== Main building blocks ===
Regel 52: Regel 52:
 
| Overgevoeligheid
 
| Overgevoeligheid
 
| rowspan="2" | AllergyIntolerance
 
| rowspan="2" | AllergyIntolerance
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDispositionReaction|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1}}
+
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDispositionReaction|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Reaction
 
| Reaction
Regel 60: Regel 60:
 
| Overgevoeligheid
 
| Overgevoeligheid
 
| Condition
 
| Condition
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDisposition|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDisposition|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Reaction
 
| Reaction
 
| Reactie
 
| Reactie
 
| Observation
 
| Observation
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-Reaction|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-Reaction|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| MedicationContraIndication
 
| MedicationContraIndication
 
| MedicatieContraIndicatie
 
| MedicatieContraIndicatie
 
| Flag
 
| Flag
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-MedicationContraIndication|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-MedicationContraIndication|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}}}
 
|}
 
|}
  
Regel 86: Regel 86:
 
| Patient
 
| Patient
 
| Patient
 
| Patient
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| rowspan="2" | HealthProfessional
 
| rowspan="2" | HealthProfessional
 
| rowspan="2" | Zorgverlener
 
| rowspan="2" | Zorgverlener
 
| PractitionerRole
 
| PractitionerRole
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Practitioner
 
| Practitioner
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| rowspan="2" | HealthcareProvider
 
| rowspan="2" | HealthcareProvider
 
| rowspan="2" | Zorgaanbieder
 
| rowspan="2" | Zorgaanbieder
 
| Location
 
| Location
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Organization
 
| Organization
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| MedicationAgreement
 
| MedicationAgreement
 
| Medicatieafspraak
 
| Medicatieafspraak
 
| MedicationRequest
 
| MedicationRequest
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationAgreement|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationAgreement|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.medicationprocess9|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| AdministrationAgreement
 
| AdministrationAgreement
 
| Toedieningsafspraak
 
| Toedieningsafspraak
 
| MedicationDispense
 
| MedicationDispense
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-AdministrationAgreement|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-AdministrationAgreement|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.medicationprocess9|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| MedicationDispense
 
| MedicationDispense
 
| Medicatieverstrekking
 
| Medicatieverstrekking
 
| MedicationDispense
 
| MedicationDispense
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationDispense|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationDispense|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.medicationprocess9|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| MedicationUse2
 
| MedicationUse2
 
| Medicatiegebruik2
 
| Medicatiegebruik2
 
| MedicationStatement
 
| MedicationStatement
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationUse2|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationUse2|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.medicationprocess9|release=V2.0.0-beta.1|namespace=cio}}}}
 
|}
 
|}
  
Regel 137: Regel 137:
 
Each transaction starts with links to the functional definition in an ART-DECOR publication and references one or several FHIR profiles. The FHIR profiles contain mappings to all data elements that are present in the functional data set (prefixed with ‘cio-dataelement-20-’).
 
Each transaction starts with links to the functional definition in an ART-DECOR publication and references one or several FHIR profiles. The FHIR profiles contain mappings to all data elements that are present in the functional data set (prefixed with ‘cio-dataelement-20-’).
  
Each transaction contains a Patient building block with cardinality 1..1 M. This patient is the subject of all other building blocks in the transaction, although no explicit relation exists in the data set. Therefore, a reference to a Patient resource conforming to the nl-core-Patient profile is expected in {{fhir|.subject}} (or {{fhir|.patient}} in the case of the AllergyIntolerance resource) of each FHIR instance of each main building block.
+
Each transaction contains a Patient building block with cardinality 1..1 M. This patient is the subject of all other building blocks in the transaction, although no explicit relation exists in the data set. Therefore, a reference to a Patient resource conforming to the nl-core-Patient profile is expected in {{fhir|.subject}} or {{fhir|.patient}} of each FHIR instance of each main building block (with the exception of RegistrationData).
  
Relations between different building blocks exist in transactions by means of concepts with a name starting with ‘Relation…’ (Dutch: ‘Relatie…’) and an underlying concept 'Identification' of data type Identification, for example RelationHypersensitivityDisposition (cio-dataelement-20-734) in building block HypersensitivityDisposition. These relations are mapped to the FHIR data type ‘Reference’. Implementers SHOULD use literal references (using {{fhir|.reference}}) instead of logical references (using {{fhir|.identifier}}) where possible, see the [[FHIR:V1.0_FHIR_IG_R4#Use_of_the_reference_data_type|general FHIR IG on the Reference data type]].
+
Relations between different building blocks exist in transactions by means of concepts with a name starting with ‘Relation…’ (Dutch: ‘Relatie…’) and an underlying concept 'Identification' of data type Identification, for example RelationHypersensitivity (cio-dataelement-20-734) in building block Hypersensitivity. These relations are mapped to the FHIR data type ‘Reference’. Implementers SHOULD use literal references (using {{fhir|.reference}}) instead of logical references (using {{fhir|.identifier}}) where possible, see the [[FHIR:V1.0_FHIR_IG_R4#Use_of_the_reference_data_type|general FHIR IG on the Reference data type]].
  
 
== Patient identification ==
 
== Patient identification ==
Regel 154: Regel 154:
 
* Flag: {{fhir|patient.identifier}} and {{fhir|subject:Patient.identifier}}
 
* Flag: {{fhir|patient.identifier}} and {{fhir|subject:Patient.identifier}}
  
An example of a request that retrieves all AllergyIntolerance resources of a patient with a fake BSN of 11122233:
+
An example of a request that retrieves all AllergyIntolerance resources of a patient with a fake BSN of 111222333:
  
 
<pre>GET [base]/AllergyIntolerance?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>
 
<pre>GET [base]/AllergyIntolerance?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>
Regel 169: Regel 169:
  
 
{| class="wikitable" "cellpadding="10"
 
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
+
! style="font-weight: bold;text-align:left;"| Transaction group
! style="text-align:left;"| '''Transaction'''
+
! style="font-weight: bold;text-align:left;"| Transaction
! style="text-align:left;"| '''Actor'''
+
! style="font-weight: bold;text-align:left;"| Actor
! style="text-align:left;"| '''System role'''
+
! style="font-weight: bold;text-align:left;"| System role
! style="text-align:left;"| '''FHIR CapabilityStatement'''
+
! style="font-weight: bold;text-align:left;"| FHIR CapabilityStatement
 
|-
 
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|[https://decor.nictiz.nl/ad/#/cio-/scenarios/scenarios/2.16.840.1.113883.2.4.3.11.60.26.4.16/2020-06-22T10:18:30 Contraindication (PULL)]  
+
|style="background-color: white;vertical-align:top;" rowspan="2"|[https://decor.nictiz.nl/pub/cio/cio-html-20230424T150542/sc-2.16.840.1.113883.2.4.3.11.60.26.3.2-2019-08-28T133341.html#_2.16.840.1.113883.2.4.3.11.60.26.4.16_20200622101830 Contraindication (PULL)]  
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/ad/#/cio-/scenarios/scenarios/2.16.840.1.113883.2.4.3.11.60.26.4.17/2020-06-22T10:18:30 Retrieving contraindications]
+
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/pub/cio/cio-html-20230424T150542/tr-2.16.840.1.113883.2.4.3.11.60.26.4.17-2020-06-22T101830.html Retrieving contraindications]
 
|style="background-color: white;vertical-align:top;"|Client  
 
|style="background-color: white;vertical-align:top;"|Client  
 
|style="background-color: white;vertical-align:top;"|CIO-CIR
 
|style="background-color: white;vertical-align:top;"|CIO-CIR
|style="background-color: white;vertical-align:top;" rowspan="2"|{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/cio-Contraindications.RetrieveServe|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1|title=CapabilityStatement Retrieve/serve contraindications}}
+
|style="background-color: white;vertical-align:top;" rowspan="2"|{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/cio-Contraindications.RetrieveServe|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}|title=CapabilityStatement Retrieve/serve contraindications}}
 
|-
 
|-
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/ad/#/cio-/scenarios/scenarios/2.16.840.1.113883.2.4.3.11.60.26.4.18/2020-06-22T10:18:30 Serving contraindications]
+
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/pub/cio/cio-html-20230424T150542/tr-2.16.840.1.113883.2.4.3.11.60.26.4.18-2020-06-22T101830.html Serving contraindications]
 
|style="background-color: white;vertical-align:top;"|Server
 
|style="background-color: white;vertical-align:top;"|Server
 
|style="background-color: white;vertical-align:top;"|CIO-CIB
 
|style="background-color: white;vertical-align:top;"|CIO-CIB
Regel 214: Regel 214:
 
| PatientIdentificationNumber
 
| PatientIdentificationNumber
 
| Search on patient.
 
| Search on patient.
| {{fhir|patient.identifier}} <ref name="patient-searchparameter">This search parameter only needs to be supported when patient identification requires the use of search parameters, see [[#Patient_identification|section 2.3]].</ref>
+
| {{fhir|patient.identifier}} <ref name="patient-searchparameter">This search parameter only needs to be supported when patient identification requires the use of search parameters, see [[#Patient_identification|section 2.4]].</ref>
 
| Flag
 
| Flag
| Retrieves all MedicationContraIndication building blocks of a patient with a fake BSN of 11122233.
+
| Retrieves all MedicationContraIndication building blocks of a patient with a fake BSN of 111222333.
 
<pre>GET [base]/Flag?category=http://snomed.info/sct|140401000146105&patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>
 
<pre>GET [base]/Flag?category=http://snomed.info/sct|140401000146105&patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>
 
|-
 
|-
 
| ReferenceDate
 
| ReferenceDate
 
| Search on the MedicationContraIndication building blocks that have been registered on or after a certain date.
 
| Search on the MedicationContraIndication building blocks that have been registered on or after a certain date.
| {{fhir|recorded-date}}<ref name="custom-searchparameter"/>
+
| {{fhir|registration-date-time}}<ref name="custom-searchparameter"/>
 
| Flag
 
| Flag
 
| Retrieves all MedicationContraIndication building blocks that were registered from 01-05-2023.
 
| Retrieves all MedicationContraIndication building blocks that were registered from 01-05-2023.
<pre>GET [base]/Flag?category=http://snomed.info/sct|140401000146105&recorded-date=ge2023-05-01</pre>
+
<pre>GET [base]/Flag?category=http://snomed.info/sct|140401000146105&registration-date-time=ge2023-05-01</pre>
 
|-
 
|-
 
| -
 
| -
Regel 231: Regel 231:
 
| {{fhir|<nowiki>_include=Flag:patient</nowiki>}}
 
| {{fhir|<nowiki>_include=Flag:patient</nowiki>}}
 
| Flag
 
| Flag
| Retrieves all MedicationContraIndication building blocks of a patient with a fake BSN of 11122233 and includes the Patient resource in the search results.
+
| Retrieves all MedicationContraIndication building blocks of a patient with a fake BSN of 111222333 and includes the Patient resource in the search results.
 
<pre>GET [base]/Flag?category=http://snomed.info/sct|140401000146105&patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333&_include=Flag:patient</pre>
 
<pre>GET [base]/Flag?category=http://snomed.info/sct|140401000146105&patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333&_include=Flag:patient</pre>
 
|}
 
|}
Regel 237: Regel 237:
 
The following custom search parameters are defined for this transaction:
 
The following custom search parameters are defined for this transaction:
  
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/flag-category|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1}}
+
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/Flag-category|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/flag-recorded-date|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1}}
+
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/Flag-registration-date-time|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}}}
  
 
=== Serve (response message) ===
 
=== Serve (response message) ===
Regel 257: Regel 257:
 
| MedicatieContraIndicatie
 
| MedicatieContraIndicatie
 
| Flag
 
| Flag
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-MedicationContraIndication|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-MedicationContraIndication|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Patient
 
| Patient
 
| Patient
 
| Patient
 
| Patient
 
| Patient
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| rowspan="2" | HealthProfessional
 
| rowspan="2" | HealthProfessional
 
| rowspan="2" | Zorgverlener
 
| rowspan="2" | Zorgverlener
 
| PractitionerRole
 
| PractitionerRole
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Practitioner
 
| Practitioner
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| HealthcareProvider
 
| HealthcareProvider
 
| Zorgaanbieder
 
| Zorgaanbieder
 
| Organization
 
| Organization
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|}
 
|}
  
Regel 283: Regel 283:
  
 
{| class="wikitable" "cellpadding="10"
 
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
+
! style="font-weight: bold;text-align:left;"| Transaction group
! style="text-align:left;"| '''Transaction'''
+
! style="font-weight: bold;text-align:left;"| Transaction
! style="text-align:left;"| '''Actor'''
+
! style="font-weight: bold;text-align:left;"| Actor
! style="text-align:left;"| '''System role'''
+
! style="font-weight: bold;text-align:left;"| System role
! style="text-align:left;"| '''FHIR CapabilityStatement'''
+
! style="font-weight: bold;text-align:left;"| FHIR CapabilityStatement
 
|-
 
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|[https://decor.nictiz.nl/ad/#/cio-/scenarios/scenarios/2.16.840.1.113883.2.4.3.11.60.26.4.10/2020-06-22T10:17:11 Contraindication (PUSH)]  
+
|style="background-color: white;vertical-align:top;" rowspan="2"|[https://decor.nictiz.nl/pub/cio/cio-html-20230424T150542/sc-2.16.840.1.113883.2.4.3.11.60.26.3.2-2019-08-28T133341.html#_2.16.840.1.113883.2.4.3.11.60.26.4.10_20200622101711 Contraindication (PUSH)]  
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/ad/#/cio-/scenarios/scenarios/2.16.840.1.113883.2.4.3.11.60.26.4.11/2020-06-22T10:17:11 Sending contraindications]
+
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/pub/cio/cio-html-20230424T150542/tr-2.16.840.1.113883.2.4.3.11.60.26.4.11-2020-06-22T101711.html Sending contraindications]
 
|style="background-color: white;vertical-align:top;"|Client  
 
|style="background-color: white;vertical-align:top;"|Client  
 
|style="background-color: white;vertical-align:top;"|CIO-CIS
 
|style="background-color: white;vertical-align:top;"|CIO-CIS
|style="background-color: white;vertical-align:top;" rowspan="2"|{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/cio-ContraIndications.SendReceive|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1|title=CapabilityStatement Send/receive contraindications}}
+
|style="background-color: white;vertical-align:top;" rowspan="2"|{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/cio-ContraIndications.SendReceive|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}|title=CapabilityStatement Send/receive contraindications}}
 
|-
 
|-
 
|style="background-color: white;vertical-align:top;"|Receiving contraindications
 
|style="background-color: white;vertical-align:top;"|Receiving contraindications
Regel 329: Regel 329:
 
| MedicatieContraIndicatie
 
| MedicatieContraIndicatie
 
| Flag
 
| Flag
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-MedicationContraIndication|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-MedicationContraIndication|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Patient
 
| Patient
 
| Patient
 
| Patient
 
| Patient
 
| Patient
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| rowspan="2" | HealthProfessional
 
| rowspan="2" | HealthProfessional
 
| rowspan="2" | Zorgverlener
 
| rowspan="2" | Zorgverlener
 
| PractitionerRole
 
| PractitionerRole
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Practitioner
 
| Practitioner
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| HealthcareProvider
 
| HealthcareProvider
 
| Zorgaanbieder
 
| Zorgaanbieder
 
| Organization
 
| Organization
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|}
 
|}
  
Regel 357: Regel 357:
  
 
{| class="wikitable" "cellpadding="10"
 
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
+
! style="font-weight: bold;text-align:left;"| Transaction group
! style="text-align:left;"| '''Transaction'''
+
! style="font-weight: bold;text-align:left;"| Transaction
! style="text-align:left;"| '''Actor'''
+
! style="font-weight: bold;text-align:left;"| Actor
! style="text-align:left;"| '''System role'''
+
! style="font-weight: bold;text-align:left;"| System role
! style="text-align:left;"| '''FHIR CapabilityStatement'''
+
! style="font-weight: bold;text-align:left;"| FHIR CapabilityStatement
 
|-
 
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|[https://decor.nictiz.nl/ad/#/cio-/scenarios/scenarios/2.16.840.1.113883.2.4.3.11.60.26.4.34/2020-10-21T15:06:32 Hypersensitivity Disposition (PULL)]  
+
|style="background-color: white;vertical-align:top;" rowspan="2"|[https://decor.nictiz.nl/pub/cio/cio-html-20230424T150542/sc-2.16.840.1.113883.2.4.3.11.60.26.3.2-2019-08-28T133341.html#_2.16.840.1.113883.2.4.3.11.60.26.4.34_20201021150632 Hypersensitivity Disposition (PULL)]  
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/ad/#/cio-/scenarios/scenarios/2.16.840.1.113883.2.4.3.11.60.26.4.35/2020-10-21T15:06:32 Retrieving hypersensitivity dispositions]
+
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/pub/cio/cio-html-20230424T150542/tr-2.16.840.1.113883.2.4.3.11.60.26.4.35-2020-10-21T150632.html Retrieving hypersensitivity dispositions]
 
|style="background-color: white;vertical-align:top;"|Client  
 
|style="background-color: white;vertical-align:top;"|Client  
 
|style="background-color: white;vertical-align:top;"|CIO-OVR
 
|style="background-color: white;vertical-align:top;"|CIO-OVR
|style="background-color: white;vertical-align:top;" rowspan="2"|{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/cio-HypersensitivityDispositions.RetrieveServe|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1|title=CapabilityStatement Retrieve/serve hypersensitivity dispositions}}
+
|style="background-color: white;vertical-align:top;" rowspan="2"|{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/cio-HypersensitivityDispositions.RetrieveServe|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}|title=CapabilityStatement Retrieve/serve hypersensitivity dispositions}}
 
|-
 
|-
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/ad/#/cio-/scenarios/scenarios/2.16.840.1.113883.2.4.3.11.60.26.4.36/2020-10-21T15:06:32 Serving hypersensitivity dispositions]
+
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/pub/cio/cio-html-20230424T150542/tr-2.16.840.1.113883.2.4.3.11.60.26.4.36-2020-10-21T150632.html Serving hypersensitivity dispositions]
 
|style="background-color: white;vertical-align:top;"|Server
 
|style="background-color: white;vertical-align:top;"|Server
 
|style="background-color: white;vertical-align:top;"|CIO-OVB
 
|style="background-color: white;vertical-align:top;"|CIO-OVB
Regel 412: Regel 412:
 
| {{fhir|patient.identifier}} <ref name="patient-searchparameter"/>
 
| {{fhir|patient.identifier}} <ref name="patient-searchparameter"/>
 
| AllergyIntolerance, Condition
 
| AllergyIntolerance, Condition
| Retrieves all HypersensitivityDisposition and corresponding Reaction building blocks of a patient with a fake BSN of 11122233.
+
| Retrieves all HypersensitivityDisposition and corresponding Reaction building blocks of a patient with a fake BSN of 111222333.
 
<pre>GET [base]/AllergyIntolerance?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>
 
<pre>GET [base]/AllergyIntolerance?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>
 
<pre>GET [base]/Condition?code=http://snomed.info/sct|157471000146100&_include=Condition:evidence-detail&patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>
 
<pre>GET [base]/Condition?code=http://snomed.info/sct|157471000146100&_include=Condition:evidence-detail&patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>
Regel 433: Regel 433:
 
{{fhir|<nowiki>_include=Condition:evidence-detail</nowiki>}}
 
{{fhir|<nowiki>_include=Condition:evidence-detail</nowiki>}}
 
| AllergyIntolerance, Condition
 
| AllergyIntolerance, Condition
| Retrieves all HypersensitivityDisposition and corresponding Reaction building blocks of a patient with a fake BSN of 11122233 and includes the Patient resource in the search results.
+
| Retrieves all HypersensitivityDisposition and corresponding Reaction building blocks of a patient with a fake BSN of 111222333 and includes the Patient resource in the search results.
 
<pre>GET [base]/AllergyIntolerance?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333&_include=AllergyIntolerance:patient</pre>
 
<pre>GET [base]/AllergyIntolerance?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333&_include=AllergyIntolerance:patient</pre>
 
<pre>GET [base]/Condition?code=http://snomed.info/sct|157471000146100&_include=Condition:evidence-detail&patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333&_include=Condition:patient</pre>
 
<pre>GET [base]/Condition?code=http://snomed.info/sct|157471000146100&_include=Condition:evidence-detail&patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333&_include=Condition:patient</pre>
Regel 455: Regel 455:
 
| Overgevoeligheid
 
| Overgevoeligheid
 
| rowspan="2" | AllergyIntolerance
 
| rowspan="2" | AllergyIntolerance
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDispositionReaction|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1}}
+
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDispositionReaction|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Reaction
 
| Reaction
Regel 463: Regel 463:
 
| Overgevoeligheid
 
| Overgevoeligheid
 
| Condition
 
| Condition
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDisposition|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDisposition|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Reaction
 
| Reaction
 
| Reactie
 
| Reactie
 
| Observation
 
| Observation
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-Reaction|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-Reaction|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Patient
 
| Patient
 
| Patient
 
| Patient
 
| Patient
 
| Patient
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| rowspan="2" | HealthProfessional
 
| rowspan="2" | HealthProfessional
 
| rowspan="2" | Zorgverlener
 
| rowspan="2" | Zorgverlener
 
| PractitionerRole
 
| PractitionerRole
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Practitioner
 
| Practitioner
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| HealthcareProvider
 
| HealthcareProvider
 
| Zorgaanbieder
 
| Zorgaanbieder
 
| Organization
 
| Organization
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| MedicationAgreement
 
| MedicationAgreement
 
| Medicatieafspraak
 
| Medicatieafspraak
 
| MedicationRequest
 
| MedicationRequest
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationAgreement|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationAgreement|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.medicationprocess9|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| AdministrationAgreement
 
| AdministrationAgreement
 
| Toedieningsafspraak
 
| Toedieningsafspraak
 
| MedicationDispense
 
| MedicationDispense
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-AdministrationAgreement|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-AdministrationAgreement|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.medicationprocess9|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| MedicationDispense
 
| MedicationDispense
 
| Medicatieverstrekking
 
| Medicatieverstrekking
 
| MedicationDispense
 
| MedicationDispense
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationDispense|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationDispense|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.medicationprocess9|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| MedicationUse2
 
| MedicationUse2
 
| Medicatiegebruik2
 
| Medicatiegebruik2
 
| MedicationStatement
 
| MedicationStatement
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationUse2|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationUse2|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.medicationprocess9|release=V2.0.0-beta.1|namespace=cio}}}}
 
|}
 
|}
  
Regel 516: Regel 516:
  
 
{| class="wikitable" "cellpadding="10"
 
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
+
! style="font-weight: bold;text-align:left;"| Transaction group
! style="text-align:left;"| '''Transaction'''
+
! style="font-weight: bold;text-align:left;"| Transaction
! style="text-align:left;"| '''Actor'''
+
! style="font-weight: bold;text-align:left;"| Actor
! style="text-align:left;"| '''System role'''
+
! style="font-weight: bold;text-align:left;"| System role
! style="text-align:left;"| '''FHIR CapabilityStatement'''
+
! style="font-weight: bold;text-align:left;"| FHIR CapabilityStatement
 
|-
 
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|[https://decor.nictiz.nl/ad/#/cio-/scenarios/scenarios/2.16.840.1.113883.2.4.3.11.60.26.4.31/2020-10-21T15:06:08 Hypersensitivity Disposition (PUSH)]  
+
|style="background-color: white;vertical-align:top;" rowspan="2"|[https://decor.nictiz.nl/pub/cio/cio-html-20230424T150542/sc-2.16.840.1.113883.2.4.3.11.60.26.3.2-2019-08-28T133341.html#_2.16.840.1.113883.2.4.3.11.60.26.4.31_20201021150608 Hypersensitivity Disposition (PUSH)]  
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/ad/#/cio-/scenarios/scenarios/2.16.840.1.113883.2.4.3.11.60.26.4.32/2020-10-21T15:06:08 Sending hypersensitivity dispositions]
+
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/pub/cio/cio-html-20230424T150542/tr-2.16.840.1.113883.2.4.3.11.60.26.4.32-2020-10-21T150608.html Sending hypersensitivity dispositions]
 
|style="background-color: white;vertical-align:top;"|Client  
 
|style="background-color: white;vertical-align:top;"|Client  
 
|style="background-color: white;vertical-align:top;"|CIO-OVS
 
|style="background-color: white;vertical-align:top;"|CIO-OVS
|style="background-color: white;vertical-align:top;" rowspan="2"|{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/cio-ContraIndications.SendReceive|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1|title=CapabilityStatement Send/receive hypersensitivity dispositions}}
+
|style="background-color: white;vertical-align:top;" rowspan="2"|{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/cio-HypersensitivityDispositions.SendReceive|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}|title=CapabilityStatement Send/receive hypersensitivity dispositions}}
 
|-
 
|-
 
|style="background-color: white;vertical-align:top;"|Receiving hypersensitivity dispositions
 
|style="background-color: white;vertical-align:top;"|Receiving hypersensitivity dispositions
Regel 562: Regel 562:
 
| Overgevoeligheid
 
| Overgevoeligheid
 
| rowspan="2" | AllergyIntolerance
 
| rowspan="2" | AllergyIntolerance
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDispositionReaction|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1}}
+
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDispositionReaction|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Reaction
 
| Reaction
Regel 570: Regel 570:
 
| Overgevoeligheid
 
| Overgevoeligheid
 
| Condition
 
| Condition
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDisposition|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDisposition|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Reaction
 
| Reaction
 
| Reactie
 
| Reactie
 
| Observation
 
| Observation
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-Reaction|nictiz.fhir.nl.r4.cio|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/cio-Reaction|nictiz.fhir.nl.r4.cio|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.cio|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Patient
 
| Patient
 
| Patient
 
| Patient
 
| Patient
 
| Patient
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| rowspan="2" | HealthProfessional
 
| rowspan="2" | HealthProfessional
 
| rowspan="2" | Zorgverlener
 
| rowspan="2" | Zorgverlener
 
| PractitionerRole
 
| PractitionerRole
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| Practitioner
 
| Practitioner
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| HealthcareProvider
 
| HealthcareProvider
 
| Zorgaanbieder
 
| Zorgaanbieder
 
| Organization
 
| Organization
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=0.9.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| MedicationAgreement
 
| MedicationAgreement
 
| Medicatieafspraak
 
| Medicatieafspraak
 
| MedicationRequest
 
| MedicationRequest
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationAgreement|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationAgreement|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.medicationprocess9|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| AdministrationAgreement
 
| AdministrationAgreement
 
| Toedieningsafspraak
 
| Toedieningsafspraak
 
| MedicationDispense
 
| MedicationDispense
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-AdministrationAgreement|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-AdministrationAgreement|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.medicationprocess9|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| MedicationDispense
 
| MedicationDispense
 
| Medicatieverstrekking
 
| Medicatieverstrekking
 
| MedicationDispense
 
| MedicationDispense
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationDispense|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationDispense|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.medicationprocess9|release=V2.0.0-beta.1|namespace=cio}}}}
 
|-
 
|-
 
| MedicationUse2
 
| MedicationUse2
 
| Medicatiegebruik2
 
| Medicatiegebruik2
 
| MedicationStatement
 
| MedicationStatement
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationUse2|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion=2.0.0-beta.1}}
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp-MedicationUse2|nictiz.fhir.nl.r4.medicationprocess9|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.medicationprocess9|release=V2.0.0-beta.1|namespace=cio}}}}
 
|}
 
|}
  
 
= Release notes =
 
= Release notes =
  
Release notes can be found on the [[cio:V2.0.0_Ontwerp_CiO#Release_notes| functional design page]].
+
Release notes can be found on the [[cio:V2.0.0_Ontwerp_CiO#Release_Notes| functional design page]].
  
 
= Footnotes =
 
= Footnotes =

Huidige versie van 15 dec 2023 om 09:26

Icoon Nictiz Cirkel Informatie Oranje.svg

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 BITS.



CiO

1 Introduction

This is the implementation guide (IG) for the information standard CiO (Dutch: Contra-indicaties en overgevoeligheden, English: Contraindications and intolerances), version 2.0.0-beta.1. The functional specification can be found here and is implemented using HL7 FHIR R4. This implementation guide assumes that the reader is familiar with both the functional specification and this version of FHIR.

Apart from this document, the guidelines as specified in the general FHIR Implementation Guide apply. In particular, the reader should take note of the Overarching principles and the use of FHIR packages. Where the general IG uses the term ‘use case’, this IG uses the term ‘transaction’ for the various processes that are described.

This IG first describes the boundaries and relationships in place, after which the implementation is described per transaction.

2 Boundaries and relationships

2.1 Boundaries

Note that this version of the CiO information standard is only focused on medication contraindications and hypersensitivities due to medication (see section 1.1 of the functional specification). Technically this scope is reflected in for instance the terminology used within the FHIR profiles or the naming of the cio-MedicationContraIndication profile. In this IG however, we will not further elaborate on this narrower scope and instead describe the technical implementation of this standard as general as possible, in order to make it easier to incorporate a broadening of the scope in subsequent versions of this IG.

2.2 Building blocks and profiles

The exchange of data within the CiO standard version 2.0.0-beta.1 is partly based on the 2020 publication of the Dutch Health and Care Information Models (Dutch: ‘zorginformatiebouwstenen’ or ‘zibs’), and subsequent changes made that are present in the 2022 prepublication. In particular, the prepublication of 2021 saw the introduction of the Hypersensitivity and Reaction zibs which are based on and still have quite some overlap with the zib AllergyIntolerance that already existed. The functional data set of CiO has further built upon the former two zibs (renaming the first as HypersensitivityDisposition), next to the zib MedicationContraIndication. These objects (which are actually exchanged) are referred to as ‘building blocks’ in the data set, and can thus be seen as ‘extended zibs’ suitable for implementation.

Due to new insights, the building blocks HypersensitivityDisposition and Reaction in the functional data set have deviated quite a lot from the zib AllergyIntolerance present in the 2020 publication, making them incompatible in varying degrees from a technical point of view. Therefore it was not possible to implement the FHIR profiles for these building blocks by building on and extending the nl-core profiles based on zib publication 2020. Hence the profiles for these building blocks have been created ‘independently’ from the nl-core profiles, meaning that they are not derived from nl-core-AllergyIntolerance. For the building block MedicationContraIndication on the other hand, the changes made within CiO are quite minimal with respect to its zib 2020 counterpart, making it possible to derive from nl-core-MedicationContraIndication.

Lastly it is important to note that there is still extensive discussion about the exact scope, name and structure of the HypersensitivityDisposition and Reaction building blocks, meaning that the current profiles definitely cannot be considered to be stable and ready for use. To aid in the discussion, two sets of FHIR profiles have been made for these building blocks:

  • The cio-HypersensitivityDispositionReaction profile is created on the AllergyIntolerance resource and closely follows the nl-core-AllergyIntolerance profile corresponding to the zib AllergyIntolerance present in the 2020 publication. However due to incompatibilities (mainly on the level of terminology) it is not actually derived from that profile. The cio-HypersensitivityDispositionReaction profile contains both the HypersensitivityDisposition and Reaction building blocks, which makes sense as the Reaction building block is never exchanged on its own, but always in the context of a certain HypersensitivityDisposition. The main advantage in this profiling approach lies in the fact that it semantically makes the most sense, and the FHIR resource AllergyIntolerance already contains quite a lot of counterparts to the concepts in the functional data set (in particular on the level of the Reaction). This profiling approach will be referred to as approach A in the remainder of this IG.
  • The cio-HypersensitivityDisposition and cio-Reaction profiles are created on the Condition and Observation resources, respectively. Using this approach less custom extensions are necessary to properly map the concepts from the functional data set, and it makes it easier to identify and handle Reactions. The main disadvantages are semantically of nature, for instance the mapping of the SubstanceToMonitor concept (which is a key concept in the HypersensitivityDisposition building block) is not as straightforward, and quite some concepts within the Reaction building block are mapped on Observation.components, while they have a direct counterpart in profiling approach A. This profiling approach will be referred to as approach B in the remainder of this IG.

See this document for a more detailed reasoning behind the mapping from functional data set to these FHIR profiles.

For both profiling approaches the technical implementation will be explained in this IG, for instance with respect to details within their profiles, or definitions of search requests/parameters in which the underlying FHIR resources are mentioned. After a definitive approach has been chosen, only the relevant sections will remain in subsequent versions of this IG.

2.2.1 Main building blocks

As described above, only the MedicationContraIndication building block has a dependency on its zib counterpart (of the 2020 publication). Nevertheless all building blocks have resulted in so-called ‘cio’ profiles.

Building block (EN) Building block (NL) FHIR resource FHIR profile
HypersensitivityDisposition Overgevoeligheid AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDispositionReaction
Reaction Reactie
HypersensitivityDisposition Overgevoeligheid Condition http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDisposition
Reaction Reactie Observation http://nictiz.nl/fhir/StructureDefinition/cio-Reaction
MedicationContraIndication MedicatieContraIndicatie Flag http://nictiz.nl/fhir/StructureDefinition/cio-MedicationContraIndication

2.2.2 Secondary building blocks

Additionally, the standard uses several secondary building blocks referenced from the main building blocks. All secondary building blocks are part of either the ‘nl-core’ or ‘medicationprocess9’ package.

Building block (EN) Building block (NL) FHIR resource FHIR profile
Patient Patient Patient http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient
HealthProfessional Zorgverlener PractitionerRole http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole
Practitioner http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner
HealthcareProvider Zorgaanbieder Location http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider
Organization http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization
MedicationAgreement Medicatieafspraak MedicationRequest http://nictiz.nl/fhir/StructureDefinition/mp-MedicationAgreement
AdministrationAgreement Toedieningsafspraak MedicationDispense http://nictiz.nl/fhir/StructureDefinition/mp-AdministrationAgreement
MedicationDispense Medicatieverstrekking MedicationDispense http://nictiz.nl/fhir/StructureDefinition/mp-MedicationDispense
MedicationUse2 Medicatiegebruik2 MedicationStatement http://nictiz.nl/fhir/StructureDefinition/mp-MedicationUse2

Note the following:

  • Each occurrence of the zib HealthProfessional is normally represented by two FHIR resources: an instance of nl-core-HealthProfessional-PractitionerRole and an instance of nl-core-HealthProfessional-Practitioner. Sending systems should only fill the reference to the PractitionerRole instance where relevant. Receiving systems can resolve the reference to the Practitioner resource from that PractitionerRole instance.
  • The zib HealthcareProvider is mapped to both a Location and Organization profile. In general the Location profile acts as the focal resource, because most references to this zib are concerned about the recording of the physical location where the care to patient takes place rather than the organizational information. However, within the main building blocks in CiO the HealthcareProvider is always present as an author, hence a reference to the Organization profile is sufficient in those cases. The Location profile, although not directly referenced from the main building blocks, is mentioned in the table above for completeness purposes (as it is referred to in secondary resources).

2.2.3 Relations between building blocks

Resources diagram CiO.png

2.3 Mappings between profiles and data set

Each transaction starts with links to the functional definition in an ART-DECOR publication and references one or several FHIR profiles. The FHIR profiles contain mappings to all data elements that are present in the functional data set (prefixed with ‘cio-dataelement-20-’).

Each transaction contains a Patient building block with cardinality 1..1 M. This patient is the subject of all other building blocks in the transaction, although no explicit relation exists in the data set. Therefore, a reference to a Patient resource conforming to the nl-core-Patient profile is expected in .subject or .patient of each FHIR instance of each main building block (with the exception of RegistrationData).

Relations between different building blocks exist in transactions by means of concepts with a name starting with ‘Relation…’ (Dutch: ‘Relatie…’) and an underlying concept 'Identification' of data type Identification, for example RelationHypersensitivity (cio-dataelement-20-734) in building block Hypersensitivity. These relations are mapped to the FHIR data type ‘Reference’. Implementers SHOULD use literal references (using .reference) instead of logical references (using .identifier) where possible, see the general FHIR IG on the Reference data type.

2.4 Patient identification

This implementation guide assumes that the client system is able to make a connection to the right server that contains the patient's information. It does not provide information on finding the right server nor does it provide information about security. Moreover, each transaction is performed in the context of a specific patient, whose context might have been established using the authentication mechanisms described in external specifications such as the MedMij ‘Afsprakenstelsel’ or through the usage of search parameters for patient identification.

Each server is required to perform filtering based on the patient associated with the context for the request or based on the patient identification search parameters, which is a chained search parameter for all resource types except Patient, so only the records associated with the authenticated patient are returned.

When patient identification requires the use of search parameters, the following search parameters SHALL be supported:

  • Patient: identifier
  • AllergyIntolerance: patient.identifier
  • Condition: patient.identifier and subject:Patient.identifier
  • Observation: patient.identifier and subject:Patient.identifier
  • Flag: patient.identifier and subject:Patient.identifier

An example of a request that retrieves all AllergyIntolerance resources of a patient with a fake BSN of 111222333:

GET [base]/AllergyIntolerance?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333

Most request examples in this IG do not include patient identification mechanisms. Requesters are assumed to include these if necessary.

3 Transactions

This section describes the FHIR implementation of all transactions listed in section 2 of the functional specification. Transactions are paired per transaction group. Each subsection below hyperlinks the names of the transaction groups and transactions to the functional definition in an ART-DECOR publication. The ART-DECOR publication details which data elements are expected to be supported (cardinality and conformance) for each transaction. Where the functional specification uses the terms ‘Query’ and ‘Making available’, this IG uses the terms ‘Retrieving’ and ‘Serving’.

3.1 Contraindication (Retrieve/Serve)

The retrieve contraindications transaction is used by the client to retrieve contraindications from a server.

Transaction group Transaction Actor System role FHIR CapabilityStatement
Contraindication (PULL) Retrieving contraindications Client CIO-CIR CapabilityStatement Retrieve/serve contraindications
Serving contraindications Server CIO-CIB

3.1.1 Retrieve (request message)

When a health professional or healthcare provider wants to obtain all contraindications or specific ones matching various parameters, they issue a retrieve contraindications request message. This message uses the HTTP GET method parameterized query against the server's FHIR Flag endpoint.

The search interaction is performed by an HTTP GET conform the FHIR search specification, as shown below. This URL is configurable by the client by configuring the search query.

GET [base]/Flag?category=http://snomed.info/sct|140401000146105{&[additional parameter(s)]}

3.1.1.1 Search parameters

All search parameters listed in the table below SHALL be supported for processing by servers and MAY be supported by clients, with the exception of the category parameter, which SHALL be supported by clients as well (as it is always part of the search query in this transaction).

CiO search parameter Description FHIR search parameter FHIR resource Example
- Search on MedicationContraIndication building blocks. category [1] Flag Retrieves all Flag resources representing a MedicationContraIndication.
GET [base]/Flag?category=http://snomed.info/sct|140401000146105
PatientIdentificationNumber Search on patient. patient.identifier [2] Flag Retrieves all MedicationContraIndication building blocks of a patient with a fake BSN of 111222333.
GET [base]/Flag?category=http://snomed.info/sct|140401000146105&patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333
ReferenceDate Search on the MedicationContraIndication building blocks that have been registered on or after a certain date. registration-date-time[1] Flag Retrieves all MedicationContraIndication building blocks that were registered from 01-05-2023.
GET [base]/Flag?category=http://snomed.info/sct|140401000146105&registration-date-time=ge2023-05-01
- The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources.

Supporting the include of the Patient resource referenced by building blocks is required. Others (Organization, PractitionerRole, Practitioner) are optional. However: all resources referenced per literal reference SHALL be resolvable per the Nictiz IG.

_include=Flag:patient Flag Retrieves all MedicationContraIndication building blocks of a patient with a fake BSN of 111222333 and includes the Patient resource in the search results.
GET [base]/Flag?category=http://snomed.info/sct|140401000146105&patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333&_include=Flag:patient

The following custom search parameters are defined for this transaction:

3.1.2 Serve (response message)

The server returns an HTTP Status code appropriate to the processing outcome and returns a Bundle, with Bundle.type = searchset, including the resources matching the search query. The resources included in the Bundle SHALL conform to the profiles listed in the 'List of profiles' below.

3.1.3 List of profiles

The table below includes all profiles that are explicitly mentioned in the data set of this transaction, and thus need to be supported.

Building block (EN) Building block (NL) FHIR resource FHIR profile
MedicationContraIndication MedicatieContraIndicatie Flag http://nictiz.nl/fhir/StructureDefinition/cio-MedicationContraIndication
Patient Patient Patient http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient
HealthProfessional Zorgverlener PractitionerRole http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole
Practitioner http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner
HealthcareProvider Zorgaanbieder Organization http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization

3.2 Contraindication (Send/Receive)

The send contraindications transaction is used by the client to send contraindications to a server.

Transaction group Transaction Actor System role FHIR CapabilityStatement
Contraindication (PUSH) Sending contraindications Client CIO-CIS CapabilityStatement Send/receive contraindications
Receiving contraindications Server CIO-CIO

3.2.1 Send (request message)

Because the data sent in this transaction potentially consists of several building blocks along with secondary resources, a transaction interaction is used. This allows for sending a Bundle with a set of resources in a single interaction and makes it possible to include referenced secondary resources if needed. The interaction is performed by an HTTP POST command as shown:

POST [base]

The body of the POST submission is a Bundle with Bundle.type = transaction. Each entry SHALL carry request details (Bundle.entry.request) that provide the HTTP method of the action to be executed. Usually, this will be POST, even for informative secondary resources.

The resources included in the Bundle SHALL conform to the profiles listed in the 'List of profiles' below.

3.2.2 Receive (response message)

The server returns an HTTP Status code appropriate to the processing outcome. If the transaction is successful, the server returns a Bundle with Bundle.type = transaction-response, that contains one entry for each entry in the request, in the same order, with the outcome of processing the entry. Included secondary resources are handled following the Nictiz IG.

If the transaction fails, the server returns an OperationOutcome with one or multiple .issue elements filled with information, as detailed as possible, that describes why the transaction failed and which resource and/or request caused this.

3.2.3 List of profiles

The table below includes all profiles that are explicitly mentioned in the data set of this transaction, and thus need to be supported.

Building block (EN) Building block (NL) FHIR resource FHIR profile
MedicationContraIndication MedicatieContraIndicatie Flag http://nictiz.nl/fhir/StructureDefinition/cio-MedicationContraIndication
Patient Patient Patient http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient
HealthProfessional Zorgverlener PractitionerRole http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole
Practitioner http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner
HealthcareProvider Zorgaanbieder Organization http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization

3.3 Hypersensitivity Disposition (Retrieve/Serve)

Within this transaction both AllergyIntolerance and Condition/Observation resources are mentioned while specifying e.g. search requests and search parameters. Note that the former references are only relevant if profiling approach A is chosen, while the latter are only relevant in approach B.

The retrieve hypersensitivity dispositions transaction is used by the client to retrieve hypersensitivity dispositions including corresponding reactions from a server.

Transaction group Transaction Actor System role FHIR CapabilityStatement
Hypersensitivity Disposition (PULL) Retrieving hypersensitivity dispositions Client CIO-OVR CapabilityStatement Retrieve/serve hypersensitivity dispositions
Serving hypersensitivity dispositions Server CIO-OVB

3.3.1 Retrieve (request message)

When a health professional or healthcare provider wants to obtain all hypersensitivity dispositions or specific ones matching various parameters, including the corresponding reactions, they issue a retrieve hypersensitivity dispositions request message. This message uses the HTTP GET method parameterized query against the server's FHIR AllergyIntolerance or Condition endpoint.

The search interaction is performed by an HTTP GET conform the FHIR search specification, as shown below. This URL is configurable by the client by configuring the search query.

GET [base]/AllergyIntolerance{?[parameter(s)]}
GET [base]/Condition?code=http://snomed.info/sct|157471000146100&_include=Condition:evidence-detail{&[additional parameter(s)]}

3.3.1.1 Search parameters

All search parameters listed in the table below SHALL be supported for processing by servers and MAY be supported by clients, with the exception of the code and evidence-detail parameters on Condition (and the corresponding include of the latter parameter), which SHALL be supported by clients as well (as these are always part of the search query in this transaction).

CiO search parameter Description FHIR search parameter FHIR resource Example
- Search on HypersensitivityDisposition building blocks. code Condition Retrieves all Condition resources representing a HypersensitivityDisposition.
GET [base]/Condition?code=http://snomed.info/sct|157471000146100
- Search on Reaction building blocks. evidence-detail Condition Retrieves all Condition resources representing a HypersensitivityDisposition and includes the Observation resources representing corresponding Reactions.
GET [base]/Condition?code=http://snomed.info/sct|157471000146100&_include=Condition:evidence-detail
PatientIdentificationNumber Search on patient. patient.identifier [2] AllergyIntolerance, Condition Retrieves all HypersensitivityDisposition and corresponding Reaction building blocks of a patient with a fake BSN of 111222333.
GET [base]/AllergyIntolerance?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333
GET [base]/Condition?code=http://snomed.info/sct|157471000146100&_include=Condition:evidence-detail&patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333
ReferenceDate Search on the HypersensitivityDisposition building blocks that have been registered on or after a certain date. date AllergyIntolerance Retrieves all HypersensitivityDisposition and corresponding Reaction building blocks that were registered from 01-05-2023.
GET [base]/AllergyIntolerance?recorded-date=ge2023-05-01
GET [base]/Condition?code=http://snomed.info/sct|157471000146100&_include=Condition:evidence-detail&recorded-date=ge2023-05-01
recorded-date Condition
- The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources.

Supporting the include of the Patient and Observation (the latter only in approach B) resource referenced by building blocks is required. Others (Organization, PractitionerRole, Practitioner, MedicationRequest, MedicationDispense, MedicationStatement) are optional. However: all resources referenced per literal reference SHALL be resolvable per the Nictiz IG.

_include=[type]:patient

_include=Condition:evidence-detail

AllergyIntolerance, Condition Retrieves all HypersensitivityDisposition and corresponding Reaction building blocks of a patient with a fake BSN of 111222333 and includes the Patient resource in the search results.
GET [base]/AllergyIntolerance?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333&_include=AllergyIntolerance:patient
GET [base]/Condition?code=http://snomed.info/sct|157471000146100&_include=Condition:evidence-detail&patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333&_include=Condition:patient

3.3.2 Serve (response message)

The server returns an HTTP Status code appropriate to the processing outcome and returns a Bundle, with Bundle.type = searchset, including the resources matching the search query. The resources included in the Bundle SHALL conform to the profiles listed in the 'List of profiles' below.

3.3.3 List of profiles

The table below includes all profiles that are explicitly mentioned in the data set of this transaction, and thus need to be supported.

Building block (EN) Building block (NL) FHIR resource FHIR profile
HypersensitivityDisposition Overgevoeligheid AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDispositionReaction
Reaction Reactie
HypersensitivityDisposition Overgevoeligheid Condition http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDisposition
Reaction Reactie Observation http://nictiz.nl/fhir/StructureDefinition/cio-Reaction
Patient Patient Patient http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient
HealthProfessional Zorgverlener PractitionerRole http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole
Practitioner http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner
HealthcareProvider Zorgaanbieder Organization http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization
MedicationAgreement Medicatieafspraak MedicationRequest http://nictiz.nl/fhir/StructureDefinition/mp-MedicationAgreement
AdministrationAgreement Toedieningsafspraak MedicationDispense http://nictiz.nl/fhir/StructureDefinition/mp-AdministrationAgreement
MedicationDispense Medicatieverstrekking MedicationDispense http://nictiz.nl/fhir/StructureDefinition/mp-MedicationDispense
MedicationUse2 Medicatiegebruik2 MedicationStatement http://nictiz.nl/fhir/StructureDefinition/mp-MedicationUse2

3.4 Hypersensitivity Disposition (Send/Receive)

Within this transaction both AllergyIntolerance and Condition/Observation resources are mentioned while specifying e.g. the profiles that need to be supported. Note that the former references are only relevant if profiling approach A is chosen, while the latter are only relevant in approach B.

The send hypersensitivity dispositions transaction is used by the client to send hypersensitivity dispositions including corresponding reactions to a server.

Transaction group Transaction Actor System role FHIR CapabilityStatement
Hypersensitivity Disposition (PUSH) Sending hypersensitivity dispositions Client CIO-OVS CapabilityStatement Send/receive hypersensitivity dispositions
Receiving hypersensitivity dispositions Server CIO-OVO

3.4.1 Send (request message)

Because the data sent in this transaction potentially consists of several building blocks along with secondary resources, a transaction interaction is used. This allows for sending a Bundle with a set of resources in a single interaction and makes it possible to include referenced secondary resources if needed. The interaction is performed by an HTTP POST command as shown:

POST [base]

The body of the POST submission is a Bundle with Bundle.type = transaction. Each entry SHALL carry request details (Bundle.entry.request) that provide the HTTP method of the action to be executed. Usually, this will be POST, even for informative secondary resources.

The resources included in the Bundle SHALL conform to the profiles listed in the 'List of profiles' below.

3.4.2 Receive (response message)

The server returns an HTTP Status code appropriate to the processing outcome. If the transaction is successful, the server returns a Bundle with Bundle.type = transaction-response, that contains one entry for each entry in the request, in the same order, with the outcome of processing the entry. Included secondary resources are handled following the Nictiz IG.

If the transaction fails, the server returns an OperationOutcome with one or multiple .issue elements filled with information, as detailed as possible, that describes why the transaction failed and which resource and/or request caused this.

3.4.3 List of profiles

The table below includes all profiles that are explicitly mentioned in the data set of this transaction, and thus need to be supported.

Building block (EN) Building block (NL) FHIR resource FHIR profile
HypersensitivityDisposition Overgevoeligheid AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDispositionReaction
Reaction Reactie
HypersensitivityDisposition Overgevoeligheid Condition http://nictiz.nl/fhir/StructureDefinition/cio-HypersensitivityDisposition
Reaction Reactie Observation http://nictiz.nl/fhir/StructureDefinition/cio-Reaction
Patient Patient Patient http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient
HealthProfessional Zorgverlener PractitionerRole http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole
Practitioner http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner
HealthcareProvider Zorgaanbieder Organization http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization
MedicationAgreement Medicatieafspraak MedicationRequest http://nictiz.nl/fhir/StructureDefinition/mp-MedicationAgreement
AdministrationAgreement Toedieningsafspraak MedicationDispense http://nictiz.nl/fhir/StructureDefinition/mp-AdministrationAgreement
MedicationDispense Medicatieverstrekking MedicationDispense http://nictiz.nl/fhir/StructureDefinition/mp-MedicationDispense
MedicationUse2 Medicatiegebruik2 MedicationStatement http://nictiz.nl/fhir/StructureDefinition/mp-MedicationUse2

4 Release notes

Release notes can be found on the functional design page.

5 Footnotes

  1. 1,0 1,1 The search parameter consists of a custom FHIR search parameter not represented in the FHIR specification.
  2. 2,0 2,1 This search parameter only needs to be supported when patient identification requires the use of search parameters, see section 2.4.