When you need to process a negative deduction or update previously processed contributions, you’ll need to upload a Contribution Correction file through your Admin Dashboard. This ensures clean and accurate data across payroll and employee benefit balances.
Why is this important?
Negative deductions are not automatically processed in Benepass. This safeguard is in place to prevent unintended changes to employee balances and benefits.
If your payroll system sends a negative deduction (for example, due to retroactive changes or over-contributions), that data will not automatically impact employee accounts.
To correct this, you’ll need to upload a corresponding Contribution Correction file so the change is applied accurately.
You should also use this process if you need to adjust contribution amounts that don’t have a matching negative deduction. This ensures the cleanest data and best employee experience.
Note: If your payroll system generates negative deductions automatically, please follow the steps below and notify Benepass Admin Support at [email protected] on or shortly after the scheduled payday.
How to upload a Contribution Correction file
Go to the Uploads tab in your Admin Dashboard.
Select “Contribution correction” as the upload type.
Download and complete the Contribution Correction file template (attached to this article).
This template helps us identify the exact contribution to be updated and the corrected amount.
Gather the data you’ll need.
Use the Contributions and expirations report in your Admin Dashboard to find the affected contributions:
Filter by the specific employee
Filter by the affected benefit(s)
Identify the contributions that need to be corrected
Locate the Contribution Internal Object ID.
This ID appears in the Contributions report under the Internal Object ID column.
It will begin with
contrib_.Include only contribution IDs in the file (do not mix deduction and contribution IDs).
In the contribution correction file upload:
Column A should match the employee’s email address as it appears in the Benepass system
Column B should include the contribution ID of the contribution you wish to reverse.
Column C should include the amount that was originally contributed
Column D should include what the new amount should be
You will then upload this to the admin dashboard as a "Contribution correction":
Once submitted, our engineering team will process the update(s) within two weeks.
