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.

The Encounter Costs page (/pm/encounter-costs) displays cost accounting records tied to completed encounters, allowing review and status progression from draft through finalized.

​
Overview

The Encounter Costs page reads from the pm_encounter_costs table, scoped to the current organization and ordered by service date descending. The page displays a table with columns for Date, Service Line, Total Cost, Charge, Margin, and Status. Margin values are color-coded using semantic tokens: positive margins render in a success color; negative margins render in a destructive color. Clicking View on any row opens the EncounterCostDetailDialog. Two dropdowns filter the table: one for cost status and one for service line. Filters are applied client-side to the currently loaded dataset (up to 200 records).

​
Who it’s for

Requires permission: PM_PERMISSIONS.COST_ACCOUNTING_VIEW (pm.cost_accounting.view).

​
Before you start

  • Ensure you have the pm.cost_accounting.view permission.
  • Cost records appear automatically once encounters are completed and costs are calculated. There is no manual creation entry point on this page.

​
Steps

1

Open Encounter Costs

Navigate to /pm/encounter-costs. The table loads all encounter cost records for your organization, ordered by most recent service date first (up to 200 records).
2

Filter by status

Use the All Statuses dropdown to filter the table to a single status: Draft, Calculated, Reviewed, or Finalized.
3

Filter by service line

Use the All Service Lines dropdown to filter to a specific service line: Outpatient, IOP, PHP, Residential, Detox, or Telehealth.
4

Review a cost record

Click the View button on any table row to open the EncounterCostDetailDialog with full detail for that encounter cost record.

​
Key concepts

Cost statuses: Records progress through draft, calculated, reviewed, and finalized. The finalized status renders a default (primary) badge; reviewed renders secondary; calculated renders outline; draft renders secondary. Margin: The margin column shows the difference between charge_amount and total_cost. Displayed as N/A when the margin field is null. Service lines: outpatient, iop, php, residential, detox, telehealth.
When no cost records exist (or no records match the active filters): “Cost records will appear here once encounters are completed and costs are calculated.”

Practice Management

Overview of the Practice Management core.

Governance & parity

Documentation coverage and governance.
This page documents shipped product behavior. It is not medical, legal, or billing advice. Verify against your organization’s policies and applicable regulations before using it for clinical, compliance, or billing decisions. Protected health information (PHI) shown in the product is governed by your tenant’s access controls and is never exposed in this documentation.
  • src/routes/pm.tsx
  • src/cores/pm/pages/EncounterCostsPage.tsx
  • src/cores/pm/hooks/useEncounterCosts.ts