Skip to content

feat: implement contractor 1099-NEC/MISC year-end reporting and TIN validation engine (closes #1871) - #1890

Merged
Dev1822 merged 1 commit into
Dev1822:mainfrom
Aakif-Kohari:feat/issue-1871-contractor-1099-tin-validation
Aug 28, 2026
Merged

feat: implement contractor 1099-NEC/MISC year-end reporting and TIN validation engine (closes #1871)#1890
Dev1822 merged 1 commit into
Dev1822:mainfrom
Aakif-Kohari:feat/issue-1871-contractor-1099-tin-validation

Conversation

@Aakif-Kohari

Copy link
Copy Markdown

Description

This PR implements a Contractor 1099-NEC/MISC Year-End Reporting & TIN Validation Engine. It introduces schemas to track annual non-employee compensation, TIN match statuses, and FIRE format drafts. The engine aggregates YTD contractor payments against the $600 threshold and categorizes amounts into NEC vs MISC boxes. A "Backup Withholding Guardrail" automatically applies the 24% backup withholding rate to future payments for contractors with unresolved TIN mismatches (B-Notice status). The frontend allows Finance/AP Admins to review payment accumulations, manage TIN validation statuses, and export IRS FIRE-format magnetic media files.

Fixes#1871

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

Changes Made

  • backend/src/models/contractor1099.model.js (New): Schemas for ContractorPaymentLedger, TINValidationRecord, and Form1099Draft.
  • backend/src/utils/form1099Engine.utils.js (New): Engine for threshold evaluation, backup withholding calculation, and FIRE format generation.
  • backend/src/controllers/contractor1099.controller.js (New): Endpoints for payment recording, TIN validation, and FIRE file generation.
  • backend/src/routes/contractor1099.routes.js (New): Route definitions.
  • frontend/src/pages/Form1099Dashboard.jsx (New): UI to monitor YTD accumulations, TIN statuses, and export FIRE files.

How Has This Been Tested?

  • Tested locally on frontend
  • Tested locally on backend

Checklist:

  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • My changes generate no new warnings

@vercel

vercelBot commented Aug 28, 2026

Copy link
Copy Markdown

@Aakif-Kohari is attempting to deploy a commit to the Dev's projects Team on Vercel.

A member of the Team first needs to authorize it.

@Aakif-KohariAakif-Kohari changed the title feat: implement contractor 1099-NEC/MISC year-end reporting and TIN v…feat: implement contractor 1099-NEC/MISC year-end reporting and TIN validation engine (closes #1871)Aug 28, 2026
@Dev1822Dev1822 added enhancement New feature or request ECSoC26 good-pr labels Aug 28, 2026
@Dev1822
Dev1822 merged commit 3924b40 into Dev1822:mainAug 28, 2026
9 of 24 checks passed
@Aakif-Kohari
Aakif-Kohari deleted the feat/issue-1871-contractor-1099-tin-validation branch August 29, 2026 02:18
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FEATURE] implement contractor 1099-NEC/MISC year-end reporting and TIN validation engine

2 participants

@Aakif-Kohari@Dev1822