Gå til hovedindhold
Filservice / Serviceplatformen
AfsendStorForsendelseTilDigitalPost

Formål

Servicen giver mulighed for at kunne sende større forsendelser via Digital Post til borgere eller virksomheder.

Beskrivelse

Med servicen kan større forsendelser sendes via SFTP på Serviceplatformen.

Servicen kan anvendes, når postforsendelsens samlede størrelse overgår de 10MB, der er maks. for forsendelser via webservicen Printservice.

Det anbefales, at denne filservice kun benyttes, hvor Printservice ikke kan håndtere størrelsen af forsendelsen, da flowet i AfsendStorForsendelseTilDigitalPost er mere kompliceret.

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
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

Filservice / Serviceplatformen
UdbetalteFeriepengeSamlingKYAnmod

Formål

Formålet med filservicen er, at løsningen Kommunernes Ydelsessystem (KY) kan anmode ATP om oplysninger om udbetalte feriepenge for relevante borgere, dvs. borgere i KY, som modtager ydelser.

Servicen indgår i et asynkront integrationsflow sammen med UdbetalteFeriepengeSamlingKSDHent.

Beskrivelse

Filservicen repræsenterer KYs anmodning til ATP Feriekonto om indestående feriepenge og oplysninger om udbetalte feriepenge på relevante borgere. Filservicen anvender Serviceplatformens SFTP-løsning.

Anmodningen består af én fil, som indeholder CPR-numre på de personer og perioder, der ønskes oplysninger om.

Filservice / Serviceplatformen
UdbetalteFeriepengeSamlingKYHent

Formål

Formålet med filservicen er, at løsningen Kommunernes Ydelsessystem (KY) kan hente oplysninger om udbetalte feriepenge for relevante borgere, dvs. borgere i KY, som modtager ydelser.

Servicen indgår i et asynkront integrationsflow sammen med UdbetalteFeriepengeSamlingKSDAnmod.

Beskrivelse

Filservicen repræsenterer retursvaret fra ATP Feriekonto til KY på anmodningen i UdbetalteFeriepengeSamlingKYAnmod. Filservicen anvender Serviceplatformens SFTP-løsning.

FIlen indholder for den angivne periode bl.a. følgende information per udbetaling fra ATP Feriekonto:

- Dato (for ferieanmodning)
- Personnummer
- Første feriedag (i den ønskede ferieperiode)
- Antal feriedage (i den ønskede ferieperiode)
- Beløb pr. udbetalingsdato (til udbetaling)
- Aktuelt ferieår på udbetalingen
- Saldo feriepenge (i aktuelt ferieår på udbetalingen)
- Saldo feriedage (i aktuelt ferieår på udbetalingen)
- Dispositionsdato/udbetalingsdato/Dato for anmodningstidspunkt/Dato for modtagelse af data
- Udbetalingsårsag
- Status (fejlmeddelelser)

Personnummer, Ferieår, Saldo feriepenge og Saldo feriedage oplyses, selv når der ikke er fundet nogen udbetalingsdato på personen i FerieKonto i den forespurgte periode.

Perioden må ikke stække sig længere tilbage end 20 måneder fra den dato, der forespørges på. Tidligst mulige dato er dog den 1. maj 2011.

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