How to set up the Visma Nmbrs integration

To configure your Visma Nmbrs integration, a Visma Nmbrs username and token is required.
How the token can be created is described in the following article:
https://support.nmbrs.nl/hc/nl/articles/360010686800-Connect-Nmbrs-with-an-API-token
The created token must be assigned an API Template. How such a template can be created is stated here:
https://support.nmbrs.nl/hc/en/articles/115005903907-API-User-Template
⚠️ Note: Do not send your token via the e-mail or chat. Only add the token in the designated area at the integration. The token is like a password to privacy sensitive data.
Our integration requires the following calls to be enabled within the API Template for your token:
Employee Service:
-
PersonalInfo_GetAll_AllEmployeesByCompany
-
Address_GetAll_AllEmployeesByCompany
-
Employment_GetAll_AllEmployeesByCompany
-
Salary_GetAll_AllEmployeesByCompany
-
Contract_GetAll_AllEmployeesByCompany
-
Schedule_GetAll_AllEmployeesByCompany
-
Function_GetAll_AllEmployeesByCompany
-
Department_GetAll_AllEmployeesByCompany
-
CostCenter_Get
-
WageComponentVar_Get
-
DaysVar_Set
- DaysVarWorked_Set
-
HourComponentVar_Clear
-
WageComponentVar_Clear
-
HourComponentVar_Insert_Batch
-
WageComponentVar_Insert_Batch
-
List_GetByCompany
Company service:
-
HourModel_GetHourCodes
- HourModel2_GetHourCodes
-
WageModel_GetWageCodes
- WageModel2_GetWageCodes
-
CostCenter_GetList
-
List_GetByDebtor
-
List_GetAll
-
Company_GetCurrentPeriod
Debtor Service:
-
Department_GetList
-
List_GetAll
After you have created a token, the integration can be set.
To do this, go to Settings > App center > Nmbrs and click the + Add Nmbrs Integration button.

After clicking the button , the following screen will appear.

Username: The username that is used to Log in in Visma Nmbrs.
Token: The token as created in Visma Nmbrs.
After the above data has been entered, the Visma Nmbrs settings can be retrieved by clicking the Connect button.
You can then select which company within your Visma Nmbrs account must be integrated.
After saving the integration it will appear in the API list and can be configured.

By clicking on the Edit icon the following screen will appear and you can configure the integration.

Mapping name: The name of the integration, which you can define yourself.
Fulltime weekly hours: The fulltime weekly hours of the employees.
Wage model: Here you can specify which wage model you want to use. The options are Standard (wage model 1), Wage model 2 or Both wage models.
Hour model: Here you can specify which hour model you want to use. The options are Standard (Hourly model 1), Hourly model 2 or Both hourly models.
Notify import email address: Email address where the integration information is being sent too, such as the status of the import of an employee.
Notify export email address: E-mail address where information about an Visma Nmbrs export is being sent too.
(.....) are managed by Nmbrs: If this option is enabled, all changes within the specific field will automatically be taken from Visma Nmbrs. If this option is disabled, the information will be imported once and for example for the contracts only the employee’s end date will be updated.
Fulltime weekly hours: Set the fulltime weekly hours.
Import Settings
Determine contract department: The contract department of employees in Shiftbase is determined by Departments or Cost centers in Visma Nmbrs.

Cost centers / Departments
Depending on the setting, all cost centers or departments in Visma Nmbrs must be mapped with a department in Shiftbase. When certain cost centers or departments do not need to be mapped, select Do not import.
Do not forget to press the Save Button on every page.
Contract types
For any contract type available within Visma Nmbrs, map the corresponding contract type within Shiftbase. Any contract type from Shiftbase can be linked to Hourly employee or Fixed hours in Visma Nmbrs.
Employees
Next, it is important that all Visma Nmbrs employees are mapped. We automatically try to associate existing employees within your account.* If no match can be found, employees will automatically be set to Add. There are four categories in which the Visma Nmbrs employees could come back.
-
Unmapped employees: The employees who are not yet mapped and can be added.
-
Mapped employees: The employees who are already mapped within your account.
-
Ignored employees: Employees identified / detected, that should not be imported. This can be specified by the given settings in contract department / contract type or manually be set for employee's.
-
Inactive employees: All inactive employees or employees who have reached their end date in their contract are hidden by deafault. You can view these employees using the Show inactive button.
Synchronisation settings employees
For all mapped employees within your Visma Nmbrs integration, you can define which level of synchronisation should be performed for that employee **
-
Only import employee: For the employee, no worked hours will be forwarded to Visma Nmbrs.
-
Import & export employee: Default setting, employee data will be imported from Visma Nmbrs into your account, worked hours are being exported.
-
Only export payrolls: No employee's peronal data or contracts will be updated. Only the worked hours will be forwarded to Nmbrs.
When the contract synchronization is done by the Visma Nmbrs intergration, the field Description is not usable for notes. Any changes to the Visma Nmbrs environment can delete made descriptions.
Export Settings
All departments in Shiftbase must be mapped to the corresponding cost center within Visma Nmbrs. Worked hours can then correctly be forwarded to Visma Nmbrs. Here you can choose if the worked hours of a specific department should be be booked to a given chosen cost center, employees Default for employee cost center or Do not export.
Wage components
Wage components kilometers and meals can mapped to a Visma Nmbrs components. To do this, simply select the according Visma Nmbrs wage component or select Do not export.
Nmbrs Hour code
Here you can map all hour codes used within Shiftbase with the according Visma Nmbrs Hour codes. Map only those hour codes which need to be forwarded to Visma Nmbrs. Ensure that all components used in the timesheets are mapped to an Visma Nmbrs component to ensure a correct and complete registration.
Supplements worked hours
For a number of hour codes of the hourly employees their can be chosen to treat them as a surcharge, Supplements worked hours.
If this is checked for a particular hourly component, the number of hours booked on this component will be added to the number of hours worked by the employee.
The hours booked on the component are treated in the same way as a surcharge for fixed hours.
💡Tip: Here employees will be sought out with corresponding email address, SSN or employee number within your account. When multiple Visma Nmbrs integrations are active within your account. Please note that employee number must be unique across the entire account. Employees with the same employee number will overwrite eachother in the integration.
💡Tip: The synchronisation level will automatically be set for employees when contracts are managed by Visma Nmbrs. Mapped employees will automatically be set to Only export payrolls when a new / modified contract is detected in which the import settings state a Contract types or Department is set to Do not import.
💡Tip: When an employee leaves the company, it is wise not to synchronise the employee in the integration anymore. This can be done by setting the employee to not import in the integration. You can do this by going to Employees and click on the employee's name and choose Don't import.
⚠️ Note: With this integration, holiday hours to be paid out can be processed. Please note that the integration does not process leave balances to and from Visma Nmbrs. It is desirable to process leave balances within Shiftbase.