Gå til hovedindhold
Webservice / Serviceplatformen
CprLookupService_Adresse4

Formål

Servicen giver mulighed for at forespørge på et personnummer, hvorefter kontaktadresse på en given person kan returneres.

Beskrivelse

Ved forespørgsel på et personnummer returnerer servicen:
- Kontaktadresse: I klarskrift typisk postnummer, postdistrikt, vejnavn, husnummer, etage, sidedør og evt. bygningsnummer
- Administration: Startdato for forekomst samt slettedato for hvornår en forekomst skal slettes

Klarskrift på adresser på personer forekommer kun i de tilfælde, hvor der ikke må/kan oprettes en relation til et personnummer. Kontaktadressen kan indeholde både danske og udenlandske kontaktadresser.

Servicen er baseret på CPR's adresse4.

Servicen henter data fra Serviceplatformens lokale replika af CPR. Data i Serviceplatformens CPR-replika opdateres dagligt.

Servicen er udstillet med følgende sikkerhedmodel:
- Certificat - InvocationContext

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/CPRLookup/CPRLookup/2

UUID: b7e5ee9c-1acd-41e6-b117-08a11dee6862

EntityId: http://cpr.serviceplatformen.dk/service/adresse4/2

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/CPRLookup/CPRLookup/2

UUID: b7e5ee9c-1acd-41e6-b117-08a11dee6862

EntityId: http://cpr.serviceplatformen.dk/service/adresse4/2

Webservice / Serviceplatformen
CprLookupService_navne3

Formål

Servicen tager et personnummer som parameter og returnerer udvalgte oplysninger om personens navn.

Beskrivelse

Servicen tager et personnummer som parameter og returnerer oplysninger om personens navn:
- Fornavn, mellemnavn, efternavne - desuden køn og status for personen (aktiv/inaktiv)
- Navnehistorik - tidligere navne markering

Servicen er baseret på CPR's service navne3 og udstiller et udsnit af CPR's service navne3's outputfelter. Følgende felter returneres ved opslag på personnummer:
CNVN_ADRNVN, CNVN_EFTERNVN, CNVN_EFTERNVNMRK, CNVN_FORNVN, CNVN_FORNVNMRK, CNVN_KOEN, CNVN_MELNVN, CNVN_MELNVNMRK, CNVN_STARTDATO, CNVN_STARTDATOUSM, CNVN_STATUS, CNVN_STATUSDATOUSM, CNVN_STATUSSTARTDAT, HISTORIKMRK.

På samme måde som hos CPR-registret, returneres et svar med maksimalt 20 personer ad gangen. Skulle søgningen resultere i et svar med flere end 20 personer, skal servicen kaldes igen for at hente de næste 20 personer i svaret.

Servicen henter data fra Serviceplatformens lokale replika af CPR. Data i Serviceplatformens CPR-replika opdateres dagligt.

Servicen er udstillet med følgende sikkerhedmodel:
- Certificat - InvocationContext

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/CPRLookup/CPRLookup/2

UUID: e3f26293-803e-4b8f-8a15-674a4f8abaad

EntityId: http://cpr.serviceplatformen.dk/service/navne3/2

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/CPRLookup/CPRLookup/2

UUID: e3f26293-803e-4b8f-8a15-674a4f8abaad

EntityId: http://cpr.serviceplatformen.dk/service/navne3/2

Webservice / Serviceplatformen
CPRMunicipalityCodeeService

Formål

Servicen kan returnere en persons bopælskommune ud fra et CPR-nummer.

Beskrivelse

Servicen henter data fra Serviceplatformens lokale replika af CPR. Data i Serviceplatformens CPR-replika opdateres dagligt.

Servicen er udstillet med følgende sikkerhedsmodel:
- Certificat - InvocationContext

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/CPRMunicipalityCode/CPRMunicipalityCode/1

UUID: cdf2d790-63ed-11e3-96c7-000c7631174f

EntityId: http://cpr.serviceplatformen.dk/service/kommunekode/1

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/CPRMunicipalityCode/CPRMunicipalityCode/1

UUID: cdf2d790-63ed-11e3-96c7-000c7631174f

EntityId: http://cpr.serviceplatformen.dk/service/kommunekode/1

Webservice / Serviceplatformen
CprSubscriptionService

Formål

Servicen giver mulighed for, at kommunens fagsystem kan abonnere på ændringer i CPR-data for de personer, som kommunen vælger at opsætte hændelsesabonnement på.

Nyt i denne version

Version 2.0 indeholder alle felter, som modtages fra CPR-kontoret inkl. de ovenfor nævnte nye felter AdresseUUID, Delvis værgemål og Delt bopæl.

Beskrivelse

Bemærk, at denne version er under udvikling.

Servicen bygger på et fuld udtræk fra CPR-kontoret dateret 12. maj 2022 samt de ændringer, der er løbet på siden da.

Ændringsudtræk sendes fra CPR-kontoret på hverdage, hvilket betyder, at man som modtager kan forvente at modtage filer fra Serviceplatformen med ændrede persondata dagligt. Der leveres persondata med tilhørende 99 års historik.
Filerne leveres til kommunens fagsystem via fagsystemets SFTP-mappe på Serviceplatformen. For anvendelse af servicen er det derfor en forudsætning, at anvendersystemet er tilknyttet Serviceplatformens SFTP med filudvekslingstypen simpel.

CPR Abonnementet sættes op ved brug af ét eller flere filtre:
- Alder: Med dette filter modtages alle ændringer for personer, som har en alder inden for det angivne aldersinterval - eksempelvis alle personer under 18 år eller alle personer over 65 år.
- Kommunekode: Med dette filter modtages alle ændringer for personer, som er bosat inden for den/de angivne kommunekode(r), herunder tilflyttere.
- CPR-numre: Med dette filter modtages alle ændringer for personer med de angivne CPR-numre.
- Hændelseskoder: Med dette filter modtages alle CPR-data for personer, hvor der er sket ændringer inden for valgte hændelseskode – eksempelvis for alle dødsfald eller navneændringer.
- Ingen filtre: Med dette filter modtages alle ændrede CPR-data for alle personer.

Det er kommunens ansvar at sikre, at der foreligger et sagligt behov for modtagelse af CPR-data for de personer, som er specificeret i ændringsfiltrene. Ligeledes er det kommunens ansvar at sikre, at kommunens fagsystem ikke modtager CPR-data for personer, hvor der ikke længere foreligger et sagligt behov.

Servicen er udstillet med følgende sikkerhedsmodel:
- Certifikat - InnovationContext

Formål

Servicen giver mulighed for, at kommunens fagsystem kan abonnere på ændringer i CPR-data for de personer, som kommunen vælger at opsætte hændelsesabonnement på.

Beskrivelse

Ændringsudtræk sendes fra CPR-kontoret på hverdage, hvilket betyder, at man som modtager kan forvente at modtage filer fra Serviceplatformen med ændrede persondata dagligt. Der leveres persondata med tilhørende 99 års historik. Filerne leveres til kommunens fagsystem via fagsystemets SFTP-mappe på Serviceplatformen. For anvendelse af servicen er det derfor en forudsætning, at anvendersystemet er tilknyttet Serviceplatformens SFTP med filudvekslingstypen simpel.

CPR Abonnementet sættes op ved brug af ét eller flere filtre:
- Alder: Med dette filter modtages alle ændringer for personer, som har en alder inden for det angivne aldersinterval - eksempelvis alle personer under 18 år eller alle personer over 65 år
- Kommunekode: Med dette filter modtages alle ændringer for personer, som er bosat inden for den/de angivne kommunekoder, herunder tilflyttere
- CPR-numre: Med dette filter modtages alle ændringer for personer med de angivne CPR-numre
- Hændelseskoder: Med dette filter modtages alle CPR-data for personer, hvor der er sket ændringer inden for valgte hændelseskode – eksempelvis for alle dødsfald eller navneændringer
- Ingen filtre: Med dette filter modtages alle ændrede CPR-data for alle personer

Det er kommunens ansvar at sikre, at der foreligger et sagligt behov for modtagelse af CPR-data for de personer, som er specificeret i ændringsfiltrene. Ligeledes er det kommunens ansvar at sikre, at kommunens fagsystem ikke modtager CPR-data for personer, hvor der ikke længere foreligger et sagligt behov.

Servicen henter data fra Serviceplatformens lokale replika af CPR. Serviceplatformen har valgt at etablere et lokalt CPR-replika af performancemæssige og økonomiske årsager. Data i Serviceplatformens CPR-replika opdateres dagligt.

Servicen er udstillet med følgende sikkerhedsmodel:
- Certifikat - InnovationContext

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/CPRSubscription/CPRSubscription/1/

UUID: 9cdccc2f-3243-11e2-8fef-d4bed98c5934

EntityId: http://cpr.serviceplatformen.dk/service/abonnement/1

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/CPRSubscription/CPRSubscription/1/

UUID: 9cdccc2f-3243-11e2-8fef-d4bed98c5934

EntityId: http://cpr.serviceplatformen.dk/service/abonnement/1

Webservice / Serviceplatformen
CVROnline

Formål

Servicen giver mulighed for at tilgå kildesystemet CVR-Online.

Nyt i denne version

Servicen anvender i denne version også SAML-token (Liberty Basic SOAP Binding) som sikkerhedsmodel.

Beskrivelse

Servicen er implementeret som en SOAP-service og understøtter fem operationer:

- LegalUnitGet
- LegalUnitSearch
- ProductionUnitGet
- ProductionUnitSearch
- RelatedProductionUnitNameAndAddressGet

De fem operationer orkestrerer kald til relevante REST-services for CVR på Datafordeleren. Afhængigt af den valgte operation returneres en række oplysninger om virksomheden.

LegalUnitGet
- Opslag på CVR-nummer. Ud fra et CVR-nummer returneres bl.a. virksomhedsnavn, adresse, start- og ophørstidspunkt, reklamekode, tilknyttede P-numre og virksomhedsform.

LegalUnitSearch
- Søgning efter CVR-enhed. Ud fra en kombination af søgeparametre returneres en liste af matchende CVR-numre. Bemærk, at kun et begrænset antal søgeparametre vil fungere efter kildeændring.

ProductionUnitGet
- Opslag på P-nummer. Ud fra et P-nummer returneres bl.a. navn, adresse, start- og ophørstidspunkt, reklamekode, relateret CVR-nummer og branche.

ProductionUnitSearch
- Søgning efter P-nummer. Ud fra en kombination af søgeparametre returneres en liste af matchende P-numre. Bemærk, at kun et begrænset antal søgeparametre vil fungere efter kildeændring.

RelatedProductionUnitNameAndAddressGet
- Opslag på relateret P-nummer. Returnerer navn og adresse på relaterede P-numre.

Servicen er udstillet med følgende sikkerhedsmodeller:
- Certifikat - InvocationContext (IC)
- SAML-token

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/CVR/Online/2

UUID: c0daecde-e278-43b7-84fd-477bfeeea027

EntityId: http://cvr.serviceplatformen.dk/service/online/2

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/CVR/Online/2

UUID: c0daecde-e278-43b7-84fd-477bfeeea027

EntityId: http://cvr.serviceplatformen.dk/service/online/2

Webservice / Serviceplatformen
ModtagFinansbilagStraksleveranceService

Formål

Servicen giver kommunale fagløsninger mulighed for at sende finansbilag med finansposteringer til en kommunes bogføringssystem som straksleverance via webservicekald.

Beskrivelse

For uddybning af integrationen se den vedhæftede dokumentation.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/OIR/ModtagFinansbilagStraksleverance/2

UUID: 63610af5-3a70-4ff2-b04f-b5e6d13fd8b9

EntityId: http://oir.serviceplatformen.dk/service/modtagfinansbilag/2

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/OIR/ModtagFinansbilagStraksleverance/2

UUID: 63610af5-3a70-4ff2-b04f-b5e6d13fd8b9

EntityId: http://oir.serviceplatformen.dk/service/modtagfinansbilag/2

Webservice / Serviceplatformen
PrintService

Formål

Servicen giver mulighed for at afsende (digitale og fysiske) breve samt forespørge på tilmelding til Digital Post og NemSMS.

Beskrivelse

Servicen er udstillet som en SOAP-service på Serviceplatfomen med to operationer:
- afsendBrev: Afsendelse af (digitale og fysiske) breve
- spoergTilmelding: Forespørgsel om tilmelding til Digital Post og NemSMS

1. afsendBrev
Operationen giver mulighed for at sende (digitalt og fysisk) ét brev til en eller flere borgere og virksomheder.

Når man afsender et brev, skal afsender vælge den rigtige kanal. Der er her mulighed for:
- Selv at foretage valg af kanal baseret på borgerens tilmeldingsstatus fra Digital Post
- At lade Serviceplatformen vælge kanalen ud fra det dagligt indlæste replika af tilmeldingslisten på Serviceplatformen fra Digital Post
- At lade den valgte fjernprintsløsning vælge kanal, ved at sende alle forsendelser til den valgte fjernprintleverandør. I fjernprintleverandørens løsning er det konfigureret hvordan kanalvalget mellem Digital Post og fjernprint skal være for en forsendelse.

Det omfatter:
- ”D” for DigitalPost
- ”F” for fysisk post
- ”A” for automatisk valg på Serviceplatformen
- ”P” for automatisk valg i fjernprintsløsning

For et brev som sendes via Digital Post skal desuden angives, hvorvidt brevet skal sendes direkte (enkeltafsendelse) eller som batch (masseafsendelse):
- ”D” for Direkte
- ”M” for Masseafsendelse

2. spoergTilmelding
Operationen giver mulighed for at forespørge på personers og virksomheders tilmelding til Digital Post og/eller NemSMS.

Servicen er udstillet med følgende sikkerhedsmodeller:
- SAML-token med Liberty Basic SOAP Binding
- Certifikat

Der kan helt undtagelsesvis gives adgang med certifikat, såfremt særlige forhold gør sig gældende

Se den vedhæftede dokumentation for en uddybning af funktionaliteten.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/Print/Print/2

UUID: fd885b8b-4a3f-46cb-b367-6c9dda1c78f6

EntityId: http://print.serviceplatformen.dk/service/forsendelse/2

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/Print/Print/2

UUID: fd885b8b-4a3f-46cb-b367-6c9dda1c78f6

EntityId: http://print.serviceplatformen.dk/service/forsendelse/2

Webservice / Serviceplatformen
TerminalAdgangService

Formål

Denne service giver adgang til og filtrerer data om ydelser ved udveksling af oplysninger mellem kommunerne og UDK.

Beskrivelse

Servicen består af dette flow:
- Et fagsystem sender en forespørgsel på et CPR-nummer med evt. tidsperiode og KLE-nummer
- Forespørgslen datoafgrænses automatisk i henhold til Lov om Udbetaling Danmark
- Servicen sender forespørgslen til Ydelsesindekset med angivelse af, om det er en kommune eller UDK, der spørger
- Ydelsesindekset returnerer relevant datasæt til servicen
- Servicen filtrerer data, inden de sendes til fagsystemet. I filtreringen fjernes felter/attributter, som en kommune/UDK ikke må modtage. Servicen sletter straks fjernet data.
- Servicen sender filtreret data til fagsystemet

Servicen er udstillet med følgende sikkerhedsmodel:
- SAML-Token

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/Ydelse/TerminalAdgang/6

UUID: 3053ec89-31fe-4206-878b-bba6783d7a88

EntityId: http://ydelse.serviceplatformen.dk/service/terminaladgang/6

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/Ydelse/TerminalAdgang/6

UUID: 3053ec89-31fe-4206-878b-bba6783d7a88

EntityId: http://ydelse.serviceplatformen.dk/service/terminaladgang/6

Formål

Denne service giver adgang til og filtrerer data om ydelser ved udveksling af oplysninger mellem kommunerne og UDK.

Beskrivelse

Servicen består af dette flow:
- Et fagsystem sender en forespørgsel på et CPR-nummer med evt. tidsperiode og KLE-nummer
- Forespørgslen datoafgrænses automatisk i henhold til Lov om Udbetaling Danmark
- Servicen sender forespørgslen til Ydelsesindekset med angivelse af, om det er en kommune eller UDK, der spørger
- Ydelsesindekset returnerer relevant datasæt til servicen
- Servicen filtrerer data, inden de sendes til fagsystemet. I filtreringen fjernes felter/attributter, som en kommune/UDK ikke må modtage. Servicen sletter straks fjernet data.
- Servicen sender filtreret data til fagsystemet

Servicen er udstillet med følgende sikkerhedsmodel:
- SAML-Token

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/Ydelse/TerminalAdgang/5

UUID: b1d6d5ba-f887-4e04-af71-f2a2024a9caa

EntityId: http://ydelse.serviceplatformen.dk/service/terminaladgang/5

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/Ydelse/TerminalAdgang/5

UUID: b1d6d5ba-f887-4e04-af71-f2a2024a9caa

EntityId: http://ydelse.serviceplatformen.dk/service/terminaladgang/5

Formål

Denne service giver adgang til og filtrerer data om ydelser ved udveksling af oplysninger mellem kommunerne og UDK.

Beskrivelse

Servicen består af dette flow:
- Et fagsystem sender en forespørgsel på et CPR-nummer med evt. tidsperiode og KLE-nummer
- Forespørgslen datoafgrænses automatisk i henhold til Lov om Udbetaling Danmark
- Servicen sender forespørgslen til Ydelsesindekset med angivelse af, om det er en kommune eller UDK, der spørger
- Ydelsesindekset returnerer relevant datasæt til servicen
- Servicen filtrerer data, inden de sendes til fagsystemet. I filtreringen fjernes felter/attributter, som en kommune/UDK ikke må modtage. Servicen sletter straks fjernet data.
- Servicen sender filtreret data til fagsystemet

Servicen er udstillet med følgende sikkerhedsmodel:
- SAML-Token

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/Ydelse/TerminalAdgang/4

UUID: f6a5ac4f-06f0-46bc-9fba-8f80243512a6

EntityId: http://ydelse.serviceplatformen.dk/service/terminaladgang/4

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/Ydelse/TerminalAdgang/4

UUID: f6a5ac4f-06f0-46bc-9fba-8f80243512a6

EntityId: http://ydelse.serviceplatformen.dk/service/terminaladgang/4

Webservice / Serviceplatformen
VedligeholdTilmelding

Formål

Servicen giver mulighed for at til- og afmelde slutbrugeren (borgere og virksomheder) til NemSMS. Desuden kan servicen opdatere slutbrugerens stamdata i NemSMS.

Beskrivelse

Servicen er en synkron SOAP-service, som består af to operationer:

OpdaterBorgerNemSMS: Opret eller opdatér stamdata til NemSMS
- Input: Borgerens CPR-nummer eller virksomhedens CVR-nummer samt mobilnummer og e-mails
- Output: Kvittering/afvisning af oprettelse eller opdatering
Hvis borgeren er oprettet i forvejen, vil borgerens data blive opdateret.

TilmeldNemSMS: Til- eller afmeld slutbruger til NemSMS
- Input: Borgerens CPR-nummer eller virksomhedens CVR-nummer samt indikator om til- eller afmelding af NemSMS
- Output: Kvittering/afvisning af oprettelse eller opdatering

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/NemSMS/VedligeholdTilmelding/2

UUID: e35c9368-36e9-47f9-b35b-8c9f9824ece5

EntityId: http://nemsms.serviceplatformen.dk/service/nemsms/2

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/NemSMS/VedligeholdTilmelding/2

UUID: e35c9368-36e9-47f9-b35b-8c9f9824ece5

EntityId: http://nemsms.serviceplatformen.dk/service/nemsms/2