Koppel Nmbrs aan PowerBi

[Theet]

Het koppelen van Nmbrs aan Powerbi kan m.b.v. SoapUI requests. Zorg ervoor dat je eerst een mailadres hebt doorgegeven aan Nmbrs die
gekoppeld wordt aan jouw bedrijfsaccount, je ontvangt van hun een API token die je moet gebruiken om de call te kunnen uitvoeren.

1) Installeer SoapUI op je device

2) Open SoapUi en ga naar bestand "nieuw SOAP project"

3) In de Initial WSDL url vul je het volgende adres in:

Code: Select all

https://api.nmbrs.nl/soap/v3/CompanyService.asmx?WSDL

4) Nu gaan we de salarissen van alle medewerkers ophalen

5) De meeste request zien er zoals hieronder uit:

Code: Select all

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:emp="https://api.nmbrs.nl/soap/v3/EmployeeService">
   <soapenv:Header>
      <emp:AuthHeaderWithDomain>
         <!--Optional:-->
         <emp:Username>[emailadres dat je hebt doorgegeven]</emp:Username>
         <!--Optional:-->
         <emp:Token>[verkregen token van Nmbrs]</emp:Token>
         <!--Optional:-->
         <emp:Domain>?</emp:Domain>  (Domain mag leeg blijven)
      </emp:AuthHeaderWithDomain>
   </soapenv:Header>
   <soapenv:Body>
      <emp:Salary_GetAll_AllEmployeesByCompany>
         <emp:CompanyID>[BedrijfsID om de gegevens van jouw bedrijf te koppelen]</emp:CompanyID>
      </emp:Salary_GetAll_AllEmployeesByCompany>
   </soapenv:Body>
</soapenv:Envelope>

Test in SoapUI of het request werkt door op het groene pijltje linksbovenin te klikken, in het rechterscherm krijg je de uitkomst dat begint met in de eerste regel een "OK":

Code: Select all

HTTP/1.1 200 OK
Date: Mon, 12 May 2025 14:16:33 GMT
Content-Type: text/xml; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Cache-Control: private, max-age=0
Vary: Accept-Encoding
X-Frame-Options: SAMEORIGIN
Server: Nmbrs
Feature-Policy: vibrate 'self' nmbrs.nl
Referrer-Policy: same-origin
Strict-Transport-Security: max-age=31536000; includeSubDomains

Ga naar https://support.nmbrs.com/hc/en-us/arti ... first-call voor de uitleg in het Engels

6) In Powerbi wordt de code als volgt, maak een lege query aan, en klik hier met rechtermuisknop op "Geavanceerde editor"

Code: Select all

"<?xml version=""1.0"" encoding=""utf-8""?>" & 
        "<soapenv:Envelope xmlns:soapenv=""http://schemas.xmlsoap.org/soap/envelope/"" xmlns:emp=""https://api.nmbrs.nl/soap/v3/EmployeeService"">" & 
            "<soapenv:Header>" & 
                "<emp:AuthHeaderWithDomain>" & 
                    "<emp:Username>[emailadres dat je hebt doorgegeven]</emp:Username>" & 
                    "<emp:Token>[verkregen token van Nmbrs]</emp:Token>" & 
                    "<emp:Domain>your_domain</emp:Domain>" & 
                "</emp:AuthHeaderWithDomain>" & 
            "</soapenv:Header>" & 
            "<soapenv:Body>" & 
                "<emp:Salary_GetAll_AllEmployeesByCompany>" & 
                    "<emp:CompanyID>[BedrijfsID om de gegevens van jouw bedrijf te koppelen]</emp:CompanyID>" & 
                "</emp:Salary_GetAll_AllEmployeesByCompany>" & 
            "</soapenv:Body>" & 
        "</soapenv:Envelope>"

Nu is het zaak de query te bewerken en de kolommen los te "klappen" totdat je alle gegevens ziet in de tabel. Je kunt deze methode nu voor alle
tabellen gebruiken, als de test "OK" weergeeft koppel je de tabel in PowerBI