Skip to main content

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.

Review and finalize 1099-NEC tax form items for contractors at route /hr/payroll/tax-forms/runs/:runId/1099-nec.

​
Overview

The 1099-NEC Review screen displays all contractor items associated with a specific tax form run identified by runId. The page shows three summary cards: total contractor count, total Box 1 compensation, and a PDF-generated count. Contractors are listed in a data table with masked SSN (last 4 digits), Box 1 (compensation), and Box 4 (federal withholding) columns alongside PDF generation status. An HR admin can generate PDFs for all items or, once the run status is review, finalize and distribute forms to contractors through their self-service portal with notifications.

​
Who it’s for

No explicit permission gate on this route — access is controlled upstream by the tax form runs list.

​
Before you start

  • A tax form run of the appropriate type must exist; navigate here from the tax form runs list.
  • Run status must be review to trigger the Finalize & Distribute action.

​
Steps

1

Navigate to the run

Open the tax form run from /hr/payroll/tax-forms/runs and select the 1099-NEC review sub-route.
2

Review contractor table

Verify each contractor’s masked SSN last-4, Box 1 compensation, and Box 4 federal withholding values.
3

Generate PDFs

Click Generate PDFs to invoke the generate-1099-nec-pdf edge function; a success toast reports the count generated and any failures.
4

Finalize and distribute

When the run is in review status, click Finalize & Distribute, confirm the dialog, and the system distributes forms to contractors’ self-service portals and sends notifications.

​
Key concepts

TermMeaning in code
box1Non-employee compensation field on the 1099-NEC form data (NEC1099FormData.box1)
box4Federal income tax withheld field (NEC1099FormData.box4)
pdf_file_pathPopulated once a PDF has been generated for that item
TaxFormRunStatusBadgeVisual indicator of run lifecycle (draft, review, filed)

Human Resources

Human Resources core overview.

Governance & parity

Documentation coverage and governance.
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.
  • src/routes/hr.tsx
  • src/cores/hr/pages/NEC1099ReviewPage.tsx
  • src/cores/hr/hooks/tax-forms/useTaxFormItems.ts
  • src/cores/hr/hooks/tax-forms/useTaxFormRuns.ts
  • src/cores/hr/services/1099-nec/types.ts