Hibob - Nmbrs | Employees: Setting up the interface

Hibob - Nmbrs | Employees: Setting up the interface

Step 1: Set up the new interface by picking the template
Example of creating the Hibob - Nmbrs Employees interface using the template

Alert
Make sure the Hibob and the Nmbrs apps are active. Follow this guide to see how to activate an app if not doing using the 'create interface' flow.

Step 2: Set up test environments and set up credentials & permissions

Idea
Consult the support of Hibob or Nmbrs if you get stuck on creating a test environment
Warning
Important: Never test against production Nmbrs data. Always synchronize to a designated Demo company in your first testing runs.
For HiBob this is less critical from a data-safety standpoint, the main benefit of a sandbox environment is it gives you more freedom to test different situations at scale.


Step 3: Fill in the configuration
Important: Never test against production Nmbrs data. Always synchronize to a designated Demo company in your first testing runs.
During testing, In this step, fill in the names of your Demo companies (see step 2), not the production companies.

Step 4: Review the scenarios (draft)
Step 4A) Scope
Note which ones you need, which ones you do not need.

Step 4B) Hibob custom fields

Step 4C) Value Mappings

Step 4D) Logic

Step 4E) Confirm Scope
WarningNote: Changing the scope late in the process introduces delays and requires additional support, with the associated costs.

Scenarios in this template
Each scenario handles one topic (identity, contract, salary, and so on). Open the ones you plan to enable; the same order below is the order in which they run.
1. Scenario Personal

Sync each employee's identity - name, BSN, gender, nationality - from HiBob into Nmbrs. This scenario runs first because it creates the employee record in Nmbrs; every other scenario depends on it.

Open the Scenario Personal article

2. Scenario Address

Sync each employee's address (street, house number, postcode, city, country) from HiBob to Nmbrs. Nmbrs stores address as period-stamped history, so every change becomes a new address period rather than an in-place edit.

Open the Scenario Address article

3. Scenario Contract

Sync employment contract details from HiBob to Nmbrs. Indefinite contracts have no end date; definite contracts require one and are dropped if missing.

Open the Scenario Contract article

4. Scenario Salary

Append each employee's salary from HiBob to Nmbrs as a new salary period. Nmbrs has no salary update endpoint; every change becomes an appended record, preserving history.

Open the Scenario Salary article

5. Scenario Schedule

Sync the weekly working schedule (per-day hours) from HiBob to Nmbrs. Applies only to hourly contract types.

Open the Scenario Schedule article

6. Scenario Job

Sync each employee's function / job from HiBob to Nmbrs. Nmbrs allows one active function at a time; the newest function period is what's compared and updated.

Open the Scenario Job article

7. Scenario Department

Sync each employee's department from HiBob to Nmbrs.

Open the Scenario Department article

8. Scenario Cost Center

Sync each employee's cost centre from HiBob to Nmbrs. Percentage splits are supported.

Open the Scenario Cost Center article

9. Scenario Assign Manager to Employee

Assign each employee's manager in Nmbrs based on the HiBob manager email. Employees whose manager isn't yet in Nmbrs are dropped with a log line - expected on the first run.

Open the Scenario Assign Manager to Employee article

10. SVW Employee Settings

Sync each employee's SVW (social security) settings from HiBob to Nmbrs - insurance obligation, phase, etc.

Open the SVW Employee Settings article

11. Scenario Tax Settings

Sync wage-tax (loonheffing) settings - income type, special table, wage-tax discount, rebate flags - from HiBob to Nmbrs.

Open the Scenario Tax Settings article

12. Scenario Employee Termination

Sync employee terminations from HiBob to Nmbrs. Runs near the end because the Contract scenario may have written new employment records earlier in the same run.

Open the Scenario Employee Termination article

13. Scenario Bank Account

Sync each employee's bank account (IBAN) from HiBob to Nmbrs. Two source variants exist (dedicated bank table vs the people record); only enable one.

Open the Scenario Bank Account article

    • Related Articles

    • Scenario Personal

      What this scenario does Synchronise the employee's personal information. This is the scenario that creates a new employee in Nmbrs when someone starts in HiBob, so every other scenario depends on it. Before you start HiBob authorisation is set up ...