Accounts in applications
Nmbrs to Somtoday integration: staff from payroll set up in Somtoday automatically
With an integration between Nmbrs and Somtoday, every new employee that payroll enters in Nmbrs automatically appears as staff in Somtoday, with name, job, location and start date. When Nmbrs records the end of employment, the staff member gets the same leaving date in Somtoday, with the reason the school uses for it.
What the integration does
Schools and education foundations that run payroll in Nmbrs, often through a payroll bureau, then enter new colleagues into Somtoday by hand once more. A substitute only appears in the system after a few days, and leavers stay listed as active staff until someone notices.
- The school creates a role in Somtoday with the HRM Service right and an account for KoppelHet, and records jobs and leaving reasons.
- The payroll bureau or HR enters the new employee in Nmbrs, with employment, job and department.
- KoppelHet reads the employee from Nmbrs, determines the abbreviation and converts the department into a Somtoday location.
- Somtoday receives the complete staff record; on every later change KoppelHet sends the whole record again.
- When employment ends in Nmbrs, the leaving date and reason go to Somtoday.
What to watch for with Nmbrs and Somtoday
- Employee numbers in Nmbrs apply per company, and an education foundation sometimes has more than one company there. KoppelHet therefore puts a prefix per company in front of the number that becomes the external staff number in Somtoday, so two colleagues with the same number never merge.
- Besides male and female, Nmbrs also has unknown and an empty value. Somtoday requires MAN, VROUW or ONBEKEND; an empty value in Nmbrs becomes ONBEKEND. KoppelHet only fills the maiden name field for VROUW, because Somtoday does not accept it otherwise.
- The name format in Nmbrs decides whether someone works under their own name or their partner's. KoppelHet derives the surname for Somtoday from it. Somtoday identifies a person by abbreviation and surname together, so on a name change KoppelHet also sends the external staff number, letting Somtoday update the existing record.
- Somtoday clears a date field when it is missing from an update. Nmbrs only signals in a webhook that something changed. KoppelHet therefore fetches the complete employee on every notification and always resends date of birth, start date and any leaving date.
- Departments in Nmbrs are set up for cost allocation, not for school locations. A lookup table converts each department into one or more location codes in Somtoday; the first becomes the main location. A department without a rule goes on a list for the school instead of guessing a location.
- Nmbrs holds citizen service number, IBAN and marital status, and the Somtoday web service has fields for them too. KoppelHet leaves those fields empty. Somtoday does not need them for the timetable or student monitoring, and payroll data stays in payroll.
- An employee who moves to another company in Nmbrs gets a new employment there. KoppelHet recognises the move and updates the existing Somtoday record with the new number, so the teacher keeps their abbreviation and login and is not briefly shown as having left.
This integration is also part of joiner, mover, leaver.
How we build and run it
- The integration runs on the KoppelHet platform, hosted in a data centre in the EU.
- Every sync and every error is visible in the functional log; on an error your administrator is notified.
- A change that cannot go through is not half-applied but queued for another attempt.
- KoppelHet is ISO 27001 certified. Data travels encrypted and stays on the platform no longer than needed.
- After go-live we manage the integration and adjust it when your process changes.
- The integration fits next to your existing integration layer. Only the fields in the design are transferred; the platform keeps no register of its own.
Implementation and price
This is not an app you switch on. We build the integration for your organisation on our platform, with building blocks we reuse on every project. So it is custom work that does not start from scratch.
A consultant prepares the intake and analyses both systems. We then record the mapping and exceptions field by field, test in the test or acceptance environment and go live at a moment you choose. Costs are a one-off amount for the setup and a monthly amount for platform, monitoring and support.
Frequently asked questions
Somtoday names AFAS and Raet as HR systems. Does the web service also work with Nmbrs?
Yes. The web service is not tied to one HR system; KoppelHet delivers the data from Nmbrs in the form Somtoday asks for.
How does a teacher get their abbreviation?
According to a rule the school chooses, for example letters from first and last name. KoppelHet checks that the abbreviation is still free and keeps it, so it does not change if the name changes later.
Are substitutes and interns included?
If they have an employment in Nmbrs, yes. Anyone working only through an agency and not in Nmbrs stays manual in Somtoday, or can come from another source later as an extension.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- Nmbrs is read through the Nmbrs REST API with OAuth 2.0 and only read scopes for employee and employment data and the company structure, per company; webhooks on changes and a daily comparison. Personal fields such as Initials, Nickname, Prefix, PartnerPrefix, PartnerLastName, Naamstelling and Gender (male, female, unknown or undefined) are in the Nmbrs data model. The SOAP API stops on 1 March 2027.
- Somtoday is written through the HRM web service (SOAP, one operation CreatePerson for create and update) with WS-Security and the hrm:Brinnummer element in the header. WSDL https://oop.somtoday.nl/services/HRMService?wsdl, test oop.test.somtoday.nl. Required: afkorting, achternaam, geslacht and datumInDienst; wachtwoord only for new staff; datumUitDienst and redenUitDienst only together. The web service is one-way.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in Nmbrs | Field in Somtoday | Notes |
|---|---|---|
Bedrijf en personeelsnummer | externMedewerkerNummer | With a prefix per company |
Voorletters | voorletters | |
Roepnaam of voornaam | roepnaam | |
Tussenvoegsel | voorvoegsel | Must be in the Somtoday table |
Achternaam volgens naamstelling | achternaam | |
Geslacht (male, female, unknown, undefined) | geslacht (MAN, VROUW, ONBEKEND) | |
Zakelijk e-mailadres | email | |
Functie | functie | Through a lookup table to an existing Somtoday job |
Afdeling | vestigingen | Lookup table from department to location code |
Begindatum dienstverband | datumInDienst | |
Einddatum dienstverband | datumUitDienst en redenUitDienst |
Related
ADP Workforce Now → Nmbrs
ADP Workforce Now to Nmbrs integration: the Dutch payroll group from ADP in the right Nmbrs company
AlexisHR → Nmbrs
AlexisHR (Simployer One) to Nmbrs integration: Dutch employees into payroll
BambooHR → Nmbrs
BambooHR to Nmbrs integration: Dutch payroll next to a global HR system
Bullhorn → Nmbrs
Bullhorn to Nmbrs integration: placements with hourly pay and end date in payroll