US W2 ANNUAL AND QUARTERLY PROCESSING - NEW YORK#

Set Up#

This document contains abbreviated set up requirement for the state of New York only, please refer to the general document (Tax Reporting - US General) for other setup procedure that may also be required.

IDGV - State Registration#

  • The IDGV Definition tab must be set up for 'State Registration' for State/Province: New York.
  • The IDGV Variables tab must be set up for 'State Registration' for State/Province: New York.
  • 'W2 STATE MEDIA FILING' - Must be ‘02’ to generate NY state magnetic media file for state of NY only.

IDGV - State SUI Registration#

  • The IDGV Definition tab must be set up with ‘State SUI Registration’ for State/Province: New *The IDGV Variables tab must be set up with ‘State SUI Registration’ for State/Province: New York
  • ‘W2 STATE MEDIA FILING’ - Must be ‘02’ to generate UI wage magnetic media file for state of New York

State File Procedures #

  • The state of New York Department of Revenue accepts filing of W-2s and Quarterly UI filing via magnetic media using the EFW2 file format.
  • Records required for both the W2 and UI reporting are: Codes RA,RE,RS,RU,RF;
  • New York state requires to file the NY state file by itself, therefore IDGV must be set up as follows:
    • for State Registration of New York, the IDGV Variables:
      • ‘W2 STATE MEDIA FILING’ 02 – State requires its own file, do not include other state information in the NY state file

Annual W2 Magnetic Media Wage Reporting – EFW2 Format#

RPYEU#

RPYEU must be run and the following selected to generate New York state file information:

Report Parameters

Annual Form CodeUse standard form code, such as 'HL$US-W2-YYYY'
Period TypeYear
Period End DateYear End Date, such as 31-Dec-YYYY
Media FormatState File Format
Directory NameMust be defined or an output file will not be generated
Media File NameMust be defined or an output file will not be generated


Report Filters

Select StateNew York, USA

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.

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.

Code RW - Employee Wage Record (Same as the 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.


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

Record Name: Code RS - State Wage Record#

ColumnDescriptionSource
1-2Record IdentifierConstant "RS"
3-4State codeAppropriate FIPS postal numeric code

Derived from the State being reported, from IDFDV sequence 7000

Numeric code for New York is ‘36’
5-9Taxing Entity CodeIf County, City or School district tax is reported, this field is derived from IDGV 'W2 TAXING ENTITY' field for the County, City or School district tax being reported
10-18Social Security NumberDerived from IDFDV Field Identifier: ‘W2-EE-SSN’ (seq 2500)

If an invalid SSN is encountered, this field is entered with zeroes
19-33Employee First NameDerived from IDFDV Field Identifier: ‘W2-EE-FIRST-NAME’ (seq 2510)
34-48Employee Middle Name or InitialDerived from IDFDV Field Identifier: ‘W2-EE-MIDDLE’ (seq 2520)
49-68Employee Last NameDerived from IDFDV Field Identifier: ‘W2-EE-LAST-NAME’ (seq 2530)
69-72Employee SuffixDerived from IDFDV Field Identifier: ‘W2-EE-SUFFIX’ (seq 2540)
73-94Employee Location AddressDerived from IDFDV Field Identifier: ‘W2-EE-LOCN-ADDR’ (seq 2600)
95-116Employee Delivery AddressDerived from IDFDV Field Identifier: ‘W2-EE-DELIV-ADDR’ (seq 2610)
117-138Employee CityDerived from IDFDV Field Identifier: ‘W2-EE-CITY’ (seq 2620)
139-140Employee State AbbreviationDerived from IDFDV Field Identifier: ‘W2-EE-STATE’ (seq 2630)
141-145Employee ZIP CodeDerived from IDFDV Field Identifier: ‘W2-EE-ZIP’ (seq 2640)
146-149Employee ZIP Code ExtensionDerived from IDFDV Field Identifier: ‘W2-EE-ZIP-EXT’ (seq 2650)
150-154Blank
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)
Location 195 to 267
Applicable to Quarterly Unemployment Reporting
ColumnDescriptionSource
195-196Optional CodeState Specific Data

If not used, enter blanks
197-202Reporting Period MMCCYYFrom user specified Period End Date converted to MMCCYY for the quarter

e.g. Period End Date = ‘31-Dec-2016’, then reporting period is ‘122016’
203-213State Quarterly Unemployment Insurance Total WagesDerived from IDFDV Field Identifier: ‘W2-ST-WAGE-HOME’ and ‘W2-ST-WAGE-WORK’

Note that the IDFDV Identifier ‘W2-SUI-WAGE-ER’ is not used to report this field because the value of Identifier ‘W2-SUI-WAGE-ER’ may already have been capped by Vertex during the US Tax calculation in UPCALC and therefore for employees who exceed the maximum wage base, this Identifier will contain no SUI Insurance wages. RPYEU will then be using the State Taxable wages from Identifier ‘W2-ST-WAGE-HOME’ and ‘W2-ST-WAGE-WORK’ that are related to the employee Home GEO and Work GEO code to report SUI Total Wages
214-224State Quarterly Unemployment Insurance Taxable WagesThis amount is derived from State Quarterly Unemployment Insurance Total Wages and the SUI Maximum wage base as defined by the State government

Please see Tax Reporting - US General for detail for quarterly reporting
225-226Number of Weeks WorkedFrom system derived number of Weeks Worked for the Reporting State

The system reads all pay headers with pay category = ‘Regular Pay’ that are not reversed with Pay Issue Date falls within the user specified Quarter begin and end date

If the Pay Header’s Work State or Home State is the same as the reporting State, then the Pay Header Tax Weeks is accumulated
227-234Date First Employed MMDDCCYYFrom system derived latest Employment Hired Date
235-242Date of Separation MMDDCCYYFrom system derived latest Employment Termination Date that is greater than the Employment Hired Date
243-247Blank
248-267State Employer Account NumberDerived 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-273Blank
274-275State code, appropriate FIPS postal numeric codeDerived from the State being reported

e.g. Numeric code for New York is "36"
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-307Other State Data, to be defined by each state
308Tax Type CodeThis field is used to report County, City or School district tax

If the County, City or School district requires to report taxes along with the State Tax information, then the following values are used for this field:
C – City Income Tax
D – County Income Tax
E – School District Income Tax
F – Other Income Tax

IDGV must be set up for the Local or School Registration by County/City or School district for the following fields on the Variables Tab:

'W2 STATE MEDIA FILING'
'W2 TAX TYPE CODE'
'W2 TAXING ENTITY'

'W2 STATE MEDIA FILING' indicates whether the County/City or School should report taxes with the State or not

'W2 TAX TYPE CODE' must contain the valid Tax Type Code as defined above

'W2 TAXING ENTITY' contains the Taxing Entity code supplied by the County/City or School government booklet

If County, City or School district tax is reported, this field is derived from IDGV 'W2 TAX TYPE CODE' field
309-319Local Taxable WagesIf School Tax is reported, this field is derived from Identifier ‘W2-SCHL-WAGE’ (seq 6500)

If County Tax is reported, this field is derived from Identifier: ‘W2-CN-WAGE-HOME’ and ‘W2-CN-WAGE-WORK’

If City Tax is reported, this field is derived from: ‘W2-CI-WAGE-HOME’ and ‘W2-CI-WAGE-WORK’
320-330Local Income Tax WithheldIf School Tax is reported, this field is derived from Identifier ‘W2-SCHL-TAX’ (seq 6510)

If County Tax is reported, this field is derived from Identifier: ‘W2-CN-TAX-HOME’ and ‘W2-CN-TAX-WORK’

If City Tax is reported, this field is derived from: ‘W2-CI-TAX-HOME’ and ‘W2-CI-TAX-WORK’
331-337State Control Number (optional)Blank
338-412Supplemental Data 1State Specific Data

If not used, enter blanks
413-487Supplemental Data 2State Specific Data

If not used, enter 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.

Code RT - Total Record (Same as the 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.


Code RF - Final Record (Same as the 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

Quarterly UI Magnetic Media Wage Reporting – EFW2 Format#

RPYEU#

RPYEU must be run and the following selected to generate New York state file information:

Annual Form CodeUse the standard supplied form code HL$US-W2-20YY. The ‘Variables’ will need to be entered in this Form Code specifically in the installation.
Period TypeQuarter
Period End DateEnter the quarter end date. Example: DD-MMM-YYYY
Select StateNew York, USA
Media File TypeState SUI File Format. If the Directory Name/Media File Name is not supplied, an output file will not be produced.

Please note that the following ‘Not Required’ fields may or may not always contain blanks. Note: Columns coded with NY indicates it is a New York specific requirement which is not the standard record format.

Record Name: Code RA - Transmitter Record #

ColumnDescriptionSource
1-2Record IdentifierConstant ‘RA’
3-13Submitter’s Employer ID number (EIN)Numeric only

Derived from IDFDV Field Identifier: ‘SUB-ER-EIN’
14-216Blank
217-273Submitter NameDerived from IDFDV Field Identifier: ‘SUB-SUBM-NAME’
274-295Submitter Location AddressDerived from IDFDV Field Identifier: ‘SUB-SUBM-LOCN’
296-317Submitter Delivery AddressDerived from IDFDV Field Identifier: ‘SUB-SUBM-DELIV’
318-339Submitter CityDerived from IDFDV Field Identifier: ‘SUB-SUBM-CITY’
340-341Submitter State AbbreviationDerived from IDFDV Field Identifier: ‘SUB-SUBM-STATE’
342-346Submitter ZIP CodeDerived from IDFDV Field Identifier: ‘SUB-SUBM-ZIP’
347-350Submitter ZIP Code ExtensionDerived from IDFDV Field Identifier: ‘SUB-SUBM-ZIP-EXT’
351-395Blank
396-422Contact NameDerived from IDFDV Field Identifier: ‘SUB-CONT-NAME’
423-437Contact Phone NumberDerived from IDFDV Field Identifier: ‘SUB-CONT-TEL’
438-442Contact Phone ExtensionDerived from IDFDV Field Identifier: ‘SUB-CONT-TEL-EXT’
443-445Blank
446-485Contact E-mailDerived from IDFDV Field Identifier: ‘SUB-CONT-EMAIL’
486-488Blank
489-512Contact FAXDerived from IDFDV Field Identifier: ‘SUB-CONT-FAX’

Record Name: Code RE - Employer Record#

ColumnDescriptionSource
1-2Record IdentifierConstant ‘RE’
3-7Blank
8-18Employer/Agent EINSystem derived the applicable Federal reporting EIN, from IDGV or IDGR
19-39Blank
40-118Employer NameDerived from IDFDV Field Identifier: ‘W2-ER-NAME’
119-140Employer Delivery AddressDerived from IDFDV Field Identifier: ‘W2-ER-DELIV-ADDR’
141-162Employer CityDerived from IDFDV Field Identifier: ‘W2-ER-CITY’
163-164Employer State FIPS Postal AbbreviationDerived from IDFDV Field Identifier: ‘W2-ER-STATE’
165-169Employer ZIP CodeDerived from IDFDV Field Identifier: ‘W2-ER-ZIP’
170-173Employer ZIP Code ExtensionDerived from IDFDV Field Identifier: ‘W2-ER-ZIP-EXT’
174-178Quarter and Year Being Reported

Format should be QYYYY with Q values of 1,2,3, or 4. and YYYY values being the tax year
179-512Blank

Record Name: Code RS - Supplemental Record#

ColumnDescriptionSource
1-2Record IdentifierConstant "RS"
3-4State CodeAppropriate FIPS postal numeric code

Derived from the State being reported, from IDFDV sequence 7000

e.g. New York numeric code is "36"
5-9Blank
10-18Social Security NumberDerived from IDFDV Field Identifier: ‘W2-EE-SSN’

If an invalid SSN is encountered, this field is entered with zeroes
19-33Employee First NameDerived from IDFDV Field Identifier: ‘W2-EE-FIRST-NAME’
34-48Employee Middle Name or InitialDerived from IDFDV Field Identifier: ‘W2-EE-MIDDLE’
49-68Employee Last NameDerived from IDFDV Field Identifier: ‘W2-EE-LAST-NAME’
69-72Employee SuffixDerived from IDFDV Field Identifier: ‘W2-EE-SUFFIX’
73-202 NYBlank
203-213State Quarterly Unemployment Insurance Total WagesDerived from IDFDV Field Identifier: ‘W2-ST-WAGE-HOME’ and ‘W2-ST-WAGE-WORK’

Note that the IDFDV Identifier ‘W2-SUI-WAGE-ER’ is not used to report this field because the value of Identifier ‘W2-SUI-WAGE-ER’ may already been capped by Vertex during the US Tax calculation in UPCALC and therefore for employees who exceed the maximum wage base, this Identifier will contain no SUI Insurance wages. RPYEU would be using the State Taxable wages from Identifier ‘W2-ST-WAGE-HOME’ and ‘W2-ST-WAGE-WORK’ that are related to the employee Home GEO and Work GEO code to report SUI Total Wages.
214-242Blank
243-243 NYWage TypeWages type identifier

‘W’ for regular wages, and ‘O’ for other wages

Derived from IDGV setup (‘Variables’ tab).
244-275Blank
276-286Gross Wages subject to withholdingEnter zeros for Quarter 1, Quarter 2, and Quarter 3

Enter Annual Amount for Quarter 4 only

Derived from IDFDV, Annual Amount, Field Identifier: ‘W2-ST-WAGE-HOME’ (seq 7020) plus ‘W2_ST_WAGE_WORK’ (sequence 7030)
287-297Total Tax WithheldNYS, NYC, and Yonkers income tax withheld (lump sum)

Enter zeros for Quarter 1, Quarter 2, and Quarter 3

Enter Annual Amount for Quarter 4 only

Derived from IDFDV, Annual Amount, Field Identifier: ‘W2-ST-TAX-HOME’ (seq 7040) plus ‘W2_ST_TAX_WORK’ (sequence 7050)
298-512 NYBlank
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 RU - Total Record#

ColumnDescriptionSource
1-2Record IdentifierConstant ‘RU’
3-9Number of RS RecordsTotal number of code "RS" records reported for this employer
10-512Blank

Record Name: Code RF - Final Record#

ColumnDescriptionSource
1-2Record IdentifierConstant ‘RF’
3-512 NYBlank

Notes#

Click to create a new notes page