Loket.nl

Wat doet de koppeling?

Met deze integratie biedt je loonaangiftes ter ondertekening aan in Pinkweb. De cliëntgebruiker krijgt de aangifte in PDF formaat te zien.

Hoe werkt de koppeling? 

Jouw kantoor stuurt de loonaangifte vanuit Loket.nl eenvoudig door naar Pinkweb. Het resultaat van een ondertekening wordt elke vijf minuten teruggekoppeld naar Loket. Zodra deze terugkoppeling heeft plaatsgevonden wordt de status van de geaccordeerde  loonaangifte in het portaal gewijzigd in “verwerkt”.

Technische informatie

De integratie werkt op basis van een RESTful API. Deze wordt onderhouden door Loket.nl. In beide pakketten wordt een koppelgebruiker aangemaakt.

De koppelgebruiker van Pinkweb wordt door Loket gebruikt om een loonaangifte ter ondertekening te plaatsen.

De koppelgebruiker van Loket wordt door Pinkweb gebruikt om de status van de accordering aan Loket.nl door te geven.

Voorbereiding implementatie

• Pinkweb configureert een zogenaamde koppelgebruiker in het portaal
• Je ontvangt een url (endpoint) en de gegevens van de Pinkweb koppelgebruiker
• Maak in Loket een normale gebruiker aan, dus nadrukkelijk geen webservice gebruiker. De normale gebruiker in Loket dient het recht "bevestigen loonaangifte" te krijgen
• Contact opnemen met loket.nl (api@loket.nl), aangeven dat Pinkweb ingesteld moet worden als externe partij voor loonaangiftes. Geef de gegevens van de Pinkweb koppelgebruiker en het endpoint door aan Loket
• Geef de gegevens van de Loket gebruiker door aan de Pinkweb consultant

Technische eisen

Er zijn geen aanvullende technische eisen.

Foutmeldingen

Klik hier voor een lijst met foutcodes. Deze codes worden gebruikt in de e-mail notificaties van Pinkweb.

FAQ

Hoe configureer ik een koppelgebruiker in Loket.nl?

Dit staat beschreven in de handleiding koppeling externe partijen van Loket.nl.