Bgz:V2.0-beta.3 Technical IG BgZ MSZ: verschil tussen versies
(→Exchange BgZ for Referral: capability statement) |
k |
||
| (5 tussenliggende versies door 3 gebruikers niet weergegeven) | |||
| Regel 1: | Regel 1: | ||
| − | |||
<!-- BACK TO TOP BUTTON --> | <!-- BACK TO TOP BUTTON --> | ||
| Regel 22: | Regel 21: | ||
== Known issues == | == Known issues == | ||
| − | This version of the information standard has known issues. Please find them in the [[ | + | This version of the information standard has known issues. Please find them in the [[Bgz:V2.0-beta.3_Ontwerp_BgZ_MSZ#Known_issues | functional design page]]. |
= Boundaries and relationships = | = Boundaries and relationships = | ||
| Regel 137: | Regel 136: | ||
= Materials = | = Materials = | ||
| + | {{NoteBox|BgZ-MSZ uses the [[FHIR:V1.0_FHIR_IG_STU3#FHIR_Packages|FHIR Packaging mechanism]]. This conveniently bundles all profiles, terminology, example material and other conformance resources you need into a single archive, which can be downloaded or installed using the appropriate FHIR tooling. This version of the information standard uses the following packages: | ||
| + | * [https://simplifier.net/packages/nictiz.fhir.nl.stu3.bgz/2.0.3-beta.2 nictiz.fhir.nl.stu3.bgz, version 2.0.3-beta.2] | ||
| + | * [https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017 nictiz.fhir.nl.stu3.zib2017, version 2.1.0 or compatible] | ||
| + | '''Note''': packages use [https://semver.org/ Semantic Versioning]. Other versions can be used at will as long as they have the same ''major.minor'' number or a ''minor'' number higher than the stated version.}} | ||
==FHIR Profiles == | ==FHIR Profiles == | ||
| Regel 155: | Regel 158: | ||
|- | |- | ||
| rowspan="3" | 2 | | rowspan="3" | 2 | ||
| − | + | | Payer | |
| Coverage | | Coverage | ||
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Payer|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Payer|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | ||
|- | |- | ||
| + | | Payer.InsuranceCompany | ||
| Organization | | Organization | ||
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-organization|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | | {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-organization|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | ||
|- | |- | ||
| + | | Payer.PayerPerson | ||
| Patient | | Patient | ||
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/BgZ-Patient|nictiz.fhir.nl.stu3.bgz|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.bgz|release=V2.0|namespace=BgZ}}}} | | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/BgZ-Patient|nictiz.fhir.nl.stu3.bgz|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.bgz|release=V2.0|namespace=BgZ}}}} | ||
| Regel 242: | Regel 247: | ||
|- | |- | ||
| rowspan="2" | 11 | | rowspan="2" | 11 | ||
| − | | | + | | MedicalDevice |
| + | | DeviceUseStatement | ||
| + | | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDevice|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | ||
| + | |- | ||
| + | | MedicalDevice.Product | ||
| Device | | Device | ||
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDeviceProduct|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDeviceProduct|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | ||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| rowspan="2" | 12 | | rowspan="2" | 12 | ||
| − | + | | Vaccination | |
| Immunization | | Immunization | ||
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Vaccination|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Vaccination|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | ||
|- | |- | ||
| + | | Vaccination.PreferedDateForRevaccination | ||
| ImmunizationRecommendation | | ImmunizationRecommendation | ||
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-VaccinationRecommendation|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-VaccinationRecommendation|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | ||
| Regel 285: | Regel 292: | ||
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Encounter|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Encounter|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | ||
|- | |- | ||
| − | | | + | | 17 |
| − | | rowspan=" | + | | PlannedCareActivity.Procedure |
| + | | ProcedureRequest | ||
| + | | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-ProcedureRequest|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | ||
| + | |- | ||
| + | | rowspan="4" | 18 | ||
| + | | HealthProfessional | ||
| Practitioner | | Practitioner | ||
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | | {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | ||
|- | |- | ||
| + | | HealthProfessional.Specialty | ||
| PractitionerRole | | PractitionerRole | ||
| | {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-practitionerrole|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | | | {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-practitionerrole|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | ||
|- | |- | ||
| − | | | + | | HealthProfessional.HealthProfessionalRole |
| + | | CareTeam | ||
| + | | {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-careteam|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | ||
| + | |- | ||
| + | | HealthcareProvider | ||
| Organization | | Organization | ||
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-organization|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | | {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-organization|nictiz.fhir.nl.stu3.zib2017|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.zib2017|release=V2.0|namespace=BgZ}}}} | ||
|- | |- | ||
| − | | | + | | |
| − | | | + | | Metadata |
| − | |||
| − | |||
| − | |||
| Provenance | | Provenance | ||
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/bgz-metadata|nictiz.fhir.nl.stu3.bgz|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.bgz|release=V2.0|namespace=BgZ}}}} | | {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/bgz-metadata|nictiz.fhir.nl.stu3.bgz|pkgVersion={{VersieInfo|nictiz.fhir.nl.stu3.bgz|release=V2.0|namespace=BgZ}}}} | ||
| Regel 412: | Regel 426: | ||
| | | | ||
All living situations available in the source system are exchanged as FHIR Observation instances that conform to the zib-LivingSituation profile. | All living situations available in the source system are exchanged as FHIR Observation instances that conform to the zib-LivingSituation profile. | ||
| − | * The Observation. | + | * The Observation.code is fixed to ‘Residence and accommodation circumstances - finding’ (code = ' 365508006' in codeSystem 'SNOMED CT'). |
* The HouseType cardinality is 1..1R and must be exchanged accordingly. | * The HouseType cardinality is 1..1R and must be exchanged accordingly. | ||
|- | |- | ||
| Regel 421: | Regel 435: | ||
| | | | ||
All drug use available in the source system is exchanged as a FHIR Observation instances that conform to the zib-DrugUse profile. | All drug use available in the source system is exchanged as a FHIR Observation instances that conform to the zib-DrugUse profile. | ||
| − | * The Observation. | + | * The Observation.code is fixed to ‘Finding relating to drug misuse behavior’ (code = '228366006' in codeSystem 'SNOMED CT'). |
* The target system may be configured to optimize the use of this information. For example, grouping data according to a specific DrugOrMedicationType. | * The target system may be configured to optimize the use of this information. For example, grouping data according to a specific DrugOrMedicationType. | ||
|- | |- | ||
| Regel 430: | Regel 444: | ||
| | | | ||
All known alcohol use, available in the source system, is exchanged as FHIR Observations that conform to the zib-AlcoholUse profile. | All known alcohol use, available in the source system, is exchanged as FHIR Observations that conform to the zib-AlcoholUse profile. | ||
| − | * The Observation. | + | * The Observation.code is fixed to ‘Finding relating to alcohol drinking behavior’ (code = '228273003' in codeSystem 'SNOMED CT'). |
|- | |- | ||
! colspan="2" style="text-align: left;" | 7.4 Tobacco Use | ! colspan="2" style="text-align: left;" | 7.4 Tobacco Use | ||
| Regel 438: | Regel 452: | ||
| | | | ||
All known Tobacco Use, available in the source system, is exchanged as FHIR Observation instances that conform to the zib-TobaccoUse profile. | All known Tobacco Use, available in the source system, is exchanged as FHIR Observation instances that conform to the zib-TobaccoUse profile. | ||
| − | * The Observation. | + | * The Observation.code is fixed to ‘Finding of tobacco use and exposure’ (code = ' 365980008' in codeSystem 'SNOMED CT'). |
|- | |- | ||
! colspan="2" style="text-align: left;" | 7.5 Nutrition Advice | ! colspan="2" style="text-align: left;" | 7.5 Nutrition Advice | ||
| Regel 774: | Regel 788: | ||
= Release notes = | = Release notes = | ||
| − | + | Please find the release notes on the [[Bgz:V2.0-beta.3_Ontwerp_BgZ_MSZ#Release_notes | functional design page]]. | |
| − | |||
| − | [ | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
{{MedMij:Sjabloon_Support}} | {{MedMij:Sjabloon_Support}} | ||
Huidige versie van 4 dec 2025 om 13:22
For an overview of all current documentation for BgZ-MSZ see BgZ main page
Inhoud
1 Introduction
This is the FHIR implementation guide (IG) for the information standard BgZ-MSZ. This IG must be used together with the functional specification: see BgZ main page.
In addition, the guidelines as specified in general FHIR STU3 Implementation Guide apply. The guide defines how to implement FHIR STU3 and what rules apply (e.g. how to handle empty reponses etc.). In particular, the reader should take note of the use case overarching principles and the use of FHIR packages.
First, this IG describes the boundaries and relationships that exist. Second, it describes the implementation per transaction.
1.1 Known issues
This version of the information standard has known issues. Please find them in the functional design page.
2 Boundaries and relationships
2.1 Boundaries
Please note that this version of the BgZ-MSZ describes the exchange of all BgZ chapters. This version does not use the MBH identifier from medication process, however systems are encouraged to use the .identifier as stated in the general FHIR STU3 Implementation Guide.
In future versions of the BgZ it is expected that implementation guides will be modularized and that for subsets of the BgZ references will be made to other information standards such as Medication Process, and Lab.
In future versions the gap to the European patient summary will be addressed.
2.2 Building blocks and FHIR profiles
Data exchange of the BgZ is based on the Dutch zibs 2017 (clinical information models). Table 3 contains an overview of all FHIR building blocks, including custom building blocks. Please note that every FHIR profile makes use of mappings towards the baseclass HCIM BasicElements, this is relevant since some parts within a FHIR profile are not mapped in the associated HCIM profile (e.g. effectiveDateTime in livingSituation). The HCIM BasicElements are used primarily for lastn queries that depend on the effectiveDateTime element.
- The Metadata building block is made independently of the nl-core profiles. Metadata contains data that relates to the registration process rather than the medical content. Exchange of metadata for the BgZ-MSZ is designed via a query add-on: BgZ-MSZ sections can be queried with or without metadata. When data with a specific section are exchanged, there may be metadata about the registration process that refer to instances within such a section. In the future, when more information standards will use the Provenance resource to exchange registration data, it is planned to create an nl-core-MetaData profile that will replace the current bgz-MetaData profile.
2.3 Relations between building blocks
Figure 1. Relations between building blocks.
2.4 Mapping between profiles and dataset
Each FHIR profile maps to the functional definition in ART-DECOR. FHIR profiles contain mappings to all data elements that are present in the functional data set. Either HCIM mappings are used (e.g., NL-CM:17.2.1) or BgZ specific mappings are used with prefix: "bgz2017-dataelement-".
Each transaction must contain a Patient building block. 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 MetaData, Patient, HealthProvider.
FHIR instances, exchanged as part of a transaction, will contain references to other instances. For example a procedure may reference a problem list item. 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.5 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.
An example of a request that retrieves all Condition resources of a patient with a fictional BSN of 111222333: GET [base]/Condition?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn%7C111222333.
Table 4 defines the FHIR queries for all BgZ chapters. These queries apply for both use cases: "Exchange BgZ for Referral" and "Retrieval of BgZ from previous practitioner". All search parameters used in this table SHALL be supported for processing by servers and MAY be supported by clients.
3 Transactions
3.1 Exchange BgZ for Referral
| Actors | Systems | FHIR Capability Statements | |||
|---|---|---|---|---|---|
| Name | Description | Name | Description | Name | Description |
| Referring (Sending) Medical Specialist | Medical specialist who sends a BgZ along with a referral | EHR | Electronic health record | FHIR Client requirements | |
| Receiving Medical Specialist | Medical specialist receives a BgZ along with a referral | EHR | Electronic health record | FHIR Server requirements | |
Table 1. Actors in the BgZ exchange for referral.
FHIR instances for the BgZ summary are made available at the sending system using the profiles (table 3), the definition of the ART-DÉCOR publication (see functional specification), and the FHIR query specification (table 4). The FHIR instances will remain available unchanged for as long as the task period is valid.
3.1.1 Exchange Using Notified Pull Transaction
The BgZ-MSZ Notification task profile (table 5) is used by the sending system to invite the receiving system to perform one or more Pull interactions (FHIR requests). The task contains the FHIR-read and FHIR-search interactions that can be performed to retrieve the data that has been made available at the sending system. The valueReference or valueString for a BgZ section is defined in Table 6.
When generating the notification message the restriction.period, during which the data will be available, is set by the sending system. This period is identical to the duration of the referral. Working agreements describe how long queries are valid.
3.1.2 Exchange without Notified Pull Transaction
The sending system pushes a FHIR document with the BgZ to a receiving system. To construct a document, a FHIR Composition resource is created that summarizes and references all the resources that need to be exchanged. This Composition resource is then placed together with all referenced resources in a Bundle with Bundle.type set to "document". The Composition resource SHALL be the first entry.
The Push use case can be used by systems transitioning from HL7 CDA to HL7 FHIR where the CDA based BgZ is replaced by a FHIR Composition.
3.2 Retrieval of BgZ from previous practitioner
| Person | System | ||
|---|---|---|---|
| Name | Description | Name | Description |
| Requesting Medical Specialist | Medical specialist who queries for a BgZ | EHR | Electronic health record |
Table 2. Actors in the retrieval of the BgZ from a previous practitioner.
In the "Retrieval of BgZ from previous practitioner" use case, the current healthcare provider (Requesting Medical Specialist) takes the initiative to retrieve the BgZ from the previous care institution. The Requesting Medical Specialist can retrieve the BgZ (at a suitable time) using the Pull Message and the search/ read queries defined in table 4.
It is assumed that the Requesting Medical Specialist, as person who uses the BgZ sharing infrastructure, is signed on, authenticated and has authorization & consent to access the necessary (patient) information stored in the BgZ sharing infrastructure (or in other words, an authenticated healthcare professional who has an active treatment relationship with the patient).
4 Materials
|
BgZ-MSZ uses the FHIR Packaging mechanism. This conveniently bundles all profiles, terminology, example material and other conformance resources you need into a single archive, which can be downloaded or installed using the appropriate FHIR tooling. This version of the information standard uses the following packages:
Note: packages use Semantic Versioning. Other versions can be used at will as long as they have the same major.minor number or a minor number higher than the stated version. |
4.1 FHIR Profiles
Table 3. FHIR Profiles used to exchange BgZ MSZ sections. The reader should take note of the 'Relating FHIR profiles with their functional definitions' in the FHIR STU3 Implementation Guide.
Certain BgZ related FHIR profiles are derived from zib and nl-core profiles. In future versions of the standard, BgZ profiles will possibly be replaced by their predaopt zib2020 counterparts.
4.2 FHIR Query Specification
The table below provides an overview of the FHIR queries to exchange all BgZ-MSZ sections.
| Query | Description |
|---|---|
| 1 Demographics and identification | |
| 1.1 Patient | |
GET [base]/Patient? _include=Patient:general-practitioner |
The patient information available in the source system is exchanged as a FHIR patient instance that conforms to the nl-core-patient profile.
|
| 1.2 Marital status | |
see Patient.maritalStatus |
Marital status data are exchanged via the patient resource (see 1.1). |
| 2 Financial information | |
| 2.1 Payer | |
GET [base]/Coverage? _include=Coverage:payor |
The payer data available in the source system is exchanged as a FHIR coverage instance that conforms to the zib-Payer profile.
|
| 3 Treatment restrictions | |
| 3.1 Treatment instructions | |
GET [base]/Consent? category=http://snomed.info/sct|11291000146105 |
All treatmentDirectives available in the source system are exchanged as FHIR consent instances, which conform to the zib-TreatmentDirective profile.
|
| 3.2 Advance directive | |
GET [base]/Consent? category=http://snomed.info/sct|11341000146107 |
All AdvanceDirectives available in the source system are exchanged as FHIR consent instances, which conform to the zib-AdvanceDirective profile.
|
| 4 Contact persons | |
| 4.1 Contact | |
Patient.contact |
Primary partner/contact data are exchanged via the patient resource (see 1.1). |
| 5 Functional/mental status | |
| 5.1 Functional or mental status | |
GET [base]/Observation? category=http://snomed.info/sct|118228005, http://snomed.info/sct|384821006 |
All functional or mental status information available in the source system is exchanged as FHIR observation data that conforms to the zib-FunctionalOrMentalStatus profile.
|
| 6 Complaints and diagnoses | |
| 6.1 Problem | |
GET [base]/Condition |
All problems available in the source system are returned as zib-Problem instances.
|
| 7 Social history | |
| 7.1 Living Situation | |
GET [base]/Observation? code=http://snomed.info/sct|365508006 |
All living situations available in the source system are exchanged as FHIR Observation instances that conform to the zib-LivingSituation profile.
|
| 7.2 Drug Use | |
GET [base]/Observation? code=http://snomed.info/sct|228366006 |
All drug use available in the source system is exchanged as a FHIR Observation instances that conform to the zib-DrugUse profile.
|
| 7.3 Alcohol Use | |
GET [base]/Observation? code=http://snomed.info/sct|228273003 |
All known alcohol use, available in the source system, is exchanged as FHIR Observations that conform to the zib-AlcoholUse profile.
|
| 7.4 Tobacco Use | |
GET [base]/Observation? code=http://snomed.info/sct|365980008 |
All known Tobacco Use, available in the source system, is exchanged as FHIR Observation instances that conform to the zib-TobaccoUse profile.
|
| 7.5 Nutrition Advice | |
GET [base]/NutritionOrder |
All Nutrition Advice available in the source system is exchanged as a FHIR NutritionOrder instances that conform to the zib-NutritionAdvice profile.
|
| 8 Alerts | |
| 8.1 Alert | |
GET [base]/Flag |
All alerts available in the source system are exchanged as a FHIR Flag instances that conform to the zib-Alert profile. |
| 9 Allergies | |
| 9.1 Allergy Intolerance | |
GET [base]/AllergyIntolerance |
All allergies and intolerances available in the source system are exchanged as a FHIR AllergyIntolerance instances that conform to the zib-AllergyIntolerance profile.
"manifestation":{
"extension": [{
"url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
"valueCode": "unknown"
}]
},
|
| 10 Medication | |
| 10.1 Medication Agreement | |
GET [base]/MedicationRequest? category=http://snomed.info/sct|16076005& _include=MedicationRequest:medication |
All medication agreements available in the source system are exchanged FHIR MedicationRequest instances that conform to the zib-MedicationAgreement profile.
|
| 10.2 Administration Agreement | |
GET [base]/MedicationDispense? category=http://snomed.info/sct|422037009& _include=MedicationDispense:medication |
All administration agreements available in the source system are exchanged FHIR MedicationDispense instances that conform to the zib-AdministrationAgreement profile.
|
| 10.3 Medication Use | |
GET [base]/MedicationStatement? category= urn:oid:2.16.840.1.113883.2.4.3.11.60.20.77.5.3|6& _include=MedicationStatement:medication |
All medication use available in the source system are exchanged FHIR MedicationStatement instances that conform to the zib-MedicationUse profile.
|
| 11 Medical devices | |
| 11.1 Medical device | |
GET [base]/DeviceUseStatement? _include=DeviceUseStatement:device |
All device use statements available in the source system are exchanged as FHIR DeviceUseStatement instances that conform to the zib-MedicalDevice profile.
|
| 12 Vaccinations | |
| 12.1 Vaccination | |
GET [base]/Immunization? status=completed |
All administered vaccinations available in the source system are exchanged as FHIR Immunization instances conforming to the zib-Vaccination profile.
|
| 13 vital signs and measurements | |
| 13.1 Blood pressure | |
GET [base]/Observation/$lastn? code=http://loinc.org|85354-9 |
The last known Blood pressure available in the source system is exchanged as a FHIR Observation instance that conforms to the zib-BloodPressure profile.
|
| 13.2 Body weight | |
GET [base]/Observation/$lastn? code=http://loinc.org|29463-7 |
The last known Body Weight available in the source system is exchanged as a FHIR Observation instance that conforms to the zib-BodyWeight profile.
|
| 13.3 Body height | |
GET [base]/Observation/$lastn? code=http://loinc.org|8302-2, http://loinc.org|8306-3, http://loinc.org|8308-9 |
The last known Body Height available in the source system is exchanged as a FHIR Observation instance that conforms to the zib-BodyHeight profile.
|
| 14 Results | |
| 14.1 Laboratory test result | |
GET [base]/Observation/$lastn? category=http://snomed.info/sct|49581000146104 &_include=Observation:related-target |
All last known Laboratory results, with the most recent test result for each PanelOrBattery, are exchanged as FHIR observations conforming to the zib-LaboratoryTestResult-Observation profile.
|
| 15 Procedures | |
| 15.1 Procedure | |
GET [base]/Procedure? category=http://snomed.info/sct|387713003, http://snomed.info/sct|258174001 |
All operative and image-guided procedures available in the source system are exchanged as FHIR Procedure instances that conform to the zib-Procedure profile.
Procedure instances with any other category than the two specified above are not exchanged. The default category for the BgZ MSZ is ‘procedure’ (code = ‘71388002’ in CodeSystem ‘SNOMED CT’). |
| 16 Encounters | |
| 16.1 Encounter | |
GET [base]/Encounter |
All Encounters available in the source system are exchanged as FHIR Encounter instances that conform to the zib-Encounter profile. |
| 17 Planned care activity | |
| 17.1 Procedure | |
GET [base]/ProcedureRequest?status=active |
All planned procedures available in the source system are exchanged as FHIR ProcedureRequest instances according to the zib-ProcedureRequest profile. |
| 18 Care Setting | |
| 18.1 Health professional | |
GET [base]/CareTeam?status=active&_include=CareTeam:participant |
All health professionals available in the source system are exchanged as part of a CareTeam instance according to the nl-core-careteam profile.
|
| 18.2 Healthcare provider | |
see Procedure.performer see Encounter.serviceProvider |
Providers are exchanged as part of the BgZ information elements according to the nl-core-organization profile. There is no specific query to retrieve Healthcare Providers. |
Table 4. FHIR queries used to retrieve BgZ MSZ components.
| Meta data | ||
|---|---|---|
| Query | Description | Example |
GET [base]/[FHIR resource]?_revinclude=Provenance:target |
When metadata may be required, provenance data available in the source system for a specific BgZ summary should be exchanged according to the BgZ-metadata profile as FHIR Provenance instances. | 14.1 Laboratory test result incl. meta data
GET [base]/Observation/$lastn?_revinclude=Provenance:target&category=http://snomed.info/sct|49581000146104&_include=Observation:related-target |
Table 5. The FHIR query and explanation to retrieve metadata.
4.3 Notified Pull Query Specification
The following table provides the overview of codings needed to retrieve all the BgZ MSZ sections. The coding column defines codedConcepts that identify the BgZ MSZ section (HCIM) to retrieve.
| Chapter | Section | Notified Pull coding |
|---|---|---|
| 1 Demographics and identification | 1.1 Patient | http://loinc.org/79191-3 |
| 1.2 Marital status | Data are exchanged as part of the patient. | |
| 2 Financial information | 2.1 Payer | http://loinc.org/48768-6 |
| 3 Treatment restrictions | 3.1 Treatment instructions | http://snomed.info/sct/11291000146105 |
| 3.2 Advance directive | http://snomed.info/sct/11341000146107 | |
| 4 Contact persons | 4.1 Contact | Data are exchanged as part of the patient. |
| 5 Functional/mental status | 5.1 Functional or mental status | http://loinc.org/47420-5 |
| 6 Complaints and diagnoses | 6.1 Problem | http://loinc.org/11450-4 |
| 7 Social history | 7.1 Living Situation | http://snomed.info/sct/365508006 |
| 7.2 Drug Use | http://snomed.info/sct/228366006 | |
| 7.3 Alcohol Use | http://snomed.info/sct/228273003 | |
| 7.4 Tobacco Use | http://snomed.info/sct/365980008 | |
| 7.5 Nutrition Advice | http://snomed.info/sct/11816003 | |
| 8 Alerts | 8.1 Alert | http://loinc.org/75310-3 |
| 9 Allergies | 9.1 Allergy Intolerance | http://loinc.org/48765-2 |
| 10 Medication | 10.1 Medication Agreement | http://snomed.info/sct/422979000 |
| 10.2 Administration Agreement | http://snomed.info/sct/422037009 | |
| 10.3 Medication Use | http://snomed.info/sct/16076005 | |
| 11 Medical devices | 11.1 Medical device | http://loinc.org/46264-8 |
| 12 Vaccinations | 12.1 Vaccination | http://loinc.org/11369-6 |
| 13 vital signs and measurements | 13.1 Blood pressure | http://loinc.org/85354-9 |
| 13.2 Body weight | http://loinc.org/29463-7 | |
| 13.3 Body height | http://loinc.org/8302-2 | |
| 14 Results | 14.1 Laboratory test result | http://snomed.info/sct/15220000 |
| 15 Procedures | 15.1 Procedure | http://loinc.org/47519-4 |
| 16 Encounters | 16.1 Encounter | http://loinc.org/46240-8 |
| 17 Planned care activity | 17.1 Procedure | http://loinc.org/18776-5 |
| 18 Care Setting | 18.1 Health professional | http://snomed.info/sct/229774002 |
| 18.2 Healthcare provider | Data are exchanges as part of other BgZ components. | |
| Meta data | Meta data | http://snomed.info/sct/257733005 |
Table 6. FHIR Task.input Query Specification.
4.4 Glossary
| Term | Description |
|---|---|
| HCIM | Health and Care Information models (HCIM) or Zorginformatiebouwstenen (ZIB's) are used to capture functional, semantic (non-technical) agreements for the standardization of information used in the care process. |
Table 7. Glossary.
5 Release notes
Please find the release notes on the functional design page.
6 Support
For questions and change requests regarding the information on this page, please create a ticket in Servicedesk Portal.