Gå til hovedindhold
FirmaAPIFirmaAPI

Brugseksempel: kundeliste

Berig en kundeliste med CVR-data

Har du en eksport fra dit CRM eller økonomisystem med CVR-numre, kan du få navn, adresse, status, branche og antal ansatte på hver række. Et lille Python-script læser din CSV-fil og skriver en ny fil, du kan åbne i Excel eller læse ind igen.

Det skal du bruge

berig_kundeliste.py

Python-script, der tilføjer navn, adresse, status og branche til en CSV-fil.

Download

eksempel-kundeliste.csv

Eksempel på en kundeliste med seks CVR-numre, som du kan prøve scriptsene på.

Download

Du skal også have Python 3.8 eller nyere. Scriptet bruger kun Pythons standardbibliotek, så du skal ikke installere pakker.

Trin for trin

  1. Installér Python. På Windows henter du det fra python.org eller Microsoft Store. På Mac er Python ofte installeret i forvejen. Tjek det med python --version i en terminal (på Mac python3 --version).
  2. Læg filerne i en mappe. Download scriptet og eksempelfilen, og læg dem i samme mappe. Åbn en terminal i mappen: på Windows højreklikker du i mappen og vælger Åbn i Terminal.
  3. Sæt din API-nøgle. Brug test-nøglen første gang. Den giver testdata og bruger ingen opslag. Nøglen gælder kun for det terminalvindue, du sætter den i.

    Windows (PowerShell)

    $env:FIRMAAPI_KEY = "cvr_test_din_test_nøgle"

    Mac og Linux

    export FIRMAAPI_KEY="cvr_test_din_test_nøgle"
  4. Kør scriptet.

    Terminal

    python berig_kundeliste.py eksempel-kundeliste.csv

    Det ser du

    Slår 6 CVR-numre op fra kolonnen 'CVR'...
      1/6 24256790
      2/6 54562519
      ...
    Færdig: 6 af 6 fundet. Gemt i eksempel-kundeliste_beriget.csv
  5. Åbn resultatet. Filen eksempel-kundeliste_beriget.csv kan åbnes direkte i Excel. Den er gemt med UTF-8 og samme skilletegn som din fil, så æ, ø og å står rigtigt.
  6. Kør på din egen liste. Eksportér dine kunder som CSV, skift til din live-nøgle, og kør scriptet med din fil i stedet for eksempelfilen.

Kolonnerne i den nye fil

KolonneFelt i API'et
Navnname
Statusstatus
Adresse, Postnr, Byaddress, zipcode, city
Virksomhedsformcompany_type
Branchekode, Brancheindustry_code, industry_text
Ansatteemployees
Stiftetfounded
OpslagOK, Ikke fundet, Ugyldigt CVR eller Ikke slået op

Store lister: brug batch

Uden batch slår scriptet ét CVR-nummer op ad gangen med en lille pause, så det overholder gratis-planens 2 kald i sekundet. 1.000 kunder tager omkring ti minutter. Har du Basis eller højere, kan du slå op til 100 op i ét kald (200 på Standard og 500 på Professionel), og så tager det samme få sekunder:

Terminal

python berig_kundeliste.py kunder.csv --batch --ud kunder_med_cvr.csv

Er du på Standard eller Professionel, kan du sætte --batch-stoerrelse 200 eller 500.

Den gratis plan har 1.000 opslag om måneden. En liste på 5.000 kunder kræver derfor Basis med 50.000 opslag. Se priser.

Gode råd

  • Gem resultatet og brug det, i stedet for at slå de samme kunder op hver dag. Stamdata ændrer sig sjældent.
  • Vil du vide, når en kunde skifter status, så brug statustjekket eller webhooks.
  • Del aldrig en fil eller et script, hvor din live-nøgle står i klartekst.

Ofte stillede spørgsmål

Hvilket format skal min fil have?

En CSV-fil med en overskrift i første række og en kolonne, hvis navn indeholder CVR, fx CVR, CVR-nummer eller cvr_nr. Semikolon, komma og tabulator som skilletegn virker alle. Gem fra Excel med Filtype CSV UTF-8.

Hvad sker der med mine egne kolonner?

De bliver stående uændret og i samme rækkefølge. Scriptet tilføjer kolonnerne fra FirmaAPI til højre og en kolonne Opslag, der viser OK, Ikke fundet eller Ugyldigt CVR.

Hvor mange opslag bruger scriptet?

Ét pr. unikt, gyldigt CVR-nummer. Dubletter og numre, der ikke er otte cifre, koster ikke noget. Med --batch tæller kun de CVR-numre, der bliver fundet.

Hvad sker der, hvis kvoten slipper op undervejs?

Scriptet stopper og gemmer filen med det, der nåede at blive slået op. De resterende rækker får Ikke slået op i kolonnen Opslag, så du kan køre dem igen senere.

Kan jeg få flere felter med?

Ja. Åbn scriptet i en teksteditor, og tilføj felter i listen FELTER øverst, fx ("phone", "Telefon") eller ("email", "E-mail"). Alle felter står i dokumentationen.

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.