CVR System-til-System eller et CVR API?

Hvad er System-til-System?

System-til-System er Erhvervsstyrelsens officielle distribution af CVR-data. Du får et brugernavn og en adgangskode og sender Elasticsearch-forespørgsler til indeksene cvr-permanent/virksomhed, cvr-permanent/produktionsenhed og cvr-permanent/deltager. Svarene indeholder hele historikken for hver virksomhed.

Sådan ser et opslag ud

curl -u "$CVR_USER:$CVR_PASSWORD" \
  -H "Content-Type: application/json" \
  -X POST "http://distribution.virk.dk/cvr-permanent/virksomhed/_search" \
  -d '{
    "query": { "term": { "Vrvirksomhed.cvrNummer": 24256790 } },
    "size": 1
  }'

# Svaret er hele CVR-dokumentet: navne, adresser, deltagere og
# attributter som historiske lister med gyldighedsperioder.

Hvert felt er en liste med gyldighedsperioder. Vil du have det nuværende navn, skal du selv finde den periode, der stadig gælder:

# Find det navn, der gælder i dag, i det rå System-til-System-svar
def current_name(vrvirksomhed):
    for navn in vrvirksomhed["navne"]:
        if navn["periode"]["gyldigTil"] is None:
            return navn["navn"]
    return None

Det samme gælder adresser, branchekoder, status, ansatte og ikke mindst deltagerrelationer, hvor ejere og direktion ligger gemt i flere lag.

Det samme opslag med apicvr.dk

curl https://apicvr.dk/api/v1/24256790

{
  "vat": 24256790,
  "name": "NOVO NORDISK A/S",
  "address": "Novo Allé 1",
  "zipcode": 2880,
  "city": "Bagsværd",
  "status": "NORMAL",
  ...
}

apicvr.dk sender forespørgslen til System-til-System for dig, plukker de gældende værdier ud og returnerer et fladt objekt. Ingen ansøgning, ingen adgangskode.

Hvornår skal du bruge System-til-System selv?

• Du skal bruge historik: tidligere navne, adresser, ejere eller direktører.
• Du skal lave masseudtræk, fx alle virksomheder i en branche eller kommune.
• Du skal bruge felter, som apicvr.dk ikke returnerer.
• Du vil ikke være afhængig af en tredjepart.

Til almindelige opslag i en webshop, et CRM, en onboarding eller et regneark er et færdigt API som apicvr.dk hurtigere at komme i gang med og lettere at vedligeholde.

Ofte stillede spørgsmål