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

# Offers

> Browse, filter, create, view, and manage employment offers across the ATS pipeline including approval, signature, background check, and negotiation lifecycle.

The Offers list page displays all employment offers and is available at `/hr/ats/offers`.

## Overview

The Offers page shows all employment offers with status filtering. Offers can be filtered by status: All, Draft, Pending Approval, Approved, Sent, Accepted, Rejected, or Withdrawn. The header includes a **Create Offer** action that opens the direct wizard route at `/hr/ats/offers/new`. Clicking an offer card navigates to `/hr/ats/offers/:id`.

## Who it's for

Access follows your organization's role and module configuration. The **Create Offer** action and the underlying wizard routes (`/hr/ats/applications/:id/offer`, `/hr/ats/offers/new`) require the `hr.ats.offers.create` permission.

## Before you start

* Offers can be created from an application detail page or directly from this page.
* To use **Create Offer**, you need the `hr.ats.offers.create` permission.

## Steps

1. Navigate to `/hr/ats/offers`.
2. Use the status filter dropdown to narrow the list.
3. Optional: click **Create Offer** to start a direct offer at `/hr/ats/offers/new`.
4. Click an offer card to view or manage the offer.

## Key concepts

* **Offer Status** — Indicates where an offer is in its lifecycle: Draft, Pending Approval, Approved, Sent, Accepted, Rejected, or Withdrawn.

## Viewing an offer

The Offer Details page provides the full offer record for a single ATS offer and is available at `/hr/ats/offers/:id`. It is a tabbed view with the following tabs: **Overview**, **Approval**, **Signature**, **Background**, and **Negotiation**. The page supports sending an offer to a candidate, managing the approval chain, viewing digital signature status, tracking counter-offers and negotiation history, and recording background check status. A hiring checklist component is also available on this page.

Before you start: the offer must already be created and available in the offers list at `/hr/ats/offers`. Verify that the approval chain is configured if approvals are required before sending.

1. Navigate to `/hr/ats/offers` and click an offer to open its detail page.
2. Use the **Overview** tab to review the offer terms.
3. Use the **Approval** tab to initiate or review the approval chain.
4. Use the **Signature** tab to track digital signature status.
5. Use the **Background** tab to record background check information.
6. Use the **Negotiation** tab to view counter-offer history.

**Key detail concepts:**

* **Approval Chain** — A configured sequence of approvers that must sign off before the offer is sent to the candidate.
* **Counter-Offer** — A candidate response proposing different terms; tracked in the Negotiation tab.
* **Signature Status** — Indicates whether the candidate has reviewed and signed the offer letter.

## Creating an offer

The direct-offer flow is available at `/hr/ats/offers/new` and opens the Offer Letter Wizard in direct mode. This mode supports existing candidates (external direct recruit), existing employees (internal promotion/transfer), and net-new candidates created inline during the wizard. The wizard creates an `hr_offers` record and routes you to `/hr/ats/offers/:id` on completion.

For recruiters and HR administrators who need to extend an offer outside the standard ATS application pipeline — for example, internal promotions, direct recruits, or rehires. The route requires the `hr.ats.offers.create` permission.

Before you start: you must have the `hr.ats.offers.create` permission. The `FEATURE_HR_JOB_OFFER_WIZARDS` feature flag must be enabled for your environment. Confirm candidate or employee recipient details are available.

1. Navigate to `/hr/ats/offers/new`.
2. In **Select Recipient**, select **Candidate** or **Employee**.
3. For candidate offers, either select an existing candidate or create one inline (first name, last name, email).
4. Complete compensation, terms, and approval routing.
5. Submit the wizard to create the offer and open `/hr/ats/offers/:id`.

## Related

<Columns cols={2}>
  <Card title="Offer Letter Wizard" icon="wand-sparkles" href="/hr/offer-letter-wizard">
    Create a new offer with the application-scoped guided wizard.
  </Card>

  <Card title="Human Resources" icon="users" href="/hr/overview">
    Human Resources 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/hr.tsx
  * src/cores/hr/pages/ats/OfferListPage.tsx
  * src/cores/hr/pages/ats/OfferDetailPage.tsx
  * src/cores/hr/pages/ats/OfferLetterWizardPage.tsx
  * src/cores/hr/hooks/ats/useOffers.ts
  * src/cores/hr/hooks/ats/useOfferDetail.ts
  * src/cores/hr/hooks/ats/useOfferApprovalMutation.ts
  * src/cores/hr/wizards/offer-letter
</Accordion>