المطالبة Claim هي اللحظة التي تتحول فيها الخدمة الطبية إلى مال، وكل ما قبلها من تسجيل وتحقق من الأهلية وموافقة مسبقة هدفه أن تصل هذه الرسالة كاملة وتقبل من أول مرة. وإذا كنت المطور المسؤول عن ربط نظام المستشفى أو العيادة أو الصيدلية بمنصة نفيس NPHIES، فأنت تعرف أن المشكلة نادراً ما تكون في إرسال الرسالة نفسها، وإنما فيما يحدث بعدها: رد يقول إن المطالبة في الطابور ولا يقول متى ينتهي، وطلب معلومات إضافية يصل بعد أيام ولا يراه أحد، ومطالبة فيها خطأ في رمز واحد لا تستطيع تعديلها، وموظف يعيد إرسالها برقم جديد فتظهر في تقرير الشركة مكررة.
وقد شرحنا في مقال التأمين الصحي من الداخل دورة المطالبة من زاوية العمل، وفي مقال المنصات الصحية في السعودية نقطة الاتصال الواحدة والسحب Polling من زاوية المعمارية، وفي مقال خادم FHIR على سيرفرك شغلنا سيرفر HAPI محملاً بدليل نفيس. وفي مقال الأهلية والموافقة المسبقة في نفس المرحلة بنينا الرسائل التي تسبق المطالبة. وهنا نكمل من حيث توقفنا: نبني مطالبة من كل نوع من الأنواع الخمسة، ونتحقق منها، ونشغل محاكياً صغيراً للمنصة وشركة تأمين واحدة يرد بالقرار الفوري والمؤجل ويطلب معلومات إضافية ويقبل الإلغاء، ثم نكتب جدول الأخطاء الشائعة من تشغيلنا نحن ومن رموز الدليل. وكل البيانات وهمية، ولا نرسل شيئاً إلى المنصة الحقيقية، لأن الدليل نفسه يمنع البيانات الحقيقية حتى في بيئات الاختبار.
وسوف نناقش في هذا المقال ما يلي:
- الأنواع الخمسة للمطالبات، وما الذي يختلف فعلاً بينها في ملفات التعريف.
- لماذا لا تعدل المطالبة بعد إرسالها، والفرق بين الإلغاء وإعادة الإرسال وتقديم المعلومات.
- كيف تتعامل المنصة مع الأخطاء، ومتى يرجع OperationOutcome ومتى يرجع رد عمل فيه أخطاء.
- مطالبة من كل نوع ببناء واحد عام، ثم الأخطاء التي رجعت لكل نوع، وكيف أصلحناها.
- قاعدتان في الدليل نفسه تتعارضان مع رسالة صحيحة، وكيف تتعامل معهما.
- محاكي للمنصة يرد فورياً ومؤجلاً، ويطلب صورة أشعة، ويرفض بنداً مكرراً، ويقبل الإلغاء.
- تصميم السحب Polling في نظامك، وجدول الأخطاء الشائعة ومن يصلح كل واحد.
الأنواع الخمسة للمطالبات Claim Types
تقسم صفحة حالة المطالبات في الدليل المطالبات إلى خمسة أنواع، ولكل نوع ملف تعريف خاص به في الحزمة، وكلها مورد Claim واحد في المعيار، بالحقل use بالقيمة claim، والفرق في الحقل type وفي ما يشترطه كل ملف تعريف:
| النوع | ملف التعريف | متى يستخدم بحسب الدليل |
|---|---|---|
| المنشأة Institutional | institutional-claim | خدمات المستشفى مثل التنويم والعمليات |
| المهنية Professional | professional-claim | خدمات الطبيب في العيادات الخارجية والاستشارات والإجراءات التشخيصية |
| الصيدلية Pharmacy | pharmacy-claim | الأدوية المعبأة والمركبة التي تصرفها الصيدليات |
| الأسنان Dental | oral-claim | إجراءات الأسنان الكبيرة مثل التقويم والجراحة |
| البصريات Vision | vision-claim | خدمات العيون ومنها العدسات التصحيحية وجراحات العين |
ولاحظ أن نوع الأسنان اسمه في الرموز oral وليس dental، وهذا من نظام الرموز القياسي في FHIR. والرسالة نفسها حزمة من نوع message أولها رأس رسالة بالحدث claim-request، ثم المطالبة، ثم التغطية والمريض والمنظمتان والممارس الصحي، ثم زيارة Encounter بملف تعريف يناسب نوع الزيارة: عيادة AMB، أو طوارئ EMER، أو رعاية منزلية HH، أو تنويم IMP، أو اليوم الواحد SS، أو عن بعد VR.
والفرق بين الأنواع ليس في الاسم فقط، فكل ملف تعريف يطلب معلومات داعمة مختلفة وحقولاً مختلفة على التشخيص والبند والزيارة، والصورة التالية تلخص ما وجدناه في المختبر لكل نوع، وسوف نرى بعد قليل كيف وصلنا إليه من أخطاء التحقق نفسها:

ويذكر الدليل في نفس الصفحة مجموعة قواعد تنطبق على كل الأنواع، وهي التي تصنع أغلب المشكلات في الواقع:
- المطالبة حزمة ثابتة Immutable: لا تعدل ولا يضاف إليها، فإذا احتاج محتواها تغييراً يلغيها المستشفى أولاً ثم يرسل مطالبة جديدة.
- المعلومات الداعمة دون تعديل: إذا كانت المطالبة صحيحة وتحتاج فقط معلومات إضافية، يرسل المستشفى رسالة تقديم معلومات Information Submission دون إلغاء.
- الأهلية والموافقة: يجب أن تحمل المطالبة مرجع التحقق من الأهلية إن تم، ومرجع الموافقة في
Claim.insurance.preAuthRefإن وجدت، أو تواريخ التحقق اليدوي بامتداداتها. - الحلقة العلاجية Episode: كل المطالبات المتعلقة بنفس الحلقة، من التنويم إلى الخروج إلى المتابعة، تحمل نفس معرف الحلقة في امتداد
extension-episode، وهو إلزامي على مستوى المطالبة لكل الأنواع. - رقم فاتورة المريض: كل بند يحمل رقم الفاتورة في امتداد
extension-patientInvoice، والدليل يذكر صراحة أن الغرض منه كشف التكرار وتتبع البند. - إعادة الإرسال: المطالبة المرفوضة أو الموافق عليها جزئياً تعاد بمطالبة جديدة فيها
Claim.related.claimبمعرف الأصلية وrelationshipبالقيمةprior، ومعها كل الخدمات، حتى التي وافقت عليها الشركة سابقاً. - المطالبات المجمعة Batch: كل مطالبة في الدفعة تحمل ثلاثة امتدادات: معرف الدفعة، ورقمها داخل الدفعة، وفترة الدفعة، وترجع الردود بنفس الامتدادات.
الحلقة العلاجية ورقم الفاتورة: من أين يأتيان في نظامك؟
هذان الحقلان يبدوان بسيطين في الدليل، ولكنهما يكشفان مشكلة تصميم في أغلب الأنظمة القديمة. فالدليل يضرب مثالاً بمريض دخل المستشفى في 20 نوفمبر، فأرسلت مطالبة في نهاية الشهر، ثم خرج في 15 ديسمبر فأرسلت مطالبة ثانية، ثم راجع الطبيب في 19 ديسمبر فأرسلت مطالبة ثالثة، والثلاث يجب أن تحمل نفس معرف الحلقة، حتى ترى الشركة أنها علاج واحد. والسؤال الذي يجب أن تسأله لنظامك: أين يولد هذا المعرف، ومن يقرر أن زيارة المتابعة تابعة لنفس الحلقة وليست حلقة جديدة؟ فإذا كان النظام يعطي كل زيارة رقماً مستقلاً، ولا يعرف شيئاً اسمه حلقة علاجية، فالحل البسيط أن يولد الكود معرف حلقة جديداً لكل مطالبة، وهذا يمر من التحقق، ولكنه يجعل الشركة ترى ثلاث حلقات منفصلة لمريض واحد، وقد ترفض المتابعة لأنها تبدو زيارة جديدة داخل فترة المتابعة المجانية. والحل الأفضل أن يكون للحلقة كيان في قاعدة البيانات يفتح عند الدخول أو الزيارة الأولى، ويختار الطبيب أو موظف الاستقبال ربط الزيارات اللاحقة به.
ورقم فاتورة المريض له مشكلة مختلفة. ففي كثير من المستشفيات تصدر الفاتورة بعد المطالبة أو بالتوازي معها من نظام مالي آخر، فلا يكون الرقم متاحاً عند بناء الرسالة. والدليل واضح في أن كل بند يحمل رقم الفاتورة التي فوتر عليها، وأن الغرض كشف التكرار، لذلك يجب أن يكون ترتيب العمل في النظام: الفاتورة أولاً ثم المطالبة. وإذا كانت الفاتورة الواحدة تشمل خدمات من أكثر من زيارة، فرقمها يتكرر على بنود مختلفة، وهذا طبيعي، فالتكرار الذي تبحث عنه الشركة هو نفس الرقم مع نفس الخدمة ونفس التاريخ، كما رأينا في المحاكي.
المطالبات المجمعة Batch: متى تحتاجها؟
المطالبة الفردية تعالج كرسالة فورية، والدليل يذكر أن المنصة توجهها للشركة في الوقت الحقيقي إن أمكن، وترجع ما ترده الشركة: أخطاء أو إقرار أو قرار جزئي أو كامل. أما الدفعة فهي مجموعة مطالبات ترسل معاً وتعالج دائماً بشكل مؤجل، وكل مطالبة فيها تحمل معرف الدفعة ورقمها داخلها وفترتها. ومتى تختار الدفعة؟ عندما يكون نظامك يجمع المطالبات أصلاً ويرسلها مرة في اليوم أو الأسبوع، كما في بعض الصيدليات أو المراكز الصغيرة، أو عندما يكون عدد المطالبات كبيراً ولا تحتاج قرارها فوراً. والثمن أنك لن ترى أي قرار في نفس الجلسة، وأن خطأ في بناء القالب يتكرر في مئات المطالبات قبل أن تعرف به. لذلك ابدأ بالمطالبات الفردية حتى يستقر القالب لكل نوع، ثم انتقل إلى الدفعات إذا احتجت.
ماذا يحدث بعد الإرسال؟ فوري ومؤجل
المسار في الدليل ست خطوات: يرسل المستشفى، فتتحقق المنصة، ثم توجه إلى شركة التأمين أو TPA، فتقرر الشركة وترد، فتتحقق المنصة من الرد، ثم ترجعه. والفرق عن الأهلية أن قرار المطالبة قد يكون فورياً أو مؤجلاً. فإذا استطاعت الشركة التسوية آلياً جاء القرار في نفس الجلسة، وإذا احتاجت مراجعة بشرية رجع رد حالته queued، ثم قد يأتي partial، ثم complete. وإذا لم تستطع المنصة إيصال المطالبة إلى الشركة فإنها تحتفظ بها وتوصلها لاحقاً، وترد على المستشفى برد تولده هي مع العلامة nphies-generated.
والردود المؤجلة لا تدفع إليك أبداً. وتشرح صفحة السحب أن المنصة تحتفظ بطابور لكل مقدم خدمة فيه ثلاثة أنواع من الرسائل: الردود المؤجلة على المطالبات والموافقات، والرسائل التي جاءت والشركة أو نظامك غير متصل، والرسائل التي ترسلها الشركة من نفسها دون طلب، مثل طلب معلومات إضافية أو مطابقة الدفع. ونظامك يرسل طلب سحب Poll Request، وهو مورد Task بالرمز poll، فترجع المنصة الرسائل في Task آخر يشير إليها، وتضع في رأس الرد العلامة queued-messages إذا بقي في الطابور شيء. والمرشحات الممكنة في الطلب:
| المعامل | العدد | المعنى |
|---|---|---|
count | 0..1 | أكثر عدد من الرسائل في الرد، حتى 100، والافتراضي رسالة واحدة |
include-message-type | 0..* | أنواع الرسائل المطلوبة برمز الحدث، مثل communication-request |
exclude-message-type | 0..* | أنواع مستبعدة، ولا تجمع مع السابق في نفس الطلب |
period | 0..1 | فترة استلام المنصة للرسالة |
focus | عنصر في Task | للحصول على الرد على طلب معين بمعرفه التجاري |
والملاحظة التي يجب أن يعرفها كل من يكتب هذا الجزء: الطلب البسيط دون معاملات يرجع رسالة واحدة فقط إن وجدت. فإذا كتبت مهمة تسحب مرة كل ساعة دون count، فسوف تستلم 24 رسالة في اليوم مهما كان عدد الرسائل في الطابور، وسوف يتأخر طابورك يوماً بعد يوم دون أن يظهر أي خطأ.
وعندما يطول انتظار قرار، يستطيع المستشفى أن يسأل عن حالة طلب معين بطلب الحالة Status Check كما في صفحة الحالة، وهو فوري، ولا يحفظ في الطابور إذا تعذر توصيله. وطلب المعلومات الإضافية من الشركة مورد CommunicationRequest يصل عبر الطابور كما في صفحة طلب المعلومات، والمستشفى يرد بمورد Communication يحمل معرف الطلب في about كما في صفحة تقديم المعلومات، ويستطيع أيضاً أن يرسل معلومات من نفسه دون طلب.

لماذا السحب وليس Webhooks؟
قد يتساءل البعض: لماذا لا ترسل المنصة القرار إلى نظام المستشفى عندما يصدر، كما تفعل بوابات الدفع مع Webhooks؟ والإجابة تبدأ من عدد الأطراف. فالمنصة تتعامل مع آلاف مقدمي الخدمة، من مستشفيات كبيرة لها فرق تقنية إلى صيدليات صغيرة يعمل نظامها على جهاز واحد خلف شبكة لا تستقبل اتصالاً من الخارج. ولو كانت المنصة هي التي تتصل، لاحتاج كل مقدم خدمة عنواناً عاماً ثابتاً وشهادة TLS وجدار حماية مفتوحاً، ولاحتاجت المنصة أن تعيد المحاولة لكل طرف متعطل وتحتفظ بحالة كل محاولة. وقد شرحنا هذه التكلفة بالتفصيل في مقال Webhooks: المرسل يتحمل إعادة المحاولة والترتيب، والمستقبل يتحمل التحقق من التوقيع ومنع التكرار وأن يكون متاحاً دائماً.
ومع السحب ينعكس الاتجاه: المستشفى هو الذي يتصل دائماً، من داخل شبكته، بنفس الشهادة ونفس نقطة الاتصال التي يرسل بها المطالبات، والمنصة تحتفظ بالرسالة حتى يأخذها. والثمن الذي يدفعه المستشفى مقابل هذه البساطة شيئان: تأخير يساوي فترة السحب، ومسؤولية أن تعمل مهمة السحب دائماً. فالمهمة التي تتوقف بصمت ليلة نهاية الشهر تعني أن طلبات المعلومات تبقى في طابور المنصة حتى تنتهي مهلتها عند الشركة، وأن قرارات الدفع لا تصل إلى قسم الحسابات. لذلك يجب أن تعامل مهمة السحب كما تعامل قاعدة البيانات: خدمة لها مراقبة وتنبيه، وليست سكربتاً في المهام المجدولة على جهاز أحد الموظفين.
ولاحظ أيضاً أن الدليل يجعل الشركة نفسها تستطيع أن ترسل رسائل لم يطلبها أحد، مثل مطابقة الدفع Payment Reconciliation التي تخبرك أي المطالبات دفعت في أي تحويل بنكي. وهذه الرسالة لا ترتبط بطلب أرسلته اليوم، فإذا كان نظامك يسحب فقط عندما ينتظر رداً على مطالبة معينة، فلن يرى هذه الرسائل أبداً. والسحب العام بمرشح يستبعد ما لا تريده، أو بلا مرشح، يجب أن يعمل دائماً بجانب أي سحب موجه.
الإلغاء Cancel أم إعادة الإرسال Resubmission أم المعلومات؟
هذه الطرق الثلاث تختلط على الفرق كثيراً، والدليل يفرق بينها بوضوح. فالإلغاء كما في صفحة الإلغاء طلب فوري بمورد Task بالرمز cancel، يحمل في Task.focus.identifier المعرف التجاري للمطالبة. ويجوز الإلغاء سواء سويت المطالبة أم لا، بشرط ألا يكون رد عليها بأخطاء، والشركة تبذل جهدها ألا تعالجها إذا لم تكن عالجتها، وإذا عالجتها يجب أن تعكس أثر التسوية، ومنه إزالة تاريخ الخدمة وإرجاع ما استهلك من المنافع. والرد Task آخر حالته completed أو error. وفي الدليل خيار للإبطال Nullify عندما يجب ألا تظهر الرسالة الأصلية إلا للتدقيق الداخلي أو القانوني.
| الحالة | ما ترسله | ما يحدث للمطالبة الأصلية |
|---|---|---|
| المحتوى خطأ: رمز خدمة، عين خطأ، سن خطأ، خدمة نسيت | إلغاء، ثم مطالبة جديدة بالمحتوى الصحيح | تلغى وتعكس آثارها |
| المحتوى صحيح، والشركة تحتاج تقريراً أو صورة | تقديم معلومات Communication يشير إلى المطالبة | تبقى كما هي، وقد تصدر الشركة رداً جديداً بسبب إعادة الإصدار |
| الشركة رفضت أو وافقت جزئياً وعندك ما يبرر | مطالبة جديدة فيها related بالقيمة prior وكل الخدمات | تبقى، والجديدة تعيد تقييم المجموعة كاملة |
كيف تعالج المنصة الأخطاء؟
تشرح صفحة معالجة الأخطاء أن كل رسالة تبادلت بنجاح ترجع بالرمز 200، حتى لو كان الرد يقول إن الطلب فيه أخطاء، فالرمز الآخر يعني أن التبادل نفسه فشل. وتقسم ما يرجع إلى أربع حالات:
| ما أرسلته | ما يرجع | رمز HTTP |
|---|---|---|
| رسالة لا يمكن قراءتها | OperationOutcome | 300 فما فوق |
| رسالة مقروءة ولكن معلوماتها لا تكفي أو بنيتها خاطئة | OperationOutcome | 300 فما فوق |
| رسالة مقروءة ومعلوماتها كافية ولكن محتواها خاطئ | رد عمل Business Response فيه الأخطاء | 200 |
| انتهت المهلة مع الشركة | رد عمل حالته queued | 200 |
وهذا يعني أن كود العميل لا يكفيه أن ينظر إلى رمز HTTP، فرد 200 قد يكون رفضاً كاملاً بأخطاء، وقد يكون queued لم يقرر فيه شيء بعد. ورموز الأخطاء في الدليل تتبع الشكل RR-NNNNN: BV لقواعد العمل والتحقق، وDT لنوع بيانات خاطئ، وIB لربط بنظام رموز غير المحدد، وIC لعدد عناصر خاطئ. وفي الحزمة أيضاً نظام رموز اسمه adjudication-error فيه 100 رمز رقمي، أغلبها من الشكل «عنصر ناقص في الرسالة» مثل 760 لـ Claim.insurance.coverage، ومعها رموز عمل مثل 1664 الوثيقة ملغاة أو منتهية، و1670 رمز الخدمة لا يتوافق مع جنس المريض، و1672 خدمات خارج فترة سريان التغطية. أما أسباب رفض البنود فهي قائمة أخرى رأيناها في مقال الأهلية: adjudication-reason.

المختبر: مطالبة من كل نوع
نستخدم نفس السيرفر من مقال الأهلية والموافقة المسبقة: HAPI FHIR 8.12.0 محمل بحزمة nphies-fs 1.0.0 مع PostgreSQL، وفيه نظام رموز صغير بتسعة رموز من ICD-10-AM للمختبر فقط، والإعداد الذي يسأل خادم المصطلحات العام عن رموز SNOMED CT. وتذكر من ذلك المقال أن HAPI لم يستخدم نظام الرموز إلا بالقيمة content: complete، وأننا رفعناه ثم أعدنا التشغيل. والحالات الخمس كلها لعضو وهمي واحد في شهر نوفمبر:
| النوع | التشخيص | البند والسعر الوهمي | الزيارة |
|---|---|---|---|
| المنشأة | K35.8 التهاب الزائدة | 30571-00-00 استئصال الزائدة، 9,800 ريال، مع مرجع موافقة | تنويم IMP يومين |
| المهنية | J06.9 التهاب الجهاز التنفسي العلوي | 83600-00-10 استشارة أخصائي، 300 ريال | عيادة AMB |
| الصيدلية | B34.9 عدوى فيروسية | دواء برمز 06285096001627، 60 ريالاً، لخمسة أيام | دون زيارة |
| الأسنان | K02.1 تسوس العاج | 97521-01-00 حشوة سطح واحد، 260 ريالاً | عيادة AMB |
| البصريات | H52.1 قصر النظر | 42503-00-02 فحص العينين، 250 ريالاً | عيادة AMB |
ورموز الخدمات كلها من الأجزاء المنشورة في الحزمة نفسها، لأن قوائم الفوترة الكاملة ينشرها مجلس الضمان الصحي، وقد شرحنا نظام الفوترة السعودي SBS في مقال الترميز الطبي.
المحاولة الأولى: بناء واحد لكل الأنواع
الطريقة التي يبدأ بها أغلب الفرق أن تأخذ الكود الذي نجح في الموافقة المسبقة وتغير فيه use إلى claim ونوع المطالبة، وهذا ما فعلناه في النسخة الأولى من claims.py: كل الأنواع تحمل كل العلامات الحيوية، وكل التشخيصات تحمل onAdmission، والنوع الفرعي op للجميع، والزيارة دون امتدادات. ثم تحققنا من الخمسة:
for k in institutional professional pharmacy oral vision; do
echo "## $k"; python3 claims.py $k cl-$k-1 v1 > v1-$k.json && ./validate.sh v1-$k.json
done## institutional
error .../Claim/cl-institutional-1*/ Slice 'Claim.extension:episode' for extension '.../extension-episode': a matching slice is required, but not found ...
error .../Claim/cl-institutional-1*/.subType The pattern [system http://nphies.sa/terminology/CodeSystem/claim-subtype, code ip, and display 'null'] defined in the profile .../institutional-claim|1.0.0 not found. ...
error .../Claim/cl-institutional-1*/.diagnosis[0] Slice 'Claim.diagnosis.extension:conditionOnset' for extension '.../extension-condition-onset': a matching slice is required, but not found ...
error .../Claim/cl-institutional-1*/.item[0] Slice 'Claim.item.extension:patientInvoice' for extension '.../extension-patientInvoice': a matching slice is required, but not found ...
error .../Claim/cl-institutional-1*/ Constraint failed: BV-00364: 'Claim subtype is using an incorrect value when Claim type is 'Institutional'.' ...
error .../Encounter/enc-cl-institutional-1*/ Constraint failed: BV-00740: 'Extension CauseOfDeath is required if dischargeDisposition is 'died' or Emergency department Disposition is 'DED' or 'DOA'.' ...
errors: 8 warnings: 11
## professional
error .../Claim/cl-professional-1*/.supportingInfo[9] This element does not match any known slice defined in the profile .../professional-claim|1.0.0 and slicing is CLOSED ...
error .../Claim/cl-professional-1*/ Constraint failed: BV-00027: 'Claim diagnosis onAdmission is required for institutional claim type but is not to be used for non-institutional claim type.' ...
error .../Encounter/enc-cl-professional-1*/ Constraint failed: BV-00736: 'Encounter Service Event Type SHALL be provided for 'professional' or 'oral' claim and Authorization.' ...
errors: 8 warnings: 10
## pharmacy
error .../Claim/cl-pharmacy-1*/.supportingInfo[0] This element does not match any known slice defined in the profile .../pharmacy-claim|1.0.0 and slicing is CLOSED ...
... (the same for supportingInfo[1] to supportingInfo[14])
errors: 20 warnings: 9
## oral
errors: 21 warnings: 10
## vision
errors: 21 warnings: 10اختصرنا المخرج لأنه طويل، والأرقام كما هي: 8 أخطاء للمنشأة، و8 للمهنية، و20 للصيدلية، و21 للأسنان، و21 للبصريات. والأرقام الكبيرة في الأنواع الثلاثة الأخيرة سببها شيء واحد يتكرر: 15 عنصراً من المعلومات الداعمة كل منها خطأ مستقل. ونجمع الأخطاء بحسب السبب في جدول، لأن هذا هو الجدول الذي سوف يحتاجه فريقك:
| الخطأ | الأنواع التي ظهر فيها | السبب والإصلاح |
|---|---|---|
شريحة episode مطلوبة | الخمسة | معرف الحلقة العلاجية إلزامي على كل مطالبة، وليس على الموافقة |
شريحة patientInvoice مطلوبة على البند | الخمسة | رقم فاتورة المريض لكل بند، وهو ما تكشف به الشركة التكرار |
BV-00027 onAdmission | المهنية والصيدلية والأسنان والبصريات | حالة التشخيص عند الدخول للتنويم فقط، وممنوعة في غيره |
| المعلومات الداعمة لا تطابق شريحة، والشرائح مغلقة | الصيدلية والأسنان والبصريات، وعنصر واحد في المهنية | كل نوع يقبل فئات محددة فقط: الصيدلية مدة الصرف days-supply، والأسنان الشكوى الرئيسية، والبصريات لا شيء إلزامي، والمدة المتوقعة للإقامة للموافقة فقط |
BV-00364 والنمط ip | المنشأة | مطالبة المنشأة نوعها الفرعي ip وليس op |
شريحة conditionOnset على التشخيص | المنشأة | بداية الحالة نسبة للتنويم، من قائمة فيها ثلاثة رموز |
BV-00736 نوع حدث الخدمة | المهنية والأسنان والبصريات | امتداد serviceEventType على زيارة العيادة، والنص يذكر المهنية والأسنان فقط ولكن ملف تعريف الزيارة يطلبه للبصريات أيضاً |
BV-00740 سبب الوفاة | المنشأة | سوف نتوقف عنده في القسم التالي |
ثم كتبنا النسخة الثانية من البناء، وكل فرع فيها مكتوب بجانبه سببه من الخطأ الذي رأيناه. وهذا جزء المعلومات الداعمة بحسب النوع:
if kind in ("institutional", "professional"):
info = vitals(t0, t1, V)
# estimated length of stay belongs to the institutional authorization only
info = [x for x in info if x["category"]["coding"][0]["code"] != "estimated-Length-of-Stay"]
if kind == "institutional":
info.append({"category": cc(CS + "claim-information-category", "admission-weight"),
"valueQuantity": {"value": 70, "system": UCUM, "code": "kg"}})
elif kind == "pharmacy":
info = [{"category": cc(CS + "claim-information-category", "days-supply"),
"valueQuantity": {"value": c["days"], "system": UCUM, "code": "d"}}]
elif kind == "oral":
info = [{"category": cc(CS + "claim-information-category", "chief-complaint"),
"code": cc("http://snomed.info/sct", "27355003", "Toothache")}]ومعه للصيدلية امتداد الدواء الموصوف وسبب اختيار الصيدلي على البند، وللأسنان رقم السن على البند في bodySite بنظام الأسنان FDI، فالسن 36 هو الضرس الأول الدائم في الفك السفلي الأيسر، وللمنشأة النوع الفرعي ip وبداية الحالة. والنتيجة بعد التصحيح:
## institutional
error .../Encounter/enc-cl-institutional-3*/ Constraint failed: BV-00740: 'Extension CauseOfDeath is required if dischargeDisposition is 'died' or Emergency department Disposition is 'DED' or 'DOA'.' ...
errors: 1 warnings: 11
## professional
errors: 0 warnings: 11
## pharmacy
errors: 0 warnings: 8
## oral
errors: 0 warnings: 10
## vision
errors: 0 warnings: 10
وفي هذه الجولة ظهر خطأ مرة واحدة ثم اختفى في التشغيل التالي دون أي تغيير:
error .../Patient/pat-001*/.identifier[0].type.coding[0].code Exception evaluating regex '[^\s]+(\s[^\s]+)*' on type code: Regex evaluation timed out after ...أي أن المدقق نفسه تجاوز مهلة داخلية وهو يفحص قيمة بسيطة، وكان الجهاز مشغولاً وقتها. وهذا يعني أن الخطأ في التحقق قد يكون من المدقق وليس من رسالتك، فلا تبن قراراً آلياً على فشل واحد، وأعد التحقق قبل أن تحكم.
قاعدتان في الدليل ترفضان رسالة صحيحة
BV-00740: سبب الوفاة لمريض خرج إلى بيته
الخطأ الوحيد الباقي في مطالبة المنشأة يقول إن امتداد سبب الوفاة مطلوب إذا كانت حالة الخروج died. ولكن حالة الخروج في زيارتنا home، أي أن المريض خرج إلى بيته. وقرأنا التعبير في ملف تعريف encounter-claim-IMP داخل الحزمة:
(hospitalization.exists() implies hospitalization.dischargeDisposition.exists() implies hospitalization.dischargeDisposition.coding.first().code='died') or
(extension.where(url = '.../extension-emergencyDepartmentDisposition').value.ofType(CodeableConcept).coding.first().code='DED') or
(extension.where(url = '.../extension-emergencyDepartmentDisposition').value.ofType(CodeableConcept).coding.first().code='DOA')
implies extension.where(url = '.../extension-causeOfDeath').exists()والمشكلة في ترتيب العمليات. فالعامل implies أضعف من or في FHIRPath، فيقرأ التعبير كله على أنه «إذا تحقق الشرط الكبير فسبب الوفاة مطلوب»، والجزء الأول من الشرط الكبير صحيح في كل زيارة ليس فيها حالة خروج أصلاً، وفارغ في زيارة حالة خروجها غير الوفاة. وجربنا ثلاث نسخ من نفس الزيارة لنتأكد:
## IMP with dischargeDisposition = home
Constraint failed: BV-00740 ...
errors: 1
## IMP without dischargeDisposition
Constraint failed: BV-00740 ...
Constraint failed: BV-00758: 'If any of period.end, hospitalization.dischargeDisposition, hospitalization extension dischargeSpecialty then all must be specified.' ...
Constraint failed: BV-00759: 'Hospitalization Intended Length Of Stay SHALL be provided for claim with Inpatient Admission or DayCase Encounter Class.' ...
Constraint failed: BV-00852: 'Discharge Disposition and Encounter end Date SHALL be provided in claims with Inpatient or DayCase Admission Encounter Class when Discharge Specialty exists.' ...
errors: 4
## IMP home + causeOfDeath
errors: 0 warnings: 12أي أن الطريقة الوحيدة لتمرير مطالبة تنويم لمريض خرج حياً من مدقق الحزمة 1.0.0 هي أن تضيف له سبب وفاة. ولاحظ أيضاً القاعدة BV-00759 في النسخة الثانية: تقول إن المدة المتوقعة للإقامة مطلوبة، وهي موجودة في الزيارة، فظهرت بسبب حذف حقل آخر، وهذا يعني أن رسالة الخطأ لا تشير دائماً إلى السبب الحقيقي.
CANRQ002: سبب الإلغاء الذي لا يقبله الدليل
والثانية ظهرت عند الإلغاء. فقد ألغينا مطالبة البصريات لأن رمز الفحص فيها خطأ، واخترنا سبب الإلغاء «معلومات خاطئة» من نظام رموز أسباب المهام في الحزمة، ورمزه WI وعرضه wrong information. فجاء:
Constraint failed: CANRQ002: 'reasonCode SHALL be 'WP', 'NP or 'TAS'.' (defined in .../cancel-request)والنظام في الحزمة فيه خمسة رموز: WI وNP وTAS وSU وresubmission، ولا يوجد فيه WP أصلاً. فالقيد يطلب رمزاً غير موجود، ويرفض الرمز الذي يصف حالتنا. والبديلان المتاحان «الخدمة لم تقدم» و«المعاملة أرسلت سابقاً» لا يصفان ما حدث.
وفي الحالتين قرارنا في المختبر واحد، وهو نفس ما قلناه في مقال الأهلية: لا نضيف سبب وفاة لمريض حي، ولا نختار سبب إلغاء لا يصف الحقيقة لكي يمر التحقق. وإنما وضعنا القاعدتين في قائمة صريحة باسم القواعد المعروف أنها معطلة، يستثنيها المحاكي من الرفض ويطبعها السكربت منفصلة عن الأخطاء الأخرى، وهذا ما سوف تراه في المخرج بالشكل +1 known IG issue. وفي نظام حقيقي يكون هذا قراراً موثقاً مع بلاغ لفريق المنصة، لأنك لا تعرف إن كان مدقق المنصة يطبق نفس التعبير.
اختبارات تحمي القوالب من الإصدار القادم
بعد هذه الجولة أصبح عندنا خمسة قوالب تمر من التحقق، وقائمة بقاعدتين معطلتين. والسؤال العملي: كيف تبقى هذه الحال صحيحة بعد ستة أشهر، عندما يغير أحد المطورين حقلاً في القالب، أو تنشر المنصة إصداراً جديداً من الحزمة؟ والحل الذي نقترحه بسيط: مجلد في المستودع فيه مثال لكل نوع مطالبة وكل نوع رد، وملف صغير فيه القواعد المعروف أنها معطلة مع سبب كل منها، واختبار في خط التكامل المستمر CI يشغل سيرفر التحقق بإصدار الحزمة المثبت، ويتحقق من كل مثال، ويفشل إذا ظهر خطأ ليس في القائمة، ويفشل أيضاً إذا اختفى خطأ من القائمة، لأن هذا يعني أن المنصة أصلحته وأن الاستثناء لم يعد مبرراً:
# known-ig-issues: rules that fail valid messages in nphies-fs 1.0.0, each with its reason
KNOWN_IG_ISSUES = {
"BV-00740": "encounter-claim-IMP: 'implies' binds weaker than 'or', so every inpatient encounter needs causeOfDeath",
"BV-00559": "eligibility-response: the not-eligible branch returns false",
"BV-00561": "eligibility-response: the not-eligible branch returns false",
"CANRQ002": "cancel-request: asks for WP, which is not in task-reason-code; WI is",
}ويضاف إلى ذلك مثال خاطئ لكل قاعدة مهمة يجب أن يفشل، كما فعلنا مع العلامات الحيوية والعملة في مقال الأهلية، لأن الاختبار الذي يمر دائماً لا يثبت أن التحقق يعمل. ولاحظ أن تحميل الحزمة في سيرفر جديد يأخذ دقائق، فاجعل خط التكامل يبني صورة Docker فيها الحزمة محملة مسبقاً بدل أن يحملها في كل تشغيل، وارفع معها أنظمة الرموز المرخصة التي يحتاجها التحقق قبل أول طلب، لأننا رأينا أن HAPI يحتفظ بالنتيجة السلبية إذا سئل عن نظام قبل أن يرفع.
محاكي المنصة وشركة التأمين
لكي نرى ما يحدث بعد الإرسال، كتبنا sim.py بمكتبة Python القياسية، وهو يجمع دورين في خدمة واحدة: دور المنصة في التحقق والطابور والسحب، ودور شركة تأمين واحدة في القرار والإلغاء. وهذه قواعده:
- كل مطالبة يتحقق منها بنفس السيرفر قبل أي شيء، وإذا كان فيها خطأ غير القواعد المعطلة رجع OperationOutcome داخل رسالة، كما تفعل المنصة مع الرسالة التي لا تكفي معلوماتها.
- البنود التي لها نفس رقم الفاتورة ونفس الرمز ونفس التاريخ في مطالبة حية أخرى ترفض بالسبب
AD-2-4«خدمة مكررة بحسب التاريخ»، إلا إذا كانت المطالبة الجديدة إعادة إرسال تشير إلى الأصلية. - مطالبة المنشأة التي تتجاوز خمسة آلاف ريال تذهب إلى مراجعة بشرية: يرجع رد
queuedفوراً، والقرار النهائي يوضع في الطابور بعد 20 ثانية. - مطالبة الأسنان تحتاج صورة أشعة قبل القرار: يرجع
queued، ويوضع في الطابور طلب معلومات CommunicationRequest، والقرار لا يصدر حتى يصل الرد. - البصريات: بقي من حد منفعة البصريات 200 ريال فقط، فتأتي الموافقة جزئية بالسبب
CV-1-8، والإلغاء يرجع المبلغ إلى الحد. - المهنية والصيدلية: قرار فوري بالموافقة، مع نسبة تحمل 20% بسقف 75 ريالاً على المهنية والأسنان والبصريات.
والجزء الذي يستحق أن تقرأه من الكود هو السحب، لأنه بسيط ولكنه يحمل قراراً مهماً: الرسائل التي لم يحن وقتها تبقى في الطابور، والرد يخبرك إن بقي شيء جاهز:
def on_poll(b):
by = parts(b)
t = by["Task"][0]
count = next((i["valuePositiveInt"] for i in t.get("input", []) if i["type"]["coding"][0]["code"] == "count"), 1)
with LOCK:
ready = [q for q in QUEUE if q[0] <= time.time()][:count]
for q in ready:
QUEUE.remove(q)
left = len([q for q in QUEUE if q[0] <= time.time()])
waiting = len(QUEUE) - left
outs = [{"type": cc(CS + "task-output-type", "response"), "valueReference": {"reference": ME + "/Bundle/" + q[1]["id"]}} for q in ready]
resp = task_reply(b, "poll-response", "completed", outs or None)
msg = message("poll-response", resp, True, by["Organization"], by["MessageHeader"][0]["id"])
for q in ready:
msg["entry"].append({"fullUrl": ME + "/Bundle/" + q[1]["id"], "resource": q[1]})
if left:
msg["meta"]["tag"] = [{"system": CS + "meta-tags", "code": "queued-messages"}]
return msgونشغل المحاكي في Container على شبكة المختبر، بمتغير يحدد مدة المراجعة البشرية:
docker run -d --name nphies-lab-sim --network nphies-lab -e B=http://hapi:8080/fhir -e REVIEW_SECONDS=20 \
-v "$PWD:/lab" -w /lab nphies-lab-client python3 sim.py
docker logs nphies-lab-sim14:53:58 simulator listening on 8080, review delay 20 sوالعشرون ثانية هنا ضغط للوقت فقط، فالمراجعة البشرية في الواقع تأخذ ساعات أو أياماً، وطلب المعلومات قد ينتظر موظفاً في المستشفى يبحث عن صورة الأشعة في نظام آخر. ولكن ضغط الوقت مفيد في الاختبار لسبب مهم: أنه يجبر كودك على أن يعامل الرد المؤجل كحالة عادية في كل تشغيل، بدل أن تظهر هذه الحالة لأول مرة في الإنتاج. وفي اختباراتك الآلية اجعل المدة صفراً أحياناً وأطول من مهلة السحب أحياناً، لترى أن الكود يعمل في الحالتين. والمحاكي لا يحاول أن يشبه المنصة في كل شيء: لا توقيع ولا شهادات ولا رخص حقيقية ولا حدود معدل الطلبات، وإنما يكفي لاختبار المنطق الذي يحيط بالرسائل في نظامك، وهو الجزء الذي لا تختبره بيئة الاختبار الرسمية بالسهولة نفسها، لأنك لا تتحكم فيها في متى ترد الشركة وبماذا. ولذلك فالمحاكي لا يغني عن اختبار المطابقة في بيئة المنصة، وإنما يجعلك تصل إليه وأنت تعرف أن الحالات الصعبة تعمل.
المحاكي نفسه فشل في التحقق أولاً
جانب الطرف الآخر يستحق نفس الصرامة، لذلك يتحقق السكربت من كل رد يصله أيضاً. وفي التشغيل الأول للمسار كاملاً فشلت ردود المحاكي نفسه في التحقق، وهذه الأخطاء التي ظهرت، كل منها في مكان:
! .../ClaimResponse/cr-CL-2-INST-279d*/ Constraint failed: BV-00023: 'ClaimResponse total is not provided when ClaimResponse outcome is not equal to error.' ...
! .../Task/resp-poll-0daad934*/ Constraint failed: BV-00471: 'Task lastModified date cannot be in the future.' ...
! .../Communication/com-a8070033*/.payload[1].content.ofType(Attachment) Attachment.creation: minimum required = 1, but only found 0 (from .../DP-Attachment|1.0.0)
! .../Task/resp-cancel-e8d14a13*/ Task.reasonCode: minimum required = 1, but only found 0 (from .../cancel-response|1.0.0)في المخرج أعلاه لاحظ التالي:
- الرد بالحالة
queuedيجب أن يحملtotalأيضاً بحسب BV-00023، رغم أن الشركة لم تقرر شيئاً بعد. فوضعنا فيه المبلغ المرسل بالفئةsubmitted، حتى لا يفهم أحد أن هناك مبلغاً موافقاً عليه. - التاريخ دون وقت في
lastModifiedفشل بقاعدة «في المستقبل»، رغم أنه تاريخ اليوم. والسبب على الأغلب أن مقارنة تاريخ بلا وقت مع وقت كامل في منطقة زمنية أخرى لا تعطي نتيجة واضحة. والإصلاح أن ترسل الوقت كاملاً مع المنطقة الزمنية دائماً. - المرفق في رسالة المعلومات يحتاج تاريخ إنشائه
creation، وهذا ليس إلزامياً في المعيار الأساسي. - رد الإلغاء يجب أن يحمل سبب الإلغاء نفسه من الطلب.
والدرس لمن يكتب جانب شركة التأمين أو TPA: المنصة تتحقق من ردك كما تتحقق من طلب المستشفى، والرد الخاطئ لا يصل إلى المستشفى، وإنما يتحول إلى إشعار خطأ Error Notice يصلك في اتصال جديد بحسب صفحة معالجة الأخطاء. فالمطالبة تتأخر بسببك أنت وليس بسبب المستشفى.
نشغل المسار كاملاً
السكربت flow.py يمثل نظام المستشفى، ويمر بأربع مراحل: يرسل المطالبات الخمس، ثم يسحب حتى يصل كل ما ينتظره، ثم يجرب مطالبة مكررة، ثم يلغي مطالبة ويعيد إرسالها. وكل رسالة في الاتجاهين تمر على المدقق. وهذا المخرج كما هو من التشغيل النهائي:
python3 flow.py 3== 1. submit one claim of each type
institutional: request errors 0 (+1 known IG issue), round trip 3168 ms, response errors 0
ClaimResponse CL-3-INST: outcome=queued adjudication=-
professional: request errors 0 (+0 known IG issue), round trip 6269 ms, response errors 0
ClaimResponse CL-3-PROF: outcome=complete adjudication=approved
item 1: approved eligible 300 copay 60.0
pharmacy: request errors 0 (+0 known IG issue), round trip 2362 ms, response errors 0
ClaimResponse CL-3-PHAR: outcome=complete adjudication=approved
item 1: approved eligible 60 copay 0
oral: request errors 0 (+0 known IG issue), round trip 3566 ms, response errors 0
ClaimResponse CL-3-ORAL: outcome=queued adjudication=-
vision: request errors 0 (+0 known IG issue), round trip 3866 ms, response errors 0
ClaimResponse CL-3-VISI: outcome=complete adjudication=partial
item 1: partial eligible 200.0 copay 0 CV-1-8في المخرج أعلاه لاحظ التالي:
- ثلاث مطالبات انتهت في نفس الجلسة: المهنية بموافقة ونسبة تحمل 60 ريالاً، أي 20% من 300، والصيدلية بموافقة دون تحمل، والبصريات بموافقة جزئية على 200 من 250 مع السبب
CV-1-8. - مطالبتان رجعتا
queuedدون أي قرار، وهذا هو الرد الذي يجب ألا يعامله نظامك كنجاح أو فشل، وإنما كحالة انتظار لها متابعة. - زمن الذهاب والعودة بين ثانيتين وست ثوان، وأغلبه تحقق المحاكي من المطالبة قبل قرارها، وهو نفس استنتاج مقال الأهلية: التحقق أبطأ جزء في السلسلة.
== 2. poll until nothing is waiting (backoff 2, 4, 8 ... s)
poll: request errors 0 (+0 known IG issue), round trip 6 ms, response errors 0 | 2 message(s) at +6s []
-> claim-response
ClaimResponse CL-3-INST: outcome=complete adjudication=approved
item 1: approved eligible 9800 copay 0
-> communication-request
asks: Please send the pre-treatment radiograph of tooth 36.
communication: request errors 0 (+0 known IG issue), round trip 6 ms, response errors 0 -> acknowledgement
poll: request errors 0 (+0 known IG issue), round trip 17 ms, response errors 0 | 0 message(s) at +12s []
poll: request errors 0 (+0 known IG issue), round trip 7 ms, response errors 0 | 1 message(s) at +19s []
-> claim-response
ClaimResponse CL-3-ORAL: outcome=complete adjudication=approved
item 1: approved eligible 260 copay 52.0 في المخرج أعلاه لاحظ التالي:
- أول سحب بعد ست ثوان رجع رسالتين معاً لأننا طلبنا حتى خمس رسائل: القرار النهائي لمطالبة التنويم بالموافقة على 9,800، وطلب الشركة صورة أشعة السن 36.
- رد المستشفى بالمعلومات فرجع إقرار Acknowledgement فقط، وهذا صحيح بحسب الدليل، فالإقرار لا يعني القرار، والقرار يأتي لاحقاً عبر الطابور.
- السحب الثاني بعد ست ثوان أخرى لم يجد شيئاً، لأن الشركة لم تنته من مراجعة الصورة، فضاعف السكربت فترة الانتظار، ووجد القرار في السحب الثالث بعد 19 ثانية: موافقة على الحشوة مع تحمل 52 ريالاً.
- لم تظهر العلامة
queued-messagesفي أي سحب، لأننا كنا نطلب خمس رسائل وفي كل مرة لم يكن في الطابور أكثر مما أخذناه.

== 3. the same consultation again under a new claim id (duplicate)
duplicate: request errors 0 (+0 known IG issue), round trip 2000 ms, response errors 0
ClaimResponse CL-3-PROF-B: outcome=complete adjudication=rejected
item 1: rejected eligible 0 copay 0 AD-2-4
== 4. cancel the vision claim (wrong eye exam code), then resubmit with Claim.related = prior
cancel: request errors 0 (+1 known IG issue), round trip 11 ms, response errors 0 -> Task.status = completed
cancel again: request errors 0 (+1 known IG issue), round trip 3 ms, response errors 0 -> Task.status = failed
resubmission: request errors 0 (+0 known IG issue), round trip 2076 ms, response errors 0
ClaimResponse CL-3-VISI-R: outcome=complete adjudication=partial
item 1: partial eligible 200.0 copay 0 CV-1-8في المخرج أعلاه لاحظ التالي:
- المطالبة المكررة لها رقم مطالبة جديد، ولكن نفس رقم الفاتورة ونفس الخدمة ونفس التاريخ، فرفض بندها بالسبب
AD-2-4. وهذا هو السيناريو الذي يحدث عندما يعيد موظف إرسال مطالبة لأنه لم ير ردها، وهو سبب أن رقم الفاتورة على كل بند إلزامي في الدليل. - الإلغاء الأول نجح، والثاني لنفس المطالبة فشل لأنها ملغاة أصلاً، فرجع Task بالحالة
failedمع رمز خطأ. والسطران يحملان+1 known IG issue، وهي قاعدة سبب الإلغاء التي شرحناها. - إعادة الإرسال حملت
relatedبالقيمةprior، ولم ترفض كمكررة، لأن المحاكي يستثني المطالبة المشار إليها من فحص التكرار. ولكنها جاءت جزئية مرة أخرى بنفس المبلغ 200، لأن الإلغاء أرجع ما استهلك إلى الحد، والحد نفسه 200. وهذا ما يجب أن يتوقعه موظف المطالبات: إعادة الإرسال لا تغير الحدود.
وأخيراً، ماذا يحدث لمطالبة لا تكفي معلوماتها؟ أرسلنا مطالبة مهنية من البناء الأول إلى المحاكي مباشرة:
claim-response
OperationOutcome
This element does not match any known slice defined in the profile .../professional-claim|1.0.0 an
Claim.extension: minimum required = 2, but only found 1 (from .../professional-claim|1.0.0)
Slice 'Claim.extension:episode' for extension '.../extension-episode': a matching slice is require
Slice 'Claim.item.extension:patientInvoice' for extension '.../extension-patientInvoice': a matchi
Constraint failed: BV-00027: 'Claim diagnosis onAdmission is required for institutional claim tالرسالة رجعت بحدث claim-response، ولكن داخلها OperationOutcome وليس ClaimResponse. فإذا كان كود العميل يبحث عن ClaimResponse في كل رد ويتوقف إذا لم يجده، فسوف تختفي هذه المطالبة من شاشات الموظفين دون أن يعرف أحد أنها رفضت.
كيف يقرأ نظامك الرد؟
رأينا أن الرد قد يحمل ClaimResponse أو OperationOutcome، وقد يكون فورياً أو مؤجلاً. والخطوة التالية أن يفهم الكود ما بداخل ClaimResponse، لأن هذا ما يحدد كم سوف يدخل الحساب. والتسوية فيه على مستويين: البند والمجموع، وكل منهما قائمة من فئات التسوية Adjudication Categories، لكل فئة مبلغ أو قيمة. وهذه الدالة التي يقرأ بها السكربت البنود:
for it in cr.get("item", []):
a = {x["category"]["coding"][0]["code"]: x for x in it["adjudication"]}
reason = a["eligible"].get("reason", {}).get("coding", [{}])[0].get("code", "")
print(f" item {it['itemSequence']}: {it['extension'][0]['valueCodeableConcept']['coding'][0]['code']:<9}"
f" eligible {a['eligible']['amount']['value']:>7} copay {a['copay']['amount']['value']:>5} {reason}")والفئات التي استخدمناها هي نفس فئات الأمثلة في الحزمة: eligible المبلغ المقبول، وcopay ما يتحمله المريض، وbenefit ما تدفعه الشركة، ومن نظام المنصة approved-quantity الكمية الموافق عليها. ومع كل بند امتداد نتيجة التسوية: موافقة، أو جزئية، أو رفض، أو معلق Pended، أو لا يحتاج. ورمز السبب يأتي مع الفئة التي تأثرت. والقاعدة التي يجب أن يتبعها كودك أن يبني على الرموز وليس على النصوص، وأن يتوقع فئات لم يرها من قبل، مثل الضريبة tax التي تظهر في أحد أمثلة الحزمة، فلا يتوقف إذا ظهرت فئة جديدة، وإنما يحفظها ويعرضها.
وقد يتساءل البعض: لماذا لا يكفي أن نحسب المبلغ من المجموع total؟ والإجابة أن قرار البند هو ما يحتاجه كل قسم: الرفض بالسبب AD-1-4 يذهب إلى المرمز، وCV-1-8 يذهب إلى الاستقبال لأنه كان يجب أن يخبر المريض، وBE-1-4 يذهب إلى مكتب الموافقات. والمجموع وحده يقول إن هناك فرقاً ولا يقول أين ولماذا. لذلك احفظ تسوية كل بند في جدول مستقل بمفتاح المطالبة ورقم البند، ومنه تبني تقارير الرفض بحسب السبب والقسم.
تصميم السحب Polling في نظامك
من الدليل ومن المختبر نستطيع أن نكتب ما يحتاجه السحب ليكون موثوقاً، وأغلب هذه النقاط شرحناها بتوسع في مقال المهام الخلفية ومقال إعادة المحاولة وطابور الرسائل الميتة:
- مهمة دائمة واحدة: عملية واحدة تسحب لكل رخصة مقدم خدمة، وليس كل موظف من شاشته، حتى لا يأخذ الموظف رسالة ويغلق الصفحة قبل أن تحفظ.
- احفظ ثم عالج: الرسالة تخرج من طابور المنصة بمجرد أن ترجع في الرد، فاحفظها كما هي في قاعدة بياناتك قبل أي معالجة، ثم عالجها من جدولك. وإلا فإن خطأ في المعالجة يعني أن الرسالة ضاعت.
- اطلب أكثر من رسالة: استخدم
count، واستمر في السحب دون انتظار ما دامت العلامةqueued-messagesموجودة. - فترات متضاعفة Backoff مع حد أعلى: كما في السكربت، حتى لا تضغط على المنصة ولا تتأخر كثيراً.
- مرشحات للأولويات: سحب منفصل لطلبات المعلومات
communication-requestبفترة أقصر، لأن لها مهلة رد عند الشركة، وسحب مطابقة الدفع بفترة أطول. - المعالجة مرة واحدة Idempotency: الرسالة نفسها قد تصلك مرتين بعد انقطاع، فاستخدم معرف رأس الرسالة مفتاحاً فريداً، كما شرحنا في مقال Idempotency.
- مراقبة الصمت: تنبيه إذا لم تنجح أي عملية سحب خلال مدة تحددها، وتنبيه إذا بقيت مطالبة
queuedأكثر من عدد أيام معين، فعندها يرسل النظام طلب حالة Status Check. - التاريخ كاملاً: احفظ المطالبة ونسخها وكل رد عليها وكل إلغاء وكل إعادة إرسال كسجلات منفصلة مرتبطة، كما قلنا في مقال التأمين الصحي، حتى لا يحسب تقرير الحسابات المدينة نفس المبلغ مرتين.
جدول الأخطاء الشائعة ومن يصلحها
هذا الجدول من تشغيلنا ومن رموز الدليل معاً، والعمود الأخير هو الأهم، لأن الخطأ الذي يصل إلى قسم المطالبات وحده يعود مرة أخرى ما دام سببه في قسم آخر:
| الخطأ أو الرمز | من أين رأيناه | السبب | من يصلحه |
|---|---|---|---|
شريحة episode ناقصة | تشغيلنا، الأنواع الخمسة | النظام لا يعرف الحلقة العلاجية | فريق النظام: معرف حلقة يولد عند الدخول ويرث في المتابعة |
شريحة patientInvoice ناقصة | تشغيلنا، الأنواع الخمسة | الفاتورة لا ترتبط بالبند | فريق النظام والحسابات |
BV-00027 | تشغيلنا | حالة الدخول على تشخيص خارج التنويم | فريق النظام: الحقل حسب نوع المطالبة |
BV-00364 النوع الفرعي | تشغيلنا | مطالبة منشأة بنوع فرعي خارجي | فريق النظام |
BV-00736 نوع حدث الخدمة | تشغيلنا | زيارة العيادة دون أول زيارة أو متابعة | الاستقبال والنظام |
| شرائح المعلومات الداعمة المغلقة | تشغيلنا، 15 خطأ لكل نوع | نفس قالب المعلومات لكل الأنواع | فريق النظام: قالب لكل نوع |
علامة حيوية ناقصة مثل BV-00765 | تشغيلنا في مقال الأهلية | لم تقس أو لم تسجل | التمريض، أو رمز سبب الغياب الذي يسمح به الدليل |
AD-2-4 خدمة مكررة | المحاكي، وقائمة أسباب التسوية | إعادة إرسال برقم جديد | قسم المطالبات: إعادة الإرسال بالعلاقة prior أو الإلغاء أولاً |
CV-1-8 الحد مستنفد | المحاكي، وقائمة أسباب التسوية | الحد لا يكفي | الاستقبال: المنافع من رد الأهلية قبل الخدمة |
BE-1-4 موافقة مطلوبة ولم تؤخذ | قائمة أسباب التسوية | الطلب نفذ قبل الموافقة | مكتب الموافقات والطبيب |
AD-2-5 انتهت مهلة الإرسال | قائمة أسباب التسوية | مطالبة متأخرة في طابور داخلي | قسم المطالبات ومراقبة الطوابير |
1664 الوثيقة ملغاة أو منتهية | نظام adjudication-error | لم يتحقق من الأهلية يوم الخدمة | الاستقبال |
1670 الخدمة لا تتوافق مع الجنس | نظام adjudication-error | جنس خاطئ في التسجيل أو رمز خاطئ | التسجيل والترميز |
1672 خدمات خارج فترة التغطية | نظام adjudication-error | تاريخ خدمة خارج السريان | الاستقبال والتسجيل |
ولاحظ أن الأخطاء الستة الأولى مصدرها كود النظام في الغالب، وتختفي مرة واحدة إذا كتبت قالباً لكل نوع واختبرته. أما الباقي فمصدره سير العمل في المستشفى، ولا يحله الكود وحده، وإنما يحله أن يرى كل قسم أخطاءه في شاشته، وهذا موضوع مقال تدقيق المطالبات في نفس المرحلة.
أخطاء شائعة
- قالب واحد لكل الأنواع: رأينا 20 خطأ في مطالبة صيدلية بسبب معلومات داعمة لا تخصها.
- معاملة 200 كنجاح: رد 200 قد يكون OperationOutcome أو
queuedأو رفضاً. - البحث عن ClaimResponse فقط في الرد: الرد بالأخطاء يحمل OperationOutcome داخل رسالة بنفس الحدث.
- السحب دون
count: رسالة واحدة في كل طلب، والطابور يتأخر بصمت. - المعالجة قبل الحفظ: الرسالة خرجت من طابور المنصة ولن تعود.
- تعديل المطالبة بإعادة إرسالها برقم جديد: النتيجة رفض كمكررة، والصحيح الإلغاء أو العلاقة
prior. - تجاهل الإقرار وانتظار القرار في نفس الجلسة: القرار بعد تقديم المعلومات يأتي عبر السحب.
- اختبار جانب المستشفى فقط: ردود الشركة أيضاً تفشل في التحقق، وتتحول إلى إشعار خطأ.
- إخفاء القواعد المعطلة بتغيير البيانات: سبب وفاة لمريض حي ليس حلاً، والحل استثناء موثق.
- تاريخ دون وقت ومنطقة زمنية: فشل بقاعدة «في المستقبل» رغم أنه تاريخ اليوم.
قائمة تحقق Checklist قبل الإطلاق
| البند | كيف تتحقق منه |
|---|---|
| قالب لكل نوع من الأنواع الخمسة | مثال صحيح لكل نوع يمر في الاختبارات الآلية |
| معرف الحلقة ورقم الفاتورة | اختبار يفشل إذا غاب أحدهما |
| كل أنواع الردود معالجة | اختبارات للرد الفوري والمؤجل والجزئي وOperationOutcome والإقرار |
| مهمة السحب | تحفظ قبل المعالجة، وcount، والعلامة queued-messages، والمراقبة |
| طلبات المعلومات | تظهر في قائمة عمل لها مسؤول ومهلة |
| الإلغاء وإعادة الإرسال | زران مختلفان في الشاشة، ولا يوجد زر «تعديل المطالبة» |
| التكرار | النظام يمنع إرسال بند بنفس الفاتورة والرمز والتاريخ مرتين |
| القواعد المعطلة | قائمة موثقة تراجع مع كل إصدار للحزمة |
| التواريخ | وقت كامل مع المنطقة الزمنية في كل حقل dateTime |
| بيانات الاختبار | وهمية بالكامل في كل بيئات الاختبار، كما يشترط الدليل |
تنظيف المختبر
docker rm -f nphies-lab-sim
docker compose down -v
docker rmi nphies-lab-clientتدريب عملي
- أضف إلى المحاكي طلب الحالة Status Check، واجعل السكربت يرسله لأي مطالبة بقيت
queuedأكثر من 15 ثانية. - غير طلب السحب ليأخذ طلبات المعلومات فقط بالمرشح
include-message-type، وتحقق منه مقابل ملف التعريف. - أرسل ثلاث مطالبات في دفعة Batch بالامتدادات الثلاثة، واجعل المحاكي يرجع الردود بنفس الامتدادات.
الخلاصة
وصلنا لنهاية الموضوع، وأهم ما فيه:
- الأنواع الخمسة مورد Claim واحد، ولكن لكل نوع ملف تعريف بمعلومات داعمة مختلفة، وبناء واحد عام أعطى بين 8 و21 خطأ لكل نوع.
- معرف الحلقة ورقم الفاتورة إلزاميان على كل مطالبة، والثاني هو ما يكشف به التكرار، ورأينا الرفض
AD-2-4عندما أعيد إرسال نفس البند برقم مطالبة جديد. - المطالبة لا تعدل: الإلغاء للمحتوى الخاطئ، والمعلومات للمحتوى الصحيح الناقص، والعلاقة
priorلإعادة التقييم. - القرار قد يكون مؤجلاً، والردود المؤجلة وطلبات المعلومات لا تصل إلا بالسحب، فاحفظ ثم عالج، واطلب أكثر من رسالة، وراقب الصمت.
- رد 200 قد يحمل OperationOutcome أو
queued، فلا يحكم الكود من رمز HTTP. - قاعدتان في الحزمة 1.0.0 ترفضان رسالة صحيحة: سبب الوفاة لكل تنويم، وسبب إلغاء غير موجود في نظام رموزه، والحل استثناء موثق مع بلاغ.
- ردود الشركة نفسها فشلت أولاً في التحقق بأربع قواعد، فجانب الشركة يحتاج نفس الاختبارات.
دليلالأهلية Eligibility والموافقة المسبقة Prior Authorizationنبني رسائل الأهلية والموافقة المسبقة بدليل نفيس، ونتحقق منها في HAPI FHIR، ونرد عليها بشركة تأمين وهمية تفحص التغطية والحدود والتشخيص.
دليلتدقيق المطالبات Claims Adjudication: محرك القواعدنبني محرك قواعد صغيراً لتدقيق المطالبات الصحية بمراحل مرتبة، ونشغله على 200 مطالبة وهمية فيها 70 مشكلة مزروعة، ونقيس ما أمسكه وما فاته ولماذا.
دليلكشف الاحتيال في المطالبات الصحية Healthcare Fraudنبحث عن رفع الترميز والتفكيك والفوترة الوهمية والتكرار في مطالبات وهمية بالقواعد وبنموذج Isolation Forest، ونقيس الدقة والاستدعاء ونقرأ الإنذارات الكاذبة.
دليلالتأمين الصحي من الداخل: الشركة وTPA والوسيط والمستشفىمن يدفع القسط ومن يقرر الموافقة ومن يدير المطالبة في التأمين الصحي السعودي، وكيف يتحرك المال من صاحب العمل إلى المستشفى.
دليلالمنصات الصحية في السعودية: نفيس NPHIES وصحتي ووصفتيمن يملك كل منصة صحية وطنية وماذا تفعل، من صحتي ومستشفى صحة الافتراضي إلى نفيس والسجل الموحد، وما يعنيه ذلك لمن يبني نظاماً.
دليلخادم FHIR على سيرفرك: تجربة عملية مع HAPI FHIRكيف تشغل سيرفر FHIR يحفظ في PostgreSQL ويتحقق من البيانات بدليل نفيس، مع البحث بالأسماء العربية والنسخ والمعاملات.
دليلالترميز الطبي Clinical Coding: من ملف المريض إلى المطالبةكيف يحول المرمز توثيق الطبيب إلى رموز تشخيص وإجراءات ومجموعات DRG، وما الذي يلزم به مجلس الضمان الصحي في السعودية.
دليلالمهام الخلفية Background Jobs: لماذا لا ينتظر المستخدم؟كيف تخرج إرسال البريد ومعالجة الملفات من الطلب إلى عامل يعمل في الخلفية، مع تجربة على Celery وRedis تقيس زمن الطلب قبل وبعد وتقتل العامل في منتصف مهمة.سجل التحديثات
- 2026-11-18: كتابة المقال، وتنفيذ المختبر على HAPI FHIR 8.12.0 (hapiproject/hapi:v8.12.0-2) بإصدار FHIR R4 4.0.1 مع PostgreSQL 17 ودليل نفيس nphies-fs 1.0.0، ومحاك للمنصة وشركة تأمين بلغة Python 3.14 على alpine 3.24، وDocker Engine 29.8.0.