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:

1. Sign up at overheid.io. Free tier returns test
   data only.
2. Open Netherlands Localization Settings in ERPNext.
3. 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.