एक प्रयोगशाला का एक एकीकरण में एक ही काम होता है: रिपोर्ट को रोगी के रिकॉर्ड में बिना दोबारा टाइप किए, संदर्भ सीमा खोए बिना, और ऐसे प्रारूप का आविष्कार किए बिना जिसे कोई और नहीं पढ़ता, डालना। Anpheros लैब कनेक्टर रिपोर्ट को उसी रूप में लेता है जैसे प्रयोगशाला इसे पहले से ही उत्पन्न करती है, HL7 v2, CSV या JSON, और हर परिणाम को एक FHIR Observation में बदल देता है जिसमें एक LOINC कोड, एक इकाई, एक संदर्भ सीमा, एक तारीख और प्रयोगशाला को प्रदर्शनकर्ता के रूप में नामित किया जाता है। यह गाइड अनुबंध है।
डेवलपर्स के लिए तकनीकी संस्करण: लैब कनेक्टर · लैब परिणाम API developers.anpheros.com पर, अनुरोधों, प्रतिक्रियाओं और सीमाओं के साथ। यह पृष्ठ सरल भाषा वाला संस्करण है।
एक अनुरोध
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 (वैकल्पिक; Provenance में दर्ज)
Idempotency-Key: <report id> (वैकल्पिक; पुनः प्रयास करने पर वही उत्तर मिलता है)
प्रतिक्रिया बताती है कि क्या हुआ:
{"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"}]}
प्रारूप
HL7 v2 ORU^R01, ER7 टेक्स्ट के रूप में। OBX-3 पहचानकर्ता है (code^text^LN LOINC है; एक स्थानीय कोड को प्रयोगशाला के अपने कोड के रूप में रखा जाता है), OBX-5 मान है, OBX-6 इकाई है, OBX-7 संदर्भ सीमा है, OBX-8 असामान्य ध्वज है (जो interpretation बन जाता है), OBX-11 स्थिति है, OBX-14 या OBR-7 तारीख है। MSH-4 भेजने वाली सुविधा का नाम बताता है, जो प्रदर्शनकर्ता बन जाता है; OBR-3 और MSH-10 Provenance में रिपोर्ट आईडी बन जाते हैं। लंबित, हटाए गए या गलत परिणाम (I, X, D, W) और बिना मान वाले OBX खंड Observations नहीं बनते हैं और warnings में नामित होते हैं।
CSV हेडर पंक्ति के साथ; विभाजक , ; या टैब, दशमलव अल्पविराम स्वीकार्य, ISO तिथियां, DD.MM.YYYY या DD/MM/YYYY। रोमानियाई या अंग्रेजी में पहचानी गई कॉलम: marker, value, unit, reference range (70-100, <5, >3.5) या ref_low/ref_high, date, वैकल्पिक LOINC कोड, note। एक CSV प्रयोगशाला नहीं ले जाता है, इसलिए प्रदर्शनकर्ता गायब है जब तक कि आप 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 जब आपके पास पहले से ही संरचित डेटा हो: {"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"}]}।
मैपिंग नियम जो मायने रखते हैं
- LOINC जब दिया गया हो, अन्यथा नाम से। नामों का मिलान LOINC नामों और रोमानियाई और अंग्रेजी में समानार्थक शब्दों से किया जाता है। एक नाम जो कई अवधारणाओं से मेल खाता है, या एक क्वालिफायर रखता है जो अवधारणा के पास नहीं है (मूत्र, गैर-एचडीएल, मुक्त, अनुपात), का अनुमान नहीं लगाया जाता है: यह प्रयोगशाला के कोड को
urn:anpheros:lab-codeके तहत रखता है औरunmappedमें दिखाई देता है, ताकि आप अपनी तरफ से मैपिंग में सुधार कर सकें। जब भी आपके पास LOINC कोड हों तो उन्हें भेजें। - मान कभी परिवर्तित नहीं होते हैं। यूरिया और यूरिया नाइट्रोजन अलग-अलग कोड हैं; एलडीएल डायरेक्ट और एलडीएल कैलकुलेटेड अलग-अलग कोड हैं; सीरम से ग्लूकोज और केशिका रक्त से ग्लूकोज अलग-अलग कोड हैं। कनेक्टर नाम और विधि से सही वाला चुनता है, और संख्या को अकेला छोड़ देता है।
- समय अपने क्षेत्र को बनाए रखते हैं। एक ऑफसेट के साथ एक v2 समय रखा जाता है; बिना ऑफसेट के,
MSH-7का ऑफसेट एक चेतावनी के साथ उपयोग किया जाता है; कहीं भी कोई ऑफसेट न होने पर, केवल तारीख संग्रहीत की जाती है। CSV समय कोई क्षेत्र नहीं ले जाते हैं और तिथियों के रूप में संग्रहीत होते हैं। - Idempotent। एक ही रिपोर्ट को एक ही
Idempotency-Keyके साथ दो बार भेजें और आपको वही उत्तर मिलेगा और कोई डुप्लिकेट नहीं। - हर परिणाम पर Provenance: स्रोत प्रणाली, रिपोर्ट आईडी और प्रदर्शनकर्ता, जैसा कि HL7 यूरोप प्रयोगशाला रिपोर्ट की आवश्यकता है।
रोगी क्या देखता है
परिणाम व्यक्ति के रिकॉर्ड में दिखाई देते हैं और, यदि वे Anpheros Daily का उपयोग करते हैं, तो उनके फोन पर जैसे ही वे आते हैं, संदर्भ सीमा और पिछले रिपोर्टों पर रुझान के साथ। स्कैन करने के लिए कुछ नहीं, दोबारा टाइप करने के लिए कुछ नहीं। यदि कोई परिणाम असामान्य है तो व्यक्ति को ध्वज दिखाई देता है; ऐप इसकी व्याख्या नहीं करता है।
परीक्षण
सैंडबॉक्स मुफ्त है और सिंथेटिक रोगियों के पास पहले से ही लैब इतिहास है। उनमें से एक को एक रिपोर्ट पोस्ट करें और उसे वापस पढ़ें:
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"
HL7 यूरोप अनुरूपता नोट्स सहित पूर्ण विनिर्देश, developers.anpheros.com/guides/lab-connector पर है।
अक्सर पूछे जाने वाले प्रश्न
क्या हमें अपने LIS द्वारा उत्पन्न चीज़ों को बदलना होगा?
नहीं। ORU^R01 संदेश या CSV निर्यात जैसा है वैसा ही भेजें। यदि आप LOINC कोड जोड़ सकते हैं, तो जोड़ें; अन्यथा कनेक्टर नाम से मैप करता है और आपको बताता है कि वह क्या मैप नहीं कर सका।
उन परिणामों के बारे में क्या जिन्हें आप मैप नहीं कर सकते?
वे प्रयोगशाला के अपने कोड और रिपोर्ट से सटीक पाठ के साथ संग्रहीत होते हैं, इसलिए कुछ भी खोता नहीं है, और unmapped में सूचीबद्ध होते हैं ताकि आप अगली बार LOINC कोड जोड़ सकें।
क्या संदर्भ सीमाएं और असामान्य ध्वज रखे जाते हैं?
हाँ: सीमा referenceRange में जाती है, ध्वज interpretation में जाता है, इकाई UCUM के रूप में संग्रहीत होती है, और मान कभी परिवर्तित नहीं होता है।
क्या कोई प्रयोगशाला ऐसे रोगी के लिए परिणाम भेज सकती है जिसे उसने नहीं बनाया है?
केवल व्यक्ति की सहमति से, या उस संगठन के रूप में जिसके लिए परियोजना कार्य करती है X-Anpheros-Acting-As के साथ। एक परियोजना उन रोगियों को देखती है जिन्हें उसने बनाया है; बाकी सब कुछ के लिए एक अनुदान की आवश्यकता होती है।
क्या एकीकरण के लिए कोई लागत है?
सैंडबॉक्स मुफ्त है। उत्पादन प्रति संगठन €49 प्रति माह से शुरू होता है, जिसमें पहला महीना मुफ्त है; मूल्य निर्धारण देखें।
अपना मेडिकल रिकॉर्ड अपने साथ रखें
एन्फेरोस डेली लक्षणों, लैब नतीजों, दवाओं और दस्तावेजों को एक ही स्थान पर, एक मानक प्रारूप में, आपके नियंत्रण में रखता है। बेसिक प्लान मुफ़्त है।