TaxW2
FDX / Data Structures / TaxW2
Form W-2, Wage and Tax Statement, from Employer (boxes b-c as issuer) to Employee (boxes a, e-f as recipient)
Extends and inherits all fields from Tax
TaxW2 Properties
| # | Id | Type | Description |
|---|---|---|---|
| 1 | controlNumber | string | Box d, Control number |
| 2 | wages | number | Box 1, Wages, tips, other compensation |
| 3 | federalTaxWithheld | number | Box 2, Federal income tax withheld |
| 4 | socialSecurityWages | number | Box 3, Social security wages |
| 5 | socialSecurityTaxWithheld | number | Box 4, Social security tax withheld |
| 6 | medicareWages | number | Box 5, Medicare wages and tips |
| 7 | medicareTaxWithheld | number | Box 6, Medicare tax withheld |
| 8 | socialSecurityTips | number | Box 7, Social security tips |
| 9 | allocatedTips | number | Box 8, Allocated tips |
| 10 | dependentCareBenefit | number | Box 10, Dependent care benefits |
| 11 | nonQualifiedPlan | number | Box 11, Nonqualified plans |
| 12 | codes | Array of CodeAmount | Box 12, Codes and amounts |
| 13 | statutory | boolean | Box 13, Statutory employee |
| 14 | retirementPlan | boolean | Box 13, Retirement plan |
| 15 | thirdPartySickPay | boolean | Box 13, Third-party sick pay |
| 16 | esppQualified | number | Employee Stock Purchase Plan Qualified Disposition amount |
| 17 | esppNonQualified | number | Employee Stock Purchase Plan Nonqualified Disposition amount |
| 18 | other | Array of DescriptionAmount | Box 14, Other descriptions and amounts |
| 19 | stateAndLocal | Array of StateAndLocalTaxWithholding | Boxes 15-20, State and Local tax withholding |
TaxW2 Usage:
FDX Tax Schema and Model Files
To assist developers, we have made available a copy of the FDX tax schema files (yaml) and related model files in csharp, java, python, ruby, and typescript languages at GitHub for a nominal fee. Request GitHub repository access or more information .
SDK (Java Software Development Kit)
A java SDK is available to generate TaxW2 documents as:
- FDX JSON
- QR PDFs and
- Intelligent Tax Documents®
See this GitHub page and contact us at info@taxdataexchange.org to license the SDK.
Introductory SDK pricing is available through November 28, 2025.
