NYSTRS Employer Reporting System provides comprehensive communication regarding rejected files, which may also serve to help reduce the number of files that are rejected.
When a file rejects, our e-mail communication will provide you with a descriptive explanation of why the file rejected and report the line number of each record that includes unacceptable data, up to a maximum of 155 lines of errors. This should provide you with enough information to easily correct and resubmit your file. Below you will find a list of the comprehensive error messages you will receive with your rejected file e-mails.
To minimize the number of manual corrections NYSTRS staff has to make, we widened the scope of data issues that the pre-processor will reject.
Listed below is a brief description of important changes that will cause your file to reject:
If you have any questions, please call us at (800) 348-7298, Ext. 6220 (447-2900 if calling from the Albany area).
| Ref # |
Category of Error |
Possible Cause of the Error |
| 02 |
Data Format Errors |
1) Invalid number of columns in CSV file. Found <nn> columns; expecting 57. File rejected.
This is unique to CSV (Comma Separated Values) file format reporting. Columns are determined by number of commas in the line. The <nn> is the number of columns detected. The number of columns detected (in a row) DID NOT contain the required 57 columns.
2) Not a valid data line – record type invalid.
This is unique to CSV (Comma Separated Values) file format reporting. The record Identifier (column 2) MUST contain the number 2. No other value is acceptable.
3) is not a valid data line – record type must be 1 or 2.
The record Identifier (column 2) MUST contain the number 1 or 2. No other value is acceptable. The 1 record type contains Control information that summarizes the values of many of the record type 2 format. The record type 2 format is the details per employee being reported.
|
| 03 |
Control Rec Out of Balance |
1) Sum <nnnnnnnn.nn> is not Equal Control Record value of (<nnnnnnnn.nn>).
2) <nnnnnnnn> is not numeric.
3) <nnnnnnnn> does not = sum of other money fields <nnnnnnnn>.
In the Control Record each Total data field must be numeric and equal to the sum of the respective column from the Detail records in the file. Additionally the Total Gross in the Control Record must equal the sum of its parts. The formula is as follows: (A) MTD (Month To Date) Gross Pay = (B) MTD Base Salary Pay
+ (C) MTD Instructional Pay
+ (D) MTD Summer School Pay
+ (E) MTD Holdover Pay
+ (F) MTD Partial Leave Pay
+ (G) MTD Retro Earliest Prior Yr Pay
+ (H) MTD Retro Next Prior Yr Pay
+ (I) MTD Retro Latest Prior Yr Pay
+ (J) MTD Awards Pay
+ (K) MTD Termination Pay
+ (L) MTD Non-Reg Comp Pay
+ (M) MTD Non-STRS Pay
+ (N) MTD Post-Retirement Pay
+ (O) MTD Undefined Pay
|
| 04 |
Control Rec Errors |
1) No valid header found; File rejected for District = <xxxx>.
The Data MUST have a Control Header Record as a Record Identifier = 1. None was found AFTER processing the Data File.
2) Multiple Control headers found.
The Data has more than 1 Control Header Record. Control Header records are identified by a 1 in the Record Identifier field. Each District can only have one control record. |
| 05 |
District Level Errors |
1) <xxxx> Non-numeric district number found.
The reported Location Code (District Number) is the first 4 digits in a 5-digit column was not Numeric. All NYSTRS Location Codes are numeric values.
2) <xxxx> District number is NOT an Active District.
The reported Location Code (District Number) was valid in the past but is now marked as inactive.
3) <xxxx> District number IS NOT VALID.
The reported Location Code (District Number) is unknown to NYSTRS.
4) <xxxx> District number is not the same as the District-In Folder [<xxxx>].
The reported Location Code (District Number) found in the data did not match to the proper FTP folder. The first <xxxx> reference is the District Number found in the data and the second [<xxxx>] reference is the FTP folder that the data was processed from. Each District has a unique FTP data storage folder and this message occurs when the data from one District has been placed in the wrong folder. Generally this only happens to service vendors that provide NYSTRS reporting for multiple school districts. |
| 10 |
Date Format Errors |
1) <xxxxxxxxxx> contains non-numeric characters, or is formatted incorrectly.
2) <xxxxxxxxxx> is not CCYY-MM-DD format.
3) <xxxxxxxxxx> Year is not numeric CCYY format.
4) <xxxxxxxxxx> is not CCYY-MM-DD format.
5) <xxxxxxxxxx> is not a reasonable date.
6) <xxxxxxxxxx> Month is not numeric MM format.
7) <xxxxxxxxxx> has an invalid month (<MM>).
8) <xxxxxxxxxx> has an invalid day (<DD>).
9) <xxxxxxxxxx> has an invalid day of month (<MM>).
10) <xxxxxxxxxx> begins on other than the 1st of the month.
11) <xxxxxxxxxx> ends on other than the last day of the month.
The date format is rigid, but not all dates are required. For instance, Hire Date is not required, but Birth Date is. When a non-required date is reported, it MUST follow the same rules as required dates. The date format is 10 characters with the Century and Year (CCYY), followed by a "-" (dash), followed by the 2-digit Month (MM), followed by a second "-" (dash) and finally followed by the 2-digit Day of the Month. This is represented by CCYY-MM-DD or for example 2007-02-01 for the first day of Febuary for the year 2007. Note that both the Month and Day contain the leading zero. All digits must be numeric and represent real dates. Some dates are range tested on the CCYY portion of the date. Ranges are set based on the Current Date with plus or minus +(-) number of years. Months and Days must represent legal calendar dates. A variety of exception messages above are produced by Date errors. Special date range tests are related to # 5 above under reference #10 Date Format errors. The special ranges for dates are described in the following.
Birth dates are required but not always available for a new employee. It has a special permitted value of 1901-01-01. This is outside the normal range, but it is used to signify that the Birth Date is unknown.
Beginning and Ending CCYY reporting dates must be between (minus 2 years) or 2005 and the Current CCYY of 2007 assuming the Current Date was 2007-02-01.
Ceased Teaching Date (when reported) has no range limit on the CCYY. Only edited if Separation Reason has also been reported.
Hire Date is not edited.
ORP Employment Date is not edited. |
| 15 |
Begin and End Date comparision violations (Reporting Month Start and End) |
1) <CCYY-MM-DD> not consistent with first begin date <CCYY-MM-DD>.
2) <CCYY-MM-DD> not the same year/month as Begin Date <CCYY-MM-DD>.
Begin and End reporting dates have additional requirements. They are required to occur in the same reporting cycle. For example, using the 2007-02-01 sample above as the Begin Date the appropriate Ending Date would be 2007-02-28. Each month's reporting must have the 1st of the month, and Ending Date is the last calendar day of the same month and year. |
| 20 |
TAB Characters |
<xxxxxxxxxxxxx> is invalid, TAB character found.
TAB characters are not allowed in any data field. The <xxxxxxxxxxxxxxx> above is replaced with the name of the data field (column) where the TAB character was found. These are often invisible to see unless you turn on special editing features in your text editor. They cause characters to align on defined boundaries. The space character should be used to force the alignment, not TAB characters. If your data is being prepared in a Text Editor, the best way to avoid this is to use the Courier or Courier New fonts and use the space bar to force the required alignment. |
| 25 |
Blank or Missing Data |
<xxxxxxxxxxxxx> is blank, Required field.
Many data fields (columns) are required. The <xxxxxxxxxxxxxxx> above is replaced with the name of the data field (column) where the blank was detected. |
| 26 |
First Name |
is blank, Required field. |
| 27 |
|
<xxxxxxxx> contains invalid characters. ONLY (A-Z a-z), (Blank), ('), or (-) are valid.
These edits only occur when the EmplID is missing or invalid format. The First Name field becomes required because this case will become a New Employee if it also has a valid Social Security number, is indicated as a Full Time employee or has been reported with contributions. First name cannot contain any numbers. The (Blank) above refers to embedded blanks not the entire data field being blank.
|
| 30 |
Last Name |
<xxxxxxxxxxxxx> contains invalid characters. ONLY (A-Z a-z), (0-9), (Blank), ('), (.), (,) or (-) are valid.
The (Blank) above refers to embedded blanks not the entire data field being blank. EXCEPTION: CSV file format Names cannot contain embedded commas. |
| 35 |
Social Security Edit (Current NID and Prior NID) |
1) <xxxxxxxxx> contains non-numeric characters.
2) <xxxxxxxxx> cannot be zeros.
3) <xxxxxxxxx> must be 9 digits.
The Social Security Numbers must be all numeric characters from 0-9, no blanks and not all zero characters. Certain exceptions apply. If the NYSTRS EmplID, Last Name, and Birth Date are present and they satisfy the individual edits, the Current NID column is accepted as is. SUNY Location Code (Districts) are allowed to report using Blanks and Zeroes. Prior NID's are accepted with blanks and zeroes, but if reported they must be numeric characters. Masked (such as xxxxx1234 or *****1234) can be a valid format. The first 5 characters will be treated as a "mask" if they are all the same non-numeric character). |
| 40 |
NYSTRS EmplID |
1) <xxxxxxxxx> is invalid, Format is not acceptable.
The NYSTRS EmplID (or Member Number) must contain 6 or 7 consecutive numeric characters starting from the left of the data field (column). Following the numeric characters can be Blanks or a single "R." If an "R" is present, numeric characters or Blanks can follow it. |
| 45 |
Payroll Frequency |
is invalid. Must be W,B,S, or M. Found '<x>'.
Payroll Frequency is how often the employee is paid. Acceptable codes are only "W," "B," "S," "M," "w," "b," "s" or "m." The <x> is the character that was found. Below is the translation of the acceptable codes:
B = Bi-weekly
M = Monthly
S = Semi-Annual
W = Weekly
|
| 50 |
Pay Cycles |
B = Payroll Frequency. Pay Cycles must be 2 or 3. Found '<x>'.
M = Payroll Frequency. Pay Cycles must be 1. Found '<x>'.
S = Payroll Frequency. Pay Cycles must be 2. Found '<x>'.
W = Payroll Frequency. Pay Cycles must be 4 or 5. Found '<x>'.
Pay Cycles is how many times the employee was paid during this reporting period. The edit is based on what the frequencey of payment is. See Payroll Frequency (above) for Code definitions. With the Bi-Weekly and Weekly there are times during the year that have more pay cycles in a month than others.
|
| 55 |
Full/Part Time Indicator |
<x> is an invalid value. Use only F, P or R.
The Full time, Part time or Retired data field (column) indicates how the employee is employed.
F = Full Time
P = Part Time
R = Retired |
| 60 |
Employment Base |
<nnn> is an invalid value. 200, 220 or 240 should be used.
The employment base is set based on how many days the employee is contracted to work.
bbb = (Blanks) Defaults to 200 as a 10-Month Empoyee
000 = (Zeroes) Defaults to 200 as a 10-Month Empoyee
200 = 10-Month Employee
220 = 11-Month Employee
240 = 12-Month Empoyee |
| 65 |
Numeric Tests |
<nnnnnnnn> Invalid character '<x>' found.
Numeric data fields (columns) cannot contain non-numeric values. The first byte of a numeric signed value can only contain: (Blank assumed positive, + positive, - negative, or 0 assumed positive). |
| 66 |
Service Days |
is an invalid value. Cannot exceed 260 days.
Service Days are reported in days earned for the reporting month. Although high, 260 has been set to prevent unreasonable amounts from being reported. |
| 70 |
Retro Multi-Yr Flag |
has an invalid '<x>' value. Must be Y, N or blank.
Multi-Year flag is to indicate that the Retroactive Pay amounts could not be properly entered into the available Retro data fields. |
| 75 |
MTD Gross Pay |
<nnnn.nn> does not = sum of other money fields (<nnnnn.nn>).
In the Employer Reporting Interface definition there are Data Description columns that have the letters "A:" through "O:" prefixing the data field (column) name. The sum of letters "B:" through "O:" is compared to the amount reported in the letter A: MTD Gross Pay. This message is caused by this formula being out of balance. The first number reported <nnnn.nn> is the MTD Gross Pay and the second (<nnnn.nn>) is the sum of letters "B:" through "O:"
(A) MTD (Month To Date) Gross Pay = (B) MTD Base Salary Pay
+ (C) MTD Instructional Pay
+ (D) MTD Summer School Pay
+ (E) MTD Holdover Pay
+ (F) MTD Partial Leave Pay
+ (G) MTD Retro Earliest Prior Yr Pay
+ (H) MTD Retro Next Prior Yr Pay
+ (I) MTD Retro Latest Prior Yr Pay
+ (J) MTD Awards Pay
+ (K) MTD Termination Pay
+ (L) MTD Non-Reg Comp Pay
+ (M) MTD Non-STRS Pay
+ (N) MTD Post-Retirement Pay
+ (O) MTD Undefined Pay |
| 80 |
Error Restriction Msgs |
Max # of LINE ERRORS (<nn>) has been detected. Total errors in line are <nn>.
During the initial data editing process the information reported is reviewed for consistency and validity. Most data fields (columns) are examined for reasonability and are reported, usually by email, when they fail these tests. However, to limit the size of any email and attempt to process as far into the data as possible, the number of errors that are reported on a single row of data has been limited. The first <nn> reported is the error limit that has been encountered and the second <nn> is the total detected on that row of data. Be sure to review the remaining contents of the row of data to see if similar errors to those listed have been made in subsequent data fields. |
| 85 |
|
Max number of FILE ERRORS (<nnn>") has been detected. File Rejected.
During the initial data editing process the information reported is reviewed for consistency and validity. Most data fields (columns) are examined for reasonability and are reported, usually by email, when they fail these tests. However, to limit the size of the email and listing of repetative errors, the number of errors that are listed for the entire file have been limited. When the Max number of FILE ERRORS is encountered the edit process is prematurely terminated. Be sure to review the remaining contents of the additional rows of data to see if similar errors to those listed have been made in subsequent rows. |
| 100 |
Old Format Messages |
Tot Reporting Period Semi-Annual Rpt Period must = 1 or 2.
The Old Format record layout is being phased out. Only Control records (Type 1) and Detail (Type 2) records are permitted in the NYSTRS data format. |
| 101 |
|
Tot Reporting Month Semi-Annual Rpt Period 2, Month must = 06.
Tot Reporting Month Semi-Annual Rpt Period 1, Month must = 12.
The Old Format record layout is being phased out. Control record Month of reporting can only be "06" or "12" which are respective to the period that is being reported. Period 1 represents the first part of the school year from 7/1 through 12/31 and it must have the month "12" used for that report period. Similarly Period 2 runs from 1/1 through 6/30 and it must be reported using month "06". |
| 102 |
|
Tot Reporting Year <xx> Semi-Annual Rpt Year must be numeric.
The Old Format record layout is being phased out. Month and year of the report are stored in the Control Record in columns 7 through 10. They must be numeric and values that are reasonable. |
| 103 |
|
Tot Employee Cnt Semi-Annual Employee Count must be numeric.
The Old Format record layout is being phased out. The control record contains the total number of detail records in the file. This value must be numeric and equal to the actual count of Detail (Type 2) records that are present in the file. |
| 104 |
|
Tot Contract Salary Semi-Annual Contract Sal must be numeric.
The Old Format record layout is being phased out. The control record contains the total of the Contract Salary in the detail records in the file. This value must be numeric and equal to the actual sum of Contract Salaries that are in the Detail (Type 2) records that are present in the file. |
| 105 |
|
Tot Salary Recvd Semi-Annual Salary Received must be numeric.
The Old Format record layout is being phased out. The control record contains the total of the Salary Received in the detail records in the file. This value must be numeric and equal to the actual sum of Salary Received that are in the Detail (Type 2) records that are present in the file. |
| 106 |
|
Tot Salary Earned Semi-Annual Salary Earned must be numeric.
The Old Format record layout is being phased out. The control record contains the total of the Salary Earned in the detail records in the file. This value must be numeric and equal to the actual sum of Salary Earned that are in the Detail (Type 2) records that are present in the file. |
| 107 |
|
Tot Contributions Semi-Annual Contributions must be numeric.
The Old Format record layout is being phased out. The control record contains the total of the Contributions in the detail records in the file. This value must be numeric and equal to the actual sum of Contributions that are in the Detail (Type 2) records that are present in the file.
|
| 110 |
|
Control Header Rec No valid header found.
The Old Format record layout is being phased out. It requires that a control record format that is identified by a "1" in column 1 of the record be the first row of data in the file. This record contains aggregate values of all of the detail, Type 2 records, in the remainder of the file. |
| 111 |
|
Record Type Unknown Record Type found in District, Only 1 or 2 is valid.
The Old Format record layout is being phased out. Only Control records (Type 1) and Detail (Type 2) records are permitted in the NYSTRS data format. |
| 112 |
|
Rpt Period Semi-Annual Period cannot change, was <x>.
The Old Format record layout is being phased out. The reporting period must remain the same throughout the entire file. |
| 120 |
|
Contract Salary <nnnnnnn> Contract Salary must be numeric.
The Old Format record layout is being phased out. The Detail (Type 2) records contain Contract Salary for each individual reported in the file. This value must be numeric. The <nnnnnnn> represents what was found. |
| 125 |
|
Tot Annual Salary Sum is not Equal to Control Record value.
The Old Format record layout is being phased out. The control record contains the total of the Contributions in the detail records in the file. This value must be numeric and equal to the actual sum of Annual Salaries that are in the Detail (Type 2) records that are present in the file. |
| 130 |
|
Control Rec (type 1) Semi-Annual format requires Control Record as First record.
See explanation under reference #110. |