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

# Compensation Statement

> Employee self-service view of a single total compensation statement with breakdown chart and PDF download.

Compensation Statement (employee self-service) is available at route `/hr/me/compensation/:id`. Access follows your organization's role and module configuration. ## Overview

The My Compensation Statement Detail page (`MyCompensationStatementDetailPage`) shows a single compensation statement identified by `:id`. It displays a `TotalCompensationStatementStatusBadge`, a `CompensationBreakdownChart` (pie chart of compensation components), and individual compensation component cards showing amounts and percentages of total. Two action buttons are available: **Acknowledge** (calls `acknowledgeStatement.mutateAsync`) and **Download PDF** (calls `generateStatementPdf`). The breadcrumb updates to "{year} Statement" via `useEntityBreadcrumb`. The statement year is surfaced from `statement.statement_year`.

## Who it's for

Access follows your organization's role and module configuration. Accessible from the self-service route `/hr/me/compensation`.

## Before you start

* A total compensation statement must have been generated and shared by HR for the employee.

## Steps

<Steps>
  <Step title="Open compensation statement">Navigate to `/hr/me/compensation` and click a statement, or navigate directly to `/hr/me/compensation/:id`.</Step>
  <Step title="Review breakdown">Examine the `CompensationBreakdownChart` and individual component amounts.</Step>
  <Step title="Acknowledge">Click **Acknowledge** to confirm you have reviewed the statement.</Step>
  <Step title="Download PDF">Click **Download PDF** to generate and download the statement document.</Step>
</Steps>

## Key concepts

| Term                               | Meaning in code                                          |
| ---------------------------------- | -------------------------------------------------------- |
| `statement_year`                   | The year covered by the compensation statement           |
| `TotalCompensationStatementStatus` | Status type from `@/cores/hr/compensation/types`         |
| `CompensationBreakdownChart`       | Pie chart visualizing compensation component proportions |
| `acknowledgeStatement`             | Mutation marking the statement as employee-acknowledged  |

## Related

<Columns cols={2}>
  <Card title="Human Resources" icon="users" href="/hr/overview">
    Human Resources core overview.
  </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/hr.tsx
  * src/routes/hr/self-service-routes.tsx
  * src/cores/hr/self-service/pages/MyCompensationStatementDetailPage.tsx
  * src/cores/hr/compensation/hooks/useTotalCompensationStatementDetail.ts
  * src/cores/hr/compensation/hooks/useCompensationStatementPdf.ts
</Accordion>