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

# OTP Billing

> Patient-scoped page for reviewing and managing opioid treatment program billing periods and service components.

The OTP Billing page provides a patient-scoped view of opioid treatment program billing periods and associated service components. Route: `/pm/patients/:patientId/otp-billing`.

## Overview

`PatientOtpBillingPage` reads `patientId` from the route parameter and renders `OtpBillingPeriodsTab` wrapped in a permission gate. The page header uses a pill icon with the title "OTP Billing" and description "Opioid treatment program billing periods and service components". A loading skeleton is shown when `patientId` is not yet resolved from the route.

## Who it's for

Requires permission `pm.otp.view` (applied via `RequirePermission` wrapping the page content; no explicit gate at the route level — the gate is inline within the component).

## Before you start

* Navigate to the patient's record at `/pm/patients/:patientId` before accessing OTP billing.
* Ensure the patient is enrolled in an OTP program (see `/pm/otp-programs`).

## Steps

<Steps>
  <Step title="Open the patient record">
    Navigate to **Practice Management → Patients** and select the patient, or go to `/pm/patients/:patientId`.
  </Step>

  <Step title="Access OTP Billing">
    From the patient detail page, navigate to `/pm/patients/:patientId/otp-billing`, or use the relevant navigation link.
  </Step>

  <Step title="Review billing periods">
    The `OtpBillingPeriodsTab` displays the patient's OTP billing periods and service components.
  </Step>
</Steps>

## Key concepts

* **OTP billing periods** — time-bounded billing segments for opioid treatment program services rendered to an identified patient.
* **Service components** — individual billable elements within a billing period.

## Related

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

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</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/PatientOtpBillingPage.tsx
  * src/cores/pm/components/otp/OtpBillingPeriodsTab.tsx
</Accordion>