Process
- Files uploaded to the /pretax/elections folder will be processed within 1-2 hours.
- The pre-tax demographics file is always processed first. Followed by pre-tax elections files then pre-tax contributions files. Subsequent files will be processed one hour after its predecessor (ex: the pre-tax elections file will process one hour after the demographics file has processed)
- Employees are not terminated by omission, so any record simply omitted from the elections file will remain active. To terminate a record, update the “Account Status” column and send an elections file with updated information to terminate an active pre-tax account.
- If individual rows contain errors, the file will continue processing the remaining valid records.
- Rows with warnings are still processed. Rows with errors are not processed, created, or updated.
- You will receive automatic notifications when a file is processed, with or without errors or warnings. See Pre-tax file processing notification for more information.
- You can also visit Forma Admin to monitor the processing status of any pre-tax file. See Forma Admin File Manager Guide for more information.
Troubleshooting
Follow the instructions below to fix any errors, then upload a new elections file with only the records that were errored out, or reload the entire file after the fields with errors have been corrected.
Elections File Errors
| Error Code | Error Message | More info |
| EN001 |
Error: Missing required field: [Errored Field] Required columns are not provided |
The file must include all required fields outlined here. All records will be errored out if an entire column is missing. |
| EN001 |
Error: Missing required field: [Errored Field] Header values are blank or invalid |
Header names must match the standard header name. For example
All records will be errored out when the file is processed if a header name is invalid. |
| EN001 |
Error: Missing required field [errored field] Data is missing in a required column |
Ensure that the required data is provided for each record in every mandatory column. |
| EN002 | Error: Invalid Account Type format | Account Type can be FSA, LPFSA, DCFSA, HSA, Transit, Parking, Transit_PT, Parking_PT, or any alternative values listed in Appendix 2. |
| EN002 | Error: Invalid Account Status format | Account Status can be Active, Temporarily Inactive, Terminated or any alternative values listed in Appendix 2. |
| EN002 | Error: Invalid Election Amount Format |
Employee's account election amount must be in numeric format. Follow Appendix 2 > Number (float) for more information. |
| EN002 | Error: Invalid Date format |
Use YYYYMMDD or MMDDYYYY date format for "Account Start Date" and "Account End Date" Follow Appendix 2 > Date for more information. |
| EN002 | Error: QLE Type format is invalid |
Use only valid QLE Types. Follow Appendix 6 for more information. |
| EN002 | Error: Invalid QLE Change format | Use the Boolean values TRUE or FALSE in the "QLE Change" field |
| EN002 | Error: Invalid Coverage Tier Format |
Use the correct "Coverage Tier" for HSA and DCFSA. If individual coverage tier use Individual, Single, or Separately If family coverage tier, use Family or Jointly The "Coverage Tier" field should be blank for FSA, LPFSA, Parking, Transit, Parking_PT, Transit_PT |
| EN004 | Error: Record type value is incorrect | Use EN as record type for elections files. |
| EN010 | Error: Employee is not found |
Could not locate employee record by Employee ID and Employee Work Email For more information about this error, refer to the following articles: |
| EN014 | Error: Employee is not eligible to enroll in HSA |
Employee must be enrolled in a High Deductible Health Plan (HDHP) to elect HSA. For more information about this error, refer to the article Pre-tax Elections File Error EN014. |
| EN015 | Error: The employee is no longer eligible for pre-tax benefits; therefore, election-related data can no longer be updated. | The employee is no longer eligible for pre-tax benefits and election-related information can no longer be updated once eligibility has ended. As a result, the employee must be in an active status to enroll in pre-tax benefits. |
| EN016 | Error: Employee is not eligible to enroll in Parking or Transit |
Employee must be eligible for commuter to enroll in Parking or Transit benefits. For more information about this error, refer to the article Pre-tax Elections File Error EN016. |
| EN017 | Error: Employee cannot enroll in both FSA and LPFSA at the same time |
Employees can only elect FSA or LPFSA. Enrolling in both at the same time is not allowed. For more information about this error, refer to the article Pre-tax Elections File Error EN017 |
| EN019 | Error: Employee's SSN is missing for HSA enrollment |
SSN is required for HSA enrollees to complete the bank application process. The HSA election record will error out if SSN has never been provided to Forma for a given record. You will not receive a pre-tax demographics file error if SSN is not provided. Provide the SSN in the next pre-tax demographics file, then reload the elections file to create the HSA account. |
| EN020 | Error: Plan not found |
For DCFSA, FSA, LPFSA, the Plan Year is required. Please check that you are using a valid account type format. For HSA, Parking, Transit, the Plan Year should be blank. |
| EN020 | Plan Start Date and Plan End Date do not match the plan setting in the system |
Plan Start Date and Plan End Date are set at the company level. Account Start Date is set at the individual record level and should not be used interchangeably. For DCFSA, FSA, and LPFSA, the dates entered in "Plan Start Date" and "Plan End Date" fields must match the plan settings. For HSA, Parking, and Transit, the date in the "Plan Start Date" field must match the system, and the date in the "Plan End Date" field should be left blank. For more information about this error, refer to the article Pre-tax Elections File Error EN020. |
| EN022 | Error: Duplicate enrollment cannot be processed | Could not process duplicate pre-tax benefit enrollments. Please include one "Account Type" per employee. |
| EN027 | Error: HSA Account Status cannot be set to Temporarily Inactive | Use Active or Terminated in "Account Status" field for HSA. Temporarily Inactive us an invalid value. |
| EN029 | Error: Amount in Employee Election and Employer Election cannot be less than $0 | The election amounts cannot be less than $0 |
| EN033 | Error: Employee Annual Election Amount is missing | Annual election amount for HSA, DCFSA, FSA. and LPFSA is required. |
| EN034 | Error: Employee Election amount cannot be less than employee's contributions year to date | Could not process the election because it is less than the employee's contributions year-to-date. |
| EN035 | Error: Combined Employee Election and Employer Election amounts cannot be less than employee's spending year to date |
Could not process the election because the combined election amount is less than the employee's spending year-to-date. For more information about this error, refer to the article Pre-tax Elections File Error EN035. |
| EN036 | Error: Combined amount of Employee Election and Employer Election cannot exceed the plan maximum or IRS limit |
Could not process this election because the combined election amount exceeds the plan maximum or IRS limit. For more information about this error, refer to the article Pre-tax elections file errors: EN036, EN037, EN040, EN041 |
| EN037 | Error: Combined Employer and Employee Election amounts can't be below plan minimum. | For more information about this error, refer to the article Pre-tax elections file errors: EN036, EN037, EN040, EN041 |
| EN039 | Error: Employer Election amount cannot be less than employer's contributions year to date | Could not process this election because the employer election amount is less than employer's contribution year-to-date. |
| EN040 | Error: Combined Employer and Employee Election amounts can't exceed plan maximum. | For more information about this error, refer to the article Pre-tax elections file errors: EN036, EN037, EN040, EN041 |
| EN041 | Error: Combined amount of Employee Pay Period and Employer Pay Period Election in a year cannot be less than the plan minimum |
Could not process this election because the combined "Employee Pay Period Election" and "Employer Pay Period Election" is less than your plan minimum. For more information about this error, refer to the article Pre-tax elections file errors: EN036, EN037, EN040, EN041 |
| EN044 | Error: Account Start Date cannot be after Plan End Date |
Could not process this election because "Account Start Date" is after "Plan End Date." Employees are only eligible for accounts during the current plan year. Please note that Plan Start Date and Plan End Date are set at the company level. Account Start Date is set at the individual level and should not be used interchangeably. For more information about this error, refer to the article Invalid account start date: Pre-tax Elections File Errors EN044, EN045, EN046, EN047, EN053 |
| EN045 | Error: Account Start Date cannot be before Plan Start Date |
Could not process this election because "Account Start Date" is before "Plan Start Date." Employees are only eligible for accounts during the current plan year. For more information about this error, refer to the article Invalid account start date: Pre-tax Elections File Errors EN044, EN045, EN046, EN047, EN053 |
| EN046 | Error: Account Start Date cannot be after Account End Date |
Could not process this election because "Account Start Date" is after "Account End Date" For more information about this error, refer to the article Invalid account start date: Pre-tax Elections File Errors EN044, EN045, EN046, EN047, EN053 |
| EN047 | Error: Account Start Date cannot be before employee's Hire Date |
Could not process this election because "Account Start Date" is before "Hire Date." Accounts can only start on or after "Hire Date" For more information about this error, refer to the article Invalid account start date: Pre-tax Elections File Errors EN044, EN045, EN046, EN047, EN053 |
| EN049 | Error: A terminated account cannot have a Start Date in the future |
Could not process this election because a terminated account cannot have a future start date. For more information about this error, refer to the article Pre-tax Elections File Error EN049. |
| EN051 | Error: Account End Date cannot be after Plan End Date |
Could not process this election because "Account End Date" is after "Plan End Date." For more information about this error, refer to the article Invalid account end date: Pre-tax Elections File Errors EN051, EN052. |
| EN052 | Error: Account End Date cannot after Plan Start Date |
Employee's "Account End Date" must be after "Plan Start Date." For more information about this error, refer to the article Invalid account end date: Pre-tax Elections File Errors EN051, EN052. |
| EN053 | Error: Account Start Date cannot be after employee's Termination Date |
Could not process this election because "Account Start Date" is after employee's "Termination Date." For more information about this error, refer to the article Invalid account start date: Pre-tax Elections File Errors EN044, EN045, EN046, EN047, EN053 |
| EN055 | Error: Employee cannot change election amount without a Qualifying Life Event (QLE) during mid-year | Once open enrollment ends, employees cannot change their election unless they have a Qualifying Life Event (QLE). |
| EN057 | Error: Employee's Qualifying Life Event (QLE) start date cannot be before the original Account Start Date | When you send an election for employee's Qualifying Life Event (QLE), fill in the first date of employee's qualifying life event in "Account Start Date" field and it must be after the original "Account Start Date." |
| EN058 | Error: A Qualifying Life Event (QLE) is already recorded |
We could not process this election because a Qualifying Life Event (QLE) is already recorded. This employee's QLE was sent in the election file previously. For more information about this error, refer to the article Pre-tax Elections File Error EN058. |
| EN060 | Error: Multiple Qualifying Life Events (QLE) are found | We could not process multiple Qualifying Life Events (QLE) for one employee. |
| EN061 | Error: Phone is missing for HSA enrollment |
Phone Number is required for HSA enrollees to complete the bank application process. The HSA election record will error out if Phone Number has never been provided to Forma for a given record. You will not receive a pre-tax demographics file error if the "Phone Number" field is blank. Provide the phone number in the next pre-tax demographics file, then reload the elections file to create the HSA account. |
Elections File Warnings
| Warning Code | Warning Message | More info |
| EN105 | Warning: Combined amount of Employee Election and Employer Election may exceed the plan maximum or IRS limit |
"Employee Election" and "Employer Election" values are processed. However, the combined election amount is rounded down to comply with the plan maximum or IRS limit, as the total of the Employee and Employer Elections may otherwise exceed these limits. For more information about this warning, refer to the article Pre-tax Elections File Warning EN105. |
| EN107 | Warning: A Qualifying Life Event (QLE) is required when Employee Election is changed in mid-year |
The "Employee Election" field is updated without a Qualifying Life Event (QLE). An election should only be changed mid-year if there is a QLE. If an employee changes their Employee Election after the open enrollment period, set the employee’s "QLE Change" field to TRUE in the elections file to prevent this warning message. If this employee does not have a QLE and should not update the Employee Election, send employee's correct elections to ensure data accuracy. For more information about this warning, refer to the article Pre-tax Elections File Warning EN107. |
| EN108 | Warning: A Qualifying Life Event (QLE) is required when Employer Election is changed in mid-year |
"Employer Election" field is updated without a Qualifying Life Event (QLE). Please note that "Employer Election" field should only be changed mid-year if the employee experiences a Qualifying Life Event (QLE). If the "Employer Election" is changed after the open enrollment period, please set the employee’s "QLE Change" field to TRUE in the elections file to prevent this warning message. If this employee does not have a QLE and the "Employer Election" field should not be updated, send the correct elections to ensure data accuracy. For more information about this warning, refer to the article Pre-tax Elections File Warning EN108. |
| EN109 | Warning: A Qualifying Life Event (QLE) is required when Account Start Date is changed in mid-year |
"Account Start Date" is updated without a Qualifying Life Event (QLE). Please note that the "Account Start Date" field can only be changed mid-year if employee experiences a Qualifying Life Event (QLE). Going forward, if an employee changes their Employee Election or Employer Election after the open enrollment period, please set the employee’s "QLE Change" field to TRUE in the elections file to prevent this warning message. If this employee does not have a QLE and should not update the Employee Election, send employee's correct elections to ensure data accuracy. |
| EN110 | Warning: No election record for plan type |
Elections file does not contain all configured account types. Please include all Account Types in your elections file. For example, if you configured HSA, DCFSA, LPFSA, FSA, Transit, Parking this year, please include every account type in your elections file. |
| EN203 | Warning: An active employee should not have a terminated account |
The account is terminated but the employee is still active in the system. For more information about this warning, refer to the article Pre-tax Elections File Warning EN203. |