Países Baixos KVK — realidade pós-KVK-API-2024 / guia do desenvolvedor

O registro de empresas dos Países Baixos — Kamer van Koophandel (KVK) — mudou silenciosamente a forma como os desenvolvedores acessam dados corporativos quando a modernizada KVK Open Data API se tornou a interface de máquina canônica. O nível de dados abertos agora expõe uma fatia limitada, mas em tempo real, do Handelsregister: data de início da atividade, forma legal, códigos de atividade e as últimas contas anuais adotadas.

A principal restrição é intencional: o nível gratuito remove informações pessoalmente identificáveis. Nomes de empresas, endereços, diretores, acionistas e UBOs não são retornados. Essas superfícies permanecem atrás de extratos de registro pagos ou canais com restrições de AML.

Para desenvolvedores que constroem ferramentas de conformidade, pipelines de pesquisa ou agentes de IA, o resultado é incomum: os Países Baixos publicam uma superfície de API tecnicamente limpa, mas os identificadores mais reconhecíveis são removidos. A integração, portanto, gira em torno do número KVK de 8 dígitos em vez de nomes de empresas.

O que o registro realmente expõe

A fonte de dados oficial é a interface KVK Open Data em opendata.kvk.nl. OpenRegistry proxy a superfície pública via ferramentas MCP.

Características importantes da API upstream:

• Identificador: número kvkNummer de 8 dígitos
• Capacidade de pesquisa: nenhuma no nível gratuito
• Formatos: JSON para metadados de perfil, árvores JSON derivadas de XBRL para financeiros
• Limites de taxa:
  • Perfil básico da empresa: ~100 solicitações / 5 minutos
  • Contas anuais: ~1 solicitação / minuto

A superfície do OpenRegistry expõe as seguintes capacidades para os Países Baixos:

Essa assimetria é deliberada: os Países Baixos tratam o feed de dados abertos como uma interface de divulgação estatística e financeira, não como uma exportação completa do registro corporativo.

O que está atrás de paywall ou restrito

Os desenvolvedores rapidamente descobrem que a maior parte dos metadados reconhecíveis da empresa está restrita.

As seguintes superfícies não estão presentes na API aberta:

• nome da empresa
• nomes comerciais
• endereço completo
• diretores e executivos
• registros de acionistas
• UBO / propriedade benéfica
• extratos completos do registro

Para obter esses campos, você deve usar um dos canais pagos:

• Digitaal uittreksel (extrato digital) comprado por empresa
• Assinatura REST do Handelsregister (~€6,40/mês + €0,02 por solicitação)

Essas interfaces pagas não são proxy pelo OpenRegistry.

Para dados relacionados a AML, as restrições são ainda mais fortes. O registro UBO holandês é acessível apenas a entidades obrigadas, como bancos, notários, auditores e autoridades policiais.

Peculiaridades específicas do país

Os integradores quase sempre encontram os mesmos casos extremos específicos dos Países Baixos.

1. Sem pesquisa por nome na API gratuita

O nível de dados abertos requer um número KVK conhecido. Pesquisar por nome da empresa retorna um erro 501.

Fluxo de trabalho típico:

1. Use o portal EU BRIS ou outro registro para descobrir o número KVK
2. Consulta o endpoint de dados abertos usando o número

2. O nome da empresa está intencionalmente em branco

A especificação HVDS (conjunto de dados de alto valor) remove deliberadamente PII. Como resultado, company_name está vazio mesmo para empresas bem conhecidas.

Isso não é um bug — é uma decisão de design legal sob as regras de privacidade holandesas.

3. Apenas formas legais BV e NV estão incluídas

O conjunto de dados gratuito foca nas duas principais estruturas comerciais:

• BV — Besloten Vennootschap (sociedade limitada privada)
• NV — Naamloze Vennootschap (sociedade anônima)

Outras formas de entidade aparecem apenas através das interfaces de registro pagas.

4. Filings financeiros retornam uma única árvore XBRL

Diferente de muitos registros, o feed holandês expõe apenas as contas anuais mais recentes adotadas. Filings históricos não são retornados.

A estrutura da resposta é uma árvore de conceito XBRL aninhada onde campos financeiros como:

• Assets
• Equity
• NetResultAfterTax
• CashAndCashEquivalents

aparecem como nós folha dentro de seções como BalanceSheet ou IncomeStatement.

Exemplo prático: ASML Holding N.V.

Uma empresa holandesa bem conhecida com o número KVK 17085815 é a fabricante de semicondutores ASML Holding N.V..

Exemplo de solicitação MCP:

get_company_profile
{
  "jurisdiction": "NL",
  "company_id": "17085815"
}

Campos típicos retornados:

{
  "datumAanvang": "19840401",
  "actief": "J",
  "rechtsvormCode": "NV",
  "postcodeRegio": "55",
  "activiteiten": [
    { "sbiCode": "26110", "soortActiviteit": "Hoofdactiviteit" }
  ],
  "lidstaat": "NL"