MedMij FHIR Implementation Guide Medication Process 9.0.7

Uit informatiestandaarden
Ga naar: navigatie, zoeken
(Interactions, operations, search parameters)
(march release)
(12 tussenliggende versies door 5 gebruikers niet weergegeven)
Regel 1: Regel 1:
{{#customtitle:MedMij FHIR Implementation Guide Medication Process 9.0.7}}
+
__NUMBEREDHEADINGS__
 +
{{#customtitle:MedMij FHIR Implementation Guide Medication Process {{VersieInfo|V2019.01|Medicatieproces}}}}
  
 
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
 
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
Regel 41: Regel 42:
 
| PHR
 
| PHR
 
| Personal health record
 
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/medication-clientcapabilities CapabilityStatement: Client]
+
|[[Bestand: Verwijzing.png| 20px]] {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/medication-clientcapabilities|CapabilityStatement: Client}}
 
| Medication process client requirements  
 
| Medication process client requirements  
 
|-
 
|-
Regel 48: Regel 49:
 
| XIS
 
| XIS
 
| Healthcare information system
 
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/medication-servercapabilities CapabilityStatement: Server]
+
|[[Bestand: Verwijzing.png| 20px]] {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/medication-servercapabilities|CapabilityStatement: Server}}
 
| Medication process server requirements  
 
| Medication process server requirements  
 
|}
 
|}
Regel 110: Regel 111:
  
 
=====Message content=====
 
=====Message content=====
The outcome of the [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/OperationDefinition/Medication-Overview medication-overview operation] is the body of the medication overview request message. Successful processing of this operation should result in a Bundle recourse, containing one List and one Patient resource as entries along with all the resources that represent the current medication overview. These resources SHALL be referenced from the List resource. The clinical content of the medication overview is defined in the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.0.7_Ontwerp_medicatieproces#Medicatieoverzicht_en_afleidingsregels Medication Process specification]. The functional dataset of the medication overview can be found on [http://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.148-2016-11-08T103441.html decor.nictiz.nl].
+
The outcome of the {{Simplifier|http://nictiz.nl/fhir/OperationDefinition/Medication-Overview|medication-overview operation}} is the body of the medication overview request message. Successful processing of this operation should result in a Bundle recourse, containing one List and one Patient resource as entries along with all the resources that represent the current medication overview. These resources SHALL be referenced from the List resource. The clinical content of the medication overview is defined in the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.0.7_Ontwerp_medicatieproces#Medicatieoverzicht_en_afleidingsregels Medication Process specification]. The functional dataset of the medication overview can be found on [http://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.148-2016-11-08T103441.html decor.nictiz.nl].
  
  
Regel 119: Regel 120:
 
The content in the response message SHALL be a valid instance of the following profiles. Clicking on the link will open the formal definition on Simplifier.net.
 
The content in the response message SHALL be a valid instance of the following profiles. Clicking on the link will open the formal definition on Simplifier.net.
  
* '''Bundle profile:''' [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/Bundle-MedicationOverview http://nictiz.nl/fhir/StructureDefinition/Bundle-MedicationOverview]
+
* '''Bundle profile:''' {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/Bundle-MedicationOverview}}
* '''List profile:''' [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/MedicationOverview http://nictiz.nl/fhir/StructureDefinition/MedicationOverview]
+
* '''List profile:''' {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/MedicationOverview}}
  
 
The Bundle profile represents the structure of the retrieve medication overview response message. The List profile represents the actual medication overview. The List contains the medication overview metadata and references to all resources that constitute the medication overview. These resources are included in the Bundle as entries. The Bundle.total value contains the number of matching HCIMs: MedicationUse, AdministrationAgreement and MedicationAgreement. Other included resources, such as Medication resources, are not included in the total. The returned Bundle has at least one List and one Patient resource.  
 
The Bundle profile represents the structure of the retrieve medication overview response message. The List profile represents the actual medication overview. The List contains the medication overview metadata and references to all resources that constitute the medication overview. These resources are included in the Bundle as entries. The Bundle.total value contains the number of matching HCIMs: MedicationUse, AdministrationAgreement and MedicationAgreement. Other included resources, such as Medication resources, are not included in the total. The returned Bundle has at least one List and one Patient resource.  
Regel 126: Regel 127:
 
All returned resources to the PHR, including the Bundle and List, SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance. The resources in the response message SHALL be a valid instance of these profiles. In the table below, the HCIMs that constitute the clinical content of the Medication Overview and their respective profiles are listed.  
 
All returned resources to the PHR, including the Bundle and List, SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance. The resources in the response message SHALL be a valid instance of these profiles. In the table below, the HCIMs that constitute the clinical content of the Medication Overview and their respective profiles are listed.  
  
'''Note''' that the medication building blocks are grouped per 'medication treatment' conform the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.0.7_Ontwerp_medicatieproces#Medicamenteuze_behandeling Medication Process specification]. Grouping SHALL be done by use of a 'medication treatment' identifier. This identifier shall be the same across different related medication resources that constitute a medication treatment. The [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Medication-MedicationTreatment zib-Medication-MedicationTreatment extension] is added to all medication profiles and can be used for this grouping purpose.
+
'''Note''' that the medication building blocks are grouped per 'medication treatment' conform the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.0.7_Ontwerp_medicatieproces#Medicamenteuze_behandeling Medication Process specification]. Grouping SHALL be done by use of a 'medication treatment' identifier. This identifier shall be the same across different related medication resources that constitute a medication treatment. The {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Medication-MedicationTreatment|zib-Medication-MedicationTreatment extension}} is added to all medication profiles and can be used for this grouping purpose.
  
{{NoteBoxPackage|https://simplifier.net/NictizSTU3-Zib2017/~packages|1.1.x|MedMij:V2019.01_FHIR_IG}}
+
{{NoteBoxPackage|https://simplifier.net/NictizSTU3-Zib2017/~packages|1.3.x|MedMij:V2019.01_FHIR_IG}}
  
 
{| class="wikitable"  
 
{| class="wikitable"  
Regel 138: Regel 139:
 
| #HCIM Patient|Patient
 
| #HCIM Patient|Patient
 
| Patient
 
| Patient
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient  http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
+
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-patient}}
 
|-
 
|-
 
| Zorgverlener
 
| Zorgverlener
 
| HealthProfessional
 
| HealthProfessional
 
| Practitioner
 
| Practitioner
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
+
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner}}
 
|-
 
|-
 
| Zorgaanbieder
 
| Zorgaanbieder
 
| HealthcareProvider
 
| HealthcareProvider
 
| Organization
 
| Organization
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
+
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-organization}}
 
|-
 
|-
| Medicatiegebruik||MedicationUse||MedicationStatement|| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse]
+
| Medicatiegebruik||MedicationUse||MedicationStatement|| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse}}
 
|-
 
|-
| Toedieningsafspraak||AdministrationAgreement||MedicationDispense|| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement]
+
| Toedieningsafspraak||AdministrationAgreement||MedicationDispense|| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement}}
 
|-
 
|-
| Medicatieafspraak||MedicationAgreement||MedicationRequest|| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
+
| Medicatieafspraak||MedicationAgreement||MedicationRequest|| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement}}
 
|-
 
|-
| Product||Product||Medication|| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Product http://nictiz.nl/fhir/StructureDefinition/zib-Product]
+
| Product||Product||Medication|| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Product}}
 
|-
 
|-
| GebruiksInstructie||InstructionsForUse||Dosage (datatype)|| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse]
+
| GebruiksInstructie||InstructionsForUse||Dosage (datatype)|| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse}}
 
|-
 
|-
 
|}
 
|}
Regel 171: Regel 172:
 
===Operations===
 
===Operations===
 
The retrieve medication overview medication operation is used for this transaction. The formal definition can be found here:
 
The retrieve medication overview medication operation is used for this transaction. The formal definition can be found here:
* [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/MedicationOverview Medication Overview]
+
* {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/MedicationOverview|Medication Overview}}
  
 
===Search parameters===
 
===Search parameters===
Regel 282: Regel 283:
 
The following custom search parameters are defined for this use case:
 
The following custom search parameters are defined for this use case:
  
* [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/SearchParameter/Medications-category http://nictiz.nl/fhir/SearchParameter/Medications-category]
+
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/Medications-category}}
* [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/SearchParameter/Medications-periodofuse http://nictiz.nl/fhir/SearchParameter/Medications-periodofuse]
+
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/Medications-periodofuse}}
* [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/SearchParameter/Medications-medicationtreatment http://nictiz.nl/fhir/SearchParameter/Medications-medicationtreatment]
+
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/Medications-medicationtreatment}}
  
  
Regel 325: Regel 326:
  
 
'''MedicationTreatment'''
 
'''MedicationTreatment'''
 +
{{NoteBox|1= Known issue: the second example search request on the server's base using the custom search parameter 'medicationtreatment' is not correct en potentially dangerous. Therefore this should not be implemented and used. Future versions of the information standard will not contain this request. It is expected that requests are made on the Resource type (first example) instead of the server base. More information can be found here: https://bits.nictiz.nl/browse/MM-560}}
 
<pre>1. [base]/MedicationRequest?medicationtreatment=http://example.nl/fhir/NamingSystem/medicationtreatment|1247848  
 
<pre>1. [base]/MedicationRequest?medicationtreatment=http://example.nl/fhir/NamingSystem/medicationtreatment|1247848  
 
2. [base]/?medicationtreatment=http://example.nl/fhir/NamingSystem/medicationtreatment|1247848 </pre>
 
2. [base]/?medicationtreatment=http://example.nl/fhir/NamingSystem/medicationtreatment|1247848 </pre>
Regel 352: Regel 354:
 
The returned data to the PHR SHALL conform to the medication HCIMs profiles. The table below lists the medication HCIMs and their respective FHIR profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.
 
The returned data to the PHR SHALL conform to the medication HCIMs profiles. The table below lists the medication HCIMs and their respective FHIR profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.
  
'''Note''' that the medication building blocks are grouped per 'medication treatment' conform the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.0.7_Ontwerp_medicatieproces#Medicamenteuze_behandeling Medication Process specification]. Grouping SHALL be done by use of a 'medication treatment' identifier. This identifier shall be the same across different related medication resources that constitute a medication treatment. The [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Medication-MedicationTreatment zib-Medication-MedicationTreatment extension] is added to all medication profiles and can be used for this grouping purpose.
+
'''Note''' that the medication building blocks are grouped per 'medication treatment' conform the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.0.7_Ontwerp_medicatieproces#Medicamenteuze_behandeling Medication Process specification]. Grouping SHALL be done by use of a 'medication treatment' identifier. This identifier shall be the same across different related medication resources that constitute a medication treatment. The {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Medication-MedicationTreatment|zib-Medication-MedicationTreatment extension}} is added to all medication profiles and can be used for this grouping purpose.
  
{{NoteBoxPackage|https://simplifier.net/NictizSTU3-Zib2017/~packages|1.1.x|MedMij:V2019.01_FHIR_IG}}
+
{{NoteBoxPackage|https://simplifier.net/NictizSTU3-Zib2017/~packages|1.3.x|MedMij:V2019.01_FHIR_IG}}
  
 
{| class="wikitable" width="1400px"
 
{| class="wikitable" width="1400px"
Regel 364: Regel 366:
 
| #ZIB Patient|Patient
 
| #ZIB Patient|Patient
 
| Patient
 
| Patient
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
+
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-patient}}
 
|-
 
|-
 
| Zorgverlener
 
| Zorgverlener
 
| HealthProfessional
 
| HealthProfessional
 
| Practitioner
 
| Practitioner
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
+
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner}}
 
|-
 
|-
 
| Zorgaanbieder
 
| Zorgaanbieder
 
| HealthcareProvider
 
| HealthcareProvider
 
| Organization
 
| Organization
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
+
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-organization}}
 
|-
 
|-
| Medicatiegebruik||MedicationUse||MedicationStatement|| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse]
+
| Medicatiegebruik||MedicationUse||MedicationStatement|| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse}}
 
|-
 
|-
| Medicatietoediening||MedicationAdministration||MedicationAdministration|| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAdministration http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAdministration]
+
| Medicatietoediening||MedicationAdministration||MedicationAdministration|| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAdministration}}
 
|-
 
|-
| Toedieningsafspraak||AdministrationAgreement||MedicationDispense|| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement]
+
| Toedieningsafspraak||AdministrationAgreement||MedicationDispense|| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement}}
 
|-
 
|-
| Medicatieafspraak||MedicationAgreement||MedicationRequest|| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
+
| Medicatieafspraak||MedicationAgreement||MedicationRequest|| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement}}
 
|-
 
|-
| Verstrekking||Dispense||MedicationDispense|| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Dispense http://nictiz.nl/fhir/StructureDefinition/zib-Dispense]
+
| Verstrekking||Dispense||MedicationDispense|| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Dispense}}
 
|-
 
|-
| Verstrekkingsverzoek||DispenseRequest||MedicationRequest|| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-DispenseRequest http://nictiz.nl/fhir/StructureDefinition/zib-DispenseRequest]
+
| Verstrekkingsverzoek||DispenseRequest||MedicationRequest|| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-DispenseRequest}}
 
|-
 
|-
| Product||Product||Medication|| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Product http://nictiz.nl/fhir/StructureDefinition/zib-Product]
+
| Product||Product||Medication|| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-Product}}
 
|-
 
|-
| GebruiksInstructie||InstructionsForUse||Dosage (datatype)|| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse]
+
| GebruiksInstructie||InstructionsForUse||Dosage (datatype)|| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse}}
 
|-
 
|-
 
|}
 
|}
Regel 417: Regel 419:
 
The following custom search parameters are defined for this use case:
 
The following custom search parameters are defined for this use case:
  
* [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/SearchParameter/Medications-category http://nictiz.nl/fhir/SearchParameter/Medications-category]
+
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/Medications-category}}
* [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/SearchParameter/Medications-periodofuse http://nictiz.nl/fhir/SearchParameter/Medications-periodofuse]
+
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/Medications-periodofuse}}
* [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/SearchParameter/Medications-medicationtreatment http://nictiz.nl/fhir/SearchParameter/Medications-medicationtreatment]
+
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/Medications-medicationtreatment}}
  
 
=Use case: retrieve Dispense612ToFHIRConversion from the LSP=
 
=Use case: retrieve Dispense612ToFHIRConversion from the LSP=
Regel 493: Regel 495:
 
GET [base]/MedicationDispense?category=http://snomed.info/sct|373784005,http://snomed.info/sct|422037009&periodofuse=le2011-12-31&periodofuse=ge2010-01-01&_include=MedicationRequest:medication&_include=MedicationDispense:patient&_include=MedicationDispense:performer
 
GET [base]/MedicationDispense?category=http://snomed.info/sct|373784005,http://snomed.info/sct|422037009&periodofuse=le2011-12-31&periodofuse=ge2010-01-01&_include=MedicationRequest:medication&_include=MedicationDispense:patient&_include=MedicationDispense:performer
 
</pre>
 
</pre>
Retrieves MedicationDispense resources that represent a HCIM MedicationDispense or AdministrationAgreement, were in effect within a 2 year period and includes related Medication, Patient and Organiation resources in the result.
+
Retrieves MedicationDispense resources that represent a HCIM MedicationDispense or AdministrationAgreement, were in effect within a 2 year period and includes related Medication, Patient and Organization resources in the result.
  
 
'''DispensePeriod'''
 
'''DispensePeriod'''
Regel 504: Regel 506:
 
The following custom search parameters are defined for this use case:
 
The following custom search parameters are defined for this use case:
  
* [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/SearchParameter/Medications-category http://nictiz.nl/fhir/SearchParameter/Medications-category]
+
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/Medications-category}}
* [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/SearchParameter/Medications-periodofuse http://nictiz.nl/fhir/SearchParameter/Medications-periodofuse]
+
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/Medications-periodofuse}}
* [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Dispense-RequestDate http://nictiz.nl/fhir/StructureDefinition/zib-Dispense-RequestDate]
+
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/MedicationDispense-requestdate}}
  
 
===XIS: response message===
 
===XIS: response message===
Regel 529: Regel 531:
 
These profiles are derived from the HCIM profiles. This use case has a very specific and stable underlying dataset. Therefore, the profiles contain many mandatory elements. Within the Medication Process dataset, there is a difference between the concept cardinalities '1..* Required' and '1..* Mandatory'.: The first means the element is required to be present, if the system possesses the information and the latter means the element should always be present. Both are mapped to a mandatory cardinality in the FHIR profiles. If the XIS is not able to provide the required information for a mandatory element, it shall use a nullFlavor extension (http://hl7.org/fhir/STU3/extension-iso21090-nullflavor) to indicate that and why the information is not present. The PHR should be able to process nullFlavor extensions and values.  
 
These profiles are derived from the HCIM profiles. This use case has a very specific and stable underlying dataset. Therefore, the profiles contain many mandatory elements. Within the Medication Process dataset, there is a difference between the concept cardinalities '1..* Required' and '1..* Mandatory'.: The first means the element is required to be present, if the system possesses the information and the latter means the element should always be present. Both are mapped to a mandatory cardinality in the FHIR profiles. If the XIS is not able to provide the required information for a mandatory element, it shall use a nullFlavor extension (http://hl7.org/fhir/STU3/extension-iso21090-nullflavor) to indicate that and why the information is not present. The PHR should be able to process nullFlavor extensions and values.  
  
{{NoteBoxPackage|https://simplifier.net/NictizSTU3-Zib2017/~packages|1.1.x|MedMij:V2019.01_FHIR_IG}}
+
{{NoteBoxPackage|https://simplifier.net/NictizSTU3-Zib2017/~packages|1.3.x|MedMij:V2019.01_FHIR_IG}}
  
 
{| class="wikitable" width="1400px"
 
{| class="wikitable" width="1400px"
Regel 539: Regel 541:
 
| Patient
 
| Patient
 
| Patient
 
| Patient
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Patient  http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Patient]
+
| {{Simplifier| http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Patient}}
 
|-
 
|-
 
| Zorgaanbieder
 
| Zorgaanbieder
 
| HealthcareProvider
 
| HealthcareProvider
 
| Organization
 
| Organization
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Organization http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Organization]
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Organization}}
 
|-
 
|-
 
| Toedieningsafspraak
 
| Toedieningsafspraak
 
| AdministrationAgreement
 
| AdministrationAgreement
 
| MedicationDispense
 
| MedicationDispense
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-AdministrationAgreement http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-AdministrationAgreement]
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-AdministrationAgreement}}
 
|-
 
|-
 
| Verstrekking
 
| Verstrekking
 
| Dispense
 
| Dispense
 
| MedicationDispense
 
| MedicationDispense
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Dispense http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Dispense]
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Dispense}}
 
|-
 
|-
 
| Product
 
| Product
 
| Product
 
| Product
 
| Medication
 
| Medication
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Product http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Product]
+
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Product}}
 
|-
 
|-
 
|}
 
|}
Regel 586: Regel 588:
 
The following custom search parameters are defined for this use case:
 
The following custom search parameters are defined for this use case:
  
* [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/SearchParameter/Medications-category http://nictiz.nl/fhir/SearchParameter/Medications-category]
+
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/Medications-category}}
* [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/SearchParameter/Medications-periodofuse http://nictiz.nl/fhir/SearchParameter/Medications-periodofuse]
+
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/Medications-periodofuse}}
* [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Dispense-RequestDate http://nictiz.nl/fhir/StructureDefinition/zib-Dispense-RequestDate]
+
* {{Simplifier|http://nictiz.nl/fhir/SearchParameter/MedicationDispense-requestdate}}
  
 
=Terminology, NamingSystems, Mappings=
 
=Terminology, NamingSystems, Mappings=
Regel 599: Regel 601:
  
 
===Mappings===
 
===Mappings===
A FHIR ConceptMap resource is provided when a FHIR value set is used instead of a HCIM value set. A ConceptMap maps the values between the two value sets. ConceptMaps can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap here].
+
A FHIR ConceptMap resource is provided when a FHIR value set is used instead of a HCIM value set. A ConceptMap maps the values between the two value sets. These ConceptMaps can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap here].
  
All profiles include HCIM mappings and are redered on Simplifier.net under the 'Mapping' tab of a profile. HCIM concepts are mapped to the corresponding FHIR elements using the HCIMs concept id. The top of the StructureDefinition contains meta information regarding the HCIM mapping, such as the name and uri of the HCIM or dataset. In the StructureDefinition elements, the corresponding HCIM concept or functional dataset concept ID is given including the mapping meta information id. This is illustrated in the following example.
+
An explanation about mappings can be found at [[MedMij:V2019.01_FHIR_IG#Mapping_of_coded_concepts|Mapping of coded concepts]].
 
+
<pre>
+
<StructureDefinition>
+
    <id value="nl-core-patient" />
+
    .....
+
    <mapping>
+
        <identity value="hcim-patient-v3.1-2017EN"/>
+
        <uri value="https://zibs.nl/wiki/Patient-v3.1(2017EN)"/>
+
        <name value="HCIM Patient-v3.1(2017EN)"/>
+
    </mapping>
+
    .....
+
        <element id="Patient.name">
+
            <path value="Patient.name" />
+
            <short value="NameInformation" />
+
            <alias value="Naamgegevens" />
+
            <type>
+
                <code value="HumanName" />
+
                <profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
+
            </type>
+
            <mapping>
+
                <identity value="hcim-patient-v3.1-2017EN"/>
+
                <map value="NL-CM:0.1.6"/>
+
            </mapping>
+
        </element>
+
    .....
+
</StructureDefinition>
+
</pre>
+
  
 
=Examples=
 
=Examples=
Regel 641: Regel 616:
  
 
==History==
 
==History==
{| class="wikitable" "cellpadding="10"
+
{| class="wikitable" "cellpadding="10" style="background-color: white;"
 
!style="text-align:left;"|Release
 
!style="text-align:left;"|Release
 
!style="text-align:left;"|Date
 
!style="text-align:left;"|Date
 
!style="text-align:left;"|Description
 
!style="text-align:left;"|Description
 +
|-
 +
| style="background-color: white;"| 2019.01 - March 2020
 +
| style="background-color: white;"| 25-03-2020
 +
| style="background-color: white;"|
 +
* Changes for 2019.01 March 2020 patch release
 +
* Added new version of FHIR package
 +
|-
 +
| style="background-color: white;"| 2019.01 - February 2020
 +
| style="background-color: white;"| 27-02-2020
 +
| style="background-color: white;"|
 +
* Changes for 2019.01 February 2020 patch release
 +
* Added new version of FHIR package
 +
|-
 +
| style="background-color: white;"| 2019.01 - January 2020
 +
| style="background-color: white;"| 27-01-2020
 +
| style="background-color: white;"|
 +
* Changes for 2019.01 January 2020 patch release
 +
* Added new version of FHIR package
 +
|-
 +
| style="background-color: white;"| 2019.01 - November
 +
| style="background-color: white;"| 28-11-2019
 +
| style="background-color: white;"|
 +
* Changes for 2019.01 November patch release
 +
* Added new version of FHIR package
 
|-
 
|-
 
| style="background-color: white;"| 2019.01
 
| style="background-color: white;"| 2019.01
 +
| style="background-color: white;"| 30-09-2019
 +
| style="background-color: white;"|
 +
* Added new version of FHIR package
 +
|-
 +
| style="background-color: white;"| 2019.01
 
| style="background-color: white;"| 27-06-2019
 
| style="background-color: white;"| 27-06-2019
 
| style="background-color: white;"|  
 
| style="background-color: white;"|  

Versie van 25 mrt 2020 om 12:34

Naar medmij.nl
Medication process
AfsprakenstelselFunctionalTecnicalAfspraken-Functioneel-Technisch

Inhoud

1 Introduction

Go to functional design

This page describes patient's use cases, in a personal health record (PHR) context, in relation to the information standard Medication Process (MP). These use cases are based on version 9.x of this standard. Functional specification of these use cases are described in the functional design wiki page. The technical specification is described here. HL7 FHIR STU3 is used for this purpose.

The Medication Process information building blocks are adopted by 'Registratie aan de Bron' and converted to Health and Care Information models (HCIM), also called ZIB's. In order to exchange medication information between systems, FHIR representations of these HCIMs are made and used in the transactions described on this page.

Use cases:

2 Actors involved

Persons Systems FHIR Capability Statements
Name Description Name Description Name Description
Patient The user of a personal healthcare enviorment. PHR Personal health record Verwijzing.png CapabilityStatement: Client Medication process client requirements
Healthcare professional The user of a XIS XIS Healthcare information system Verwijzing.png CapabilityStatement: Server Medication process server requirements

3 Use case: retrieve medication overview

This FHIR implementation guide assumes that the PHR system is able to make a connection to the right XIS that contains the patient's information. It does not provide information on finding the right XIS nor does it provide information about security. Moreover, each transaction is performed in the context of a specific authenticated patient, for whose context (token) has been established using the authentication mechanisms described in the 'Afsprakenstelsel'. Each XIS Gateway is required to perform filtering based on the patient associated with the context for the request, so only the records associated with the authenticated patient are returned. For this reason, search parameters should not be included for patient identification.

3.1 Introduction

The retrieve medication overview transaction is used by the PHR to retrieve a medication overview from the XIS.

3.2 Actors

Transaction group Transaction Actor Role
Retrieve Medication Overview(PULL) Retrieve medication overview request Patient (using a PHR) Request medication overview from the XIS
Retrieve medication overview response Healthcare professional (using a XIS) Serves medication overview to the PHR

3.3 Invocations

3.3.1 PHR: request message

This message uses an extended operation on the RESTful API to obtain a medication overview from a XIS. This operation is used because the XIS needs to play an active role in formulating the content of the response.

3.3.1.1 Trigger Events

When the patient (PHR) wants to obtain the current medication overview, it issues a retrieve medication overview request message.

3.3.1.2 Message Semantics

The PHR executes a medication-overview operation with HTTP POST against the XIS's base endpoint as shown below.

POST [base]/$medication-overview
3.3.1.2.1 Expected Actions

The XIS shall process the operation to find or generate and return the current medication overview.

3.3.2 XIS: response message

The XIS returns a HTTP Status code appropriate to the processing of the operation as well as a Bundle of type 'searchset', containing one List and one Patient resource along with other resources that represent the Medication Overview.

3.3.2.1 Trigger Events

The XIS completed processing of the retrieve medication overview request message.

3.3.2.2 Message Semantics

Based on the medication-overview operation processing results, the XIS will either return an error or success. When the XIS needs to report an error, it shall use HTTP error response codes and shall include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not a Medication Overview is found or generated, the HTTP status code shall be 200.

The body of the response message shall be a Bundle resource of type "searchset". The following section will elaborate on the content included.

If the XIS is sending warnings, the Bundle resource shall also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:

3.3.2.2.1 Message content

The outcome of the medication-overview operation is the body of the medication overview request message. Successful processing of this operation should result in a Bundle recourse, containing one List and one Patient resource as entries along with all the resources that represent the current medication overview. These resources SHALL be referenced from the List resource. The clinical content of the medication overview is defined in the Medication Process specification. The functional dataset of the medication overview can be found on decor.nictiz.nl.


The content in the response message SHALL be a valid instance of the following profiles. Clicking on the link will open the formal definition on Simplifier.net.

The Bundle profile represents the structure of the retrieve medication overview response message. The List profile represents the actual medication overview. The List contains the medication overview metadata and references to all resources that constitute the medication overview. These resources are included in the Bundle as entries. The Bundle.total value contains the number of matching HCIMs: MedicationUse, AdministrationAgreement and MedicationAgreement. Other included resources, such as Medication resources, are not included in the total. The returned Bundle has at least one List and one Patient resource.

All returned resources to the PHR, including the Bundle and List, SHALL include their related profile canonical URL in the meta.profile element in order to show compliance. The resources in the response message SHALL be a valid instance of these profiles. In the table below, the HCIMs that constitute the clinical content of the Medication Overview and their respective profiles are listed.

Note that the medication building blocks are grouped per 'medication treatment' conform the Medication Process specification. Grouping SHALL be done by use of a 'medication treatment' identifier. This identifier shall be the same across different related medication resources that constitute a medication treatment. The zib-Medication-MedicationTreatment extension is added to all medication profiles and can be used for this grouping purpose.

Em.png

MedMij uses the FHIR Packaging mechanism. This conveniently bundles all examples, profiles and other conformance resources you need into a single download. For more background information see the the FHIR implementation guide. This version of the information standard depends on Nictiz package 1.3.x. Please note that the direct links to the various conformance resources below will take you to the latest version, which might not match the package version. At time of writing, there is no way to render the conformance resource as found in the package. This is on the roadmap for Simplifier.
HCIM name NL HCIM name EN FHIR Resource FHIR Profile
Patient Patient Patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient
Zorgverlener HealthProfessional Practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner
Zorgaanbieder HealthcareProvider Organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization
Medicatiegebruik MedicationUse MedicationStatement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse
Toedieningsafspraak AdministrationAgreement MedicationDispense http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement
Medicatieafspraak MedicationAgreement MedicationRequest http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement
Product Product Medication http://nictiz.nl/fhir/StructureDefinition/zib-Product
GebruiksInstructie InstructionsForUse Dosage (datatype) http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse

3.3.2.3 Expected Actions

The PHR processes the results according to application-defined rules. The PHR should be robust as the response may contain medication information resources as mentioned in the former section.

3.4 Interactions, operations, search parameters

3.4.1 Interactions

No interactions are needed for the retrieve medication overview transaction.

3.4.2 Operations

The retrieve medication overview medication operation is used for this transaction. The formal definition can be found here:

3.4.3 Search parameters

The following search parameter type needs to be supported for this transaction.

Search parameter types:

4 Use case: retrieve medication information

This FHIR implementation guide assumes that the PHR system is able to make a connection to the right XIS that contains the patient's information. It does not provide information on finding the right XIS nor does it provide information about security. Moreover, each transaction is performed in the context of a specific authenticated patient, for whose context (token) has been established using the authentication mechanisms described in the 'Afsprakenstelsel'. Each XIS Gateway is required to perform filtering based on the patient associated with the context for the request, so only the records associated with the authenticated patient are returned. For this reason, search parameters should not be included for patient identification.

4.1 Introduction

The Retrieve Medication Information transaction is used by the PHR to retrieve medication information from the XIS. The PHR can use this transaction to retrieve the desired information by searching on specific medication building blocks.

4.2 Actors

Transaction group Transaction Actor Role
Retrieve Medication Information(PULL) Retrieve medication information request Patient (using a PHR) Request medication information from the XIS
Retrieve medication information response Healthcare professional (using a XIS) Serves medication information to the PHR

4.3 Invocations

4.3.1 PHR: request message

This message uses the HTTP GET method parameterized query to obtain medication information from a XIS. Multiple different HTTP GET request messages may be needed to retrieve all medication information.

4.3.1.1 Trigger Events

When the patient (PHR) wants to obtain medication information matching various parameters, it issues a retrieve medication information request message.

4.3.1.2 Message Semantics

The PHR executes an HTTP GET against the XIS's medication FHIR endpoints. These endpoints can be one of the following:

  • MedicationRequest
  • MedicationAdministration
  • MedicationDispense
  • MedicationStatement

The search interaction is performed by an HTTP GET conform the FHIR search specification, as shown below. This URL is configurable by the PHR by configuring the query search parameters and search control parameters to modify the behaviour of the XIS such as response format, or pagination.

GET [base]/[type]{?[parameters]{&_format=[mime-type]}}
4.3.1.2.1 Search on category code

To distinguish the medication HCIMs between each other and between general medication resources, a fixed category coding has been added to the medication HCIM profiles (listed below in the Message content section). The fixed category code is solely used for indexing and retrieval of the HCIM building blocks.

4.3.1.2.2 Including other resources in searchresults

The PHR may request that the XIS return resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This is useful when the PHR is searching on a clinical resource, but for every such resource returned, the client will also need the subject (Patient resource) or prescriber (Practitioner resource) or medication that the clinical resource refers to. The client can use the _include parameter to indicate that the subject resources be included in the results. Example search:

GET [base]/MedicationRequest?category=http://snomed.info/sct|16076005&_include=MedicationRequest:medication

This search interaction finds all MedicationRequest that represent the HCIM MedicationAgreement and if present includes the referenced Medication resource.

4.3.1.3 Query Search Parameters

The PHR may supply, and the XIS SHALL be capable of processing, all query parameters listed in the table below. The XIS may choose to support additional query parameters beyond the subset listed below. Any additional query parameters supported shall be supported according to the core FHIR specification. Such additional parameters are considered out of scope for this transaction.

MP9 search parameters Description FHIR search parameter FHIR resource
Identification Search on identifier. identifier MedicationRequest, MedicationDispense, MedicationAdministration, MedicationStatement
Type Search on type of medication building block (HCIM). category * / ** MedicationRequest, MedicationAdministration, MedicationDispense, MedicationStatement
ProductCode Search on medication code. code MedicationRequest, MedicationAdministration, MedicationDispense, MedicationStatement, Medication
UsePeriod Search on medication use in the past, present or future within the specified time period. periodofuse ** MedicationDispense, MedicationRequest
DispensePeriod Returns all medication dispenses within the specific period. whenhandedover MedicationDispense
MedicationTreatment Search on the medication treatment identifier medicationtreatment ** MedicationRequest, MedicationAdministration, MedicationDispense, MedicationStatement, System Wide

* The FHIR profiles that represent the medication building blocks contain fixed code values in the .category elements to allow searching on specific medication building blocks. FHIR resources MedicationAdministration and MedicationDispense do not contain a 'category' search parameter in the FHIR specification. Custom search parameters are provided.

** The search parameter consists of a custom created FHIR search parameter not represented in the FHIR specification.

4.3.1.3.1 Custom Search Parameters

The following custom search parameters are defined for this use case:


4.3.1.4 Example Searches

Identifier

1. [base]/MedicationRequest?identifier=http://example.nl/fhir/NamingSystem/MedicationRequest|999922448 
  1. Retrieves a MedicationRequest resource with the identifier 999922448.

Type

1. [base]/MedicationRequest 
2. [base]/MedicationRequest?category=http://snomed.info/sct|16076005
  1. Retrieves all MedicationRequest resources.
  2. Retrieves all MedicationRequest resources that represent a HCIM MedicationAgreement.

ProductCode

1. [base]/MedicationRequest?medication.code=urn:oid:2.16.840.1.113883.2.4.4.8|13610554
2. [base]/MedicationRequest?medication.code=urn:oid:2.16.840.1.113883.2.4.4.8|13610554&_include=MedicationRequest:medication
3. [base]/MedicationRequest?category=http://snomed.info/sct|16076005&medication.code=urn:oid:2.16.840.1.113883.2.4.4.8|13610554
  1. Retrieves all MedicationRequest resources that have Carbasalaatcalcium Sandoz 600 30 as medication.
  2. Retrieves all MedicationRequest resources that have Carbasalaatcalcium Sandoz 600 30 as medication and includes the Medication resource in the search results.
  3. Retrieves all MedicationRequest resources that represent a HCIM MedicationAgreement and have Carbasalaatcalcium Sandoz 600 30 as medication

UsePeriod

1. [base]/MedicationRequest?periodofuse=ge2010-01-01
2. [base]/MedicationDispense?periodofuse=ge2010-01-01&periodofuse=le2011-12-31
3. [base]/MedicationRequest?category=http://snomed.info/sct|16076005&periodofuse=ge2010-01-01
  1. Retrieves all MedicationRequest resources that were in effect after 01-01-2010.
  2. Retrieves all MedicationDispense resources that were in effect within a 2 year period.
  3. Retrieves all MedicationRequest resources that represent a HCIM MedicationAgreement and were in effect after 01-01-2010.

DispensePeriod

1. [base]/MedicationDispense?whenhandedover=ge2010-01-01
2. [base]/MedicationDispense?whenhandedover=ge2010-01-01&whenhandedover=le2011-12-31
3. [base]/MedicationDispense?whenhandedover=ge2010-01-01&category=http://snomed.info/sct|373784005
  1. Retrieves all MedicationDispense resources that were handed over after 01-01-2010.
  2. Retrieves all MedicationDispense resources that were handed over within a 2 year period.
  3. Retrieves all MedicationDispense resources that represent a HCIM Dispense and were handed over after 01-01-2010.

MedicationTreatment

Em.png

Known issue: the second example search request on the server's base using the custom search parameter 'medicationtreatment' is not correct en potentially dangerous. Therefore this should not be implemented and used. Future versions of the information standard will not contain this request. It is expected that requests are made on the Resource type (first example) instead of the server base. More information can be found here: https://bits.nictiz.nl/browse/MM-560

1. [base]/MedicationRequest?medicationtreatment=http://example.nl/fhir/NamingSystem/medicationtreatment|1247848 
2. [base]/?medicationtreatment=http://example.nl/fhir/NamingSystem/medicationtreatment|1247848 
  1. Retrieves all MedicationRequest resources that are part of the medication treatment 1247848.
  2. Retrieves all MedicationRequest, MedicationDispense, MedicationAdministration, MedicationStatement resources that are part of the the medication treatment 1247848


4.3.1.4.1 Expected Actions

The XIS shall process the query to discover the medication information that match the search parameters given.

4.3.2 XIS: response message

The XIS returns a HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching medication information.

4.3.2.1 Trigger Events

The XIS completed processing of the Retrieve medication information request message.

4.3.2.2 Message Semantics

Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any medication resources are found, the HTTP status code SHALL be 200.

The response message SHALL be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:

4.3.2.2.1 Message resource content

The returned data to the PHR SHALL conform to the medication HCIMs profiles. The table below lists the medication HCIMs and their respective FHIR profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the meta.profile element in order to show compliance.

Note that the medication building blocks are grouped per 'medication treatment' conform the Medication Process specification. Grouping SHALL be done by use of a 'medication treatment' identifier. This identifier shall be the same across different related medication resources that constitute a medication treatment. The zib-Medication-MedicationTreatment extension is added to all medication profiles and can be used for this grouping purpose.

Em.png

MedMij uses the FHIR Packaging mechanism. This conveniently bundles all examples, profiles and other conformance resources you need into a single download. For more background information see the the FHIR implementation guide. This version of the information standard depends on Nictiz package 1.3.x. Please note that the direct links to the various conformance resources below will take you to the latest version, which might not match the package version. At time of writing, there is no way to render the conformance resource as found in the package. This is on the roadmap for Simplifier.
HCIM name NL HCIM name EN FHIR Resource FHIR Profile
Patient Patient Patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient
Zorgverlener HealthProfessional Practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner
Zorgaanbieder HealthcareProvider Organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization
Medicatiegebruik MedicationUse MedicationStatement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse
Medicatietoediening MedicationAdministration MedicationAdministration http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAdministration
Toedieningsafspraak AdministrationAgreement MedicationDispense http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement
Medicatieafspraak MedicationAgreement MedicationRequest http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement
Verstrekking Dispense MedicationDispense http://nictiz.nl/fhir/StructureDefinition/zib-Dispense
Verstrekkingsverzoek DispenseRequest MedicationRequest http://nictiz.nl/fhir/StructureDefinition/zib-DispenseRequest
Product Product Medication http://nictiz.nl/fhir/StructureDefinition/zib-Product
GebruiksInstructie InstructionsForUse Dosage (datatype) http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse

4.3.2.3 Expected Actions

The PHR shall process the results according to application-defined rules. The PHR should be robust as the response may contain medication information resources that match the query parameters.

4.4 Interactions, operations, search parameters

4.4.1 Interactions

The following logical interactions are needed for the retrieve medication information transaction:

4.4.2 Operations

No operations are defined or needed for this transaction.

4.4.3 Search parameters

The following search parameter types and search result parameters need to be supported for this transaction.

Search parameter types:

Search result parameters:

The following custom search parameters are defined for this use case:

5 Use case: retrieve Dispense612ToFHIRConversion from the LSP

This FHIR implementation guide assumes that the PHR system is able to make a connection to the right XIS that contains the patient's information. It does not provide information on finding the right XIS nor does it provide information about security. Moreover, each transaction is performed in the context of a specific authenticated patient, for whose context (token) has been established using the authentication mechanisms described in the 'Afsprakenstelsel'. Each XIS Gateway is required to perform filtering based on the patient associated with the context for the request, so only the records associated with the authenticated patient are returned. For this reason, search parameters should not be included for patient identification.

5.1 Introduction

This use case concerns the retrieval of medication dispenses and related medication information that is exchanged between healthcare providers on the 'Landelijk Schakelpunt' (LSP). Over the LSP, these medication dispenses are exchanged based on the information standard MedicationProces version 6.12 in HL7v3-messaging format. In this use case, the requested information by a PHR is converted to FHIR-resources by the XIS.

5.2 Actors

Transaction group Transaction Actor Role
Retrieve Dispense612ToFHIRConversion(PULL) Retrieve Dispense612ToFHIRConversion request Patient (using a PHR) Request Dispense612ToFHIRConversion from the XIS
Retrieve Dispense612ToFHIRConversion response Healthcare professional (using a XIS) Serves Dispense612ToFHIRConversion to the PHR

5.3 Invocations

5.3.1 PHR: request message

This message uses the HTTP GET method parameterized query to obtain medication information from a XIS.

5.3.1.1 Trigger Events

When the patient (PHR) wants to obtain Medication process Dispense 6.12 information matching various parameters, it issues a retrieve Dispense612ToFHIRConversion request message.

5.3.1.2 Message Semantics

The PHR executes an HTTP GET against the XIS's MedicationDispense FHIR endpoint. This URL is configurable by the PHR by configuring the query search parameters and search control parameters to modify the behaviour of the XIS such as response format, or pagination. The search interaction is performed by an HTTP GET compliant with the FHIR search specification as shown:

GET [base]/MedicationDispense{?[parameters]{&_format=[mime-type]}}
5.3.1.2.1 Explicit search on MedicationDispense and AdministrationAgreement

To distinguish the medication-related HCIMs between each other and between general medication resources, a fixed category coding has been added to the medication-related HCIM profiles (listed below in the Message content section). The fixed category code is solely used for indexing and retrieval of the HCIM building blocks.

For this use case, HCIMs MedicationDispense and AdministrationAgreement are requested from the XIS. Both HCIMs are represented by a MedicationDispense resource, however, the PHR makes an explicit request by searching on the category code for both HCIM's.

5.3.1.2.2 Including the Patient, Organization and Medication resources in searchresults

The PHR requests the XIS to return resources related to the MedicationDispense resources, namely the Patient, Organization and Medication resources. The _include parameter is used for this purpose. The request URL syntax is shown here:

GET [base]/MedicationDispense?category=http://snomed.info/sct|373784005,http://snomed.info/sct|422037009&_include=MedicationDispense:medication&_include=MedicationDispense:patient&_include=MedicationDispense:performer{&[parameters]{&_format=[mime-type]}}

This search interaction Retrieves MedicationDispense resources that represent a MedicationDispense or AdministrationAgreement and includes the related Patient, Organization and Medication resources in the result.

5.3.1.3 Query Search Parameters

The PHR may supply, and the XIS SHALL be capable of processing, all query parameters listed in the table below.

MP9 search parameters Description FHIR search parameter
UsePeriod Search on medication use in the past, present or future within the specified time period. periodofuse
DispensePeriod Returns all medication dispenses within the specific period, based on the dispense request date. requestdate

UsePeriod

GET [base]/MedicationDispense?category=http://snomed.info/sct|373784005,http://snomed.info/sct|422037009&periodofuse=le2011-12-31&periodofuse=ge2010-01-01&_include=MedicationRequest:medication&_include=MedicationDispense:patient&_include=MedicationDispense:performer

Retrieves MedicationDispense resources that represent a HCIM MedicationDispense or AdministrationAgreement, were in effect within a 2 year period and includes related Medication, Patient and Organization resources in the result.

DispensePeriod

GET [base]/MedicationDispense?category=http://snomed.info/sct|373784005,http://snomed.info/sct|422037009&requestdate=ge2010-01-01&_include=MedicationRequest:medication&_include=MedicationDispense:patient&_include=MedicationDispense:performer

Retrieves MedicationDispense resources that represent a HCIM MedicationDispense or AdministrationAgreement, that requested after 01-01-2010 and includes related Medication, Patient and Organization resources in the result.

5.3.1.3.1 Custom Search Parameters

The following custom search parameters are defined for this use case:

5.3.2 XIS: response message

The XIS returns a HTTP Status code appropriate to the processing of the request as well as a Bundle of type searchset.

5.3.2.1 Trigger Events

The XIS completed processing of the retrieve medication overview request message.

5.3.2.2 Message Semantics

Based on the retrieve Dispense612ToFHIRConversion request processing results, the XIS will either return an error or success. When the XIS needs to report an error, it shall use HTTP error response codes and shall include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not MedicationDispense resources are found or generated, the HTTP status code shall be 200.

The body of the response message shall be a Bundle resource of type "searchset". The following section will elaborate on the content included.

If the XIS is sending warnings, the Bundle resource shall also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:

5.3.2.2.1 Message resource content

The returned data to the PHR SHALL conform to the profiles listed in the table below. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their respective profile canonical URL in the meta.profile element to show compliance.

These profiles are derived from the HCIM profiles. This use case has a very specific and stable underlying dataset. Therefore, the profiles contain many mandatory elements. Within the Medication Process dataset, there is a difference between the concept cardinalities '1..* Required' and '1..* Mandatory'.: The first means the element is required to be present, if the system possesses the information and the latter means the element should always be present. Both are mapped to a mandatory cardinality in the FHIR profiles. If the XIS is not able to provide the required information for a mandatory element, it shall use a nullFlavor extension (http://hl7.org/fhir/STU3/extension-iso21090-nullflavor) to indicate that and why the information is not present. The PHR should be able to process nullFlavor extensions and values.

Em.png

MedMij uses the FHIR Packaging mechanism. This conveniently bundles all examples, profiles and other conformance resources you need into a single download. For more background information see the the FHIR implementation guide. This version of the information standard depends on Nictiz package 1.3.x. Please note that the direct links to the various conformance resources below will take you to the latest version, which might not match the package version. At time of writing, there is no way to render the conformance resource as found in the package. This is on the roadmap for Simplifier.
HCIM name NL HCIM name EN FHIR Resource FHIR Profile url
Patient Patient Patient http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Patient http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Patient
Zorgaanbieder HealthcareProvider Organization http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Organization
Toedieningsafspraak AdministrationAgreement MedicationDispense http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-AdministrationAgreement
Verstrekking Dispense MedicationDispense http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Dispense
Product Product Medication http://nictiz.nl/fhir/StructureDefinition/mp612-DispenseToFHIRConversion-Product

5.3.2.3 Expected Actions

The PHR shall process the results according to application-defined rules. The PHR should be robust as the response may contain medication information resources that match the query parameters.

5.4 Interactions, operations, search parameters

5.4.1 Interactions

The following logical interactions are needed for the retrieve medication information transaction:

5.4.2 Operations

No operations are defined or needed for this transaction.

5.4.3 Search parameters

The following search parameter types and search result parameters need to be supported for this transaction.

Search parameter types:

Search result parameters:

The following custom search parameters are defined for this use case:

6 Terminology, NamingSystems, Mappings

6.1 Terminology

Relevant ValueSets can be found through the ValueSet bindings in the listed StructureDefinitions. All ValueSets can be found here here and can be downloaded as a .zip in XML or JSON format.

6.2 NamingSystems

Relevant NamingSystems can be found here.

6.3 Mappings

A FHIR ConceptMap resource is provided when a FHIR value set is used instead of a HCIM value set. A ConceptMap maps the values between the two value sets. These ConceptMaps can be found here.

An explanation about mappings can be found at Mapping of coded concepts.

7 Examples

  1. Medicatieproces has a wiki page that contains examples in FHIR and CDA for dosage instructions.
  2. Every profile or resource on Simplifier has a reference tab. The reference tab shows all references from and to the selected resource. So the listed profiles in these use cases have a reference tab on Simplifier where examples are listed that declare conformance to the specific profile.
  3. Examples are accessible through the Simplifier project by going to the resources tab of the project. It is possible to filter on examples and underlying FHIR resource. This is clarified with the following URL, which lists all medication examples available in the NictizSTU3-zib2017 project: https://simplifier.net/NictizSTU3-Zib2017/~resources?category=Example&exampletype=MedicationDispense%7CMedicationStatement%7CMedicationRequest%7CMedication%7CMedicationAdministration&fhirVersion=STU3&sortBy=DisplayName

8 Annex: Document history

8.1 Release notes

Release notes can be found on the functional design page.

8.2 History

Release Date Description
2019.01 - March 2020 25-03-2020
  • Changes for 2019.01 March 2020 patch release
  • Added new version of FHIR package
2019.01 - February 2020 27-02-2020
  • Changes for 2019.01 February 2020 patch release
  • Added new version of FHIR package
2019.01 - January 2020 27-01-2020
  • Changes for 2019.01 January 2020 patch release
  • Added new version of FHIR package
2019.01 - November 28-11-2019
  • Changes for 2019.01 November patch release
  • Added new version of FHIR package
2019.01 30-09-2019
  • Added new version of FHIR package
2019.01 27-06-2019
  • MM-295 updated search specifications of Dispense612ToFHIRConversion. Added link to new search parameter.
2019.01 13-05-2019
  • Correction hyperlink to information standard MP in introduction.
2019.01 11-03-2019
  • Publication of changes in version 2019.01, conform release notes.
  • Moved release notes to functional design page.
2019.01 11-03-2019
  • finished use case Dispense612ToFHIRConversion.
2019.01 11-03-2019
  • MM-106 - Bundle.total verduidelijkt bij MedicationOverview use case.
  • replaced HCIM name MedicationUsage to MedicationUse.
2019.01 11-03-2019
  • Moved release notes to the functional design page.
  • Replaced ZIB with HCIM.
  • Textual improved the PHR request message section of the Medication Information use case.
  • Added draft of use case retrieve Dispense612ToFHIRConversion from the LSP.
2018.06 12-12-2018 Replaced "https://vonk.test-nictiz.nl" with [base].
2018.06 12-11-2018 Added Terminology, NamingSystems, Mappings section.
2018.06 15-10-2018 Added version in title, and document history.