Koppelen met Loket.nl (via RESTful)


Introductie

Als u gebruik maakt van Loket.nl dan kunt u mijnrooster en Loket.nl aan elkaar koppelen. Met deze koppeling is het mogelijk om personen in Loket.nl te importeren naar mijnrooster. Ook kunnen we bij het salaris rapport een Loket.nl CSV export mogelijk maken welke vervolgens bij Loket.nl geïmporteerd kan worden. Via deze export/import kunt u eenvoudig alle uren van mijnrooster naar Loket.nl overzetten.


Dit artikel behandeld de volgende onderwerpen:


Loket.nl gebruiker

Als eerst heeft u een Loket.nl gebruiker nodig die geschikt is voor het maken van de koppeling. Volg hiervoor de instructie van Loket.nl: 

https://helpdesk.loket.nl/hc/nl/articles/360010294760-Handleiding-REST-API-koppeling


Loonkoppeling toevoegen/bewerken

Nu u een geschikte Loket.nl gebruiker heeft kunt u de koppeling gaan maken. Ga hiervoor naar uw mijnrooster omgeving en open de pagina Structuur. Selecteer uw hoogste structuur onderdeel en ga onderin naar het tabblad Loonkoppeling. Klik op de knop 'Nieuw' om een nieuwe koppeling toe te voegen of selecteer uw bestaande Loket.nl koppeling en klik op 'Bewerken' om deze aan te passen.


Er verschijnt nu een popup waarin u de loonkoppeling kunt maken:

  • Kies bovenin voor de optie: LoketNL (RESTful)
  • U ziet nu onderstaande scherm. De velden 'Email/gebruiker' en 'Token/wachtwoord' kunt u leeglaten, deze is d.m.v. het authorisatie proces niet meer nodig. Klik op de knop Authoriseren om verder te gaan.
  • Er verschijnt een melding met de vraag of u wilt gaan authoriseren, klik hier op OK.
  • U krijgt nu een inlogscherm te zien, log hier in met de gegevens van de Loket.nl gebruiker die u eerder heeft aangemaakt.
  • Wanneer u op 'Login' klikt zal er gevraagd worden of u toestaat dat er gegevens met mijnrooster gedeeld worden. Klik op 'Toestaan' en hierna keert u terug naar de popup: Loonkoppeling.
  • In de loonkoppeling popup zullen nu velden die eerder een rode achtergrond hadden veranderd zijn naar een groene achtergrond. De velden Werkgever en Administratienummer zullen wel nog een rode achtergrond hebben omdat deze nog ingevuld moeten worden. Vul deze velden in of gebruik de knoppen Gebruik ... om één van de voorgestelde opties te gebruiken. Hierna zullen deze velden ook groen kleuren.
  • Klik tot slot op 'Opslaan'. Uw loonkoppeling is nu gereed.


Loonkoppeling testen

Om te controleren of de loonkoppeling werkt kunt u deze testen. Selecteer uw bestaande loonkoppeling op het tabblad Loonkoppeling (te vinden op de pagina structuur, selecteer hier het hoogste onderdeel) en klik op de knop 'Test koppeling'. Er verschijnt nu een popup met controles en als de koppeling correct werkt ook een lijst met uw personen in Loket.nl.