الدليل التقني الموحد للربط البرمجي مع المختبرات الطبية (HL7 & FHIR R4)

انطلاقاً من دورنا الريادي في تحديث المنظومة الصحية الرقمية في سوريا، نعلن عن وضع البنية التحتية المتكاملة لربط أنظمة إدارة المختبرات (LIS) مباشرة مع منصتنا الطبية. 

نحن ندرك أن التحول الرقمي في المخابر السورية بدأ يأخذ مساره الجاد، لذا اعتمدنا أرقى المعايير العالمية لضمان دقة تبادل البيانات لحظياً، منهين بذلك عصر النتائج الورقية.

أولاً: الحقول والبيانات التي نوفرها للمختبر

عند التعاقد مع مختبركم، نقوم بتزويدكم بـ "لوحة تحكم مصغرة" أو وثيقة تحتوي على الحقول التالية التي يحتاجها مبرمج نظامكم (LIS) لبناء الاتصال:

• 1. رابط الاستقبال (Webhook URL): الرابط الذي سيرسل إليه نظامكم النتائج.
• 2. مفتاح الأمان (API Key): رمز سري فريد لتأكيد هوية مختبركم (يُرسل في الـ Header).
• 3. معرف المختبر (Sender ID): معرف خاص بمختبركم في رسائل HL7.
• 4. نوع البروتوكول (Protocol Type): تحديد ما إذا كان الربط سيتم عبر JSON/FHIR أو HL7 V2.

ثانياً: ماذا يرسل نظامنا للمختبر؟ (طلب الفحص)

بمجرد قيام الطبيب بطلب تحليل، يرسل نظامنا طلب استدعاء (Trigger) إلى نظام المختبر الخاص بكم. الصيغة التي نرسلها هي JSON وتحتوي على كافة تفاصيل المريض والتحاليل:

// ما نرسله للمختبر (Outgoing Order)
{
  "order_id": "ORD-1002",         // الرقم المرجعي للطلب (يجب إعادته مع النتيجة)
  "sender_id": "CLINIC_SY_01",    // معرف العيادة المرسلة
  "patient": {
    "id": "PAT-5542",             // معرف المريض في نظامنا
    "full_name": "أحمد المحمد",
    "gender": "M",
    "dob": "1985-05-12"
  },
  "requested_tests": [
    {"code": "6690-2", "name": "WBC"}, // كواد التحاليل المطلوبة (LOINC)
    {"code": "2823-3", "name": "Potassium"}
  ]
}

---

ثالثاً: ماذا نتوقع أن نستقبل من المختبر؟ (النتائج)

يمكن للمختبر إرسال النتائج إلينا عبر مسارين حسب قدرة نظام الـ LIS لديكم:

المسار (أ): بروتوكول FHIR R4 (صيغة JSON)

هذا المسار هو الأسهل والأنظف برمجياً، حيث يرسل المختبر كائن JSON يحتوي على القيمة والوحدة والمجال الطبيعي.

{
  "resourceType": "Observation",
  "identifier": [{"value": "ORD-1002"}], // ضروري جداً لربط النتيجة بالطلب
  "subject": {"reference": "Patient/PAT-5542"},
  "valueQuantity": {
    "value": 9.5,
    "unit": "10*3/uL"
  },
  "referenceRange": [{"low": {"value": 4.0}, "high": {"value": 11.0}}]
}

المسار (ب): بروتوكول HL7 V2.5 (نص خام)

للمختبرات التي تعتمد الأنظمة التقليدية، نستقبل رسائل ORU^R01 الخام بمرونة عالية.

MSH|^~\&|LAB_SYS|SENDER_ID|OUR_SYS|CLINIC|20231027||ORU^R01|MSG-001|P|2.5
PID|1||PAT-5542||أحمد^المحمد
OBR|1|ORD-1002|LAB-9901|6690-2^WBC
OBX|1|NM|6690-2^WBC||9.5|10*3/uL|4.0-11.0|N|||F

---

رابعاً: متطلبات الأمان والمصادقة

يجب على مبرمج المختبر تضمين هذه الترويسات (Headers) في كل طلب إرسال لضمان قبول البيانات في سيرفراتنا:

الترويسة (Header)	القيمة المتوقعة
X-API-KEY	المفتاح السري الذي زودناكم به (مثلاً: LAB-HHTA4...)
X-PROTOCOL	نوع البيانات HL7_V2 أو FHIR_R4

توجيهات هامة للمطورين في سوريا:

• مطابقة الأكواد: نعتمد نظام LOINC، يرجى مطابقة تحاليلكم معه لضمان ظهور النتائج في مكانها الصحيح.
• ترميز UTF-8: يرجى التأكد من إرسال البيانات بترميز UTF-8 لضمان ظهور الأسماء العربية.
• الدعم الفني: نوفر بيئة اختبار (Sandbox) للمطورين لتجربة الربط قبل اعتماده رسمياً.