Tax Reporting - IA

IOWA State Annual and Quarterly Wage and Tax Reporting - IOWA#

Set Up#

This document contains abbreviated set up requirements for the State of Iowa only. Please refer to the general document Tax Reporting - US General for other setup procedures that may also be required.

IDGV - State Registration#

State File Procedures#

State SUI Wage File Procedures#

Annual W2 Wage Reporting for State – EFW2 File Format#

RPYEU must be run with the following report parameters and filters defined to generate the Iowa State file information:


RPYEU Report Parameters

Annual Form CodeMandatory.
Annual Form Code HL$US-W2-20YY, defined on the IDFDV form.
NOTE: Always use the current year form code. DO NOT use a prior year form code as the Identifiers may be obsolete.
Period TypeMandatory. Defines the period type. Enter "Year" for Annual reporting and "Quarter" for quarterly reporting.
Period End DateMandatory. Defines the end date of the reporting period.
Media FormatMandatory. Defines the Federal file format for SSA reporting (includes 'RW' and 'RS' records).
Directory Name Mandatory. Defines the name of the government Magnetic Media file. Must be defined or an output file will not be produced
Media File NameMandatory. Defines the media file name of the data being uploaded. Must be defined or an output file will not be produced

RPYEU Report Filters
Select State: Iowa, USA

State Magnetic Media Reporting – EFW2 Format#

Record Name: Code RA – Submitter Record (Same as the Federal Code RA)#

State Media Magnetic Media Reporting - SSA EFW2 File Format for Annual and Quarterly Reporting#

Record Name: Code RA - Submitter Record#

ColumnDescriptionSource
1-2Record IdentifierConstant "RA"
3-11Submitter’s Employer ID Number (EIN)Required.
Derived from the ‘SUB-ER-EIN’ IDFDV Field Identifier (seq 1000).
Numeric only.
12-19User Identification (User ID)Required.
Enter the eight-character BSO User ID assigned to the employee who is attesting to the accuracy of this file.
20-23Software Vendor CodeEnter the numeric four-digit Software Vendor Identification Code assigned by the National Association of Computerized Tax Processors (NACTP).

If "99 (Off-the-Shelf Software)" is entered in the Software Code field (positions 36-37) enter the Software Vendor Code.
Otherwise, fill with blanks.
24-28BlankFill with blanks. Reserved for SSA use.
29Resub IndicatorEnter "1" if this file is being resubmitted. Otherwise, enter "0" (zero).
30-35Resub Wage File Identifier (WFID)If "1" was entered in Resub Indicator field (position 29), enter the WFID displayed on the notice SSA sent. Otherwise, fill with blanks.
36-37Software CodeEnter "99" to indicate 'Off-the-Shelf Software'
38-94Company NameEnter the Company Name.
Left justify and fill with blanks.
95-116Location AddressEnter the company's location address (Attention, Suite, Room Number, etc).
Left justify and fill with blanks
117-138Delivery AddressEnter the company's delivery address (Street or Post Office Box).
Example: 123 Main Street.
Left justify and fill with blanks
139-160CityEnter the company's city.
Left justify and fill with blanks
161-162State AbbreviationEnter the company's State or commonwealth/territory.
Use a postal abbreviation. For a foreign address, fill with blanks
163-167ZIP CodeEnter the company's ZIP code. For a foreign address, fill with blanks
168-171ZIP Code ExtensionEnter the company's four-digit extension of the ZIP code. If not applicable, fill with blanks
172-176BlankFill with blanks. Reserved for SSA use.
177-199Foreign State/ProvinceIf applicable, enter the company's foreign State/Province.
Left justify and fill with blanks. Otherwise, fill with blanks.
200-214Foreign Postal CodeIf applicable, enter the company's foreign postal code.
Left justify and fill with blanks. Otherwise, fill with blanks.
215-216Country CodeIf one of the following applies, fill with blanks:
* One of the 50 States of the U.S.A.
* District of Columbia
* Military Post Office (MPO)
* American Samoa
* Guam
* Northern Mariana Islands
* Puerto Rico
* Virgin Islands

Otherwise, enter the applicable Country Code.
217-273Submitter NameRequired.
Enter the name of the organization's submitter to receive error notification if this file cannot be processed.
Left Justify and fill with blanks.
Derived from the ‘SUB-SUBM-NAME’ IDFDV Field Identifier (seq 1150).
274-295Submitter Location AddressEnter the submitter's location address (Attention, Suite, Room Number, etc.)
Left justify and fill with blanks.
Derived from the ‘SUB-SUBM-LOCN’ IDFDV Field Identifier (seq 1160).
296-317Submitter Delivery AddressRequired.
Enter the submitter's delivery address (Street or Post Office Box).
Left justify and fill with blanks.
Derived from the ‘SUB-SUBM-DELIV’ IDFDV Field Identifier (seq 1170).
318-339Submitter CityRequired.
Enter the submitter's city.
Left justify and fill with blanks.
Derived from the ‘SUB-SUBM-CITY’ IDFDV Field Identifier (seq 1180).
340-341Submitter State AbbreviationRequired.
Enter the submitter's State or commonwealth/territory. Use a postal abbreviation.
For a foreign address, fill with blanks.
Derived from the ‘SUB-SUBM-STATE’ IDFDV Field Identifier (seq 1190).
342-346Submitter ZIP CodeRequired.
Enter the submitter's ZIP Code.
For a foreign address, fill with blanks.
Derived from the ‘SUB-SUBM-ZIP’ IDFDV Field Identifier (seq 1200).
347-350Submitter ZIP Code extensionEnter the submitter's four-digit extension of the ZIP code. If not applicable, fill with blanks.
Derived from the ‘SUB-SUBM-ZIP-EXT’ IDFDV Field Identifier (seq 1210).
351-355BlankFill with blanks. Reserved for SSA use
IMPORTANT NOTE: If using a foreign address, the foreign State/Province (postions 356-378), Foreign Postal Code (positions 379-393) and the Contry Code (positions 394-395) are required to be completed.
356-378Foreign State/ProvinceIf applicable, enter the submitter's foreign State/Province.
Left justify and fill with blanks. Otherwise, fill with blanks.
379-393Foreign Postal CodeIf applicable, enter the submitter's foreign Postal Code.
Left justify and fill with blanks. Otherwise, fill with blanks.
394-395Country CodeIf one of the following applies, fill with blanks
* One of the 50 States of the U.S.A.
* District of Columbia
* Military Post Office (MPO)
* American Samoa
* Guam
* Northern Mariana Islands
* Puerto Rico
* Virgin Islands

Otherwise, enter the applicable Country Code.
396-422Contact NameRequired.
Enter the name of the person to be contacted by SSA concerning processing problems.
Left justify and fill with blanks.
Derived from the ‘SUB-CONT-NAME’ IDFDV Field Identifier (seq 1250).
423-437Contact Phone NumberRequired.
Enter the contact's phone number with numeric valies only (including area code). Do not use any special characters.
Left justify and fill with blanks.

NOTE: It is imperative that the contact's telephone number be entered in the appropriate positions. Failure to include correct and complete submitter contact information may, in some cases, delay the timely processing of your file.

Derived from the ‘SUB-CONT-TEL’ IDFDV Field Identifier (seq 1260).
438-442Contact Phone ExtensionEnter the contact's telephone extension.
Left justify and fill with blanks.
Derived from the ‘SUB-CONT-TEL-EXT’ IDFDV Field Identifier (seq 1270).
443-445BlankFill with blanks. Reserved for SSA use.
446-485Contact E-mail/InternetEnter the contact's e-mail/internet address.
Derived from the ‘SUB-CONT-EMAIL’ IDFDV Field Identifier (seq 1280).
486-488BlankFill with blanks. Reserved for SSA use.
489-498Contact FaxIf applicable, enter the contact's fax number (including area code). Otherwise, fill with blanks.
Derived from the ‘SUB-CONT-FAX’ IDFDV Field Identifier (seq 1290).
499BlankFill with blanks. Reserved for SSA use.
500Preparer CodeEnter one of the following codes to indicate who prepared this file:
* A = Accounting Firm
* L = Self Prepared
* S = Service Bureau
* P = Parent Company
* O = Other

If more than one code applies, use the code that best describes who prepared this file.
501-512BlankFill with blanks. Reserved for SSA use.

Record Name: Code RE – Employer Record (Same as the Federal Code RE)#

State Media Magnetic Media Reporting - SSA EFW2 File Format for Annual and Quarterly Reporting#

Record Name: Code RE - Employer Record#

ColumnDescriptionSource
1-2Record IdentifierConstant "RE"
3-6Tax yearRequired.
Enter the tax year for this report (YYYY).
Derived from the user defined FROM-TO period, converted to YYYY.
7Agent Indicator CodeIf applicable, enter one of the following codes:
* 1 = 2678 Agent
* 2 = Common Paymaster
* 3 = 3504 Agent
If more than one code applies, use the one that best describes your status as an agent.
Otherwise, fill with a blank.
8-16Employer/Agent EINRequired.
Derived from the applicable Federal reporting EIN, from IDGV or IDGR.
17-25Agent for EINIf "1" was entered in the Agent Indicator Code field (position 7), enter the client-employer's EIN for which you are an Agent. Otherwise, fill with blanks.
26Terminating Business IndicatorIf this is the last tax year that W-2s will be filed under this EIN, enter "1". Otherwise, enter 0 (zero).
27-30Establishment NumberFor multiple RE (Employer) Records with the same EIN, you can use this field to assign a unique identifier for each RE (Employer) Record. Otherwise, fill with blanks.
31-39Other EINFor this tax year, if you submitted tax payments to the IRS under Form 941, 943, 944, CT-1 or Schedule H or W2 data to SSA, and a different EIN was used from the EIN in positions 8-16, enter the other EIN. Otherwise, fill with blanks.
IMPORTANT NOTE: The Employer's Name field (positions 40-96) and the Employer's Address fields (positions 97-173) should normally match the employer name and address under which tax payments were submitted to the IRS under Form 941, 943, 944, 945, CT-1 or Schedule H.
40-96Employer NameRequired.
Enter the name associated with the EIN entered in positions 8 - 16.
Left justify and fill with blanks.
Derived from the 'W2-ER-NAME' IDFDV Field Identifier (seq 2010).
97-118Employer Location AddressEnter the employer's location address (Attention, Suite, Room Number, etc.)
Left justify and fill with blanks.
Derived from the 'W2-ER-LOCN-ADDR' IDFDV Field Identifier (seq 2020).
119-140Employer Delivery AddressEnter the employer's delivery address (Street or Post Office Box).
Left justify and fill with blanks.
Derived from the 'W2-ER-DELIV-ADDR' IDFDV Field Identifier (seq 2030).
141-162Employer CityEnter the employer's city.
Left justify and fill with blanks.
Derived from the 'W2-ER-CITY' IDFDV Field Identifier (seq 2040).
163-164Employer State AbbreviationEnter the employer's State or commonwealth/territory. Use a postal abbreviation.
For a foreign address, fill with blanks.
Derived from the 'W2-ER-STATE' IDFDV Field Identifier (seq 2050).
165-169Employer ZIP CodeEnter the employer's ZIP Code.
For a foreign address, fill with blanks.
Derived from the 'W2-ER-ZIP' IDFDV Field Identifier (seq 2060).
170-173Employer ZIP Code ExtensionEnter the employer's four-digit extension of the ZIP code. If not applicable, fill with blanks.
Derived from the 'W2-ER-ZIP-EXT' IDFDV Field Identifier (seq 2070).
174Kind of EmployerRequired.
Enter the appropriate kind of employer:

* F = Federal Government
* State/local non-501c
* T = 501c non-government
* Y = State/local 501c
* N = None apply

NOTE: Leave blank if the tax jurisdiction Code in position 220 of the RE (Employer) Records is "P" (Puerto Rico).
175-178BlankFill with blanks. Reserved for SSA use.
179-201Foreign State/ProvinceIf applicable, enter the employer's foreign State/Province.
Left justify and fill with blanks. Otherwise, fill with blanks.
202-216Foreign Postal CodeIf applicable, enter the company's foreign postal code. Left justify and fill with blanks. Otherwise, fill with blanks.
217-218Country CodeIf one of the following applies, fill with blanks:

* One of the 50 States of the U.S.A.
* District of Columbia
* Military Post Office (MPO)
* American Samoa
* Guam
* Northern Mariana Islands
* Puerto Rico
* Virgin Islands

Otherwise, enter the applicable Country Code.
219Employment CodeRequired.
Enter the appropriate employment code:

* A = Agriculture (Form 943)
* H = Household (Schedule H)
* M = Military (Form 941)
* Q = Medicare Qualified Government Employment (Form 941)
* X = Railroad (CT-1)
* F = Regular (Form 944)
* R = Regular (all others) (Form 941).
NOTE: Railroad reporting is not applicable for Puerto Rico and territorial employers.
220Tax Jurisdiction CodeRequired.
Enter the code that identifies the type of income tax withheld from the employee's earnings:

* Blank (W-2)
* V = Virgin Islands (W-2VI)
* G = Guam (W-2GU)
* S = American Samoa (W-2AS)
* N = Northern Mariana Islands (W-2CM)
* P = Puerto Rico (W-2PR/499R-2)
221Third Party Sick Pay IndicatorEnter "1" for a sick pay indicator. Otherwise, enter "0" (zero).
222-248Employer Contact NameEnter the name of the employer's contact.
Left justify and fill with blanks.
249-263Employer Contact Phone NumberEnter the employer's contact telephone number with numeric values only (including area code). Do not use any special characters.
Left justify and fill with blanks.
264-268Employer Contact Phone ExtensionEnter the employer's contact telephone extension with numeric values only. Do not use any special characters.
Left justify and fill with blanks.
269-278Employer Contact Fax NumberIf applicable, enter the employer's contact fax number with numeric values only (including area code). Do not use any special characters.
Otherwise, fill with blanks.
For US and US Territories only
279-318Employer Contact E-Mail/InternetEnter the employer's contact e-mail/internet address.
319-512BlankFill with blanks. Reserved for SSA use.

Record Name: Code RW - Employee Wage Record (Same as Federal Code RW)#

State Media Magnetic Media Reporting - SSA EFW2 File Format for Annual and Quarterly Reporting#

Record Name: Code RW - Employee Wage Record #

ColumnDescriptionSource
1-2Record IdentifierConstant "RW"
3-11Social Security NumberRequired.
Enter the employee's SSN.
If an invalid SSN is encountered, this field is filled with zeros.
Derived from the ‘W2-EE-SSN’ (seq 2500) IDFDV Field Identifier.
12-26Employee First NameRequired.
Enter the employee's first name.
Left justify and fill with blanks.
Derived from the ‘W2-EE-FIRST-NAME’ (seq 2510) IDFDV Field Identifier.
27-41Employee Middle Name or InitialIf applicable, enter the employee's middle name or initial.
Left Justify and fill with blanks. Otherwise, fill with blanks.
Derived from the ‘W2-EE-MIDDLE’ (seq 2520) IDFDV Field Identifier.
42-61Employee Last NameRequired.
Enter the employee's last name.
Left justify and fill with blanks.
Derived from the ‘W2-EE-LAST-NAME’ (seq 2530) IDFDV Field Identifier.
62-65Employee SuffixIf applicable, enter the employee's alphabetic suffix.
Left justify and fill with blanks. Otherwise, fill with blanks.
Derived from the ‘W2-EE-SUFFIX’ (seq 2540) IDFDV Field Identifier.
66-87Employee Location AddressEnter the employee's location address (Attention, Suite, Room Number, etc.)
Left justify and fill with blanks.
Derived from the ‘W2-EE-LOCN-ADDR’ (seq 2600) IDFDV Field Identifier.
88-109Employee Delivery AddressEnter the employee's delivery address (Street or Post Office Box).
Left justify and fill with blanks.
Derived from the ‘W2-EE-DELIV-ADDR’ (seq 2610) IDFDV Field Identifier.
110-131Employee CityEnter the employee's City.
Left justify and fill with blanks.
Derived from the ‘W2-EE-CITY’ (seq 2620) IDFDV Field Identifier.
132-133Employee State AbbreviationEnter the employee's State or commonwealth/territory.
For a foreign address, fill with blanks.
Derived from the ‘W2-EE-STATE’ (seq 2630) IDFDV Field Identifier.
134-138Employee ZIP CodeEnter the employee's ZIP code.
For a foreign address, fill with blanks.
Derived from the ‘W2-EE-ZIP’ (seq 2640) IDFDV Field Identifier.
139-142Employee ZIP Code ExtensionEnter the employee's four-digit ZIP code extension.
If not applicable, fill with blanks.
Derived from the ‘W2-EE-ZIP-EXT’ (seq 2650) IDFDV Field Identifier.
143-147BlankFill with blanks. Reserved for SSA use.
148-170Employee Foreign State/ProvinceIf applicable, enter the employee's foreign State/Province.
Left justify and fill with blanks. Otherwise, fill with blanks.
Derived from the ‘W2-EE-F-STATE’ (seq 2660) IDFDV Field Identifier.
171-185Employee Foreign Postal CodeIf applicable, enter the employee's foreign postal code.
Left justify and fill with blanks. Otherwise, fill with blanks.
Derived from the ‘W2-EE-F-POSTAL’ (seq 2670) IDFDV Field Identifier.
186-187Employee Country CodeIf one of the following applies, fill with blanks:

* One of the 50 States of the U.S.A.
* District of Columbia
* Military Post Office (MPO)
* American Samoa
* Guam
* Northern Mariana Islands
* Puerto Rico
* Virgin Islands

Otherwise, enter the applicable Country Code.
Derived from the ‘W2-EE-COUNTRY’ (seq 2680) IDFDV Field Identifier.
188-198Wages, Tips and Other CompensationNo negative amounts.
Right justify and zero fill.
Derived from the ‘W2-FIT-WAGE’ (seq 3000) IDFDV Field Identifier.
Does not apply to Puerto Rico, Virgin Islands, American Samoa, Guam or Northern Mariana Islands employees.
199-209Federal Income Tax WithheldNo negative amounts.
Right justify and zero fill.
Derived from the ‘W2-FIT-TAX’ (seq 3010) IDFDV Field Identifier.
Does not apply to Puerto Rico, Virgin Islands, American Samoa, Guam or Northern Mariana Islands employees.
210-220Social Security WagesZero fill if the Employment Code reported in position 219 of the preceding RE (Employer) Record is 'Q-MGQE' or 'X-Railroad'.

If Employment Code is 'H-Household' and the tax year is 1994 or later, the sum of this field and the Social Security Tips field must be equal to or greater than the annual Household minimum for the tax year being reported. Otherwise, reports zeros.

The sum of this field and the Social Security Tips field should not exceed the annual maximum Social Security wage base for the tax year being reported.

No negative amounts.
Right justify and zero fill.
Derived from the ‘W2-SSN-WAGE’ (seq 3020) IDFDV Field Identifier.
221-231Social Security Tax WithheldZero fill if the Employment Code reported in position 219 of the preceeding RE (Employer_ Record is 'Q-MGQE' or 'X-Railroad'.

If the Employement Code is not 'Q-MGQE' or 'X-Railroad' and the amount in this field is greater than zero, then the Social Security Wages field and/or the Social Security Tips field must be greater than zero.

No negative amounts.
Right justify and zero fill.
Derived from the ‘W2-SSN-TAX’ (seq 3030) IDFDV Field Identifier.
232-242Medicare Wages and TipsZero fill if the Employment Code reported in position 219 of the preceding RE (Employer) Record is 'X-Railroad'.

If Employment Code is 'H-Household' and the tax year is 1994 or later, this field must be equal to or greater than the annual Household minimum for the tax year being reported. Otherwise, fill with zeros.

No negative amounts.
Right justify and zero fill.
Derived from the ‘W2-MEDI-WAGE’ (seq 3040) IDFDV Field Identifier.
243-253Medicare Tax WithheldZero fill if the Employment Code reported in position 219 of the preceding RE (Employer) Record is 'X-Railroad'.

No negative amounts.
Right justify and zero fill.
Derived from the ‘W2-MEDI-TAX’ (seq 3050) IDFDV Field Identifier.
254-264Social Security TipsZero fill if the Employment Code reported in position 219 of the preceding RE (Employer) Record is 'Q-MGQE' or 'X-Railroad'.

The sum of this field and the Social Security Wages field should not exceed the annual maximum Social Security wage base for the tax year being reported. Otherwise, reports zeros.

If Employment Code is 'H-Household' and the tax year is 1994 or later, the sum of this field and the Social Security Wages field must be equal to or greater than the annual Household minimum for the tax year being reported. Otherwise, report zeros.

No negative amounts.
Right justify and zero fill.
Derived from the ‘W2-SSN-TIP’ (seq 3060) IDFDV Field Identifier.
265-275BlankFill with blanks. Reserved for SSA use.
276-286Dependent Care BenefitsNo negative amounts.
Right justify and zero fill.
Derived from the ‘W2-DEP-CARE’ (seq 3090) IDFDV Field Identifier.
Does not apply to Puerto Rico, Virgin Islands, American Samoa, Guam or Northern Mariana Islands employees.
287-297Deferred Compensation Contributions to Section 401(k) (Code D)No negative amounts.
Right justify and zero fill.
Derived from the ‘W2-CODE-D’ (seq 4030) IDFDV Field Identifier.
Does not apply to Puerto Rico employees.
298-308Deferred Compensation Contributions to Section 403(b) (Code E)No negative amounts.
Right justify and zero fill.
Derived from the ‘W2-CODE-E’ (seq 4040) IDFDV Field Identifier.
Does not apply to Puerto Rico employees.
309-319Deferred Compensation Contributions to Section 408(k)(6) (Code F)No negative amounts.
Right justify and zero fill.
Derived from the ‘W2-CODE-F’ (seq 4050) IDFDV Field Identifier.
Does not apply to Puerto Rico employees.
320-330Deferred Compensation Contributions to Section 457(b) (Code G)No negative amounts.
Right justify and zero fill.
Derived from the ‘W2-CODE-G’ (seq 4060) IDFDV Field Identifier.
Does not apply to Puerto Rico employees.
331-341Deferred Compensation Contributions to Section 501(c)(18)(D) (Code H)No negative amounts.
Right justify and zero fill.
Derived from the ‘W2-CODE-H’ (seq 4070) IDFDV Field Identifier.
Does not apply to Puerto Rico employees.
342-352BlankFill with blanks. Reserved for SSA use.
353-363Nonqualified Plan Section 457 Distributions or ContributionsNo negative amounts.
Right justify and zero fill.
Derived from the ‘W2-NQUAL-457’ (seq 3102) IDFDV Field Identifier.
Does not apply to Puerto Rico employees.
364-374Employer Contributions to a Health Savings Account (Code W)No negative amounts.
Right justify and zero fill.
Derived from the ‘W2-CODE-W’ (seq 4190) IDFDV Field Identifier.
Does not apply to Puerto Rico or Northern Mariana Islands employees.
375-385Nonqualified Plan Not Section 457 Distributions or ContributionsNo negative amounts.
Right justify and zero fill.
Derived from the ‘W2-NQUAL-N457’ (seq 3104) IDFDV Field Identifier.
Does not apply to Puerto Rico employees.
386-396Nontaxable Combat Pay (Code Q)No negative amounts.
Right justify and zero fill.
Does not apply to Puerto Rico or Northern Mariana Islands employees.
397-407BlankFill with blanks. Reserved for SSA use.
408-418Employer Cost of Premiums for Group Term Life Insurance Over $50,000 (Code C)No negative amounts.
Right justify and zero fill.
Derived from the ‘W2-CODE-C’ (seq 4020) IDFDV Field Identifier.
Does not apply to Puerto Rico employees.
419-429Income from the Exercise of Non-Statutory Stock Options (Code V)No negative amounts.
Right justify and zero fill.
Derived from the ‘W2-CODE-V’ (seq 4180) IDFDV Field Identifier.
Does not apply to Puerto Rico employees.
430-440Deferrals Under a Section 409A Non-Qualified Deferred Compensation Plan (Code Y)No negative amounts.
Right justify and zero fill.
Does not apply to Puerto Rico or Northern Mariana Islands employees.
441-451Designated Roth Contributions to a Section 401 (k) Plan (Code AA)No negative amounts.
Right justify and zero fill.
Does not apply to Puerto Rico employees.
452-462Designated Roth Contributions to a Section 403 (b) Salary Reduction Agreement (Code BB)No negative amounts.
Right justify and zero fill.
Does not apply to Puerto Rico employees.
463-473Cost of Employer-Sponsored Health Coverage (Code DD)No negative amounts.
Right justify and zero fill.
Does not apply to Puerto Rico or Northern Mariana Islands employees.
474-484Permitted Benefits Under a Qualified Small Employer Health Reimbursement Arrangement (Code FF)No negative amounts.
Right justify and zero fill.
485BlankFill with blanks. Reserved for SSA use.
486Statutory Employee IndicatorEnter "1" for statutory employee. Otherwise, enter "0" (zero).
Derived from the ‘W2-STAT-EE’ (seq 6000) IDFDV Field Identifier.
487BlankFill with blanks. Reserved for SSA use.
488Retirement Plan IndicatorEnter "1" for a retirement plan. Otherwise, enter "0" (zero).
Derived from the ‘W2-RETIRE-PLAN’ (seq 6020) IDFDV Field Identifier.
489Third-Party Sick Pay IndicatorEnter "1" for a sick pay indicator. Otherwise, enter "0" (zero). Derived from the ‘W2-3PARTY-SICK’ (seq 6060) IDFDV Field Identifier.
490-512BlankFill with blanks. Reserved for SSA use.

Record Name: Code RO - Employee Wage Record (Optional for State Quarterly Reporting)#

State Media Magnetic Media Reporting - SSA EFW2 File Format for Annual and Quarterly Reporting#

Record Name: Code RO - Employee Wage Record #

ColumnDescriptionSource
1-2Record IdentifierConstant ‘RO’
3-11BlankFill with blanks. Reserved for SSA use.
12-22Allocated TipsNo negative amounts.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-ALLOC-TIP’ (seq 3070)
23-33Uncollected Employee Tax on Tips (Codes A and B)Combine the uncollected Social Security tax and the uncollected Medicare tax.
No negative amounts.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-A’ + Field Identifier: ‘W2-CODE-B’ (seq 4010)
34-44Medical Savings Account (Code R)No negative amounts.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-R’ (seq 4150).

Does not apply to Puerto Rico or Northern Mariana Islands employees.
45-55Simple Retirement Account (Code S)No negative amounts.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-S’ (seq 4160).

Does not apply to Puerto Rico employees.
56-66Qualified Adoption Expenses (Code T)No negative amounts.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-T’ (seq 4170).

Does not apply to Puerto Rico or Northern Mariana Islands employees.
67-77Uncollected Social Security or RRTA Tax on Cost of Group Term
Life Insurance over $50,000 (Code M)
No negative amounts.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-M’ (seq 4110).

Does not apply to Puerto Rico employees.
78-88Uncollected Medicare Tax on Cost of Group Term Life Insurance
over $50,000 (Code N)
No negative amounts.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-N’ (seq 4120).

Does not apply to Puerto Rico employees.
89-99Income Under a Nonqualified Deferred Compensation Plan
That Fails to Satisfy Section 409A (Code Z)
No negative amounts.
Right justify and zero fill.

Does not apply to Puerto Rico or Northern Mariana Islands employees.
100-110BlankFill with blanks. Reserved for SSA use.
111-121Designated Roth Contributions Under a Governmental
Section 457(b) Plan )(Code EE)
No negative amounts.
Right justify and zero fill.

Does not apply to Puerto Rico or Northern Mariana Islands employees.
122-132Income from Qualified Grants Under Section 83(i) (Code GG)No negative amounts.
Right justify and zero fill.
133-143Aggregate Deferrals Under Section 83(i) Elections as of
the Close of the Calendar Year (Code HH)
No negative amounts.
Right justify and zero fill.
144-274BlankFill with blanks. Reserved for SSA use.
275-285Wages Subject to Puerto Rico TaxNo negative amounts.
Right justify and zero fill.

For Puerto Rico employees only.
286-296Commissions Subject to Puerto Rico TaxNo negative amounts.
Right justify and zero fill.

For Puerto Rico employees only.
297-307Allowances Subject to Puerto Rico TaxNo negative amounts.
Right justify and zero fill.

For Puerto Rico employees only.
308-318Tips Subject to Puerto Rico TaxSNo negative amounts.
Right justify and zero fill.

For Puerto Rico employees only.
319-329Total Wages, Commissions, Tips, and Allowances
Subject to Puerto Rico Tax
No negative amounts.
Right justify and zero fill.

For Puerto Rico employees only.
330-340Puerto Rico Tax WithheldNo negative amounts.
Right justify and zero fill.

For Puerto Rico employees only.
341-351Retirement Fund Annual ContributionsNo negative amounts.
Right justify and zero fill.

For Puerto Rico employees only.
352-362BlankFill with blanks. Reserved for SSA use.
363-373Total Wages, Tips and Other Compensation Subject to
Virgin Islands, Guam, American Samoa or Northern Mariana Islands Income Tax
No negative amounts.
Right justify and zero fill.

For Virgin Islands, American Samoa, Guam, or Northern Mariana Islands employees only.
374-384Virgin Islands, American Samoa, Guam, or
Northern Mariana Islands Income Tax Withheld
No negative amounts.
Right justify and zero fill.

For Virgin Islands, American Samoa, Guam, or Northern Mariana Islands employees only.
385-512BlankFill with blanks. Reserved for SSA use.

Record Name: Code RS - State Wage Record (Same as Federal Code RS, except as noted)#

ColumnDescriptionSource
1-2Record IdentifierConstant "RS"
3-4State code, appropriate FIPS postal numeric codeIowa is code "19".
Derived from the State being reported, from IDFDV sequence 7000
5-9 IATaxing Entity CodeNot required for Iowa reporting. Fill with blanks
10-18Social Security NumberEnter the employee's SSN. If no SSN is available, enter zeros.
Derived from the ‘W2-EE-SSN’ IDFDV Field Identifier.
19-33Employee First NameEnter the employee's first name. Left justify and fill with blanks.
Derived from IDFDV W2-EE-FIRST-NAME Field Identifier
34-48Employee Middle Name or InitialEnter the employee's middle name or initial, if applicable. Left justify and fill with blanks.
Derived from IDFDV Field Identifier: ‘W2-EE-MIDDLE’
49-68Employee Last NameEnter the employee's last name. Left justify and fill with blanks. \Derived from IDFDV Field Identifier: ‘W2-EE-LAST-NAME’
69-72Employee SuffixEnter the employee's alphabetical suffix, if applicable. Left justify and fill with blanks.
Derived from IDFDV Field Identifier: ‘W2-EE-SUFFIX’
73-94Employee Location AddressEnter the employee's location address. Include suite, room number, etc. Left justify and fill with blanks.
Derived from IDFDV Field Identifier: ‘W2-EE-LOCN-ADDR’
95-116Employee Delivery AddressEnter the employee's delivery address. Left justify and fill with blanks.
Derived from IDFDV Field Identifier: ‘W2-EE-DELIV-ADDR’
117-138Employee CityEnter the employee's city. Left justify and fill with blanks.
Derived from IDFDV Field Identifier: ‘W2-EE-CITY’
139-140Employee State AbbreviationEnter the employee's State postal abbreviation. Left justify and fill with blanks. For a foreign address, fill with blanks.
Derived from IDFDV Field Identifier: ‘W2-EE-STATE’
141-145Employee ZIP CodeEnter the employee's zip code. For a foreign address, fill with blanks.
Derived from IDFDV Field Identifier: ‘W2-EE-ZIP’
146-149Employee ZIP Code ExtensionEnter the employee's four-digit zip code extension. If not applicable, fill with blanks.
Derived from IDFDV Field Identifier: ‘W2-EE-ZIP-EXT’
150-154BlankFill with blanks
155-177Employee Foreign State/ProvinceDerived from IDFDV, Field Identifier: ‘W2-EE-F-STATE’ (seq 2660)
178-192Employee Foreign Postal CodeDerived from IDFDV, Field Identifier: ‘W2-EE-F-POSTAL’ (seq 2670)
193-194Employee Country CodeDerived from IDFDV, Field Identifier: ‘W2-EE-COUNTRY’ (seq 2680)
195-242 IANot required for Iowa reportingFill with blanks
243-247 IAApplies to Quarterly Unemployment ReportingFill with blanks
248-267 IAState Employer Account NumberEnter the 12-digit Iowa Withholding Permit Number assigned by the Iowa Department of Revenue. Right justify and zero fill.
Derived from IDFDV, Field Identifier: ‘W2-STATE-REGIST’ for the reporting State

When RPYEU is run, if the Media Format = ‘State SUI File Format’, then this field contains the SUI Registration Number from IDGV for the SUI Registration of the State
268-273BlankFill with blanks
Location 274 to 337
Apply to Income Tax Reporting

If the user defined ‘Period Type’ = ‘Quarter’ or ‘Year’, then Location 274 to 337 will be filled.

ColumnDescriptionSource
274-275State codeFIPS (Federal Information Processing Standard) postal numeric code
System Derived from the State being reported (Example: Iowa is ‘19’)
276-286State Taxable WagesDerived from IDFDV, Field Identifier: ‘W2-ST-WAGE-HOME’(7020) and ‘W2-ST-WAGE-WORK’ (7030)
287-297State Income Tax WithheldDerived from IDFDV, Field Identifier: ‘W2-ST-TAX-HOME’ (7040) and ‘W2-ST-TAX-WORK’ (7050)
298-307VariousNot required for Iowa reporting. Fill with blanks
308 IATax Type CodeNot required for Iowa reporting. Fill with blanks
309-319 IALocal Taxable WagesNot required for Iowa reporting. Fill with zeroes
320-330 IALocal Income Tax WithheldNot required for Iowa reporting. Fill with zeroes
331-337 IAState Control NumberNot required for Iowa reporting. Fill with
338-412Supplemental Data 1Not required for Iowa reporting. Fill with blanks
413-487Supplemental Data 2Not required for Iowa reporting. Fill with blanks
488-512Blank
Multiple Code RS records
Multiple code RS records are generated for an employee if there are applicable county, city or school district tax information to be reported for a State. In this case, the State wages and tax will be zero for the subsequent code RS records.

Record Name: Code RT - Total Record (Same as Federal Code RT)#

State Media Magnetic Media Reporting - SSA EFW2 File Format for Annual and Quarterly Reporting#

Record Name: Code RT - Total Record #

ColumnDescriptionSource
1-2Record IdentifierConstant "RT"
3-9Number of RW RecordsTotal number of "RW" records reported since last "RE" record.
Right justify and zero fill.
10-24Wages, Tips and Other CompensationTotal of all "RW" records since last "RE" record.
Right justify and zero fill.
Does not apply to Puerto Rico, Virgin Islands, American Samoa, Guam or Northern Mariana Islands emplyees.
Derived from IDFDV Field Identifier: ‘W2-FIT-WAGE’
25-39Federal Income Tax WithheldTotal of all "RW" records since last "RE" record.
Right justify and zero fill.
Does not apply to Puerto Rico, Virgin Islands, American Samoa, Guam or Northern Mariana Islands emplyees.
Derived from IDFDV Field Identifier: ‘W2-FIT-TAX’
40-54Social Security WagesTotal of all "RW" records since last "RE" record.
Zero fill if the Employment Code is position 219 of the preceeding RE Employer Record is "Q-MQGE" or "X-Railroad".
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-SSN-WAGE’
55-69Social Security Tax WithheldTotal of all "RW" records since last "RE" record.
Zero fill if the Employment Code is position 219 of the preceeding RE Employer Record is "Q-MQGE" or "X-Railroad".
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-SSN-TAX’
70-84Medicare Wages and TipsTotal of all "RW" records since last "RE" record.
Zero fill if the Employment Code is position 219 of the preceeding RE Employer Record is "X-Railroad".
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-MEDI-WAGE’
85-99Medicare Tax WithheldTotal of all "RW" records since last "RE" record.
Zero fill if the Employment Code is position 219 of the preceeding RE Employer Record is "X-Railroad".
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-MEDI-TAX’
100-114Social Security TipsTotal of all "RW" records since last "RE" record.
Zero fill if the Employment Code is position 219 of the preceeding RE Employer Record is "Q-MQGE" or "X-Railroad".
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-SSN-TIP’
115-129BlankFill with blanks. Reserved for SSA use.
130-144Dependent Care BenefitsTotal of all "RW" records since last "RE" record.
Does not apply to Puerto Rico, Virgin Islands, American Samoa, Guam or Northern Mariana Islands employees.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-DEP-CARE’
145-159Deferred Compensation Contributions to
Section 401(k) (Code D)
Total of all "RW" records since last "RE" record.
Does not apply to Puerto Rico employees.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-D’
160-174Deferred Compensation Contributions to
Section 403(b)(Code E)
Total of all "RW" records since last "RE" record.
Does not apply to Puerto Rico employees.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-E’
175-189Deferred Compensation Contributions to
Section 408(k)(6) (Code F)
Total of all "RW" records since last "RE" record.
Does not apply to Puerto Rico employees.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-F’
190-204Deferred Compensation Contributions to
Section 457(b) (Code G)
Total of all "RW" records since last "RE" record.
Does not apply to Puerto Rico employees.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-G’
205-219Deferred Compensation Contributions to
Section 501(c)(18)(D) (Code H)
Total of all "RW" records since last "RE" record.
Does not apply to Puerto Rico employees.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-H’
220-234BlankFill with blanks. Reserved for SSA use.
235-249Nonqualified Plan Section 457 Distributions or ContributionsTotal of all "RW" records since last "RE" record.
Does not apply to Puerto Rico employees.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-NQUAL-457’
250-264Employer Contribution to a Health Savings Account
(Code W)
Total of all "RW" records since last "RE" record.
No negative amounts.
Does not apply to Puerto Rico or Northern Mariana Islands employees.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-W’
265-279Nonqualified Plan Not Section 457 Distributions or ContributionsTotal of all "RW" records since last "RE" record.
Does not apply to Puerto Rico employees.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-NQUAL-N457’
280-294Nontaxable Combat Pay (Code Q)Total of all "RW" records since last "RE" record.
Does not apply to Puerto Rico or Northern Mariana Islands employees.
Right justify and zero fill.
295-309Cost of Employer-Sponsored Health Coverage
(Code DD)
Total of all "RW" records since last "RE" record.
Does not apply to Puerto Rico or Northern Mariana Islands employees.
Right justify and zero fill.
310-324Employer Cost of Premiums for Group Term Life Insurance over $50,000 (Code C)Total of all "RW" records since last "RE" record.
Does not apply to Puerto Rico employees.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-C’
325-339Income Tax Withheld by Payer of Third-Party Sick PayTotal of all "RW" records since last "RE" record.
Total Federal Income Tax withheld by third-parties (generally insurance companies) from sick or disability payments made to your employees.
Does not apply to Puerto Rico employees.
Derived from IDFDV Field Identifier: ‘SUB-3RD-PARTY-TAX’
340-354Income from the Exercise of Non-statutory Stock Options (Code V)Total of all "RW" records since last "RE" record.
Does not apply to Puerto Rico employees.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-V’
355-369Deferrals Under a Section 409A Nonqualified Deferred Compensation Plan (Code Y)Total of all "RW" records since last "RE" record.
Does not apply to Puerto Rico or Northern Mariana Islands employees.
Right justify and zero fill.
370-384Designated Roth Contributions to a Section
401(k) Plan (Code AA)
Total of all "RW" records since last "RE" record.
Does not apply to Puerto Rico employees.
Right justify and zero fill.
385-399Designated Roth Contributions to a Section
403(b) Salary Reduction Agreement (Code BB)
Total of all "RW" records since last "RE" record.
Does not apply to Puerto Rico employees.
Right justify and zero fill.
400-414Permitted Benefits Under a Qualified Small Employer Health Reimbursement Arrangement (Code FF)Total of all "RW" records since last "RE" record.
Right justify and zero fill.
415-512BlankFill with blanks. Reserved for SSA use.

Record Name: Code RU - Total Record (Optional for State Quarterly Reporting)#

State Media Magnetic Media Reporting - SSA EFW2 File Format for Annual and Quarterly Reporting#

Record Name: Code RU - Total Record #

ColumnDescriptionSource
1-2Record IdentifierConstant "RU"
3-9Number of RO RecordsTotal number of "RO" records reported since last "RE" record.
Right justify and zero fill.
10-24Allocated TipsTotal of all "RO" records since last "RE" record.
Right justify and zero fill.
Does not apply to Puerto Rico, Virgin Islands, American Samoa, Guam or Northern Maraina Islands employees.
Derived from IDFDV Field Identifier: ‘W2-ALLOC-TIP’
25-39Uncollected Employee Tax on Tips (Code A and B)Total of all "RO" records since last "RE" record.
Right justify and zero fill.
Derived from IDFDV Field Identifier: ‘W2-CODE-A’ and ‘W2-CODE-B’
40-54Medical Savings Account (Code R)Total of all "RO" records since last "RE" record.
Right justify and zero fill.
Does not apply to Puerto Rico or Northern Maraina Islands employees.
Derived from IDFDV Field Identifier: ‘W2-CODE-R’
55-69Simple Retirement Account (Code S)Total of all "RO" records since last "RE" record.
Right justify and zero fill.
Does not apply to Puerto Rico employees.
Derived from IDFDV Field Identifier: ‘W2-CODE-S’
70-84Qualified Adoption Expenses (Code T)Total of all "RO" records since last "RE" record.
Right justify and zero fill.
Does not apply to Puerto Rico or Northern Maraina Islands employees.
Derived from IDFDV Field Identifier: ‘W2-CODE-T’
85-99Uncollected SSA tax or RRTA Tax on Cost of Group Term Life
Insurance over $50,000 (Code M)
Total of all "RO" records since last "RE" record.
Right justify and zero fill.
Does not apply to Puerto Rico employees. Derived from IDFDV Field Identifier: ‘W2-CODE-M’
100-114Uncollected Medicare Tax on Cost of Group Term Life Insurance
over $50,000 (Code N)
Total of all "RO" records since last "RE" record.
Right justify and zero fill.
Does not apply to Puerto Rico employees.
Derived from IDFDV Field Identifier: ‘W2-CODE-N’
115-129Income Under a Nonqualified Deferred Compensation Plan
That Fails to Satisfy Section 409A (Code Z)
Total of all "RO" records since last "RE" record.
Right justify and zero fill.
Does not apply to Puerto Rico or Northern Maraina Islands employees.
130-144BlankFill with blanks. Reserved for SSA use.
145-159Designated Roth Contributions Under a Governmental
Section 457(b) Plan (Code EE)
Total of all "RO" records since last "RE" record.
Right justify and zero fill.
Does not apply to Puerto Rico or Northern Maraina Islands employees.
160-174Income from Qualified Equity Grants Under Section 83(i) (Code GG)Total of all "RO" records since last "RE" record.
Right justify and zero fill.
175-189Aggregate Deferrals Under Section 83(i) Elections as
of the Close of the Calendar Year (Code HH)
Total of all "RO" records since last "RE" record.
Right justify and zero fill.
190-354BlankFill with blanks. Reserved for SSA use.
355-369Wages Subject to Puerto Rico TaxTotal of all "RO" records since last "RE" record.
Right justify and zero fill.
For Puerto Rico employees only.
370-384Commissions Subject to Puerto Rico TaxTotal of all "RO" records since last "RE" record.
Right justify and zero fill.
For Puerto Rico employees only.
385-399Allowances Subject to Puerto Rico TaxTotal of all "RO" records since last "RE" record.
Right justify and zero fill.
For Puerto Rico employees only.
400-414Tips Subject to Puerto Rico TaxTotal of all "RO" records since last "RE" record.
Right justify and zero fill.
For Puerto Rico employees only.
415-429Total Wages, Commissions, Tips and Allowances
Subject to Puerto Rico Tax
Total of all "RO" records since last "RE" record.
Right justify and zero fill.
For Puerto Rico employees only.
430-444Puerto Rico Tax WithheldTotal of all "RO" records since last "RE" record.
Right justify and zero fill.
For Puerto Rico employees only.
445-459 Retirement Fund Annual ContributionsTotal of all "RO" records since last "RE" record.
Right justify and zero fill.
For Puerto Rico employees only.
460-474Total Wages, Tips and Other Compensation Subject to
Virgin Islands, Guam, American Samoa or Northern Mariana
Islands Income Tax
Total of all "RO" records since last "RE" record.
Right justify and zero fill.
For Virgin Islands, Guam, American Samoa or Northern Mariana Islands employees only.
475-489Virgin Islands, Guam, American Samoa, or Northern Mariana Islands Income Tax WithheldTotal of all "RO" records since last "RE" record.
Right justify and zero fill.
For Virgin Islands, Guam, American Samoa or Northern Mariana Islands employees only.
490-512BlankFill with blanks. Reserved for SSA use.

Record Name: Code RV – State Total Record (required for State of Iowa)#

ColumnDescriptionSource
1-2Record IdentifierConstant "RV"
3-9Number of Iowa RS recordsEnter the total number of State of Iowa RS records reported since the last RE record. Right justify and zero fill.
10-24Iowa Wages, Tips and Other CompensationEnter the sum amount of all State of Iowa RS records reported since the last RE record. Right justify and zero fill.
25-39Iowa Income Tax WithheldEnter the sum amount of all State of Iowa RS records reported since the last RE record. Right justify and zero fill.
40-47Employer's BEN numberBusiness eFile Number, if applicable. May be zero if no Iowa tax was withheld and no Iowa permit was provided in the RS records.
48-57Iowa Confirmation NumberNot required for Iowa reporting. Enter zeros
58-512BlankFill with blanks

Record Name: Code RF - Final Record (Same as Federal Code RF)#

State Media Magnetic Media Reporting - SSA EFW2 File Format for Annual and Quarterly Reporting#

Record Name: Code RF - Final Record#

ColumnDescriptionSource
1-2Record IndentifierConstant "RF"
3-7BlankFill with blanks. Reserved for SSA use
8-16Number of RW RecordsTotal number of RW (Employee) Records reported on the entire file.
Right justify and zero fill
17-512BlankFill with blanks. Reserved for SSA use

State Quarterly UI Wage Reporting – .CSV File Format#

UEEF must be run with the following report parameters defined to generate the Iowa State Quarterly file information in the .CSV format.

ParameterDescriptionSource
As Of DateEnter the quarter end date, such as 30-Jun-20YY
Interface Format CodeUse the annual supplied form code, such as 'HL$US-QTR-IA20YY'. The 'Variables' need to be entered on this form code for specific use in the installation.
Directory Name Mandatory. Defines the name of the government Magnetic Media file. Must be defined or an output file will not be produced
Media File NameMandatory. Defines the media file name of the data being uploaded. Must be defined or an output file will not be produced

Quarterly UI Wage Magnetic Media Reporting - .CSV File Format#

ColumnDescriptionSource
1Sequence NumberMaximum 1500 records per file
2UI Account NumberIncluding leading zero
3Federal EINEnter only numeric characters of the Federal EIN
4Year and Quarter (YYYYQ)Example: 20192
5Employee’s Social Security NumberNumeric values only
6Employee Last NameMaximum 30 characters
7Employee First NameMaximum 15 characters
8Employee Middle InitialEnter employee's middle initial. Fill with blanks if no middle initial
9State QTR Unemployment Insurance Total WagesEnter quarterly wages subject to unemployment taxes
(from Pay Element 'SUI WAGES' if the standard IDIF file definition 'HL$US-QTR-IA20YY' is used)
10Reporting Unit Number4 digits, including leading zero

Notes#

Click to create a new notes page