@openmrs/esm-billing-app 1.2.0 → 1.2.1-pre.1869

package/dist/openmrs-esm-billing-app.js.buildmanifest.json

@@ -151,10 +151,10 @@
       "rendered": true,
       "initial": true,
       "entry": true,
-      "size": 5531703,
+      "size": 5531794,
       "sizes": {
         "consume-shared": 210,
-        "javascript": 5531157,
+        "javascript": 5531248,
         "runtime": 13411,
         "share-init": 336
       },
@@ -171,7 +171,7 @@
       "auxiliaryFiles": [
         "main.js.map"
       ],
-      "hash": "e8b1902f9bccbcdf",
+      "hash": "f3cd0d09b604cb32",
       "childrenByOrder": {}
     },
     {
@@ -1658,10 +1658,10 @@
       "rendered": true,
       "initial": false,
       "entry": false,
-      "size": 1598242,
+      "size": 1598333,
       "sizes": {
         "consume-shared": 42,
-        "javascript": 1598200
+        "javascript": 1598291
       },
       "names": [],
       "idHints": [],
@@ -1674,7 +1674,7 @@
       "auxiliaryFiles": [
         "990.js.map"
       ],
-      "hash": "506460e25a0e7d17",
+      "hash": "239f1da0a4ef4be4",
       "childrenByOrder": {}
     }
   ]

package/dist/routes.json

@@ -1 +1 @@
-{"$schema":"https://json.openmrs.org/routes.schema.json","backendDependencies":{"billing":">=2.3.0-0","webservices.rest":">=2.24.0"},"pages":[{"component":"billableServicesHome","route":"billable-services"}],"extensions":[{"component":"billingDashboardLink","name":"billing-dashboard-link","slot":"homepage-dashboard-slot","meta":{"name":"billing","title":"billing","slot":"billing-dashboard-slot"}},{"component":"root","name":"billing-dashboard-root","slot":"billing-dashboard-slot"},{"name":"billing-patient-summary","component":"billingPatientSummary","slot":"patient-chart-billing-dashboard-slot","order":10,"meta":{"columnSpan":4}},{"name":"visit-bills-panel","component":"visitBillsPanel","slot":"visit-summary-panels","meta":{"title":"Bills"}},{"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-history"}},{"name":"billable-services-app-menu-item","component":"billableServicesAppMenuItem","slot":"app-menu-item-slot","meta":{"name":"Billable Services"}},{"name":"billing-checkin-form","slot":"extra-visit-attribute-slot","component":"billingCheckInForm"},{"slot":"system-admin-page-card-link-slot","component":"billableServicesCardLink","name":"billable-services-admin-card-link"},{"name":"patient-banner-billing-tags","component":"visitAttributeTags","slot":"patient-banner-tags-slot","order":2},{"name":"patient-banner-payment-status-tag","component":"patientPaymentStatusTag","slot":"patient-banner-tags-slot","order":3},{"name":"billable-services-left-panel-link","component":"billableServicesLeftPanelLink","slot":"billable-services-left-panel-slot","order":0},{"name":"billing-settings-left-panel-menu","component":"billingSettingsLeftPanelMenu","slot":"billable-services-left-panel-slot","order":1},{"name":"discount-requests-left-panel-link","component":"discountRequestsLeftPanelLink","slot":"billable-services-left-panel-slot","order":2},{"name":"refund-requests-left-panel-link","component":"refundRequestsLeftPanelLink","slot":"billable-services-left-panel-slot","order":3}],"modals":[{"name":"add-cash-point-modal","component":"addCashPointModal"},{"name":"payment-mode-form-modal","component":"paymentModeFormModal"},{"name":"delete-payment-mode-modal","component":"deletePaymentModeModal"},{"name":"edit-bill-item-modal","component":"editBillLineItemModal"},{"name":"edit-bill-line-item-modal","component":"editBillLineItemModal"},{"name":"require-billing-modal","component":"requirePaymentModal"},{"name":"delete-line-item-confirmation-modal","component":"deleteLineItemConfirmationModal"},{"name":"finalize-bill-confirmation-modal","component":"finalizeBillConfirmationModal"},{"name":"delete-bill-confirmation-modal","component":"deleteBillConfirmationModal"},{"name":"request-discount-modal","component":"requestDiscountModal"},{"name":"review-bill-discounts-modal","component":"reviewBillDiscountsModal"},{"name":"request-refund-modal","component":"requestRefundModal"},{"name":"review-bill-refunds-modal","component":"reviewBillRefundsModal"}],"workspaces2":[{"name":"billing-form-workspace","component":"billingFormWorkspace","window":"billing-form-window"},{"name":"billable-service-form","component":"billableServiceFormWorkspace","window":"billable-service-form-window"}],"workspaceWindows2":[{"name":"billing-form-window","group":"billingFormWorkspaceGroup"},{"name":"billable-service-form-window","group":"billingFormWorkspaceGroup","width":"wider"}],"workspaceGroups2":[{"name":"billingFormWorkspaceGroup","overlay":false}],"version":"1.2.0"}
+{"$schema":"https://json.openmrs.org/routes.schema.json","backendDependencies":{"billing":">=2.3.0-0","webservices.rest":">=2.24.0"},"pages":[{"component":"billableServicesHome","route":"billable-services"}],"extensions":[{"component":"billingDashboardLink","name":"billing-dashboard-link","slot":"homepage-dashboard-slot","meta":{"name":"billing","title":"billing","slot":"billing-dashboard-slot"}},{"component":"root","name":"billing-dashboard-root","slot":"billing-dashboard-slot"},{"name":"billing-patient-summary","component":"billingPatientSummary","slot":"patient-chart-billing-dashboard-slot","order":10,"meta":{"columnSpan":4}},{"name":"visit-bills-panel","component":"visitBillsPanel","slot":"visit-summary-panels","meta":{"title":"Bills"}},{"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-history"}},{"name":"billable-services-app-menu-item","component":"billableServicesAppMenuItem","slot":"app-menu-item-slot","meta":{"name":"Billable Services"}},{"name":"billing-checkin-form","slot":"extra-visit-attribute-slot","component":"billingCheckInForm"},{"slot":"system-admin-page-card-link-slot","component":"billableServicesCardLink","name":"billable-services-admin-card-link"},{"name":"patient-banner-billing-tags","component":"visitAttributeTags","slot":"patient-banner-tags-slot","order":2},{"name":"patient-banner-payment-status-tag","component":"patientPaymentStatusTag","slot":"patient-banner-tags-slot","order":3},{"name":"billable-services-left-panel-link","component":"billableServicesLeftPanelLink","slot":"billable-services-left-panel-slot","order":0},{"name":"billing-settings-left-panel-menu","component":"billingSettingsLeftPanelMenu","slot":"billable-services-left-panel-slot","order":1},{"name":"discount-requests-left-panel-link","component":"discountRequestsLeftPanelLink","slot":"billable-services-left-panel-slot","order":2},{"name":"refund-requests-left-panel-link","component":"refundRequestsLeftPanelLink","slot":"billable-services-left-panel-slot","order":3}],"modals":[{"name":"add-cash-point-modal","component":"addCashPointModal"},{"name":"payment-mode-form-modal","component":"paymentModeFormModal"},{"name":"delete-payment-mode-modal","component":"deletePaymentModeModal"},{"name":"edit-bill-item-modal","component":"editBillLineItemModal"},{"name":"edit-bill-line-item-modal","component":"editBillLineItemModal"},{"name":"require-billing-modal","component":"requirePaymentModal"},{"name":"delete-line-item-confirmation-modal","component":"deleteLineItemConfirmationModal"},{"name":"finalize-bill-confirmation-modal","component":"finalizeBillConfirmationModal"},{"name":"delete-bill-confirmation-modal","component":"deleteBillConfirmationModal"},{"name":"request-discount-modal","component":"requestDiscountModal"},{"name":"review-bill-discounts-modal","component":"reviewBillDiscountsModal"},{"name":"request-refund-modal","component":"requestRefundModal"},{"name":"review-bill-refunds-modal","component":"reviewBillRefundsModal"}],"workspaces2":[{"name":"billing-form-workspace","component":"billingFormWorkspace","window":"billing-form-window"},{"name":"billable-service-form","component":"billableServiceFormWorkspace","window":"billable-service-form-window"}],"workspaceWindows2":[{"name":"billing-form-window","group":"billingFormWorkspaceGroup"},{"name":"billable-service-form-window","group":"billingFormWorkspaceGroup","width":"wider"}],"workspaceGroups2":[{"name":"billingFormWorkspaceGroup","overlay":false}],"version":"1.2.1-pre.1869"}

package/e2e/pages/index.ts

@@ -3,3 +3,4 @@ export * from './billing-form-page';
 export * from './invoice-page';
 export * from './payment-page';
 export * from './discounts-page';
+export * from './refunds-page';

package/e2e/pages/refunds-page.ts

@@ -0,0 +1,63 @@
+import { type Page, expect } from '@playwright/test';
+
+export class RefundRequestModal {
+  constructor(readonly page: Page) {}
+
+  readonly modal = () =>
+    this.page.getByRole('dialog').filter({ has: this.page.getByRole('heading', { name: /request refund/i }) });
+  readonly amountInput = () => this.modal().locator('#refund-amount');
+  readonly reasonInput = () => this.modal().locator('#refund-reason');
+  readonly submitButton = () => this.modal().getByRole('button', { name: /submit request/i });
+
+  async submitRefund(amount: number, reason: string) {
+    await this.modal().waitFor({ state: 'visible' });
+    // Carbon NumberInput: clear then type
+    await this.amountInput().fill(amount.toString());
+    await this.reasonInput().fill(reason);
+    await expect(this.submitButton()).toBeEnabled();
+    await this.submitButton().click();
+  }
+}
+
+export class RefundRequestsAdminPage {
+  constructor(readonly page: Page) {}
+
+  readonly heading = () => this.page.getByRole('heading', { name: /refund requests/i });
+  readonly filterDropdown = () => this.page.getByRole('combobox', { name: /filter by/i });
+  readonly requestsTable = () => this.page.getByRole('table', { name: /refund requests/i });
+  readonly searchInput = () => this.page.getByTestId('refundRequestsSearchBar');
+
+  async goto() {
+    await this.page.goto('billable-services/refund-requests');
+  }
+
+  async waitForLoaded() {
+    await this.heading().waitFor({ state: 'visible' });
+  }
+
+  async openReviewForPatient(patientName: string) {
+    await this.searchInput().fill(patientName);
+    const row = this.requestsTable().locator('tbody tr').filter({ hasText: patientName }).first();
+    await row.waitFor({ state: 'visible' });
+    await row.getByRole('link').first().click();
+  }
+}
+
+export class ReviewBillRefundsModal {
+  constructor(readonly page: Page) {}
+
+  readonly modal = () =>
+    this.page.getByRole('dialog').filter({ has: this.page.getByRole('heading', { name: /review refunds/i }) });
+  readonly firstRefundCard = () => this.modal().locator('article').first();
+
+  async waitForLoaded() {
+    await this.modal().waitFor({ state: 'visible' });
+    await this.firstRefundCard().waitFor({ state: 'visible' });
+  }
+
+  async approveFirstPending() {
+    await this.firstRefundCard()
+      .getByRole('button', { name: /^approve$/i })
+      .click();
+  }
+}

package/e2e/specs/bill-refunds.spec.ts

@@ -0,0 +1,173 @@
+import { expect } from '@playwright/test';
+import { test } from '../core/test';
+import { deleteBill, ensureServiceHasPrices, extractNumericValue, waitForSuccessNotification } from '../commands';
+import {
+  BillingDashboardPage,
+  BillingFormPage,
+  InvoicePage,
+  PaymentPage,
+  RefundRequestModal,
+  RefundRequestsAdminPage,
+  ReviewBillRefundsModal,
+} from '../pages';
+
+test.describe('Bill refund workflow', () => {
+  test.describe.configure({ mode: 'serial' });
+
+  let testServiceName: string;
+  const billsToCleanup = new Set<string>();
+
+  test.beforeAll(async ({ api }) => {
+    const serviceUuid = process.env.E2E_TEST_SERVICE_UUID;
+    if (!serviceUuid) {
+      throw new Error('E2E_TEST_SERVICE_UUID must be configured in .env file');
+    }
+
+    const service = await ensureServiceHasPrices(api, serviceUuid, 30);
+    testServiceName = service.name;
+
+    const cashPrice = service.servicePrices.find((sp) => sp.name === 'Cash');
+    if (!cashPrice) {
+      throw new Error('Cash price not found for test service');
+    }
+  });
+
+  test.afterEach(async ({ api }) => {
+    for (const billUuid of billsToCleanup) {
+      try {
+        await deleteBill(api, billUuid);
+      } catch (error) {
+        console.error(`Failed to delete bill ${billUuid}:`, error);
+      }
+    }
+    billsToCleanup.clear();
+  });
+
+  test('Cashier requests a refund, admin approves it, cashier processes it', async ({ page, api, patient }) => {
+    const billingDashboardPage = new BillingDashboardPage(page);
+    const billingFormPage = new BillingFormPage(page);
+    const invoicePage = new InvoicePage(page);
+    const paymentPage = new PaymentPage(page);
+    const refundModal = new RefundRequestModal(page);
+    const refundRequestsPage = new RefundRequestsAdminPage(page);
+    const reviewModal = new ReviewBillRefundsModal(page);
+
+    const patientUuid = patient.uuid;
+    const patientName = patient.person.display;
+    const refundReason = `e2e test refund ${Date.now()}`;
+    let billUuid: string;
+    let refundAmount: number;
+
+    await test.step('Given a PAID bill exists for the patient', async () => {
+      await page.goto(`patient/${patientUuid}/chart/billing-history`);
+      await page.getByRole('button', { name: /launch bill form|add bill|create bill/i }).click();
+
+      await billingFormPage.searchAndSelectBillableService(testServiceName);
+      await billingFormPage.selectPaymentMethodIfVisible();
+      await billingFormPage.saveBill();
+      await waitForSuccessNotification(page, /bill processed successfully/i);
+
+      const billsResponse = await api.get(`billing/bill?patient=${patientUuid}&v=full`);
+      const billsData = await billsResponse.json();
+      billUuid = billsData.results[0].uuid;
+      billsToCleanup.add(billUuid);
+
+      await billingDashboardPage.goto();
+      await billingDashboardPage.waitForBillsTableToLoad();
+      await billingDashboardPage.selectFilter('Pending confirmation');
+      await billingDashboardPage.waitForBillsTableToLoad();
+      await billingDashboardPage.clickInvoiceNumberLink(patientName);
+      await invoicePage.waitForInvoiceToLoad();
+
+      await invoicePage.finalizeBill();
+      await waitForSuccessNotification(page, /bill finalized/i);
+      await expect.poll(async () => await invoicePage.getInvoiceStatus()).toBe('POSTED');
+
+      await paymentPage.waitForPaymentForm();
+      const amountDue = await invoicePage.getAmountDue();
+      await paymentPage.addPayment('Cash', extractNumericValue(amountDue));
+      await paymentPage.processPayment();
+      await waitForSuccessNotification(page, /payment processed successfully/i);
+
+      await page.reload();
+      await invoicePage.waitForInvoiceToLoad();
+      await expect.poll(async () => await invoicePage.getInvoiceStatus()).toBe('PAID');
+    });
+
+    await test.step('When the cashier requests a refund for the full bill amount', async () => {
+      const totalAmount = await invoicePage.getTotalAmount();
+      refundAmount = extractNumericValue(totalAmount);
+
+      await page.getByRole('button', { name: /request refund/i }).click();
+      await refundModal.submitRefund(refundAmount, refundReason);
+      await waitForSuccessNotification(page, /refund request submitted/i);
+    });
+
+    await test.step('Then the refund appears as REQUESTED via the API', async () => {
+      const billResponse = await api.get(`billing/bill/${billUuid}?v=full`);
+      const billData = await billResponse.json();
+      const refunds: Array<{ status: string; refundAmount: number; reason: string }> = billData.refunds;
+      expect(refunds).toHaveLength(1);
+      expect(refunds[0].status).toBe('REQUESTED');
+      expect(refunds[0].refundAmount).toBeCloseTo(refundAmount, 2);
+      expect(refunds[0].reason).toBe(refundReason);
+    });
+
+    await test.step('When the admin approves the refund from the refund requests dashboard', async () => {
+      await refundRequestsPage.goto();
+      await refundRequestsPage.waitForLoaded();
+      await refundRequestsPage.openReviewForPatient(patientName);
+
+      await reviewModal.waitForLoaded();
+      await reviewModal.approveFirstPending();
+      await waitForSuccessNotification(page, /refund approved/i);
+    });
+
+    await test.step('Then the refund status is APPROVED via the API', async () => {
+      await expect
+        .poll(async () => {
+          const res = await api.get(`billing/bill/${billUuid}?v=full`);
+          const data = await res.json();
+          return (data.refunds ?? [])[0]?.status;
+        })
+        .toBe('APPROVED');
+    });
+
+    await test.step('When the cashier processes the approved refund from the invoice page', async () => {
+      await invoicePage.goto(patientUuid, billUuid);
+      await invoicePage.waitForInvoiceToLoad();
+
+      const processButton = page.getByRole('button', { name: /process refund/i });
+      await expect(processButton).toBeEnabled();
+      await processButton.click();
+      await waitForSuccessNotification(page, /refund processed/i);
+    });
+
+    await test.step('Then the refund status is COMPLETED via the API', async () => {
+      await expect
+        .poll(async () => {
+          const res = await api.get(`billing/bill/${billUuid}?v=full`);
+          const data = await res.json();
+          return (data.refunds ?? [])[0]?.status;
+        })
+        .toBe('COMPLETED');
+    });
+
+    await test.step('And the completed refund is visible in the refunds table on the invoice', async () => {
+      const billDataLoaded = page.waitForResponse(
+        (response) => response.url().includes(`billing/bill/${billUuid}`) && response.status() === 200,
+      );
+      await invoicePage.goto(patientUuid, billUuid);
+      await billDataLoaded;
+
+      const refundsTable = page.getByRole('table', { name: /^refunds$/i });
+      await expect(refundsTable).toBeVisible();
+
+      const refundRows = refundsTable.locator('tbody tr');
+      await expect(refundRows).toHaveCount(1);
+
+      const statusCell = refundRows.first().locator('td').nth(3);
+      await expect(statusCell).toContainText(/completed/i);
+    });
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmrs/esm-billing-app",
-  "version": "1.2.0",
+  "version": "1.2.1-pre.1869",
   "description": "O3 frontend module for handling billing concerns in healthcare settings",
   "browser": "dist/openmrs-esm-billing-app.js",
   "main": "src/index.ts",
@@ -106,5 +106,6 @@
     "*.{ts,tsx}": "eslint --cache --fix --max-warnings 0",
     "*.{css,scss,ts,tsx}": "prettier --write --list-different"
   },
-  "packageManager": "yarn@4.10.3"
+  "packageManager": "yarn@4.10.3",
+  "stableVersion": "1.2.0"
 }

package/src/invoice/invoice-table.scss

@@ -34,6 +34,8 @@
 }
 
 .searchbox {
+  height: 3rem;
+
   input:focus {
     outline: 2px solid colors.$orange-40 !important;
   }
@@ -61,7 +63,7 @@
     border-bottom: 0.375rem solid var(--brand-03);
   }
 
-  & > span {
+  &>span {
     @include type.type-style('body-01');
   }
-}
+}

package/.turbo/cache/31f1dfc7f71601df-meta.json

@@ -1 +0,0 @@
-{"hash":"31f1dfc7f71601df","duration":17644}