KvK Lookup

Every Dutch business has a KvK-nummer — the 8-digit registration number assigned by the Kamer van Koophandel (KvK, the Dutch Chamber of Commerce). This module adds a one-click lookup that fetches the company's official details from the KvK registry and populates your Customer or Supplier record.

What gets filled

Click Lookup KvK on a Customer or Supplier form after entering the KvK number, and you'll get:

Legal company name (statutaire naam)
Trading name if different
Registered address (street, postcode, city)
Activity classification (SBI-code)
Founding date and legal form (BV, eenmanszaak, VOF, etc.)
Status (active / dissolved / suspended)

These are written to the corresponding ERPNext fields plus the Customer's or Supplier's primary Address.

Search by name

Don't have the KvK number? Click Search KvK instead and type a partial company name. The dialog shows matching companies; pick one and the form fills in everything including the KvK number.

Configuration

KvK lookup uses the overheid.io OpenKvK API, which resells the official KvK data feed. You need an API key:

Sign up at overheid.io. Free tier returns test data only.
Open Netherlands Localization Settings in ERPNext.
Tick Enable KvK Lookup and paste the API key into the password field. Save.

Pricing

overheid.io charges per lookup tier. As of 2026 the Small plan is around €150/year for 2,500 lookups/month — sufficient for most SMBs that onboard a few new B2B customers per week. Heavier usage requires a higher tier; check overheid.io for current pricing.

Limitations

Dutch businesses only. International customers won't appear; use the EU VIES BTW number validator for those (not part of this module).
Lookups are not stored as full snapshots. If KvK data changes (a trading name update, an address move), you need to re-run the lookup — ERPNext won't notice on its own. Plan a periodic refresh for active customers if the freshness matters for compliance.
Buttons hidden if not configured. If the API key isn't set on Netherlands Localization Settings, the buttons stay hidden — the form doesn't bother you with a feature you can't use.

What about the BTW number?

KvK number ≠ BTW number. The BTW number is issued separately by the Belastingdienst. ERPNext's standard tax_id field is where the BTW number goes; the KvK number lives in the custom_kvk_number field added by this module.

If you need to validate the BTW number against EU VIES, that's a separate feature on the roadmap.