Die Hl7-Schnittstelle in Cypro

Die HL7-Schnittstelle in Cypro 

Der bekannteste Kommunikationsstandard für Daten des Gesundheitswesens ist HL7 (Health 

Level Seven). Dieser ursprünglich in den USA (Universitätsklinik in Palo Alto 1987) entwickelte 

Standard spezifiziert Austauschformate und -inhalte auf der Anwendungsebene, d.h. er beschreibt 

die Kommunikation unabhängig von der eingesetzten Soft- und Hardware. 

Die Cypro-HL7-Schnittstelle arbeitet mit SAP- und nicht SAP-Krankenhaus-Systemen. Diese Systeme 

benutzen normalerweise keine SAP-Bewegungs-Nummer, deshalb erstellt Cypro eigene 

Bewegungs-Nummern. Wenn Sie es wünschen, können Sie allerdings auch HL7 Schnittstellen mit 

Nicht-SAP-Systemen benutzen, die eigene Bewegungs-Nummern verwenden. 

Cypro unterstützt die HL7-Version 2.2 und 2.31 mit folgenden HL7-Befehlen: 

A01 : Admit Patient (Patient neu aufnehmen) 

A02 : Transfer Patient (Patient verlegen) 

A03 : Discharge Patient (Patient entlassen) 

A04 : ambulanter Besuch 

A06 : Wechsel ambulant nach stationär 

A07 : Wechsel stationär nach ambulant 

A08 : Update Patient (Patientdaten ändern) 

A11 : Cancel Admit Patient (Neuaufnahme stornieren) 

A12 : Cancel Transfer Patient (Verlegung stornieren) 

A13 : Cancel Discharge Patient (Entlassung stornieren) 

A31 : Änderung Patienteninformationen (analog A08) 

Hier ein Beispiel: 

ars pharmaceutica GmbH 

Gesellschaft für klinisches Wissenschaftsmanagement 

und Softwarelösungen mbH 

Patient A kommt ins Krankenhaus. Die Aufnahmedaten werden in das Krankenhaus-Informations- 

System eingebracht. (Name, Vorname, Adresse, .Aufnahme-Nummer, Station,...). Die Apotheke 

verfügt über ein eigenes EDV-System, in dem diese Daten über die HL7-Schnittstelle in Cypro eingefügt 

werden, wodurch die erneute manuelle Eingabe von Patienten, sowie das Aufnehmen und 

Entlassen entfällt. Daten bestehender Cypro-Patienten werden durch die HL7-Schnittstelle automatisch 

aktualisiert, die Daten von Nicht-Cypro-Patienten verbleiben in der HL7 Datenbank. Diese 

können als HL7-Patienten in die Cypro-Datenbank eingefügt werden. 

ars pharmaceutica GmbH Telefon (040) 7903240 Geschäftsführer: Heinrich Meemken UST-ID-Nr.: DE 158 986 748 Dt. Apotheker- und Ärztebank eG 

Zum Fürstenmoor 11 Telefax (040) 79143602 Amtsgericht Lüneburg IBAN: DE 49 3006 0601 0403 7189 99 BLZ 200 906 02 

21079 Hamburg E-Mail cypro@cypro.de Handesregister-Nr. HRB 110427 BIC: DAAEDEDD Kto.-Nr. 040 3718999 

http://www.cypro.de 

Seite 1 (C) 2006, ars pharmaceutica GmbH, Autor : Dipl.-Ing. Stefan Knecht




Allgemeines 

Voraussetzungen für den Betrieb der HL7-Schnittstelle 

Die HL7-Schnittstelle ist als Windows-Dienst realisiert und läuft deswegen nur in Windows NT 4.0, 

Windows 2000 und Windows XP. Für Windows 9x-Systemen sieht Cypro keine Anbindung an das 

krankenhausinterne Kommunikations-System vor. 

Vor der Inbetriebnahme der HL7-Schnittstelle muss entweder ein Firebird-Client (wenn die Cypro- 

Datenbank sich nicht auf dem lokalen Rechner befindet) oder ein Firebird-Server (wenn sich die 

Cypro-Datenbank auf dem lokalen Rechner befindet) installiert sein und laufen. Die HL7-Schnittstelle 

funktioniert global im Cypro-Netzwerk und braucht deswegen nur auf einem Rechner installiert 

werden. Mehrere Installationen sind sehr kontraproduktiv für die Geschwindigkeit der Datenbank, 

da nun die HL7-Botschaften mehrfach abgearbeitet werden. Dies führt zwar nicht dazu, das 

Daten doppelt eingetragen werden (da die Schnittstelle ja von vornherein von einer dualen Eingabe 

ausgeht), Einfüge-Operationen werden von den mehrfach aktiven Schnittstellen dann aber als 

Aktualisierungen ausgeführt. 

Die HL7-Schnittstelle sollte also auf jedem Fall nur ein einziges Mal aktiv installiert sein. 

Wie werden Daten in Cypro eingefügt? 


Die HL7-Schnittstelle ist an das Krankenhaus-interne HL7-Kommunikations-System angeschlossen 

und empfängt über eine Socket-Verbindung alle gesendeten HL7-Botschaften. Die Kommunikations-Einstellungen 

können in den Cypro-Optionen geändert werden. 

Die empfangenen Daten werden zunächst auf Fehlerfreiheit geprüft und dann in eine spezielle 

HL7-Daten-Verwaltung in die Cypro-Datenbank eingetragen. Die ankommenden HL7-Daten werden 

nur dann an die Cypro-Patienten weitergereicht, wenn ein „HL7-Patienten“ zuvor als 

„Cypro-Patient“ eingefügt wurde. 









Das MSH-Segment 

Für jede HL7-Botschaft wird ein MSH- und ein EVN-Segment gesendet. Die HL7-Schnittstelle liest 

folgende Informationen aus: 

HL7-Segment HL7-Sequenz-Name Sequenz- 

Nr. 

MSH SENDING APPLICATION 3 

MSH SENDING FACILITY 4 

MSH RECEIVING APPLICATION 5 

MSH RECEIVING FACILITY 6 

MSH DATE/TIME OF MESSAGE 7 

MSH MESSAGE TYPE 9 

MSH MESSAGE CONTROL ID 10 

MSH PROCESSING ID 11 

MSH VERSION ID 12 

MSH ACCEPT ACKNOWLEDGEMENT TYPE 15 

MSH APPLICATION ACKNOWLEDGEMENT TYPE 16 

EVN EVENT TYPE CODE 1 

EVN DATE/TIME OF EVENT 2 

PV1 SET ID - PATIENT VISIT 1 


Der Haupt-Separator (normalerweise das Zeichen „|“’) wird aus dem ersten Zeichen im MSH- 

Segment hinter der Segmentbezeichnung („MSH“) gelesen. Der Detail-Separator wird aus dem 

ersten Zeichen im zweiten Feld des MSH-Segments gelesen (normalerweise das Zeichen „^“). 

Die Datums- und Zeitinformationen müssen in einem bestimmten Format vorliegen. Abhängig vom 

Feldtyp in der HL7-Botschaft können diese entweder als „yyyymmdd[hhmmss]“ gesendet werden, 

oder auch noch weitere Zeitinformationen, wie z.B. Millisekunden enthalten. 

Die HL7-Schnittstelle liest jedoch bei Datumsfeldern nur Jahr, Monat und Tag aus, bei Zeitfeldern 

wird noch zusätzlich Stunde, Minute und Sekunde ausgelesen. Alle weiteren Informationen werden 

ignoriert. 

Die Länder-Informationen (Land und Staatsangehörigkeit) muss als Alpha-2 oder Alpha-3 Code 

nach ISO 3166-1 vorliegen. Cypro entscheidet je nach Länge des Eintrages, welcher Code vorliegt. 

Die Bewegungs-Nummer wird standardmäßig aus dem ersten Feld im PV1-Segment (SET ID - 

PATIENT VISIT) ausgelesen. Hier sind nur Zahlen erlaubt. Buchstaben oder andere Zeichen, die 

eine Umformung der Feld-Informationen in eine Zahl nicht zulassen würden, sind nicht erlaubt. 









Vorrausetzung für die Daten-Annahme durch Cypro 

Die HL7-Schnittstelle nimmt nur dann Daten an, wenn diese folgende Voraussetzungen erfüllen: 

1. Die HL7-Daten stammen von einer Cypro bekannten Anwendung (Dieser Wert entspricht MS 

H.SENDING_APPLICATION) 

2. Die HL7-Daten stammen von einer Cypro bekannten „Einrichtung“ (Dieser Wert entspricht MS 

H.SENDING_FACILITY) 

3. Die HL7-Daten werden für eine Cypro bekannte Anwendung (normalerweise ist dies Cypro 

selbst) ausgesandt (Dieser Wert entspricht MSH.RECEIVING_APPLICATION) 

4. Die HL7-Daten werden an eine Cypro bekannte „Einrichtung“ ausgesandt (Dieser Wert entspricht 

MSH.RECEIVING_FACILITY) 

5. Es handelt sich um Produktions-Daten (MSH.PROCESSING-ID=“P“). Trainings (Test) und 

Debug-Daten werden nur dann empfangen (allerdings auch vollständig in die HL7-bzw. Cypro- 

Datenbank eingetragen), wenn dies in den Optionen eingestellt ist. 

6. Die ausgesandten Daten können von bestimmten Start- und Endzeichen eingeschlossen sein. 

In diesem Fall wird alles ignoriert, was außerhalb dieser Zeichen steht. 

Bestätigungsmeldung an den HL7-Server 

Alle empfangene Daten werden überprüft, ob sie für Cypro bestimmt sind und alle Voraussetzungen 

für die weitere Verarbeitung erfüllen (dazu gehört auch Fehlerfreiheit und vollständige Übermittlung 

aller HL7-Daten). 

Sieht die HL7-Botschaft eine Bestätigungsmeldung vor oder wird dies in den Optionen expliziert 

eingestellt, so sendet Cypro nach Empfang bzw. nach Verarbeitung der Daten eine Bestätigungsmeldung 

(Acknowledgement) an das übermittelnde System 

Dabei sieht Cypro zwei Möglichkeiten vor. 

Möglichkeit 1: Accept-Acknowledgement 


Die Nachricht wird gespeichert und anschließend das MSH-Segment überprüft. Werden die Einträge 

der Felder MSH-9, MSH-11 und/oder MSH-12 nicht akzeptiert, so wird ein „Commit Reject“ 

(CR) zurückgesandt. Liegen andere Gründe für eine Ablehnung der Nachricht vor, so wird ein 

„Commit Error“ (CE) übermittelt, andernfalls wird die Nachricht zur Weiterverarbeitung weitergegeben 

und ein „Commit Accept“ (CA) zurückgesandt. 









Möglichkeit 2: Application-Acknowledgement 

Bei diesem Verfahren werden die ACK-Nachrichten erst nach Verarbeitung der Daten in der HL7- 

Patienten-Verwaltung und in der Cypro-Patienten-Verwaltung verschickt. Dies erfolgt in der Regel 

zeitversetzt zum Eingang der zu bestätigenden Nachricht. Es gibt dabei zwei Möglichkeiten: 

● Wenn die Nachricht korrekt verarbeitet werden konnte, wird „Application Accept“ (AA) zurückgesandt. 

● Konnte die Nachricht aufgrund eines formalen oder inhaltlichen Fehlers nicht ausgewertet werden, 

so wird „Application Error“ (AE) geschickt. 

Die HL7-Schnittstelle kann natürlich auch zuerst ein Accept-Acknowledgement versenden und 

dann im Anschluss ein Application-Acknowledgement. Dies kann man entweder über die eingehende 

HL7-Nachricht steuern (Felder MSH-15 und MSH-16) oder über die Cypro-Optionen. 

Das Senden eines Application-Acknowledgement. Ist beim betrieb in hochfrequenten Nachrichtensystemen 

nicht möglich 

Aufbau der ACK-Nachricht 


Bei einer ACK-Nachricht sendet Cypro zunächst das empfangene MSH-Segment und dann nach 

einem Zeilenumbruch () das MSA-Segment mit Acknowledgement-Code und Message-Control-ID 

aus dem MSH-Segment. 

Im MSH-Segment kann der Wert für „MESSAGE_TYPE“ durch „ACK“ ersetzt werden. Aktivieren 

Sie dazu die Option „im MSH-Segment "ACK" anstatt des ursprünglichen MESSAGE_TYPE 

senden“ (Cypro-Optionen – Rubrik „HL7“- Seite „Allgemeines“). 









Eingefügte Daten in Cypro 

Die HL7-Schnittstelle fügt folgende Daten in Cypro ein: 

Wert für Cypro HL7- HL7-Sequenz-Name Länge Sequenz- 

Segment 

Nummer 

Patienten-ID PID PATIENT-ID 30 3 

Patient-Name PID PATIENT NAME 30 5 

Patient-Vorname PID PATIENT NAME 30 5 

Patient-Anrede/Titel PID PATIENT NAME 30 5 

Patient-Geburtsdatum PID DATE OF BIRTH ./. 5 

Patient-Geschlecht PID SEX 8 

Adresse-Strasse PID PATIENT ADRESS 50 11 

Adresse-Ort PID PATIENT ADRESS 50 11 

Adresse-Postleitzahl PID PATIENT ADRESS 10 11 

Adresse-Land PID PATIENT ADRESS 50 11 

Telefon privat PID PHONE NUMBER-HOME 25 13 

Telefon geschäftlich PID PHONE NUMBER-BUSINESS 25 14 

Staatsangehörigkeit PID CITIZENSHIP 50 26 

Bewegungsnummer PV1 30 1 

Krankenhaus PV1 ASSIGNED PATIENT LOCATION 50 3 

Abteilung PV1 ASSIGNED PATIENT LOCATION 50 3 

Station PV1 ASSIGNED PATIENT LOCATION 50 3 

Arzt-ID-Kennung PV1 ATTENDING DOCTOR 20 7 

Arzt-Name PV1 ATTENDING DOCTOR 30 7 

Arzt-Vorname PV1 ATTENDING DOCTOR 30 7 

Arzt-Anrede/Titel PV1 ATTENDING DOCTOR 30 7 

Patient-Aufnahme-Nummer PV1 VISIT NUMBER 15 19 

Aufnahme-Zeitpunkt PV1 ADMIT DATE/TIME ./. 44 

Entlassungszeitpunkt PV1 DISCHARGE DATE/TIME ./. 45 

Patient verlegen ab EVN DATE TIME OF EVENT ./. 2 

Gültigkeitsdatum der Versi IN1 PLAN EXPIRATION DATE 8 13 

cherungs-Karte 

Krankenkassen-Nummer IN1 INSURANCE COMPANY ID 15 3 

Krankenkasse IN1 INSURANCE COMPANY NAME 60 4 

Versicherten-Nummer IN1 POLICY NUMBER 25 36 

Arzt-ID-Kennung STF ATTENDING DOCTOR 20 1 

Arzt-Name STF ATTENDING DOCTOR 30 3 

Arzt-Vorname STF ATTENDING DOCTOR 30 3 

Arzt-Anrede/Titel STF ATTENDING DOCTOR 30 3 

Bewegungsnummer ZBE 30 2 

Patient verlegen ab ZBE /. 3 

Bewegungsnummer ZID 30 2 

Patient verlegen ab ZID /. 3 

Vorgabe-Felder, alternative Felder sind andersfarbig markiert 

Eingefügte Daten in Cypro 









Besondere HL7-Sequenzen 

Einige HL7-Sequenzen liegen nicht als einzelne Felder, sondern als zusammengesetzte Felder 

vor. Die nachfolgend beschrieben HL7-Sequenzen können je nach Krankenhaus unterschiedlich 

aufgebaut sein. Hier wird zunächst die standardmäßige Kodierung beschrieben. In den nachfolgenden 

Kapiteln wird auf die Anpassung an spezifische Gegebenheiten eingegangen. 

1. Patient-Namens-Informationen: Patient-Vorname, Patient-Name, Patient-Anrede/Titel 

Diese Information liegt standardmäßig wie folgt vor: 

FAMILY NAME ^ GIVEN NAME ^ MIDDLE INITIAL OR NAME ^ SUFFIX ^ PREFIX ^ DEGREE 

Die HL7-Schnittstelle liest folgendes aus: 

Patient-Name = MIDDLE INITIAL OR NAME + FAMILY NAME + SUFFIX, 

Patient-Vorname = GIVEN NAME, 

Patient-Anrede = PREFIX + DEGREE 

2. Patient-Adresse: Strasse, Ort, Postleitzahl, Land 

Diese Information liegt wie folgt vor: 

STREET ADDRESS ^ OTHER DESTINATION ^ CITY ^ STATE OR PROVINCE ^ ZIP ^ 

COUNTRY ^ TYPE 


Strasse = STREET ADDRESS, Ort = CITY, Postleitzahl = ZIP, Land = COUNTRY 

Der Wert in TYPE wird ignoriert. Die HL7-Schnittstelle trägt immer alles als Privat-Adresse ein. 

3. Stations-Informationen: Krankenhaus, Abteilung, Station 


NURSE UNIT ^ ROOM ^ BED ^ FACILITY ID ^ BED STATUS 


Station = NURSE UNIT, Abteilung = FACILITY ID, Krankenhaus = die ersten zwei Zeichen 

von NURSE UNIT 

Die Werte für Krankenhaus, Abteilung, Station sind keine vollständigen Namensbezeichnungen, 

sondern eindeutige Abkürzungen. Die Kodierung des Krankenhauses kann in den Optionen 

verändert werden (siehe „Kodierung für Krankenhaus“). Hier wird das Standard-Verfahren 

aufgezeigt. 

4. Arzt-Namens-Informationen: Arzt-ID-Kennung, Arzt-Vorname, Arzt-Name 


ID NUMBER ^ FAMILY NAME ^ GIVEN NAME ^ MIDDLE INITIAL OR NAME ^ SUFFIX ^ 

PREFIX ^ DEGREE 


Arzt-ID-Kennung = ID NUMBER 

Arzt-Name = MIDDLE INITIAL OR NAME + FAMILY NAME + SUFFIX, 

Arzt-Vorname = GIVEN NAME, Arzt-Anrede = PREFIX + DEGREE 










Kodierung für Namen 

Die Kodierung für Arzt- und Patienten-Namen kann in den Cypro-Optionen entsprechend den Gegebenheiten 

des Krankenhauses angepaßt werden. 

Standardmäßig erwartet Cypro den Patienten-Namen in folgendem Format: 

FAMILY NAME ^ GIVEN NAME ^ MIDDLE INITIAL OR NAME ^ SUFFIX ^ PREFIX ^ DEGREE 

Der Arzt-Name wird wie folgt erwartet: 

ID NUMBER^FAMILY NAME^GIVEN NAME^MIDDLE INITIAL OR NAME^SUFFIX^PREFIX^ DE 

GREE 

Werden die Namens-Informationen abweichend übertragen, so wählen Sie aus den nachfolgend 

aufgeführten Optionen. Sie finden diese in der Rubrik „HL7“ auf der Seite „Spezielles“ und der 

Unterseite „Kodierung“. 

● Der Arzt-Name wird genauso wie der Patienten-Name übertragen: 

ID NUMBER^FAMILY NAME^GIVEN NAME^MIDDLE INITIAL OR NAME^SUFFIX^PREFIX^ 

DEGREE 

● Der Arzt-Name wird ohne "MIDDLE INITIAL OR NAME" übertragen 

Verwenden Sie diese Option, wenn Ihr HL7-Server an Cypro für den Arzt-Namen das Feld 

„MIDDLE INITIAL OR NAME“ nicht sendet. 

Achtung: 

Damit ist nicht gemeint, dass dieses Feld nicht gefüllt wird. 

Wählen Sie dies also nur, wenn an Cypro für den Arzt z.B. folgendes gesendet wird: 

0001^Muster-Arzt^Paul^^^Dr. med. 

Wählen Sie dies NICHT, wenn an Cypro für den Arzt z.B. folgendes gesendet wird: 

0001^Muster-Arzt^Paul^^^^Dr. med. 

● Der Arzt-Name wird ohne „SUFFIX“ und ohne „PREFIX“ übertragen 


● „MIDDLE INITIAL OR NAME“ des Patient- und des Arzt-Namens gehört zum Nachnamen 









● „MIDDLE INITIAL OR NAME” des Patient- und des Arzt-Namens ist Vorsatz zum Titel und gehört 

nicht zum Nachnamen 

Mit dieser Option wird das Feld „MIDDLE INITIAL OR NAME“ als Bestandteil des Titels gewertet. 

Cypro setzt den Titel dann aus MIDDLE INITIAL OR NAME + PREFIX + DEGREE zusammen, 

ansonsten wird der Titel aus PREFIX + DEGREE zusammengesetzt. 

● „MIDDLE INITIAL OR NAME“ des Patient- und des Arzt-Namens beinhaltet den 2. sowie weitere 

Vornamen und gehört nicht zum Nachnamen 

Die hier beschriebenen Optionen haben keinen Einfluß auf schon verarbeitete HL7-Botschaften. 

Sie gelten nur für neu ankommende HL7-Botschaften. 

Leere Vornamen und unvollständiges Geburtsdatum 

Um HL7-Botschaften auch verarbeiten zu können, wenn der Patienten-Vorname leer ist oder das 

Geburtsdatum unvollständig ist, wählen Sie die Optionen „Erlaube leere Vornamen für Patienten“ 

und „Erlaube ein unvollständiges Geburtsdatum für Patienten“ (HL7-Optionen – Rubrik 

„HL7“- Seite „Spezielles“ - Unterseite „Eingabe/Aktualisierung“). 

Ist die Option „Erlaube leere Vornamen für Patienten“ gewählt, so verwendet Cypro ein Leerzeichen 

(„ “) anstelle des leeren Vornamens. Wird ein solcher Patient als Cypro-Patient eingefügt und 

anschließend in der Patientenverwaltung bearbeitet, so erhalten Sie eine Hinweismeldung, daß 

der Vornamen eingeben werden muß. Ein Leerzeichen ist nicht zulässig. Um dies zu umgehen 

und ein Leerzeichen als zulässigen Vornamen verwenden zu können, aktivieren Sie auch bei den 

Cypro-Clients die Option „Erlaube leere Vornamen für Patienten“. 

Ist die Option „Erlaube ein unvollständiges Geburtsdatum für Patienten“ gewählt, so wird ein 

unvollständiges Geburtsdatum um die fehlenden Werte vervollständigt. 

Ein vollständiges Geburtsdatum wird im Format „yyyymmdd“ übertragen. Nicht übertragene Werte 

werden durch „01“ ersetzt. 

Beispiel: 

Geburtsdatum in der HL7-Botschaft „Cypro“-Geburtsdatum 

19550724 24.07.1955 

195507 01.07.1955 

1955 01:01:1955 










Kodierung für Krankenhaus 

Die Kodierung für die Krankenhaus-Informationen wird in den Cypro-Optionen – Rubrik „HL7“- 

Seite „Spezielles“ - Unterseite „Kodierung“ eingetragen. 

Cypro unterstützt 4 „Kodierungs-Verfahren“: 

1. Das Krankenhaus wird in einem 2-stelligen Code als Bestandteil von Abteilung und Station 

übertragen: ^^^ 

Dies ist das Standard-Verfahren der Cypro-HL7-Schnittstelle (siehe „Besondere HL7-Sequenzen“). 

In Segment PV1.3 wird die Abteilung und die Station als „NURSE UNIT ^ ROOM ^ BED 

^ FACILITY ID ^ BED STATUS“ übertragen. Das Krankenhaus wird als zweistelliges Zeichen 

jeweils vor „NURSE UNIT“ und jeweils vor „FACILITY ID“ übertragen. 

2. Das Krankenhaus wird in Segment MSH.SENDING FACILITY kodiert 

Das Krankenhaus wird in Segment MSH.SENDING FACILITY (MSH.4) anstelle der Kennung 

für die sendende „Einrichtung“ übertragen. 

3. Das Krankenhaus wird in der HL7-Botschaft nicht kodiert 

Wählen Sie diese Variante nur, wenn immer sichergestellt ist, das alle mit HL7 übertragenen 

Abteilungen und Stationen nur zu einem Krankenhaus gehören. Cypro verwendet in diesem 

Fall für jede Abteilung/Station ein Krankenhaus mit der Kennung „0“. 

4. Das Krankenhaus UND die Abteilung wird in der HL7-Botschaft nicht kodiert 

Wählen Sie diese Variante nur, wenn immer sichergestellt ist, wenn Krankenhaus und Abteilung 

nicht in der HL7-Botschaft übertragen werden. Noch nicht in die Cypro-Stationsverwaltung 

eingetragene Stationen können mit dieser Option allerdings nicht automatisch in Cypro 

eingetragen werden, da das zugehörige Krankenhaus und die Abteilung nicht bekannt sind. 

Führende Nullen in Stationsbezeichnungen werden entfernt, wenn die ersten beiden Zeichen als 

Krankenhaus-Kennung dienen (Option „Das Krankenhaus wird in einem 2-stelligen Code als 

Bestandteil von Abteilung und Station übertragen: ^^^ 

“). 

Bewegungsnummer und Verlegungsdatum 










Wenn ein ZID-Segment gesendet wird, dann wird die Bewegungsnummer aus dem zweiten Feld 

dieses Segments gelesen. Wird ein ZBE-Segment gesendet wird, dann wird die Bewegungsnummer 

aus dem zweiten Feld des ZBE-Segments gelesen, ansonsten wird das erste Feld des PV1- 

Segments verwendet. 

Wenn ein ZID- oder ein ZBE-Segment gesendet wird, dann wird das Verlegungsdatum bei einer 

Patientenverlegung aus dem dritten Feld dieser Segmente gelesen, ansonsten wird das zweite 

Feld des EVN-Segments verwendet. 

Arzt-Informationen aus dem STF-Segment 

Die Arzt-Informationen in der HL7-Botschaft werden aus dem STF-Segment gelesen, wenn ein 

solches Segment übertragen wird. Ist das STF-Segment nicht vorhanden, werden die Information 

aus Feld PV1.7 verwendet. 

Die ID-Nummer des Arztes wird aus dem ersten Feld des STF-Segments ausgelesen. 

Krankenkassen-Informationen 


Cypro akzeptiert nur IN1-Segmente, wenn diese als Hauptversicherung deklariert sind (22. Feld 

des IN1-Segments='01'). Wenn es in der HL7-Botschaft keine Hauptversicherung gibt, dann wird 

nur das IN1-Segment mit leerer Segmentnummer (Feld IN1.1) oder mit „1“ als Segmentnummer 

verwendet. IN1-Segmente, die als „Selbstzahler“ deklariert sind (22. Feld des IN1-Segments='98') 

werden immer abgelehnt. 

Cypro akzeptiert nur IN1-Segmente, wenn diese als Hauptversicherung deklariert sind (22. Feld 

des IN1-Segments='01' oder Feld 15.2 des IN1-Segments='H'). Als Hauptversicherung wird auch 

ein IN1-Segment mit Feld 15.2 des IN1-Segments='H' angesehen. Wenn es in der HL7-Botschaft 

keine Hauptversicherung gibt, dann wird nur das IN1-Segment mit leerer Segmentnummer (Feld 

IN1.1) oder mit „1“ als Segmentnummer verwendet. IN1-Segmente, die als „Selbstzahler“ deklariert 

sind (22. Feld des IN1-Segments='98') werden immer abgelehnt. 

Das Gültigkeitsdatum der Versicherungs-Karte wird aus dem 13. Feld des IN1-Segments gelesen. 









Geschlecht und Patienten-Klasse/ Patientenstatus 

Als Wert für Geschlecht (Feld PID.8) sind neben den englischen auch die deutschen Abkürzungen 

zulässig: 

„F“ (female), „M“ (male), „O“ (other), „U“ (unknown), „W“ (weiblich), „M“ (männlich). 

Als Wert für die Patienten-Klasse/ Patientenstatus (Feld PV1.2) ist folgendes zulässig: 

„I“ oder „1“ (inbound), „O“ oder „2“ (outbound), „T“ oder „3“ (teilstationär), 

„S“ oder „4“ (stationär), „A“ (ambulant). 

Welche Felder dürfen nicht leer sein? 

Cypro benötigt bestimmte Felder in der HL7-Botschaft die nicht leer bleiben dürfen. Dies sind: 

1. Alle Felder im MSH-Segment außer ACCEPT ACKNOWLEDGEMENT TYPE und APPLICATI 

ON ACKNOWLEDGEMENT TYPE 

2. Die Felder EVENT TYPE CODE und DATE/TIME OF EVENT aus dem EVN-Segment 

3. Die Felder für Patient-ID, Name, Vorname, Geburtsdatum aus dem PID-Segment 

Anmerkung: Je nach Option, ist auch ein Betrieb ohne Vorname möglich (siehe „Leere Vornamen 

und unvollständiges Geburtsdatum”). 

4. Die Felder für Bewegungs-Nummer, Aufnahme-Nummer, Aufnahme-Zeitpunkt aus dem PV1- 

Segment 

Anmerkung: Je nach Option, ist auch ein Betrieb ohne Bewegungsnummer möglich (siehe 

„Warum benötigt Cypro eine Bewegungs-Nummer?”, ff.). 

Folgende Felder müssen eindeutig sein, d.h. sie dürfen nie doppelt vergeben werden: 

1. Patient-ID 

2. Bewegungs-Nummer 

3. Aufnahme-Nummer 

4. ID-Kennung für den Arzt 

5. Abkürzungen (ID-Kennung) für Krankenhaus, Abteilung, Station 










Konfiguration der Schnittstelle 

Alle Einstellungen für die HL7-Schnittstelle können in den Cypro-Optionen getroffen werden. Für 

die HL7-Konfiguration ist im Options-Programm eine Rubrik „HL7“ eingefügt worden. 

Hier kann, wie auch schon bereits erwähnt, eingestellt werden, welche HL7-Botschaften Cypro 

entgegennehmen soll (z.B. nur Produktionsdaten, nur Botschaften, die für ein bestimmtes Programm 

ausgeschickt werden). Ebenso kann hier eingestellt werden, ob und welche Art der ACK- 

Nachricht ausgeschickt werden soll. Sie finden diese Einstellungen auf der Seite „HL7“-„Allgemeines“. 

Die Optionen gelten nur lokal, d.h. die Optionen für die Schnittstelle wirken sich nur dann aus, 

wenn Sie auf dem Rechner eingestellt werden, auf dem die HL7-Schnittstelle aktiviert ist. 

Anbindung an den Krankenhaus-Kommunikationsserver 

Auf der Seite „HL7“-HL7-Server“ können die Einstellungen zur Anbindung an den Krankenhausinternen 

HL7-Kommunikationsserver gewählt werden (Port und Rechner-Name bzw. IP-Adresse). 

Cypro unterstützt 3 Betriebs-Modi: 

1. Eine ständige Verbindung zwischen der HL7-Schnittstelle und dem HL7-Server-Rechner (der 

Rechner, der die HL7-Botschaften aussendet) 

2. Ein Verbindungsaufbau erst dann, wenn der HL7-Server eine HL7-Botschaft aussendet 

3. HL7-Botschaften aus Dateien auslesen 


Wenn Sie keine ständige Verbindung zum HL7-Server herstellen, wird die Verbindung zur HL7- 

Schnittstelle vom HL7-Server erst dann aufgebaut, wenn eine HL7-Botschaft gesendet werden soll 

und im allgemeinen nach Erhalt der ACK-Meldung wieder abgebaut. 

Wenn Sie eine ständige Verbindung aufbauen, wird die Schnittstelle in den "Abhören"-Modus gesetzt. 

Wenn Sie eine ständige Verbindung einrichten möchten, wählen Sie die Option „Eine ständige 

Verbindung zwischen HL7-Schnittstelle und „HL7-Server" einrichten“. Sie benötigen nun den 

Port und den Rechner-Namen bzw. die IP-Adresse des HL7-Servers. 

Wenn Sie keine ständige Verbindung einrichten möchten (dies ist die Standard-Option), dann markieren 

Sie die obige Option nicht. Sie benötigen nun nur den Port des HL7-Servers. Auf dem HL7- 

Server müssen Sie nun natürlich beim aussendenden Programm den Rechner-Namen bzw. die 

IP-Adresse des Rechners mit der HL7-Schnittstelle angeben. 









HL7-Botschaften aus Dateien auslesen 

Cypro kann nicht nur HL7-Botschaften über eine Socket-Verbindung empfangen, sondern auch 

HL7-Botschaften aus Dateien auslesen. Es ist aber nur eine HL7-Botschaft pro Datei zulässig. 

Zum Auslesen der Dateien dient das Programm „Cypro-HL7-Server“. 

Um HL7-Botschaften aus Dateien auszulesen gehen Sie wie folgt vor: 

● Starten Sie die Cypro-HL7-Optionen über das Windows-Startmenü (Gruppe „Cypro“-“Cypro- 

Dienste“-“HL7-Schnittstelle“-“HL7-Optionen“), über das Programm „Dienst Status Informationen“ 

(Rechtsklick auf das farbige Kugelsymbol links neben der Uhrzeit-Anzeige auf der Windows-Leiste 

am unteren Bildschirmrand, Eintrag „HL7-Client“ - „Optionen“) oder über die Optionen 

im Cypro-Programm (Rubrik „HL7“). 

● Gehen Sie nun auf die Seite „HL7-Server“ und wählen Sie „Eine ständige Verbindung zwischen 

HL7-Schnittstelle und "HL7-Server" einrichten“ ab und dann „HL7-Botschaften aus 

Dateien auslesen“ aus. 

● Geben Sie den Port des HL7-Servers an (z.B. 29777). Der Cypro-HL7-Servers kommuniziert 

mit der HL7-Schnittstelle über eine lokale Socketverbindung. 

● Geben Sie die Datei-Erweiterung (Datei-Endung) der HL7-Dateien, aus denen die Botschaften 

gelesen werden, und den Pfad zum HL7-Verzeichnis an (hier befinden sich die HL7-Dateien). 

Wenn Sich das HL7-Verzeichnis auf einem externen Rechner befindet, müssen Sie einen lokalen 

Benutzer mit Passwort angeben, der Zugriff auf dieses Verzeichnis hat. Dies müssen Sie auch 

dann tun, wenn der aktuelle Windows-Benutzer ausreichende Zugriffsrechte besitzt, da der Cypro- 

HL7-Server aus einem lokalen Windows-Dienst heraus gestartet wird und ansonsten nur Zugriff 

auf den lokalen Rechner hat. Alternativ können Sie auch einen Benutzer aus einer Domäne angeben. 

Um den Datenbank-Server zu entlasten, können Sie ein Sende-Intervall angeben, nach dem die 

ausgelesen Botschaften an die HL7-Schnittstelle gesendet werden sollen (geben Sie in diesem 

Fall kein Zeit-Intervall für die HL7-Schnittstelle an (Seite „HL7-Client“), für den HL7-Wartungs- 

Modus, sollten Sie das aber natürlich tun). 

Der Cypro-HL7-Server führt folgendes aus: 


Die Botschaft wird aus der HL7-Datei ausgelesen und an die Cypro-HL7-Schnittstelle gesendet. 

Dann wird je nach Option (Seite „Allgemeines“-“ACK-Nachricht senden“) auf das Accept- und Application-Acknowledgement 

gewartet und ausgewertet. Falls die HL7-Botschaft von der HL7- 

Schnittstelle erfolgreich empfangen und in die Cypro-Datenbank gespeichert wurde, wird die HL7- 

Datei gelöscht. Wenn Sie nochmals gesendet werden soll (Accept- Acknowledgement = „CR“) 

wird die Botschaft einmalig neu gesendet. Wenn die Botschaft von der HL7-Schnittstelle immer 

noch nicht korrekt verarbeitet werden kann und weiterhin ein Neu-Senden gewünscht wird, dann 

wird die HL7-Datei mit angehängter ACK-Meldung in den Ordner „HL7_Receive_Error“ unterhalb 

des HL7-Verzeichnisses verschoben. Fehlerhafte HL7-Botschaften (Accept- Acknowledgement = 

„CE“ oder Application- Acknowledgement = „AE“) werden mit angehängter ACK-Meldung in den 









Ordner „HL7_Error“ unterhalb des HL7-Verzeichnisses verschoben. Cypro legt diese Ordner bei 

Bedarf an. Das heißt, der Cypro-HL7-Server benötigt Vollzugriff auf den HL7-Datei-Ordner. 

Nach dem Senden der Botschaften wartet der Cypro-HL7-Server mindestens die in den Optionen 

angebende Intervall-Zeit bis zum Senden der nächsten Botschaft, falls diese nicht durch das Warten 

auf die Acknowledgement-Meldungen überschritten wird. 

Für Test-Zwecke können Sie den Cypro-HL7-Server sichtbar schalten (Option „Sende und Empfangsdaten 

anzeigen“). 

Werden HL7-Botschaften aus Dateien gelesen und und ist der Cypro-HL7-beendet bzw. hat dieser 

keinen Zugriff auf den HL7-Datei-Ordner, so erscheint die HL7-Schnittstelle in der Dienst-Status- 

Information als deaktiviert (rotes Kugelsymbol). 

Die Cypro-HL7-Schnittstelle startet einen manuell beendeten Cypro-HL7-Server automatisch nach 

30 Sekunden wieder neu (natürlich nur dann, wenn HL7-Botschaften aus Dateien gelesen 

werden). 

Betriebsmodus der HL7-Schnittstelle festlegen 

Die Cypro-HL7-Schnittstelle unterstützt 2 Betriebsmodi, den Normalbetrieb und den Betrieb in 

hochfrequenten Nachrichtensystemen. 

Der Normalbetrieb 


Die eingehenden Daten werden von der HL7-Schnittstelle zunächst ausgewertet und dann als abzuarbeitende 

Aufgabe vermerkt. Sobald eine HL7-Nachricht als abzuarbeitende Aufgabe vermerkt 

ist, wird ein Zeitgeber aktiv, der nach einer bestimmten Zeit (normalerweise 1 Minute, einstellbar 

über die Cypro-Optionen) die aufbereitete HL7-Botschaft entgegennimmt und in die HL7- bzw. die 

Cypro-Patienten-Verwaltung einfügt. Sind währen dieser Verarbeitungszeit neue Aufgaben angefallen, 

so werden diese sofort wieder an das Verarbeitungs-System übergeben, ohne ein neues 

Zeitintervall (1 Minuten) abzuwarten. Gibt es jedoch keine neuen Aufgaben, so bleibt der Zeitgeber 

aktiv und kontrolliert nun ständig, ob neue Aufgaben zur Verarbeitung vorliegen. 

Sie können die eingehenden HL7-Botschaften aber auch sofort verarbeiten lassen. Stellen Sie 

dazu in den Option als Wert für das Zeit-Intervall „0“ ein (Optionen- Rubrik „HL7“-Seite „Allgemeines“- 

Option „Die eingehenden HL7-Botschaften immer nach diesem Zeit-Intervall in die 

HL7- bzw. die Cypro-Datenbank eintragen:“). Ein Zeit-Intervall größer als „0“ können Sie den 

Datenbank-Server entlasten, da es nun keine „dauerhaften“ Datenbank-Zugriffe gibt (dies ist z.B. 

dann der Fall, wenn alle 30 oder 60 Sekunden eine HL7-Botschaft an den Cypro-Server gesendet 

wird). 

Für den Normalbetrieb muss ein zeitverzögertes Accept-Acknowledgement eingestellt werden. 

Dies dient dazu die HL7-Schnittstelle zu entlasten, da die Krankenhaus-HL7-Server sofort nach 

Empfang der ACK-Meldung eine neue HL7-Botschaft versenden. 









Ein Zeit-Intervall größer als „0“ hat aber den Nachteil, das die eingehenden Botschaften erst zeitlich 

Verzögert an die Cypro-Datenbank weitergereicht werden. Bei der Einstellung des Zeit-Intervalls 

gilt es also zwischen Entlastung des Datenbank-Servers und zeitnaher Datenweitergabe abzuschätzen, 

dies ist natürlich vor allem von der Anzahl der empfangenen Daten und der generellen 

Leistungsfähigkeit der Servers abhängig. 

Betrieb in hochfrequenten Nachrichtensystemen 

Die HL7-Schnittstelle ist für den stabileren Betrieb in hochfrequenten HL7-Nachrichten-Systemen ( 

>= 1 Nachricht / 5 Sekunden, entspricht 3000-4000 Nachrichten/Tag) ausgerichtet. Um in diesen 

Betriebs-Modus zu wechseln, wählen Sie „Thread für den Empfang der HL7-Nachricht vom 

Thread für die Speicherung in der Cypro-Datenbank entkoppeln (empfohlen für hochfrequente 

Nachrichten-Systeme - >= 1 Nachricht / 5 Sekunden)“ in den Cypro-Optionen (Rubrik 

„HL7“- Seite „HL7-Client“). 

Bei diesem Modus wird die eingehende HL7-Nachricht nicht mehr im Arbeitsspeicher zwischengespeichert, 

sondern sofort als HL7-Rohdaten in die HL7-Datenbank gespeichert und dann nach 

dem mit der Option „Die eingehenden HL7-Botschaften immer nach diesem Zeit-Intervall in 

die HL7- bzw. die Cypro-Datenbank eintragen“ definierten Zeitintervall ausgelesen, verarbeitet 

und in die Cypro-Datenbank eingebaut. Diese Option dient dazu den Server-Rechner zu entlasten, 

damit nicht ständige Schreibzugriffe auf die Festplatte entstehen (Vorgabe : 1 Minute). 

Ein zeitverzögertes Accept-Acknowledgement ist nicht notwendig. Sie können den Vorgabewert 

(60 Sekunden) auf „0” setzen. Das zeitverzögertes Accept-Acknowledgement dient dazu die 

HL7-Schnittstelle zu entlasten, wenn die Option für den Betrieb in hochfrequenten HL7-Nachrichten-Systemen 

deaktiviert ist, da die Krankenhaus-HL7-Server sofort nach Empfang der ACK-Meldung 

eine neue HL7-Botschaft versenden. 

Wir empfehlen diesen Betriebs-Modus nicht nur für hochfrequente Nachrichten-Systeme, 

sondern auch für alle anderen einzustellen. 

Achtung: 

Bei dieser Option wird von der Cypro-HL7-Schnittstelle kein Application-Acknowledgement gesendet, 

eine entsprechende Option auf der Seite „Allgemeines" der HL7-Optionen wird ignoriert. 

Um in diesen Betriebsmodus zu wechseln, ist ein Neustart der HL7-Schnittstelle erforderlich. 

Die HL7-Datenbank 










Die HL7-Schnittstelle nimmt die Daten aller im Krankenhaus aufgenommen Patienten entgegen. 

Die onkologisch behandelten Patienten sind also nur ein Teil all dieser Patienten. Aus diesem 

Grund empfiehlt es sich die Cypro-Datenbank mit den onkologischen Patienten von der HL7-Datenbank 

mit allen Patienten abzutrennen und getrennte Datenbanken zu verwenden. Um eine getrennte 

(externe) Datenbank für die HL7-Daten zu verwenden, legen Sie diese in den Optionen auf 

der Seite „HL7“-„Datenablage“ fest und kreuzen Sie „Die externe HL7-Datenbank anstatt der 

Cypro-Datenbank verwenden“ an. Die Vorgabe Datenbank für eine externe Datenbank ist die 

Datei „Cypro_HL7.Cyp“ im Ordner „Database“ des Cypro-Installations-Ordners. Sie können diese 

Datenbank aber, genauso wie die Cypro-Datenbank „Cypro.Cyp“ auch in einen anderen Ordner 

legen. 

Werden getrennte Datenbanken verwendet, so kann die HL7-Datenbank auch auf einem externen 

„HL7-Server-Rechner“ installiert sein. In diesem Fall gibt es im Cypro-Netzwerk, dann zwei aktive 

Firebird-Datenbank-Server. So kann die CPU-Last einfach auf zwei getrennte Systeme verteilt 

werden. Entscheidend für die Geschwindigkeit der HL7-Schnittstelle ist zwar zum einen auch der 

Rechner auf dem die HL7-Schnittstelle läuft, aber vor allem der Rechner, auf dem sich die HL7- 

bzw. die Cypro-Datenbank befindet. Wenn es zwischen diesen Rechnern eine nur langsame Netzwerk-Verbindung 

gibt, ist natürlich dies das geschwindigkeits-entscheidende Moment. 

Die Log-Datei 

Cypro schreibt standardmäßig beim Starten, Beenden, Aktivieren, Deaktivieren, bei einer Änderung 

der Konfiguration (Port, Server-IP-Adresse, Aktualisierungszeit, Datenbank, Betriebsmodus) 

und bei jedem Fehler einen Eintrag in eine Log-Datei. Dieses Verhalten kann hier verändert werden. 

Die Log-Datei befindet sich im Cypro-Installations-Ordner („HL7.log“). 

Den Verlege-Status eines Patienten erkennen 


Das Verlegen eines Patienten wird bei HL7 durch eine A02-Botschaft signalisiert. Cypro kann jedoch 

auch bei jeder anderen HL7-Botschaft kontrollieren, ob der Patient verlegt worden ist. Wählen 

Sie diese Option, wenn nicht sicher ist, das Verlegungen auch über andere Botschaften stattfinden 

können. Wenn Sie aber sicher wissen, das Verlegungen nur mit A02-Botschaften signalisiert 

werden, dann schalten Sie diese Option aus. Die Schnittstelle spart somit bei jeder HL7-Botschaft 

das Auslesen der „alten“ Station und das Vergleichen mit der „neuen“. In Cypro bedeutet 

„Verlegen“ aber nicht nur eine Stations-Verlegung, sondern auch eine „Änderung“ des behandelnden 

Arztes. Werden durch A02-Botschaften nur Stations- aber keine „Arzt-Verlegungen“ abgedeckt, 

so aktivieren Sie die Option, bei allen HL7-Botschaften auf Verlegungen zu prüfen. Beim 

Verlegen eines Patienten wird in Cypro nicht nur Arzt und Station für den Patienten geändert, sondern 

auch Arzt und Station aller Rezepte für den Patienten ab dem Verlegungstag. 

Optionen im laufenden Betrieb der Schnittstelle ändern 










Im laufenden Betrieb der HL7-Schnittstelle kann die Datenbank-Verbindung nicht neu gesetzt werden, 

alle anderen Einstellungen aber schon. Möchten Sie eine bestehende Datenbank-Verbindung 

trennen und die Schnittstelle an eine andere Datenbank anbinden, dann müssen Sie die HL7- 

Schnittstelle beenden und dann neu starten. 

Wenn keine Verbindung zum Krankenhaus-HL7-Server oder zur Cypro-Datenbank hergestellt 

werden kann, dann wird das Options-Programm automatisch gestartet und die entsprechenden 

Einstellungen können getroffen werden. 









Die Inbetriebnahme der Schnittstelle 

Die Inbetriebnahme der 

Schnittstelle 

Voraussetzungen für die Inbetriebnahme der Schnittstelle 

Cypro findet alle Patienten in der HL7-Patienten-Verwaltung nur nach Patienten-ID. Um bestehende 

Patienten nachträglich in die HL7-Schnittstelle einzutragen ist es erforderlich in der Cypro- 

Patienten-Verwaltung die „Patienten-ID im Krankenhaus-Informations-System (KIS)“ für alle Patienten 

einzutragen und die Patienten dann in die HL7-Patienten-Verwaltung einzutragen. Dabei 

wird aber nur Name, Vorname, Geburtsdatum und Patienten-ID aus Cypro in die HL7-Verwaltung 

übernommen, keine Arzt-, Versicherungs-, Stations- und Aufnahmedaten (diese Daten wurden alle 

manuell eingefügt und entstammen nicht dem Krankenhaus-Informations-System). Dies reicht jedoch 

aus, um eine automatische Verknüpfung zwischen HL7- und Cypro-Patienten-Verwaltung 

über die Cypro-interne ID zu erstellen. Es ist dringend erforderlich die Patienten-ID richtig einzutragen, 

da ansonsten die Aktualisierung nicht richtig erfolgen kann. 

Zum Einfügen eines „Cypro-Patienten“ in die HL7-Patienten-Verwaltung gehen Sie bitte in die Cypro-Patienten-Verwaltung 

und klicken auf den Schalter „in HL7-Verwaltung einfügen“. Sie finden 

diesen Schalter in der Statusleiste rechts neben der Suchfeld-Auswahl. Ein Patient kann nur in die 

HL7-Patientenverwaltung eingefügt werden, wenn die Patienten-ID des KIS eingetragen ist. Sie 

sollten diese deswegen anzeigen (Optionen: Seite „Allgemeines“-„Allgemeines“- „auch die Patienten-Kennung 

des KIS eintragen“). 

Bereits in der HL7-Patienten-Verwaltung vorhandene Patienten werden nicht neu eingetragen, 

ebenso wird ein Patient nicht eingetragen, wenn es in der HL7-Patienten-Verwaltung bereits einen 

anderen Patienten mit der gleichen Patienten-ID gibt (in diesem Fall wäre die Patienten-ID des 

einzutragenden Patienten falsch). Sie können das Eintragen in die HL7-Patienten-Verwaltung 

auch für alle Cypro-Patienten auf einmal vornehmen. Klicken Sie dazu im Menü „Patient“ in der 

Hauptansicht auf den Eintrag „in HL7-Verwaltung einfügen“. Cypro ermittelt nun alle Patienten, 

bei denen eine Patienten-ID angegeben wurde und trägt diese in die HL7-Patienten-Verwaltung 

ein. Es gilt jedoch auch hier das bereits Erwähnte: schon vorhanden Patienten werden nicht doppelt 

eingetragen und es erfolgt keine Eintragung, wenn es bereits einen anderen Patienten mit 

gleicher Patienten-ID gibt. 

Während das Einfügen der bestehenden Patienten auch „nach und nach“ erfolgen kann (automatische 

Aktualisierungen finden dann aber nicht statt) ist es vor Inbetriebnahme der Schnittstelle 

dringend erforderlich die ID-Kennung für die Ärzte und die Abkürzungen für Krankenhaus, Abteilung 

und Station einzutragen. Es müssen keine neuen Stationen eingetragen werden, dies ist nur 

für bestehende Einträge erforderlich. Geschieht dies nicht, so fügt die HL7-Schnittstelle automatisch 

neue Stationen in die Stations-Verwaltung von Cypro ein, da keine Stationen mit der entsprechenden 

Abkürzung gefunden werden können. Im Grunde sind dies dann aber doppelte Einträge. 









Konfiguration von Cypro für HL7 

Neben Angabe der HL7-Datenbank (siehe „Die HL7-Datenbank”), benötigt Cypro lediglich die Angabe 

folgender Informationen: 

● Sind in einem Krankenhaus-Verbund Stations- und Abteilungs-Kürzel Krankenhaus-übergreifend 

eindeutig oder gelten Sie nur für das jeweils zugehörige Krankenhaus ? 

● Werden Stationen für verschiedene Abteilungen belegt ? 

● Sind leer Vornamen bei der Eingabe von Patienten erlaubt ? 


● Sind Arzt-ID-Kennung und Stations-Kürzel als Pflichtfelder einzugeben 

Dies sollte man auf jeden Fall setzen, beachten Sie dazu auch Kapitel “Wie werden Daten 

von Cypro gefunden?“ 

● Welche Standard-Such-Kriterien sollen beim Anzeigen der HL7-Patienten benutzt werden ? 










Die HL7-Schnittstelle starten, beenden und überwachen 

Das Dienst-Status-Informations-Programm dient zur Überwachung der HL7-Schnittstelle, des 

Cypro-Servers und des automatischen Backups. Zum Starten der Dienst-Status-Information wählen 

Sie den Punkt „Dienst Status Informationen“ aus der Gruppe „Cypro“ des Windows-Startmenüs. 

Nach dem Programmstart wird das Dienst-Status-Informations-Programm zu einem Symbol 

minimiert und als farbige Kugel links neben der Uhrzeit in der Windows-Task-Leiste angezeigt. 

Mit diesem Programm können Sie die einzelnen Dienste installieren, deinstallieren, starten und beenden, 

sowie alle Optionen einstellen (Eintrag „Dienst starten und beenden” im Kontextmenü 

des Symbols für das Dienst-Status-Informations-Programm). Mit „Installieren“ ist hier nicht die Installation 

von der Cypro-CD gemeint, sondern die Registrierung als Windows-Dienst im Betriebssystem. 

Das Beenden eines Dienstes gilt nur für die aktuelle Windows-Sitzung. Nach einem Neustart 

wird der Dienst wieder gestartet. Wenn Sie einen Cypro-Dienst dauerhaft beenden möchten, 

so müssen Sie den Dienst entweder deinstallieren oder in der Windows-Dienste-Verwaltung manuell 

deaktivieren. Die Dienst-Einstellungen können nur dann vorgenommen werden, wenn Sie 

über Administrator-Rechte verfügen (das gilt nicht für die Dienst-Optionen). 









Sie können einstellen, welcher Dienst überwacht werden soll. Klicken Sie dazu mit der rechten 

Maustaste auf das Symbol des Dienst-Status-Informations-Programms und dann auf den Eintrag 

„Optionen“. 

Das Dienst-Status-Informations-Programm verwendet folgendes Farbschema: 

� Graue Kugel : Keine Dienste werden überwacht 

� Rote Kugel : Kein überwachter Dienst ist gestartet oder aktiv 

� Gelbe Kugel : Einige der überwachten Dienste sind gestartet und aktiv 

� Grüne Kugel : Alle überwachten Dienst sind gestartet und aktiv 


Sie können das Dienst-Status-Informations-Programm genauso wie den Cypro-Schnellstarter 

auch automatisch mit Windows starten. Wählen Sie dazu den Eintrag „automatisch starten“ aus 

dem Kontextmenü (Rechtsklick auf das „Kugel“-Symbol). 

Alle hier beschrieben Einstellungen finden sie auch im Menü des Schalter „Dienste“ der Cypro- 

Schnellstart-Leiste. 









Eintragen von Daten in Cypro 

Wie werden HL7-Daten in die Cypro-Datenbank eingefügt? 

Sobald ein HL7-Patient als Cypro-Patient eingefügt wurde werden alle ankommenden HL7-Daten 

in die Cypro-Datenbank eingetragen. Neue Patienten über HL7 werden NICHT automatisch in die 

Cypro-Datenbank eingefügt. 

Cypro verwendet innerhalb der Cypro-Datenbank zwei getrennte Bereiche zur Verwaltung der 

HL7- und der Cypro-Patienten. Werden HL7-Botschaften an die Cypro-HL7-Schnittstelle gesendet, 

so werden diese zunächst in die HL7-Patienten-Verwaltung aufgenommen. Wenn ein solcher 

Patient allerdings als Cypro-Patient vorliegt, werden im Anschluss alle Daten auch an die Cypro- 

Patienten-Verwaltung übergeben. Wird ein Patient in Cypro verändert, so hat dies keinerlei Auswirkung 

auf die HL7-Patienten-Verwaltung, ebenso werden Löschvorgänge in Cypro nicht an die 

HL7-Patienten-Verwaltung übergeben. 

Beispiel: 

Der Patienten Udo Mustermann mit der Patienten-ID „123456“ existiert als „HL7-Patient“ in der 

HL7-Patienten-Verwaltung und wird nun in Cypro als „Cypro-Patient“ eingefügt. Cypro liest nun 

alle Werte für diesen Patienten aus (Patienten-Informationen, wie Name, Vorname, Geburtsdatum, 

Arzt, Station. Krankenkasse, Aufnahme- und Entlassungsdaten) und trägt diese in die Cypro- 

Datenbank ein. Noch nicht existierende Ärzte, Stationen und Krankenkassen werden automatisch 

in die Cypro-Datenbank eingefügt. Da die übertragenen Stations-, Abteilungs- und Krankenhaus- 

Informationen über HL7 nur Abkürzungen sind, trägt Cypro als Bezeichnung ebenfalls die Abkürzung 

ein. Die Bezeichnung kann später vom Benutzer in Cypro geändert werden. 

Der Patient wurde am „31.01.2004“ aufgenommen und ist nicht entlassen. Dieser Patient wird nun 

in der Cypro-Patienten-Verwaltung entlassen (Datum=“03.02.2004“). Diese Information wird von 

Cypro aber weder an die HL7-Patienten-Verwaltung noch an das Krankenhaus-Aufnahme-System 

weitergereicht. Über die HL7-Schnittstelle wird nun ebenfalls das Entlassungsdatum gesendet. 

Dieses ist aber der „02.02.2004“, so das die Information in Cypro aktualisiert wird. Wird der Patient 

nun aus Cypro gelöscht, so bleibt er weiterhin in der HL7-Patienten-Verwaltung bestehen, so dass 

er später mit allen inzwischen angefallenen Daten wieder in Cypro eingefügt werden kann. Bei gelöschten 

Patienten wird also nur die Verbindung zwischen HL7-Patienten-Verwaltung und Cypro- 

Patienten-Verwaltung getrennt. 

Speichern der empfangenen HL7-Botschaften 


Bei der Konfiguration der Schnittstelle für den Betrieb in hochfrequenten HL7-Nachrichten-Systemen 

werden auch die empfangenen Botschaften und nicht nur die aufbereiteten Werte gespeichert. 

Dies ist dann sinnvoll, wenn man erfahren möchte, ob und wann eine spezielle Botschaft an 

Cypro gesendet wurde. Wird die HL7-Schnittstelle beendet und danach neu gestartet, werden zunächst 

die noch nicht abgearbeiteten HL7-Botschaften aus der HL7-Datenbank ausgelesen und in 

die Cypro-Datenbank eingetragen. Gleichzeitig werden aber weiterhin die gesendeten HL7-Botschaften 

empfangen und verarbeitet. Es kommt so zu keinem Verlust von HL7-Botschaften 









Ist diese Option deaktiviert, so verbleiben die Botschaften nur bis zur Verarbeitung temporär im 

Arbeitsspeicher. Wenn die HL7-Schnittstelle beendet wird, werden die ausstehenden, noch nicht 

in der Cypro-Datenbank gespeicherten, Botschaften lokal gespeichert. Beim nächsten Start der 

Schnittstelle, werden zunächst die HL7-Botschaften aus der lokalen Datei („Maintenance.*“ im 

„Database“-Ordner der Cypro-Installation) ausgelesen und in die Cypro-Datenbank eingetragen. 

Auch hier kommt es zu keinem Verlust von HL7-Botschaften, da ebenfalls weiterhin die gesendeten 

HL7-Botschaften empfangen und verarbeitet werden. 

Wie werden die HL7-Daten ausgewertet? 

Cypro wertet bei der Aufbereitung der HL7-Nachrichten die übermittelte Bewegungs-Nummer aus. 

Wurde eine neue Bewegungs-Nummer übertragen oder bezieht sich die HL7-Botschaft auf die aktuelle 

Bewegungs-Nummer, so werden neben Arzt, Versicherungs- und Aufnahmedaten auch Patientendaten 

aktualisiert (zu den Patienten-Daten gehören neben Name, Anschrift, Geburtsdatum 

u.a. auch die Stationsinformationen). Bei einer alten Bewegungs-Nummer werden nur Aufnahme- 

und Entlassungsdaten verarbeitet. 

Cypro geht beim Auswerten der empfangenen Daten immer grundsätzlich von folgendem aus: 

1. Die empfangenden Informationen können in Cypro schon manuell eingegeben sein. 

2. Der Patient kann in Cypro schon existieren (er wurde manuell eingegeben), ohne als HL7-Patient 

deklariert zu sein. 

Im einzelnen geschieht folgendes: 


Cypro sucht die Daten mit der übertragenden Bewegungs-Nummer. Werden solche Daten gefunden, 

dann werden sie mit den neuen Daten aktualisiert. Werden keine Daten gefunden, dann 

sucht Cypro nach relevanten Kenngrößen, z.B. die Aufnahmenummer bei Aufnahme- und Entlassungsdaten. 

Die Daten einer bestehenden Aufnahme werden jedoch nur dann immer aktualisiert, wenn der 

Eintrag über die Bewegungs-Nummer gefunden wurde. Eine alte Bewegungs-Nummer kann niemals 

die Daten einer Aufnahme mit neuer Bewegungs-Nummer aktualisieren. Unabhängig davon 

werden aber immer die Aufnahmenummer angepasst, wenn folgendes gilt: 

1. Die Aufnahme-Nummer einer bestehenden Aufnahme mit einer alten Bewegungs-Nummer 

wird geändert. Existiert ein Entlassungs-Eintrag mit der selben Bewegungs-Nummer (das kann 

aber normalerweise nie sein, da eine Entlassung ein unabhängiger Vorgang ist), so wird die 

Aufnahme-Nummer der Entlassung ebenfalls geändert. 

2. Die Aufnahme-Nummer einer bestehenden Aufnahme mit einer alten Bewegungs-Nummer 

wird geändert. Existiert kein Entlassungs-Eintrag mit der selben Bewegungs-Nummer, aber ein 

Entlassungs-Eintrag mit der selben „alten“ Aufnahme-Nummer, so wird die Aufnahme-Nummer 

der Entlassung ebenfalls geändert, aber niemals andere Daten, wie z.B. Entlassungszeit. 









3. Die Aufnahme-Nummer einer bestehenden Entlassung mit einer alten Bewegungs-Nummer 

wird geändert. Existiert ein Aufnahme-Eintrag mit der selben Bewegungs-Nummer (das kann 

aber normalerweise nie sein, da eine Aufnahme ein unabhängiger Vorgang ist), so wird die 

Aufnahme-Nummer der Aufnahme ebenfalls geändert. 

4. Die Aufnahme-Nummer einer bestehenden Entlassung mit einer alten Bewegungs-Nummer 

wird geändert. Existiert kein Aufnahme-Eintrag mit der selben Bewegungs-Nummer, aber ein 

Aufnahme-Eintrag mit der selben „alten“ Aufnahme-Nummer, so wird die Aufnahme-Nummer 

der Aufnahme ebenfalls geändert, aber niemals andere Daten, wie z.B. Aufnahmezeit. 

Detaildaten wie Arzt und Versicherung sind unabhängig von der Bewegungs-Nummer und werden 

extern verwaltet. Cypro fügt nicht nur neue Versicherungen ein, sondern kann auch bestehende 

ändern (Änderung von Name und Kassen-Nr.), wobei aber immer nur eine Änderung zur Zeit 

möglich ist, da als Kenngröße für die Identifizierung einer Krankenkasse der Name und die Kassen-Nummer 

dienen. Bei einem Arzt dient als Identifizierung die Arzt-ID-Kennung. Wird Name und 

Vorname bei einem bestehenden Arzt geändert, so hat dies Auswirkungen auf alle Patienten. Der 

neue Arzt-Name wird nun nicht nur für den einen Patienten, sondern bei allen Patienten, die von 

diesem Arzt behandelt werden, angezeigt. 

Warum benötigt Cypro eine Bewegungs-Nummer? 


Auf SAP-basierende Informations-Systeme können „historische“ Nachrichten aussenden. So 

können z.B. ältere Nachrichten erst zeitlich nach den aktuellen Nachrichten gesendet werden. Um 

diese Nachrichten zeitlich sortieren zu können, werden Bewegungs-Nummern verwendet. Hiermit 

wird natürlich auch die Relevanz der Nachricht beschrieben. Patienten-Informationen aus älteren 

Nachrichten werden so verworfen, Aufnahmedaten aber verwendet. Mit Hilfe von Bewegungs- 

Nummern ist es auch möglich ganz gezielt ältere Nachrichten-Sätze zu verändern. 

Bei Krankenhaus-Informations-Systemen ohne „historische“ Nachrichten werden in der Regel keine 

Bewegungs-Nummern verwendet. In diesem Fall verwenden Sie die Option. „Keine Bewegungs-Nummer 

des Krankenhaus-Informations-Systems verwenden, sondern eigene Bewegungs-Nummern 

generieren“ (Optionen- Rubrik „HL7“-Seite „Allgemeines“), Cypro generiert so 

eigene Bewegungs-Nummern. 

Cypro benötigt zu korrekten Verarbeitung der HL7-Botschaften Bewegungs-Nummern, die im System 

eindeutig sind. Es darf keine Bewegungs-Nummer geben, die für einen anderen Vorgang, einem 

anderen Patienten oder einer anderen Aufnahme verwendet wird. 









HL7-Botschaften ohne Bewegungsnummer 


Cypro geht davon aus, daß es im Krankenhaus-Informationssystem Patienten gibt, die noch nicht 

in der Cypro-HL7-Patientenverwaltung eingetragen sind. Wird eine HL7-Nachricht an Cypro gesendet 

und ist der Patient noch nicht in der Cypro-Datenbank eingetragen, so wird dieser bei jeder 

Nachricht nachgetragen, auch z.B. bei A02 (Patient verlegen) - oder A13 (Entlassung stornieren) 

-Nachrichten. 

Für jeden Vorgang ist aber eine Bewegungsnummer notwendig. Cypro kann auch eigene Bewegungsnummern 

erzeugen, dies ist aber normalerweise nur für Systeme vorgesehen, die keine eigenen 

Bewegungsnummern erzeugen. 

Eine Besonderheit sind Botschaften, bei denen nur das PID-Segment übertragen wird. Bei einer 

solchen Botschaft wird keine Bewegungsnummer gesendet. Dies kommt immer vor, wenn auch 

das PV1-Segment nicht gefüllt ist und liegt i.d.R. daran, daß SAP IS-H je nach gewähltem Menüzweig 

des Anwenders und seiner Schnelligkeit ein SAP-Event „NP0201“ generiert, welches nur 

Patientendaten-Änderungen (ohne HL7-PV1 und Bewegungsnummer) oder auch Patienten- und 

Falldaten-Änderungen (mit HL7-PV1 und mit Bewegungsnummer) zuläßt. 

Bei einer solchen Botschaft ohne HL7-PV1 und Bewegungsnummer geht Cypro wie folgt vor: 

Wenn der Patient bereits in der HL7-Verwaltung von Cypro enthalten ist, wird der Datenstamm aktualisiert, 

die Bewegungsnummer aber nicht. Historische Nachrichten können weiterhin erkannt 

werden. 

Wenn der Patient noch nicht in der HL7-Verwaltung von Cypro enthalten ist, wird der Datenstamm 

aktualisiert, die Bewegungsnummer aber nicht. Cypro generiert eine eigene negative Bewegungsnummer, 

damit diese nicht mit den späteren Bewegungsnummern des SAP-Systems „kollidiert“. 

Eine darauffolgende Nachricht mit Bewegungsnummer führt immer zu einer Aktualisierung des 

Datenstamms, da zu diesem Zeitpunkt eine historische Nachricht noch nicht erkannt werden kann. 

Anmerkung: 

Cypro ignoriert normalerweise historische Nachrichten in Bezug auf die Patientendaten (Name, 

Geburtsdatum, Anschrift), aber nicht für Aufnahmedaten. 









Historische Nachrichten in einem Krankenhaus-Verbund 

Die HL7-Schnittstelle unterstützt das korrekte Erkennen von historischen Nachrichten in einem 

Krankenhaus-Verbund ohne einen einheitlichen Zahlenraum für Bewegungsnummern. 

In SAP-Systemen können historische HL7-Nachrichten versendet werden. Historische Daten sind 

Daten, die zeitlich älter sind als die aktuellen. Cypro erkennt diese historischen Nachrichten anhand 

der versendeten Bewegungsnummer. Bei historischen Nachrichten werden nur die Aufnahmedaten 

verwendet, die Patientendaten (Name, Versicherung, Station,...) werden ignoriert. 

In einem Krankenhaus-Verbund ohne einen einheitlichen Zahlenraum für Bewegungsnummern 

lassen sich historische Daten nicht ohne weiteres erkennen, da bei einer Verlegung des Patienten 

von einem Krankenhaus in ein anderes ein neuer Zahlenraum für Bewegungsnummern gültig wird. 

Beispiel für nicht „System-eindeutige" Bewegungsnummern : 


Ein Patient liegt im Krankenhaus „11“, die Aufnahmenummer ist „1101", die letzte Bewegungsnummern 

ist „001". Der Patient wird nun verlegt in das Krankenhaus „10“. Er wird dort neu aufgenommen 

mit der Aufnahmenummer „1001", die Bewegungsnummern ist „001". 

Cypro bildet bei Bewegungsnummern, die nicht „System-eindeutig" sind, sondern nur für die verwendeten 

Aufnahmen gelten, eine interne Cypro-Bewegungsnummer aus Aufnahme-Nummer und 

Bewegungsnummer. Die Cypro-Bewegungsnummer für den Patienten vor der Verlegung ist somit 

„1101001" und die Cypro-Bewegungsnummer für den Patienten nach der Verlegung ist 

„1001001". 

Beim Vergleich der Bewegungsnummern (die Bewegungsnummer nach der Verlegung ist kleiner 

als die vor der Verlegung) erscheint es so, als ob es sich bei der Verlegung um einen historischen 

Vorgang handelt, somit werden die Patientendaten (und auch die neue Station) des Patienten 

ignoriert, nicht aber die Aufnahmenummer. 

Um auch solche Daten korrekt als NICHT-historisch erkennen zu können, deaktivieren Sie die Option 

„In einem Krankenhaus-Verbund gibt es einen einheitlichen Zahlenraum für Bewegungs-Nummern“ 

(Rubrik „HL7“- Seite „HL7-Client“). Standardmäßig ist diese Option bereits deaktiviert. 

Wenn die Bewegungsnummern nicht „System-eindeutig" sind, sondern nur für die verwendeten 

Aufnahmen gelten, darf diese Option nur dann verwendet werden, wenn ein einheitlicher Zahlenraum 

für die Aufnahme-Nummern benutzt wird. 

Bei einem einheitlicher Zahlenraum beginnen alle Werte von einem gemeinsamen Startwert aus 

und sind fortlaufend. 









Beispiele: 

Nicht „System-eindeutige" Bewegungsnummer (interne Cypro-Bewegungsnummer ist zusammengesetzt 

aus Aufnahme-Nummer und Bewegungsnummer) mit einheitlichem Zahlenraum. 

Krankenhaus = „11", Aufnahme = „1101", Bewegung = „1101001" 


Nicht „System-eindeutige" Bewegungsnummer ohne einheitlichen Zahlenraum. 



Im unten stehenden Fall, gibt es für die beiden Krankenhäuser unterschiedliche Startwerte für die 

Aufnahme-Nummer. 

Deaktivieren Sie in diesem Fall die Option „In einem Krankenhaus-Verbund gibt es einen einheitlichen 

Zahlenraum für Bewegungs-Nummern“ und aktivieren Sie sie für den oben stehenden 

Fall. 

Wenn Cypro eigene Bewegungsnummern verwendet, wird diese Option ignoriert. 

Diese Option hat natürlich auch nur dann Auswirkung, wenn es in einem Krankenhaus-Verbund zu 

Verlegungen zwischen den einzelnen Krankenhäusern kommt. 

Wie werden Daten von Cypro gefunden? 


Cypro findet einen Patienten in der HL7-Patienten-Verwaltung immer nur über dessen Patienten- 

ID und in der Cypro-Patienten-Verwaltung über die interne Cypro-Patienten-ID. Ein Arzt und eine 

Station wird jedoch immer nur über dessen ID-Kennung gefunden. Wird die Arzt-ID-Kennung aus 

Cypro gelöscht oder verändert, dann geht Cypro davon aus das auch ein gleichnamiger Arzt eine 

andere Person ist und fügt diesen neu ein. Die Verknüpfung zwischen Patient aus der HL7-Patienten-Verwaltung 

und der Cypro-Patienten-Verwaltung geschieht über die interne Cypro-ID, so dass 

man hier die „Patienten-ID“ nachträglich ändern kann. Das ist natürlich nicht sinnvoll, da dies ein 

falscher Wert wäre. 

Da die HL7-Schnittstelle von einem dualen Eingabe-System ausgeht (Eingabe einmal über das 

HL7-System und einmal über Cypro), kontrolliert die Schnittstelle auch bei neuen Werten, ob dieser 

Eintrag nicht doch schon in Cypro vorhanden ist und aktualisiert dann den „Cypro-Eintrag“, obwohl 

ein Neu-Einfügen vom HL7-System gefordert wird. 









Aktualisierung bestehender Daten 

Automatische Aktualisierung der eingefügten Patienten 

Die HL7-Schnittstelle erhält laufend Daten vom Krankenhaus-Informations-System und reicht diese 

an alle Patienten in der HL7-Patienten-Verwaltung weiter. Wenn Sie „HL7-Patienten“ in den Cypro-Daten-Stamm 

eingefügt haben, werden die Daten aus dem Krankenhaus-Informations-System 

auch an die „Cypro-Patienten“ weitergereicht. Über die HL7-Schnittstelle werden folgende Patientendaten 

aktualisiert: 

Name, Vorname, Geburtsdatum, Anschrift, Staatsangehörigkeit, Station, Arzt, Aufnahmen, 

Krankenkasse. 

Die HL7-Schnittstelle kann folgende Aktionen durchführen: 

Patient neu aufnehmen 

Patient verlegen 

Patient entlassen 

Patientdaten ändern 

Neuaufnahme stornieren 

Verlegung stornieren 

Entlassung stornieren 

Beispiel: 


Sie haben einen Patienten „Mustermann“ aus der HL7-Verwaltung in die Cypro-Daten eingefügt. 

Dieser erscheint mit allen bislang aus dem Krankenhaus-Informations-System erhaltenen Daten 

(Name, Vorname, Geburtsdatum, Anschrift, Staatsangehörigkeit, Station, Aufnahmen). Wird dieser 

Patient nun z.B. entlassen, so ist dies auch direkt in Cypro mit Zeitpunkt sichtbar. 









Automatische Aktualisierung bei eigener Bearbeitung 

Sie können die Patientendaten auch selbst bearbeiten. Die HL7-Schnittstelle wird Ihre Änderungen 

allerdings bei Eintreffen von neuen HL7-Nachrichten wieder überschreiben. 

Beispiel: 

Sie haben die Anschrift des Patienten geändert von „Neue Strasse 17“ auf „Hauptstrasse 18“. 

Eine HL7-Nachricht trifft ein und macht Ihre Änderungen wieder rückgängig. 

Selbst eingefügte Aufnahmen in der Aufnahmeliste des Patienten, werden nicht ohne weiteres von 

der HL7-Schnittstelle aktualisiert. 

● Wenn jedoch die Aufnahme (Nummer, Datum) einer bestehenden Aufnahme, die durch die 

HL7-Schnittstelle eingefügt wurde, geändert wird, so werden die Änderungen von neuen HL7- 

Nachrichten wieder überschrieben. 

● Dies gilt auch für die Aufnahme-/Entlassungs-Zeit einer nicht durch HL7 eingefügten Aufnahme, 

wenn die Aufnahme-Nummer der „eigenen“ Aufnahme und die aus der HL7-Nachricht 

gleich sind. 

● Die HL7-Schnittstelle unterbindet das Löschen von Aufnahmen, wenn zu einer Aufnahme bereits 

Arztbriefe oder Herstellungen zugeordnet sind. In der Aufnahme-Liste wird dies durch eine 

rötliche Hintergrundfarbe angezeigt. 

Eigene Aufnahmen erscheinen mit einem roten Symbol, durch HL7 eingefügte Aufnahmen erscheinen 

ohne Symbol. 

Aktualisierung von eigenen Aufnahmen 


Bei Cypro-Systemen mit einer HL7-Schnittstelle, werden die Aufnahmedaten nicht mehr manuell 

eingepflegt, sondern automatisch über die Schnittstelle eingetragen. Wenn das zugrundeliegende 

Krankenhaus-Informations-System die Aufnahmedaten verspätet liefert, kann ein Patient zum Herstellungsdatum 

noch entlassen bzw. noch nicht aufgenommen sein. Eine Herstellung ist dann 

nicht möglich und die Aufnahme müßte manuell eingepflegt werden. 

Es ist in Cypro aber auch möglich, Patienten einzugeben, ohne diese aufzunehmen. Genauso 

kann für nicht aufgenommene Patienten hergestellt werden. 

Falls dies so nicht geschehen soll und nur für aufgenommene Patienten hergestellt werden soll, 

muß der Patient in Cypro manuell aufgenommen werden. Die korrekte Aufnahme-Nummer ist 

dann nicht bekannt und es muß eine „eigene“ Aufnahme-Nummer verwendet werden. 









Die HL7-Schnittstelle bemerkt eine eigene manuelle Aufnahme (angezeigt mit einem roten Symbol 

in der Patienten-Aufnahme-Liste) und überschreibt die LETZTE eigene Aufnahme unabhängig 

von der Aufnahme-Nummer mit einer neu eintreffenden „HL7-Aufnahme“. Das gilt aber nicht für 

Stornierungen von Aufnahmen (A11-Nachricht in HL7), d.h. eigene Aufnahmen werden nicht gelöscht. 

In den Cypro-Optionen kann eingestellt werden, ob diese Art der Daten-Aktualisierung generell 

stattfinden soll, und ob Stornierungen von Entlassungen (A13-Nachricht in HL7) genauso wie Stornierungen 

von Aufnahmen dabei nicht beachtet werden soll (Optionen - Seite „HL7“–„Spezielles”). 

Wenn eine eigene Aufnahme unabhängig von den Einstellungen in den Cypro-Optionen nicht 

durch die nächste HL7-Nachricht überschrieben werden soll, so kann man sie maskieren (Patienten-Verwaltung 

– Seite „Aufnahmedaten“ - Schalter „Änderung maskieren“). Die Aufnahme erscheint 

jetzt mit einem grünen Symbol. Mit Klick auf den Schalter „Maskierung aufheben“ wird 

die Maskierung wieder entfernt. 

Zusammenfassung: 


Cypro zeigt eigene Aufnahmen mit einem roten Symbol an, eigene maskierte Aufnahmen erscheinen 

mit einem grünen Symbol, durch die HL7-Schnittstelle eingefügte Aufnahmen werden ohne 

Symbol angezeigt. Wenn durch die HL7-Schnittstelle eingefügte Aufnahmen manuell geändert 

werden (Aufnahmenummer, Aufnahmedatum, Entlassen), so wird diese Aufnahme mit einen Türkis-Symbol 

angezeigt. 

Dieses Farbsymbol ist in der Patienten-Verwaltung auf der Seite „Aufnahmedaten“ und auf der 

Seite „Allgemeines“ links neben der Aufnahme-Nummer sichtbar. 









Aktualisierung von selbst eingegeben Patienten 

Wenn Sie einen Patienten mit Patienten-ID eingeben, aber nicht in die HL7-Daten einfügen (Patienten-Verwaltung 

– Seite „Allgemeindaten“ - Schalter „in HL7-Verwaltung einfügen“), dann wird 

dieser automatisch in die HL7-Daten-Verwaltung eingetragen und von der HL7-Schnittstelle aktualisiert, 

wenn eine HL7-Nachricht für einen Patienten mit gleicher Patienten-ID, unabhängig vom 

Namen, eintrifft. Der Patient mit dieser Patienten-ID darf aber noch nicht in der HL7-Verwaltung 

vorhanden sein. Deswegen empfiehlt es sich immer eigene Patienten mit korrekter Patienten-ID 

selbst in die HL7-Patienten-Verwaltung einzufügen. 

Beispiel: 


Sie fügen einen Patienten „Mustermann“ mit der Patient-ID „123456789“ in Cypro ein. Bei der 

nächsten HL7-Nachricht für den Patienten mit der ID „123456789“ wird der Cypro-Patient in die 

HL7-Verwaltung eingefügt und automatisch von HL7 aktualisiert, d.h., das Name, Vorname, etc, 

von HL7 überschrieben werden. 

Wenn Sie für einen Patienten herstellen möchten, der noch nicht im Krankenhaus-Informations- 

System vorhanden ist, dann müssen sie ihn selbst in Cypro eingegeben. Die Patienten-ID ist dann 

nicht bekannt. Lassen Sie in diesem Fall die Patienten-ID leer oder fügen Sie die Cypro-ID ein. Die 

HL7-Schnittstelle fügt diesen Patienten automatisch in die HL7-Patienten-Verwaltung ein, wenn 

eine HL7-Nachricht für einen Patienten mit gleichem Namen, Vornamen, Geburtsdatum, Krankenhaus, 

Abteilung und Station eintrifft und wenn der Cypro-Patient keine Patienten-ID besitzt 

oder als Patienten-ID die Cypro-ID eingetragen ist. Der HL7-Patient aus der HL7-Nachricht darf 

noch nicht in der HL7-Patienten-Verwaltung enthalten sein. 









Die Arbeit mit der HL7-Schnittstelle 

Durch die HL7-Schnittstelle entfällt das manuelle Eingeben von Patienten, sowie das Aufnehmen 

und Entlassen in Cypro. Dies ist aber auch weiterhin möglich. In diesem Kapitel sind die in den 

vorherigen Kapiteln beschriebenen Vorgangsweisen zur Arbeit mit der HL7-Schnittstelle zusammengefaßt. 

Einfügen eines Patienten in die HL7-Patienten-Verwaltung 

Klicken Sie auf den Schalter „in HL7-Verwaltung einfügen“ in der Patienten-Verwaltung. 

Alternativ können Sie auch den Menüpunkt „alle Patienten in HL7 einfügen“ im Menü „Patient“ 

der Hauptansicht. Hierdurch werden alle noch nicht in die HL7-Verwaltung aufgenommen Patienten 

dort eingefügt. 

Achtung: 

Die einzufügenden Patienten müssen eine korrekte Patienten-ID besitzen. Fügen Sie keine Patienten 

mit inkorrekter Patienten-ID ein. 

Sie brauchen neue Patienten, nur dann in die HL7-Patienten-Verwaltung einzutragen, wenn Sie 

Patienten manuell ohne HL7-Schnittstelle in Cypro eingetragen haben. 

Einfügen eines Patienten aus der HL7-Verwaltung 


Um einen Patienten aus der HL7-Verwaltung in Cypro einzufügen, wird der Dialog „HL7-Patienten 

[F2]“ aus der Patienten-Verwaltung verwendet. Der entsprechende Schalter befindet sich auch im 

Dialog „Patient bearbeiten“ und „Neuer Patient“. 

Die Standard-Suchkriterien der HL7-Patienten-Liste und der erweiterten Suche können in den 

Cypro-Optionen eingestellt werden (Seite „HL7“-„Cypro“). Sie können aber auch von der Patienten-Verwaltung 

und aus den Dialogen „HL7-Patienten“ und „erweiterte Suche“ schnell auf diese 

Optionen zugreifen. Dazu befindet sich in den genannten Dialogen ein Schalter „Optionen“. 

Für den Dialog „HL7-Patienten“ kann neben den Standard-Suchkriterien, eingestellt werden, ob 

Patienten kombiniert werden dürfen. Für die erweiterte Suche können nur die Standard-Suchkriterien 

eingestellt werden. Das neue Standard-Suchkriterium ist nun „Name, beginnt mit ...“. 









Im Dialog „HL7-Patienten“ werden nur die Schalter angezeigt, deren Funktion momentan zulässig 

ist. Aus der Hauptansicht ausgeführt sind alle Funktionen zulässig: 

● Patient einfügen (Schalter „Diesen Patienten einfügen“) 

● Daten des eingefügten Patienten bearbeiten (Schalter „Daten bearbeiten“) 

● HL7-Patienten mit dem aktuellen Patienten der Hauptansicht kombinieren (Schalter „Diese Patienten 

kombinieren“) 

● HL7-Patienten mit dem aktuellen Patienten der Hauptansicht kombinieren und dann die Patienten-Daten 

bearbeiten (Schalter „Patienten kombinieren + ändern“) 

Aus der Patienten-Verwaltung aufgerufen, können nur die Daten des eingefügten Patienten bearbeitet 

und der HL7-Patient mit dem aktuellen Patienten der Patienten-Verwaltung kombiniert und 

anschließend bearbeitet werden. Sichtbare Schalter sind also: 

● Schalter „Daten bearbeiten“ 

● Schalter „Patienten kombinieren + ändern“ 

Aus „Patientdaten ändern“ und aus „Neuer Patient“ aufgerufen (wenn der neue Patient gespeichert 

ist), kann nur der HL7-Patient mit dem aktuellen Patienten der Patienten-Verwaltung kombiniert 

und anschließend bearbeitet werden. Sichtbare Schalter sind also: 

● Schalter „Patienten kombinieren + ändern“ 

Vorgehensweise zum Einfügen eines Patienten aus HL7 


1. Klicken Sie auf den Schalter „HL7-Patienten“ in der Hauptansicht. Sie finden einen solchen 

Eintrag auch als Menüpunkt im Menü „Patient“ oder in der Patienten-Verwaltung (nicht bei 

„Patientdaten ändern“). Hier finden Sie diesen Befehl auch im Menü des Schalters „Patienten-Suche“. 

2. Geben Sie in der oberen Liste Suchkriterien für den „HL7-Patienten“ ein. Diese Kriterien sind 

genauso einzufügen, wie die Kriterien in der Cypro-Statistik. 

Standardmäßig werden hier immer „Name“, „Vorname“ und „Geburtsdatum“ anzeigt, Wünschen 

Sie weitere Kriterien, so klicken Sie auf den Plusschalter und dann in das Feld „Feld“. 

Nun wird die Liste aller möglichen Kriterien angezeigt. Wählen Sie das gewünschte Kriterium 

aus und geben dann als Freitext im Feld „Wert“ den Such-Wert ein. Spezielle Bedingungen 

können im Feld „Bedingung“ eingegeben werden. Ein leerer Eintrag bedeutet immer „gleich“. 

Mehrere Kriterien können mit bestimmten Verknüpfungen verbunden werden (Feld „Verknüpfung“). 

Ein leerer Eintrag bedeutet hier „UND“. Wenn Sie ein Kriterium wieder löschen möchten, 

dann markieren Sie den Eintrag und klicken dann auf den Minus-Schalter. Sie können 

auch vordefinierte Kriterien-Paare einfügen. Klicken Sie dazu auf den Schalter mit dem Datengitter 

neben dem X-Symbol. 









3. Wenn Sie alle Kriterien ausgefüllt haben, dann klicken Sie auf den Schalter „diese Patienten 

anzeigen“ oder betätigen den ENTER-Schalter. Cypro sucht nun in der HL7-Patienten-Verwaltung 

nach allen Patienten, die diese Kriterien erfüllen. 

Möchten Sie alle Patienten aus der HL7-Patienten-Verwaltung anzeigen, dann klicken Sie auf 

den Schalter „Alle Patienten anzeigen“. 

4. Wenn Sie mehrere Patienten gefunden haben, können Sie entweder die Kriterien weiter einschränken 

oder den Patienten aus der Liste manuell auswählen. 

Sie können die Liste der gefundenen Patienten nach bestimmten Kriterien (z.B. Name, Geburtsdatum) 

sortieren. Klicken Sie dazu auf den Sortier-Schalter links über der Patientenliste. 

Sie können auch in der Patienten-Liste nach bestimmten Einträgen suchen. Geben Sie dazu 

den Wert in das Suchfeld über der Patientenliste ein und wählen Sie in der Liste rechts daneben 

das Feld, in dem gesucht werden soll. 

5. Möchten Sie einen Patienten aus der Patienten-Liste in Cypro überführen, dann klicken Sie nun 

auf „Diesen Patienten einfügen“ oder auf „Patientdaten ändern“. Sie können einen Patienten 

auch mit Doppelklick auf den Listeneintrag einfügen. Beim Einfügen eines Patienten wird der 

Dialog verlassen und der neue Patient wird zum aktuellen Patienten in der Patientenliste der 

Hauptansicht. Mit „Patientdaten ändern“ wird in die Patienten-Verwaltung von Cypro zum Bearbeiten 

des eingefügten Patienten gewechselt. 

Achtung: 

Wenn Sie die HL7-Verwaltung von der Patienten-Verwaltung aus aufgerufen haben,können Sie 

nur im „Bearbeitungs-Modus“ bleiben. Der Schalter „Diesen Patienten einfügen“ wird nicht angezeigt. 

Achtung: 


In der HL7-Patienten-Liste werden nur die Patienten angezeigt, die aus der HL7-Patienten-Verwaltung 

noch nicht in die Cypro-Patienten-Verwaltung eingefügt wurden. Wenn ein eingefügter „HL7- 

Patient“ in Cypro wieder gelöscht wird, dann wird der Patient in der HL7-Patienten-Liste zum Neu- 

Einfügen wieder angezeigt. 

Es wird nur die aktuelle Aufnahme-Nummer angezeigt, ebenso sucht das Kriterium „Aufnahme- 

Nummer“ nur nach der aktuellen Aufnahme-Nummer. Wenn ein Patient entlassen ist, dann ist die 

Aufnahme-Nummer leer, obwohl ein Aufnahme und Entlassungs-Satz mit ausgefüllter Aufnahme- 

Nummer besteht. 

Die Schnellsuche in Cypro (ALT-F3 in der Hauptansicht oder entsprechender Menüeintrag im 

Menü „Patient“) ist mit der HL7-Patienten-Verwaltung verknüpft. Wenn die Schnellsuche keinen 

Patienten finden kann, dann wechselt Cypro mit den gewählten Kriterien der Schnellsuche in den 

Dialog “HL7-Patienten“. Zuvor fragt Cypro natürlich, ob jetzt bei den HL7-Patienten gesucht werden 

soll. 









Patienten aus Cypro mit Patienten aus HL7 kombinieren 

Sie können die Daten von Patienten aus Cypro mit den aus der HL7-Patienten-Verwaltung zusammenfassen. 

Dabei werden alle Daten des Cypro-Patienten (Name, Vorname, Geburtsdatum, Anschrift, 

Station...) überschrieben. Die Aufnahmen des Cypro-Patienten werden bei einer gleichen 

Aufnahme-Nummer überschrieben, ansonsten bleiben die Aufnahmen des Cypro-Patienten bestehen 

und die des HL7-Patienten werden eingefügt. 

Der Cypro-Patient darf nicht von der HL7-Schnittstelle eingefügt worden sein, der HL7-Patient darf 

nicht als andere Cypro-Patient eingefügt worden sein oder mit einem anderen Cypro-Patienten 

kombiniert worden sein. 

Nach dem Kombinieren ist der Cypro-Patient in die HL7-Patienten-Verwaltung eingefügt und wird 

anschließend von der HL7-Schnittstelle bei Eintreffen von HL7-Nachrichten automatisch aktualisiert. 

Sie können die Möglichkeit, Patienten kombinieren zu können, in den Optionen deaktivieren (Optionen 

- Seite „HL7“ – „Cypro”), dies ist standardmäßig der Fall. 

ACHTUNG: 

Das Kombinieren überschreibt alle Patienten-Daten des aktuellen Patienten. Dies ist genauso, als 

ob Sie alle Daten des Patienten neu überschreiben würden. 

Vorgehensweise zum Kombinieren von Patienten 


1. Klicken Sie auf den Schalter „HL7-Patienten“ in der Hauptansicht. Sie finden einen solchen 

Eintrag auch als Menüpunkt im Menü „Patient“ oder in der Patienten-Verwaltung. 

2. Geben Sie in der oberen Liste Suchkriterien für den „HL7-Patienten“ ein. Diese Kriterien sind 

genauso einzufügen, wie die Kriterien in der Cypro-Statistik. 

3. Wenn Sie alle Kriterien ausgefüllt haben, dann klicken Sie auf den Schalter „diese Patienten 

anzeigen“ oder betätigen den ENTER-Schalter. Cypro sucht nun in der HL7-Patienten-Verwaltung 

nach allen Patienten, die diese Kriterien erfüllen. Möchten Sie alle Patienten aus der HL7- 

Patienten-Verwaltung anzeigen, dann klicken Sie auf den Schalter „Alle Patienten anzeigen“. 

4. Wenn Sie mehrere Patienten gefunden haben, können Sie entweder die Kriterien weiter einschränken 

oder den Patienten aus der Liste manuell auswählen. 

5. Möchten Sie einen Patienten aus der Patienten-Liste in Cypro überführen, dann klicken Sie nun 

auf „Diese Patienten kombinieren“ oder auf „Patienten kombinieren + ändern“. Beim Kombinieren 

von Patienten wird der Dialog verlassen, ohne den aktuellen Patienten in der Hauptansicht 

zu wechseln. Mit „Patienten kombinieren + ändern“ wird in die Patienten-Verwaltung von 

Cypro zum Bearbeiten des kombinierten Patienten gewechselt. 










Verhindern, dass die HL7-Schnittstelle eigene Aufnahmen, 

automatisch mit neuen Werten überschreibt 

Wählen Sie in den Cypro-Optionen den Punkt „Aktualisierung eigener Aufnahmen/Patienten“ - 

„Eigene Aufnahmen durch die nächste eintreffende HL7-Botschaft aktualisieren“ ab (Seite 

„HL7“ - „Spezielles“). 

Alternativ können Sie auch eine spezielle Aufnahme von der Aktualisierung ausschließen, Dazu 

wählen Sie die Aufnahme in der Aufnahme-Liste der Patienten-Verwaltung und klicken auf den 

Schalter „Änderung maskieren“. Die Aufnahme erscheint jetzt mit einem grünen Symbol. Mit 

Klick auf den Schalter „Maskierung aufheben“ wird die Maskierung wieder entfernen. 

Verhindern, dass die HL7-Schnittstelle eigene Patienten, 

automatisch mit neuen Werten überschreibt 

Wählen Sie in den Cypro-Optionen den Punkt „Selbst eingegebene Patienten ohne Patienten- 

ID oder mit Cypro-ID als Patienten-ID, automatisch mit einem HL7-Patienten verknüpfen, 

wenn Name, Vorname, Geburtstag, Krankenhaus, Abteilung und Station vollständig übereinstimmen“ 

ab (Seite „HL7“ - „Spezielles“). 









HL7-Testdaten 

Im folgenden sehen Sie beispielhafte HL7-Botschaften, so wie sie von Cypro erwartet werden. 

Die Bewegungs-Nummer wird vom Krankenhaus-Informations-System übertragen (PV1.1) und 

das Krankenhaus wird in einem 2-stelligen Code als Bestandteil von Abteilung und Station übertragen. 

Einen Patienten mit einer A01-Botschaft aufnehmen: 

MSH|^~\&|SAP_ISH|0011|CYPRO|CYPRO|20040603163103||ADT^A01|01341624|P|2.2|||AL||DE 

EVN|A01|200406031632 

PID|||0039546724||Mustermann^Hans||19111111|M|||Alte Strasse 27^^Musterhausen^^22453^ 

DE||0179/1234567|0178/12345678||||||||||||DE 

PV1|0127895||110102^^^1101||||0000600787^Tester^Hans A.^^^^Dr.med.|||||||||||| 

1121976002|||||||||||||||||||||||||20040603160000 

IN1|||123456789|AOK Hamburg||||||||||||||||||||||||||||||||078565| 

Die Daten eines bestehenden Patienten mit einer A08-Botschaft aktualisieren: 


EVN|A08|200406041632 

PID|||0039546724||Mustermann^Hans||19111111|M|||Neue Strasse 17^^Musterhausen^^22453^ 

DE||0179/1234567|0178/12345678||||||||||||DE 


1121976002|||||||||||| |||||||||||||20040603160000 

IN1|||123456789|AOK Hamburg||||||||||||||||||||||||||||||||078565| 

Einen Patienten mit einer A02-Botschaft verlegen: 


EVN|A02|200406051632 


DE||0179/1234567|0178/12345678||||||||||||DE 


1121976002|||||||||||| |||||||||||||20040603160000 

IN1|||123456789|AOK Hamburg||||||||||||||||||||||||||||||||078565| 

HL7-Testdaten 









Einen Patienten mit einer A03-Botschaft entlassen: 


EVN|A03|200406161632 


DE||0179/1234567|0178/12345678||||||||||||DE 


1121976002|||||||||||| |||||||||||||20040603160000|200406161625 

IN1|||123456789|AOK Hamburg||||||||||||||||||||||||||||||||078565| 

HL7-Testdaten

Die Hl7-Schnittstelle in Cypro

Sie wollen auch ein ePaper? Erhöhen Sie die Reichweite Ihrer Titel.

Template löschen?

Als Template speichern?