Tax Documents

 

TaxW2

 

FDX / Data Structures / TaxW2
Form W-2, Wage and Tax Statement
Extends and inherits all fields from Tax  
TaxW2 Properties
#IdTypeDescription
1employeeTinstringEmployee's social security number
2employerTinstringEmployer identification number (EIN)
3employerNameAddressNameAddressEmployer's name and address
4controlNumberstringControl number
5employeeNameIndividualNameEmployee name
6employeeAddressAddressEmployee's address
7wagesnumber (double)Box 1, Wages, tips, other compensation
8federalTaxWithheldnumber (double)Box 2, Federal income tax withheld
9socialSecurityWagesnumber (double)Box 3, Social security wages
10socialSecurityTaxWithheldnumber (double)Box 4, Social security tax withheld
11medicareWagesnumber (double)Box 5, Medicare wages and tips
12medicareTaxWithheldnumber (double)Box 6, Medicare tax withheld
13socialSecurityTipsnumber (double)Box 7, Social security tips
14allocatedTipsnumber (double)Box 8, Allocated tips
15dependentCareBenefitnumber (double)Box 10, Dependent care benefits
16nonQualifiedPlannumber (double)Box 11, Nonqualified plans
17codesArray of CodeAmountBox 12, Codes and amounts
18statutorybooleanBox 13, Statutory employee
19retirementPlanbooleanBox 13, Retirement plan
20thirdPartySickPaybooleanBox 13, Third-party sick pay
21esppQualifiednumber (double)Employee Stock Purchase Plan Qualified Disposition amount
22esppNonQualifiednumber (double)Employee Stock Purchase Plan Nonqualified Disposition amount
23otherArray of DescriptionAmountBox 14, Other descriptions and amounts
24stateTaxWithholdingArray of StateTaxWithholdingBoxes 15-17, State tax withholding
25localTaxWithholdingArray of LocalTaxWithholdingBoxes 18-20, Local tax withholding
TaxW2 Usage:
/img/forms/TaxW2/2022/v5.0/TaxW2.Recipient.Form.annotated.fdx.png
FDX Data Structure as JSON
{
  "taxW2" : {
    "taxYear" : 0,
    "corrected" : true,
    "accountId" : "",
    "taxFormId" : "",
    "taxFormDate" : "2020-07-01",
    "description" : "string",
    "additionalInformation" : "string",
    "taxFormType" : "BusinessIncomeStatement",
    "attributes" : [ {
      "name" : "string",
      "value" : "string",
      "boxNumber" : "string",
      "code" : "string"
    } ],
    "error" : {
      "code" : "string",
      "message" : "string"
    },
    "employeeTin" : "string",
    "employerTin" : "string",
    "employerNameAddress" : {
      "line1" : "String64",
      "line2" : "String64",
      "line3" : "String64",
      "city" : "String64",
      "state" : "String64",
      "postalCode" : "string",
      "country" : "AD",
      "name1" : "String64",
      "name2" : "String64"
    },
    "controlNumber" : "string",
    "employeeName" : {
      "first" : "string",
      "middle" : "string",
      "last" : "string",
      "suffix" : "string"
    },
    "employeeAddress" : {
      "line1" : "String64",
      "line2" : "String64",
      "line3" : "String64",
      "city" : "String64",
      "state" : "String64",
      "postalCode" : "string",
      "country" : "AD"
    },
    "wages" : 0.0,
    "federalTaxWithheld" : 0.0,
    "socialSecurityWages" : 0.0,
    "socialSecurityTaxWithheld" : 0.0,
    "medicareWages" : 0.0,
    "medicareTaxWithheld" : 0.0,
    "socialSecurityTips" : 0.0,
    "allocatedTips" : 0.0,
    "dependentCareBenefit" : 0.0,
    "nonQualifiedPlan" : 0.0,
    "codes" : [ {
      "code" : "string",
      "amount" : 0.0
    } ],
    "statutory" : true,
    "retirementPlan" : true,
    "thirdPartySickPay" : true,
    "esppQualified" : 0.0,
    "esppNonQualified" : 0.0,
    "other" : [ {
      "description" : "string",
      "amount" : 0.0
    } ],
    "stateTaxWithholding" : [ {
      "stateTaxWithheld" : 0.0,
      "state" : "string",
      "stateTaxId" : "string",
      "stateIncome" : 0.0
    } ],
    "localTaxWithholding" : [ {
      "localTaxWithheld" : 0.0,
      "localityName" : "string",
      "state" : "string",
      "localIncome" : 0.0
    } ]
  }
}
Example Form PDF

Download

/img/forms/TaxW2/2022/v5.0/TaxW2.RecipCopy.png
Example Form JSON

Download

{
  "taxW2" : {
    "taxYear" : 2022,
    "taxFormDate" : "2021-03-30",
    "taxFormType" : "TaxW2",
    "employeeTin" : "XXX-XX-1234",
    "employerTin" : "12-3456789",
    "employerNameAddress" : {
      "line1" : "12021 Sunset Valley Dr",
      "line2" : "Suite 230",
      "city" : "Preston",
      "state" : "VA",
      "postalCode" : "20191",
      "name1" : "Tax Form Issuer, Inc"
    },
    "controlNumber" : "012547 WY/OA7",
    "employeeName" : {
      "first" : "Kris",
      "middle" : "Q",
      "last" : "Public"
    },
    "employeeAddress" : {
      "line1" : "1 Main St",
      "city" : "Melrose",
      "state" : "NY",
      "postalCode" : "12121"
    },
    "wages" : 44416.74,
    "federalTaxWithheld" : 6907.16,
    "socialSecurityWages" : 47162.92,
    "socialSecurityTaxWithheld" : 2924.1,
    "medicareWages" : 47162.92,
    "medicareTaxWithheld" : 683.86,
    "codes" : [ {
      "code" : "C",
      "amount" : 301.5
    }, {
      "code" : "D",
      "amount" : 2746.18
    }, {
      "code" : "DD",
      "amount" : 4781.88
    } ],
    "retirementPlan" : true,
    "stateTaxWithholding" : [ {
      "stateTaxWithheld" : 1726.78,
      "state" : "OH",
      "stateTaxId" : "OH 036-133505158F-01",
      "stateIncome" : 44416.74
    } ],
    "localTaxWithholding" : [ {
      "localTaxWithheld" : 427.62,
      "localityName" : "Kirtland",
      "state" : "OH",
      "localIncome" : 44416.74
    } ]
  }
}
Example Form JSON for QR Code Purposes

Download

Example Form PDF with QR Code

Download

/img/forms/TaxW2/2022/v5.0/TaxW2.RecipCopy.qr.png
Example Data As Flattened Map (Key, Value Pairs)

 

{
  "taxYear": "2022",
  "taxFormDate": "2021-03-30",
  "taxFormType": "TaxW2",
  "employeeTin": "XXX-XX-1234",
  "employerTin": "12-3456789",
  "employerNameAddress.line1": "12021 Sunset Valley Dr",
  "employerNameAddress.line2": "Suite 230",
  "employerNameAddress.city": "Preston",
  "employerNameAddress.state": "VA",
  "employerNameAddress.postalCode": "20191",
  "employerNameAddress.name1": "Tax Form Issuer, Inc",
  "controlNumber": "012547 WY/OA7",
  "employeeName.first": "Kris",
  "employeeName.middle": "Q",
  "employeeName.last": "Public",
  "employeeAddress.line1": "1 Main St",
  "employeeAddress.city": "Melrose",
  "employeeAddress.state": "NY",
  "employeeAddress.postalCode": "12121",
  "wages": "44416.74",
  "federalTaxWithheld": "6907.16",
  "socialSecurityWages": "47162.92",
  "socialSecurityTaxWithheld": "2924.1",
  "medicareWages": "47162.92",
  "medicareTaxWithheld": "683.86",
  "codes-1.code": "C",
  "codes-1.amount": "301.5",
  "codes-2.code": "D",
  "codes-2.amount": "2746.18",
  "codes-3.code": "DD",
  "codes-3.amount": "4781.88",
  "retirementPlan": "true",
  "stateTaxWithholding-1.stateTaxWithheld": "1726.78",
  "stateTaxWithholding-1.state": "OH",
  "stateTaxWithholding-1.stateTaxId": "OH 036-133505158F-01",
  "stateTaxWithholding-1.stateIncome": "44416.74",
  "localTaxWithholding-1.localTaxWithheld": "427.62",
  "localTaxWithholding-1.localityName": "Kirtland",
  "localTaxWithholding-1.state": "OH",
  "localTaxWithholding-1.localIncome": "44416.74"
}
Issuer Instructions

Download

/img/forms/TaxW2/2022/v5.0/TaxW2.IssuerInstr.png

© Copyright 2023. All Rights Reserved.