Paylocity – Vestwell Help Center

Since our platform has an integration with your payroll provider, we can take a lot of work off your plate regarding the processing of your payroll files through automation.

This guide will help you set up your integration and understand your specific responsibilities for the proper administration of payroll files.

  1. Determine Your Integration Type
  2. Initiate Your Integration Setup
  3. Are There Any Reasons Why My Plan Might Not Be Eligible for an Integration?
  4. What Are My Responsibilities If My Plan Has an Active Payroll Integration?
  5. What Do You Handle for Me If My Plan Has an Active Payroll Integration?
  6. Will My Payroll Provider Charge Me Fees to Set Up and/or Maintain My Payroll Integration?
  7. How Do I Disconnect My Integration?

Determine Your Integration Type

There are two possible integration types. Your eligibility depends on your prior relationship with us and your payroll setup.

API – How to Initiate Your Integration Setup (for Prior Accrue Clients)

Note: This integration will not support multiple EINs.

To initiate your integration:

  1. Log in to your employer portal.
  2. Navigate to the "Contributions" page.
  3. Click the gear icon.
  4. Click the Connect to Paylocity button.
  5. You will be redirected to Paylocity’s app marketplace.
  6. Search for the “Vestwell 2.0” app.
  7. Click Begin Integration and follow the steps to authorize your connection.
  8. You will be redirected to your portal once authorization completes.
    • If your plan has multiple pay groups, you must add a pay schedule name to identify each pay group.
  9. Lastly, set up any employer contribution codes and formulas.

Please do not run payroll until you see Vestwell Integration retirement deduction codes. These will appear 4 business days before your first payroll with us. You can locate the codes in Paylocity by following the instructions below:

  1. Log in to Paylocity.
  2. Navigate to "People Search."
  3. Navigate to the employee.
  4. Select Pay.
  5. Select Pay Setup.
  6. Look for the below codes:
    • 401K
    • ROTH
  7. If your plan allows, loans will also be set up within Paylocity through the integration.

Note: If you have existing Pretax or Roth codes in Paylocity, they will be deactivated. Any existing IRA codes must be deactivated by you, the employer.

File-Based Integration – How to Initiate Your Integration Setup

  1. In your Paylocity portal, Navigate to "HR & Payroll" and then "Marketplace."
  2. Search for “Vestwell” in the name field.
  3. Click Begin Integration to access, complete, and sign the integration form.
  4. View the alert window. Any important information and fees will be reflected here. If you wish to proceed, select “Acknowledge associated fees for this service” and continue.
  5. Enter the following information. Note: You must complete the following information exactly as follows, or your request will be rejected by Paylocity, and your integration will be delayed.
    • Client Information: Complete ALL fields
    • Vendor Name: Vestwell
    • Plan ID(s)/Policy Numbers(s): Paylocity company ID (this is your Paylocity company code and NOT your retirement plan number)
    • Vendor Contact Name: Ashley Lettieri
    • Effective Date: Anticipated first payroll date
    • Vendor Contact Email: payrollintegrations@vestwell.com
    • Vendor Contact Phone: (917) 979-5358
    • TPA Information: Leave all fields blank; even if you are working with a TPA, please leave this section blank
    • Broker/Advisor Information: Leave all fields blank; even if you are working with an advisor, please leave this section blank
  6. Select the Electronic Records and Signature Disclosure link to read the disclosure. If you are ready, proceed to submit.
  7. Sign the document and click Finish to submit the request to Paylocity. You will see the notification that your request has been successfully submitted and a reference number.
  8. Your Paylocity representative will reach out to assist you with deduction code set up. If you have created and are using custom deduction codes with your Paylocity Account Manager, please communicate these to the Paylocity team during integration setup. This includes the set up of any loans.

If you have recently switched payroll providers to Paylocity and your first payroll run with Paylocity is also your first payroll with us, your integration will not be active for the first payroll date. You may be required to manually input your deferral rates in your Paylocity system and submit your first payroll manually to us. For more information, please reach out to your representative.

Note: Until the integration is activated, contribution uploads into the portal will be required until our team has notified you that the integration can begin.

Are There Any Reasons Why My Plan Might Not Be Eligible for an Integration?

There are some plan design features that currently prohibit the use of payroll integration, including:

What Are My Responsibilities?

Our ability to successfully process your payroll files and administer your plan depends on you! It is your responsibility to manage:

What Do You Handle for Me If My Plan Has an Active Payroll Integration?

Will Paylocity Charge Me Fees to Set Up and/or Maintain My Payroll Integration?

Your payroll provider may charge fees in conjunction with the integration. Please check with your Paylocity representative for more specific details. We will not charge you to facilitate this integration.

What If I Amend My Plan?

If your plan has been amended or if you are considering an amendment to your original plan documents, you are responsible for informing your payroll provider of the updates.

How Do I Disconnect My Integration?

If you change payroll providers, it is your responsibility to inform us so that we can disconnect your integration and assess whether integration with a different payroll provider is available. Please reach out to your representative, and we will assist you.