Udstillede services

På denne side beskrives de REST-services, der udstilles af Blanketmotoren, og som kan benyttes af alle myndigheder.

1 Opslag på CVR-nummer
2 Opslag på CVR eller SE-nummer
3 Opslag på SE-nummer
4 Hent produktionsenheder for CVR-nummer
5 Opslag på P-nummer
6 Opslag på revisor
7 Fremsøgning af adresser
8 Validering af udenlandske adresser
- 8.1 Validering af struktureret udenlandsk adresse
- 8.2 Validering af udenlandsk adresse som fritekst

Opslag på CVR-nummer

Servicen laver et opslag i CVR-registret og returnerer data om den konkrete CVR-enhed.

URL: {xxf:property('blanketmotorservice')}/cvr/opslagPaaCvrNummer

Method: GET

URL Parameters:

cvrNummer

Output:

<CVRReplyWrapper>
    <address>
        <addressString></addressString>
        <buildingIdentifier></buildingIdentifier>
        <coAddress></coAddress>
        <districtName></districtName>
        <postalCode></postalCode>
        <kommuneKode></kommuneKode>
        <kommuneNavn></kommuneNavn>
        <streetName></streetName>
    </address>
    <antalAarsvaerk></antalAarsvaerk>
    <antalAnsatte></antalAnsatte>
    <brancheBeskrivelse></brancheBeskrivelse>
    <brancheKode></brancheKode>
    <companyName></companyName>
    <cvrNumber></cvrNumber>
    <email></email>
    <faxNumber></faxNumber>
    <telephoneNumber></telephoneNumber>
    <virksomhedsStatus></virksomhedsStatus>
    <virksomhedsform></virksomhedsform>
    <virksomhedsformKode></virksomhedsformKode>
    <fejlBesked></fejlBesked>
    <statusKode></statusKode>
</CVRReplyWrapper>

Felt	Muligt udfaldsrum

Felt	Muligt udfaldsrum
virksomhedsStatus	AKTIV, NORMAL, OPLØST, OPLØST EFTER ERKLÆRING, OPLØST EFTER FRIVILLIG LIKVIDATION, OPLØST EFTER FUSION, OPLØST EFTER GRÆNSEOVERSKRIDENDE FUSION, OPLØST EFTER GRÆNSEOVERSKRIDENDE HJEMSTEDSFLYTNING, OPLØST EFTER KONKURS, OPLØST EFTER SPALTNING, TVANGSOPLØST, UDEN RETSVIRKNING, UNDER FRIVILLIG LIKVIDATION, UNDER KONKURS, UNDER REASSUMERING, UNDER REKONSTRUKTION, UNDER TVANGSOPLØSNING

Opslag på CVR eller SE-nummer

Servicen laver et opslag i Erhvervssystemet hos SKAT, hvis SE-nummeret er forskelligt for det tilhørende CVR-nummer, og ellers i CVR-registret. I begge tilfælde returneres data om den konkrete enhed.

URL: {xxf:property('blanketmotorservice')}/cvr/opslagPaaCvrEllerSeNummer

Method: GET

URL Parameters:

cvrEllerSeNummer

Output:

<CVRReplyWrapper>
    <address>
        <addressString></addressString>
        <buildingIdentifier></buildingIdentifier>
        <coAddress></coAddress>
        <districtName></districtName>
        <postalCode></postalCode>
        <kommuneKode></kommuneKode>
        <kommuneNavn></kommuneNavn>
        <streetName></streetName>
    </address>
    <brancheBeskrivelse></brancheBeskrivelse>
    <brancheKode></brancheKode>
    <companyName></companyName>
    <cvrNumber></cvrNumber>
    <email></email>
    <faxNumber></faxNumber>
    <telephoneNumber></telephoneNumber>
    <virksomhedsform></virksomhedsform>
    <virksomhedsformKode></virksomhedsformKode>
    <fejlBesked></fejlBesked>
    <statusKode></statusKode>
</CVRReplyWrapper>

Opslag på SE-nummer

Servicen laver et opslag i Erhvervssystemet hos SKAT og returnerer data for det indsendte SE-nummer.

URL: {xxf:property('blanketmotorservice')}/cvr/opslagPaaSeNummer

Method: GET

URL Parameters:

seNummer

Output:

<CVRReplyWrapper>
    <address>
        <addressString></addressString>
        <buildingIdentifier></buildingIdentifier>
        <coAddress></coAddress>
        <districtName></districtName>
        <postalCode></postalCode>
        <kommuneKode></kommuneKode>
        <kommuneNavn></kommuneNavn>
        <streetName></streetName>
    </address>
    <brancheBeskrivelse></brancheBeskrivelse>
    <brancheKode></brancheKode>
    <companyName></companyName>
    <cvrNumber></cvrNumber>
    <email></email>
    <faxNumber></faxNumber>
    <telephoneNumber></telephoneNumber>
    <virksomhedsform></virksomhedsform>
    <virksomhedsformKode></virksomhedsformKode>
    <fejlBesked></fejlBesked>
    <statusKode></statusKode>
</CVRReplyWrapper>

Hent produktionsenheder for CVR-nummer

Servicen henter alle produktionsenheder for et givent CVR-nummer.

URL: {xxf:property('blanketmotorservice')}/cvr/soegProduktionsenheder

Method: GET

URL Parameters:

cvrNummer

Output:

Opslag på P-nummer

Servicen laver et opslag på P-nummer i P-enhedsregistret og returnerer data om den konkrete P-enhed.

URL: {xxf:property('blanketmotorservice')}/cvr/hentProduktionsenhed

Method: GET

URL Parameters:

pNummer

Output:

Opslag på revisor

Det er via Blanketmotorens servicelag muligt at slå en revisor op på MNE-nummer og få returneret oplysninger om revisoren samt eventuelt tilknyttede revisionsvirksomheder.

URL: {xxf:property('blanketmotorservice')}/cvr/opslagAfRevisor

Method: POST

Input:

Output:

Felt	Muligt udfaldsrum

Felt	Muligt udfaldsrum
revisorstatus	AKTIV, DEPONERET, SLETTET, BORTFALDET, FRATAGET, FRAKENDT
revisortype	STATSAUTORISERET, REGISTRERET, UDENLANDSK_3_LANDS_REVISOR, UDENLANDSK_KONKRET_GODKENDELSE, UDENLANDSK_TJENESTEYDER

Fremsøgning af adresser

Servicen laves i Danmarks AdresseRegister og returnerer data på de adresser, der matcher søgeteksten.

URL: {xxf:property('blanketmotorservice')}/cvr/hentAdresser

Method: GET

URL Parameters:

soegetekst

Output:

XML’en for adressesøgningen er formateret lidt anderledes end de øvrige XML-strukturer, og XPath til at udtrække værdier ser derfor lidt anderledes ud. Først og fremmest skal der vælges første resultat i listen, men derudover skal felter angives vha et @ - eksempelvis

/list/map[1]/entry[@ke='postnummer']/text()

Validering af udenlandske adresser

Disse services laves i SmartyStreets og giver mulighed for at få valideret hhv. en struktureret adresse eller en fritekst. Resultatet fortæller bl.a. om hele adressen er verificeret, hvilket niveau den er verificeret på og hvilke ændringer, der evt. er lavet til de enkelte felter for at få dem til at passe.

Validering af struktureret udenlandsk adresse

URL: {xxf:property('blanketmotorservice')}/adresse/validerAdresseInternational

Method: POST

Input:

Krav til input:
En af følgende kombinationer skal være udfyldt:

landekode + adresselinje1 + postnummer
landekode + adresselinje1 + bynavn + stat

Output:

Nærmere beskrivelse af valideringssvaret kommer senere.

Output ved fejl:

Validering af udenlandsk adresse som fritekst

URL: {xxf:property('blanketmotorservice')}/adresse/validerAdresseInternationalFritekst

Method: POST

URL parameters:

landekode + fritekst

Output:

Kaldet til servicen har følgende XML-struktur:

Krav til input:

Begge felter skal være udfyldt.

Output:

Nærmere beskrivelse af valideringssvaret kommer senere.

Output ved fejl: