Hvilken ejendom holder virksomheden til på?

Kæden: CVR → adresse → ejendom

1. 1

   Slå virksomheden op

   /v1/cvr/:cvr giver navn, status, virksomhedsform, hovedbranche og beliggenhedsadressen. Kender du kun navnet, finder /v1/cvr/search CVR-nummeret først.

2. 2

   Vask adressen mod DAR

   Send virksomhed.adresse.betegnelse til /v1/datavask/adgangsadresser. Svaret er rangerede kandidater med en sikkerhed (kategori A, B eller C) og hver kandidats adgangsadresse_id og bfe_nummer.

3. 3

   Hent ejendommen

   Er matchet sikkert, sender du kandidatens bfe_nummer til /v1/bbr/ejendom/:bfe og får bygningerne, enhederne og vurderingen.

{
  "vejnavn": "Dortheavej",
  "husnr": "10",
2  "etage": null,
2  "doer": null,
  "postnr": "2400",
  "postnrnavn": "København NV",
1  "betegnelse": "Dortheavej 10, 2400 København NV",
3  "kommunekode": "0101",
3  "kommune_navn": "København",
3  "regionskode": "1084",
3  "region_navn": "Region Hovedstaden"
}

Koden

# 1) Virksomheden
curl "https://api.grundfast.dk/v1/cvr/20213094" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

# 2) Vask beliggenhedsadressen
curl -G "https://api.grundfast.dk/v1/datavask/adgangsadresser" \
  --data-urlencode "betegnelse=Dortheavej 10, 2400 København NV" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

# 3) Ejendommen på kandidatens bfe_nummer (her 6022499)
curl "https://api.grundfast.dk/v1/bbr/ejendom/6022499" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Stol på A, kig på B og C

Datavasken sammenligner strengen med alle adgangsadresser og rangerer kandidaterne efter lighed. A er et sikkert match, B sandsynligt og C usikkert. Læs antal først: C med antal: 0 betyder, at intet matchede. En CVR-adresse er tastet ind af virksomheden selv og kan være forkortet, gammel eller stavet anderledes, så regn med, at en del af en større liste lander i B og C.

Bemærk også, at kandidaten er en adgangsadresse: vej, husnummer og postnummer. Har virksomheden etage og dør i CVR, finder du den præcise enhed i bygningen, som beskrevet i Hvilke boliger og lokaler er der på adressen?.

Fra navn til CVR-nummer

Har du kun virksomhedens navn, så find CVR-nummeret med /v1/cvr/search. Hvert hit er et resumé med cvr_nummer, navn, status, virksomhedsform og kommune — nok til at vælge den rigtige, men ikke adressen. Den henter du med det fulde opslag på cvr_nummer.

const { results } = await gf.cvrSearch('lagkagehuset', 5);
const aktiv = results.find((r) => r.status === 'aktiv');
if (aktiv) {
  const { virksomhed } = await gf.cvr(aktiv.cvr_nummer);
  console.log(virksomhed.navn, virksomhed.adresse.betegnelse);
}

Filtrér på status. En ophørt virksomhed har stadig en adresse i CVR, men det er den sidst registrerede, og der kan sagtens bo en anden i dag. Kobler du en ophørt virksomhed på en ejendom, så gem status og ophoersdato med koblingen, så ingen senere tror, at virksomheden stadig holder til der.

En hel liste af virksomheder

Har du hundredvis af virksomheder, så vask adresserne med POST /v1/datavask/adgangsadresser:batch, som tager op til 50 adresser pr. kald og svarer i samme rækkefølge. Ejendommene henter du derefter med POST /v1/bbr/ejendom:batch. Begge kræver Pro. Et batch-kald tæller stadig én enhed pr. adresse eller BFE, men du sparer forespørgslerne — se Spar på kald.

Persondata og markedsføring

For en enkeltmandsvirksomhed er navn og beliggenhedsadresse ofte ejerens egne oplysninger — tit hans eller hendes bopæl. Grundfast henter ikke CVR’s personregister, men du skal selv have et lovligt grundlag for at behandle oplysningerne. Bruger du listen til markedsføring, så respektér reklamebeskyttet; null betyder ukendt, ikke "må gerne". Telefon og e-mail udfyldes kun, når virksomheden positivt er registreret som ikke reklamebeskyttet, og er ellers null.