---
title: "How to synchronize employees in batch with Visualtime?"
slug: "1730373006"
tags: ["Employees"]
updated: 2026-11-10T12:28:24Z
published: 2026-11-10T12:28:24Z
canonical: "help.ila.cegid.com/1730373006"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.ila.cegid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to synchronize employees in batch with Visualtime?

- [x] PT
- [ ] ES
- [ ] AO
- [ ] CV
- [ ] MZ

- [x] Professional
- [x] Executive
- [x] Public Sector
- [ ] Omnia
- [x] Evolution

---

Integration with the [Cegid Visualtime](https://www.cegid.com/ib/pt/produtos/software-gestao-tempo-visualtime/) time management system ensures that the information associated with the employee is **successfully synchronized** between the two applications.

> [!WARNING]
> This integration must be [configured in both applications](/primavera/docs/en/1730372321), and also allows for the [synchronization of monthly absences.](/primavera/docs/en/1730373613)

---

## Synchronizing Employees in Batch

After [configuring the integration](/primavera/docs/en/1730372321), you can send employees **in batch**. To do this, follow these steps:

1. In the ERP, go to **Human Capital | Visualtime | Employee Synchronization**;
2. Select the desired filters and **Update** the list;
3. In the list shown, select the employees you want to synchronize and click **Communicate.** **Important note**: if there is an **active employee in the ERP** with the **same Tax ID already synchronized with Visualtime**, it will not be possible to synchronize another one with the same Tax ID. By default, this list shows **active** employees **with changes.**

---

## Sending Data

After configuring the [integration with Visualtime](/primavera/docs/en/1730372321), the application **automatically sends employees** whenever:

- an employee is created;
- the **Department** or **Work Location** is changed, depending on the integration's configuration in the **Subgroup**;
- the **Name**, **Abbreviated Name**, **Phone**, and/or **Email** fields are changed;
- the **contract is terminated**, i.e., when the dismissal date and/or the status (active/inactive) of the employee's record is changed.

For the **start period** of contracts in Visualtime, Visualtime's **lock date** is considered, taking the **latest of three dates**: the hire date, the date of the first processing period, or the lock date.

If a [prefix](/primavera/docs/en/1730372321) is set in the Visualtime integration settings, the system will use the combination of the ***prefix + employee code*** as the employee's **code** in Visualtime*.* This feature lets you **distinguish the employee's code** by company in subscriptions with multiple companies. When re-synchronizing an employee, the **Abbreviated Name** is not resent, since it may have been changed in Visualtime. If it needs to be resent, you must select the **Restart Synchronization** option in the ERP and proceed with the export.

---

## Viewing Data

After synchronization, you can view the employees already synchronized in **Human Capital | Visualtime | Employee Synchronization.**

---

## Frequently Asked Questions

The following frequently asked questions aim to clarify possible doubts about how this integration works:

**1. When synchronizing employees, I get the Invalid_login error. How do I fix it?**

In this case, you should check whether the **Abbreviated Name** of the employee you're trying to synchronize **already exists**.

This name must be unique for synchronization.

**2. When synchronizing employees, I get the Invalid_contract error. How do I get past this?**

You should check whether the **Tax ID** of the employee you're trying to synchronize **already exists.**

Only one active Tax ID can exist in Visualtime for synchronization.

**4. I made a mistake in an employee's hire date. I deleted the employee from Visualtime and corrected the hire date in the ERP; however, the synchronization start date still corresponds to the previous date. How do I fix this?**

In this scenario, you should:

1. In the ERP, go to **Human Capital | Visualtime | Employee Synchronization;**
2. Select the desired **filters** and click **Update the list**;
3. Right-click the employee to be corrected and click **Restart Synchronization;**
4. Confirm the message that appears.

After this operation, the synchronization start date is updated to the new hire date.

**5. I removed an employee from the ERP, but they are still active in Visualtime. Why?**

If an employee who was synchronized with Visualtime is removed in the ERP, they will need to be **removed manually** in Visualtime.

## Related

- [Integration with Visualtime: Features and Settings](/1730372321.md)
- [How to synchronize monthly changes with Visualtime?](/1730373613.md)