Introductie: integraties/ koppelingen

Gebruikersrechten en koppelingen Volgen

Een koppeling via de REST API werkt met de rechten van de gebruiker die de koppeling heeft geautoriseerd. Dat blijft zo na het koppelen: verandert de toegang in Nmbrs Payroll van die gebruiker, dan verandert ook wat de koppeling mag.

Bij het gebruik van een koppeling controleert de Nmbrs Payroll bij een eerste set gevoelige acties of die gebruiker het juiste recht heeft. Het gaat om hetzelfde recht dat de gebruiker in Nmbrs Payroll zelf nodig heeft. In eerste instantie vindt deze aanvullende validatie plaats op de meeste gevoelige informatie in Nmbrs Payroll.

We voeren deze extra controle in omdat accountant gebruikers binnekort koppelingen kunnen autoriseren. Met één toestemming kan een koppeling dan bij meerdere administraties.

Wat verandert er niet:

  • Bestaande koppelingen hoeven niet opnieuw geautoriseerd te worden, tenzij nieuwe organisaties aangesloten moeten worden op de koppeling.
  • Bedrijfsgegevens die elke gebruiker ziet, zoals afdelingen, functies en kostenplaatsen, blijven beschikbaar. Organisatorische gegevens zijn verweven in vrijwel iedere feature binnen een bedrijf.

Melding: 403 ontbrekend recht

Mist de gebruiker een recht, dan geeft de API voor die ene actie een foutmelding met statuscode 403:

The authorized user doesn't have permission needed to perform the operation {OperationId}.

In de melding staat op de plek van {OperationId} de naam van de actie, bijvoorbeeld deleteEmployeeLeaveRequest. De rest van de koppeling blijft werken. De klant of softwarepartner merkt dit meestal als een synchronisatie die deels mislukt.

Wat te doen bij deze melding

De softwarepartner kan dit niet oplossen. Het recht moet in Nmbrs Payroll worden toegekend, door jouw als accountant of door de beheerder bij de werkgever.

  1. Vraag de softwarepartner om de volledige melding, met de operationId (refereert naar een zogeheten API endpoint).
  2. Zoek de operationId op in het Overzicht benodigde rechten per operationId. Daar staat bij welk onderdeel van Nmbrs Payroll de actie hoort, en of de gebruiker dat moet kunnen lezen of schrijven.
  3. Ga na welke gebruiker de koppeling heeft geautoriseerd.
  4. Kies een van deze oplossingen:
    • Geef die gebruiker in zijn template toegang tot het onderdeel.
    • Laat de koppeling opnieuw autoriseren door een gebruiker die al toegang heeft.
  5. Laat de softwarepartner de synchronisatie opnieuw uitvoeren. De toegang wordt bij elke aanroep opnieuw gecontroleerd, dus de volgende aanroep slaagt direct.

Tip: geef alleen toegang tot de onderdelen die de koppeling nodig heeft. Gebruik bij voorkeur een aparte gebruiker per koppeling, met een rol die past bij wat de koppeling doet.

Ziet de gebruiker de feature wel in Nmbrs Payroll, maar geeft de API toch een 403? Neem dan contact op met Support en vermeld de operationId die wordt meegegeven in de foutmelding. Wij controleren of de instelling van het aangsproken API endpoint klopt.

Benodigde rechten per operationId

Krijgt een koppeling de melding The authorized user doesn't have permission needed to perform the operation {OperationId}? Zoek de operationId dan op in deze tabel. De tabel toont bij welk onderdeel van Nmbrs Payroll de actie hoort, en of de gebruiker die de koppeling heeft geautoriseerd dat onderdeel moet kunnen lezen of schrijven. Geef die gebruiker in zijn rol toegang tot dat onderdeel. Staat de operationId niet in de tabellen? Neem dan contact op met Support.

Wijzigen (PUT)

operationIdOnderdeel in Nmbrs PayrollBenodigde toegang
updateBankAccountEmployee › Personal info › Bank accountSchrijven
updateEmployeeSocialSecurityNumberEmployee › Personal info › Personal infoSchrijven

Verwijderen (DELETE)

operationIdOnderdeel in Nmbrs PayrollBenodigde toegang
deleteEmployeeContractEmployee › Employment › ContractSchrijven
deleteEmployeeEmploymentEmployee › Employment › EmploymentSchrijven
deleteEmployeeHoursEmployee › Salary › Hour componentsSchrijven
deleteEmployeeLeaveRequestEmployee › Leave › LeaveSchrijven
deleteEmployeeWagecomponentEmployee › Salary › Wage componentsSchrijven
deleteEmploymentEndOfServiceDateEmployee › Employment › EmploymentSchrijven

Opvragen (GET)

operationIdOnderdeel in Nmbrs PayrollBenodigde toegang
getPrivateInfosByCompanyEmployee › Personal info › Personal infoLezen

 

Opmerkingen