@kenyaemr/esm-billing-app 5.4.1-pre.1936 → 5.4.1-pre.1945

package/dist/routes.json

@@ -1 +1 @@
-{"$schema":"https://json.openmrs.org/routes.schema.json","backendDependencies":{"kenyaemr":"^19.0.0"},"pages":[{"component":"billableServicesHome","route":"billable-services"},{"component":"requirePaymentModal","routeRegex":"^patient/.+/chart","online":true,"offline":false}],"extensions":[{"component":"billingDashboardLink","name":"billing-dashboard-link","slot":"homepage-dashboard-slot","meta":{"name":"billing","title":"billing","slot":"billing-dashboard-slot"}},{"component":"benefitsPackageDashboardLink","name":"benefits-package-dashboard-link","slot":"patient-chart-dashboard-slot","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","slot":"patient-chart-dashboard-slot","order":11,"meta":{"columns":1,"columnSpan":1,"slot":"patient-chart-billing-dashboard-slot","path":"Billing","layoutMode":"anchored"}},{"name":"billing-check-in-form","slot":"extra-visit-attribute-slot","component":"billingCheckInForm"},{"name":"require-billing-modal","component":"requirePaymentModal"},{"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":"billing-test-order-action","component":"testOrderAction","slot":"tests-ordered-actions-slot","order":0},{"component":"billingOverviewLink","name":"billing-overview-link","order":0,"slot":"billing-dashboard-link-slot"},{"component":"paymentHistoryLink","name":"payment-history-link","slot":"billing-dashboard-link-slot"},{"component":"paymentPointsLink","name":"payment-points-link","slot":"billing-dashboard-link-slot"},{"component":"paymentModesLink","name":"payment-modes-link","slot":"billing-dashboard-link-slot"},{"component":"billManagerLink","name":"bill-manager-link","slot":"billing-dashboard-link-slot"},{"component":"chargeableItemsLink","name":"chargeable-items-link","slot":"billing-dashboard-link-slot"},{"component":"billableExemptionsLink","name":"billable-exemptions-link","slot":"billing-dashboard-link-slot"},{"component":"claimsManagementSideNavGroup","name":"claims-management-dashboard-link","slot":"homepage-dashboard-slot","meta":{"name":"claims-management","title":"Claims management Overview","slot":"case-management-slot"},"featureFlag":"healthInformationExchange"},{"component":"claimsManagementOverviewDashboardLink","name":"claims-management-overview-link","order":0,"slot":"claims-management-dashboard-link-slot"},{"component":"preAuthRequestsDashboardLink","name":"preauthrequest-overview-link","slot":"claims-management-dashboard-link-slot"},{"component":"claimsOverview","name":"claims-overview-dashboard-link","slot":"claims-management-overview-slot"},{"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"}],"workspaces":[{"name":"waive-bill-form","component":"waiveBillForm","title":"Waive Bill Form","type":"other-form"},{"name":"edit-bill-form","component":"editBillForm","title":"Edit Bill Form","type":"other-form"},{"name":"billable-service-form","component":"addServiceForm","title":"Create Charge Item Form","type":"other-form"},{"name":"commodity-form","component":"addCommodityForm","title":"Create Charge Item Form","type":"other-form"},{"name":"billing-form","component":"billingForm","title":"Billing Form","type":"other-form","width":"extra-wide"},{"name":"payment-mode-workspace","component":"paymentModeWorkspace","title":"Payment Mode Workspace","type":"other-form"},{"name":"cancel-bill-workspace","component":"cancelBillWorkspace","title":"Cancel Bill Workspace","type":"other-form"}],"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":"retry-claim-request-modal","component":"retryClaimRequestModal"},{"name":"paid-bill-receipt-print-preview-modal","component":"paidBillReceiptPrintPreviewModal"},{"name":"clock-in-modal","component":"clockIn"},{"name":"create-bill-item-modal","component":"createBillItemModal"}],"version":"5.4.1-pre.1936"}
+{"$schema":"https://json.openmrs.org/routes.schema.json","backendDependencies":{"kenyaemr":"^19.0.0"},"pages":[{"component":"billableServicesHome","route":"billable-services"},{"component":"requirePaymentModal","routeRegex":"^patient/.+/chart","online":true,"offline":false}],"extensions":[{"component":"billingDashboardLink","name":"billing-dashboard-link","slot":"homepage-dashboard-slot","meta":{"name":"billing","title":"billing","slot":"billing-dashboard-slot"}},{"component":"benefitsPackageDashboardLink","name":"benefits-package-dashboard-link","slot":"patient-chart-dashboard-slot","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","slot":"patient-chart-dashboard-slot","order":11,"meta":{"columns":1,"columnSpan":1,"slot":"patient-chart-billing-dashboard-slot","path":"Billing","layoutMode":"anchored"}},{"name":"billing-check-in-form","slot":"extra-visit-attribute-slot","component":"billingCheckInForm"},{"name":"require-billing-modal","component":"requirePaymentModal"},{"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","slot":"prescription-action-button-slot","order":0},{"component":"billingOverviewLink","name":"billing-overview-link","order":0,"slot":"billing-dashboard-link-slot"},{"component":"paymentHistoryLink","name":"payment-history-link","slot":"billing-dashboard-link-slot"},{"component":"paymentPointsLink","name":"payment-points-link","slot":"billing-dashboard-link-slot"},{"component":"paymentModesLink","name":"payment-modes-link","slot":"billing-dashboard-link-slot"},{"component":"billManagerLink","name":"bill-manager-link","slot":"billing-dashboard-link-slot"},{"component":"chargeableItemsLink","name":"chargeable-items-link","slot":"billing-dashboard-link-slot"},{"component":"billableExemptionsLink","name":"billable-exemptions-link","slot":"billing-dashboard-link-slot"},{"component":"claimsManagementSideNavGroup","name":"claims-management-dashboard-link","slot":"homepage-dashboard-slot","meta":{"name":"claims-management","title":"Claims management Overview","slot":"case-management-slot"},"featureFlag":"healthInformationExchange"},{"component":"claimsManagementOverviewDashboardLink","name":"claims-management-overview-link","order":0,"slot":"claims-management-dashboard-link-slot"},{"component":"preAuthRequestsDashboardLink","name":"preauthrequest-overview-link","slot":"claims-management-dashboard-link-slot"},{"component":"claimsOverview","name":"claims-overview-dashboard-link","slot":"claims-management-overview-slot"},{"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"}],"workspaces":[{"name":"waive-bill-form","component":"waiveBillForm","title":"Waive Bill Form","type":"other-form"},{"name":"edit-bill-form","component":"editBillForm","title":"Edit Bill Form","type":"other-form"},{"name":"billable-service-form","component":"addServiceForm","title":"Create Charge Item Form","type":"other-form"},{"name":"commodity-form","component":"addCommodityForm","title":"Create Charge Item Form","type":"other-form"},{"name":"billing-form","component":"billingForm","title":"Billing Form","type":"other-form","width":"extra-wide"},{"name":"payment-mode-workspace","component":"paymentModeWorkspace","title":"Payment Mode Workspace","type":"other-form"},{"name":"cancel-bill-workspace","component":"cancelBillWorkspace","title":"Cancel Bill Workspace","type":"other-form"}],"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":"retry-claim-request-modal","component":"retryClaimRequestModal"},{"name":"paid-bill-receipt-print-preview-modal","component":"paidBillReceiptPrintPreviewModal"},{"name":"clock-in-modal","component":"clockIn"},{"name":"create-bill-item-modal","component":"createBillItemModal"}],"version":"5.4.1-pre.1945"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kenyaemr/esm-billing-app",
-  "version": "5.4.1-pre.1936",
+  "version": "5.4.1-pre.1945",
   "description": "Billing app for KenyaEMR",
   "browser": "dist/kenyaemr-esm-billing-app.js",
   "main": "src/index.ts",

package/src/benefits-package/forms/packages-and-interventions-form.component.tsx

@@ -1,9 +1,9 @@
 import { Column, InlineLoading, InlineNotification, MultiSelect } from '@carbon/react';
-import React, { useEffect } from 'react';
+import React from 'react';
 import { Controller, useFormContext } from 'react-hook-form';
 import { useTranslation } from 'react-i18next';
-import PackageInterventions from './interventions-form.component';
 import usePackages from '../../hooks/usePackages';
+import PackageInterventions from './interventions-form.component';
 
 type Props = {
   patientUuid: string;
@@ -21,6 +21,19 @@ const SHABenefitPackangesAndInterventions: React.FC<Props> = ({ patientUuid }) =
     );
   }
 
+  if (packageError) {
+    return (
+      <InlineNotification
+        aria-label="closes notification"
+        kind="error"
+        lowContrast={true}
+        statusIconDescription="notification"
+        title={t('errorLoadingpackages', 'Error loading packages')}
+        subtitle={packageError?.message}
+      />
+    );
+  }
+
   return (
     <>
       <Column>

package/src/billable-services/billiable-item/order-actions/components/base-order-button.component.tsx

@@ -0,0 +1,42 @@
+import React from 'react';
+import { InlineLoading, Button } from '@carbon/react';
+import { useTranslation } from 'react-i18next';
+export type BaseOrderButtonProps = {
+  isDisabled: boolean;
+  isLoading: boolean;
+  buttonText: string;
+  onClick: () => void;
+  kind?: 'primary' | 'secondary' | 'ghost' | 'danger' | 'tertiary';
+  size?: 'sm' | 'md' | 'lg';
+  className?: string;
+  Icon?;
+};
+
+export const BaseOrderButton: React.FC<BaseOrderButtonProps> = ({
+  isDisabled,
+  isLoading,
+  buttonText,
+  onClick,
+  kind = 'primary',
+  size = 'md',
+  className = '',
+  Icon,
+}) => {
+  const { t } = useTranslation();
+
+  return (
+    <Button
+      kind={isLoading ? 'ghost' : kind}
+      renderIcon={!isLoading ? Icon : undefined}
+      className={className}
+      size={size}
+      disabled={isLoading || isDisabled}
+      onClick={onClick}>
+      {isLoading ? (
+        <InlineLoading description={t('verifyingBillStatus', 'Verifying bill status...')} status="active" />
+      ) : (
+        buttonText
+      )}
+    </Button>
+  );
+};

package/src/billable-services/billiable-item/order-actions/components/lab-order-button.component.tsx

@@ -0,0 +1,51 @@
+import React, { useCallback } from 'react';
+import { showModal } from '@openmrs/esm-framework';
+import { Order } from '@openmrs/esm-patient-common-lib';
+import { BaseOrderButton } from './base-order-button.component';
+import { useLabOrderAction } from '../hooks/useLabOrderAction';
+import { useModalHandler } from '../hooks/useModalHandler';
+import styles from '../styles/order-action.scss';
+
+export interface LabOrderButtonProps {
+  order?: Order;
+  modalName?: string;
+  additionalProps?: Record<string, unknown>;
+  actionText?: string;
+}
+
+export const LabOrderButton: React.FC<LabOrderButtonProps> = ({
+  order,
+  modalName = 'pickup-lab-request-modal',
+  additionalProps,
+  actionText,
+}) => {
+  const { isLoading, isDisabled, buttonText: defaultButtonText, isInProgress } = useLabOrderAction(order);
+
+  const { handleModalClose } = useModalHandler(additionalProps?.mutateUrl as string);
+  const buttonText = actionText ?? defaultButtonText;
+
+  const launchModal = useCallback(() => {
+    const dispose = showModal(modalName, {
+      closeModal: () => {
+        handleModalClose();
+        dispose();
+      },
+      order,
+      ...(additionalProps && { additionalProps }),
+    });
+  }, [modalName, order, additionalProps, handleModalClose]);
+
+  if (isInProgress) {
+    return null;
+  }
+
+  return (
+    <BaseOrderButton
+      isLoading={isLoading}
+      isDisabled={isDisabled}
+      buttonText={buttonText}
+      onClick={launchModal}
+      className={styles.actionButton}
+    />
+  );
+};

package/src/billable-services/billiable-item/order-actions/components/medication-order-button.component.tsx

@@ -0,0 +1,84 @@
+import React, { useCallback } from 'react';
+import { Edit } from '@carbon/react/icons';
+import { showModal, launchWorkspace } from '@openmrs/esm-framework';
+import { BaseOrderButton } from './base-order-button.component';
+import { useMedicationOrderAction, useOrderByUuid } from '../hooks/useMedicationOrderAction';
+import { launchPrescriptionEditWorkspace, useModalHandler } from '../hooks/useModalHandler';
+import { useTranslation } from 'react-i18next';
+export interface MedicationOrderButtonProps {
+  medicationRequestBundle?: {
+    request: fhir.MedicationRequest;
+  };
+  modalName?: string;
+  additionalProps?: Record<string, unknown>;
+  actionText?: string;
+  closeable?: boolean;
+}
+
+export const MedicationOrderButton: React.FC<MedicationOrderButtonProps> = ({
+  medicationRequestBundle,
+  modalName,
+  additionalProps,
+  actionText,
+  closeable = true,
+}) => {
+  const { t } = useTranslation();
+  const {
+    isLoading: isMedicationOrderLoading,
+    isDisabled,
+    buttonText: defaultButtonText,
+    shouldShowBillModal,
+    dispenseFormProps,
+    patientUuid,
+    shouldAllowModify,
+  } = useMedicationOrderAction(medicationRequestBundle);
+  const { data: order, isLoading: isOrderLoading } = useOrderByUuid(medicationRequestBundle?.request?.id);
+  const isLoading = isMedicationOrderLoading && isOrderLoading;
+
+  const { handleModalClose } = useModalHandler(additionalProps?.mutateUrl as string);
+  const buttonText = actionText ?? defaultButtonText;
+
+  const launchModal = useCallback(() => {
+    if (shouldShowBillModal) {
+      const disposeBill = showModal(modalName ?? 'create-bill-item-modal', {
+        closeModal: () => {
+          handleModalClose();
+          disposeBill();
+        },
+        medicationRequestBundle,
+      });
+      return;
+    }
+
+    if (dispenseFormProps) {
+      launchWorkspace('dispense-workspace', dispenseFormProps);
+    }
+  }, [modalName, shouldShowBillModal, handleModalClose, medicationRequestBundle, dispenseFormProps]);
+
+  if (!closeable) {
+    return null;
+  }
+
+  return (
+    <div>
+      {shouldAllowModify && (
+        <BaseOrderButton
+          size="lg"
+          kind="tertiary"
+          Icon={Edit}
+          isLoading={isLoading}
+          isDisabled={false}
+          buttonText={t('modify', 'Modify')}
+          onClick={() => launchPrescriptionEditWorkspace(order, patientUuid)}
+        />
+      )}
+      <BaseOrderButton
+        size="lg"
+        isLoading={isLoading}
+        isDisabled={isDisabled}
+        buttonText={buttonText}
+        onClick={launchModal}
+      />
+    </div>
+  );
+};

package/src/billable-services/billiable-item/order-actions/components/order-action-button.component.tsx

@@ -0,0 +1,29 @@
+import React from 'react';
+import { LabOrderButton } from './lab-order-button.component';
+import { MedicationOrderButton } from './medication-order-button.component';
+
+const OrderActionButton: React.FC<Record<string, any>> = (props) => {
+  if (Object.hasOwn(props, 'medicationRequestBundle')) {
+    const { medicationRequestBundle, modalName, additionalProps, actionText, closeable } = props;
+    return (
+      <MedicationOrderButton
+        medicationRequestBundle={medicationRequestBundle}
+        modalName={modalName}
+        additionalProps={additionalProps}
+        actionText={actionText}
+        closeable={closeable}
+      />
+    );
+  }
+
+  if (props.orderType === 'lab') {
+    const { order, modalName, additionalProps, actionText } = props;
+    return (
+      <LabOrderButton order={order} modalName={modalName} additionalProps={additionalProps} actionText={actionText} />
+    );
+  }
+
+  return null;
+};
+
+export default OrderActionButton;

package/src/billable-services/billiable-item/order-actions/hooks/useBillStatus.ts

@@ -0,0 +1,12 @@
+import { useOrderBill, useTestOrderBillStatus } from '../../test-order/test-order-action.resource';
+
+export function useBillStatus(orderUuid?: string, patientUuid?: string) {
+  const { isLoading, hasPendingPayment } = useTestOrderBillStatus(orderUuid, patientUuid);
+  const { itemHasBill } = useOrderBill(patientUuid, orderUuid);
+
+  return {
+    isLoading,
+    hasPendingPayment,
+    itemHasBill,
+  };
+}

package/src/billable-services/billiable-item/order-actions/hooks/useLabOrderAction.ts

@@ -0,0 +1,27 @@
+import { useTranslation } from 'react-i18next';
+import { Order } from '@openmrs/esm-patient-common-lib';
+import { useBillStatus } from './useBillStatus';
+
+export enum FulfillerStatus {
+  IN_PROGRESS = 'IN_PROGRESS',
+}
+
+export function useLabOrderAction(order?: Order) {
+  const { t } = useTranslation();
+  const orderUuid = order?.uuid;
+  const patientUuid = order?.patient?.uuid;
+
+  const { isLoading, hasPendingPayment } = useBillStatus(orderUuid, patientUuid);
+
+  const isInProgress = order?.fulfillerStatus === FulfillerStatus.IN_PROGRESS;
+  const buttonText = hasPendingPayment ? t('unsettledBill', 'Unsettled bill') : t('pickLabRequest', 'Pick Lab Request');
+
+  return {
+    isLoading,
+    isDisabled: hasPendingPayment,
+    buttonText,
+    isInProgress,
+    orderUuid,
+    patientUuid,
+  };
+}

package/src/billable-services/billiable-item/order-actions/hooks/useMedicationOrderAction.ts

@@ -0,0 +1,106 @@
+import { useTranslation } from 'react-i18next';
+import { useStockItemQuantity } from '../../useBillableItem';
+import { useBillableServices } from '../../../billable-service.resource';
+
+import { useBillStatus } from './useBillStatus';
+import { createMedicationDispenseProps } from '../../test-order/dispense.resource';
+
+interface MedicationRequest {
+  request: fhir.MedicationRequest;
+}
+
+export function useMedicationOrderAction(medicationRequestBundle?: MedicationRequest) {
+  const { t } = useTranslation();
+  const request = medicationRequestBundle?.request;
+  const orderUuid = request?.id;
+  const patientUuid = request?.subject?.reference?.split('/')[1];
+  const drugUuid = request?.medicationReference?.reference?.split('/')[1];
+
+  const { isLoading, hasPendingPayment, itemHasBill } = useBillStatus(orderUuid, patientUuid);
+  const { stockItemQuantity, stockItemUuid } = useStockItemQuantity(drugUuid);
+  const { billableServices } = useBillableServices();
+
+  const billableItem =
+    billableServices?.filter((service) => {
+      const stockItem = service?.stockItem.split(':')[0];
+      return stockItem === stockItemUuid;
+    }) || [];
+
+  const dispenseFormProps = medicationRequestBundle ? createMedicationDispenseProps({ medicationRequestBundle }) : null;
+
+  const shouldShowBillModal = stockItemQuantity > 0 && itemHasBill.length < 1 && billableItem.length > 0;
+  const isDisabled = hasPendingPayment || (stockItemQuantity < 1 && !!drugUuid);
+
+  // Modification is allowed only when:
+  // 1. There are no pending payments
+  // 2. Stock item is available (quantity > 0)
+  // 3. Item hasn't been billed yet (no existing bills)
+  // 4. Item exists in billable items list
+  const shouldAllowModify =
+    !hasPendingPayment && stockItemQuantity > 0 && itemHasBill.length < 1 && billableItem.length > 0;
+
+  const getButtonText = () => {
+    if (hasPendingPayment) {
+      return t('unsettledBill', 'Unsettled bill');
+    }
+
+    if (stockItemQuantity < 1 && drugUuid) {
+      return t('outOfStock', 'Out of Stock');
+    }
+
+    if (shouldShowBillModal) {
+      return t('bill', 'Bill');
+    }
+
+    return t('dispense', 'Dispense');
+  };
+
+  return {
+    isLoading,
+    isDisabled,
+    buttonText: getButtonText(),
+    shouldShowBillModal,
+    dispenseFormProps,
+    orderUuid,
+    patientUuid,
+    billableItem,
+    itemHasBill,
+    medicationRequestBundle,
+    hasPendingPayment,
+    shouldAllowModify,
+  };
+}
+
+import { useMemo } from 'react';
+import { FetchResponse, openmrsFetch, restBaseUrl } from '@openmrs/esm-framework';
+import { Order } from '@openmrs/esm-patient-common-lib';
+import useSWR from 'swr';
+
+const customRepresentation =
+  'custom:(uuid,dosingType,orderNumber,accessionNumber,' +
+  'patient:ref,action,careSetting:ref,previousOrder:ref,dateActivated,scheduledDate,dateStopped,autoExpireDate,' +
+  'orderType:ref,encounter:ref,orderer:(uuid,display,person:(display)),orderReason,orderReasonNonCoded,orderType,urgency,instructions,' +
+  'commentToFulfiller,drug:(uuid,display,strength,dosageForm:(display,uuid),concept),dose,doseUnits:ref,' +
+  'frequency:ref,asNeeded,asNeededCondition,quantity,quantityUnits:ref,numRefills,dosingInstructions,' +
+  'duration,durationUnits:ref,route:ref,brandName,dispenseAsWritten)';
+
+/**
+ * Hook to get a single order by UUID.
+ *
+ * @param orderUuid The UUID of the order to fetch.
+ */
+export function useOrderByUuid(orderUuid: string) {
+  const ordersUrl = useMemo(
+    () => (orderUuid ? `${restBaseUrl}/order/${orderUuid}?v=${customRepresentation}` : null),
+    [orderUuid],
+  );
+  const { data, error, isLoading, isValidating, mutate } = useSWR<FetchResponse<Order>, Error>(ordersUrl, openmrsFetch);
+
+  return {
+    data: data?.data,
+    error,
+    isLoading,
+    isValidating,
+    mutate,
+  };
+}

package/src/billable-services/billiable-item/order-actions/hooks/useModalHandler.ts

@@ -0,0 +1,66 @@
+import { launchWorkspace } from '@openmrs/esm-framework';
+import { Order } from '@openmrs/esm-patient-common-lib';
+import { useCallback } from 'react';
+import { mutate } from 'swr';
+
+export function useModalHandler(mutateUrl?: string) {
+  const handleModalClose = useCallback(() => {
+    if (!mutateUrl) {
+      return;
+    }
+
+    mutate((key) => typeof key === 'string' && key.startsWith(mutateUrl), undefined, {
+      revalidate: true,
+    });
+  }, [mutateUrl]);
+
+  return {
+    handleModalClose,
+  };
+}
+
+export const launchPrescriptionEditWorkspace = (order: Order, patientUuid: string) => {
+  const newItem = {
+    uuid: order.uuid,
+    display: order.drug?.display,
+    previousOrder: order.uuid,
+    startDate: new Date(),
+    action: 'REVISE',
+    drug: order.drug,
+    dosage: order.dose,
+    unit: {
+      value: order.doseUnits?.display,
+      valueCoded: order.doseUnits?.uuid,
+    },
+    frequency: {
+      valueCoded: order.frequency?.uuid,
+      value: order.frequency?.display,
+    },
+    route: {
+      valueCoded: order.route?.uuid,
+      value: order.route?.display,
+    },
+    commonMedicationName: order.drug?.display,
+    isFreeTextDosage: order.dosingType === 'org.openmrs.FreeTextDosingInstructions',
+    freeTextDosage: order.dosingType === 'org.openmrs.FreeTextDosingInstructions' ? order.dosingInstructions : '',
+    patientInstructions: order.dosingType !== 'org.openmrs.FreeTextDosingInstructions' ? order.dosingInstructions : '',
+    asNeeded: order.asNeeded,
+    asNeededCondition: order.asNeededCondition,
+    duration: order.duration,
+    durationUnit: {
+      valueCoded: order.durationUnits?.uuid,
+      value: order.durationUnits?.display,
+    },
+    pillsDispensed: order.quantity,
+    numRefills: order.numRefills,
+    indication: order.orderReasonNonCoded,
+    orderer: order.orderer?.uuid,
+    careSetting: order.careSetting?.uuid,
+    quantityUnits: {
+      value: order.quantityUnits?.display,
+      valueCoded: order.quantityUnits?.uuid,
+    },
+  };
+
+  launchWorkspace('add-drug-order', { patientUuid, order: newItem });
+};

package/src/claims/dashboard/form/claims-explanation-and-justification-form-input.component.tsx

@@ -0,0 +1,120 @@
+import { Column, InlineLoading, InlineNotification, Layer, TextArea } from '@carbon/react';
+import { usePatient } from '@openmrs/esm-framework';
+import React, { useEffect, useMemo } from 'react';
+import { Controller, useFormContext } from 'react-hook-form';
+import { useTranslation } from 'react-i18next';
+import { InterventionsFilter, useInterventions } from '../../../hooks/useInterventions';
+import usePackages from '../../../hooks/usePackages';
+import styles from './claims-form.scss';
+
+type ClaimExplanationAndJusificationInputProps = {
+  patientUuid: string;
+};
+const ClaimExplanationAndJusificationInput: React.FC<ClaimExplanationAndJusificationInputProps> = ({ patientUuid }) => {
+  const { error: patientError, isLoading: isPatientLoading, patient } = usePatient(patientUuid);
+
+  const form = useFormContext<{
+    claimExplanation: string;
+    claimJustification: string;
+    packages: Array<string>;
+    interventions: Array<string>;
+  }>();
+  const { t } = useTranslation();
+  const { isLoading: packagesLoading, error: packageError, packages: shaPackages } = usePackages();
+  const { setValue } = form;
+  const packagesObservable = form.watch('packages');
+  const interventionsObservable = form.watch('interventions');
+  const filters = useMemo<InterventionsFilter>(
+    () => ({
+      package_code: packagesObservable.join(','),
+      applicable_gender: patient?.gender === 'male' ? 'MALE' : 'FEMALE',
+    }),
+    [packagesObservable, patient],
+  );
+  const { error: interventionsError, isLoading: isLoadingInterventions, allInterventions } = useInterventions(filters);
+  const packagesSelected = useMemo(
+    () =>
+      packagesObservable
+        .map((packageCode) => shaPackages.find((pkg) => pkg.uuid === packageCode))
+        ?.map((p) => p?.packageName ?? '')
+        .filter(Boolean) ?? [],
+    [packagesObservable, shaPackages],
+  );
+  const interventionSelected = useMemo(
+    () =>
+      interventionsObservable.map(
+        (interventionCode) =>
+          allInterventions.find((intervention) => intervention.interventionCode === interventionCode)?.interventionName,
+      ) ?? [],
+    [interventionsObservable, allInterventions],
+  );
+
+  useEffect(() => {
+    setValue('claimExplanation', packagesSelected.join(', '));
+    setValue('claimJustification', interventionSelected.join(', '));
+  }, [packagesSelected, setValue, interventionSelected]);
+
+  if (packagesLoading || isPatientLoading || isLoadingInterventions) {
+    return (
+      <InlineLoading description={t('loading', 'Loading')} iconDescription={t('loading', 'Loading data') + '...'} />
+    );
+  }
+
+  if (packageError || patientError || interventionsError) {
+    return (
+      <InlineNotification
+        aria-label="closes notification"
+        kind="error"
+        lowContrast={true}
+        statusIconDescription="notification"
+        title={t('errorLoadingpackages', 'Error loading packages')}
+        subtitle={packageError?.message ?? packageError?.message ?? interventionsError?.message}
+      />
+    );
+  }
+
+  return (
+    <>
+      <Column>
+        <Layer className={styles.input}>
+          <Controller
+            control={form.control}
+            name="claimExplanation"
+            render={({ field, fieldState: { error } }) => (
+              <TextArea
+                {...field}
+                labelText={t('claimExplanation', 'Claim Explanation')}
+                rows={3}
+                placeholder="Claim Explanation"
+                id="claimExplanation"
+                invalid={!!error?.message}
+                invalidText={error?.message}
+              />
+            )}
+          />
+        </Layer>
+      </Column>
+      <Column>
+        <Layer className={styles.input}>
+          <Controller
+            control={form.control}
+            name="claimJustification"
+            render={({ field, fieldState: { error } }) => (
+              <TextArea
+                {...field}
+                labelText={t('claimJustification', 'Claim Justification')}
+                rows={3}
+                placeholder="Claim Justification"
+                id="claimJustification"
+                invalid={!!error?.message}
+                invalidText={error?.message}
+              />
+            )}
+          />
+        </Layer>
+      </Column>
+    </>
+  );
+};
+
+export default ClaimExplanationAndJusificationInput;