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 Authorization Details screen (Prior Authorization Detail) displays a single prior authorization record at route /pm/authorizations/:id. An alternate route for Managed Care Authorization detail exists at /pm/managed-care-auth/:id (see Authorization Detail).

​
Overview

The page loads a prior authorization via usePriorAuthorizationDetail. It shows a two-column grid with Authorization Details (auth number, service type, urgency, payer, requested and approved date ranges, units, diagnosis codes, procedure codes) and Patient details (name, MRN, date of birth). A Units Used progress bar appears when approved units are set. If a determination date or denial reason is recorded, a Determination card shows those values. Clinical Justification text is displayed when present. The page also renders an AuthReviewSection for concurrent reviews. Status-action buttons — Submit (draft), Appeal (denied), and Edit (draft/submitted/pending) — are gated by individual permissions.

​
Who it’s for

Requires permission PM_PERMISSIONS.PRIOR_AUTH_VIEW (enforced via RequirePermission in the route definition). Additional permissions:
  • pm.prior_auth.submit — Submit button (draft status)
  • pm.prior_auth.appeal — Appeal button (denied status)
  • pm.prior_auth.edit — Edit button (draft/submitted/pending)

​
Before you start

  • You need pm.prior_auth.view to access this page.
  • The prior authorization record must belong to your organization.

​
Steps

1

Open a prior authorization

Navigate from the Prior Authorizations list (/pm/authorizations) and click a row to open the detail page.
2

Review authorization details

The left card shows all authorization fields including service type, urgency, payer, date ranges, unit counts, and codes.
3

Review patient information

The right card shows patient name, MRN, and date of birth joined from pm_patients.
4

Take a status action

Depending on current status, click Submit (draft), Appeal (denied), or Edit to update the record.
5

View concurrent reviews

The AuthReviewSection below the main grid shows linked concurrent review entries.

​
Key concepts

TermMeaning in code
authorization_numberThe payer-assigned authorization number
urgencyUrgency classification; urgent + BHRF service type shows Exempt badge
approved_units / used_unitsAuthorized units vs. consumed units; drives progress bar
determination_dateDate the payer issued a determination
denial_reasonFree-text reason from payer when denied
PriorAuthStatusdraft, submitted, pending, approved, denied, appealed, expired, cancelled

Practice Management

Practice Management core overview.

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/PriorAuthorizationDetailPage.tsx
  • src/cores/pm/hooks/usePriorAuthorizationDetail.ts
  • src/cores/pm/hooks/usePriorAuthorizationMutation.ts