In order to support the contents of the IRS Form W-3 uploaded by the applying entities Ocrolus supports the verification of employee Form W-2.
The form_type
parameter W2
for the Upload PDF endpoint is required for this Form Type.
Optional fields captured
Configuration-Driven Output
All fields below are optionally captured, depending on your order form. To adjust fields captured, please speak with your Ocrolus Account Manager.
JSON Attribute | Data Type | Description |
---|---|---|
| Text | Numerical description of the Form's pre-printed year, e.g. "2020" for a 2020 form |
| Text | Formatted XXX-XX-XXXX. Social Security Number of employee |
| Text | The employer EIN |
| Amount earned by employee in compensation | |
| Amount withheld by employee for federal income tax purposes | |
| Amount earned that is eligible for Social Security tax | |
| Amount withheld in Social Security tax | |
| Amount earned that is eligible for Medicare tax | |
| Amount withheld in Medicare tax | |
| Text | Name of employer |
| Text | Street address of the employer |
| Text | Office number or suite number of the employer |
| Text | City of employer |
| Text | Formatted as a 2 character state code. State the employer resides in |
| Text | 5 digit zip code in which employer resides |
| Text | Name of the employee |
| Text | Street address of the employee |
| Text | Office number or suite number of the employee |
| Text | City of employee |
| Text | Formatted as a 2 character state code. State the employee resides in |
| Text | 5 digit zip code in which employee resides |
| Amount in tips earned by employee eligible for Social Security tax | |
| Amount in tips allocated to employee by employer | |
| Text | Default |
| Default | |
| Default | |
| Text | Default |
| Default | |
| Text | Default |
| Default | |
| Text | Default |
| Default | |
| Text | Default |
| Default | |
|
|
|
|
|
|
|
|
|
| Text | Default |
| Text | Primary state employee pays taxes in from employer |
| Text | Default |
| Text | State ID from primary state employee works for employer in |
| Text | State ID from secondary state employee works for employer in |
| Amount in total taxable wages employee earned from employer in primary state | |
| Amount in total taxable wages employee earned from employer in secondary state | |
| Amount in state income taxes withheld from wages earned in primary state | |
| Amount in state income taxes withheld from wages earned in secondary state | |
| Amount in total taxable wages subject to local, city or other state taxes | |
| Amount in total taxable wages sublect to secondary state's local, city and other state taxes | |
| Amount in local city or other state taxes withheld from wages earned in primary state | |
| Amount in local city or other state taxes withheld from wages earned in secondary state | |
| Text | Description of the local, city or other state tax being paid from primary state |
| Text | Description of the local, city or other state tax being paid from secondary state |
Sample Form
The below Ocrolus Sample PDF (input) matches the below Sample JSON Result (output).
Sample JSON Result
{
"form_type": "W2",
"pk": 4735507,
"form_config_pk": 1726,
"raw_fields": {
"year": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "2019"
},
"employeeSocialSecurityNumber": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "987654321"
},
"employerIdNo": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "123456789"
},
"wagesTipsOtherComp": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "100000.00"
},
"federalIncomeTaxWithheld": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "15000.00"
},
"socialSecurityWages": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "98750.00"
},
"socialSecurityTaxWithheld": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "7500.00"
},
"medicareWagesAndTips": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "98750.00"
},
"medicareTaxWithheld": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "4500.00"
},
"employerName": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "OCROLUS INC."
},
"employerAddressLine1": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "101 GREENWICH STREET"
},
"employerAddressLine2": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "FLOOR 23"
},
"employerAddressCity": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "NEW YORK"
},
"employerAddressState": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "NY"
},
"employerAddressZip": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "10006"
},
"employeeName": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "JOHN DOE"
},
"employeeAddressLine1": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "123 MAIN STREET"
},
"employeeAddressLine2": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"employeeAddressCity": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "NEW YORK"
},
"employeeAddressState": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "NY"
},
"employeeAddressZip": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "10001"
},
"socialSecurityTips": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "0.00"
},
"allocatedTips": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "0.00"
},
"box9": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"dependentCareBenefits": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "0.00"
},
"qualifiedPlans": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"box12aCode": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "D"
},
"box12aAmount": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "1000.00"
},
"box12bCode": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"box12bAmount": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"box12cCode": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"box12cAmount": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"box12dCode": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"box12dAmount": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"statutoryEmployee": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "UNCHECKED"
},
"retirementPlan": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "CHECKED"
},
"third-PartySickPay": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "UNCHECKED"
},
"box14Other": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "NY-PFR 223.25"
},
"statePrimary": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "NY"
},
"stateSecondary": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"employerStateIdNumberPrimary": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "999999999"
},
"employerStateIdNumberSecondary": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"stateWagesTipsPrimary": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "100000.00"
},
"stateWagesTipsSecondary": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"stateIncomeTaxPrimary": {
"alias_used": null,
"is_empty": false,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": "9000.00"
},
"stateIncomeTaxSecondary": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"localWagesTipsPrimary": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"localWagesTipsSecondary": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"localIncomeTaxPrimary": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"localIncomeTaxSecondary": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"localityNamePrimary": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
},
"localityNameSecondary": {
"alias_used": null,
"is_empty": true,
"page_doc_pk": 64551790,
"source_filename": "Ocrolus Sample PDF - IRS Form W-2.pdf",
"value": ""
}
},
"tables": []
}
Updated 9 months ago