Gå til hovedindhold
FirmaAPIFirmaAPI

Brugseksempel: overvågning

Statustjek: se når en kunde går konkurs

En kunde, der går konkurs med en åben faktura, er dyr. Med et lille script kan du hver uge tjekke alle dine kunder i CVR og få at vide, hvem der har skiftet status siden sidst. Det kræver ingen server, kun en computer, der kan køre en planlagt opgave.

Det skal du bruge

statustjek.py

Python-script, der viser, hvilke kunder der har skiftet status siden sidst.

Download

eksempel-kundeliste.csv

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

Download

Du skal have Python 3.8 eller nyere og en CSV-fil med dine kunders CVR-numre. Har du ikke en, så start med guiden til kundelister, som viser, hvordan du laver og kører scripts.

Trin for trin

  1. Læg scriptet og din kundeliste i en mappe, fx C:\Statustjek. Kolonnen med CVR-numre skal have CVR i navnet.
  2. Kør det første gang. Sæt din nøgle som beskrevet i kundeliste-guiden, og kør python statustjek.py kunder.csv. Scriptet gemmer status for alle kunder og viser dem, der ikke er aktive i dag.

    Første kørsel

    Tjekker 6 kunder...
    Første kørsel: status for 6 kunder er gemt i statustjek_tilstand.json.
  3. Kør det igen senere. Nu sammenligner scriptet med sidste gang og viser kun de kunder, der har skiftet status. Med --rapport rapport.csv får du også ændringerne i en fil.

    Når noget har ændret sig

    Tjekker 6 kunder...
    1 kunder har skiftet status:
      12345678 Eksempel ApS: Aktiv -> Under konkurs
  4. Planlæg kørslen, så den sker af sig selv hver uge. Se næste afsnit.

Kør det automatisk hver uge

På Windows gemmer du nøglen én gang med setx og opretter en opgave i Opgavestyring. Åbn et nyt terminalvindue efter setx, før du opretter opgaven.

Windows: gem nøglen

setx FIRMAAPI_KEY "cvr_live_din_nøgle"

Windows: hver mandag kl. 8

schtasks /Create /TN "FirmaAPI statustjek" /SC WEEKLY /D MON /ST 08:00 /TR "cmd /c cd /d C:\Statustjek && python statustjek.py kunder.csv --rapport rapport.csv"

På Mac og Linux tilføjer du en linje med crontab -e:

cron: hver mandag kl. 8

0 8 * * 1 cd /Users/dig/statustjek && FIRMAAPI_KEY=cvr_live_din_nøgle /usr/bin/python3 statustjek.py kunder.csv --rapport rapport.csv
Scriptet afslutter med kode 2, når en kunde er gået fra Aktiv til en anden status. Kører du det fra et værktøj, der kan sende en besked ved fejl, fx et CI-system eller en overvågningstjeneste, får du en advarsel uden ekstra kode.

Filerne, scriptet laver

FilIndhold
statustjek_tilstand.jsonStatus for hver kunde fra sidste kørsel. Slet den for at starte forfra.
rapport.csvKun med --rapport: CVR, navn, status før og nu og tidspunktet for tjekket.

Når en uge er for lang tid

  • Med webhooks sender FirmaAPI en besked, så snart en virksomhed går konkurs eller skifter status. Det kræver Standard.
  • På Professionel kan webhooken begrænses til dine egne kunder med op til 1.000 CVR-numre, så du kun får beskeder om dem.
  • Kør gerne statustjekket videre som en ekstra sikkerhed, hvis din server har været nede.

Ofte stillede spørgsmål

Hvor ofte skal jeg køre statustjekket?

En gang om ugen er nok for de fleste. Status i CVR ændrer sig sjældent, og en konkurs bliver registreret, når skifteretten har afsagt dekretet. Skal du vide det samme dag, er webhooks bedre.

Hvor mange opslag bruger det?

Ét opslag pr. kunde pr. kørsel uden batch. 200 kunder én gang om ugen er omkring 870 opslag om måneden, hvilket kan ligge på den gratis plan med 1.000 opslag. Med --batch tæller kun de fundne CVR-numre.

Hvad er forskellen på statustjek og webhooks?

Statustjekket spørger med faste mellemrum og kræver kun en computer, der kan køre et script. Webhooks sender en besked til din server, så snart status ændrer sig, men kræver Standard og en server, der kan tage imod beskeden.

Hvilke statusser kan en virksomhed have?

Blandt andet Aktiv, Under konkurs, Under tvangsopløsning, Under rekonstruktion, Opløst efter konkurs, Tvangsopløst, Ophørt og Opløst efter fusion. Alle værdier 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.