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

# 1099 Forms

> List, manage, and view individual 1099 vendor tax reporting forms including box-level breakdown and correction workflow.

List and manage all 1099 vendor tax reporting forms for the organization at the in-app route `/fa/tax/forms/1099`.

## Overview

This screen displays all 1099 forms for the current organization in a data table. Each row shows the vendor name (linked to the detail page), form type (defaulting to `1099-NEC`), total amount, and status. A "New 1099 Form" button navigates to the form creation route. The table shows an empty state of "No 1099 forms created yet" when no records exist.

## Who it's for

Required permission: `fa.tax.view` (enforced at the route via `RequirePermission`). The "Create 1099-COR Correction" action additionally requires `fa.tax.generate`.

## Before you start

* An organization must be selected.
* Vendors should be set up in the Vendors section before creating 1099 forms.

## Steps

<Steps>
  <Step title="Navigate to the list">Go to `/fa/tax/forms/1099` via the Finance & Revenue navigation.</Step>
  <Step title="Review existing forms">The table lists all 1099 forms with vendor name, form type, amount, and status columns.</Step>
  <Step title="Open a form">Click a vendor name link or the View button to open the 1099 Form Details page.</Step>
  <Step title="Create a new form">Click "New 1099 Form" to navigate to the form creation screen.</Step>
</Steps>

## Key concepts

* `form_type` — IRS form variant (defaults to `1099-NEC` when not specified)
* `status` — lifecycle state of the form record (`draft`, `generated`, `filed`)
* `total_amount` — total dollar amount displayed using `formatCurrency`

## Viewing a 1099 form

Selecting a form opens its detail view at `/fa/tax/forms/1099/:id` (permission: `fa.tax.view`). The page shows vendor details (vendor name, vendor ID, total amount), the current form status (`draft`, `generated`, or `filed`), and a box-level breakdown of IRS form box amounts keyed by identifiers such as `box_1` through `box_15`.

Users with the `fa.tax.generate` permission can create a correction form (1099-COR) when the form status is `generated` or `filed`. A "Create Distribution" action is available via `CreateDistributionDialog` for distributing the form to the recipient.

Key concepts for the detail view:

* `is_correction` — boolean flag set to `true` on correction forms
* `corrects_form_id` — links a correction form back to the original form
* `box_amounts` — JSON object storing per-box dollar values

1. Navigate to the form via the 1099 Forms list.
2. Review the Vendor Details card: vendor name, vendor ID, and total amount.
3. Review the Box-Level Breakdown card for all non-zero IRS box amounts.
4. Click the Create Distribution action to open the distribution dialog (optional).
5. When status is `generated` or `filed`, click "Create 1099-COR Correction" to create a linked correction form (requires `fa.tax.generate`).

## Related

<Columns cols={2}>
  <Card title="Finance & Revenue" icon="building-columns" href="/fa/overview">
    Finance & Revenue 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/fa.tsx
  * src/cores/fa/pages/Form1099ListPage.tsx
  * src/cores/fa/pages/Form1099DetailPage.tsx
  * src/cores/fa/hooks/use1099Forms.ts
</Accordion>