Gå til hovedindhold
FirmaAPIFirmaAPI

Brugseksempel: Excel

Excel-skabelon: CVR-opslag og segmenter

Hent en færdig Excel-fil, der kan to ting: slå dine egne kunder op på CVR-nummer, og finde et segment af virksomheder ud fra branche, område, antal ansatte og meget mere, med en fordeling, der viser, hvor de ligger. Ingen kode, ingen makroer. Excel henter data fra FirmaAPI med Power Query.

Hent skabelonen

firmaapi-cvr-skabelon.xlsx

Excel-skabelon med Power Query: kundeopslag, segmentsøgning og fordeling. Ingen makroer.

Download
ArkDet bruger du det til
VejledningKort forklaring af skabelonen
Kunder og ResultatSkriv CVR-numre, og få stamdata for hver virksomhed
SøgningVælg filtre for dit segment, fx branche, kommune og antal ansatte
SegmentVirksomhederne, der matcher filtrene, med kontaktoplysninger
FordelingSegmentet talt op efter kommune, branche, størrelse eller andet
BrancherAlle branchekoder med navn og antal virksomheder, som du kan søge i
IndstillingerDin API-nøgle

Sådan kommer du i gang

  1. Hent en API-nøgle. Opret en gratis konto, og kopiér din nøgle fra dashboardet. Brug test-nøglen, der starter med cvr_test_, første gang. Den giver testdata og bruger ingen opslag.
  2. Åbn filen, og tillad indhold. Excel åbner filer fra internettet i beskyttet visning. Klik Aktivér redigering, og hvis Excel spørger om eksterne dataforbindelser, så klik Aktivér indhold.
  3. Indsæt nøglen. Gå til arket Indstillinger, og indsæt nøglen i celle B1 i stedet for teksten INDSAET-DIN-API-NOEGLE-HER.
  4. Skriv dine CVR-numre. På arket Kunder står seks eksempler. Overskriv dem, eller indsæt din egen liste i kolonnen CVR. Tabellen vokser automatisk. Mellemrum, bindestreger og DK foran nummeret er fint, de bliver fjernet.
  5. Opdater. Vælg Data og Opdater alle. Første gang spørger Excel om adgang til webindhold: vælg Anonym, og klik Opret forbindelse.
  6. Se resultatet. Arket Resultat viser dine kolonner og data fra CVR for hver række. Næste gang du opdaterer, bliver tallene hentet igen.

Det får du for hver virksomhed

KolonneEksempel
NavnNovo Nordisk A/S
StatusAktiv
Adresse, Postnr, ByNovo Allé 1, 2880 Bagsværd
VirksomhedsformAktieselskab
BrancheFremstilling af farmaceutiske præparater
AnsatteInterval fra CVR, fx 10-19 eller 1000+
Stiftet1931-11-28

Kan et CVR-nummer ikke slås op, står årsagen i kolonnen Status: Ikke fundet, Ugyldigt CVR, Forkert API-nøgle eller For mange opslag, prøv igen.

Find et segment

Arket Søgning har en tabel med filtre. Udfyld dem, du vil bruge, og lad resten stå tomme. Felterne til branche, kommune, region, virksomhedsform, status og ja/nej har rullelister, men du kan også skrive flere værdier adskilt af komma, fx Aarhus,Silkeborg. Rullelisten for branche har de cirka 90 hovedgrupper. Skal du bruge en mere præcis kode, så find den på arket Brancher, hvor du kan filtrere på navn, og skriv den ind, fx 4321 for elinstallation.

FilterEksempelBetyder
Branchekode62 eller 4321,4322Alle virksomheder, hvis branchekode starter sådan
Kommune, Region, PostnummerAarhus, Midtjylland, 8000Hvor virksomheden ligger
VirksomhedsformApS,A/SSelskabsform
Min. og maks. ansatte5 og 49Antal ansatte ifølge CVR
Stiftet efter og før01-01-2024Stiftelsesdato
Min. omsætning5000000Omsætning i seneste regnskab
Har telefon, e-mail, hjemmesideJaKun virksomheder med kontaktoplysningen
ReklamebeskyttetNejNej udelader dem, der har frabedt sig markedsføring

Under tabellen vælger du, hvor mange virksomheder arket Segment højst skal hente (standard 200), og hvad arket Fordeling skal fordele efter: kommune, region, branche, virksomhedsform, antal ansatte, stiftelsesår, postnummer eller status. Fordelingen viser antal og andel med en stang for hver gruppe, så du hurtigt kan se, hvor segmentet ligger.

Hver side med op til 100 virksomheder er ét opslag, og fordelingen er ét opslag. Et segment på 200 virksomheder og en fordeling koster altså tre opslag. Vil du kun opdatere ét ark, så højreklik i tabellen og vælg Opdater i stedet for Opdater alle.

Skal listen bruges til markedsføring, så lad Reklamebeskyttet stå på Nej. Læs mere om reklamebeskyttelse og leadlister.

Tilpas felterne

Vælg Data, Forespørgsler og forbindelser, og dobbeltklik på forespørgslen Virksomheder. Klik Avanceret editor, og ret de to lister øverst. Her er telefon og e-mail tilføjet:

Power Query (M)

Felter = {"name", "status", "address", "zipcode", "city", "company_type", "industry_text", "employees", "founded", "phone", "email"},
Kolonner = {"Navn", "Status", "Adresse", "Postnr", "By", "Virksomhedsform", "Branche", "Ansatte", "Stiftet", "Telefon", "E-mail"},

Listerne skal have lige mange elementer. Feltnavnene til venstre står i dokumentationen, og navnene til højre bestemmer du selv.

Brug forespørgslen i din egen projektmappe

Har du allerede en projektmappe, du vil bruge, kan du hente forespørgslen som tekst og sætte den ind selv:

firmaapi-cvr-opslag.pq

Power Query-koden fra skabelonen, hvis du vil bruge den i din egen projektmappe.

Download
  • Lav en tabel med kolonnen CVR, og giv den navnet Cvrliste under Tabeldesign.
  • Giv cellen med din nøgle navnet ApiNoegle under Formler og Definer navn.
  • Vælg Data, Hent data, Fra andre kilder og Tom forespørgsel. Åbn Avanceret editor, og indsæt indholdet af filen.
I din egen projektmappe kan Excel vise en fejl om privatlivsniveauer (Formula.Firewall), fordi forespørgslen bruger data fra arket i en webadresse. Skabelonen er sat op, så det ikke sker. I din egen fil retter du det under Data, Hent data, Forespørgselsindstillinger, Aktuel projektmappe og Beskyttelse af personlige oplysninger.

Mange rækker

Skabelonen laver ét opslag pr. række med en lille pause imellem, så den holder sig under gratis-planens grænse på 2 kald i sekundet. 500 rækker tager derfor omkring fem minutter. Har du Basis eller højere, er batch-opslag hurtigere: op til 100 CVR-numre i ét kald. Se batch i Power Query, eller brug scriptet til kundelister.

Ofte stillede spørgsmål

Virker skabelonen på Mac?

Skabelonen er lavet og testet i Excel til Windows (Microsoft 365). Nyere versioner af Excel til Mac kan opdatere Power Query-forespørgsler fra internettet, men det har vi ikke testet. Google Sheets er et godt alternativ på Mac.

Hvorfor spørger Excel om adgang til firmaapi.dk?

Excel spørger, første gang en forespørgsel henter data fra en ny adresse. Vælg Anonym. Din API-nøgle sendes i en header fra forespørgslen og ikke som login, så Excel skal ikke gemme nogen adgangskode.

Hvor mange opslag bruger en opdatering?

Kundeopslaget bruger ét opslag pr. række. Segmentet bruger ét opslag pr. 100 virksomheder, og fordelingen ét (to, hvis du fordeler efter branche). Med 1.000 gratis opslag om måneden rækker det langt, hvis du opdaterer det enkelte ark i stedet for Opdater alle. Test-nøglen bruger ingen opslag.

Excel siger, at legitimationsoplysningerne er ugyldige. Hvad gør jeg?

Det betyder, at API-nøglen i arket Indstillinger er forkert eller ikke er sat ind. Ret nøglen, og opdater igen. Bliver fejlen ved, så åbn Data, Hent data, Indstillinger for datakilde, vælg firmaapi.dk, og ryd tilladelserne. Næste gang vælger du Anonym.

Kan jeg bruge andre filtre end dem på arket Søgning?

Ja. Tilføj en række i tabellen Filtre med navnet på parameteren i kolonnen Parameter, fx age_min, region_list eller has_financials. Alle parametre til den avancerede søgning står i dokumentationen.

Kan jeg få flere felter med, fx telefon og e-mail?

Ja. Åbn forespørgslen, og tilføj feltnavnene i listerne Felter og Kolonner, fx phone og email. Alle felter står i dokumentationen under virksomhedsopslag.

Indeholder filen makroer?

Nej. Skabelonen er en almindelig .xlsx-fil med en Power Query-forespørgsel. Excel kan vise en sikkerhedsadvarsel om eksterne dataforbindelser, første gang du åbner den. Det er forespørgslen, der beder om lov til at hente data.

Prøv det med din egen API-nøgle

Opret en gratis konto, og hent din API-nøgle med det samme. Intet kreditkort kræves.