Sådan beriger du dit CRM med CVR-data

Har du en kundeliste med CVR-numre, men mangler virksomhedsnavne, adresser eller brancheoplysninger? Her gennemgår vi vejen fra en CVR-kolonne til en CSV-fil, du kan gennemgå og importere i dit CRM. Bagefter kan du bruge samme API-kald i din egen integration.

Vil du først afprøve forbindelsen? Kør et gratis testopslag på vores CVR API-side, eller hent et kørbart Node.js-eksempel.

Du kan læse hele guiden og eksemplerne uden login. Den interaktive guide i dashboardet kræver en konto og lader dig slå op til 20 virksomheder op ad gangen. Batch er inkluderet i Basic-prøven samt Basic og Pro. Efter prøven kræver batch et betalt abonnement; se planer og priser.

1. Klargør en lille liste med CVR-numre

Start med 2–20 virksomheder fra dit CRM. Kopiér kun CVR-kolonnen, uden overskrift, kundenavne eller øvrige kontaktdata. Hvert nummer skal have otte cifre; i dashboardet kan du adskille dem med linjeskift, komma eller semikolon. Dubletter fjernes før opslaget.

Hvis du kun har et firmanavn, kan du først finde virksomhedens CVR-nummer. Brug CVR som matchfelt, når du senere fører oplysningerne tilbage til CRM'et, så virksomheder med lignende navne ikke blandes sammen.

2. Hent oplysningerne i dashboardet

Vælg Prøv med dine data, opret en konto eller log ind, og fortsæt til Dashboard → Integration. Her kan du oprette en API-nøgle eller indsætte en, du allerede har. Indsæt CVR-numrene, og start batch-opslaget.

Guiden viser resultatet for hvert nummer. Du får virksomhedsnavn, status, adresse og branche, når oplysningerne findes. De normale kvoter og grænser for API-kald gælder også her; én batch er ikke ét gratis opslag på alle virksomhederne.

3. Gennemgå resultatet, før du importerer

Et svar kan indeholde både fundne virksomheder, numre der ikke blev fundet, og opslag der fejlede. Her er et forenklet eksempel med opdigtede numre og virksomhedsdata — ikke et aktuelt CVR-opslag:

• Gennemgå status og manglende felter, før du opdaterer kundekort.
• Lad et manglende resultat blive til manuel kontrol, så du ikke overskriver eksisterende CRM-data med tomme felter.
• Hvis kvoten eller minutgrænsen stopper batchen, viser dashboardet de resterende numre. Vent ved en minutgrænse, eller kontrollér abonnementets kvote, før du prøver resten igen.

4. Hent CSV, og match felterne i dit CRM

Download CSV-filen fra dashboardet. Filen bruger semikolon som separator og indeholder CVR, virksomhed, status, adresse, branchekode, branche, reklamebeskyttelse og resultat. Her er samme opdigtede eksempel i CSV-format:

"CVR";"Virksomhed";"Status";"Adresse";"Branchekode";"Branche";"Reklamebeskyttet";"Resultat"
"12345678";"Eksempel ApS";"ACTIVE";"Eksempelvej 1, 8000 Aarhus C";"";"";"Ukendt";"Fundet"
"87654321";"";"";"";"";"";"Ukendt";"Ikke fundet"

Vælg CRM'ets importfunktion, og match CVR-kolonnen med dit eksisterende CVR-felt. Kontrollér, hvordan systemet håndterer dubletter og tomme felter, og prøv først med nogle få rækker. Branchefelter kan være tomme, og reklamebeskyttelse kan være ukendt.

Guiden leverer en fil til import. Den opretter ikke automatisk en forbindelse til dit CRM eller en løbende synkronisering.

5. Automatisér med samme batch-endpoint

Når du har afprøvet felterne, kan din backend sende en liste af CVR-numre til POST /api/v1/company/batch. Sæt din API-nøgle som miljøvariablen CVR_API_KEY på serveren, og erstat de to opdigtede numre nedenfor med rigtige CVR-numre fra din liste:

curl -X POST 'https://cvrlookup.dk/api/v1/company/batch' \
  -H "Authorization: Bearer $CVR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"cvrs":["12345678","87654321"]}'

API'et returnerer JSON; CSV-filen ovenfor dannes af dashboardguiden. I din egen integration læser du data.results og kontrollerer hvert elements found og error, før du bruger company. Kontrollér også stoppedReason og quotaExhausted, så et delvist svar ikke behandles som en færdig synkronisering.

Opbevar nøglen på serveren, og håndtér HTTP-fejl, før du behandler resultaterne. Se feltbeskrivelser, grænser og svarformat i batch-dokumentationen.

Prøv arbejdsgangen på din egen kundeliste

Start med nogle få CVR-numre, kontrollér resultatet, og hent din første CSV. Du bliver sendt videre til integrationsguiden efter login. Har du allerede en konto uden batch-adgang, viser guiden, hvordan du vælger Basic.