OdooWiki OCA HUB

Integration with Kamer van Koophandel

l10n_nl_kvk folder_open OCA/l10n-netherlands open_in_new
Localization License: AGPL-3

This module integrates Odoo with the official Dutch chamber of commerce Kamer van Koophandel (KvK) API search.

The KvK API service allows lookups by the Chamber Of Commerce Registration Number (KvK field) providing company name, street name, postcode and city. The lookups will be triggered in the partner form views by entering a KvK field and pressing its lookup button. The lookup works also on the company name field, providing Kvk number, street name, postcode and city.

The KvK field is already provided by the OCA module partner_coc. That field is visible when the partner is a Company (flag is_company = true).

More info about the lookup service here: https://developers.kvk.nl/documentation

auto_awesome What this module does

AI-generated from the code · Odoo 12.0

Look up Dutch company details from the Kamer van Koophandel (KvK) directly on the company contact form and fill in name, address, city, zip and KvK number automatically.

This module connects Odoo to the official Dutch chamber of commerce (Kamer van Koophandel) search service so you do not have to type company details by hand.

On a company contact (res.partner), two extra arrow buttons appear next to the company name and the KvK number: "Load values from Name" and "Load values from KvK". They are only shown for companies whose country is the Netherlands; for other countries they stay hidden.

  • Pressing "Load values from KvK" uses the KvK number already entered; if it is empty, Odoo asks you to enter one first.
  • Pressing "Load values from Name" searches by the company name.
  • If nothing is found, Odoo shows a message saying no record was found.
  • If exactly one match is found, the contact is filled in immediately with company name, street, city, zip, country, KvK number, website and VAT.
  • If several matches are found, a "KvK Preview" window opens listing each result with its entity type (legal person, headquarters or branch); you pick the right one with the "Set Partner Fields" button.

Administrators configure the service in Settings: choose the test or live KvK service, set the API key name and value, and optionally a timeout. The module touches res.partner, res.config.settings and adds the KvK preview wizard models.

Depends on

partner_cocbase_setup

Required by other modules

l10n_nl_openkvk
Models and fields (5)
  • res.partner · extends an existing modelis_not_nl_company
  • res.config.settings · extends an existing modell10n_nl_kvk_api_key, l10n_nl_kvk_service (KvK API Service), l10n_nl_kvk_timeout, l10n_nl_kvk_api_value
  • l10n.nl.kvk.api.handler · new model
  • l10n.nl.kvk.preview.wizard · new modelkvk, name, line_ids, partner_id
  • l10n.nl.kvk.preview.wizard.line · new modelkvk, name, wizard_id, country_id (Country), entity_type, partner_vat, partner_zip, partner_city, partner_name, partner_street, partner_website

Text generated by AI (DeepSeek) from reading the Odoo 12.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 1 confirmed, 8 with no information of 9 versions.

Sources · Odoo 12.0

Confirmed on 2026-11-03 in branch 12.0 of OCA/l10n-netherlands.

terminal Installation and usage

OCA documentation · Odoo 12.0

Configuration

Source · Odoo 12.0

Go to the General Settings panel under KvK Integrations and select one of the following:

  • Kamer van Koophandel (TEST)
  • Kamer van Koophandel (KvK API)

The first option can bu used for testing-only purposes and it's free. It allows the lookup on a very limited list of companies. By default this is the service set when the module is installed.

The second option allows to connect to the official KvK API search service. Enter the API key that you requested from the Kamer van Koophandel KvK API.

Usage

Source · Odoo 12.0

Create or edit a partner. If the flag Company is set, the KvK number field is displayed on the form.

If you enter a KvK number and click on the related button on the right, the company name and its address fields are automatically filled.

If you enter a company name and click on the related button on the right, the KvK number and the address fields are automatically filled.

In case the lookup returns more than one record, a popup will be displayed, allowing to select one of the resulting records.

No verified information in OCA: Installation.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.