Establishing the Tellent HR and Nmbrs connection
A. Connection Requirements
Before connecting Tellent HR to your Visma Nmbrs account, ensure you have admin access. Tellent HR will handle the OAuth authentication with Nmbrs, so you don't need to obtain or manage any API credentials yourself.
To get help setting up the integration with Visma Nmbrs, make sure you have "adminsutartor" rights and access to all debtors in your account. To confirm it, go to your Account settings > User settings > logins
B. Connection Setup
1. In Tellent HR, go to Settings > Configuration > Integrations > Apps > Nmbrs
2. Select the integration card, click Integrate, and accept the integration terms.
3. Select the Nmbrs integration listing and click the + Connect new Nmbrs instance button.
4. Enter the name that will help you identify this connection in the Tellent HR interface and click Connect in the bottom right.
5. Follow the instructions that appear on the Nmbrs connector modal and click on Authenticate with Nmbrs.
6. You will be taken to the Nmbrs website for consent. Select the Company that corresponds to your Nmbrs account from the dropdown and click Allow. You'll be redirected back to Tellent HR.
After this step, the connection is established, and you can start assigning employees.
Assign Employees
Go to the Employees tab to select and assign which Tellent HR users will sync with Nmbrs. You can also create a new Nmbrs employee from this view by selecting +Create New.
⚠️ Important: When assigning or creating a user who is already assigned to an existing user in Nmbrs, the system will display the following warning:
"This Nmbrs employee is already assigned to another user."
This warning helps prevent duplicate assignments and ensures that each Nmbrs employee is linked to only one user.
Syncing employee data with Nmbrs
A. Employee data synchronization
Tellent HR synchronizes the following employee data with Nmbrs when creating or updating employees:
Syncing an employee in Nmbrs will make the employee a Payroll employee.
Tellent HR field | Nmbrs field | Required | Notes |
First name | firstName | Yes |
|
Last name | lastName | Yes |
|
Social Security Number | socialSecurityNumber | Yes |
|
Employment start date | startDate | Yes | Employment field |
IBAN | IBAN | Yes | Bank account field |
Street address | street | Yes | Address field |
City | city | Yes | Address field |
Country | countryISOCode | Yes | ISO code format |
Employee field mapping
The default fields are mapped automatically when the integration is configured. If you only want to use the default mapping, no further action is required.
To map additional fields, you must first create the corresponding Employee fields in Profile Fields Management. Once the field has been created, return to the integration settings to complete the mapping.
⚠️ Important: Setting a non-required mapped field to empty in Tellent HR will not remove the existing value in Nmbrs. To delete a value, it must be cleared directly in Nmbrs.
B. Creating a new employee in Nmbrs via Tellent HR
1. Fill in the employee's details, including email, first name, last name, and set up HR access.
Creating a new employee in Nmbrs will make the employee a New hire.
2. Fill in employment information, including the employment start date, and click Save changes.
3. Go to the employee profile, add their Social Security number, and complete their address details.
4. Navigate to Settings > Configuration > Integrations > Apps > Nmbrs
5. Select your Nmbrs connection and click Edit assignees in the Employees tab.
6. Select the newly created employee and click Assign.
7. Under the Nmbrs User section, click + Create new and click Save changes. The employee will be created in Nmbrs with their Tellent HR data.
Create an employee in Nmbrs individually
Go to Employee profile > Manage > Payroll > Integrations and Assign the employee to your Nmbrs account.
Select company, choose the corresponding Nmbrs user, and click Synchronize.
Syncing payslips from Nmbrs
A. Distributing Nmbrs payslips within Tellent HR
Within the integration, Tellent HR can retrieve payslips from Nmbrs for a particular month and securely distribute them to employees through the Payroll module.
To get and distribute payslips, you first need to create a Pay run, a feature that gathers payroll-relevant data for selected employees within a specified pay period.
2. Select the month for which payslips will be retrieved. Select a payment date and approver. Click Add to confirm.
To retrieve payslips from Nmbrs correctly, you must select the entire month. Custom date ranges will not work.
3. Assign all employees to the pay run for whom you want to import and distribute payslips.
4. In the top-right corner, press the NMBRS button and select Import payslips.
5. From the modal, choose your Nmbrs connection. Review the summary of employees whose payslips will be imported, then click Import payslips.
6. Confirm the action in the next modal by clicking Import payslips.
7. In the pay run details, you'll see that payslips are being synced. Once imported, you'll see the timestamp of the successful operation.
8. You can preview imported payslips by going to Salary and opening the files next to each employee.
Employees do not see payslips until the pay run is marked as Closed.
9. To distribute payslips to employees, close the pay run by pressing Close pay run in the top right corner.
10. Once closed, employees will receive an in-app notification and an email notifying them that their payslips are available in their Tellent HR profiles.
11. Employees can view and download their Nmbrs payslips from their profile under Payroll > Paysheets.
B. Distributing Nmbrs payslips within Tellent HR
Within the integration, Tellent HR can retrieve Nmbrs payslips for a particular month and securely distribute them to employees through the Payroll module.
To get and distribute payslips, first you need to create a Pay run. It is a feature of the Payroll module that enables the collection of payroll-relevant data for selected employees during a specified pay period.
1. Go to Payroll > Pay runs > New.
2. Select the month for which payslips are going to be retrieved. It is also obligatory to select the payment date and the user who will serve as an Approver. Those choices will not affect the process of downloading and distributing payslips. Click Add to confirm.
Please note that to get the payslips from Nmbrs correctly, the entire month has to be selected. If you switch the pay period to a custom range that does not cover the entire month, payslips will not be downloaded from Nmbrs.
3. Assign to the created pay run all employees for whom you wish to import and distribute payslips.
4. In the top-right corner, press the Nmbrs button and select Import payslips.
5. From the modal, choose your Nmbrs connection. The system will then display a summary of employees whose payslips will be imported (those assigned to both a pay run and the selected Nmbrs connection). After reviewing this summary, click Import payslips.
6. Confirm the action again in the next modal by clicking Import Payslips.
⚠️ Important: Syncing might take a few minutes. If available in Nmbrs, payslips will be downloaded for employees assigned to the pay run. Otherwise, you will see an error message: No payslips available in the pay run details section
7. In the pay run details section, you will see that the payslips are being synced. Once imported, you will see the timestamp of the successful operation.
8. You can preview the payslips that were imported by going to Salary and opening the files that appeared next to each employee.
Employees do not see the payslips until the pay run is marked as Closed.
9. To distribute payslips to employees, close the pay run by pressing the Close pay run button in the top right corner.
10. Once the pay run is closed, employees will receive an in-app notification and (according to notification settings), an e-mail about their pay sheets being available in their Tellent HR profiles.
11. Employees will see the pay sheet summaries in their profile, where they’ll also be able to download Nmbrs payslips.
FAQs
General
Is this integration available with my current Tellent HR plan?
Is this integration available with my current Tellent HR plan?
The Nmbrs integration is offered as an optional add-on. To activate it, simply go to your Account Settings > Integrations > Apps.
Integration setup
Can I use the same connection for multiple companies?
Can I use the same connection for multiple companies?
No, you need to set up a separate connection for each company in your Nmbrs account.
My connection keeps failing. What should I do?
My connection keeps failing. What should I do?
Verify that you have admin access to your Nmbrs account and that your account has the necessary permissions. If issues persist, contact Tellent HR support.
Employee synchronization
Can new employees be created in Nmbrs from Tellent HR?
Can new employees be created in Nmbrs from Tellent HR?
Yes, during connection setup, you can create new employees in Nmbrs rather than only matching existing ones.
What happens if an employee isn't matched correctly?
What happens if an employee isn't matched correctly?
If there's a mismatch, the target employee's data in Nmbrs will be overwritten with the Tellent HR data. If an employee isn't matched to a connection, no data will be transmitted to Nmbrs for that employee.
Can I synchronize only certain employees with Nmbrs?
Can I synchronize only certain employees with Nmbrs?
Yes, you can choose which employees to synchronize in each connection by using the assign employees feature during setup.
What if an employee's data changes in Tellent HR?
What if an employee's data changes in Tellent HR?
Employee data is automatically synchronized with Nmbrs when changes are saved in Tellent HR. You do not need to manually push updates — the integration handles this continuously.
Does the sync happen in real time?
Does the sync happen in real time?
Yes, changes saved in Tellent HR are pushed to Nmbrs shortly after. There may be a brief delay of a few minutes for larger sync operations.
What happens if I unassign an employee from the connection?
What happens if I unassign an employee from the connection?
The employee will no longer be synchronized with Nmbrs. Existing data in Nmbrs remains unchanged, but future updates from Tellent HR will not be pushed until the employee is reconnected.
Employee field mapping
What fields are synchronized to Nmbrs?
What fields are synchronized to Nmbrs?
Tellent HR synchronizes a core set of required fields to Nmbrs, including employee number, first and last name, date of birth, gender, nationality, personal email, and contract details. For a complete reference, see the Employee field mapping Nmbrs article.
Can I clear a field value in Nmbrs by emptying it in Tellent HR?
Can I clear a field value in Nmbrs by emptying it in Tellent HR?
No. Setting a non-required field to empty in Tellent HR does not clear the value in Nmbrs. To remove a value in Nmbrs, you must do so directly within the Nmbrs platform.
Is there a complete overview of all available field mappings?
Is there a complete overview of all available field mappings?
Yes, see the Employee field mapping Nmbrs article for a full table of all fields, their direction of sync, and any notes on behavior.
Payslips
When can employees see their payslips?
When can employees see their payslips?
Employees only see payslips after the pay run in Nmbrs has been marked as Closed. Until then, payslips are not visible in Tellent HR, even if they have been imported.
Can I import payslips for a custom date range?
Can I import payslips for a custom date range?
No. Payslips can only be imported per pay period as defined in Nmbrs. Custom date ranges are not supported.
What if a payslip import fails?
What if a payslip import fails?
Check that the employees are assigned to both the pay run and the Nmbrs connection. If the issue persists, contact Tellent HR support.