Door de koppeling te activeren en autoriseren geef je Nmbrs en BrightPensioen toestemming om gegevens uit te wisselen. In dit artikel leggen we uit wat deze toegang precies inhoudt. Nmbrs heeft haar gegevens ingedeeld in categorieën, die kunnen worden meegenomen of uitgesloten in de toestemming. Ze hanteren de volgende rechten/scopes (ook hier te vinden in de API-documentatie van Nmbrs):

• employee.employment – View and manage employment data: contracts, salary, schedule
• employee.employment.read – View employment data: contracts, salary, schedule
• employee.info – View and manage employee information: personal info, address, family data
• employee.info.read – View employee information: personal info, address, family data
• employee.payment – View and manage payment data: hour components, wage components and cost centers
• employee.payment.read – View payment data: hour components, wage components and cost centers
• employee.leave – View and manage leave and absence information
• employee.leave.read – View leave and absence information
• company.info – View and manage company information
• company.info.read – View company information
• company.payrollsettings.read – View payroll settings: hour codes, wage codes, cost centers and cost units
• company.leave.read – View company leave and absence settings
• employee.orgstructure – View and manage organization structure data: functions, departments, managers
• employee.orgstructure.read – View organization structure data data: functions, departments, managers
• employee.bankaccount.read – View bank account information
• employee.bankaccount – View and manage bank account information
• user.info.read – View user information
• debtor.info.read – View debtor information
• offline_access – Used in the authorization process to receive a refresh token
• employee.document.read – Generate employee documents
• company.document.read – Generate company documents
• document.read – View and download document content
• employee.document – View and manage employee documents
• employee.payrollsettings – View employee payroll settings
• employee.payrollsettings.read – View and manage employee payroll settings

Onderstreepte rechten zijn noodzakelijk voor de koppeling. We leggen hier uit waarom (in chronologische volgorde waarin ze gebruikt worden):

• offline_access
  • De eerste autorisatie/access-token is maar kort geldig. Hiermee kunnen we de autorisatie verlengen met een refresh-token, totdat je de autorisatie intrekt (door de koppeling te deactiveren in het werkgeversportaal).
• company.info.read
  • Hiermee kunnen we met je Nmbrs-bedrijfsnummer je companyId uitlezen, die nodig is voor de volgende stappen.
  • Bij het autoriseren vermeldt als:
    • Company Information – View company information.
• company.payrollsettings.read
  • Hiermee kunnen we de lijst van salarisruns ophalen en voor iedere salarisrun de periode, het type en de payrollRunId zien.
  • Bij het autoriseren vermeldt als:
    • Company Information – View payroll settings: hour codes.
• company.document.read
  • Hiermee kunnen we een (XML-)document laten maken in Nmbrs, van de salarisrun, met alleen doorgegeven looncodes/wageCodes.
  • Bij het autoriseren vermeldt als:
    • Company Information – Generate company documents.
• document.read
  • Hiermee kunnen we die (XML-)documentgegevens ophalen.
  • Bij het autoriseren vermeldt als:
    • Document Information – View and download document content.
• employee.info.read
  • Hiermee kunnen we de lijst van werknemers ophalen en van iedere werknemer het e-mailadres, de naam, het personeelsnummer, extra velden en het dienstverband zien, om ze aan of af te melden bij BrightPensioen.
  • Bij het autoriseren vermeldt als:
    • Employee Information – View employee information: personal info, bank account, address, family data.
• employee.payment.read
  • Hiermee kunnen we ingestelde looncomponenten bij de werknemer in de huidige periode uitlezen. Hierdoor kunnen we eventueel eerder zien dat iemand pensioeninleg heeft, dan te wachten op het aanmaken van de salarisrun.
  • Bij het autoriseren vermeldt als:
    • Employee Information – View payment data: hours, wage components, extra days and cost centers.

Het is met deze toegang niet mogelijk om gegevens aan te passen in Nmbrs. Het zijn enkel read-/leesrechten. Ter info, deze toegang geeft ook de technische mogelijkheid om andere looncodes zoals die van het salaris en persoonlijke gegevens van werknemers zoals BSN en adresgegevens uit te lezen. Daar willen we transparant over zijn. Nmbrs biedt geen kleinere categorieën/scopes om dat verder te uit te sluiten. We doen dit natuurlijk niet, hebben er geen baat bij en zijn ook door de voorwaarden en wetgeving gebonden aan het ophalen, verwerken en bewaren van zo min mogelijk gegevens. Daarnaast zijn onze leden, dus ook werknemers, verplicht om bij de persoonlijke aanmelding dergelijke gegevens (BSN, adres en salarisindicatie) ook door te geven voor het openen van hun rekening en de benodigde wettelijke veiligheidschecks.

Als er nog vragen, opmerkingen of zorgen zijn over de werking of veiligheid van de koppeling, dan horen we graag van je om dat samen aandachtig door te nemen.