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

# VBP Contract

> View and manage a value-based payment program record, including overview, performance measures, and incentive structures.

The VBP Contract detail page provides a tabbed view of a single value-based payment program record, including program overview, quality measures, and incentive structures. Route: `/pm/vbp/:id`.

## Overview

`VbpProgramDetailPage` loads the program via `useVbpProgramDetail` keyed by `id`. The dynamic breadcrumb is set to `program_name`. If the program has a `deleted_at` value, a destructive alert indicates it is archived. Actions available (gated by `pm.vbp.manage`):

* **Edit** — opens `VbpProgramForm`
* **Archive** — soft-deletes via `useVbpProgramMutation`

Three tabs are rendered:

* **Overview** — program metadata (contract type using `CONTRACT_LABELS`, payer, dates, description)
* **Measures** — `VbpMeasuresTab`
* **Incentives** — `VbpIncentivesTab`

Contract type labels: `shared_savings`, `quality_bonus`, `capitation`, `bundled_payment`, `other`.

## Who it's for

Requires permission `pm.vbp.view` (`PM_PERMISSIONS.VBP_VIEW`). Archive and edit require `pm.vbp.manage`.

## Before you start

* Programs must exist at `/pm/vbp` before a detail page is accessible.
* Payer must be configured before linking a VBP program to a payer.

## Steps

<Steps>
  <Step title="Open the VBP program">
    Navigate to **Practice Management → Value-Based Payment**, select a program, or go to `/pm/vbp/:id`.
  </Step>

  <Step title="Review the overview tab">
    The overview tab shows contract type, payer, effective dates, and program description.
  </Step>

  <Step title="Review measures">
    Switch to the **Measures** tab to view quality and performance measures tracked under this program.
  </Step>

  <Step title="Review incentives">
    Switch to the **Incentives** tab to view incentive structures tied to program performance.
  </Step>

  <Step title="Edit the program">
    Click **Edit** (requires `pm.vbp.manage`) to open `VbpProgramForm` and update program details.
  </Step>

  <Step title="Archive the program">
    Click **Archive** (requires `pm.vbp.manage`) to soft-delete the program. Archived programs display a warning banner.
  </Step>
</Steps>

## Key concepts

* **Contract type** — classifies the VBP arrangement; values: `shared_savings`, `quality_bonus`, `capitation`, `bundled_payment`, `other`.
* **Archived programs** — soft-deleted (`deleted_at` set); displayed with a destructive alert banner.

## 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/VbpProgramDetailPage.tsx
  * src/cores/pm/hooks/useVbpProgramDetail.ts
  * src/cores/pm/hooks/useVbpProgramMutation.ts
  * src/cores/pm/components/VbpMeasuresTab.tsx
  * src/cores/pm/components/VbpIncentivesTab.tsx
</Accordion>