KvK Connector

Category: Connectors
Subcategory: Connectors

Overview

This connector enables you to quickly connect to the APIs of the Kamer van Koophandel, the Dutch Chambre of Commerce. It contains microflow actions to connect to their Search and Basic Profile APIs.

Documentation

Description

The connector has a module containing a plug-and-play integration with the Kamer van Koophandel, the Dutch Chambre of Commerce.

Typical usage scenario

You can use this app service when you want to determine the KvK number of a Dutch company based on its name or the other way around. You can also use it to gather more information about the company such as its address, the sbi activities and the legal form of the company owner. 

Features and limitations

  1. Search: based on options such as the KvK number and name of the company, the connector will connect to the KvK’s Search API and will give you the KvK number, RSIN, Establishment Number, Establishment Name, Street, City, Type and Expired Name of the company or companies that meet your search criteria.  

  2. Basic Profile: based on the KvK number, the connector will connect to the KvK’s Basic Profile API and will give you an extended list of information about the company with that KvK number. 

Dependencies

  • Mendix 9.12.1 or higher

Installation

To install this module, follow these steps (that can also be found in the Read me of the module): 

  1. Make sure you have the right credentials to use this API, i.e. a working API key. 

  2. Use the APIKey you get to configure constant "KVKConnector.APIKey". 

  3. Now configure the correct URL for constant "KVKConnector.Endpoint".  

  4. Finally, add the right certificate to the project. This certificate can be retrieved by opening the URL in Chrome and exporting the certificate there. More information about adding certificates in Mendix can be found here: https://docs.mendix.com/developerportal/deploy/certificates/#outgoing-client-certificates 

Configuration

You can build the Search request using the RequestSearch from the module. The attributes are described in their documentation. The Basic Profile REST call is done purely based on the KvK Number and therefore no extra configuration is needed.

Releases

Version: 1.0.0
Framework Version: 9.12.1
Release Notes: Initial release