7kezo:V1.0 Interacties tussen LSP en bron

{{#customtitle: Interacties tussen LSP en bron | Interacties tussen LSP en bron}}

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.

Waar mogelijk worden de bouwsteenspecifieke queries gerealiseerd o.b.v. bestaande interacties uit de AORTA specificaties (zoals bij labuitslagen en voorschriftenlijst). Als er nog geen Nederlandse standaard is, dan wordt een nieuwe lokalisatie van een internationale standaard gebruikt (zoals bij contactmomenten). Alleen als er geen toepasbare internationale standaard bestond, is een nieuwe interactie uitgewerkt (zoals bij algemene uitslagen).

Daar waar er voor de zorgtoepassing Ketenzorg aanpassingen worden gedaan aan een template dat al onderdeel is van de AORTA specificaties (hetgeen is gebeurd bij labuitslagen), moet nog overlegd worden om alsnog harmonisatie te bewerkstelligen, zeker als het gaat om niet-compatibele verschillen (zoals bij persoonsgegevens en inhoudsverantwoordelijke).

Een belangrijk aspect is de versionering van de bouwsteenspecifieke queries (en van de bouwstenen zelf). De versie van elke interactie (dus ook van de queries) is af te leiden uit het interactie ID, dat ook al root element fungeert. De versie van een bouwsteeninstantiatie is direct gerelateerd aan het template ID dat erin wordt meegegeven. 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.

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).

Er moet worden bekeken in hoeverre de update op het XML Schema, plus het gewijzigde gebruik van <observationEffectiveTime> en het toevoegen van <observationType> in het template, moeten worden doorgevoerd in de bestaande zorgtoepassing voor opvragen van labuitslagen door apotheken. Dit staat nog los van de discussie over het formaat van de labuitslagen zelf (de bouwsteendefinitie), zoals beschreven in de [HL7v3 IH Bouwstenen].

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.

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

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.

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.

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.

Het is mogelijk om een lijstconstructie in de query response toe te voegen om voor alle opgeleverde bepalingen in één keer aan te geven om welke patiënt het gaat. Dit mechanisme wordt ook toegepast bij de interactie voor het opvragen van medicatievoorschriften (opvragenVoorschriftenLijst). Vooralsnog is echter besloten om bij het opleveren van algemene bepalingen helemaal geen patiënt aan te duiden in de payload van de query response. Dit gebeurt in plaats daarvan in de <attentionLine> van de transmission wrapper van de interactie, zodat de vraagsteller (in dit geval het LSP) toch kan controleren dat gegevens van de juiste patiënt geretourneerd worden. Voordeel is dat het Clinical Statement van CDA R2 (d.w.z. de bouwsteen die erop gebaseerd is) direct als payload van de interactie gebruikt kan worden.

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.

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.

Merk op dat in deze fase de scope zodanig is dat vanuit het huisarts-dossier (opgebouwd conform het NHG model) niet elk deelcontact, maar alleen het contactmoment als geheel opgeleverd moet worden. Dit omdat voor nu alleen de administratieve aspecten relevant zijn, terwjl deelcontacten nodig zijn om de link naar episodes te leggen.

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.

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.

Het is mogelijk om een lijstconstructie in de query response toe te voegen om voor alle opgeleverde contactmomenten in één keer aan te geven om welke patiënt het gaat. Dit mechanisme wordt ook toegepast bij de interactie voor het opvragen van medicatievoorschriften (opvragenVoorschriftenLijst). Vooralsnog is echter besloten om bij het opleveren van contactmomenten helemaal geen patiënt aan te duiden in de payload van de query response. Dit gebeurt in plaats daarvan in de <attentionLine> van de transmission wrapper van de interactie, zodat de vraagsteller (in dit geval het LSP) toch kan controleren dat gegevens van de juiste patiënt geretourneerd worden. Voordeel is dat het Clinical Statement van CDA R2 (d.w.z. de bouwsteen die erop gebaseerd is) direct als payload van de interactie gebruikt kan worden.

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.

1. DOORVERWIJZING 7kezo:V1.0 QURX IN990201NL01
2. DOORVERWIJZING 7kezo:V1.0 QURX IN990203NL01