@kenyaemr/esm-billing-app 5.4.4-pre.430 → 5.4.4-pre.435

package/dist/routes.json

@@ -1 +1 @@
-{"$schema":"https://json.openmrs.org/routes.schema.json","backendDependencies":{"kenyaemr":"^19.0.0","kenyaemr.cashier":"^4.2.6-SNAPSHOT"},"pages":[{"component":"billableServicesHome","route":"billable-services"},{"component":"requirePaymentModal","routeRegex":"^patient/.+/chart","online":true,"offline":false},{"component":"billingAdmin","route":"billing-admin"},{"component":"resubmitClaimPage","route":"billing/resubmit-claim"}],"extensions":[{"component":"accountingDashboardLink","name":"accounting-dashboard-link","slots":["homepage-dashboard-slot"],"meta":{"name":"accounting","slot":"accounting-dashboard-slot","title":"Accounting"}},{"name":"billing-dashboard","component":"billingDashboard","slot":"accounting-dashboard-slot"},{"component":"benefitsPackageDashboardLink","name":"benefits-package-dashboard-link","meta":{"name":"benefits-package","slot":"patient-chart-benefits-dashboard-slot","path":"insurance-benefits","columns":1,"columnSpan":1},"featureFlag":"healthInformationExchange"},{"component":"benefitsPackage","name":"benefits-package","slot":"patient-chart-benefits-dashboard-slot"},{"component":"root","name":"billing-dashboard-root","slot":"billing-dashboard-slot"},{"component":"benefitsEligibilyRequestForm","name":"benefits-eligibility-request-form"},{"component":"benefitsPreAuthForm","name":"benefits-pre-auth-form"},{"name":"billing-patient-summary","component":"billingPatientSummary","slot":"patient-chart-billing-dashboard-slot","order":10,"meta":{"columnSpan":4}},{"name":"billing-summary-dashboard-link","component":"billingSummaryDashboardLink","order":11,"meta":{"columns":1,"columnSpan":1,"slot":"patient-chart-billing-dashboard-slot","path":"Billing","layoutMode":"anchored"}},{"name":"billing-check-in-form","slot":"visit-form-bottom-slot","component":"billingCheckInForm","order":1},{"name":"patient-banner-billing-tags","component":"visitAttributeTags","slot":"patient-banner-tags-slot","order":2},{"name":"initiate-payment-modal","component":"initiatePaymentDialog"},{"name":"delete-billableservice-modal","component":"deleteBillableServiceModal"},{"name":"refund-bill-modal","component":"refundBillModal"},{"name":"delete-bill-modal","component":"deleteBillModal"},{"name":"lab-order-billable-item","component":"labOrder","slot":"top-of-lab-order-form-slot"},{"name":"procedure-order-billable-item","component":"procedureOrder","slot":"top-of-procedure-order-form-slot"},{"name":"imaging-order-billable-item","component":"imagingOrder","slot":"top-of-imaging-order-form-slot"},{"name":"price-info-order","component":"priceInfoOrder"},{"name":"drug-order-billable-item","component":"drugOrder","slot":"medication-info-slot"},{"name":"order-action-button","component":"orderActionButton","slots":["prescription-action-button-slot","imaging-orders-action","procedure-orders-action","tests-ordered-actions-slot"],"order":0},{"component":"claimsManagementOverviewDashboardLink","name":"claims-management-overview-link","slots":["claims-management-dashboard-link-slot"]},{"component":"preAuthRequestsDashboardLink","name":"preauthrequest-overview-link","slots":["claims-management-dashboard-link-slot"]},{"component":"claimsOverview","name":"claims-overview-dashboard-link","slot":"claims-management-overview-slot"},{"name":"patient-preauth-widget","component":"patientPreauthWidget","slot":"ewf-preauth-dashboard-slot","meta":{"columnSpan":4}},{"component":"waiveBillActionButton","name":"waive-bill-action-button","slot":"bill-actions-slot"},{"component":"deleteBillActionButton","name":"delete-bill-action-button","slot":"bill-actions-slot"},{"component":"refundLineItem","name":"refund-line-item","slot":"bill-actions-overflow-menu-slot"},{"name":"edit-line-item","component":"editLineItem","slot":"bill-actions-overflow-menu-slot"},{"name":"cancel-line-item","component":"cancelLineItem","slot":"bill-actions-overflow-menu-slot"},{"name":"patient-info-sha-status","component":"patientBannerShaStatus","slot":"patient-banner-tags-slot"},{"name":"payments-points-dashboard-link","component":"paymentPointDashboardLink","slot":"billing-admin-dashboard-slot","meta":{"name":"cashier-points","title":"Payment Point","slot":"payment-point-dashboard-slot"}},{"name":"payment-points-dashboard","component":"paymentPoints","slot":"payment-point-dashboard-slot"},{"name":"payment-mode-dashboard-link","component":"paymentModeLink","slot":"billing-admin-dashboard-slot","meta":{"name":"payment-modes","title":"Payment Mode","slot":"payment-mode-dashboard-slot"}},{"name":"payment-mode-dashboard","component":"paymentModeDashboard","slot":"payment-mode-dashboard-slot"},{"name":"bill-deposit-dashboard-link","component":"billDepositDashboardLink","slot":"billing-admin-dashboard-slot","meta":{"name":"bill-deposit","title":"Bill Deposit","slot":"billing-deposit-dashboard-slot"}},{"name":"bill-deposit-dashboard","component":"billDepositDashboard","slot":"billing-deposit-dashboard-slot"},{"name":"billable-exemptions-dashboard-link","component":"billableExemptionsLink","slot":"billing-admin-dashboard-slot","meta":{"name":"billable-exemptions","title":"Billable Exemptions","slot":"billing-exemptions-dashboard-slot"}},{"name":"billable-exemptions-dashboard","component":"billableExemptions","slot":"billing-exemptions-dashboard-slot"},{"name":"clinical-charges-dashboard-link","component":"clinicalChargesLink","slot":"billing-admin-dashboard-slot","meta":{"name":"clinical-charges","title":"Clinical Charges","slot":"clinical-charges-dashboard-slot"}},{"name":"clinical-charges-dashboard","component":"clinicalCharges","slot":"clinical-charges-dashboard-slot"},{"name":"payment-history-dashboard-link","component":"paymentHistoryLink","slot":"billing-admin-dashboard-slot","meta":{"name":"payment-history","title":"Payment History","slot":"payment-history-dashboard-slot"}},{"name":"payment-history-dashboard","component":"paymentHistoryDashboard","slot":"payment-history-dashboard-slot"},{"name":"patient-billing-dashboard-link","component":"patientBillingLink","slot":"billing-admin-dashboard-slot","meta":{"name":"patient-billing","title":"Patient Billing","slot":"patient-billing-dashboard-slot"}},{"name":"patient-billing-dashboard","component":"patientBilling","slot":"patient-billing-dashboard-slot"}],"workspaces":[],"modals":[{"name":"create-payment-point","component":"createPaymentPoint"},{"name":"clock-out-modal","component":"clockOut"},{"name":"bulk-import-billable-services-modal","component":"bulkImportBillableServicesModal"},{"name":"delete-payment-mode-modal","component":"deletePaymentModeModal"},{"name":"manage-claim-request-modal","component":"manageClaimRequestModal"},{"name":"claim-preview-modal","component":"claimPreviewModal"},{"name":"close-claim-modal","component":"claimCloseModal"},{"name":"resubmit-claim-line-modal","component":"claimResubmitModal"},{"name":"edit-claim-line-modal","component":"claimEditLineModal"},{"name":"clock-in-modal","component":"clockIn"},{"name":"delete-claim-line-modal","component":"claimDeleteLineModal"},{"name":"create-bill-item-modal","component":"createBillItemModal"},{"name":"delete-deposit-modal","component":"deleteDepositModal"},{"name":"reverse-transaction-modal","component":"reverseTransactionModal"},{"name":"print-preview-modal","component":"printPreviewModal"},{"name":"bill-action-modal","component":"billActionModal"},{"name":"require-billing-modal","component":"requirePaymentModal"}],"workspaces2":[{"name":"create-bill-workspace","component":"createBillWorkspace","window":"billing-workspace-window"},{"name":"waive-bill-form","component":"waiveBillForm","window":"billing-workspace-window"},{"name":"edit-bill-form","component":"editBillForm","window":"billing-workspace-window"},{"name":"billable-service-form","component":"addServiceForm","window":"billing-workspace-window"},{"name":"commodity-form","component":"commodityForm","window":"billing-workspace-window"},{"name":"billing-form","component":"billingForm","window":"billing-extra-wide-workspace-window"},{"name":"payment-mode-workspace","component":"paymentModeWorkspace","window":"billing-workspace-window"},{"name":"cancel-bill-workspace","component":"cancelBillWorkspace","window":"billing-workspace-window"},{"name":"add-deposit-workspace","component":"addDepositWorkspace","window":"billing-workspace-window"},{"name":"deposit-transaction-workspace","component":"depositTransactionWorkspace","window":"billing-workspace-window"},{"name":"payment-workspace","component":"paymentWorkspace","window":"billing-workspace-window"},{"name":"claim-attachments-workspace","component":"claimAttachmentsWorkspace","window":"billing-workspace-window"},{"name":"claim-doctors-workspace","component":"claimDoctorsWorkspace","window":"billing-workspace-window"},{"name":"claim-submission-workspace","component":"claimSubmissionWorkspace","window":"billing-workspace-window"},{"name":"edit-drug-order","component":"@openmrs/esm-patient-medications-app#exportedAddDrugOrderWorkspace","window":"billing-workspace-window"},{"name":"preauth-form-workspace","component":"preauthFormWorkspace","window":"billing-workspace-window"},{"name":"elective-preauth-form-workspace","component":"electivePreauthFormWorkspace","window":"billing-workspace-window"},{"name":"preauth-operation-workspace","component":"preauthOperationWorkspace","window":"billing-workspace-window"}],"workspaceWindows2":[{"name":"billing-workspace-window","group":"billing-workspace-group","canMaximize":true},{"name":"billing-extra-wide-workspace-window","group":"billing-workspace-group","canMaximize":true,"width":"extra-wide"}],"workspaceGroups2":[{"name":"billing-workspace-group","persistence":"closeable","closeable":true}],"version":"5.4.4-pre.430"}
+{"$schema":"https://json.openmrs.org/routes.schema.json","backendDependencies":{"kenyaemr":"^19.0.0","kenyaemr.cashier":"^4.2.6-SNAPSHOT"},"pages":[{"component":"billableServicesHome","route":"billable-services"},{"component":"requirePaymentModal","routeRegex":"^patient/.+/chart","online":true,"offline":false},{"component":"billingAdmin","route":"billing-admin"},{"component":"resubmitClaimPage","route":"billing/resubmit-claim"}],"extensions":[{"component":"accountingDashboardLink","name":"accounting-dashboard-link","slots":["homepage-dashboard-slot"],"meta":{"name":"accounting","slot":"accounting-dashboard-slot","title":"Accounting"}},{"name":"billing-dashboard","component":"billingDashboard","slot":"accounting-dashboard-slot"},{"component":"benefitsPackageDashboardLink","name":"benefits-package-dashboard-link","meta":{"name":"benefits-package","slot":"patient-chart-benefits-dashboard-slot","path":"insurance-benefits","columns":1,"columnSpan":1},"featureFlag":"healthInformationExchange"},{"component":"benefitsPackage","name":"benefits-package","slot":"patient-chart-benefits-dashboard-slot"},{"component":"root","name":"billing-dashboard-root","slot":"billing-dashboard-slot"},{"component":"benefitsEligibilyRequestForm","name":"benefits-eligibility-request-form"},{"component":"benefitsPreAuthForm","name":"benefits-pre-auth-form"},{"name":"billing-patient-summary","component":"billingPatientSummary","slot":"patient-chart-billing-dashboard-slot","order":10,"meta":{"columnSpan":4}},{"name":"billing-summary-dashboard-link","component":"billingSummaryDashboardLink","order":11,"meta":{"columns":1,"columnSpan":1,"slot":"patient-chart-billing-dashboard-slot","path":"Billing","layoutMode":"anchored"}},{"name":"billing-check-in-form","slot":"visit-form-bottom-slot","component":"billingCheckInForm","order":1},{"name":"patient-banner-billing-tags","component":"visitAttributeTags","slot":"patient-banner-tags-slot","order":2},{"name":"initiate-payment-modal","component":"initiatePaymentDialog"},{"name":"delete-billableservice-modal","component":"deleteBillableServiceModal"},{"name":"refund-bill-modal","component":"refundBillModal"},{"name":"delete-bill-modal","component":"deleteBillModal"},{"name":"lab-order-billable-item","component":"labOrder","slot":"top-of-lab-order-form-slot"},{"name":"procedure-order-billable-item","component":"procedureOrder","slot":"top-of-procedure-order-form-slot"},{"name":"imaging-order-billable-item","component":"imagingOrder","slot":"top-of-imaging-order-form-slot"},{"name":"price-info-order","component":"priceInfoOrder"},{"name":"drug-order-billable-item","component":"drugOrder","slot":"medication-info-slot"},{"name":"order-action-button","component":"orderActionButton","slots":["prescription-action-button-slot","imaging-orders-action","procedure-orders-action","tests-ordered-actions-slot"],"order":0},{"component":"claimsManagementOverviewDashboardLink","name":"claims-management-overview-link","slots":["claims-management-dashboard-link-slot"]},{"component":"preAuthRequestsDashboardLink","name":"preauthrequest-overview-link","slots":["claims-management-dashboard-link-slot"]},{"component":"claimsOverview","name":"claims-overview-dashboard-link","slot":"claims-management-overview-slot"},{"name":"patient-preauth-widget","component":"patientPreauthWidget","slot":"ewf-preauth-dashboard-slot","meta":{"columnSpan":4}},{"component":"waiveBillActionButton","name":"waive-bill-action-button","slot":"bill-actions-slot"},{"component":"deleteBillActionButton","name":"delete-bill-action-button","slot":"bill-actions-slot"},{"component":"refundLineItem","name":"refund-line-item","slot":"bill-actions-overflow-menu-slot"},{"name":"edit-line-item","component":"editLineItem","slot":"bill-actions-overflow-menu-slot"},{"name":"cancel-line-item","component":"cancelLineItem","slot":"bill-actions-overflow-menu-slot"},{"name":"patient-info-sha-status","component":"patientBannerShaStatus","slot":"patient-banner-tags-slot"},{"name":"payments-points-dashboard-link","component":"paymentPointDashboardLink","slot":"billing-admin-dashboard-slot","meta":{"name":"cashier-points","title":"Payment Point","slot":"payment-point-dashboard-slot"}},{"name":"payment-points-dashboard","component":"paymentPoints","slot":"payment-point-dashboard-slot"},{"name":"payment-mode-dashboard-link","component":"paymentModeLink","slot":"billing-admin-dashboard-slot","meta":{"name":"payment-modes","title":"Payment Mode","slot":"payment-mode-dashboard-slot"}},{"name":"payment-mode-dashboard","component":"paymentModeDashboard","slot":"payment-mode-dashboard-slot"},{"name":"bill-deposit-dashboard-link","component":"billDepositDashboardLink","slot":"billing-admin-dashboard-slot","meta":{"name":"bill-deposit","title":"Bill Deposit","slot":"billing-deposit-dashboard-slot"}},{"name":"bill-deposit-dashboard","component":"billDepositDashboard","slot":"billing-deposit-dashboard-slot"},{"name":"billable-exemptions-dashboard-link","component":"billableExemptionsLink","slot":"billing-admin-dashboard-slot","meta":{"name":"billable-exemptions","title":"Billable Exemptions","slot":"billing-exemptions-dashboard-slot"}},{"name":"billable-exemptions-dashboard","component":"billableExemptions","slot":"billing-exemptions-dashboard-slot"},{"name":"clinical-charges-dashboard-link","component":"clinicalChargesLink","slot":"billing-admin-dashboard-slot","meta":{"name":"clinical-charges","title":"Clinical Charges","slot":"clinical-charges-dashboard-slot"}},{"name":"clinical-charges-dashboard","component":"clinicalCharges","slot":"clinical-charges-dashboard-slot"},{"name":"payment-history-dashboard-link","component":"paymentHistoryLink","slot":"billing-admin-dashboard-slot","meta":{"name":"payment-history","title":"Payment History","slot":"payment-history-dashboard-slot"}},{"name":"payment-history-dashboard","component":"paymentHistoryDashboard","slot":"payment-history-dashboard-slot"},{"name":"patient-billing-dashboard-link","component":"patientBillingLink","slot":"billing-admin-dashboard-slot","meta":{"name":"patient-billing","title":"Patient Billing","slot":"patient-billing-dashboard-slot"}},{"name":"patient-billing-dashboard","component":"patientBilling","slot":"patient-billing-dashboard-slot"}],"workspaces":[],"modals":[{"name":"create-payment-point","component":"createPaymentPoint"},{"name":"clock-out-modal","component":"clockOut"},{"name":"bulk-import-billable-services-modal","component":"bulkImportBillableServicesModal"},{"name":"delete-payment-mode-modal","component":"deletePaymentModeModal"},{"name":"manage-claim-request-modal","component":"manageClaimRequestModal"},{"name":"claim-preview-modal","component":"claimPreviewModal"},{"name":"close-claim-modal","component":"claimCloseModal"},{"name":"resubmit-claim-line-modal","component":"claimResubmitModal"},{"name":"edit-claim-line-modal","component":"claimEditLineModal"},{"name":"clock-in-modal","component":"clockIn"},{"name":"delete-claim-line-modal","component":"claimDeleteLineModal"},{"name":"create-bill-item-modal","component":"createBillItemModal"},{"name":"delete-deposit-modal","component":"deleteDepositModal"},{"name":"reverse-transaction-modal","component":"reverseTransactionModal"},{"name":"print-preview-modal","component":"printPreviewModal"},{"name":"bill-action-modal","component":"billActionModal"},{"name":"require-billing-modal","component":"requirePaymentModal"},{"name":"replace-claim-attachment-modal","component":"replaceAttachmentModal"},{"name":"resubmit-confirm-modal","component":"resubmitConfirmModal"}],"workspaces2":[{"name":"create-bill-workspace","component":"createBillWorkspace","window":"billing-workspace-window"},{"name":"waive-bill-form","component":"waiveBillForm","window":"billing-workspace-window"},{"name":"edit-bill-form","component":"editBillForm","window":"billing-workspace-window"},{"name":"billable-service-form","component":"addServiceForm","window":"billing-workspace-window"},{"name":"commodity-form","component":"commodityForm","window":"billing-workspace-window"},{"name":"billing-form","component":"billingForm","window":"billing-extra-wide-workspace-window"},{"name":"payment-mode-workspace","component":"paymentModeWorkspace","window":"billing-workspace-window"},{"name":"cancel-bill-workspace","component":"cancelBillWorkspace","window":"billing-workspace-window"},{"name":"add-deposit-workspace","component":"addDepositWorkspace","window":"billing-workspace-window"},{"name":"deposit-transaction-workspace","component":"depositTransactionWorkspace","window":"billing-workspace-window"},{"name":"payment-workspace","component":"paymentWorkspace","window":"billing-workspace-window"},{"name":"claim-attachments-workspace","component":"claimAttachmentsWorkspace","window":"billing-workspace-window"},{"name":"claim-doctors-workspace","component":"claimDoctorsWorkspace","window":"billing-workspace-window"},{"name":"claim-submission-workspace","component":"claimSubmissionWorkspace","window":"billing-workspace-window"},{"name":"edit-drug-order","component":"@openmrs/esm-patient-medications-app#exportedAddDrugOrderWorkspace","window":"billing-workspace-window"},{"name":"preauth-form-workspace","component":"preauthFormWorkspace","window":"billing-workspace-window"},{"name":"elective-preauth-form-workspace","component":"electivePreauthFormWorkspace","window":"billing-workspace-window"},{"name":"preauth-operation-workspace","component":"preauthOperationWorkspace","window":"billing-workspace-window"}],"workspaceWindows2":[{"name":"billing-workspace-window","group":"billing-workspace-group","canMaximize":true},{"name":"billing-extra-wide-workspace-window","group":"billing-workspace-group","canMaximize":true,"width":"extra-wide"}],"workspaceGroups2":[{"name":"billing-workspace-group","persistence":"closeable","closeable":true}],"version":"5.4.4-pre.435"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kenyaemr/esm-billing-app",
-  "version": "5.4.4-pre.430",
+  "version": "5.4.4-pre.435",
   "description": "Billing app for KenyaEMR",
   "keywords": [
     "openmrs"

package/src/claims/claims-wrap/claim-workspaces/attachements/claim-attachements-workspace.tsx

@@ -33,6 +33,8 @@ type ClaimAttachmentsWorkspaceProps = {
   applicableDocumentTypes: ReadonlyArray<string>;
   alreadyUploadedTypes: ReadonlyArray<string>;
   mutate: () => void;
+  preselectedDocumentType?: string;
+  replacementNotice?: { documentType: string; filename?: string };
 };
 
 type RowStatus = 'pending' | 'uploading' | 'succeeded' | 'already_sent' | 'failed';
@@ -60,6 +62,7 @@ const ClaimAttachmentsWorkspace: React.FC<Workspace2DefinitionProps<ClaimAttachm
 }) => {
   const { consentToken, interventionCode, interventionName, applicableDocumentTypes, alreadyUploadedTypes, mutate } =
     workspaceProps ?? ({} as ClaimAttachmentsWorkspaceProps);
+  const { preselectedDocumentType, replacementNotice } = workspaceProps ?? ({} as ClaimAttachmentsWorkspaceProps);
 
   const { t } = useTranslation();
   const isTablet = useLayoutType() === 'tablet';
@@ -110,6 +113,20 @@ const ClaimAttachmentsWorkspace: React.FC<Workspace2DefinitionProps<ClaimAttachm
     [watchedAttachments, availableDocumentTypes],
   );
 
+  React.useEffect(() => {
+    if (!preselectedDocumentType) {
+      return;
+    }
+    const tid = setTimeout(() => {
+      const current = getValues('attachments.0.document_type');
+      if (!current) {
+        setValue('attachments.0.document_type', preselectedDocumentType);
+      }
+    }, 0);
+    return () => clearTimeout(tid);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [preselectedDocumentType, getValues, setValue]);
+
   const pendingRowsCount = useMemo(() => {
     return attachmentFields.filter((f) => {
       const status = rowResults.get(f.id)?.status;

package/src/claims/claims-wrap/claim-workspaces/attachements/claim-attachments-resource.ts

@@ -104,3 +104,94 @@ export const useClaimAttachments = (consentToken: string | null) => {
     mutate,
   };
 };
+
+export const moveClaimToResubmit = async (params: {
+  consentToken: string;
+  t: TFunction;
+}): Promise<{ ok: boolean; error?: string; alreadyOpenForEdit?: boolean }> => {
+  const { consentToken, t } = params;
+  if (!consentToken) {
+    return { ok: false, error: t('noConsentToken', 'No consent token provided') };
+  }
+
+  try {
+    const response = await openmrsFetch(`${restBaseUrl}/virtualclaims/billing/resubmit`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: { consent_token: consentToken },
+    });
+    if (!response.ok) {
+      const upstream = extractUpstreamError(response.data);
+      return {
+        ok: false,
+        error:
+          upstream ??
+          t('moveToResubmitHttpError', 'Could not move claim to resubmit (HTTP {{status}})', {
+            status: response.status,
+          }),
+      };
+    }
+    const data = response.data as {
+      success?: boolean;
+      already_open_for_edit?: boolean;
+      error?: string;
+    };
+    if (data?.success === false) {
+      return { ok: false, error: data.error ?? t('moveToResubmitFailed', 'Could not move claim to resubmit') };
+    }
+    return { ok: true, alreadyOpenForEdit: data?.already_open_for_edit };
+  } catch (err) {
+    return {
+      ok: false,
+      error: extractFetchError(err, t('moveToResubmitFailed', 'Could not move claim to resubmit. Please try again.')),
+    };
+  }
+};
+
+export const retireClaimAttachment = async (params: {
+  consentToken: string;
+  attachmentUuid: string;
+  interventionCode: string;
+  t: TFunction;
+}): Promise<{ ok: boolean; error?: string; retrievalId?: string }> => {
+  const { consentToken, attachmentUuid, interventionCode, t } = params;
+  if (!consentToken) {
+    return { ok: false, error: t('noConsentToken', 'No consent token provided') };
+  }
+  if (!attachmentUuid) {
+    return { ok: false, error: t('noAttachmentUuid', 'No attachment selected') };
+  }
+  if (!interventionCode) {
+    return { ok: false, error: t('noInterventionCode', 'No intervention code provided') };
+  }
+
+  try {
+    const response = await openmrsFetch(`${restBaseUrl}/virtualclaims/billing/attachments`, {
+      method: 'PATCH',
+      headers: { 'Content-Type': 'application/json' },
+      body: {
+        consent_token: consentToken,
+        attachment_uuid: attachmentUuid,
+        intervention_code: interventionCode,
+      },
+    });
+    if (!response.ok) {
+      const upstream = extractUpstreamError(response.data);
+      return {
+        ok: false,
+        error:
+          upstream ?? t('retireAttachmentHttpError', 'Retire failed (HTTP {{status}})', { status: response.status }),
+      };
+    }
+    const data = response.data as { success?: boolean; retrieval_id?: string; error?: string };
+    if (data?.success === false) {
+      return { ok: false, error: data.error ?? t('retireFailed', 'Retire failed') };
+    }
+    return { ok: true, retrievalId: data?.retrieval_id };
+  } catch (err) {
+    return {
+      ok: false,
+      error: extractFetchError(err, t('retireFailed', 'Failed to retire attachment. Please try again.')),
+    };
+  }
+};

package/src/claims/claims-wrap/claim-workspaces/attachements/replace-attachment.modal.tsx

@@ -0,0 +1,62 @@
+import React from 'react';
+import { useTranslation } from 'react-i18next';
+import { Button, ModalBody, ModalFooter, ModalHeader } from '@carbon/react';
+
+interface ReplaceAttachmentModalProps {
+  documentType: string;
+  filename?: string;
+  closeModal: () => void;
+  onConfirm: () => Promise<void> | void;
+}
+
+const ReplaceAttachmentModal: React.FC<ReplaceAttachmentModalProps> = ({
+  documentType,
+  filename,
+  closeModal,
+  onConfirm,
+}) => {
+  const { t } = useTranslation();
+  const prettyType = documentType.replace(/_/g, ' ');
+
+  const handleConfirm = async () => {
+    closeModal();
+    await onConfirm();
+  };
+
+  return (
+    <>
+      <ModalHeader
+        closeModal={closeModal}
+        title={t('replaceAttachmentTitle', 'Replace {{type}}?', { type: prettyType })}
+      />
+      <ModalBody>
+        <p>
+          {filename
+            ? t(
+                'replaceAttachmentBodyWithFile',
+                'The current file ({{filename}}) will be retired from SHA. You will then need to upload a new file to complete the replacement.',
+                { filename },
+              )
+            : t(
+                'replaceAttachmentBody',
+                'The current {{type}} will be retired from SHA. You will then need to upload a new file to complete the replacement.',
+                { type: prettyType },
+              )}
+        </p>
+        <p style={{ marginTop: '0.75rem', fontSize: '0.8125rem', color: 'var(--cds-text-secondary, #525252)' }}>
+          {t('replaceAttachmentWarning', 'Until the replacement is uploaded the claim will be missing this document.')}
+        </p>
+      </ModalBody>
+      <ModalFooter>
+        <Button kind="secondary" onClick={closeModal}>
+          {t('cancel', 'Cancel')}
+        </Button>
+        <Button kind="danger" onClick={handleConfirm}>
+          {t('retireAndUploadNew', 'Retire & upload new')}
+        </Button>
+      </ModalFooter>
+    </>
+  );
+};
+
+export default ReplaceAttachmentModal;

package/src/claims/claims-wrap/claim-workspaces/claim-submission/ClaimSubmitWorkspace.tsx

@@ -56,6 +56,7 @@ type ClaimSubmitWorkspaceProps = {
   isResubmission?: boolean;
   totalAmount?: number;
   mutate: () => void;
+  providerWorkflowState?: string;
 };
 
 const RequiredLabel: React.FC<{ children: React.ReactNode }> = ({ children }) => (
@@ -80,6 +81,7 @@ const ClaimSubmitWorkspace: React.FC<Workspace2DefinitionProps<ClaimSubmitWorksp
     interventions,
     paymentMechanism,
     isResubmission = false,
+    providerWorkflowState,
     totalAmount,
     mutate,
   } = workspaceProps ?? ({} as ClaimSubmitWorkspaceProps);
@@ -149,12 +151,15 @@ const ClaimSubmitWorkspace: React.FC<Workspace2DefinitionProps<ClaimSubmitWorksp
   }, []);
 
   const runSubmit = useCallback(
-    async (auth: { otp: string } | { dischargeAuthGuid: string }) => {
+    async (auth: { otp: string } | { dischargeAuthGuid: string } | Record<string, never>) => {
       const params = {
         consentToken,
         invoiceNumber,
         dischargeReason: dischargeReasonRef.current,
-        ...('otp' in auth ? { otp: auth.otp } : { dischargeAuthGuid: auth.dischargeAuthGuid }),
+        ...('otp' in auth ? { otp: (auth as { otp: string }).otp } : {}),
+        ...('dischargeAuthGuid' in auth
+          ? { dischargeAuthGuid: (auth as { dischargeAuthGuid: string }).dischargeAuthGuid }
+          : {}),
       };
 
       const result = isInpatient
@@ -383,14 +388,51 @@ const ClaimSubmitWorkspace: React.FC<Workspace2DefinitionProps<ClaimSubmitWorksp
     [dischargeReasonItems, dischargeReasonSelected],
   );
 
+  const launchResubmitConfirm = useCallback(() => {
+    setSubmitError(null);
+    const dispose = showModal('resubmit-confirm-modal', {
+      consentToken,
+      onConfirm: async () => {
+        setIsSubmitting(true);
+        try {
+          await runSubmit({});
+          setSubmitSucceeded(true);
+          showSnackbar({
+            title: t('claimResubmitted', 'Claim resubmitted'),
+            subtitle: t('claimSubmittedDesc', 'Claim {{code}} sent to payer for review', {
+              code: consentToken,
+            }),
+            kind: 'success',
+            isLowContrast: true,
+          });
+          mutate();
+          setTimeout(() => closeWorkspace(), 800);
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          setSubmitError(msg);
+          throw err;
+        } finally {
+          setIsSubmitting(false);
+        }
+      },
+      closeModal: () => dispose(),
+    });
+  }, [consentToken, runSubmit, mutate, t]);
+
   if (!workspaceProps) {
     return null;
   }
 
+  const shouldSkipOtp = isResubmission && providerWorkflowState === 'DRAFT_RESUBMIT';
+
   const onContinue = (data: ClaimSubmitFormData) => {
     dischargeReasonRef.current = data.discharge_reason;
     dischargeDateIsoRef.current = isInpatient ? buildDischargeDateIso() : '';
-    launchAuthModal();
+    if (shouldSkipOtp) {
+      launchResubmitConfirm();
+    } else {
+      launchAuthModal();
+    }
   };
 
   const workspaceTitle = isResubmission
@@ -532,7 +574,9 @@ const ClaimSubmitWorkspace: React.FC<Workspace2DefinitionProps<ClaimSubmitWorksp
               <InlineLoading className={styles.spinner} description={t('verifying', 'Verifying…')} />
             ) : (
               <span>
-                {isResubmission
+                {shouldSkipOtp
+                  ? t('resubmitToSha', 'Resubmit to SHA')
+                  : isResubmission
                   ? t('continueResubmit', 'Continue to resubmit')
                   : t('continueToSubmit', 'Continue to submit')}
               </span>

package/src/claims/claims-wrap/claim-workspaces/claim-submission/resubmit-confirm.modal.tsx

@@ -0,0 +1,73 @@
+import React, { useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { Button, InlineLoading, InlineNotification, ModalBody, ModalFooter, ModalHeader } from '@carbon/react';
+
+interface ResubmitConfirmModalProps {
+  consentToken: string;
+  closeModal: () => void;
+  onConfirm: () => Promise<void> | void;
+}
+
+const ResubmitConfirmModal: React.FC<ResubmitConfirmModalProps> = ({ consentToken, closeModal, onConfirm }) => {
+  const { t } = useTranslation();
+  const [isSubmitting, setIsSubmitting] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const handleConfirm = async () => {
+    setError(null);
+    setIsSubmitting(true);
+    try {
+      await onConfirm();
+      closeModal();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+    } finally {
+      setIsSubmitting(false);
+    }
+  };
+
+  return (
+    <>
+      <ModalHeader closeModal={closeModal} title={t('resubmitConfirmTitle', 'Resubmit claim to SHA?')} />
+      <ModalBody>
+        <p>
+          {t(
+            'resubmitConfirmBody',
+            'Claim {{code}} will be sent back to the payer for re-review with the changes you made.',
+            { code: consentToken },
+          )}
+        </p>
+        <p style={{ marginTop: '0.75rem', fontSize: '0.8125rem', color: 'var(--cds-text-secondary, #525252)' }}>
+          {t(
+            'resubmitConfirmNote',
+            'The original consent token still authorizes this resubmission — no OTP or biometric verification is needed.',
+          )}
+        </p>
+        {error && (
+          <InlineNotification
+            kind="error"
+            lowContrast
+            hideCloseButton
+            title={t('resubmitFailed', 'Resubmit failed')}
+            subtitle={error}
+            style={{ marginTop: '1rem' }}
+          />
+        )}
+      </ModalBody>
+      <ModalFooter>
+        <Button kind="secondary" onClick={closeModal} disabled={isSubmitting}>
+          {t('cancel', 'Cancel')}
+        </Button>
+        <Button kind="danger" onClick={handleConfirm} disabled={isSubmitting}>
+          {isSubmitting ? (
+            <InlineLoading description={t('resubmitting', 'Resubmitting...')} />
+          ) : (
+            t('resubmitToSha', 'Resubmit to SHA')
+          )}
+        </Button>
+      </ModalFooter>
+    </>
+  );
+};
+
+export default ResubmitConfirmModal;