Gå til hovedindhold
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

Beskedservice / Fælleskommunal Beskedfordeler
DigitalPostTilmeldingBeskedHent

Formål

Beskedservicen giver mulighed for at abonnere på borgeres og virksomheders tilmelding og afmelding til Digitaliseringsstyrelsens Digital Post-løsning. Hvis en borger eller virksomhed ikke er tilmeldt Digital Post, skal der sendes fysisk brev via kommunens fjernprintløsning.

Servicen anvender pull-mønster, dvs. at man som anvendersystem skal hente beskeden fra Beskedfordeleren.

Beskrivelse

Beskedservicen udstiller beskedtypen DigitalPost_DigitalPostTilmelding.

Beskedservice / Fælleskommunal Beskedfordeler
DigitalPostTilmeldingBeskedModtag

Formål

Beskedservicen giver mulighed for at abonnere på borgeres og virksomheders tilmelding og afmelding til Digitaliseringsstyrelsens Digital Post-løsning. Hvis en borger eller virksomhed ikke er tilmeldt Digital Post, skal der sendes fysisk brev via kommunens fjernprintløsning.

Servicen anvender push-mønster, dvs. at man som anvendersystem skal installere en service til at modtage beskeden fra Beskedfordeleren.

Beskrivelse

Beskedservicen udstiller beskedtypen DigitalPost_DigitalPostTilmelding.

Eksternt testmiljø

Endpoint: amqp://beskedfordeler.eksterntest-stoettesystemerne.dk:5671

Produktionsmiljø

Endpoint: amqp://beskedfordeler.stoettesystemerne.dk:5671

Beskedservice / Fælleskommunal Beskedfordeler
MedComKvitteringBeskedAfsend

Formål

Formålet med servicen er at afsende en besked af typen MedComKvittering via Beskedfordeleren.

Beskrivelse

Beskedtypen MedComKvittering i version 1.0 dækker over MedCom-meddelelsestypen:

- Acknowledgement (Kvittering).

For at afsende beskeder, skal man benytte de services, der indgår i SF1462 Afsend beskeder via Beskedfordeler.

Eksternt testmiljø

Endpoint: amqp://beskedfordeler.eksterntest-stoettesystemerne.dk:5671

Produktionsmiljø

Endpoint: amqp://beskedfordeler.prod-stoettesystemerne.dk:5671

Beskedservice / Fælleskommunal Beskedfordeler
MedComKvitteringBeskedModtag

Formål

Formålet med servicen er at modtage en besked af typen MedComKvittering via Beskedfordeleren.

Beskrivelse

Beskedtypen MedComKvittering i version 1.0 dækker over MedCom-meddelelsestypen:

- Acknowledgement (Kvittering).

For at modtage beskeder, skal man benytte de services, der indgår i SF1461 Modtag beskeder via Beskedfordeler.

Eksternt testmiljø

Endpoint: beskedfordeler.eksterntest-stoettesystemerne.dk:5671

Produktionsmiljø

Endpoint: beskedfordeler.stoettesystemerne.dk:5671

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

Beskedservice / Fælleskommunal Beskedfordeler
NemSMSTilmeldingBeskedHent

Formål

Beskedservicen giver mulighed for at abonnere på borgeres og virksomheders tilmelding til NemSMS.

Servicen anvender pull-mønster, dvs. at man som anvendersystem skal hente beskeden fra Beskedfordeleren.

Beskrivelse

Beskedservicen udstiller beskedtypen DigitalPost_NemSMSTilmelding.

Beskedservice / Fælleskommunal Beskedfordeler
NemSMSTilmeldingBeskedModtag

Formål

Beskedservicen giver mulighed for at abonnere på borgeres og virksomheders tilmelding til NemSMS.

Servicen anvender push-mønster, dvs. at man som anvendersystem skal installere en service til at modtage beskeden fra Beskedfordeleren.

Beskrivelse

Beskedservicen udstiller beskedtypen DigitalPost_NemSMSTilmelding.

Eksternt testmiljø

Endpoint: amqp://beskedfordeler.eksterntest-stoettesystemerne.dk:5671

Produktionsmiljø

Endpoint: amqp://beskedfordeler.stoettesystemerne.dk:5671

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

Beskedservice / Fælleskommunal Beskedfordeler
SocialPensionHelbredssagHændelseBeskedHent

Formål

Servicen giver anvender mulighed for at oprette abonnement på og modtage beskeder med ændringer i en pensionists kommunale helbredssag fra KMD SPK.

Servicen anvender pull-mønster, dvs. at man som anvendersystem skal hente beskeden fra Beskedfordeleren.

Beskrivelse

Servicen udstiller beskedtypen SocialPension_SocialPensionHelbredsSagHaendelse version 1.0.

Beskeden indeholder ændringer til en pensionists kommunale helbredssag fra KMD SPK med oplysninger relateret til den eller de ændringer, der kommunikeres i beskeden.

Beskedkuverten indeholder bl.a. pensionistens CPR-nummer og bopælskommune samt sagshændelsen. Der indgår følgende hændelsestyper i beskeden:
- Et helbredskort bevilges
- Et helbredskort/bevilling stoppes
- Personlig helbredsprocent ændres
- Sygesikringsgruppe ændres

Beskeddata indeholder XML-fil med sagens informationer, herunder:
- Pensionistens CPR-nummer
- Helbredskort bevilges
- Helbredskort/bevilling stoppes
- Personlig helbredsprocent
- Sygesikringsgruppe

Eksternt testmiljø

Endpoint: amqp://beskedfordeler.eksterntest-stoettesystemerne.dk:5671

Produktionsmiljø

Endpoint: amqp://beskedfordeler.stoettesystemerne.dk:5671