Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

API εργαστηριακών αποτελεσμάτων: HL7 v2, FHIR και LOINC

Πώς ταξιδεύουν τα εργαστηριακά αποτελέσματα ως δεδομένα HL7 v2 και FHIR R4, τι πρέπει να περιέχει ένα αποτέλεσμα, και πώς να λάβετε εργαστηριακές αναφορές σε ένα αρχείο FHIR, με ένα πραγματικό παράδειγμα.

Ένα API αποτελεσμάτων εργαστηρίου παραδίδει τα αποτελέσματα εργαστηρίου ως δομημένα δεδομένα — κωδικός εξέτασης, τιμή, μονάδα, εύρος αναφοράς, κατάσταση και ώρα — αντί για PDF, ώστε το λογισμικό να μπορεί να τα αποθηκεύει, να τα συγκρίνει, να τα απεικονίζει και να τα μοιράζεται. Σήμερα αυτά τα δεδομένα ταξιδεύουν σε τρεις μορφές: μηνύματα HL7 v2 ORU^R01 (ακόμα η ραχοκοκαλιά μεταξύ εργαστηρίων και νοσοκομείων), πόροι HL7 FHIR R4 Observation και DiagnosticReport (η μορφή των σύγχρονων API) και εξαγωγές CSV, JSON ή PDF ειδικές για εργαστήρια. Αυτή η σελίδα εξηγεί πώς ταιριάζουν τα κομμάτια, τι πρέπει να μεταφέρει ένα καλό API αποτελεσμάτων εργαστηρίου και πώς να λαμβάνετε εργαστηριακά δεδομένα στο αρχείο FHIR ενός ασθενούς με το Anpheros.

Ποιος ανταλλάσσει εργαστηριακά αποτελέσματα και σε ποια μορφή

Η κατεύθυνση έχει σημασία: ένα σύστημα πληροφοριών εργαστηρίου (LIS) είναι η πηγή αλήθειας για ένα αποτέλεσμα, και κάθε σύστημα που ακολουθεί διατηρεί ένα αντίγραφο. Αυτό που καθιστά τα αντίγραφα αξιόπιστα είναι ότι το καθένα διατηρεί τον κωδικό, τη μονάδα, το εύρος και την προέλευση της τιμής.

Τι πρέπει να μεταφέρει ένα εργαστηριακό αποτέλεσμα

Ένα αποτέλεσμα που λέει μόνο "Γλυκόζη 126" δεν μπορεί να ερμηνευτεί με ασφάλεια. Ένα πλήρες αποτέλεσμα περιέχει:

• Έναν τυπικό κωδικό. Το LOINC αναγνωρίζει την αναλυόμενη ουσία, το δείγμα και τη μέθοδο: 2345-7 είναι γλυκόζη σε ορό ή πλάσμα, 2339-0 είναι γλυκόζη σε ολικό αίμα. Ο δικός κωδικός του εργαστηρίου μπορεί να ταξιδέψει δίπλα του.
• Μια τιμή με μονάδα. Ιδανικά μια μονάδα UCUM (mg/dL, mmol/L, 10*3/uL), ώστε οι τιμές από δύο εργαστήρια να μπορούν να μετατραπούν και να συγκριθούν.
• Το εύρος αναφοράς που χρησιμοποίησε το εργαστήριο, και μια σημαία ερμηνείας (H, L, N…) όταν το εργαστήριο παρέχει μία.
• Κατάσταση: προκαταρκτικό, τελικό, διορθωμένο ή τροποποιημένο. Οι διορθώσεις συμβαίνουν· ένα API πρέπει να σας επιτρέπει να δείτε τη νέα έκδοση χωρίς να χάσετε την παλιά.
• Χρόνοι: πότε συλλέχθηκε το δείγμα (effectiveDateTime) και πότε δημοσιεύθηκε το αποτέλεσμα (issued).
• Προέλευση: ποιο εργαστήριο το παρήγαγε και σε ποια αναφορά ή παραγγελία ανήκει.

Στο FHIR R4 κάθε αποτέλεσμα είναι ένα Observation με category = laboratory, και η αναφορά που τα ομαδοποιεί είναι ένα DiagnosticReport που παραθέτει τις Παρατηρήσεις σε result. Έγκυρα παραδείγματα και των δύο, με τα λάθη που οι επικυρωτές αναφέρουν συχνότερα, βρίσκονται στα Παραδείγματα JSON FHIR R4 — δείτε επίσης το παράδειγμα DiagnosticReport.

HL7 v2 και FHIR παράλληλα

Το ίδιο αποτέλεσμα λιπιδαιμικού προφίλ, όπως το στέλνουν σήμερα τα περισσότερα εργαστήρια και όπως θα έπρεπε να το αποθηκεύει ένα API:

OBX|1|NM|2093-3^Cholesterol^LN||212|mg/dL|<200|H|||F|||20261002074500

Η μετατροπή μεταξύ των δύο είναι κυρίως αντιστοίχιση πεδίων. Τα δύσκολα σημεία βρίσκονται αλλού: εργαστήρια που στέλνουν τους δικούς τους κωδικούς αντί για LOINC, αριθμοί γραμμένοι ως κείμενο ("6,4", "<5"), εύρη σε διάφορες σημειώσεις και αναφορές που αποστέλλονται ξανά μετά από ένα χρονικό όριο. Πώς να ομαλοποιήσετε ιατρικά δεδομένα καλύπτει αυτά λεπτομερώς.

Λήψη αποτελεσμάτων εργαστηρίου σε εγγραφή FHIR με το Anpheros

Το Anpheros αποθηκεύει την εγγραφή κάθε ασθενούς ως HL7 FHIR R4 και διαθέτει έναν σύνδεσμο εργαστηρίου: ένα αίτημα δέχεται ολόκληρη την αναφορά ως HL7 v2, CSV ή JSON και επιστρέφει εργαστηριακές Παρατηρήσεις (Observations) με κωδικούς LOINC, εύρη αναφοράς, ερμηνεία και προέλευση.

curl -s -X POST "https://platform.anpheros.com/v1/patients/$PID/labs/import" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: x-application/hl7-v2+er7" \
  -H "X-Anpheros-Source-System: springfield-lis" \
  --data-binary @lipid-panel.hl7

Για ένα πάνελ λιπιδίων τριών γραμμών (χοληστερόλη, HDL, τριγλυκερίδια), η απάντηση, από μια τοπική εκτέλεση της πλατφόρμας, είναι:

{
  "created": 3, "skipped": 0, "unmapped": [], "warnings": [],
  "observations": [
    {"id": "26ed9219-…", "marker": "Cholesterol", "code": "2093-3", "system": "http://loinc.org",
     "value": 212.0, "unit": "mg/dL", "date": "2026-10-02T07:45:00Z"},
    {"id": "2633d1d4-…", "marker": "HDL cholesterol", "code": "2085-9", "system": "http://loinc.org",
     "value": 48.0, "unit": "mg/dL", "date": "2026-10-02T07:45:00Z"},
    {"id": "a02520bb-…", "marker": "Triglyceride", "code": "2571-8", "system": "http://loinc.org",
     "value": 165.0, "unit": "mg/dL", "date": "2026-10-02T07:45:00Z"}
  ]
}

Κάθε αποθηκευμένο αποτέλεσμα είναι μια τυπική FHIR R4 Παρατήρηση (Observation), αναγνώσιμη από οποιονδήποτε πελάτη FHIR:

{
  "resourceType": "Observation",
  "status": "final",
  "category": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/observation-category", "code": "laboratory"}]}],
  "code": {"coding": [{"system": "http://loinc.org", "code": "2093-3",
                        "display": "Cholesterol [Mass/volume] in Serum or Plasma"}], "text": "Cholesterol"},
  "subject": {"reference": "Patient/4c3062d9-…"},
  "effectiveDateTime": "2026-10-02T07:45:00Z",
  "valueQuantity": {"value": 212.0, "unit": "mg/dL"},
  "interpretation": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation", "code": "H"}]}],
  "referenceRange": [{"high": {"value": 200.0, "unit": "mg/dL"}}]
}

Η αποστολή του ίδιου μηνύματος ξανά δεν δημιουργεί τίποτα νέο ("created": 0, "skipped": 3): κάθε γραμμή λαμβάνει ένα σταθερό αναγνωριστικό από το αναγνωριστικό αναφοράς, τον κωδικό, την ημερομηνία και την τιμή. Οι δείκτες που η πλατφόρμα δεν μπορεί να αντιστοιχίσει σε LOINC διατηρούν τον κωδικό του εργαστηρίου και επιστρέφουν στο unmapped, ώστε να μπορείτε να διορθώσετε την αντιστοίχιση στην πηγή.

Η ανάγνωση των αποτελεσμάτων είναι μια τυπική αναζήτηση FHIR:

curl -s "https://platform.anpheros.com/fhir/R4/Observation?patient=$PID&category=laboratory&code=http://loinc.org|2093-3" \
  -H "Authorization: Bearer $KEY"

Άλλοι τρόποι εισόδου και εξόδου των ίδιων δεδομένων:

• Απευθείας FHIR: POST /fhir/R4/Observation, ή ένα Bundle συναλλαγής με το DiagnosticReport και τις Παρατηρήσεις του (Observations) μαζί.
• Γεγονότα: ένα webhook resource.created ανά Παρατήρηση (Observation), ώστε μια κλινική ή μια εφαρμογή να μπορεί να αντιδρά όταν φτάνουν αποτελέσματα.
• Για ανθρώπους και AI: ο ασθενής βλέπει τα αποτελέσματα στην εφαρμογή του· εφαρμογές στις οποίες συναινεί τα διαβάζουν· το POST /v1/context παρέχει σε ένα μοντέλο AI μια περίληψη με ετικέτα πηγής που περιλαμβάνει πρόσφατες εργαστηριακές τιμές.
• Προέλευση: κάθε εισαγόμενο αποτέλεσμα καταγράφει author_type = import, το σύστημα πηγής και το αναγνωριστικό αναφοράς (προέλευση ιατρικών δεδομένων).

Η πλήρης αναλυτική παρουσίαση, με μια αναφορά CSV, ένα μήνυμα HL7 v2, μη αντιστοιχισμένους δείκτες και επαναλαμβανόμενες αναφορές σε έναν συνθετικό ασθενή, βρίσκεται στο σεμινάριο Πώς να εισάγετε εργαστηριακά αποτελέσματα σε μια εγγραφή FHIR.

Ελέγξτε τα αποτελέσματα πριν τα στείλετε

Ο δωρεάν FHIR R4 validator ελέγχει τη δομή ενός Observation και τα απαιτούμενα value sets, και με το eu-lab profile ελέγχει επίσης τι πρέπει να περιέχει ένα εργαστηριακό αποτέλεσμα: την κατηγορία laboratory, έναν κωδικό LOINC, ένα υποκείμενο, μια κατάσταση final-type, μια ώρα, μια τιμή, μια μονάδα UCUM και ένα εύρος αναφοράς. Οι ίδιοι έλεγχοι εκτελούνται στην πλατφόρμα μέσω του POST /fhir/R4/Observation/$validate?profile=eu-lab.

Επιλογή API για εργαστηριακά αποτελέσματα: λίστα ελέγχου

• Αποθηκεύει τα αποτελέσματα ως FHIR R4 Observations με κωδικούς LOINC, ή ως γραμμές στο δικό του σχήμα;
• Μπορεί να δεχτεί τις μορφές που στέλνουν πραγματικά τα εργαστήρια (HL7 v2 στα περισσότερα νοσοκομεία, CSV ή PDF από μικρότερα εργαστήρια);
• Τι συμβαίνει σε έναν δείκτη που δεν μπορεί να αντιστοιχιστεί: απορρίπτεται, παραλείπεται ή διατηρείται με τον κωδικό του εργαστηρίου;
• Είναι οι επαναλήψεις ασφαλείς, ή μια εκ νέου υποβληθείσα αναφορά δημιουργεί διπλότυπα;
• Έχουν οι διορθωμένες τιμές εκδοτική διαχείριση, με την προηγούμενη τιμή να είναι ακόμα αναγνώσιμη;
• Καταγράφεται η προέλευση κάθε τιμής και είναι ορατή στον ασθενή;
• Ποιος μπορεί να διαβάσει τα αποτελέσματα και αποφασίζεται αυτό από τη συγκατάθεση του ασθενούς;

Τι δεν κάνει το Anpheros

Το Anpheros δεν είναι σύστημα πληροφοριών εργαστηρίου και δεν συνδέεται με εμπορικά εργαστηριακά δίκτυα: η αναφορά αποστέλλεται από το εργαστήριο, την κλινική ή την εφαρμογή του ασθενούς. Δεν δρομολογεί παραγγελίες εργαστηρίου, δεν διαβάζει αναφορές PDF μέσω αυτού του API (η εφαρμογή Anpheros Daily εξάγει αποτελέσματα από φωτογραφίες και PDF από την πλευρά του ασθενούς) και δεν ερμηνεύει κλινικά τα αποτελέσματα. Οι μονάδες αποθηκεύονται όπως τις στέλνει το εργαστήριο· η μετατροπή τους σε κωδικούς UCUM είναι ευθύνη του αποστολέα, όπως περιγράφεται στο Πώς να κανονικοποιήσετε ιατρικά δεδομένα.

Συχνές Ερωτήσεις

Τι είναι ένα API αποτελεσμάτων εργαστηρίου;

Μια διεπαφή που επιτρέπει στο λογισμικό να στέλνει ή να λαμβάνει εργαστηριακά αποτελέσματα ως δομημένα δεδομένα — μια κωδικοποιημένη εξέταση, μια τιμή με μονάδα, ένα εύρος αναφοράς, μια κατάσταση και μια χρονική σήμανση — αντί για ένα έγγραφο. Τα σύγχρονα API αποτελεσμάτων εργαστηρίου χρησιμοποιούν τους πόρους Observation και DiagnosticReport του HL7 FHIR R4. Οι περισσότεροι εργαστηριακοί πάροχοι εξακολουθούν να εκπέμπουν μηνύματα HL7 v2 ORU^R01.

Ποιο σύστημα κωδικοποίησης αναγνωρίζει τις εργαστηριακές εξετάσεις;

LOINC. Κάθε κωδικός LOINC ονομάζει την αναλυόμενη ουσία, το δείγμα και συχνά τη μέθοδο, επομένως οι 2345-7 (γλυκόζη σε ορό ή πλάσμα) και 2339-0 (γλυκόζη σε ολικό αίμα) είναι διαφορετικά αποτελέσματα. Οι μονάδες εκφράζονται καλύτερα σε UCUM.

Ποια είναι η διαφορά μεταξύ ενός Observation και ενός DiagnosticReport;

Ένα Observation είναι ένα μεμονωμένο αποτέλεσμα, όπως η χοληστερόλη 212 mg/dL. Ένα DiagnosticReport είναι η αναφορά στο σύνολό της — η παραγγελθείσα πάνελ, ποιος την εξέδωσε και πότε — και παραθέτει τα Observations της στο result.

Μπορώ να εισαγάγω μηνύματα εργαστηριακών εξετάσεων HL7 v2 σε έναν διακομιστή FHIR;

Ναι. Κάθε τμήμα OBX αντιστοιχεί σε ένα Observation (OBX-3 στο code, OBX-5 και OBX-6 στο valueQuantity, OBX-7 στο referenceRange, OBX-8 στο interpretation). Ο σύνδεσμος εργαστηρίου Anpheros το κάνει αυτό σε ένα αίτημα και διατηρεί το αναγνωριστικό αναφοράς του εργαστηρίου στο Provenance.

Πώς μπορώ να αποφύγω διπλότυπα εργαστηριακά αποτελέσματα όταν μια αναφορά επανυποβάλλεται;

Δώστε σε κάθε αποτέλεσμα ένα σταθερό αναγνωριστικό που προέρχεται από την αναφορά, την εξέταση, την ώρα και την τιμή, και παραλείψτε τις γραμμές των οποίων το αναγνωριστικό υπάρχει ήδη. Ο σύνδεσμος εργαστηρίου Anpheros το κάνει αυτό αυτόματα και αναφέρει τον αριθμό ως skipped.

Σχετικά

• Αντιστοίχιση HL7 v2 σε FHIR: κάθε τμήμα και πεδίο OBX
• Πώς να εισαγάγετε εργαστηριακά αποτελέσματα σε ένα αρχείο FHIR: ο οδηγός βήμα προς βήμα
• Συνδέτης εργαστηρίου: η αναφορά τελικού σημείου
• Πώς να κανονικοποιήσετε ιατρικά δεδομένα: LOINC, UCUM, ημερομηνίες, εύρη και διπλότυπα
• Επεξήγηση προέλευσης ιατρικών δεδομένων
• Συστήματα κωδικοποίησης FHIR
• Πώς να ενσωματώσετε συστήματα κλινικής με ένα backend FHIR
• FHIR vs HL7 v2: πρακτικές διαφορές
• HL7 v2 και FHIR για κλινικούς πίνακες ελέγχου: από ένα εργαστηριακό μήνυμα σε ένα πλακίδιο πίνακα ελέγχου

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card