Menu

Samenvatting van de Nmbrs API

De Nmbrs API stelt je in staat om je volledige HR- en payroll-flow te automatiseren — van het aanmaken van medewerkers tot het verwerken van loonruns en het exporteren van loonstroken. Hiermee bouw je een geïntegreerde HR-stack met urenregistratie, boekhouding en planning.
  • Medewerkers & contracten: Beheer medewerkergegevens, adressen, bankrekeningen, contracten, dienstverbanden, salarissen en functies.
  • Loonruns & componenten: Voer loonruns uit, lees per medewerker looncomponenten, loonheffing en werkkosten uit.
  • Urenregistratie & verlof: Boek gewerkte uren, beheer verlofbalansen en plan werkdagen via aparte endpoints per medewerker.
  • Organisatie-structuur: Beheer afdelingen, kostenplaatsen, managers en werkroosters voor accurate loonkostentoewijzing.
  • Documenten & debiteuren: Haal loonstroken en jaaropgaven op als documenten, en beheer debiteureninformatie voor accountantsprocessen.
  • Settings: Configureer SVW-, loonheffing- en CAO-instellingen per bedrijf voor correcte berekeningen.
API Quick Facts REST
  • Authenticatie OAuth2
  • Methods GET (81)POST (17)PUT (13)DELETE (3)
  • Rate limits Niet gespecificeerd
  • Webhooks Niet beschikbaar
  • Sandbox Beschikbaar
  • Response format JSON
  • Versionering URL-based

Laatste ontwikkelingen bij de Nmbrs API

Nmbrs is opgericht in 2008 in Rotterdam als cloud-salarisadministratie voor MKB en accountantskantoren en werd in 2022 overgenomen door Visma. De API stack bestond historisch uit SOAP-services per resource (CompanyService, EmployeeService, etc.) en is sindsdien gemoderniseerd naar één publieke REST API. De huidige Public REST API is OpenAPI 3.0-gespecificeerd, gehost op api.nmbrsapp.com en wordt gedocumenteerd via een Stoplight-portal met mockservers voor sandbox-testen. OAuth 2.0 is de standaard authenticatiemethode. Officiële SDK's worden niet aangeboden; community-libraries bestaan voor PHP en .NET tegen de oudere SOAP-services.

API versies

Public REST API (OpenAPI 3.0) Major release

Moderne REST API als opvolger van de oudere SOAP-services, OpenAPI 3.0-gespecificeerd en gehost op api.nmbrsapp.com.

Visma-overname

Nmbrs werd in 2022 overgenomen door Visma; sindsdien wordt het platform geïntegreerd in de Visma-suite met behoud van eigen API.

Stoplight-portal

Documentatie via Stoplight met mockservers voor sandbox-testen zonder echte productie-data.