7kezo:V1.0 Interacties tussen LSP en bron: verschil tussen versies

Uit informatiestandaarden
Naar navigatie springen Naar zoeken springen
k (Tekst vervangen - "{{#customtitle:" door "{{DISPLAYTITLE:")
 
(2 tussenliggende versies door een andere gebruiker niet weergegeven)
Regel 1: Regel 1:
{{#customtitle: Interacties tussen LSP en bron | Interacties tussen LSP en bron}}
+
{{DISPLAYTITLE: Interacties tussen LSP en bron | Interacties tussen LSP en bron}}
 
<noinclude>{{DocumentPart|ns=7kezo|title=V1.0_HL7v3-uitwisseling_Ketenzorg}}</noinclude>
 
<noinclude>{{DocumentPart|ns=7kezo|title=V1.0_HL7v3-uitwisseling_Ketenzorg}}</noinclude>
 
==Interacties tussen LSP en bron==
 
==Interacties tussen LSP en bron==
Regel 14: Regel 14:
 
'''Vermoedelijk zal het zo zijn dat als de bouwsteen van versie verandert, de bijbehorende query dat ook zal doen, maar daarover moet nog nader overleg gevoerd worden en er kan ervaring mee worden opgedaan in de proof of concept fase van het project.'''}}
 
'''Vermoedelijk zal het zo zijn dat als de bouwsteen van versie verandert, de bijbehorende query dat ook zal doen, maar daarover moet nog nader overleg gevoerd worden en er kan ervaring mee worden opgedaan in de proof of concept fase van het project.'''}}
  
{{:7kezo:V1.0 POLB_IN354001NL03}}
+
{{:7kezo:V1.0 POLB_IN354001NL02}}
 
{{:7kezo:V1.0 POLB_IN364001NL02}}
 
{{:7kezo:V1.0 POLB_IN364001NL02}}
 
{{:7kezo:V1.0 POOB_IN990001NL}}
 
{{:7kezo:V1.0 POOB_IN990001NL}}
Regel 20: Regel 20:
 
{{:7kezo:V1.0 PRPA_IN900300NL}}
 
{{:7kezo:V1.0 PRPA_IN900300NL}}
 
{{:7kezo:V1.0 PRPA_IN900350NL}}
 
{{:7kezo:V1.0 PRPA_IN900350NL}}
{{:7kezo:V1.0 QURX_IN990101NL02}}
+
{{:7kezo:V1.0 QURX_IN990201NL01}}
{{:7kezo:V1.0 QURX_IN990103NL02}}
+
{{:7kezo:V1.0 QURX_IN990203NL01}}

Huidige versie van 20 jul 2020 om 01:37


Dit materiaal is onderdeel van HL7v3-domein Ketenzorg V1.0_HL7v3-uitwisseling_Ketenzorg.
  • Compatible wijzigingen/nadere bewoordingen, tikfouten kunnen direct in de Wiki gewijzigd worden
  • Open issues die discussie vergen s.v.p. in de commentaarsectie opnemen.

Interacties tussen LSP en bron

De hiernavolgende interacties zijn query/response paren voor het opvragen van specifieke bouwsteentypen, voor zover deze in scope zijn voor de ‘proof of concept’ fase van de zorgtoepassing Ketenzorg. De query interacties worden hier volledig beschreven, inclusief het template voor de query parameters en bijbehorende XML voorbeelden.

Van de query responses wordt alleen beschreven hoe deze ‘verpakt’ worden. De payload van de query responses bestaat immers uit bouwsteenimplementaties, zoals die worden beschreven in het document [HL7v3 IH Bouwstenen]. Afhankelijk van het bouwsteentype kan deze verpakking (wrappers plus een eventuele header) een andere vorm hebben.

Waarschuwing:Titelweergave "POLB_IN354001NL02 - opvragenLabUitslagen" overschrijft eerdere titelweergave "Interacties tussen LSP en bron".

POLB_IN354001NL02 - opvragenLabUitslagen

Deze interactie wordt door het LSP gebruikt om laboratoriumuitslagen op te vragen bij bron¬systemen. De daarbij gebruikte query is een update van de interactie die eerder is gespecificeerd om labuitslagen op te vragen t.b.v. medicatiebewaking door apotheken, vandaar de versieaanduiding 03 in het interactie ID. Beide varianten zijn een lokalisatie van de internationale standaard uit het Laboratory domein (vandaar de aanduiding NL).

Samenstelling interactie

Omschrijving ID
Trigger Event Opvragen Labuitslagen ZTKT_TE000004NL
Transmission Wrapper Send Message Payload MCCI_MT000100
Control Act Wrapper Query Control Act Request : Query By Parameter QUQI_MT021001
Message Type Opvragen Labuitslagen POLB_MT300000NL02

Zendende en ontvangende rollen

Omschrijving ID
Sender Zorg Informatie Makelaar (ZIM) AZIM_AR000000NL
Receiver Gegevensopleverend Ketenzorgsysteem ZTKZ_AR000004NL

Receiver Responsibilities

Reden Trigger Event HL7v3-interactie
De ontvanger van de query moet de meegegeven parameters verwerken en alle labuitslagen die daaraan voldoen retourneren, voor zover deze niet lokaal afgeschermd zijn. Het retourbericht is: - POLB_IN364000NL02

Template

Het template voor deze interactie is vrijwel gelijk aan dat van de interactie om labuitslagen op te vragen t.b.v. medicatiebewaking door apotheken, zoals dat is opgenomen in de AORTA v6.12 specificaties. Deze wijzigingen zijn aangebracht:

  • Het element <observationEffectiveTime> wordt iets anders gebruikt (zie aldaar).
  • Het element <observationType> is toegevoegd (dit is wél onderdeel van de internationale specificaties, maar was uitgesloten in het Nederlandse template).
  • Het element <responseTemplateId> heeft een andere (vaste) waarde, omdat het antwoordbericht in dit geval een iets ander template heeft (zie paragraaf 4.5.2.3XXXXXXXXXXXXX).

Bovenstaande verschillen leiden niet tot aanpassingen in het schema van de interactie, ten opzichte van de versie uit de AORTA v6.12 specificaties. Dat verschil ontstaat doordat het element <value> onder de <observationType> herhalend is gemaakt (zie aldaar).

De template 2.16.840.1.113883.2.4.3.11.60.66.10.5 Opvragen Labuitslagen is weergegeven, in detail beschreven en met voorbeelden voorzien in ART-DECOR. Waarschuwing:Titelweergave "POLB_IN364001NL02 - opleverenLabUitslagen" overschrijft eerdere titelweergave "POLB_IN354001NL02 - opvragenLabUitslagen".

POLB_IN364001NL02 - opleverenLabUitslagen

Deze interactie wordt gebruikt door bronsystemen om aan het LSP labuitslagen op te leveren. Het bijbehorende XML Schema is exact gelijk aan dat van de interactie om labuitslagen op te leveren t.b.v. medicatiebewaking door apotheken, zoals dat is opgenomen in de AORTA v6.12 specificaties. Dit Schema is een lokalisatie van de internationale standaard uit het Laboratory domein (vandaar de toevoeging NL).

Samenstelling interactie

Omschrijving ID
Trigger Event Antwoord op OpvragenLabuitslagen ZTKT_TE000005NL
Transmission Wrapper Application Level Acknowledgement MCCI_MT000300
Control Act Wrapper Query Control Act Response / Acknowledgement QUQI_MT120001
Message Type OpleverenLabuitslagen POLB_MT004000NL02

Zendende en ontvangende rollen

Omschrijving ID
Sender Gegevensopleverend ketenzorgsysteem ZTKZ_AR000004NL
Receiver Zorg Informatie Makelaar (ZIM) AZIM_AR000000NL

R-MIM

Kezormimobservationreport.jpg

Het bovenstaande R-MIM geeft alleen het deel van het payload-model weer dat nodig is om de opgeleverde set bouwstenen (met afzonderlijke labbepalingen) te bundelen. Elke bouwsteen met een labuitslag fungeert dan als <component> in bovenstaand model.

De twee onderdelen samen (<observationReport> met <component> subelementen) zijn compatible met de specficaties die al op AORTA gebruikt worden voor het opvragen van labuitslagen. De <observationReport> klasse wordt feitelijk alleen gebruikt om te zorgen dat de patiënt slechts eenmaal hoeft te worden opgenomen voor alle uitslagen.

Elk van de <component> subelementen omvat één gestandaardiseerde bouwsteen met de uitslag van één enkele bepaling. De definitie van deze bouwsteen wordt nader gespecificeerd in de implementatiehandleiding met HL7v3 bouwstenen voor Ketenzorg.

Template

Het template voor deze interactie valt uiteen in twee delen:

  • Het <observationReport> element fungeert als een header voor de opgeleverde verzameling labuitslagen. De patiëntidentificatie wordt meegeven op dit niveau.
  • De <observationEvent> elementen bevatten de afzonderlijke labuitslagen. Elke herhaling van dit element is een instantiatie van de bouwsteen voor labuitslagen.

In dit hoofdstuk wordt alleen het template voor de header uitgewerkt. Dit template is gebaseerd op het template om labuitslagen op te leveren t.b.v. medicatiebewaking door apotheken, zoals dat is opgenomen in de AORTA v6.12 specificaties. De wijzigingen zijn:

  • Diverse optionele onderdelen zijn niet overgenomen (dit is een valide restrictie).
  • Het element <templateId> heeft door de wijzigingen een andere (vaste) waarde.
  • Het element <observationReport><code> heeft een vaste waarde uit het codesysteem LOINC (namelijk 26436-6).
  • Diverse onderdelen van <recordTarget><patient> zijn niet overgenomen, ook al zijn ze in het bestaande template verplicht. De reden is dat het onnodig lijkt om (verplicht) allerlei persoonsgegevens van de patiënt te retourneren aan de vrager.
  • element <author> is niet overgenomen, ook al is het in het bestaande template verplicht. De reden is dat de inhoudsverantwoordelijke al wordt doorgegeven op het niveau van afzonderlijke labuitslagen (<observationEvent>).

De template 2.16.840.1.113883.2.4.3.11.60.66.10.6 Opleveren Labuitslagen is weergegeven, in detail beschreven en met voorbeelden voorzien in ART-DECOR.

De definitie van het subtemplate voor de bouwsteenimplementatie wordt nader gespecificeerd in de implementatiehandleiding met HL7v3 bouwstenen voor Ketenzorg, de template 2.16.840.1.113883.2.4.3.11.60.66.10.203 Labbepaling is weergegeven, in detail beschreven en met voorbeelden voorzien in ART-DECOR. Waarschuwing:Titelweergave "POOB_IN990001NL - opvragenAlgemeneUitslagen" overschrijft eerdere titelweergave "POLB_IN364001NL02 - opleverenLabUitslagen".

POOB_IN990001NL - opvragenAlgemeneUitslagen

Deze interactie wordt door het LSP gebruikt om algemene uitslagen op te vragen bij bronsystemen. Deze interactie is nieuw ontwikkeld, omdat er nog geen bestaande standaard (nationaal of internationaal) is die hier precies voor bedoeld is. Het XML Schema dat gebruikt wordt voor de query parameters is de zogenaamde Generic Act Query, die ook wordt gebruikt bij het opvragen van ICA gegevens (intoleranties, contra-indicaties en allergieën), zoals opgenomen in de AORTA v6.12 specificaties. Dit Schema was ook bedoeld om voor verschillende soorten brongegevens te kunnen gebruiken.

Samenstelling interactie

Omschrijving ID
Trigger Event Opvragen Algemene Uitslagen ZTKT_TE000006NL
Transmission Wrapper Send Message Payload MCCI_MT000100
Control Act Wrapper Query Control Act Request : Query By Parameter QUQI_MT021001
Message Type Generic Act Query QUMT_MT020099NL02

Zendende en ontvangende rollen

Omschrijving ID
Sender Zorg Informatie Makelaar (ZIM) AZIM_AR000000NL
Receiver Gegevensopleverend Ketenzorgsysteem ZTKZ_AR000004NL

Receiver Responsibilities

Reden Trigger Event HL7v3-interactie
De ontvanger van de query moet de meegegeven parameters verwerken en alle algemene uitslagen die eraan voldoen retourneren, voor zover deze niet lokaal afgeschermd zijn. Het retourbericht is: - POOB_IN990003NL

R-MIM

Het R-MIM is hetzelfde generieke model (en bijbehorend XML Schema) dat ook gebruikt wordt bij het opvragen van ICA-gegevens. Het biedt voldoende mogelijkheden om te filteren op de patiënt (verplicht), het tijdsinterval waarbinnen de bepaling werd gedaan en het soort zorgverlener dat inhoudsverantwoordelijk is voor het resultaat ervan.

Er heeft een uitbreiding op het model van de Generic Act Query plaatsgevonden om het mogelijk te maken om te kunnen filteren op basis van de code van de onderliggende Acts (in dit geval de algemene bepalingen). Dit is nodig omdat per contextcode een wisselende subset van diagnostische bepalingen in scope is (net zoals bij de labbepalingen). De toegevoegde parameter is typeSelection.

Template

De template 2.16.840.1.113883.2.4.3.11.60.66.10.7 Opvragen Algemene Uitslagen is weergegeven, in detail beschreven en met voorbeelden voorzien in ART-DECOR. Waarschuwing:Titelweergave "POOB_IN990003NL – opleverenAlgemeneUitslagen" overschrijft eerdere titelweergave "POOB_IN990001NL - opvragenAlgemeneUitslagen".

POOB_IN990003NL – opleverenAlgemeneUitslagen

Deze interactie wordt door bronsystemen gebruikt om algemene bepalingen op te leveren naar aanleiding van een bevraging door het LSP. Deze interactie is nieuw ontwikkeld, omdat er nog geen bestaande standaard (nationaal of internationaal) is die hier precies voor bedoeld is (net zoals dat voor de query het geval is). De payload van de query response bestaat uit gestandaardiseerde bouwstenen die compatible zijn met CDA R2.

Samenstelling interactie

Omschrijving ID
Trigger Event Antwoord op Opvragen Algemene Uitslagen ZTKT_TE000007NL
Transmission Wrapper Send Message Payload MCCI_MT000300
Control Act Wrapper Query Control Act Response / Acknowledgement QUQI_MT120001
Message Type Opleveren Algemene Uitslagen (Clinical Statement) POOB_MT990003NL

Zendende en ontvangende rollen

Omschrijving ID
Sender Zorg Informatie Makelaar (ZIM) AZIM_AR000000NL
Receiver Gegevensopleverend ketenzorgsysteem ZTKZ_AR000004NL

R-MIM

De payload van de query response bestaat alleen uit een set bouwsteeninstantiaties. Zie bouwsteen Algemene Bepaling.

Template

De payload van de query response bestaat alleen uit een set bouwsteeninstantiaties. Zie bouwsteen Algemene Bepaling.

De template 2.16.840.1.113883.2.4.3.11.60.66.10.8 Opleveren Algemene Uitslagen is weergegeven, in detail beschreven en met voorbeelden voorzien in ART-DECOR. Waarschuwing:Titelweergave "PRPA_IN900300NL - opvragenContactmomenten" overschrijft eerdere titelweergave "POOB_IN990003NL – opleverenAlgemeneUitslagen".

PRPA_IN900300NL - opvragenContactmomenten

Deze interactie wordt door het LSP gebruikt om de contactmomenten op te halen bij bronsystemen. De interactie is gebaseerd op de query die is gedefinieerd in Release 2 van de Draft Standard for Trial Use (DSTU), onderdeel van de HL7v3 Normative Edition. Verschil is echter dat niet alle query parameters worden ondersteund en dat de payload van de query response is aangepast naar bouwstenen die compatible zijn met CDA R2.

De definitie van een contactmoment is “elke situatie waarbij contact is geweest (fysiek, mondeling of zelfs per mail) tussen een patiënt en één of meer van diens zorgverleners”. Dit omvat met name ambulante bezoeken (bijv. op spreekuur huisarts of specialist), maar ook klinische opnames (waarbij specialisten soms maar deels betrokken zijn). Ook een telefonisch consult of een chat via sociale media kan als contactmoment fungeren.

Samenstelling interactie

Omschrijving ID
Trigger Event Find Encounters Query PRPA_TE900300UV02
Transmission Wrapper Send Message Payload MCCI_MT000100
Control Act Wrapper Query Control Act Request : Query By Parameter QUQI_MT021001
Message Type Find Encounters Query PRPA_MT900300NL

Zendende en ontvangende rollen

Omschrijving ID
Sender Zorg Informatie Makelaar (ZIM) AZIM_AR000000NL
Receiver Gegevensopleverend Ketenzorgsysteem ZTKZ_AR000004NL

Receiver Responsibilities

Reden Trigger Event HL7v3-interactie
De ontvanger van de query moet de meegegeven parameters verwerken en alle contactmomenten die eraan voldoen retourneren, voor zover deze gegevens niet lokaal afgeschermd zijn. - PRPA_IN900350NL

Template

De template 2.16.840.1.113883.2.4.3.11.60.66.10.9 Opvragen Contactmomenten is weergegeven, in detail beschreven en met voorbeelden voorzien in ART-DECOR. Waarschuwing:Titelweergave "PRPA_IN900350NL - opleverenContactmomenten" overschrijft eerdere titelweergave "PRPA_IN900300NL - opvragenContactmomenten".

PRPA_IN900350NL - opleverenContactmomenten

Deze interactie wordt door bronsystemen gebruikt om contactmomenten op te leveren naar aanleiding van een bevraging door het LSP. De interactie is gebaseerd op de query response die is gedefinieerd in Release 2 van de Draft Standard for Trial Use (DSTU), onderdeel van de HL7v3 Normative Edition. De payload van de query response is echter aangepast naar gestandaardiseerde bouwstenen die compatible zijn met CDA R2.

Samenstelling interactie

Omschrijving ID
Trigger Event Find Encounters Response PRPA_TE900300UV02
Transmission Wrapper Send Message Payload MCCI_MT000300
Control Act Wrapper Query Control Act Response / Acknowledgement QUQI_MT120001
Message Type Opleveren Contactmomenten (Clinical Statement) PRPA_MT900350NL

Zendende en ontvangende rollen

Omschrijving ID
Sender Gegevensopleverend ketenzorgsysteem ZTKZ_AR000004NL
Receiver Zorg Informatie Makelaar (ZIM) AZIM_AR000000NL

R-MIM

De payload van de query response bestaat alleen uit een set bouwsteeninstantiaties. Zie bouwsteen Contactmoment.

Template

De payload van de query response bestaat alleen uit een set bouwsteeninstantiaties. Zie bouwsteen Contactmoment.

De template 2.16.840.1.113883.2.4.3.11.60.66.10.10 Opleveren Contactmomenten is weergegeven, in detail beschreven en met voorbeelden voorzien in ART-DECOR. Waarschuwing:Titelweergave "QURX_IN990201NL01 - opvragenVoorschriftenLijst" overschrijft eerdere titelweergave "PRPA_IN900350NL - opleverenContactmomenten".

QURX_IN990201NL01 - opvragenVoorschriften

Deze interactie wordt door het LSP gebruikt om medicatievoorschriften op te halen bij bronsystemen. De interactie is identiek aan degene die wordt gebruikt binnen de zorgtoepassing Medicatieproces, maar wordt hier voor de volledigheid toch toegelicht.

Samenstelling interactie

Omschrijving ID
Trigger Event Opvragen van medicatievoorschriften QURX_TE990001NL
Transmission Wrapper Send Message Payload MCCI_MT000100
Control Act Wrapper Query Control Act Request : Query By Parameter QUQI_MT021001
Message Type Voorschriftquery QURX_MT990001NL02

Zendende en ontvangende rollen

Omschrijving ID
Sender Zorg Informatie Makelaar (ZIM) AZIM_AR000000NL
Receiver Gegevensopleverend Ketenzorgsysteem ZTKZ_AR000004NL

Receiver Responsibilities

Reden Trigger Event HL7v3-interactie
De ontvanger van de query moet de meegegeven parameters verwerken en alle medicatievoorschriften die daaraan voldoen retourneren, voor zover deze gegevens niet lokaal afgeschermd zijn. - QURX_IN990103NL02

R-MIM

Kezormimmedicationcombinedorderquery.jpg

Dit is het model dat gebruikt wordt binnen de zorgtoepassing Medicatieproces voor het opvragen van voorschriftenlijsten. Het biedt mogelijkheden om te filteren op de patiënt, het voorschriftnummer, het tijdsinterval waarbinnen het voorschrift beschikbaar kwam en het tijdsinterval waarbinnen de voorgeschreven medicatie naar schatting gebruikt wordt.

Template

De template 2.16.840.1.113883.2.4.3.11.60.66.10.11 Opvragen Medicatievoorschriften is weergegeven, in detail beschreven en met voorbeelden voorzien in ART-DECOR. Waarschuwing:Titelweergave "QURX_IN990203NL01 - opleverenVoorschriftenLijst" overschrijft eerdere titelweergave "QURX_IN990201NL01 - opvragenVoorschriftenLijst".

QURX_IN990203NL01 - opleverenVoorschriften

Deze interactie wordt door bronsystemen gebruikt om medicatievoorschriften op te leveren naar aanleiding van een bevraging door het LSP.

Samenstelling interactie

Omschrijving ID
Trigger Event Beantwoorden vraag naar medicatievoorschriften QURX_TE990002NL
Transmission Wrapper Send Message Payload MCCI_MT000300
Control Act Wrapper Query Control Act Response / Acknowledgement QUQI_MT120001
Message Type Lijst met medicatievoorschriften (als CDA R2 CS) PORX_MT932200NL01

Zendende en ontvangende rollen

Omschrijving ID
Sender Gegevensopleverend ketenzorgsysteem ZTKZ_AR000004NL
Receiver Zorg Informatie Makelaar (ZIM) AZIM_AR000000NL

R-MIM

Kezormimmedicationprescriptionlist.jpg

Het bovenstaande R-MIM geeft alleen het deel van het payload-model weer dat nodig is om de opgeleverde set bouwstenen (met medicatievoorschriften) te bundelen. Elke bouwsteen met een voorschrift fungeert dan als <component> in bovenstaand model.

De twee onderdelen (<medicationSubscriptionList> met <component> subelementen) zijn compatible met de specficaties die al op AORTA gebruikt worden voor het opvragen van medicatievoorschriften. De <medicationSubscriptionList> wordt feitelijk alleen gebruikt om te zorgen dat de patiënt slechts eenmaal hoeft te worden opgenomen.

Elk van de <component> subelementen omvat één gestandaardiseerde bouwsteen met één enkel medicatievoorschrift. De definitie van deze bouwsteen wordt nader gespecificeerd in de implementatiehandleiding met HL7v3 bouwstenen voor Ketenzorg.

Template

De template 2.16.840.1.113883.2.4.3.11.60.66.10.12 Opleveren Medicatievoorschriften is weergegeven, in detail beschreven en met voorbeelden voorzien in ART-DECOR.

De definitie van het subtemplate voor de bouwsteenimplementatie wordt nader gespecificeerd in de implementatiehandleiding met HL7v3 bouwstenen voor Ketenzorg, de template 2.16.840.1.113883.2.4.3.11.60.66.10.204 Voorschrift is weergegeven, in detail beschreven en met voorbeelden voorzien in ART-DECOR.