Dateibasierte AIS-Importschnittstelle

Die dateibasierte AIS-Importschnittstelle dient zur Übertragung von Patientendaten aus einem Arztinformationssystem (AIS) zu labcomplete®. Zum Austausch der Daten wird eine Datei in das Dateisystem (Lokal oder Netzlaufwerk) abgelegt.

info

Dieses Dokument dient als technische Beschreibung für Hersteller bzw. Entwickler von AIS-Software.

Allgemeines

• Die Datei muss in ANSI oder UTF-8 Kodierung generiert werden.
• Jeder Schlüssel darf maximal einmal vorkommen.
• Schlüssel-Wert-Paare müssen in eine Zeile geschrieben werden, es sind keine Zeilenumbrüche erlaubt.
• Die Patientendaten werden in eine Textdatei ins Dateisystem geschrieben. Der Pfad dafür ist konfigurierbar, bevorzugt ist C:\Medcom\import\import.txt (Windows).
• Es sollte vom AIS zuerst eine temporäre Datei erstellt werden, die dann in den Zielpfad verschoben wird, um Leseoperationen mit unvollständigen Daten (Race Conditions) zu vermeiden. Ein Stream der Daten direkt in die Zieldatei sollte vermieden werden.

Sequenzdiagramm

Multi-User Betrieb

Möchten sich mehrere Ärzte mit jeweils eigenen Stammdaten einen Benutzer teilen, um sich z.B. in Gruppenpraxen nicht ummelden zu müssen, kann zusätzlich über den Eintrag X-Arzt= eine ID für jeden Arzt übergeben werden. Beim Einlesen dieser ID öffnet sich in labcomplete® automatisch der richtige Zuweiser.

Schlüssel & Werte

Schlüssel	Typ	Pflichtfeld	Kommentar	Beispiel
P-Id	String	❌	ID des Patienten im AIS	P-Id=8041
P-Zuname	String	✅		P-Zuname=TestNachname
P-Vorname	String	✅		P-Vorname=TestVorname
P-Titel	String	❌		P-Titel=Mag.
P-Gebdat	Date	✅	Format yyyyMMdd	P-Gebdat=19440404
P-Geschlecht	Enum	✅	M oder W	P-Geschlecht=W
P-VersNr	String	❌	Wenn nicht versichert bzw. Privat, dann Leerstring übergeben. Ansonsten muss eine gültige 10-stellige Versicherungsnummer übergeben werden.	P-VersNr=1382290182
P-Telefon	String	❌	Sollte keine Leerzeichen, jedoch die internationale Vorwahl enthalten	P-Telefon=+43666777888
P-Email	String	❌	Wenn angegeben, dann muss der Wert eine gültige E-Mail-Adresse sein	P-Email=me@example.org
P-Land	String	❌	Bei keiner Angabe wird automatisch AT angenommen	P-Land=A
P-Plz	String	❌	Muss angegeben werden, um Privatverrechnung an den Patient zu aktivieren	P-Plz=5020
P-Ort	String	❌	Muss angegeben werden, um Privatverrechnung an den Patient zu aktivieren	P-Ort=Salzburg
P-Strasse	String	❌	Muss angegeben werden, um Privatverrechnung an den Patient zu aktivieren	P-Strasse=Teststr. 1
X-Kasse	String	❌	Kassencode vom Hauptverband der Sozialversicherungsträger. Wenn nicht versichert bzw. Privat, dann Leerstring übergeben	X-Kasse=41
X-Kasse-Text	String	❌		X-Kasse-Text=WGKK
X-Vgr	String	❌	Versicherten-Kategorie	X-Vgr=5
X-Vgr-Text	String	❌		X-Vgr-Text=Pen.
X-Arzt	String	❌	Für Multi-User Betrieb	X-Arzt=ME123456
V-Id	String	❌	ID des Versicherten im AIS	V-Id=7787
V-Zuname	String	✅	Pflichtfeld nur, wenn der Patient mitversichert ist.	V-Zuname=TestNachnameMitversichert
V-Vorname	String	✅	Pflichtfeld nur, wenn der Patient mitversichert ist.	V-Vorname=TestVornameMitversichert
V-Titel	String	❌		V-Titel=Mag.
V-Gebdat	Date	✅	Pflichtfeld nur, wenn der Patient mitversichert ist. Format yyyyMMdd	V-Gebdat=19440404
V-Geschlecht	Enum	✅	Pflichtfeld nur, wenn der Patient mitversichert ist. M oder W	V-Geschlecht=W
V-VersNr	String	✅	Pflichtfeld nur, wenn der Patient mitversichert ist. Wenn mitversichert muss eine gültige 10-stellige Versicherungsnummer übergeben werden.	V-VersNr=1382290182
V-Gebfrei	Boolean	❌	Noder J	V-Gebfrei=N
V-Telefon	String	❌	Sollte keine Leerzeichen, jedoch die internationale Vorwahl enthalten	V-Telefon=+43666777888
V-Email	String	❌	Wenn angegeben, dann muss der Wert eine gültige E-Mail-Adresse sein	V-Email=me@example.org
V-Land	String	❌	Bei keiner Angabe wird automatisch AT angenommen	V-Land=A
V-Plz	String	❌	Muss angegeben werden, um Privatverrechnung an den Patient zu aktivieren	V-Plz=5020
V-Ort	String	❌	Muss angegeben werden, um Privatverrechnung an den Patient zu aktivieren	V-Ort=Salzburg
V-Strasse	String	❌	Muss angegeben werden, um Privatverrechnung an den Patient zu aktivieren	V-Strasse=Teststr. 1
Dgn-1, Dgn-2, ...	String	❌	Enthalten jeweils eine Diagnose aus der Patientenkartei, wobei 1 ein numerischer Wert ist, der je nach Anzahl der Diagnosen einfach inkrementiert wird.	Dgn-1=Diabetes Mellitus
L-Werte	String	❌	Die übergebenen Parameter müssen mit den Parameterkurzbezeichnungen in labcomplete® übereinstimmen. Achtung: Parameterkurzbezeichnungen in labcomplete® müssen nicht mit den von Labors über Befunde übermittelten Kurzbezeichnungen für Parameter übereinstimmen! Mehrere Werte werden durch Beistrich getrennt. Leerzeichen werden ignoriert.	L-Werte=GGT, GOT
L-Vorlage	String	❌	Profile müssen in labcomplete® definiert sein, um vom AIS übernommen werden zu können. Es kann maximal 1 Profil übernommen werden. Leerzeichen sind erlaubt.	L-Vorlage=Profil 1
Out-Pdf	String	❌	Hier kann ein absoluter Dateipfad für den AIS-Rückimport des Überweisungszettels in Form eines PDF-Dokuments angegeben werden.	Out-Pdf=C:/Medcom/Ais-Export/2024-01-01-1234.pdf

Beispiele

Patient ist Hauptversicherter

import.txt

P-Id=450000003
P-Zuname=P-Nachname
P-Vorname=P-Vorname
P-Titel=
P-Gebdat=19820129
P-Geschlecht=M
P-VersNr=1382290182
P-Gebfrei=N
P-Telefon=004318693658
P-Land=A
P-Plz=8230
P-Ort=Testort
P-Strasse=Teststrasse 123
X-Arzt=500012
X-Kasse=4F
X-Vgr=1
X-Vgr-Text=Erwerbstätige
V-Zuname=
V-Vorname=
V-Titel=
V-Gebdat=
V-Geschlecht=
V-VersNr=
Dgn-1=AIS Diagnose 1
Dgn-2=AIS Diagnose 2
L-Werte=GGT, GOT
L-Vorlage=Profil 1

Patient ist mitversichert

import.txt

P-Id=450000003
P-Zuname=MitversicherterNachname
P-Vorname=MitversicherterVorname
P-Titel=
P-Gebdat=19820129
P-Geschlecht=M
P-VersNr=1382290182
P-Gebfrei=N
P-Telefon=004318693658
P-Land=A
P-Plz=8230
P-Ort=Testort
P-Strasse=Teststrasse 123
X-Arzt=ArztId
X-Kasse=15
X-Vgr=1
X-Vgr-Text=Erwerbstätige
V-Zuname=HauptversicherterNachname
V-Vorname=HauptversicherterVorname
V-Titel=
V-Gebdat=19800101
V-Geschlecht=M
V-VersNr=1234
Dgn-1=AIS Diagnose 1
Dgn-2=AIS Diagnose 2