De volgende stappen dienen gedaan te worden in "Nmbrs" om de koppeling tot stand te brengen. Dit kan alleen uitgevoerd worden door een Nmbrs-gebruiker met de juiste rechten.
1 Gebruiker aanmaken
In Nmbrs dient een gebruiker aangemaakt te worden die voldoende rechten heeft om de dienstverbandgegevens en verzuimgegevens te mogen ophalen.
Ga hiervoor naar INSTELLINGEN → GEBRUIKERACCOUNTS → LOGINS
Klik op NIEUW ACCOUNT om een nieuwe gebruiker aan te maken.
2 API Token aanmaken
Als de gebruiker is aangemaakt die hij een API-token te krijgen. Met deze token kan CompuCase via de API de gegevens ophalen.
Ga naar het INSTELLINGEN → GEBRUIKERACCOUNTS → LOGINS en bij de zojuist aangemaakte gebruiker klik op het plusje onder "Api token" om de token te genereren.
3 API Rechten instellen
Per Type Gebruiker kan worden ingesteld welke API requesten hij mag doen.
Ga hiervoor naar INSTELLINGEN → GEBRUIKERACCOUNTS → TEMPLATE USERS.
Vervolgens klik je bij de juiste template op API bewerken en daar kunnen de instellingen gedaan worden.
Vervolgens moet er per Webservice aangegeven worden welke Method aangeroepen mag worden.
Op dit moment hebben wij de volgend Methods nodig, maar het kan zijn dat dit in de toekomst meer worden dus hoe meer rechten hoe zeker het is dat de koppeling ook in de toekomst blijft werken.
Algemeen | |
Webservice | Method |
|---|---|
CompanyService | List_GetAll |
CompanyService | Company_GetCurrentPeriod |
DebtorService | List_GetAll |
Bedrijfsonderdelen synchroniseren | |
Webservice | Method |
DebtorService | Department_GetList |
Dienstverbanden synchroniseren | |
Webservice | Method |
EmployeeService | Employment_GetAll_AllEmployeesByCompany |
EmployeeService | PersonalInfo_GetAll_AllEmployeesByCompany |
EmployeeService | Address_GetAll_AllEmployeesByCompany |
EmployeeService | Contract_GetAll_AllEmployeesByCompany |
EmployeeService | Function_GetAll_AllEmployeesByCompany |
EmployeeService | Department_GetAll_AllEmployeesByCompany |
EmployeeService | Schedule_GetAll_AllEmployeesByCompany |
EmployeeService | Salary_GetAll_AllEmployeesByCompany |
EmployeeService | List_GetByCompany |
EmployeeService | PersonalInfo_GetCurrent |
EmployeeService | Address_GetListCurrent |
EmployeeService | Contract_GetCurrentPeriod |
EmployeeService | Function_GetCurrent |
EmployeeService | Manager_GetCurrent |
EmployeeService | Department_GetCurrent |
EmployeeService | Schedule_GetCurrent |
EmployeeService | Salary_GetCurrent |
Verzuimen synchroniseren | |
Webservice | Method |
EmployeeService | Absence_GetAll_AllEmployeesByCompany |
EmployeeService | Absence2_GetList |
4 Gegevens doorgeven aan CompuCase
Om de koppeling in te stellen hebben wij de volgende gegevens nodig:
De gebruikersnaam van de in stap 1 aangemaakte gebruiker.
De API token die in stap 2 is gegenereerd.
Het nummer van de werkgever(s) waarvan de gegevens geïmporteerd moeten worden naar CompuCase.
Klik links in het menu op EXPLORER en dan wordt een lijstje getoond met werkgevers met daarachter het nummer.
De URL van de Nmbrs applicatie (BEDRIJF.nmbrs.nl). Dit is waar je in de browser naar toe gaat om in te loggen in Nmbrs.
DebiteurID binnen Nmbrs. Let op dit is dus niet het DebiteurNummer maar het ID wat onderwater wordt gebruikt. Deze hebben we nodig voor de requesten naar de DeptorService, en deze wordt gebruikt voor het ophalen van de bedrijfsonderdelen (departments).
Als de aangemaakte gebruiker voor de API genoeg rechten heeft dan kan ik het ID via de API achterhalen, maar als dat niet het geval is dat zal de Nmbrs klant het ID moeten achterhalen.
Heb bij Nmbrs gevraagd of en hoe dit mogelijk is via de applicatie en heb daarbij de volgende uitleg gekregen:
Uitleg Nmbrs:
Voor iemand die toegang heeft tot debiteur niveau is het ook op te vragen binnen de omgeving.
Met de rechtermuisknop klik je ergens in de omgeving en kies voor inspect. Vervolgens kan je linksboven van het popupscherm (zie afbeelding) klikken en vervolgens op de debiteur. Vervolgens kan je aflezen wat het ID is.
Op deze pagina: