HL7 v2-koppeling laten maken
HL7 versie 2 is de berichtstandaard waarmee systemen binnen ziekenhuizen en laboratoria al jaren gegevens uitwisselen: opnames en verplaatsingen van patiënten, orders en uitslagen. Volgens Nictiz is het de meest gebruikte HL7-standaard in de tweede- en derdelijnszorg. Moet uw eigen systeem die berichten ontvangen of versturen, of wilt u ze vertalen naar iets nieuwers, dan is een koppeling nodig. Appfront bouwt die koppeling.
Wat is een HL7 v2-koppeling?
Een HL7 v2-koppeling laat uw systeem meedoen in het berichtenverkeer binnen een ziekenhuis of lab. HL7 Nederland noemt de v2-berichten het werkpaard van HL7: ze ondersteunen de meest voorkomende transacties tussen systemen in zorginstellingen, zoals inschrijving en opname van patiënten, het plaatsen van orders, het ontvangen van uitslagen, recepten, agendabeheer en de financiële afhandeling. In Nederland worden ze vooral in ziekenhuizen gebruikt, voor het administratieve domein en de ordercommunicatie. Volgens Nictiz gaat het vooral om uitwisseling binnen een instelling, en in mindere mate tussen instellingen.
Een v2-bericht bestaat uit segmenten: herbruikbare groepjes gegevens, zoals patiëntkenmerken, bezoekgegevens, verzekeringsgegevens, orders en uitslagen. Welke segmenten in welke volgorde in een bericht staan, ligt vast in de specificatie van dat bericht. De berichten hebben de bekende pipe-structuur, hoewel XML ook kan. Voorbeelden uit de standaard zijn ADT_A01 voor een opname of bezoek en ADT_A02 voor een verplaatsing in de patiëntadministratie, ORM_O01 en OML_O21 voor orders, ORU_R01 voor uitslagen en SIU_S12 voor afspraken. De versies van HL7 v2 zijn achterwaarts compatibel, en HL7 Nederland onderhoudt implementatiehandleidingen met afspraken over Nederlandse zaken zoals het BSN.
Wij bouwen maatwerk omdat elk ziekenhuis de standaard net anders invult: welke velden gevuld zijn, welke codes er in staan, welke berichten er echt komen. De koppeling leest elk bericht, controleert het tegen de afspraken die u met de verzender hebt, verwerkt het in uw systeem en stuurt een bevestiging terug. Een bericht dat niet klopt, gaat niet verloren maar komt in een wachtrij waar u ziet wat er mis is. Het transport stemmen we per verbinding af, bijvoorbeeld via MLLP, het minimal lower layer protocol van HL7, of als bestand. Wilt u de gegevens ook als FHIR beschikbaar maken, dan gebruiken we de implementatiegids van HL7 die v2-berichten, segmenten en datatypes naar FHIR R4 vertaalt.
Ontvangen
Berichten gelezen en getoetst.
Bevestigd
Elk bericht beantwoord.
Niets kwijt
Fouten in een wachtrij.
Hoe wij uw HL7 v2-koppeling bouwen
We beginnen bij het berichtenverkeer zoals het nu is: welke systemen welke berichten sturen, welke velden ze gebruiken en waar het misgaat. Met voorbeeldberichten uit uw eigen omgeving leggen we per berichttype vast welke segmenten en velden de koppeling leest en schrijft, en wat er gebeurt bij een afwijking. We bouwen eerst één berichtstroom, bijvoorbeeld de ADT-berichten, en testen die met echte, geanonimiseerde voorbeelden in een testomgeving. Daarna volgen orders, uitslagen of afspraken. Verandert een verzendend systeem van versie, dan werken we de koppeling bij.
Systemen, berichten, knelpunten.
Segmenten, velden, afwijkingen.
Getest met eigen voorbeelden.
Bewaking, en beheer bij nieuwe versies.
Wat een HL7 v2-koppeling concreet doet
De onderdelen hieronder komen in vrijwel elke HL7 v2-koppeling terug. Welke u nodig hebt, hangt af van de berichtstromen en de systemen aan de andere kant.
Ontvangen
Berichten gelezen en getoetst.
Versturen
Orders en uitslagen verzonden.
Bevestigingen
Elk bericht beantwoord.
Wachtrij
Afgekeurde berichten zichtbaar.
Vertaling
Van v2 naar FHIR R4.
Logboek
Elk bericht terug te vinden.
Voor wie wij een HL7 v2-koppeling bouwen
De koppeling is bedoeld voor organisaties die een systeem moeten aansluiten op het berichtenverkeer van een ziekenhuis of lab, of die v2-berichten willen omzetten naar een nieuwere standaard.
Ziekenhuizen
Afdelingssystemen aangesloten.
Laboratoria
Orders in, uitslagen uit.
Diagnostische centra
Aanvragen en verslagen.
Softwarebouwers
Uw pakket op het HIS.
Technologie en koppelingen
Deze pagina gaat over het berichtenverkeer met HL7 versie 2, vooral binnen ziekenhuizen en labs. Moeten de gegevens daarna aansluiten op de landelijke zorginformatiebouwstenen, kijk dan naar de zibs-koppeling. Werkt uw ziekenhuis met HiX, lees dan ook over de ChipSoft-koppeling, en voor verwijzingen van huisartsen naar het ziekenhuis over de ZorgDomein-koppeling. Moet het berichtenverkeer via een tussenlaag lopen, dan is er middleware laten maken. Onze werkwijze leest u op software laten maken.
Waarom Appfront voor uw HL7 v2-koppeling?
Een uitslag die niet aankomt omdat één veld anders is gevuld, een opname die met de hand wordt overgetypt, of een koppeling die stilvalt na een update van het ziekenhuissysteem, raken direct het werk op de afdeling. Daar bouwen we op: afspraken per bericht die u kunt nalezen, bevestigingen voor elk bericht en een wachtrij waar niets uit verdwijnt.
Getoetst
Elk bericht gecontroleerd.
Zichtbaar
Afwijkingen direct gemeld.
Bijgehouden
Nieuwe versies verwerkt.
Security en privacy bij een HL7 v2-koppeling
HL7 v2-berichten bevatten gegevens over patiënten, opnames, orders en uitslagen, en dat zijn gezondheidsgegevens. De koppeling verwerkt alleen de segmenten en velden die uw systeem nodig heeft, bewaart berichten niet langer dan voor controle en herstel nodig is, en legt elk bericht met tijd, afzender en resultaat vast.
De koppeling draait in een Europees datacenter of in uw eigen omgeving, met versleutelde verbindingen en opslag. Omdat v2-berichten van zichzelf niet versleuteld zijn, loopt het transport over een beveiligde verbinding of een afgeschermd netwerk. Wie de wachtrij mag inzien en berichten opnieuw mag aanbieden, stemmen we vooraf met u af.
Veelgestelde vragen over een HL7 v2-koppeling
Vragen die applicatiebeheerders, integratiespecialisten en leveranciers van ziekenhuis- en labsoftware stellen voordat ze hiermee beginnen.
Een berichtstandaard van HL7 voor de uitwisseling van gegevens tussen systemen in zorginstellingen, zoals opname van patiënten, orders, uitslagen, afspraken en financiële afhandeling. De berichten bestaan uit segmenten in de zogenaamde pipe-structuur.
Volgens Nictiz vooral in de tweede- en derdelijnszorg, en dan binnen de instelling zelf, in mindere mate tussen instellingen. HL7 Nederland noemt de ziekenhuisomgeving, met name het administratieve domein en de ordercommunicatie.
Het zijn berichtgroepen uit de standaard. ADT-berichten horen bij de patiëntadministratie, zoals ADT_A01 voor een opname of bezoek. ORM_O01 is een algemeen orderbericht, OML_O21 een laboratoriumorder en ORU_R01 hoort bij het rapporteren van uitslagen.
HL7 v2 werkt met berichten die tussen systemen worden verstuurd. FHIR werkt met resources via een REST-interface op webstandaarden, met profielen voor de Nederlandse situatie. Volgens Nictiz combineert FHIR eigenschappen van v2, v3 en CDA. Beide kunnen naast elkaar bestaan.
Ja. HL7 heeft een implementatiegids die HL7 v2-berichten, segmenten, datatypes en vocabulaire naar FHIR R4 vertaalt. Een koppeling kan berichten blijven ontvangen en de gegevens daarnaast als FHIR aanbieden.
Dat stemmen we per verbinding af met het systeem aan de andere kant. Mogelijkheden zijn onder meer MLLP, het minimal lower layer protocol van HL7, en bestandsoverdracht, altijd over een beveiligde verbinding.
Voor organisaties met eigen of afdelingssoftware die op het berichtenverkeer van een ziekenhuis of lab moet aansluiten, en voor leveranciers die dat in hun pakket willen opnemen. Heeft uw pakket al een interface die precies past bij de berichten van uw ziekenhuis, dan is een eigen koppeling meestal niet nodig.
Uw systeem op het HL7 v2-berichtenverkeer?
Vertel ons welke berichten uw systeem moet ontvangen of versturen en met welk systeem. We laten zien hoe een koppeling dat betrouwbaar afhandelt.