Labor-Anbindung: Wie ein Laborbericht in HL7 v2, CSV oder JSON mit einer Anfrage zu FHIR Observations wird

Ein Labor hat bei einer Integration eine Aufgabe: den Bericht in die Patientenakte zu bekommen, ohne abzutippen, ohne den Referenzbereich zu verlieren und ohne ein Format zu erfinden, das niemand sonst liest. Der Anpheros Labor-Konnektor nimmt den Bericht so, wie das Labor ihn bereits erstellt, HL7 v2, CSV oder JSON, und wandelt jedes Ergebnis in eine FHIR Observation mit einem LOINC-Code, einer Einheit, einem Referenzbereich, einem Datum und dem Labor als Leistungserbringer um. Diese Anleitung ist der Vertrag.

Technische Version für Entwickler: Labor-Konnektor · API für Laborergebnisse auf developers.anpheros.com, mit Anfragen, Antworten und Limits. Diese Seite ist die Version in einfacher Sprache.

Eine Anfrage

POST /v1/patients/{patient_id}/labs/import
Authorization: Bearer <project key>
Content-Type: text/csv | x-application/hl7-v2+er7 | application/json
X-Anpheros-Source-System: labx        (optional; wird in Provenance aufgezeichnet)
Idempotency-Key: <report id>          (optional; ein erneuter Versuch liefert die gleiche Antwort)

Die Antwort sagt, was passiert ist:

{"created": 3, "skipped": 0, "unmapped": ["Marker sehr selten"], "warnings": [],
 "observations": [{"id": "…", "marker": "TSH", "code": "3016-3", "system": "http://loinc.org",
                   "value": 2.1, "unit": "mUI/L", "date": "2026-09-01"}]}

Formate

HL7 v2 ORU^R01, als ER7-Text. OBX-3 ist die Kennung (code^text^LN ist LOINC; ein lokaler Code wird als eigener Code des Labors beibehalten), OBX-5 der Wert, OBX-6 die Einheit, OBX-7 der Referenzbereich, OBX-8 das abnormale Flag (wird zu interpretation), OBX-11 der Status, OBX-14 oder OBR-7 das Datum. MSH-4 nennt die sendende Einrichtung, die zum Leistungserbringer wird; OBR-3 und MSH-10 werden zur Berichts-ID in Provenance. Ausstehende, gelöschte oder falsche Ergebnisse (I, X, D, W) und OBX-Segmente ohne Wert werden nicht zu Observations und werden in warnings genannt.

CSV mit einer Kopfzeile; Trennzeichen , ; oder Tabulator, Dezimalkomma akzeptiert, Datenformate ISO, DD.MM.YYYY oder DD/MM/YYYY. Erkannte Spalten auf Rumänisch oder Englisch: marker, value, unit, reference range (70-100, <5, >3.5) oder ref_low/ref_high, date, optional LOINC code, note. Eine CSV-Datei enthält kein Labor, daher fehlt der Leistungserbringer, es sei denn, Sie senden X-Anpheros-Acting-As.

Analiza;Rezultat;UM;Interval de referinta;Data
Hemoglobina glicozilata (HbA1c);6,4;%;4,0-5,6;01.09.2026
TSH;2,1;mUI/L;0,4-4,0;01.09.2026

JSON, wenn Sie bereits strukturierte Daten haben: {"date": "2026-09-01", "origin": "report-77", "laboratory": "Synevo", "items": [{"marker": "TSH", "value": 2.1, "unit": "mUI/L", "ref_low": 0.4, "ref_high": 4.0, "code": "3016-3"}]}.

Zu beachtende Zuordnungsregeln

• LOINC, wenn angegeben, sonst nach Namen. Namen werden mit LOINC-Namen und Synonymen auf Rumänisch und Englisch abgeglichen. Ein Name, der mehreren Konzepten entspricht oder einen Zusatz trägt, den das Konzept nicht hat (Urin, non-HDL, frei, Verhältnis), wird nicht erraten: Er behält den Code des Labors unter urn:anpheros:lab-code und erscheint in unmapped, damit Sie die Zuordnung auf Ihrer Seite verbessern können. Senden Sie LOINC-Codes, wann immer Sie welche haben.
• Werte werden niemals umgerechnet. Harnstoff und Harnstoff-Stickstoff sind unterschiedliche Codes; LDL direkt und LDL berechnet sind unterschiedliche Codes; Glukose aus Serum und aus Kapillarblut sind unterschiedliche Codes. Der Konnektor wählt den richtigen anhand des Namens und der Methode und lässt die Zahl unverändert.
• Zeiten behalten ihre Zeitzone. Eine v2-Zeit mit einem Offset wird beibehalten; ohne einen wird der Offset von MSH-7 mit einer Warnung verwendet; wenn überall keiner vorhanden ist, wird nur das Datum gespeichert. CSV-Zeiten haben keine Zeitzone und werden als Daten gespeichert.
• Idempotent. Senden Sie denselben Bericht zweimal mit demselben Idempotency-Key und Sie erhalten dieselbe Antwort und keine Duplikate.
• Provenance bei jedem Ergebnis: das Quellsystem, die Berichts-ID und der Leistungserbringer, wie es der HL7 Europe Laboratory Report vorschreibt.

Was der Patient sieht

Die Ergebnisse erscheinen in der Akte der Person und, wenn sie Anpheros Daily nutzen, auf ihrem Handy, sobald sie eintreffen, mit dem Referenzbereich und dem Trend über frühere Berichte. Nichts zum Scannen, nichts zum Abtippen. Wenn ein Ergebnis abnormal ist, sieht die Person das Flag; die App interpretiert es nicht.

Testen

Die Sandbox ist kostenlos und die synthetischen Patienten haben bereits eine Laborhistorie. Senden Sie einen Bericht an einen von ihnen und lesen Sie ihn zurück:

curl -X POST "$BASE/v1/patients/$PID/labs/import" -H "Authorization: Bearer $KEY" \
     -H "Content-Type: text/csv" --data-binary @report.csv
curl "$BASE/fhir/R4/Observation?patient=$PID&category=laboratory&_sort=-date" -H "Authorization: Bearer $KEY"

Die vollständige Spezifikation, einschließlich der HL7 Europe Konformitätsnotizen, finden Sie unter developers.anpheros.com/guides/lab-connector.

Häufige Fragen

Müssen wir ändern, was unser LIS produziert?

Nein. Senden Sie die ORU^R01-Nachricht oder den CSV-Export, wie er ist. Wenn Sie LOINC-Codes hinzufügen können, tun Sie es; andernfalls ordnet der Konnektor nach Namen zu und teilt Ihnen mit, was er nicht zuordnen konnte.

Was passiert mit Ergebnissen, die Sie nicht zuordnen können?

Sie werden mit dem eigenen Code des Labors und dem exakten Text aus dem Bericht gespeichert, sodass nichts verloren geht, und in unmapped aufgeführt, damit Sie beim nächsten Mal einen LOINC-Code hinzufügen können.

Werden Referenzbereiche und abnormale Flags beibehalten?

Ja: Der Bereich geht zu referenceRange, das Flag zu interpretation, die Einheit wird als UCUM gespeichert und der Wert wird niemals umgerechnet.

Kann ein Labor Ergebnisse für einen Patienten senden, den es nicht erstellt hat?

Nur mit der Zustimmung der Person oder als die Organisation, für die das Projekt handelt, mit X-Anpheros-Acting-As. Ein Projekt sieht die von ihm erstellten Patienten; alles andere erfordert eine Genehmigung.

Gibt es Kosten für die Integration?

Die Sandbox ist kostenlos. Die Produktion beginnt bei 49 € pro Monat pro Organisation, wobei der erste Monat kostenlos ist; siehe Preise.