Virksomhedsindsats.VirksomhedService (Version 2, 2024-4)
Siden opdateres automatisk til at afspejle koden.
Metoder
- 1 GetVirksomhed (GET /v2/Virksomhed/{cvrNummer})
- 2 GetLogo (GET /v2/Virksomhed/{cvrNummer}/logo)
- 3 SetLogo (PUT /v2/Virksomhed/{cvrNummer}/logo)
- 4 DeleteLogo (DELETE /v2/Virksomhed/{cvrNummer}/logo)
- 5 GetLaasehistorik (GET /v2/Virksomhed/{cvrNummer}/laasehistorik)
- 6 SetLaas (PUT /v2/Virksomhed/{cvrNummer}/laas)
- 7 DeleteLaas (DELETE /v2/Virksomhed/{cvrNummer}/laas)
- 8 SoegVirksomheder (GET /v2/Virksomhed/soeg)
GetVirksomhed (GET /v2/Virksomhed/{cvrNummer})
Finder en virksomhed.
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
virksomhedsindsats.virksomhed.read
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
cvrNummer [Path] | string | Pattern: [0-9]{8} | 1 |
|
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
response | GetVirksomhedResponseDto |
| 1 |
|
- virksomhed | VirksomhedDto |
| 1 | Virksomhed. |
- - cvrNummer | string | Pattern: [0-9]{8} | 1 | CVR-nummer. |
- - navn | string |
| 0 - 1 | Navn på virksomheden (fra CVR). |
- - url | string |
| 0 - 1 | URL (fra CVR). |
- - emailadresse | string |
| 0 - 1 | E-mailadresse (fra CVR). |
- - telefonnummer | string |
| 0 - 1 | Telefonnummer (fra CVR). |
- - laas |
| 0 - 1 |
| |
- - logo | base64Binary |
| 0 - 1 | Logo i et formaterne: PNG, JPEG (base64). |
- - adresse | AdresseDto |
| 0 - 1 | Adresse for virksomhed. |
- - - vejnavn | string |
| 0 - 1 | Vejnavn (fra CVR). |
- - - husnummer | string |
| 0 - 1 | Husnummer (fra CVR). |
- - - etage | string |
| 0 - 1 | Etagebetegnelse (fra CVR). |
- - - sidedoer | string |
| 0 - 1 | Side-/dørbetegnelse (fra CVR). |
- - - bynavn | string |
| 0 - 1 | Bynavn (fra CVR). |
- - - postnummer | string | Pattern: [0-9]{4} | 0 - 1 | Postnummer (fra CVR). |
- - - kommunenummer | int32 | Pattern: [0-9]{3} | 0 - 1 | Kommunenummer (fra CVR). |
- - - landekode | string | Pattern: [a-z,A-Z]{2}|[a-z,A-Z]{3}|[0-9]{3}|[0-9]{4} | 0 - 1 | Landekode (fra CVR).
|
- - lukket | boolean |
| 1 | Om virksomheden er lukket (fra CVR). |
- - oprettetTidspunkt | date-time |
| 1 | Tidspunkt for oprettelse. |
- - opdateretTidspunkt | date-time |
| 1 | Tidspunkt for seneste opdatering. |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
120500 | Virksomheden blev ikke fundet. | Virksomheden blev ikke fundet. |
GetLogo (GET /v2/Virksomhed/{cvrNummer}/logo)
Finder en virksomheds logo.
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
virksomhedsindsats.virksomhed.read
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
cvrNummer [Path] | string | Pattern: [0-9]{8} | 1 |
|
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
response | GetLogoResponseDto |
| 1 |
|
- logo | base64Binary | MinLength: 1 | 1 | Logo i et formaterne: PNG, JPEG (base64). |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
120500 | Virksomheden blev ikke fundet. | Virksomheden blev ikke fundet. |
120505 | Logoet blev ikke fundet. | Logoet blev ikke fundet. |
SetLogo (PUT /v2/Virksomhed/{cvrNummer}/logo)
Sætter en virksomheds logo.
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
virksomhedsindsats.virksomhed.write
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
cvrNummer [Path] | string | Pattern: [0-9]{8} | 1 |
|
x-requestId [Header] | string |
| 1 | Unikt id for requestet (typisk guid). Hvis api'et modtager samme requestId mere end én gang returneres http status kode 412. Max længde for id'et er 46 chars |
requestBody | SetLogoRequestDto |
| 1 |
|
- logo | base64Binary | MinLength: 1 | 1 | Logo i et formaterne: PNG, JPEG (base64). |
Output
Intet output
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
4575 | Du er ikke autoriseret til at udføre denne handling | Du er ikke autoriseret til at udføre denne handling |
120500 | Virksomheden blev ikke fundet. | Virksomheden blev ikke fundet. |
120506 | Ugyldig billedtype. Skal være PNG eller JPEG. | Ugyldig billedtype. Skal være PNG eller JPEG. |
120507 | Størrelsen på billedet skal være mindre end 200x200px. | Størrelsen på billedet skal være mindre end 200x200px. |
120508 | Filstørrelsen på billedet skal være mindre end 100kB. | Filstørrelsen på billedet skal være mindre end 100kB. |
DeleteLogo (DELETE /v2/Virksomhed/{cvrNummer}/logo)
Sletter en virksomheds logo.
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
virksomhedsindsats.virksomhed.write
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
cvrNummer [Path] | string | Pattern: [0-9]{8} | 1 |
|
x-requestId [Header] | string |
| 1 | Unikt id for requestet (typisk guid). Hvis api'et modtager samme requestId mere end én gang returneres http status kode 412. Max længde for id'et er 46 chars |
Output
Intet output
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
4575 | Du er ikke autoriseret til at udføre denne handling | Du er ikke autoriseret til at udføre denne handling |
120500 | Virksomheden blev ikke fundet. | Virksomheden blev ikke fundet. |
120505 | Logoet blev ikke fundet. | Logoet blev ikke fundet. |
GetLaasehistorik (GET /v2/Virksomhed/{cvrNummer}/laasehistorik)
Henter låsehistorik for en virksomhed.
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
virksomhedsindsats.virksomhed.laas.read
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
cvrNummer [Path] | string | Pattern: [0-9]{8} | 1 |
|
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
response | GetLaasehistorikResponseDto |
| 1 |
|
- historikresultater | LaasehistorikDtoCollection |
| 1 | Låsehistorik for virksomhed. |
- - LaasehistorikDto | LaasehistorikDto |
| 0 - * |
|
- - - laas |
| 0 - 1 |
| |
- - - aarsag | string | Length: 1-500 | 1 | Årsag til at ændringen er lavet. |
- - - bruger | string | MinLength: 1 | 1 | Bruger som lavede ændringen. |
- - - oprettetTidspunkt | date-time |
| 1 | Tidspunkt for oprettelse. |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
120500 | Virksomheden blev ikke fundet. | Virksomheden blev ikke fundet. |
SetLaas (PUT /v2/Virksomhed/{cvrNummer}/laas)
Sætter lås på en virksomhed.
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
virksomhedsindsats.virksomhed.laas.write
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
cvrNummer [Path] | string | Pattern: [0-9]{8} | 1 |
|
x-requestId [Header] | string |
| 1 | Unikt id for requestet (typisk guid). Hvis api'et modtager samme requestId mere end én gang returneres http status kode 412. Max længde for id'et er 46 chars |
requestBody | SetLaasRequestDto |
| 1 |
|
- laas |
| 1 |
| |
- aarsag | string | Length: 1-500 | 1 | Årsag til at ændringen er lavet. |
Output
Intet output
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
4575 | Du er ikke autoriseret til at udføre denne handling | Du er ikke autoriseret til at udføre denne handling |
2002 | Invalid CodeList value | Invalid CodeList value |
120500 | Virksomheden blev ikke fundet. | Virksomheden blev ikke fundet. |
DeleteLaas (DELETE /v2/Virksomhed/{cvrNummer}/laas)
Sletter lås på en virksomhed.
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
virksomhedsindsats.virksomhed.laas.write
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
cvrNummer [Path] | string | Pattern: [0-9]{8} | 1 |
|
aarsag [Query] | string | MaxLength: 500 | 1 | Årsag til at ændringen er lavet. |
x-requestId [Header] | string |
| 1 | Unikt id for requestet (typisk guid). Hvis api'et modtager samme requestId mere end én gang returneres http status kode 412. Max længde for id'et er 46 chars |
Output
Intet output
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
4575 | Du er ikke autoriseret til at udføre denne handling | Du er ikke autoriseret til at udføre denne handling |
120500 | Virksomheden blev ikke fundet. | Virksomheden blev ikke fundet. |
120602 | Der blev ikke fundet en lås på virksomheden. | Der blev ikke fundet en lås på virksomheden. |
SoegVirksomheder (GET /v2/Virksomhed/soeg)
Fremsøger virksomheder ud fra parametre. Returnerer maks 100 søgeresultater.
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
virksomhedsindsats.virksomhed.read
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
navn [Query] | string | MinLength: 3 | 0 - 1 | Del af virksomhedens navn. |
cvrNummer [Query] | string | Pattern: [0-9]{3,8} | 0 - 1 | Del af virksomhedens CVR-nummer. |
inkluderLaase [Query] | VirksomhedslaasTypeCodeListCollection |
| 0 - 1 | Inkluder virksomheder med angivne låsetyper.
|
- VirksomhedslaasTypeCodeList |
| 0 - * |
| |
inkluderLukkede [Query] | boolean |
| 0 - 1 | Inkluder lukkede virksomheder i søgeresultatet.
|
sidestoerrelse [Query] | int32 | MinInclusive: 1 | 0 - 1 | Det maksimale antal returnerede søgeresultater.
|
sidenummer [Query] | int32 | MinInclusive: 1 | 0 - 1 | Sidenummer definerer hvilken side i resultatsættet, der returneres.
|
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
response | SoegVirksomhederResponseDto |
| 1 |
|
- soegeresultater | VirksomhedDtoCollection |
| 1 | Søgeresultater. |
- - VirksomhedDto | VirksomhedDto |
| 0 - * |
|
- - - cvrNummer | string | Pattern: [0-9]{8} | 1 | CVR-nummer. |
- - - navn | string |
| 0 - 1 | Navn på virksomheden (fra CVR). |
- - - url | string |
| 0 - 1 | URL (fra CVR). |
- - - emailadresse | string |
| 0 - 1 | E-mailadresse (fra CVR). |
- - - telefonnummer | string |
| 0 - 1 | Telefonnummer (fra CVR). |
- - - laas |
| 0 - 1 |
| |
- - - logo | base64Binary |
| 0 - 1 | Logo i et formaterne: PNG, JPEG (base64). |
- - - adresse | AdresseDto |
| 0 - 1 | Adresse for virksomhed. |
- - - - vejnavn | string |
| 0 - 1 | Vejnavn (fra CVR). |
- - - - husnummer | string |
| 0 - 1 | Husnummer (fra CVR). |
- - - - etage | string |
| 0 - 1 | Etagebetegnelse (fra CVR). |
- - - - sidedoer | string |
| 0 - 1 | Side-/dørbetegnelse (fra CVR). |
- - - - bynavn | string |
| 0 - 1 | Bynavn (fra CVR). |
- - - - postnummer | string | Pattern: [0-9]{4} | 0 - 1 | Postnummer (fra CVR). |
- - - - kommunenummer | int32 | Pattern: [0-9]{3} | 0 - 1 | Kommunenummer (fra CVR). |
- - - - landekode | string | Pattern: [a-z,A-Z]{2}|[a-z,A-Z]{3}|[0-9]{3}|[0-9]{4} | 0 - 1 | Landekode (fra CVR).
|
- - - lukket | boolean |
| 1 | Om virksomheden er lukket (fra CVR). |
- - - oprettetTidspunkt | date-time |
| 1 | Tidspunkt for oprettelse. |
- - - opdateretTidspunkt | date-time |
| 1 | Tidspunkt for seneste opdatering. |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
120516 | Når der kaldes som virksomhed, så skal CVR-nummer være virksomhedens eget. | Når der kaldes som virksomhed, så skal CVR-nummer være virksomhedens eget. |