Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt

Use this file to discover all available pages before exploring further.

Module: Practice Management (PM-16)
Last Updated: 2026-02-23

Overview

The Patient Statement Billing module enables your organization to generate patient statements, track delivery across channels (print, email, portal), manage payment plans, and process financial assistance applications.

Quick Reference

I need to…PatternLocation
Trigger a statement runGenerate Statements dialog from runs listTriggering a Statement Run
Review delivery outcomesDelivery history dialog by run/statementDelivery History
Set up a payment planNew Payment Plan workflowCreating a Payment Plan
Submit financial assistanceNew Application workflowSubmitting an Application
Review assistance decisionReview action with approve/deny optionsReviewing an Application

Prerequisites

You need the following permissions:
PermissionRequired For
pm.statements.viewView statement runs and deliveries
pm.statements.generateTrigger new statement runs
pm.statements.manageEdit/manage statement runs
pm.payment_plans.viewView payment plans
pm.payment_plans.createCreate payment plans
pm.payment_plans.editEdit existing payment plans
pm.payment_plans.deleteDelete payment plans
pm.financial_assistance.viewView financial assistance applications
pm.financial_assistance.createSubmit new applications
pm.financial_assistance.reviewApprove or deny applications

Statement Runs

Viewing Statement Runs

  1. Navigate to Practice Management → Statement Runs.
  2. The list shows all statement runs with type, status, start time, and count of statements generated.
  3. Click any row to view the detail page with linked statements and delivery history.

Triggering a Statement Run

  1. From the Statement Runs list, click Generate Statements.
  2. In the dialog, select:
    • Run Type: On-demand, scheduled, or cycle-end.
    • Date Range: The billing period to include.
    • Minimum Balance: Optionally filter by minimum amount due.
  3. Click Generate to start the run.
  4. The run will appear with status Pending, then transition to In Progress and finally Completed or Failed.

Statement Run Statuses

StatusMeaning
PendingRun created, not yet started
In ProgressActively generating statements
CompletedAll statements generated successfully
FailedRun encountered errors
CancelledRun was cancelled before completion

Payment Plans

Viewing Payment Plans

  1. Navigate to Practice Management → Payment Plans.
  2. The list shows all plans with patient name, total amount, frequency, status, and remaining balance.

Creating a Payment Plan

  1. Click New Payment Plan.
  2. Fill in:
    • Patient: Select the patient.
    • Total Amount: The total balance to be paid.
    • Installment Amount: Amount per payment.
    • Frequency: Weekly, bi-weekly, or monthly.
    • Start Date / End Date: Payment schedule period.
  3. Click Save.

Payment Plan Statuses

StatusMeaning
ActivePayments being collected
PausedTemporarily suspended
CompletedAll payments received
DefaultedPatient missed payments beyond threshold
CancelledPlan cancelled

Financial Assistance

Viewing Applications

  1. Navigate to Practice Management → Financial Assistance.
  2. The list shows all applications with patient name, type, requested amount, and status.

Submitting an Application

  1. Click New Application.
  2. Fill in:
    • Patient: Select the patient.
    • Application Type: Charity care, sliding scale, or hardship.
    • Requested Amount: The amount of assistance requested.
    • Household Size / Annual Income: Required for eligibility determination.
    • Supporting Documentation: Optional notes or references.
  3. Click Submit.

Reviewing an Application

  1. Open the application detail page.
  2. Click Review.
  3. In the review dialog:
    • Select Approve or Deny.
    • If approving, set Approved Amount, Discount Percentage, and Effective Dates.
    • Add review notes.
  4. Click Submit Review.

Delivery History

Each patient statement tracks its delivery history:
  1. From a Statement Run detail or Patient Statement, click View Deliveries.
  2. The dialog shows all delivery attempts with method (print/email/portal/text), status, and timestamp.

Troubleshooting

IssueResolution
Statement run stuck in “Pending”Check Edge Function logs; the run-statement-cycle function may need to be re-triggered.
Cannot create payment planVerify you have pm.payment_plans.create permission.
Financial assistance review button missingYou need pm.financial_assistance.review permission.
Delivery shows “Failed”Check that patient email/portal access is configured correctly.

Specification: specs/pm/specs/PM-16-patient-statement-generation-billing-communications.md