Folks Help Center
Maximize your experience with Folks through our detailed documentation.
Payroll
Getting Started & useful Information
Introduction to Folks Payroll Implementation
Folks offers an integrated payroll management solution for comprehensive HR centralization.
Manage all your HR processes on a single platform, save time on every payroll and every stage of an employee’s life cycle, and retrieve your information in just a few clicks, at any time.
Features and benefits
The payroll module is designed to make your life easier. Intuitive, seamless, and fully integrated, it transforms payroll management into a hassle-free process.
- One-click data synchronization and automated payroll calculations
- Automated pay statements, via secure emails and added directly to the employee profile
- Payroll analysis reports for a global view of your workforce
Implementation
Migrating to Folks Payroll is part of a structured customer journey designed to ensure a secure transition, efficient onboarding, and a fully operational payroll from the go-live date.
This section provides an overview of the journey, including key steps, responsibilities, and requirements for a successful migration.
Payroll Customer Journey
The Folks Payroll customer journey follows a structured sequence:
- Kickoff: project scoping, access, and planning
- Configuration: company setup and payroll rules
- Validation: payroll testing and results verification
- Go-live: first official payroll run
- Post-implementation: support and stabilization
The goal is to achieve a stable, repeatable payroll process that meets all legal obligations.
Transitioning from Another System
Migrating from an existing provider follows a specific sequence:
- Run the final payroll in the previous system
- Export year-to-date (YTD) cumulative data and payroll reports
- Import data into Folks Payroll
- Validate the imported data
- Run payroll tests (parallel payroll)
Important:
- YTD data must be accurate to ensure correct tax slips (T4, Relevé 1)
- Records of Employment (ROEs) must be completed in the previous system if required
- Do not cancel your previous provider before full validation is complete
This step is critical to avoid compliance errors or payroll discrepancies.
Roles and Responsibilities
Folks' Role
- Frame the project and structure the steps
- Support configuration
- Assist with testing and validation
- Train users
Client's Role
- Provide data and information
- Validate results
- Perform payroll tests
- Operate payroll after go-live
Important: Folks acts as a support and guidance resource, but the client remains responsible for their data and its validation.
Required Data
- Complete employee list (active, inactive, terminated)
- Up-to-date employee records
- Year-to-date (YTD) cumulative data
- Banking information
- Vacation percentages
- Province of hire
Incomplete or inaccurate data may delay the go-live date.
Validation and Go-Live
Before go-live:
- Validate payroll tests
- Correct any anomalies (CNESST, exceptions)
- Confirm cumulative data
Après validation :
- Authorize go-live
- Submit the first payroll run
- Validate remittances (CRA and Revenu Québec)
Important: Ensure your previous provider does not produce T4s and Relevés 1 after the migration.
Required Configurations for Time Import
In this article, we will guide you through the various configurations required for importing time into Folks Payroll.
- Creating Payroll Items
- Configuring Payroll Codes
- Time Import File Format
- Frequently Asked Question: Who Calculates What?
Enabling the feature
Time import is not available by default. Contact us to enable it.
Creating Payroll Items
If you have not already done so, go to the business settings to create your payroll items.
Payroll items are the building blocks of payroll: every earning paid to an employee goes through a payroll item that determines how it is processed, accounted for, and reported to tax authorities.
- In Folks, go to Payroll > Dashboard > ☰ > Business Settings > Payroll Items.
- Click on Create Preset.
-
In the window that opens, give the preset a name and select the type Earning and the sub-type. The type/sub-type pair determines how the earning is processed in payroll.
For example, the calculation of overtime with its multiplier, or the specific tax treatment of a payment to a self-employed worker (box 48 on the T4A). A misclassified item will produce a valid payroll but one that is fiscally incorrect. For self-employed workers, only the type Earning with the subtype Invoice Payment is accepted. - If a value is set for a field on this preset, it will be synced from the preset to line items created from the preset, and that field will not be editable on those line items.
- Click Create.
You can modify your payroll items as needed.
If you have multiple registration numbers, be sure to create your payroll items for each company. A dropdown menu allows you to select the desired company. Simply go to the payroll items for each company.
Configuring Pay Codes
When you use an external time system, that system identifies each type of earning by its own code (example: “REG” for regular hours). Folks needs to learn what each one means. Configuring pay codes creates the link between the codes in your import file and the presets that determine how each earning will be processed.
This configuration is done once and reused for every import. If you change your time system or add new earning types, simply update the mapping.
Go to Dashboard > gear icon (Configuration) > Presets tab. There you will find the list of your available presets. For each preset of type Earning, a field allows you to enter the pay code dedicated to import: this is the code expected in column E of the CSV file.
Time Import File Format
This section describes the expected CSV file format at step 1 of time import (File import). The file is based on a universal format, allowing most external time systems to generate it without special development.
An explanatory template of the file is available. Only 6 columns are read by the system. All others must be present but empty. Any value entered in an unsupported column will be ignored.
The file must be separated by semicolons. A comma-separated file is not rejected at step 1, but all its lines will return errors at step 2 (Data validation).
| Column | Field | Required | Description |
|---|---|---|---|
| B | Employee Number | Yes | Unique Folks employee identifier (max 20 characters) |
| D | Type | Yes | Only accepted value: G (earning) |
| E | Code | Yes | Earning code, associated with a preset (max 100 characters) |
| F | Quantity | Conditional | Read for codes associated with presets corresponding to amounts; format 5.2 (max #####.##) |
| H | Amount | Conditional | Read for codes associated with presets corresponding to hours; format 7.2 (max #######.##) |
| N | Date | Yes | Transaction date, format YYYY-MM-DD, within the current pay period |
The column read depends on the payroll code:
|
Amount column for:
|
Quantity column for:
|
If both columns are filled on the same line, only the column corresponding to the code is read — the other is ignored without generating an error. This allows importing both hours and amounts (e.g., expense reimbursements).
Here is an example of a valid line:
;21;;G;1;35.00;;;;;;;;2009-01-10;;;;;;;;;;;;;;;;;;;;;;;Employee 21, earning code 1, quantity 35.00 hours, date 2009-01-10.
Frequently Asked Question: Who Calculates What?
The answer has two parts. Folks calculates time: hours imported on overtime codes are paid according to their multiplier (x1.0, x1.5, x2.0). Regarding dollar amounts, any earning expressed in dollars must already be calculated in the file.
Overtime: the source system knows which hours are at straight time, time and a half, or double time. Folks then applies the code multiplier: 4 hours imported on OT 1.5 are paid at 1.5 times the rate.
Holidays: the number of holiday hours is determined on your side and imported as quantity on the code associated with the Holiday preset.
Create a Company for Folks Payroll
One of the essential steps when integrating Folks Payroll is to create your company in the dashboard. Without this setup, other settings cannot be configured. Please follow the steps below to complete this successfully.
- From the left menu, navigate to Payroll > Dashboard. On this page, click on the square containing 3 horizontal lines (☰) at the top left.
- In the menu that opens, click on Business Settings and then on the Details tab.
- Under the Details tab, fill in the information for the Business Info and Contact Info sections. Click on save.
The other configurations will then be accessible via the various company settings tabs.
How to Synchronize Employee Profiles for Payroll
This guide will walk you through the process of synchronizing employee profiles effectively for payroll purposes. A dedicated page is available for managing the synchronization of employee information related to payroll.
This page is accessible through: Folks HR > Payroll > Synchronisation
Sync Page Functionalities
- Decide who is included or excluded from your pay cycle.
- Sync employees.
- Validate all employee files for completeness before transferring to compensation.
Steps to Synchronize Employee Profiles
Access the Synchronization Page:
In the main menu under Payroll, click on Synchronization.
Include a Terminated Employee:
Search for the employee you wish to include.
Use the toggle to include the selected employee in the pay cycle.
Exclude an Employee:
Search for the employee you wish to exclude.
Exclude the employee by selecting the desired date of exclusion.
Review Employee Inclusion/Exclusion:
Easily view who is included or excluded in payroll for your current cycle.
Synchronize Employee List:
Once your employee selection is final, click on Sync Employees.
Select Validate and Synchronize to initiate the synchronization process.
Validate Employee Records:
The sync process will validate your employee records and highlight any errors.
Select the Correct button to apply the necessary corrections.
Continue correcting errors until no more payroll errors are detected.
Finalize Synchronization:
Click on Synchronize to complete the process. All of your employees are now included in the current pay cycle.
Information Validation Rules for Data Transfer to Folks Payroll
This page provides a concise overview of the validation rules applied to company information and employee profile data when integrating with Folks payroll.
These validations ensure that all transmitted data is complete, consistent, and compliant with the requirements of the payroll system. The tables below outline the constraints and mandatory fields for each data category.
Company Information
| Field | Validation Rules | Required |
|---|---|---|
Name | Maximum 255 characters | Yes |
Address Line 1 | Maximum 30 characters | No |
Address Line 2 | Maximum 30 characters | No |
City | Maximum 28 characters | No |
Postal Code | Maximum 10 characters | No |
Contact Name | Maximum 255 characters | No |
Contact Phone | Maximum 11 digits | No |
Firm Number | Maximum 15 characters | No |
Province | Canadian provinces only | No |
Country | Canada only | No |
Language | French or English (English by default) | No |
Employee Profile Information
Field | Validation Rules | Required |
|---|---|---|
Employee Number | Maximum 9 characters | No |
First Name | Maximum 50 characters | Yes |
Last Name | Maximum 50 characters | Yes |
Personal Email | Must be a valid email format | No |
Corporate Email | Must be a valid email format | No |
Address Line 1 | Maximum 30 characters | No |
Address Line 2 | Maximum 30 characters | No |
City | Maximum 28 characters | No |
Province | Canadian provinces only | No |
Country | Canada only | No |
Postal Code | Maximum 10 characters | No |
Social Insurance Number | Exactly 9 characters; must be valid | No |
Date of Birth | Must be a valid date | No |
Bank Account Number | Maximum 12 characters | Yes |
Bank Institution Number | Exactly 3 characters | Yes |
Bank Transit Number | Exactly 5 characters | Yes |
Hiring Province | Canadian provinces only | No |
Job Title | Maximum 255 characters | Yes |
Regular Weekly Hours | Maximum 168 hours; minimum 1 hour if annual salary is transmitted | Yes |
Hourly Salary | Must be > 0 if transmitted; maximum 9,999,999 | Required only if hourly salary is sent |
Annual Salary | Must be > 0 if transmitted; maximum 9,999,999 | Required only if annual salary is sent |
Payroll Procedures
Registration Number Configuration
After creating the company, the next step is to configure the company’s tax accounts (registration numbers) in the dashboard. These accounts include the identifiers used for remittances and filings with the CRA (Canada Revenue Agency) and Revenu Québec, as well as for integration with company settings.
Without configured tax accounts, it is impossible to properly generate the remittances and payroll-related filings.
👉 The company must have been created in order to configure the registration numbers.
Follow these steps to configure the registration numbers:
- From the left menu, navigate to Payroll > Dashboard. On this page, click on the square containing 3 horizontal lines (☰) at the top left. In the menu that opens, click on Business Settings and on the Tax Accounts tab.
- Under the Tax Accounts tab, add each applicable tax account for the company. Here are the supported tax accounts:
- CRA: Account with the Canada Revenue Agency (identifier of the type
123456789RP0001). - Revenu Québec: Account with Revenu Québec (identifier of the type
1234567891RS0001).
💡Note that it is possible to have more than one CRA tax account and more than one Revenu Québec tax account.
- For each account, provide:
The type (CRA or Revenu Québec)
The account identifier
A label to distinguish it in the interface
An optional note
Save
Importing Time Entries into Folks Payroll
You can import time data and amounts from an external system into Folks Payroll to transmit them for payroll processing.
To do this, you must first configure your payroll item codes and export your time data via a CSV file. Please refer to the article Required Configurations for Time Import.
Once the pay codes are configured and you have the CSV file, the import is done in three steps. A description of the behaviour of multiple imports for the same pay period is provided at the bottom of the article.
Step 1 - File import
- In Folks, go to Payroll > Payroll Preparation.
- On the payroll preparation page, at the top right, click the arrow on the payroll submission button and select Import time. If you do not have the timesheet, the submission button will take you directly to the import feature.
- Next, import the CSV file you exported from your time management application. The maximum allowed size is 15 MB. Refer to the article Time Import File Format.
The time and compensation data of your employees supported by Folks will be integrated into the current period. Data in columns not supported by the system are simply ignored during import. If an employee already has hours for this period, they will be replaced. Others will simply be added. - Once your file is uploaded, click Next.
Step 2 - Data validation
This step ensures that the data is consistent. The table displays the data line by line.
If your file contains errors, make the necessary corrections and re-import it. Refer to the Errors and causes section for assistance. You can also click Next to proceed with the imported lines. However, lines with errors will be excluded from the import.
Errors and causes
Each invalid cell has an error indicator with a tooltip explaining the cause. As soon as at least one cell in a row is invalid, the row status changes to Ignored, is greyed out, and excluded from aggregate totals.
A filter by status (All lines by default, Imported lines, Ignored lines) with count badges, a search across all data columns, and pagination facilitate analysis.
This section comprehensively presents the errors and warnings handled during time import. Note that the columns Line no., Employee, and Status never carry an error icon. An unfound employee is indicated by a long dash in the Employee column, with the error carried by the Employee no. cell.
| Error | Cause |
|---|---|
| Employee no. | |
| The employee number is required. | Empty |
| The employee number cannot exceed 20 characters. | More than 20 characters |
| No employee matches this number in Folks. Verify the number or create the employee. | Not found in Folks |
| Lines for this employee are ignored because the employee is excluded from payroll. | Employee excluded from payroll |
| This employee number is associated with more than one employee. Each number must be unique. | Not unique |
| Hour type | |
| The hour type is required. | Empty |
| Only the type "G" is accepted for import. | Different from G |
| Gain code | |
| The payroll code is required. | Empty |
| The payroll code cannot exceed 100 characters. | More than 100 characters |
| This payroll code does not exist in the payroll code configuration. Add it to the configuration or correct the code. | Nonexistent in configuration |
| Quantity and Amount | |
| Invalid format. A valid format is: 35.50 | Invalid quantity format (max #####.##) |
| Invalid format. A valid format is: 30.50 | Invalid amount format (max #######.##) |
| Transaction date | |
| The transaction date is required. | Empty |
| Invalid date format. Use YYYY-MM-DD. | Invalid format |
| This date does not exist (e.g., February 31). | Nonexistent date |
| The date must be within the current payroll period. | Outside current payroll period |
Step 3 - Summary and sending to payroll
The summary presents the import in two sections — General Information and Payroll Code Information. By clicking Send to Payroll, a confirmation window informs you that sending may take a few minutes and offers a checkbox to receive an email upon completion. You can therefore launch the sending and continue with other tasks in parallel.
The data will be transmitted for employees included in the synchronization and whose profile is complete.
Behaviour of multiple imports for the same pay period
When you import time multiple times for the same payroll period, it does not add hours together nor erase everything previously assigned. The update is done by preset.
Hours are updated according to their type (preset).
If you re-import for the same employee and same preset → previously imported data is replaced by the new file’s data (no addition).
If you import for the same employee but a different preset → both are retained (hours from the first preset remain intact).
Presets absent from the new file are not affected.
Here is an example:
Initial Import |
Second Import |
Total |
|---|---|---|
| 40 h in Regular Hours | Re-import of 38 h in Regular Hours and 5 h in Overtime | 38 h, not 78 h; addition of 5 h in Overtime → the 38 regular hours remain |
Can't find What You're Looking For?
Start a conversation with our team and get the answers you need.