W-2 EFW2 FILE VALIDATOR · RUNS IN YOUR BROWSER · NOTHING UPLOADED

Will SSA accept this W-2 file?

Paste or drop an EFW2 wage file (the 512-character RA / RE / RW / RT / RF format used by Business Services Online) and get every structural error with its line number: record lengths, record order, EINs, employee SSNs, money fields, Social Security wage-base and tax-rate sanity, RT employer totals and the RF count. After a hand edit, rebuild the RT and RF totals in one click and download the corrected file.

The file is read in this browser tab and never leaves your device. SSNs are masked to their last four digits in the report. Independent of the Social Security Administration and the IRS. The record layout is read by position from memory of the public SSA EFW2 specification; no SSA validator was available when this was built.

1. Your EFW2 file

Usually a .txt, .dat or .w2 file exported from payroll or tax software: 512-character lines starting RA, RE, RW, RO, RS, RT, RU or RF.

Choose a file or paste the text, then click Validate.

The model, and what it leaves out

Common questions

How do I check a W-2 EFW2 file before uploading it to SSA?

Paste the file or drop it onto this page. It checks every 512-character record: the RA, RE, RW, RT and RF order, the tax year and EINs, each employee's SSN and eleven-digit money boxes, the RT employer totals against the RW lines, and the RF count, then lists each problem with its line number.

Why did Business Services Online reject my W-2 wage file?

The usual causes are a record that is not exactly 512 characters (trailing spaces trimmed by an editor), RT totals that no longer match the wage lines after a hand edit, an RF count that disagrees with the number of RW records, an invalid SSN such as 000 or 9xx in the area number, or lowercase and non-ASCII characters. This tool tests each of them.

What are the RA, RE, RW, RT and RF records?

RA identifies the submitter and starts the file. RE opens one employer and carries the tax year and EIN. Each RW is one employee's W-2 wage line. RT closes an employer with the employee count and the sums of each money box. RF ends the file with the total employee count. RO, RS and RU are optional records for other withholding, state data and the RO totals.

Can this tool fix my EFW2 file?

It can rebuild the RT employer totals and the RF count from the RW lines, which is what is stale after a hand edit. It never edits an RW line: a wrong SSN, name or amount is a payroll decision, so it is reported and left to you.

Is it safe to put a file full of SSNs into a web page?

The page runs in your browser, the file is read locally and nothing is uploaded; a test in the code asserts there are no network calls. SSNs are masked to their last four digits in the report and the findings download. Your own policies still decide whether you may open wage data in a browser.

What does this not check?

Whether an SSN and name match SSA's records (only SSA's own verification service can tell you), state record layouts, the RO, RS and RU records beyond their order, every optional W-2 box, your submitter user ID and credentials, and anything SSA adds to the specification each year. A clean result is not a promise of acceptance.