DECOR-informatie voor project: Medicatieproces (mp-)

• dr Kai U. Heitmann
• Gerrit Boers
• Tom de Jong
• Maarten Ligtvoet
• Elze de Groot
• Claartje Hülsmann
• Alexander Henket
• Arianne van de Wetering
• Michael Tan
• Marc de Graauw
• Gerda Meijboom
• Tessa van Stijn
• Projectgroep
• Expertpanel
• Nasra Khan

• Issue 238 : MP 9 bouwsteen Medicatiegebruik en voorstel Medicatieafspraak en voorstel Verstrekkingsverzoek. De patiënt als auteur was in het template niet in lijn met internationale aanbeveling. Dit is hersteld. Dit heeft effect op instances en is niet backwards compatible.
• Issue 245 : MP 9 templateId voor identificatie medicamenteuze behandeling. De kardinaliteit in de templates is aangepast naar wat in de transacties gedefinieerd staat.
• Issue 246 : Bouwsteen medicatieafspraak, alleen dataset. Omschrijving gewijzigd voor het concept "Reden afspraak" van: "Reden voor deze afspraak.", naar: "Reden voor het maken van deze medicatieafspraak. Dit kan de reden zijn om de medicatie te starten, te wijzigen of te stoppen."
• Issue 247 : Bouwstenen Toedieningsafspraak en Verstrekking. Het inmiddels overbodig geworden commentaar verwijderd bij de dataset concepten Toedieningsafspraak/Toelichting en Verstrekking/Toelichting
• Issue 248 : Bouwsteen medicatieafspraak, alleen dataset. Omschrijving gewijzigd voor het concept "Aanvullende informatie". Omschrijving gewijzigd naar: "Aanvullende informatie bevat een lijst van bijzonderheden over de gemaakte afspraak die van belang zijn voor de medicatiebewaking en invulling door de apotheker. Hiermee kan bijvoorbeeld worden aangegeven dat er bewust is afgeweken van wat gebruikelijk is of dat de afspraak op een bepaalde manier moet worden ingevuld."
• Issue 249 : Bouwsteen medicatieafspraak, alleen dataset. Omschrijving gewijzigd voor het concept "Toelichting" van: "Toelichting bij medicatieafspraak. Deze toelichting kan bijvoorbeeld uitleg bevatten waarom een voorschrijver een medicatieafspraak maakt die afwijkt van wat gebruikelijk is.", naar: "Opmerkingen met betrekking tot de medicatieafspraak. Bijvoorbeeld: in overleg met de specialist."
• Issue 254 : Bouwsteen medicatiegebruik. In de scenarios/transacties met Medicatiegebruik was onbedoeld het dataset concept 'Eenheidsterm' opgenomen. Dit is hersteld.
• Issue 255 : Diverse voorbeeldfragmenten verbeterd in templates.
• Issue 256 : Bouwsteen verstrekkingsverzoek. Het template MP CDA Verstrekkingsverzoek (9087) had als enige bouwsteen template geen 'code' element. Dit is verplicht (!) toegevoegd analoog aan de andere bouwstenen (MA, TA, VS, Gebruik).
• Issue 257 : Transacties voor medicatieoverzicht. Er stonden een aantal overbodige dataset concepten in de transacties. Deze waren al niet opgenomen in de templates, zijn nu ook verwijderd uit transacties (PUSH en PULL). Het gaat om: adres/additioneleInformatie, afdelingspecialisme en organisatietype.
• Issue 259 : Bouwsteen verstrekking. Het template MP CDA Verstrekking (9094) definieerde bij verbruiksduur (expectedUseTime) onterecht een low en een high. Dit is hersteld.
• Issue 260 : Bouwsteen medicatiegebruik, alleen dataset (geen effect op bericht templates). Medicatiegebruik/gerelateerde verstrekking/identificatie erfde van verkeerde concept, dit is hersteld
• Issue 261 : Bouwsteen medicatiegebruik. Kleine correctie in template 9154 - Gebruik entryRelationships voor redenen miste verplichte attribuut typeCode, deze moet waarde 'RSON' hebben. Dit is nu expliciet gemaakt in het template.
• Issue 263 : Alle bouwstenen. Template 9111 was te streng voor zorgverlener identificaties, een andere id dan uzi/agb/big mag ook worden meegegeven. Dit is hersteld.
• Issue 266 : Bouwsteen medicatiegebruik. Template Medicatiegebruik (9154) gebruikte een verkeerd template (9013) voor informant zorgverlener, dit is hersteld naar 9167.
• Issue 267 : Template MP CDA author medicatieoverzicht (9171) miste toelichting bij time, dit is hersteld.
• Issue 269 : Bouwsteen medicatiegebruik. Het template voor de voorschrijver bij medicatiegebruik was te streng. Dit is hersteld.
• Issue 270 : Bouwsteen medicatiegebruik. Voorschrijver in medicatiegebruik had te veel velden in transacties, dit is hersteld. Deze bevat nu dezelfde velden als de voorschrijver uit MA, wel allemaal met een kardinaliteit van 0..x. Betreft alle transacties waar medicatiegebruik in zit (102, 134, 138, 148, 150)
• Issue 271 : MP9 templates. Bij templates 9113, 9066 en 9167 is het opnemen van het template id nu optioneel ipv verplicht.
• Issue 272 : MP9 templates van voorstel transacties (ma en vv). Het was niet mogelijk om voorstelgegevens/toelichting in het bericht te plaatsen. Dit is hersteld.
• Issue 273 : Transactie voorstel verstrekkingsverzoek (geen effect op bericht templates). De kardinaliteit/conformance van het geneesmiddel in het verstrekkingsverzoek in de transactie voorstel verstrekkingsverzoek week onterecht af van die van de medicatieafspraak. De kardinaliteit/conformance van voorschrijver/zorgverlener/naamgegevens in de medicatieafspraak ook in de transactie voorstel verstrekkingsverzoek week onterecht af van die in medicatieafspraak in andere transacties. Dit is recht getrokken.
• Issue 274 : Transactie medicatieoverzicht (geen effect op bericht templates). Binnen de groep Patient/Contactgegevens/Emailadressen onterecht het emailadres optioneel. De groep is namelijk al optioneel. Dit is hersteld.
• Issue 275 : MaxDoseQuantity template (9064) had een verkeerde waardelijst gekoppeld voor tijdseenheid, minuten en uren werden niet toegestaan. Dit is hersteld.
• Issue 276 : Bouwsteen Medicatieafspraak. Bij aanvullende informatie (template 9177) was onterecht een datatype 'CD' gebruikt. Dit is hersteld naar 'CE'. Let op! Dit heeft effect op instances en is niet backwards compatible.
• Issue 277 : Templates voor voorstel verstrekkingsverzoek. Bij de medicatieafspraak in een voorstel verstrekkingsverzoek was het niet toegestaan om alleen een omschrijving van een ongecodeerd geneesmiddel mee te geven. Dit is hersteld.
• Issue 282 : XML schema's voor organizer/component. De xsd's zijn bijgewerkt om compatibiliteitsredenen met Ketenzorg. Dit heeft géén effect op xml instances / templates.
• Issue 283 : XML schema's voor DTr2 IVL_TS. De xsd's voor DTr2 IVL_TS waren onterecht als extensie van QSET_TS gedefinieerd. Dit moet een extensie zijn van SXCM_TS en is hersteld. Dit heeft géén effect op xml instances / templates.
• Issue 285 : MP 9 bouwsteen Medicatiegebruik. De patiënt als informant was in het template niet in lijn met hoe het na issue 238 gedaan is voor auteur. Dit is hersteld. Dit heeft effect op instances en is niet backwards compatible.
• Issue 286 : MP 9 Voorstel Verstrekkingsverzoek. Het bericht template (9131) voor voorstel verstrekkingsverzoek miste de relatie naar de medicatieafspraak. Dit is hersteld.
• Issue 287 : MP 9 transacties voorstel medicatieafspraak / voorstel verstrekkingsverzoek: de kardinaliteiten/conformance van voorstelgegevens onderling gelijk gemaakt. Geen effect op de bericht templates.

• Issue 265 : Transactie voorschrift. Template Medication Dispense Request (103): schematron gaf een onterechte fout bij het opnemen van twee vertalingen bij te verstrekken hoeveelheid. Dit is hersteld.

• Issue 244 : Bij verstrekkingsverzoek was de kardinaliteit voor identificatie (id) in het template onterecht 1..*. Dit is hersteld naar 1..1.

• Issue 242 : Bij medicatieverstrekkingenlijstquery ontbrak in de transmission wrapper een controle op acceptAckCode = 'NE'. Dit is hersteld.

• Issue 243 : Binnen een dosering met een doseerhoeveelheid was het niet mogelijk om meer dan één toedientijd/weekdag/dagdeel te specificeren. Dit is hersteld.

• Issue 240 : Een template voor doseerinstructies - toedieningsduur (9161) had een fout voorbeeld xml fragment. Dit is hersteld.
• Issue 241 : Bij een template voor doseerinstructies (9121) ontbrak iets in het voorbeeld xml fragment. Dit is hersteld.

• Template id="2.16.840.1.113883.2.4.3.11.60.20.77.10.9050" name="MedicatieoverzichtPatient" displayName="Medicatieoverzicht patiënt"
• Template id="2.16.840.1.113883.2.4.3.11.60.20.77.10.9135" name="MPCDAPart2Reuse" displayName="MP CDA Part2Reuse"
• Template id="2.16.840.1.113883.2.4.3.11.60.20.77.10.9170" name="MPCDAPart2ReuseMO" displayName="MP CDA Part2Reuse Medicatieoverzicht"
• Template id="2.16.840.1.113883.2.4.3.11.60.20.77.10.9104" name="MPHL7MedicatiegegevensOrganizer" displayName="MP HL7 Medicatiegegevens Organizer"
• Template id="2.16.840.1.113883.2.4.3.11.60.20.77.10.9124" name="MPHL7AfhVoorschriftOrganizer" displayName="MP HL7 Afhandeling Voorschrift Organizer"
• Template id="2.16.840.1.113883.2.4.3.11.60.20.77.10.9125" name="MPHL7SturenGebruikPayload" displayName="MP HL7 Sturen gebruik Organizer"
• Template id="2.16.840.1.113883.2.4.3.11.60.20.77.10.9126" name="MPHL7VoorschriftOrganizer" displayName="MP HL7 Voorschrift Organizer"
• Template id="2.16.840.1.113883.2.4.3.11.60.20.77.10.9127" name="MPHL7VoorstelMAOrganizer" displayName="MP HL7 Voorstel medicatieafspraak Organizer"
• Template id="2.16.840.1.113883.2.4.3.11.60.20.77.10.9130" name="MPHL7VoorstelVVOrganizer" displayName="MP HL7 Voorstel Verstrekkingsverzoek Organizer"
• Template id="2.16.840.1.113883.2.4.3.11.60.20.77.10.9132" name="MPHL7MedicatieoverzichtOrganizer" displayName="MP HL7 Medicatieoverzicht Organizer"

• De template "2.16.840.1.113883.2.4.3.11.60.20.77.10.9119" MPCDArecordTarget2 had een verplichte recordTarget/templateId welke in de geharmoniseerde template is komen te vervallen. Dit heeft impact op implementaties!
• De template "2.16.840.1.113883.2.4.3.11.60.20.77.10.9051" MPCDArecordTarget stond patient/id en patient/birthplace optioneel toe. Deze zijn beide in komen te vervallen in de geharmoniseerde template. De eerste was in CDA al deprecated en zou sowieso niet gebruikt moeten worden; ook de transactie en het template maakten geen use case duidelijk. De tweede, geboorteplaats, bestaat geen Zorginformatiebouwsteen voor en de transactie en het template maakten geen use case duidelijk voor gebruik op een Medicatieoverzicht.
• Verder zijn enkele kleine verschillen in expressiviteit op het gebied van de templatekoppelingen met datasetconcepten. Adres is wel gekoppeld aan hl7:addr, Naam is gekoppeld aan hl7:name, Telefoon/e-mail wel aan hl7:telecom, maar verdere subcomponenten (adresdelen, naamdelen, gebruikstype, telefoonnummer/e-mailadres) zijn niet gekoppeld. De betreffende datatypetemplates laten in duidelijkheid niets aan het toeval over en koppelen zou, door de wijze waarop dit werkt, onnodig dupliceren van template inhouden.

• Issue 237 : Bij (meest gebruikte) UCUM-eenheden ontbrak een toelichting. Dit is toegevoegd met een link naar een wiki pagina.

• Issue 202 : Bij magistraal moet het mogelijk zijn om 'aanvullen tot' mee te geven bij ingrediënten. Dit kan met nullFlavor 'QS' in HL7. Dit is doorgevoerd in de bericht templates.
• Issue 213 : Bij nieuwe vooraankondigingen voorschrift is de verplichting op UZI-identificatie voor de voorschrijver losgelaten. Identificatie mag nu met UZI en/of AGB.

• Issue 24: Template voor voorschrift. Wanneer er meer dan één therapeuticAgentOf voor een voorschrift is, moet de eenheid van de periode altijd 'd' (dag) zijn. Dit wordt nu ook gecontroleerd door de schematrons.
• Issue 211 : Het schematron was te streng voor ingrediënten voor magistralen (verplichting op activeIngredient). Het onderscheid tussen actieve en hulpstoffen is niet nodig. Dit is hersteld (verplichting op activeIngredient óf otherIngredient).
  
• Issue 218: Bij naam persoon was er een onterecht verplicht fixed attribuut given/@qualifier='BR', initialen mogen ook meegegeven worden met qualifier 'IN'. Dit is hersteld.

• Issue 183 : Er ontbrak een valueset bij Verstrekking/Distributievorm. Deze is toegevoegd.
  
• Issue 190 : Verstrekkingsverzoek heeft nu een relatie naar 0..* Medicatieafspraken. Medicatieafspraak heeft een relatie naar 0..1 medicatieafspraak, toedieningsafspraak of medicatiegebruik.
  
• Issue 194 : In de toekomst wordt voorschrijven op generieker niveau mogelijk. Daarom alvast SNK en SSK toegevoegd als mogelijke medicatie coderingen.
  
• Issue 204 : Extra codelijst-element bij toedieningsafspraak - aanvullende informatie.
• Issue 208 : Bij Reden afspraak is de waarde 'wijziging' is overbodig.'Wijziging' verwijderd uit waardelijst.
  
• Issue 209 : Einddatum gebruik: tijd moet verplicht meegegeven worden

• Issue 112 : Bij reden wijzigen/stoppen voor medicatiegebruik stond nog een SNOMED terminologiekoppeling die niet klopte. Dit is hersteld. In de bericht template werd wél al de juiste code gebruikt.
• Issue 189 : Voorschrijver toegevoegd aan Medicatiegebruik. De hieruit volgende wijzigingen in scenario/bericht template zijn behandeld in issue 224.
  
• Issue 192 : De omschrijving van ingangsdatum en einddatum (van de gebruiksperiode) is aangescherpt na consultatie van leveranciers.
• Issue 195 : De omschrijving van Medicatiegebruik is verduidelijkt.
  
• Issue 200 : De naam van het dataset concept 'Herhaalperiode' zorgde voor verwarring en is aangepast naar 'Herhaalperiode cyclisch schema'.
• Issue 203 : Bij gebruiksinstructie keerdosis en toedieningssnelheid stond de hoeveelheid medicatie als integer, maar hier moeten ook decimalen kunnen worden doorgegeven. Dit is hersteld in de dataset. In de bericht templates stond dit al goed en deze zijn daarom niet gewijzigd.
• Issue 205 : Het datatype van Medicatieafspraak/Toelichting is gewijzigd van text naar string (van tekst mét opmaak naar tekst zonder opmaak).
  
• Issue 206 : Het datatype van Verstrekkingsverzoek/Toelichting is gewijzigd van text naar string (van tekst mét opmaak naar tekst zonder opmaak).
  
• Issue 207 : Bij medicatietoediening ontbrak een omschrijving. Deze is toegevoegd.
  
• Issue 215 : Patiënt en mantelzorger kunnen ook toediener zijn voor het concept medicatietoediening. Dit was nog niet mogelijk in de dataset. Dat is aangepast analoog aan medicatiegebruik.
• Issue 217 : Er kan per dosering maar 1 weekdag meegegeven worden, de naam 'weekdagen' was verwarrend. Naam van het element 'weekdagen' is daarom aangepast naar 'weekdag'.
• Issue 222 : Gebruiksinstructie is opgenomen als separaat concept om herbruikbaarheid te verbeteren.
• Issue 230 : Bij verstrekking/verstrekker was onterecht ook een zorgverlener opgenomen (naast zorgaanbieder). Dit is hersteld zodat alleen zorgaanbieder overblijft.
• Issue 235: De gebruiksperiode in medicatieafspraak / toedieningsafspraak en medicatiegebruik was weergegeven in drie concepten (ingangsdatum / duur / einddatum), dit is equivalent met 1 concept met datatype "tijdsduur". Dit is aangepast naar het concept "Gebruiksperiode".

• Issue 191 : Bij een voorschrift is het nu mogelijk meerdere medicamenteuze behandelingen en ook meerdere verstrekkingsverzoeken horende bij 1 MA op te nemen.
• Issue 199 : Medicatieoverzicht scenario's hebben nu medicatieafspraak, toedieningsafspraak, gebruik en documentgegevens.
  
• Issue 224 : Voor transactie met medicatiegebruik is de voorschrijver toegevoegd nav issue 189. Alle elementen in medicatiegebruik/voorschrijver 0..1, behalve de identificatie zorgverlener/zorgaanbieder, die zijn 0..*. Bijbehorende templates ook aangepast.
  
• Issue 225 : Functionele wens is onderscheid tussen MA/TA/Gebruik op medicatieoverzicht. De bouwstenen MA en TA zijn daarom toegevoegd aan deze transactie met issue 199. Dit is ook doorgevoerd in de bericht templates.
  
• Issue 227 : Voor het medicatieoverzicht ontbrak de auteur (zorgaanbieder) in de payload. Deze is toegevoegd.
  
• Issue 233 : Bij medicatieoverzicht ontbrak patiënt telefoonnummer en adres. Dit is hersteld.
  

• Issue 136 : Bij medicatiegebruik is de informant / auteur een keuze van één van de onderliggende concepten. Dit was bij de scenario's / transacties nog niet gespecificeerd. Dat is toegevoegd. In de bericht templates geen wijziging.
• Issue 232 : De kardinaliteit bij toedieningsafspraak/verstrekker/zorgaanbiederidentificatie was onterecht 1..1 in alle transacties, dit is hersteld naar 1..*.Wijziging met effect op MP 9 (alleen bericht templates):
  
• Issue 210 : Een template associatie (link tussen dataset concept en template) bij toedieningsafspraak wees onterecht naar medicatieafspraak/identificatie. Dit is hersteld.
  
• Issue 228 : Er stond een verouderde codering in het template voor Toedieningsafspraak. Dit is hersteld naar de juiste SNOMED code zoals bij de dataset is opgenomen.
• Issue 229 : Het voorbeeld fragment van het template voor Medicatieafspraak bevatte een foutieve OID (9168 moet zijn 9148). Dit is hersteld.
• Issue 231 : Bij ingrediënten (voor magistrale medicatie) miste vertaling naar G-standaard eenheden in de templates. Dit is hersteld.
• Issue 234 : Documentdatum was niet opgenomen in de HL7-messaging ("organizer") versie van medicatieoverzicht. Dit is hersteld.

• Issue 236 : Het schema voor organizer is zoveel mogelijk recht getrokken met CDA Clinical Statement. Voor MP 9 XML instances betekent dit dat het (eerder verplichte) attribuut contextControlCode op xml element component niet meer opgenomen mag worden.

• Issue 216 . Waardelijst voor zo nodig - criterium toegevoegd op basis van de lijst aanvullende teksten met tekstcategorie 'conditie' (G-standaard / NHG). Zie het issue voor alle details.

• Issue 196. Omschrijving gebruiksinstructie aangepast van 'Gebruiksinstructie' naar: 'Aanwijzingen voor het gebruik of toediening van de medicatie, bijvoorbeeld dosering en toedieningsweg. Bij medicatiegebruik is dit het gebruikspatroon dat de patiënt heeft gevolgd of met zichzelf heeft afgesproken.' Zie het issue voor alle details. 
• Issue 204. Bij toedieningsafspraak - aanvullende informatie: de waardelijst ingevuld en van coderingen voorzien.Zie het issue voor alle details.
• Issue 219. Waardelijst aanvullende informatie medicatieafspraak aangepast conform uitkomsten expert panel op 4 april 2017. Zie https://www.z-index.nl/documentatie/publicaties/proof-of-concept-medicatieproces Zie het issue voor alle details.
• Issue 220. Waardelijst aanvullende wensen verstrekkingsverzoek aangepast conform uitkomsten expert panel op 4 april 2017. Zie https://www.z-index.nl/documentatie/publicaties/proof-of-concept-medicatieproces. Zie het issue voor alle details. 
• Issue 221. Waardelijst aanvullende informatie verstrekking aangepast conform uitkomsten expert panel op 4 april 2017. Zie https://www.z-index.nl/documentatie/publicaties/proof-of-concept-medicatieproces. Zie het issue voor alle details. 

• Issue 188 "Schematron warning toevoegen wanneer unit buiten meest gebruikte UCUM eenheden valt" met status "Gesloten". Zie het issue voor alle details. Laatste gebeurtenis (2017-01-18T12:54:09):
  Er is een waarschuwing toegevoegd wanneer een gevonden UCUM eenheid niet eentje is van de meest gebruikte zoals opgesomd in: 
  http://informatiestandaarden.nictiz.nl/wiki/7phcy:V6.12.3_HL7v3-domeinspecificatie_Pharmacy#medicationAdministrationRequest.doseQuantity 
  en: http://informatiestandaarden.nictiz.nl/wiki/7phcy:V6.12.3_HL7v3-domeinspecificatie_Pharmacy#medicationDispenseEvent.quantity
  
  Wijziging in validatiewaarschuwing zowel voor MP 6.12 als voor MP 9.

• Issue 164 "Welke codes horen bij ingrediënt code?" met status "Gesloten". De toegestane product en ingrediënt codes zijn gelijk getrokken met MP6.12.
• Issue 170 "Rol zorgverlener dubbelop (gebruik/informant)", de redundante rol is verwijderd

• Issue 174: Medicatiegebruik\Stoptype toegevoegd 0..1 R
• Issue 185: Medicatiegebruik\Reden gebruik overal 0..1 R.
• Issue 186: Toelichting in alle bouwstenen 0..1 R.
• Medicatieoverzicht scenario's uitgewerkt voor push en pull interactie.

• issue 142, de mapping van het dataset element 'dagdeel' naar de template(s) ontbrak. Dit is hersteld.
• issue 144, de dataset omschrijving bij eenheid specificeerde niet tabel 902 uit de G-standaard. Tevens valueset toegevoegd met codesysteem voor G-standaard.
• issue 148, de kardinaliteit voor de groep dosering was niet in alle transacties 0..*, dit is hersteld. Dit gaat om de transacties op functioneel niveau, aan de technische (HL7/CDA) templates is niets gewijzigd.
• issue 149, de kardinaliteit voor dagdeel / weekdagen was niet consequent in alle transacties, dit is hersteld.

• issue 141 (BITS MP-36): het template toonde 0..* voor Condition terwijl maximaal 1 keer het element Condition is toegestaan. Dit is hersteld.

• 139: kardinaliteit in template (1..*) klopte niet met scenario's (0..1) voor indicatie in medicamenteuze behandeling. Dit is hersteld.

• Alle referenties naar waardelijsten en templates op naam zijn vervangen door referenties op id. Namen zijn ambigu wanneer een project in contact staat andere projecten.
• In template DoseQuantity ("2.16.840.1.113883.2.4.3.11.60.20.77.10.9048" / "2015-07-24T15:11:09") is de koppeling op de drie elementen hl7:doseQuantity verbeterd (elementen hadden geen uniek id)
• In template doseCheckQuantity ("2.16.840.1.113883.2.4.3.11.60.20.77.10.9049" / "2015-07-28T13:30:31") is de context ** indicatie verwijderd, omdat dat niet kan in een template op datatype-niveau en bovendien het vereiste hl7:template element daarvoor niet was gespecificeerd.

• Dataset 8.0 is aangepast en bevat nu ook de reden van niet gebruik medicatie met template associatie
• Scenario 2.16.840.1.113883.2.4.3.11.60.20.77.4.80 Meld medicatiegebruik en 2.16.840.1.113883.2.4.3.11.60.20.77.4.91 Opleveren medicatiegebruik eveneens aangepast.
• Dataset 8.0 is aangepast en bevat nu als query parameter ook de gebruiksperiode voor medicatiegebruik
• Scenario 2.16.840.1.113883.2.4.3.11.60.20.77.4.90 Opvragen medicatiegebruik eveneens aangepast