You are using an unsupported browser. Please update your browser to the latest version on or before July 31, 2020.
close
Home > moovs > How to configure a moov > How to configure a Transamerica moov
How to configure a Transamerica moov
print icon

This article describes how to configure a client for the Standard 401k to Transamerica moov definition.  Each client configuration will vary based on their plan specification and will need to be configured accordingly.

 

If you have not already done so, please add the Standard 401k to Transamerica moov to your account by following these steps.

 

 

 

Create a Variable for the file name

 

Transamerica requires your payroll company name to be included in the header row and file name of the file sent to them.  To ensure this is set up correctly you will need to create a detamoov variable for your company name.

 

First, click on your initials in the upper right of the app and select the Admin Console option. 

 

Click on the Setting tab, expand the Variables section and click the Add button.

 

Enter the value 'Company Name' in the Name field and the name of your payroll company in the Value field.

 

Note: Make sure the value in the name field is exactly 'Company Name' as it appears in the image below.

 

Once the Standard 401k to Transamerica moov has been added to your account, access the moovs section on the left side menu and click on the Standard 401k to Transamerica moov.

 

Notification Settings

 

The Standard 401k to Transamerica moov provides a notification for when the moov is complete.  The notification can be sent to any email address you wish and can also be configured to sent to multiple email addresses. 

 

To edit the notification step, click on the cog icon under the Action - Notify step on the left.  Then toggle the "Use default parameters" off and enter in the email addresses you would like to receive the notification.  If you would like to enter multiple email addresses, separate them with a comma.  A Reply to email is also required in the event that a recipient of the notification replies to the email.

Note: these settings apply to any client configuration you set up for this specific moov.  You also have the ability to configure the notification step for each client configuration if you wish to add or remove email addresses per client.

 

To save your parameters click on the Save Changes button.

 

Configure a client

 

In the moov configuration section, click the Add button to add a new client to send retirement data to Transamerica.

 

Complete the ID and source

 

Client/Entity - either select an existing client or click the + sign to create a new client. 

Status - the status field is important when configuring a new integration with Transamerica as it provides the correct file name sent to Transamerica while in their testing phase.  This field should be set to 'Testing' until the testing phase has been completed.

Expected Frequency - the client's payroll frequency

File Name Starts With - typically the client or company code within your payroll platform.  The value entered into this field is important as the file you send to detamoov must start with this value.

File Name Contains - optional value that is included in the file name

 

Header/Footer Row Overrides

 

Transamerica requires that the Plan ID be included in the header row of the file.  If you do not store the Plan ID in payroll then you will need to add an override for the Contract ID field in the header row.

 

To add a header row override, locate the Action - Header/Footer Rows step and toggle the 'Use default parameters' off, then click the Row index: 1under the Header Rows section to expand the header row. 

 

Then on the Contract ID (edit) component, change the Row Component Type to Text and enter in the client's plan ID in the Text field.

 

Transamerica also requires that the Deposit Method, ACH Number and Mode be configured for each client.

 

The Deposit Method field is dependent on the Transamerica auto approval feature which bypasses manual approval.  If this is the case for your client's plan, enter in the following for the Deposit Method field:

 

Wire = 0

ACH = 1

 

The ACH Number is dependent on the Deposit Method field.  If the Deposit Method field is set to 1, then enter in the ACH account number in the ACH Number field.  If the Deposit Method field is 0, leave the ACH Number field blank.

 

The Mode field identifies if the plan is in test or production mode.  If the plan is in test mode, leave the value of 'VALIDATE' in the Mode field.  If the plan is in production mode, remove the value in Mode field.

 

The example below shows a plan that has a Deposit Method of ACH, provides the ACH account number, and sets the plan to production mode.

 

NOTE: The ACHNumber field must contain the Routing Number + the Bank Account Number (no space between):

 

 

File Name Overrides

 

Transamerica requires that the Plan ID be included in file name.  If you do not store the Plan ID in payroll then you will need to add an override for the Plan ID in the file name.

 

To add a file name override, locate the Action -Name File step and toggle the 'Use default parameters' off. Then on the Plan ID Custom Field, change the Naming Component Type to Text and enter in the client's plan ID in the Text field.

 

Transamerica uses different file names for testing and production mode.  To ensure that the file is set up correctly, you will need to provide the same override for the testing file name section.

 

Notification step overrides

 

At the beginning of this article you configured the notification step for the moov to send a notification once the moov had completed.  You also have the ability to configure the notification step for each client configuration if you wish to add or remove email addresses per client. 


To override the notification step, locate the Action - Notify step and toggle the "Use default parameters" off and enter/remove email addresses from Email Address and Reply To fields. If you would like to enter multiple email addresses, separate them with a comma.

 

To complete the configuration for your client, click the Next button at the bottom of the page and then the Save button on the moov summary page.

scroll to top icon