| Serving New York Educators Since 1921 |

Introduction | Rejected File Error Messages | Table of Contents
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).
The following is a list of error messages sent with rejected file e-mails.
| 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. 2) Not a valid data line – record type invalid. 3) is not a valid data line – record type must be 1 or
2. |
| 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>. + (C) MTD Instructional Pay |
| 04 | Control Rec Errors | 1) No valid header found; File rejected for District =
<xxxx>. 2) Multiple Control headers found. |
| 05 | District Level Errors | 1) <xxxx> Non-numeric district number found. 2) <xxxx> District number is NOT an Active District. 3) <xxxx> District number IS NOT VALID. 4) <xxxx> District number is not the same as the District-In Folder
[<xxxx>]. |
| 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. 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>. |
| 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. |
|
| 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. |
| 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>'. |
| 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>'. |
| 55 | Full/Part Time Indicator | <x> is an invalid value. Use only F, P or R. |
| 60 | Employment Base | <nnn> is an invalid value. 200, 220 or 240 should be
used. 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 |
| 80 | Error Restriction Msgs | Max # of LINE ERRORS (<nn>) has been detected. Total errors in line
are <nn>. |
| 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. |
|
| 107 | Tot Contributions Semi-Annual Contributions must be numeric. |
|
| 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. |