TaxW2
As a tax document issuer you collect the data elements shown below into either a flat or tree structure.
You then populate the applicable FDX object, serialize it to JSON, and
distribute the JSON in up to 4 ways.
(1) File download or (2) API
(3) Printed document with QR code
(4) PDF file with embedded JSON
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 14a, Other descriptions and amounts |
| 19 | occupationCodes | Array of string | Box 14b, Treasury Tipped Occupation Codes (TTOC) |
| 20 | stateAndLocal | Array of StateAndLocalTaxWithholding | Boxes 15-20, State and Local tax withholding |
TaxW2 Usage:
FDX Tax Schema and Model Files
A copy of the FDX tax schema files (yaml) and related model files in csharp, java, python, ruby, and typescript languages are available at this private GitHub repository:
https://github.com/iTipsDev/fdx-tax-schema-v6.6.0
We will make this repository available to developers implementing Financial Data Exchange (FDX) JSON in their applications. Just send your GitHub user email and company name to info@taxdataexchange.org to be granted access.
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.
Docker Image
A Docker image is available to generate TaxW2 documents as:
- FDX JSON
- QR PDFs and
- Intelligent Tax Documents®
See this page and contact us at info@taxdataexchange.org to license the Docker image.
