Voluntary Credits and Deductions Program Guide

Credits and Deductions Rejections File

Voluntary Credits and Deductions Program Guide

NYSLRS may send a Credits and Deductions Rejections file to you after processing your Text file. This outbound file contains any transactions from your Text file that were rejected by NYSLRS. Please note that this file is only sent if there are rejections. Detailed rejection reasons will be identified within the file (see the table below for a list of reasons).

This is a pipe-delimited Text file (*.txt) and has the following naming convention:

NYSLRS_<VENDOR ID>_CRDEDREJECT_YYYYMMDDHHMMSS.txt

The first row of the Credit and Deduction Rejections File contains your first rejected transaction. There are no headers or footers.

Complete Example:

R12345678|123456789|John Doe|ERS|A|027|100.00|1000.00|02/01/2022|02/01/2024|Payment Suspended|1000.00

 


The table below provides details about the type of information the file contains:

  • Field Name: Denotes what information will be provided.
  • Is This Field Required?: Indicates when a field must have a valid entry in it.
    • Required: There will always be information populated in this field.
    • Optional: This field may be left blank if it is not applicable.
  • Field Values: Describes the various values that are allowed in this field.
  • Example: Provides an example of an allowable value that would be entered into the field.
  • Additional Details: Provides additional information for the corresponding field.
Field Name Is This Field Required? Field Values Example Additional Details
NYSLRS ID REQUIRED R######## R12345678 Unique identifier assigned to the retiree by NYSLRS. NYSLRS ID is an alphanumeric character string that begins with an R and is followed by eight numbers.
Social Security Number REQUIRED ######### 123456789 The retiree’s complete nine-digit Social Security number. (without hyphens or spaces).
Name REQUIRED N/A John Doe The retiree’s first and last name, in that order.
Retirement System OPTIONAL - ERS

- PFRS
ERS The retirement system (Employees’ Retirement System [ERS] or Police and Fire Retirement System [PFRS]) from which the credit/deduction should be applied against.
Data Processing REQUIRED - A

- U

- T
A The type of transaction:
  • A = Add
  • U = Update
  • T = Terminate
Code Type REQUIRED - ###

- ####
027 The unique identifier assigned to each organization's deduction type(s). Code types vary by organization and are either three or four digits.

Please refer to the ‘Code Types’ that were sent to you separately.
Amount REQUIRED ########.## 100.00 The amount of the deduction that was requested to be taken.
Goal Amount OPTIONAL ########.## 1000.00 The maximum "not to exceed" amount of the deduction that was requested.

For example, if the goal amount is $1,000 and the monthly deduction amount is $50, then we will automatically stop the deduction after 20 months.
Begin Date REQUIRED MM/DD/YYYY 02/01/2022 The date the deduction should begin, entered in the format of MM/DD/YYYY.
End Date OPTIONAL MM/DD/YYYY 02/01/2024 The date the deduction should end, entered in the format of MM/DD/YYYY.
Reject Reason REQUIRED

- Format incorrect: <Field Name>

- Required field missing: <Field Name>

- Invalid Data Processing (Data Processing field did not contain an ‘A’, ‘U’ or ‘T’)

- Vendor ID/Code Type mismatch

- NYSLRS ID/SSN mismatch

- NYSLRS ID/Retirement System mismatch

- Payee is deceased

- Payment(s) are terminated

- Payment(s) are suspended

- No monthly payments exist

- Record does not exist to update

- Deduction exceeds previous month’s net pay

- Goal Amount less than or equal to the Current Goal Balance

Deduction Rejected Reason why the requested deduction was rejected.

 

Net Pension Amount REQUIRED ########.## 1000.00 The retiree's net pension amount that is available for deduction.