Nmbrs is een geïntegreerde HR- en salarissoftware oplossing voor loonadministratie, verlofregistratie en personeelsbeheer.
Wat houdt de Nmbrs integratie in?
Door de integratie tussen Nmbrs en Rakoo worden gebruikers vanuit Nmbrs automatisch toegevoegd en geüpdatet in Rakoo.
Benodigde gegevens verkrijgen vanuit Nmbrs
De integratie tussen Nmbrs en Rakoo heeft een aantal gegevens nodig om te kunnen werken. Namelijk OAuth2 Client ID, OAuth2 Client Secret, RefreshToken en SubscriptionKey. Deze haal je op vanuit Nmbrs. Volg hiervoor onderstaande stappen.
Stappen om aan Client ID, Client Secret & RefreshToken te komen:
Ga naar de integratie-pagina op het partner portal.
Ga naar secrets en genereer een secret. Bewaar de client id en de client secret die je krijgt.
Gebruik de 'helper' met de benodigde scopes:
offline_access
employee.employment.read
employee.info.read
employee.payrollsettings.read
company.info.read
Zet de redirect url op localhost:8080 (uit dropdown selecteren).
Kopieer de URL en plak die in de adresbalk van je browser.
Geef toestemming voor de scopes die je net hebt ingesteld (OAuth2 flow).
Je wordt geredirect naar localhost:8080 met daarin in een Query parameter genaamd 'code'. Kopieer deze waarde (inclusief de '-1' aan het eind), dit is je Authorization code.
Maak nu het volgende curl request:
Vervang hierin de waardes als '<CLIENT_ID>' met de id en secret die je eerder hebt gekregen.
Het RefreshToken haal je vervolgens uit de URL. v
Stappen om SubscriptionKey aan te maken:
Volg de stappen in deze documentatie van Nmbrs om een SubscriptionKey aan te maken.
Hoe koppel ik Nmbrs aan Rakoo?
Ga via het menu links in beeld naar 'Integraties'.
Kies bij 'Automatiseren' voor 'Nmbrs'.
Klik op 'Installeer integratie'.
Vul de gevraagde gegevens in.
Naam: geef je integratie een naam.
BaseUrl: https://api.nmbrsapp.com
OAuth2 Client ID: opgehaald vanuit Nmbrs volgens stappenplan hierboven.
OAuth2 Client Secret: opgehaald vanuit Nmbrs volgens stappenplan hierboven.
RefreshToken: opgehaald vanuit Nmbrs volgens stappenplan hierboven.
SubscriptionKey: opgehaald vanuit Nmbrs volgens stappenplan hierboven.
JsonMapping: met je Customer Success Manager bespreek je de mapping van de velden uit Nmbrs met de velden in Rakoo. Deze mapping delen we met je en voeg je hier toe.
Zet de integratie op 'Geactiveerd' en sla de wijzigingen op.