Mappings/mp:Vdraft MP612Dispense 2 MP9TA - Bewerkingsoverzicht

Wetering: /* Conversie specificaties (mappings) */

2023-06-27T14:12:18Z

‎Conversie specificaties (mappings)

Wetering: /* Missende MP9 functionaliteit bij converteren vanaf MP 6.12 */

2023-06-27T13:54:58Z

‎Missende MP9 functionaliteit bij converteren vanaf MP 6.12

Wetering: /* Missende MP9 functionaliteit bij converteren vanaf MP 6.12 */

2023-06-06T14:56:34Z

‎Missende MP9 functionaliteit bij converteren vanaf MP 6.12

Wetering: /* Inleiding */

2023-06-06T14:14:26Z

‎Inleiding

Wetering: /* Informatie in MP 6.12 die niet naadloos past op het MP9 datamodel */

2022-12-27T14:27:32Z

‎Informatie in MP 6.12 die niet naadloos past op het MP9 datamodel

Wetering: /* Informatie in MP 6.12 die niet naadloos past op het MP9 datamodel */

2022-12-27T14:15:34Z

‎Informatie in MP 6.12 die niet naadloos past op het MP9 datamodel

Wetering: Added fixed root OID as per MP-572

2022-12-23T11:22:40Z

Added fixed root OID as per MP-572

Wetering op 16 nov 2022 om 15:28

2022-11-16T15:28:26Z

Wetering: /* Conversie specificaties (mappings) */

2022-11-16T15:18:02Z

‎Conversie specificaties (mappings)

Wijzigingen bekijken

Wetering: Nieuwe pagina aangemaakt met '{{DISPLAYTITLE: Transactie Verstrekkingenvertaling (conversie MP 6.12 verstrekkingenlijst naar MP-9 TA)}} NUMBEREDHEADINGS Bestand:Nictiz_logo_PO_rechts_rgb....'

2022-11-16T12:18:52Z

Nieuwe pagina aangemaakt met '{{DISPLAYTITLE: Transactie Verstrekkingenvertaling (conversie MP 6.12 verstrekkingenlijst naar MP-9 TA)}} __NUMBEREDHEADINGS__ Bestand:Nictiz_logo_PO_rechts_rgb....'

Nieuwe pagina

{{DISPLAYTITLE: Transactie Verstrekkingenvertaling (conversie MP 6.12 verstrekkingenlijst naar MP-9 TA)}}
__NUMBEREDHEADINGS__

[[Bestand:Nictiz_logo_PO_rechts_rgb.png |link=https://www.nictiz.nl/|rechts|Naar nictiz.nl]]
Naar [[Mappingarchitectuur|Mapping architectuur]]
{{TOClimit|4}}
= Inleiding =
Deze pagina beschrijft hoe een versie 6.12 'verstrekkingenlijst' response te converteren naar Medicatieproces (MP9) versie 2.x voor de transactie: 'beschikbaarstellen medicatiegegevens'.

Een versie 6.12 verstrekkingenlijst converteert zich in het MP9 datamodel naar de Toedieningsafspraak (en patiënt).

Aangezien deze conversie plaatsvindt tussen verschillende versies van de MP standaard zijn er een aantal zaken waarmee rekening gehouden moet worden:
* niet alle MP9-functionaliteit is beschikbaar in MP 6.12
* de informatie uit MP 6.12 past niet altijd naadloos op het MP9 datamodel.

Deze twee aspecten zijn hieronder verder uitgewerkt.
==Missende MP9 functionaliteit bij converteren vanaf MP 6.12 ==
{| class="wikitable sortable"
| style="background-color: #1F497D;; color: white; font-weight: bold; text-align:center;" | # || style="background-color: #1F497D;; width:400px; color: white; font-weight: bold; text-align:center;" | Informatie / Functionaliteit || style="background-color: #1F497D;; color: white; font-weight: bold; text-align:center;" | Omschrijving
|-
| 1|| Medicamenteuze behandeling/MBH id niet ondersteund || MBH id vullen met nullFlavor NI.
|-
| 2|| Toedieningsafspraak/TA id niet ondersteund || De @root prefixen met een vaste root oid.
|-
| 3|| TA/afspraakdatum niet beschikbaar|| De verstrekkingsdatum(tijd) overnemen als afspraakdatum(tijd)
|-
| 4|| Gebruiksperiode soms moeilijk afleidbaar|| In MP 6.12 is de juiste gebruiksperiode soms moeilijk afleidbaar. Gebruiksperiode wordt als volgt geconverteerd:
*Als er één 6.12 MedicationAdministrationRequest (MAR) is:
**Gebruiksperiode informatie (startdatum en/of duur en/of einddatum) 1:1 overnemen van MP 6.12.
**Bij eenmalig gebruik, de datum(/tijd) van het eenmalig gebruik overnemen als startdatum gebruik.
*Als er meer dan één MP 6.12 MAR is, dan moeten deze allemaal een startdatum hebben om een mapping te kunnen doen (met minimaal één 'zwevende' periode bij meerdere MARs kan geen gebruiksduur berekend worden):
**startdatum: als alle MARs een startdatum hebben: vroegste startdatum overnemen als startdatum gebruik
**duur: niet van toepassing, bij meerdere MARs de einddatum berekenen
**einddatum:
***als alle MARs een einddatum hebben: chronologisch laatste einddatum overnemen als einddatum gebruik
***als alle MARs een startdatum én duur hebben: de einddatums berekenen door de bij de startdatum horende duur op te tellen bij die startdatum, en dan de chronologisch laatste einddatum overnemen als einddatum gebruik.
***niet ondersteund in de mapping: een combinatie van einddatum en duur in de verschillende MAR's. In theorie kan dan ook een einddatum worden uitgerekend. Echter in de praktijk komt zo'n combinatie niet voor in MP 6.12 berichten. Dat is ook niet logisch, een leverancier kiest eigenlijk altijd één van de twee methoden (ofwel startdaum en duur ofwel start- en einddatum).
***als minimaal één MAR geen duur of einddatum heeft, dan is de medicatie 'tot nader order'. Dan geen duur of einddatum opnemen.
**bij meer dan één MAR met 'eenmalig gebruik' geen gebruiksperiode opnemen.
|-
| 5|| TA/geannuleerd indicator niet ondersteund|| Niet gebruiken.
|-
| 6|| TA/stoptype niet ondersteund|| Niet gebruiken.
|-
| 7|| TA/verstrekker//organisatie_naam niet verplicht|| Deze organisatie_naam is 1..1 Required in MP-9, maar heeft niet altijd een waarde in 6.12. Indien mogelijk uit wrapper halen, anders nullFlavor NI.
|-
|8||TA/reden afspraak niet ondersteund || Niet gebruiken.
|-
|9||TA/Gebruiksinstructie/toedieningsweg || Deze is 1..1 Required in MP9, maar heeft niet altijd een waarde in MP 6.12. Als niet aanwezig nullFlavor NI.
|-
|10||TA//Doseerinstructie || Alleen de meest voorkomende doseerinstructies/toedieningsschema's converteren. Bij andere doseerinstructies moet teruggevallen worden op de tekstuele omschrijving. De volgende MP 6.12 varianten kunnen geconverteerd worden:
* eenvoudige frequentie, in maximaal 1 MAR in 1 PIVL_TS (zonder phase)
* variabele frequentie (1 à 2 maal per dag)
** altijd 2 MAR's, 1 vast, 1 zo nodig
** deze twee MAR's lopen qua gebruiksperiode tegelijkertijd (parallel, met alle een gelijke startdatum of alle zonder startdatum)
* cyclisch schema ('pilschema') in maximaal 1 MAR
* toedientijden
** uitsluitend met maximaal 1 MAR,
** met één of meerdere tijdscomponenten met een vaste tijd,
** frequentie moet overal hetzelfde zijn en
** frequentie moet altijd in dagen (meestal: 1 maal per dag, maar mag ook 1 maal per 2 dagen)
* eenmalig gebruik, in 1 MAR met 1 eenmalige effectiveTime
|-
|11|| TA//Toedieningsschema/interval niet ondersteund || Niet gebruiken.
|-
|12|| TA//Toedieningsschema/weekdag niet ondersteund || Niet gebruiken.
|-
|13|| TA//Toedieningsschema/dagdeel niet ondersteund || Niet gebruiken.
|-
|14|| TA//Doseerinstructie/toedieningssnelheid niet ondersteund || Niet gebruiken.
|-
|15|| TA//Doseerinstructie/toedieningsduur niet ondersteund || Niet gebruiken.
|-
|16||TA/aanvullende informatie niet ondersteund || Niet gebruiken.
|-
|17||TA/toelichting niet ondersteund || Niet gebruiken.
|}

==Informatie in MP 6.12 die niet naadloos past op het MP9 datamodel==
{| class="wikitable sortable"
| style="background-color: #1F497D;; color: white; font-weight: bold; text-align:center;" | # || style="background-color: #1F497D;; width:400px; color: white; font-weight: bold; text-align:center;" | Informatie / Functionaliteit|| style="background-color: #1F497D;; color: white; font-weight: bold; text-align:center;" | Omschrijving
|-
|1||Magistralen - onderscheid tussen actieve ingrediënten en hulpstoffen niet meer mogelijk || MP9 heeft dit onderscheid losgelaten. Alle MP 6.12 ingrediënten daarom converteren naar een ingrediënt zonder nadere aanduiding.
|-
|2||Geen exact doseerschema bekend ("dagdosis") || MP 6.12 HL7 heeft hiervoor de [[7phcy:V6.12.8_HL7v3-domeinspecificatie_Pharmacy#medicationAdministrationRequest.doseCheckQuantity|doseCheckQuantity]], het MP9 datamodel kent geen equivalent, deze informatie niet converteren.
|-
|3||Voorschrijfinformatie anders dan prescription/id || MP 6.12 HL7 heeft hiervoor de [[7phcy:V6.12.8_HL7v3-domeinspecificatie_Pharmacy#medicationDispenseEvent.product.dispensedMedication.directTargetOf.prescription|prescription]]. Deze mag ook andere informatie bevatten dan alleen het id. MP9 toedieningsafspraak heeft hiervoor geen veld. Niet gebruiken.
|}

=Conversie specificaties (mappings)=
Specificaties voor de MP 6.12 Verstrekking en het MP9 datamodel vindt u via de [https://nictiz.nl/standaarden/informatiestandaarden/medicatieproces/ Nictiz website]

Sommige concepten in het datamodel zijn toegevoegd om de conversie te helpen. Het gaat om:
* patient / naamgegevens / ongestructureerde_naam

[[Categorie:Mappings|MP612]]

@@ Regel 221: / Regel 221: @@
 |[[Bestand: II.png| 16px]] ||-
 ||1..1
-||@nullFlavor NI
+||Kijk naar product/dispensedMedicationKind/(code | code/translation).
 | [[Bestand: II.png| 16px]]  || &#160;&#160;&#160;Identificatie || 42 || 1 .. 1

@@ Regel 25: / Regel 25: @@
 *Als er geen PRK maar wel een HPK is, dan op basis van deze HPK een generieke MBH id maken
 *Als er geen PRK en geen HPK is, dan op basis van het medicationDispenseEvent.id een MBH id maken in een herkenbare root oid
 |-
 | 2|| Toedieningsafspraak/TA id niet ondersteund || Gebruik het medicationDispenseEvent.id, maar prefix @root met een vaste root oid

@@ Regel 22: / Regel 22: @@
 |-
 | 1|| Medicamenteuze behandeling/MBH id niet ondersteund ||
-*Als er een PRK in het bericht staat, dan op basis van de PRK een generieke MBH id maken
+*Als er een PRK in de verstrekking staat, dan op basis van deze PRK een generieke MBH id maken
-*Als er geen PRK, maar wel een HPK, dan op basis van de HPK een generieke MBH id maken
+*Als er geen PRK maar wel een HPK is, dan op basis van deze HPK een generieke MBH id maken
-*Als er geen PRK of HPK is, dan op basis van het medicationDispenseEvent.id een MBH id maken in een herkenbare root oid
+*Als er geen PRK en geen HPK is, dan op basis van het medicationDispenseEvent.id een MBH id maken in een herkenbare root oid
 |-
-| 2|| Toedieningsafspraak/TA id niet ondersteund || Gebruik het medicationDispenseEvent.id, maar prefix @root met een vaste root oid.
+| 2|| Toedieningsafspraak/TA id niet ondersteund || Gebruik het medicationDispenseEvent.id, maar prefix @root met een vaste root oid
 |-
 | 3|| TA/afspraakdatum niet beschikbaar|| De verstrekkingsdatum(tijd) overnemen als afspraakdatum(tijd)

@@ Regel 87: / Regel 87: @@
 |2||Geen exact doseerschema bekend ("dagdosis") || MP 6.12 HL7 heeft hiervoor de [[7phcy:V6.12.10_HL7v3-domeinspecificatie_Pharmacy#medicationAdministrationRequest.doseCheckQuantity|doseCheckQuantity]], het MP9 datamodel kent geen equivalent, deze informatie niet converteren.
 |-
-|3||Voorschrijfinformatie anders dan prescription/id || MP 6.12 HL7 heeft hiervoor de [[7phcy:V6.12.10_HL7v3-domeinspecificatie_Pharmacy#medicationDispenseEvent.product.dispensedMedication.directTargetOf.prescription|prescription]]. Deze mag ook andere informatie bevatten dan alleen het id. MP9 toedieningsafspraak heeft hiervoor geen veld. Niet gebruiken.
+|3||Voorschrijfinformatie anders dan prescription/id || MP 6.12 HL7 heeft hiervoor de [[7phcy:V6.12.10_HL7v3-domeinspecificatie_Pharmacy#medicationDispenseEvent.product.dispensedMedication.directTargetOf.prescription|prescription]]. Deze mag ook andere informatie bevatten dan alleen het id. MP9 toedieningsafspraak heeft hiervoor geen veld, dus deze additionele informatie niet gebruiken.
 |-
 |4||Verantwoordelijk apotheker (zorgverlener) niet in MP9 || MP 6.12 kent uitwisseling van de [[7phcy:V6.12.10_HL7v3-domeinspecificatie_Pharmacy#medicationDispenseEvent.responsibleParty.assignedCareProvider|verantwoordelijke apotheker]]. MP9 kent hiervoor alleen de organisatie.

@@ Regel 138: / Regel 138: @@
 | [[Bestand: CD.png| 16px]]  || &#160;&#160;&#160;&#160;&#160;&#160;Naamgebruik || 6 || 0 .. 1
 |-style="vertical-align:top; background-color: #E3E3E3; "
-|||-
+|[[Bestand: Container.png| 20px]] ||subject/ Patient/ Person/ name
 ||-
 ||-
@@ Regel 154: / Regel 154: @@
 | [[Bestand: ST.png| 16px]]  || &#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;Achternaam || 9 || 1 .. 1
 |-style="vertical-align:top; background-color: #E3E3E3; "
-|||-
+|[[Bestand: Container.png| 20px]] ||subject/ Patient/ Person/ name
 ||-
 ||-
@@ Regel 213: / Regel 213: @@
 || [[Bestand: Container.png| 20px]] || MedicamenteuzeBehandeling|| 41 || 0 .. *
 |-
-|[[Bestand: II.png| 16px]] ||medicationDispenseEvent/ id + een concatenated string
+|[[Bestand: II.png| 16px]] ||-
 ||1..1
-||./ @root overnemen, bij extension: concat('MBHConverted_', ./ @extension)
+||@nullFlavor NI
 | [[Bestand: II.png| 16px]]  || &#160;&#160;&#160;Identificatie || 42 || 1 .. 1
@@ Regel 226: / Regel 226: @@
 |[[Bestand: II.png| 16px]] ||medicationDispenseEvent/ id, maar de @root prefixen met een vaste root oid
 ||1..1
-||Voor de @root: concat('vaste-root-oid', @root), @extension overnemen
+||Voor de @root: concat('1.3.6.1.4.1.58606.1.', @root-oid', @root), @extension overnemen
 | [[Bestand: II.png| 16px]]  || &#160;&#160;&#160;&#160;&#160;&#160;Identificatie || 344 || 1 .. 1
@@ Regel 384: / Regel 384: @@
 ||0..1
 ||Er is een vaste dosering. In oudere versies van de standaard kon dit op twee manieren meegegeven worden. Hoewel de tweede manier wordt ontmoedigd, is het verstandig om als ontvangende partij met beide varianten rekening te houden:
-<syntaxhighlight lang="xml"><doseQuantity>
+<syntaxhighlight lang="xml">
   <center value="1" unit="1">
-   <translation value="1" code="245" codeSystem="2.16.840.1.113883.2.4.4.1.900.2" displayName="stuk"/>
+ <translation value="1" code="245" codeSystem="2.16.840.1.113883.2.4.4.1.900.2" displayName="stuk"/>
   </center>
-</doseQuantity>
+ </doseQuantity>
+ <doseQuantity value="1" unit="1">
-<doseQuantity value="1" unit="1">
+  <translation value="1" code="245" codeSystem="2.16.840.1.113883.2.4.4.1.900.2" displayName="stuk"/>
-  <translation value="1" code="245" codeSystem="2.16.840.1.113883.2.4.4.1.900.2" displayName="stuk"/>
+ </doseQuantity>
 </syntaxhighlight>
@@ Regel 420: / Regel 420: @@
 ** de tijdseenheid wordt 1 van de in MP 6.12 opgenomen eenheid (bijv. dag of uur)
 ** voorbeeld: MP 6.12 herhaalperiode van 0.3333 dag, vertaalt zich naar 3 x per (1) dag
 ** voorbeeld: MP 6.12 frequentie van 0.8 dag, vertaalt zich NIET naar een gestructureerde MP9 frequentie (1.25 heeft een decimaal die groter is dan 0)
 * Als de MP 6.12 periode groter of gelijk aan 1 is:
 ** dan wordt het aantal herhalingen per tijdseenheid 1

@@ Regel 8: / Regel 8: @@
 {{TOClimit|4}}
 = Inleiding =
-Deze pagina beschrijft hoe een versie 6.12 'verstrekkingenlijst' response te converteren naar Medicatieproces (MP9) versie 2.x voor de transactie: 'beschikbaarstellen medicatiegegevens'.
+Deze pagina beschrijft hoe een versie 6.12 'verstrekkingenlijst' response te converteren naar Medicatieproces (MP9) versie 3.x voor de transactie: 'beschikbaarstellen medicatiegegevens' of 'sturen medicatiegegevens'.
-Een versie 6.12 verstrekkingenlijst converteert zich in het MP9 datamodel naar de Toedieningsafspraak (en patiënt).
+Een versie 6.12 verstrekkingenlijst converteert zich in het MP9 datamodel naar de Toedieningsafspraak (en patiënt/zorgaanbieder/farmaceutisch product).
 Aangezien deze conversie plaatsvindt tussen verschillende versies van de MP standaard zijn er een aantal zaken waarmee rekening gehouden moet worden:
@@ Regel 21: / Regel 21: @@
 | style="background-color: #1F497D;; color: white; font-weight: bold; text-align:center;"  | # || style="background-color: #1F497D;; width:400px; color: white; font-weight: bold; text-align:center;" | Informatie / Functionaliteit  || style="background-color: #1F497D;; color: white; font-weight: bold; text-align:center;" | Omschrijving
 |-
-| 1|| Medicamenteuze behandeling/MBH id niet ondersteund || MBH id vullen met nullFlavor NI.
+| 1|| Medicamenteuze behandeling/MBH id niet ondersteund ||
 |-
-| 2|| Toedieningsafspraak/TA id niet ondersteund || De @root prefixen met een vaste root oid.
+| 2|| Toedieningsafspraak/TA id niet ondersteund || Gebruik het medicationDispenseEvent.id, maar prefix @root met een vaste root oid.
 |-
 | 3|| TA/afspraakdatum niet beschikbaar|| De verstrekkingsdatum(tijd) overnemen als afspraakdatum(tijd)

@@ Regel 85: / Regel 85: @@
 |1||Magistralen - onderscheid tussen actieve ingrediënten en hulpstoffen niet meer mogelijk || MP9 heeft dit onderscheid losgelaten. Alle MP 6.12 ingrediënten daarom converteren naar een ingrediënt zonder nadere aanduiding.
 |-
-|2||Geen exact doseerschema bekend ("dagdosis") || MP 6.12 HL7 heeft hiervoor de [[7phcy:V6.12.8_HL7v3-domeinspecificatie_Pharmacy#medicationAdministrationRequest.doseCheckQuantity|doseCheckQuantity]], het MP9 datamodel kent geen equivalent, deze informatie niet converteren.
+|2||Geen exact doseerschema bekend ("dagdosis") || MP 6.12 HL7 heeft hiervoor de [[7phcy:V6.12.10_HL7v3-domeinspecificatie_Pharmacy#medicationAdministrationRequest.doseCheckQuantity|doseCheckQuantity]], het MP9 datamodel kent geen equivalent, deze informatie niet converteren.
 |-
-|3||Voorschrijfinformatie anders dan prescription/id || MP 6.12 HL7 heeft hiervoor de [[7phcy:V6.12.8_HL7v3-domeinspecificatie_Pharmacy#medicationDispenseEvent.product.dispensedMedication.directTargetOf.prescription|prescription]]. Deze mag ook andere informatie bevatten dan alleen het id. MP9 toedieningsafspraak heeft hiervoor geen veld. Niet gebruiken.
+|3||Voorschrijfinformatie anders dan prescription/id || MP 6.12 HL7 heeft hiervoor de [[7phcy:V6.12.10_HL7v3-domeinspecificatie_Pharmacy#medicationDispenseEvent.product.dispensedMedication.directTargetOf.prescription|prescription]]. Deze mag ook andere informatie bevatten dan alleen het id. MP9 toedieningsafspraak heeft hiervoor geen veld. Niet gebruiken.
 |}

← Oudere versie		Versie van 16 nov 2022 om 15:28
Regel 1:		Regel 1:
	{{DISPLAYTITLE: Transactie Verstrekkingenvertaling (conversie MP 6.12 verstrekkingenlijst naar MP-9 TA)}}		{{DISPLAYTITLE: Transactie Verstrekkingenvertaling (conversie MP 6.12 verstrekkingenlijst naar MP-9 TA)}}
		+	{{IssueBox\|Dit is een werkpagina voor intern Nictiz gebruik.}}
		+
	__NUMBEREDHEADINGS__		__NUMBEREDHEADINGS__

Mappings/mp:Vdraft MP612Dispense 2 MP9TA - Bewerkingsoverzicht

Wetering: /* Conversie specificaties (mappings) */

Wetering: /* Missende MP9 functionaliteit bij converteren vanaf MP 6.12 */

Wetering: /* Missende MP9 functionaliteit bij converteren vanaf MP 6.12 */

Wetering: /* Inleiding */

Wetering: /* Informatie in MP 6.12 die niet naadloos past op het MP9 datamodel */

Wetering: /* Informatie in MP 6.12 die niet naadloos past op het MP9 datamodel */

Wetering: Added fixed root OID as per MP-572

Wetering op 16 nov 2022 om 15:28

Wetering: /* Conversie specificaties (mappings) */

Wetering: Nieuwe pagina aangemaakt met '{{DISPLAYTITLE: Transactie Verstrekkingenvertaling (conversie MP 6.12 verstrekkingenlijst naar MP-9 TA)}} __NUMBEREDHEADINGS__ Bestand:Nictiz_logo_PO_rechts_rgb....'

Wetering: Nieuwe pagina aangemaakt met '{{DISPLAYTITLE: Transactie Verstrekkingenvertaling (conversie MP 6.12 verstrekkingenlijst naar MP-9 TA)}} NUMBEREDHEADINGS Bestand:Nictiz_logo_PO_rechts_rgb....'