@ampath/esm-dha-workflow-app 4.0.0-next.34 → 4.0.0-next.340

package/src/billing/dashboard/v2/preauth/preauth-status-tag.component.tsx

@@ -0,0 +1,75 @@
+import React from 'react';
+import { InlineLoading, Tag } from '@carbon/react';
+import { isPreauthNeedsClarification, type PreauthCheckKind } from '../../../../claims/claims.resource';
+
+export type PreauthStatusDisplayKind = PreauthCheckKind | 'no_token' | 'loading';
+
+export interface PreauthStatusTagProps {
+  kind?: PreauthStatusDisplayKind | null;
+  status?: string;
+  preauthCode?: string;
+  loading?: boolean;
+}
+
+/**
+ * Shared preauth status Tag for list rows and other callers.
+ * Prefer `kind` from `checkPreauthStatus` / `usePreauthPreview`.
+ */
+const PreauthStatusTag: React.FC<PreauthStatusTagProps> = ({
+  kind,
+  status,
+  preauthCode,
+  loading,
+}) => {
+  if (loading || kind === 'loading') {
+    return <InlineLoading description="" />;
+  }
+
+  switch (kind) {
+    case 'no_token':
+      return (
+        <Tag size="sm" type="red">
+          No claim token
+        </Tag>
+      );
+    case 'finalised':
+      return (
+        <Tag size="sm" type="green" title={preauthCode ? `Code: ${preauthCode}` : undefined}>
+          {preauthCode ? `FINALISED · ${preauthCode}` : 'FINALISED'}
+        </Tag>
+      );
+    case 'pending':
+      return (
+        <Tag
+          size="sm"
+          type={isPreauthNeedsClarification(status ?? '') ? 'magenta' : 'purple'}
+          title={status?.trim() || undefined}
+        >
+          {isPreauthNeedsClarification(status ?? '')
+            ? 'Needs clarification'
+            : status?.trim() || 'Pending'}
+        </Tag>
+      );
+    case 'failed':
+      return (
+        <Tag size="sm" type="red">
+          {status?.trim() || 'Failed'}
+        </Tag>
+      );
+    case 'error':
+      return (
+        <Tag size="sm" type="magenta">
+          Error
+        </Tag>
+      );
+    case 'not_raised':
+    default:
+      return (
+        <Tag size="sm" type="gray">
+          Not raised
+        </Tag>
+      );
+  }
+};
+
+export default PreauthStatusTag;

package/src/billing/dashboard/v2/preauth/preauth-typed-fields.md

@@ -0,0 +1,125 @@
+# Preauth fields currently typed (EMR gap inventory)
+
+Independent checklist per scenario. Excludes data already extracted or inferred (consent/claim token, intervention code, doctor National ID / ID type / regulation body from provider + HWR).
+
+---
+
+## 1. Normal preauth
+
+| Currently typed / uploaded | HIE field(s) |
+| --- | --- |
+| ICD-11 *(if not picking a visit diagnosis)* | `diagnoses[].icd_code` |
+| Unit price *(if bill price missing/wrong)* | `items[].unit_price` |
+| Service start / end *(if defaults need change)* | `service_start`, `service_end` |
+| Provider notification email *(if not from session/HWR)* | `provider_notification_email` |
+| Attachments (generate or upload) | `attachments[]` + files |
+
+No specialty clinical narrative for Normal.
+
+---
+
+## 2. Surgical preauth
+
+Form-backed fields are loaded from the **POC Pre-authorization Form** (encounter type PREAUTHORIZATION) when present — shown read-only. Missing form answers block submit until the chart form is completed.
+
+| Source | HIE field(s) |
+| --- | --- |
+| Form: presenting complaints | `chief_complaint` |
+| Clerk (not on form) | `vital_signs` |
+| Form: HPI | `history_of_present_illness` |
+| Form: general examination | `physical_examination` |
+| Form: investigation report | `investigation_report_details` |
+| Form: anaesthesia | `type_of_anaesthesia` |
+| Form: encounter datetime | `surgery_date` |
+| Form: employment / accident / co-insurance | `is_condition_related_to_employment`, `is_condition_related_to_auto_or_other_accident`, `is_co_insured`, `co_insurance_details` |
+| ICD-11 *(if not from visit diagnosis)* | `diagnoses[].icd_code` |
+| Unit price *(if needed)* | `items[].unit_price` |
+| Service start / end *(if needed)* | `service_start`, `service_end` |
+| Provider email *(if needed)* | `provider_notification_email` |
+| Attachments | `attachments[]` + files |
+
+---
+
+## 3. Imaging preauth
+
+| Currently typed / uploaded | HIE field(s) |
+| --- | --- |
+| Clinical indications *(from clinical-notes obs / Pre-authorization form; read-only)* | `clinical_indications` |
+| ICD-11 *(if not from visit diagnosis)* | `diagnoses[].icd_code` |
+| Unit price *(if needed)* | `items[].unit_price` |
+| Service start / end *(if needed)* | `service_start`, `service_end` |
+| Provider email *(if needed)* | `provider_notification_email` |
+| Attachments | `attachments[]` + files |
+
+---
+
+## 4. Renal preauth
+
+Form-backed dialysis fields come from the **POC Pre-authorization Form** (read-only when present).
+
+| Source | HIE field(s) |
+| --- | --- |
+| Form: session number | `number_of_sessions_required` |
+| Clerk (not on form) | `cost_per_session` |
+| Form: frequency of sessions | `frequency_of_sessions` |
+| Form: clinical indication | `clinical_indications` |
+| Form: start date | `start_date` |
+| Form: co-insured (+ details when yes) | `is_co_insured`, `co_insurance_details` |
+| ICD-11 *(if not from visit diagnosis)* | `diagnoses[].icd_code` |
+| Unit price *(if needed)* | `items[].unit_price` |
+| Service start / end *(if needed)* | `service_start`, `service_end` |
+| Provider email *(if needed)* | `provider_notification_email` |
+| Attachments | `attachments[]` + files |
+
+---
+
+## 5. Oncology preauth
+
+| Currently typed / uploaded | HIE field(s) |
+| --- | --- |
+| Carcinoma staging | `carcinoma_staging` |
+| Comorbidity | `comorbidity` |
+| Metastases | `metastases` |
+| Treatment setting | `treatment_setting` |
+| Number of sessions required | `number_of_sessions_required` |
+| Cost per session | `cost_per_session` |
+| Is co-insured | `is_co_insured` |
+| ICD-11 *(if not from visit diagnosis)* | `diagnoses[].icd_code` |
+| Unit price *(if needed)* | `items[].unit_price` |
+| Service start / end *(if needed)* | `service_start`, `service_end` |
+| Provider email *(if needed)* | `provider_notification_email` |
+| Attachments | `attachments[]` + files |
+| Start date / progress report *(docs; start date not fully separate in current UI)* | `start_date`, `progress_report` |
+
+---
+
+## 6. Optical preauth
+
+| Currently typed / uploaded | HIE field(s) |
+| --- | --- |
+| Necessity of service | `necessity_of_service` |
+| Lens prescription | `lens_prescription` |
+| Lens amount | `lens_amount` |
+| Eye examination amount | `eye_examination_amount` |
+| Frame amount | `frame_amount` |
+| New or replacement | `new_or_replacement` |
+| Clinical indications *(required by HIE; ensure UI captures if not already)* | `clinical_indications` |
+| ICD-11 *(if not from visit diagnosis)* | `diagnoses[].icd_code` |
+| Unit price *(if needed)* | `items[].unit_price` |
+| Service start / end *(if needed)* | `service_start`, `service_end` |
+| Provider email *(if needed)* | `provider_notification_email` |
+| Attachments | `attachments[]` + files |
+
+---
+
+## Already available (excluded from tables above)
+
+- Consent / claim token
+- Intervention code
+- Doctor National ID, ID type, regulation body (OpenMRS provider attribute + HWR)
+
+## References
+
+- [Postman HIE Integrations UAT](https://documenter.getpostman.com/view/39260559/2sB3dSPoWf)
+- [eClaims Preauths API](https://hie-docs.dha.go.ke/eclaims/preauths)
+- [Normal](https://hie-docs.dha.go.ke/docs/claims/process/preauths/normalPreauths) · [Surgical](https://hie-docs.dha.go.ke/docs/claims/process/preauths/surgicalPreauths) · [Imaging](https://hie-docs.dha.go.ke/docs/claims/process/preauths/imagingPreauth) · [Renal](https://hie-docs.dha.go.ke/docs/claims/process/preauths/renalPreauth) · [Oncology](https://hie-docs.dha.go.ke/docs/claims/process/preauths/oncologyPreauth) · [Optical](https://hie-docs.dha.go.ke/docs/claims/process/preauths/opticalPreauth)