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

Συνδετήρας εργαστηρίου

Αποστολή μιας πλήρους εργαστηριακής αναφοράς ως CSV, HL7 v2 ORU^R01 ή JSON και λήψη παρατηρήσεων εργαστηρίου με κωδικούς LOINC και εύρη αναφοράς.

Ένα εργαστήριο (ή οποιοσδήποτε κατέχει εργαστηριακή αναφορά) στέλνει την πλήρη αναφορά σε ένα αίτημα και η πλατφόρμα μετατρέπει κάθε αποτέλεσμα σε μια εργαστηριακή Observation του ασθενούς:

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; recorded in Provenance)
Idempotency-Key: <report id>          (optional; a retry returns the same answer)

Μορφές

CSV με γραμμή κεφαλίδας· διαχωριστές , ; ή tab, δεκαδικό κόμμα αποδεκτό, ημερομηνίες ISO, DD.MM.YYYY ή DD/MM/YYYY. Αναγνωρίσιμες στήλες (Ρουμανικά ή Αγγλικά): δείκτης (analiza, test, marker, name) — ή μόνο στήλη LOINC code, στην περίπτωση αυτή το όνομα LOINC γίνεται ο δείκτης — τιμή (rezultat, valoare, value, result), μονάδα (um, unitate, unit), εύρος αναφοράς (interval, referinta: 70-100, <5, >3.5) ή ref_low/ref_high, ημερομηνία (data, recoltare), προαιρετικό LOINC (loinc, code), σημείωση.

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

HL7 v2 ORU^R01 (κείμενο ER7, τμήματα χωρισμένα με CR ή LF): OBX-3 αναγνωριστικό (code^text^LN είναι LOINC· ένας τοπικός κωδικός (^L, ^99zzz) ή οποιοδήποτε άλλο σύστημα κωδικοποίησης διατηρείται ως ο δικός του κωδικός του εργαστηρίου υπό urn:anpheros:lab-code), OBX-5 τιμή (NM, SN, ή κείμενο), OBX-6 μονάδα, OBX-7 εύρος αναφοράς, OBX-8 δείκτης ανωμαλίας → interpretation, OBX-11 κατάσταση, OBX-14 ή OBR-7 ημερομηνία· OBR-3/MSH-10 γίνονται το αναγνωριστικό αναφοράς στο Provenance.

Το εργαστήριο. Κάθε αποτέλεσμα ονομάζει ποιος το παρήγαγε στο performer, όπως απαιτεί το HL7 Europe Laboratory Report 2.1.0: ο οργανισμός για τον οποίο ενεργείτε (X-Anpheros-Acting-As), αλλιώς MSH-4 (αποστέλλον κέντρο) για HL7, ή laboratory σε JSON (κορυφαίο επίπεδο ή ανά στοιχείο). Ένα CSV δεν φέρει εργαστήριο· τέτοια αποτελέσματα επικυρώνονται με έναν ελλείποντα εκτελεστή, που είναι η αλήθεια.

Αναφορές κειμένου, έγγραφα και ελλείπουσες ημερομηνίες. Μια αναφορά κειμένου που αποστέλλεται μία γραμμή ανά OBX (TX/FT, ίδιο OBX-3) γίνεται ένα αποτέλεσμα με τις γραμμές ενωμένες. Ένα ολόκληρο έγγραφο σε OBX-5 (ED, ή οποιαδήποτε τιμή κωδικοποιημένη Base64) δεν αποθηκεύεται ως αποτέλεσμα· η απάντηση προειδοποιεί και το έγγραφο ανήκει στο /documents. Χωρίς OBR-7, τα αποτελέσματα χρονολογούνται από OBR-14 (παραλαβή δείγματος), με προειδοποίηση.

Ώρες και ζώνες ώρας. Μια ώρα v2 χωρίς ζώνη ώρας είναι η τοπική ώρα του αποστολέα, όχι UTC. Η μετατόπιση που αποστέλλεται με OBX-14/OBR-7 (20260901081000+0300) διατηρείται (2026-09-01T08:10:00+03:00). Χωρίς μία, χρησιμοποιείται η μετατόπιση του MSH-7 και μια προειδοποίηση το αναφέρει· χωρίς μετατόπιση οπουδήποτε, το αποτέλεσμα διατηρεί μόνο την ημερομηνία του, επίσης με προειδοποίηση. Οι ώρες CSV (01.09.2026 08:10) δεν φέρουν ζώνη ώρας, οπότε αποθηκεύονται μόνο ως ημερομηνίες. Μέχρι τις 17 Οκτωβρίου 2026 τέτοιες ώρες επισημαίνονταν ως UTC· τα αποτελέσματα που εισήχθησαν τότε διατηρούν τα αναγνωριστικά τους και αναγνωρίζονται ακόμα όταν αποστέλλεται ξανά μια αναφορά.

Τα αποτελέσματα HL7 που είναι ακόμα σε εκκρεμότητα (OBX-11 I), μη διαθέσιμα (X), διαγραμμένα (D) ή λανθασμένα (W), και τα τμήματα OBX χωρίς τιμή, δεν γίνονται Observations· καθένα ονομάζεται στο warnings.

JSON: {"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, "date": "2026-09-01", "code": "3016-3"}]}.

Τι λαμβάνετε πίσω

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

• Οι δείκτες αντιστοιχίζονται σε LOINC όταν η αναφορά παρέχει κωδικό LOINC ή το όνομα ταιριάζει με την ορολογία της πλατφόρμας (Ρουμανικά και Αγγλικά ονόματα και κοινά ψευδώνυμα). Άλλοι διατηρούν τον κωδικό του εργαστηρίου κάτω από το urn:anpheros:lab-code με το ακριβές κείμενο από την αναφορά, και παρατίθενται στο unmapped ώστε να μπορείτε να βελτιώσετε την αντιστοίχιση από την πλευρά σας. Ο δικός κωδικός ενός εργαστηρίου είναι μοναδικός μόνο μαζί με το εργαστήριό του: το σύστημα προέλευσης καταγράφεται στην Προέλευση (Provenance) κάθε Παρατήρησης (Observation) (X-Anpheros-Source-System).
• Τα ονόματα αντιστοιχίζονται με ονόματα και συνώνυμα LOINC (για παράδειγμα Hemoglobin A1c, Glycated hemoglobin, HDL cholesterol, LDL-C). Ένα όνομα που ταιριάζει με πολλές έννοιες, ή που φέρει έναν προσδιοριστή που η έννοια δεν έχει (urine, non-HDL, free, ratio…), δεν γίνεται εικασία: διατηρεί τον κωδικό του εργαστηρίου και παρατίθεται στο unmapped. Στείλτε κωδικούς LOINC όποτε το σύστημά σας τους έχει.
• Η ουρία και το άζωτο ουρίας (BUN) είναι διαφορετικές μετρήσεις: Uree / Urea αντιστοιχεί σε ουρία (LOINC 3091-6, ή 22664-7 σε mmol/L), BUN / Urea nitrogen / Azot ureic σε άζωτο ουρίας (3094-0, ή 14937-7 σε mmol/L). Οι τιμές δεν μετατρέπονται ποτέ.
• Χοληστερόλη LDL: ένα όνομα χωρίς μέθοδο αντιστοιχεί στο 2089-1· calculated / calculat / Friedewald στην υπολογιζόμενη LDL (13457-7)· direct στην άμεση ανάλυση (18262-6). Η μέθοδος είναι ένας προσδιοριστής, όπως το direct στο Bilirubina directa, το οποίο δεν είναι ολική χολερυθρίνη και διατηρεί τον κωδικό του εργαστηρίου.
• Γλυκόζη: ένα απλό "Glicemie" / "Glucose" σε μια εργαστηριακή αναφορά αντιστοιχίζεται σε ορό ή πλάσμα (LOINC 2345-7)· ένα όνομα που λέει τριχοειδές, τρύπημα δακτύλου ή ολικό αίμα ("capilar", "sânge integral") σε ολικό αίμα (2339-0). Ένας κωδικός LOINC στην αναφορά έχει πάντα προτεραιότητα.
• Κάθε γραμμή λαμβάνει ένα σταθερό αναγνωριστικό (urn:anpheros:lab-import:v2) κατασκευασμένο από ό,τι λέει η αναφορά — αναγνωριστικό αναφοράς, το όνομα και τον κωδικό στην αναφορά, ημερομηνία, τιμή και μονάδα — ποτέ από τον κωδικό LOINC που επέλεξε η πλατφόρμα, οπότε η επανυποβολή της ίδιας αναφοράς παραλείπει γραμμές που έχουν ήδη εισαχθεί (skipped), ακόμη και μετά τη βελτίωση της αντιστοίχισης. Γραμμές που διαφέρουν σε οποιοδήποτε από αυτά (άλλη αναφορά, άλλη ώρα συλλογής, άλλη τιμή) διατηρούνται ξεχωριστά. Αποτελέσματα που εισήχθησαν πριν από τις 14 Οκτωβρίου 2026 διατηρούν το αρχικό τους αναγνωριστικό και αναγνωρίζονται από όνομα, ημερομηνία, τιμή, μονάδα και αναγνωριστικό αναφοράς. Χωρίς αναγνωριστικό αναφοράς (CSV) μια τέτοια αντιστοίχιση αναφέρεται στο warnings· στείλτε ένα αναγνωριστικό αναφοράς (HL7 OBR-3/MSH-10, JSON origin) για να διατηρήσετε ξεχωριστές αναφορές.
• Κάθε Παρατήρηση (Observation) φέρει Προέλευση (Provenance) με author_type = import, το σύστημα πηγής σας και το αναγνωριστικό αναφοράς· τα webhooks ενεργοποιούνται resource.created ανά Παρατήρηση (Observation)· ο ασθενής βλέπει τα αποτελέσματα στην εφαρμογή του και οποιαδήποτε εφαρμογή έχει συναινέσει μπορεί να τα διαβάσει.
• Έως 500 γραμμές ανά αίτημα.

Και τα δύο SDKs: labs.importCsv, labs.importHl7, labs.importItems.

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

Πώς τα εργαστηριακά δεδομένα μετακινούνται μεταξύ εργαστηρίων, κλινικών, εφαρμογών και AI, και τι να προσέξετε σε ένα API εργαστηριακών αποτελεσμάτων: API Εργαστηριακών Αποτελεσμάτων.

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