1. Inleiding

Dit document beschrijft de inrichting voor de klanten van Personeel & Salaris van de web api voor de koppeling met externe partijen.

2. Voorwaarden API

De web api van Unit4 Personeel & Salaris is uitsluitend beschikbaar op de Salaris Cloud. Klanten die on-premise werken kunnen hier geen gebruik van maken.

3. Mogelijkheden API

De web API van Unit4 Personeel & Salaris is ontwikkeld om derde partijen de mogelijkheid te bieden te communiceren met de database van Unit4 Personeel & Salaris met zo min mogelijk gebruikershandelingen. Dit gaat om zowel lezen als schrijven.

4. Koppeling in Unit4 Personeel & Salaris

Om een koppeling te realiseren met een externe partij dient de klant hier zelf expliciet toestemming voor te geven binnen Unit4 Personeel & Salaris. Dit staat los van het contract en de verwerkersovereenkomst die de klant moet afsluiten met de externe leverancier. Hier is Unit4 geen partij in. 

4.1. Maak een gebruikersgroep aan

De eerste stap is om een gebruikersgroep aan te maken zodat alleen toegang kan worden gegeven op de geautoriseerde administratie. Om een gebruikersgroep aan te maken volg je de volgende stappen:

• Login met ‘Systeem’ rechten, in de meeste gevallen is dit gebruiker .01
• Ga naar Onderhoud | Systeembeheer | Toegangsbeheer
• Kies het tabblad Gebruikersgroepen
• Kies Nieuw
• Koppel de bestaande gebruiker die over de juiste rechten beschikt aan deze nieuwe groep.
• Sla de gegevens op.  

4.2 Koppel de werkgever(s) aan de gebruikersgroep

Nu de nieuwe gebruikersgroep is aangemaakt, is de volgende stap om de werkgever(s) te koppelen waar de api koppeling voor van toepassing is.

Om werkgever(s) te koppelen aan de gebruikersgroep volg je de volgende stappen:

• Login met ‘Systeem’ rechten, in de meeste gevallen is dit gebruiker .01
• Ga naar Onderhoud | Systeembeheer | Toegangsbeheer
• Kies het tabblad Autorisatie Werkgevers
• Kies de gebruikersgroep die zojuist is aangemaakt bij stap 4.1
• Koppel de werkgever die moet worden geautoriseerd door die naar rechts te verplaatsen
• Sla de gegevens op

4.3 Aanmaken van een web api gebruiker

Om de leverancier toegang te verlenen moeten de volgende stappen worden gevolgd:

• Log in met ‘Beheer’ rechten, in de meeste gevallen is dit gebruiker .01
• Ga naar Onderhoud Nieuw | Systeembeheer | Toegangsbeheer

• Selecteer de externe applicatie: InsuranceBrydge De lijst met externe applicaties wordt onderhouden door Unit4. Hierin staan alleen de applicaties die formeel zijn aangemeld en die voor alle klanten van toepassing zijn.
• Kies Nieuw om een gebruiker te selecteren.
• Selecteer dezelfde gebruiker die we bij stap 4.1 hebben gekoppeld aan de nieuw aangemaakte gebruikersgroep (Gebruiker)
• Het veld Client ID en Client Secret (de identificatiecode voor Unit4 Identity Management), worden gegenereerd door te kiezen voor ‘Gebruik onderstaande knop om de code op te halen’
• De wijzigingen worden automatisch opgeslagen als het Client Secret is ontvangen.
• De gegenereerde Client ID en Client Secret moeten worden overgedragen aan de externe partij via een beveiligde manier. Daarmee krijgt deze toegang tot de database en de geautoriseerde werkgever.

Benodigde koppelparameters: 

Hieronder volgt een korte opsomming van de benodigde koppelgegevens: 

• Client ID:
• Client Secret: