> ## 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.

# Superbills

> View, open, and download all generated superbills and patient receipts across encounters at /pm/superbills.

The Superbills page lists all generated superbills for the current organization and is accessible at the route `/pm/superbills`.

## Overview

The Superbills page presents a table of all superbills generated across encounters for the organization, sourced from the `pm_superbills` table ordered by `generated_at` descending. Each row shows the generation date and time, a truncated encounter ID (first 8 characters in monospace), a delivery method badge, and action buttons to open or download the document PDF. Rows with no associated `document_url` display "No document" instead of action buttons.

Superbills are created from encounters with charges; this page is read-only and does not expose a create action. The `useSuperbillList` hook supports optional `encounterId` and `patientId` filters, though the list page passes no filters and shows all superbills for the org.

## Who it's for

Requires permission: `pm.superbill.view`

## Before you start

* You must hold `pm.superbill.view` to access this page.
* Superbills must be generated from within an encounter before they appear here. The page has no in-page generation capability.

## Steps

<Steps>
  <Step title="Navigate to Superbills">
    Go to `/pm/superbills`. The table loads all superbills for your organization, most recently generated first.
  </Step>

  <Step title="Review the superbill list">
    Each row shows generation timestamp, truncated encounter ID, delivery method badge, and document action buttons.
  </Step>

  <Step title="Open a superbill PDF">
    Click the external link icon button on a superbill row to open the PDF in a new browser tab via `openPdfInNewTab`.
  </Step>

  <Step title="Download a superbill PDF">
    Click the download icon button to save the PDF locally. The file is named `superbill-<encounter_id_prefix>.pdf`.
  </Step>
</Steps>

## Key concepts

<AccordionGroup>
  <Accordion title="Empty and error states">
    * **Empty list:** "No superbills generated — Superbills are created from encounters with charges. Navigate to an encounter to generate one."
    * **Load error:** "Failed to load superbills. Please try again." shown inline.
    * **No document:** Row shows "No document" text in place of action buttons when `document_url` is null.
  </Accordion>
</AccordionGroup>

A <Tooltip tip="A superbill is an itemized receipt used by patients to submit claims to their insurance when the provider does not bill the insurer directly.">superbill</Tooltip> is an itemized receipt generated from an encounter's charges. Delivery method badges reflect how the superbill was delivered (e.g., printed, portal, email) with variants defined in `DELIVERY_METHOD_VARIANT`. The encounter ID is displayed truncated to the first 8 characters.

## Related

<Columns cols={2}>
  <Card title="Practice Management" icon="briefcase" href="/pm/overview">
    Overview of the Practice Management core.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  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.
</Note>

<Accordion title="Documentation sources">
  * src/routes/pm.tsx
  * src/cores/pm/pages/SuperbillListPage.tsx
  * src/cores/pm/hooks/useSuperbillList.ts
  * src/platform/permissions/constants.ts
</Accordion>