Beskrivelse

Servicen giver mulighed for at tilgå de CPR-services, der udstilles af CPR-kontoret (myndighedsregister og vejregister) og implementerer services, der udstilles af CPR til offentlige myndigheder.

Servicen er af typen gennemstilling, og fungerer således, at anvendersystemet kontakter Serviceplatformen med en forespørgsel, hvorefter Serviceplatformen videresender forespørgslen til kildesystemet. Serviceplatformen indkapsler dermed kildesystemet, så anvendersystemet ikke påvirkes, hvis der fx sker ændringer i kildesystemet.

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

Eksternt testmiljø

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

UUID: 8ee213c7-25a9-11e2-8770-d4bed98c63db

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

Produktionsmiljø

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

UUID: 8ee213c7-25a9-11e2-8770-d4bed98c63db

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

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

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

Nyt i denne version

Operationen ”HentDebitorkonto” er udvidet på følgende områder:
- Alle dataelementer og strukturer, som fagsystemer kan registrere på en Debitorkonto, kan returneres – også de nye, der oprettet med version 3.0 af servicen DebitorregistreringAfsend.
- Man kan nu se, om en debitorkonto er omfattet af en aftale om automatisk betaling af fordringer.
- Mere detaljeret information om debitorsystemets håndtering og gældende status for den enkelte fordring kan nu returneres: RettidigIndbetalingsDato, Betalingsmåde (FI-kort, Automatisk træk), hvorvidt der er bevilget henstand på fordringer (og evt. rykkere og renter), om fordringen (og evt. rykkere og renter) indgår i en betalingsaftale, hvilke fordringer en rykker gælder.
- Fordringens titel fra kommunens selvbetjeningsløsning kan returneres.
- Et evt. ”dybt” link til betaling af fordringen i debitorsystemets betalingsløsning kan returneres.
- I operationens søgekriterie er tilføjet mulighed for at forespørge på debitorkontoen i kontekst af en juridisk medhæfter. På dem måde vil man kunne se fordringer, påløbne omkostninger og frister, der gælder for den juridiske medhæfter.

Beskrivelse

For uddybning af servicen se den vedhæftede dokumentation.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/OIR/DebitorForespoergselAfsend/1

UUID: b20fcbeb-1bc0-47c8-bd06-90e88df9b2ed

EntityId: http://oir.serviceplatformen.dk/service/debitorforespoergselafsend/1

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/OIR/DebitorForespoergselAfsend/1

UUID: b20fcbeb-1bc0-47c8-bd06-90e88df9b2ed

EntityId: http://oir.serviceplatformen.dk/service/debitorforespoergselafsend/1

Beskrivelse

Servicen omfatter beskedtypen: FordringTilIndbetaling

For uddybning af servicen se den vedhæftede dokumentation.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/OIR/DebitorIndbetalingAfsend/1

UUID: d0ed926d-be52-4b12-bf4a-0513b594eed5

EntityId: http://oir.serviceplatformen.dk/service/debitorindbetalingafsend/1

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/OIR/DebitorIndbetalingAfsend/1

UUID: d0ed926d-be52-4b12-bf4a-0513b594eed5

EntityId: http://oir.serviceplatformen.dk/service/debitorindbetalingafsend/1

Beskrivelse

Servicen understøtter, at et fagsysteme kan oprette en anmodning om en handling, som involverer en eller flere af fagsystemets debitorkonti i myndighedens debitorsystem. Servicens anvendes, når fagsystemet har behov for, at opkrævningsfunktionen - her repræsenteret ved debitorsystemet - udfører handlinger på fagsystemets debitorkonti, som kun debitorsystemet har adgang til at udføre.

I svaret på anmodningen får fagsystemet besked om, at handlingsønsket kan accepteres og evt. resultatet af handlingen, hvis der er tale om en her og nu handling. Handlingen kan dermed også gennemføres tidsforskudt for accepten af anmodning. Resultatet af handlingen vil i det tilfælde sendes af debitorsystemet til fagsystemet i en selvstændig svarservice.

Servicen understøtter fire varianter af debitorkontoanmodninger:

1. Anmodning om handling på én debitorkonto. Det kan dreje sig om massehandlinger på alle objekter af en given type under debitorkonto.
2. Anmodning om handling på en eller flere udspecificerede fordringer under en debitorkonto. Handlingerne vil dreje sig om tilstandsændringer på de specificerede fordringer eller massehandlinger på objekter under disse fordringer.
3. Anmodning om handlinger mellem to debitorkonti. Handlinger vil ofte skulle bruges til at flytte værdier fra objekter på den ene debitorkonto til tilsvarende objekter på den anden debitorkonto.
4. Anmodning om handlinger mellem udpegede fordringer på to debitorkonti. Handlinger vil ofte skulle bruges til at flytte værdier fra objekter på sættet af fordring på den ene debitorkonto til tilsvarende objekter på det sæt af fordringer, der er angivet som handlingens mål.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/OIR/DebitorkontoAnmodningAfsend/1

UUID: 6f93bebe-9898-11ed-b537-1706599258b5

EntityId: http://oir.serviceplatformen.dk/service/debitorkontoanmodningafsend/1

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/OIR/DebitorkontoAnmodningAfsend/1

UUID: 6f93bebe-9898-11ed-b537-1706599258b5

EntityId: http://oir.serviceplatformen.dk/service/debitorkontoanmodningafsend/1

Beskrivelse

Servicen understøtter, at debitorsystemet kan afsende et forretningssvar til et fagsystem på resultatet af den handling, som er affødt af en debitorkontoanmodning, som fagsystemet tidligere har oprettet i myndighedens debitorsystem.

Afgivelse af forretningssvar forudsætter, at debitorsystemet tidligere har kvitteret med accept på debitorkontoanmodning til senere behandling.

Fagsystemet kan bruge svaret til håndtering af egne processer, der afventer den endelige tilbage-melding på en debitorkontoanmodning.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/OIR/DebitorkontoAnmodningSvarAfsend/1

UUID: 9ab5d456-9898-11ed-9b1c-eb4fae236c62

EntityId: http://oir.serviceplatformen.dk/service/debitorkontoanmodningsvarafsend/1

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/OIR/DebitorkontoAnmodningSvarAfsend/1

UUID: 9ab5d456-9898-11ed-9b1c-eb4fae236c62

EntityId: http://oir.serviceplatformen.dk/service/debitorkontoanmodningsvarafsend/1

Nyt i denne version

Ændringer i Operationen OpretDebitorkontoRegistrering:
- Operationen indeholder nu muligheden for at kunne registrere omkostningsfordringer, der er afledt af andre fordringer, fx lånerenter. Operationen understøtter, at disse særlige fordringer kan pege på den fordring, de er afledt af og dermed muliggøres korrekt overførsel af denne slags fordringer til inddrivelse i PSRM.
- Nogle lånetyper kræver ifm. med oversendelse til inddrivelse i PSRM, at den oprindelige hovedstol er oversendt fra fagsystemet sammen med lånefordringen. Det er nu understøttet.
- Andre PSRM-krav er yderligere understøttet, bla. på området for tilbagebetalingspligtige ydelser.
- Operationen understøtter, at krediteringer (nedreguleringer af fordringer) kan suppleres af en fritekst til skyldner om, hvad det er, der krediteres for. Det betyder fx at biblioteker nu kan udspecificere hvilke bøger en borger får godtgjort sin erstatning for.
- Ift. EDI-fakturering, har fagsystemet fremover mulighed for at referere til et ordrenummer hos modtageren af fakturaen. Der kan også specificeres en ydelsesmodtager. Det sidste er relevant ift. mellemkommunal fakturering.

Operationen OverdragDebitorkonto udgår.

Beskrivelse

For uddybning af servicen se den vedhæftede dokumentation.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/OIR/DebitorRegistreringAfsend/3

UUID: d9f6680a-a636-486b-b8ae-1ea8dc65e26c

EntityId: http://oir.serviceplatformen.dk/service/debitorregistreringafsend/3

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/OIR/DebitorRegistreringAfsend/3

UUID: d9f6680a-a636-486b-b8ae-1ea8dc65e26c

EntityId: http://oir.serviceplatformen.dk/service/debitorregistreringafsend/3

Beskrivelse

Servicen indeholder en enkelt operation, callDemoService, hvor man kan afsende og modtage en simple tekststreng.

Servicen er kun tilgængelig i Serviceplatformens eksterne testmiljø.

For uddybning af integrationen se den vedhæftede dokumentation.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/demo/DemoService/1

UUID: d8a062c0-27d1-11e6-b67b-9e71128cae77

EntityId: http://demo.prod-serviceplatformen.dk/service/DemoService/1

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/SP/Demo/1

UUID: d8a062c0-27d1-11e6-b67b-9e71128cae77

EntityId: http://demo.prod-serviceplatformen.dk/service/DemoService/1

Beskrivelse

Afsendersystem:
Serviceplatformen udstiller en synkron SOAP-service, som et afsendersystem kan kalde med en anmodning om udveksling/overdragelse af et sagsdokument, journalnotat eller formular. Da sagsdokumenter kan være datamæssigt store, overføres selve sagsdokumenter via SFTP, og der refereres til sagsdokumentet i anmodningen.

Serviceplatformen kalder en synkron service udstillet af afsendersystemet umiddelbart efter, modtagersystemet har modtaget anmodning, med en teknisk kvittering, der angiver om modtagersystemet kan teknisk forstå anmodningen (accepteret/afvist).

Såfremt modtagersystemet er Digital Post, vil den tekniske kvittering angive om anmodning kunne videregives til en modtagermyndighed (accept/afvist).

Når anmodningen er forretningsmæssig behandlet i modtagersystemet vil Serviceplatformen kalde afsendersystemet på samme synkrone service, som anvendes til teknisk kvittering, med en forretningsmæssig kvittering med accept eller afvisning af anmodningen.

Der modtages ikke en forretningsmæssig kvittering, hvis modtagersystem er Digital Post.

Modtagersystem:
Serviceplatformen kalder en synkron service på modtagersystemet med en anmodning fra et afsendersystem. Modtagersystemet svarer med en teknisk accept eller afvisning af anmodningen. Er det et sagsdokument, som der modtages en anmodning på, undersøger modtagersystem om dokumentet kan hentes via SFTP, før der svares på servicekaldet. Dokumentet hentes efterfølgende.

Når modtagersystemet har forretningsmæssigt behandlet en anmodning, kan modtagersystemet via en service udstillet af Serviceplatformen svare med en kvittering, som indeholder en forretningsmæssig accept eller afvisning af anmodningen.

Digital Post:
Sendes en anmodning til Digital Post, vil Serviceplatformen kalde Digital Post og alene modtage en transportkvittering som svar. Såfremt modtageren ønsker at afvise anmodningen, skal dette ske via mail-korrespondance.

Servicens datagrundlag:
Fordelingskomponenten selv indeholder kun data, der gør det muligt at fordele anmodning. Disse data er følgende:

- Myndighed
- KLE emne
- KLE emne facet
- SystemUUID

De tre første parametre angives i anmodning, og kan herefter opløses til SystemUUID.

Servicen er udstillet med følgende sikkerhedsmodeller:
- AuthorityContext
- SAML-token

Udveksling mellem UDK og kommunerne vil være dækket af en fælles databehandleraftale for de fælleskommunale systemer. Er der tale om systemer, der ikke er fælleskommunale, skal det undersøges, om udvekslingen er dækket af en databehandleraftale. Afsender og modtager skal også verificere om leverandøren af modtager- og afsendersystem har den fornødne instruks til databehandling.

Ønsker afsender og modtager at udveksle formularer, skal afsender og modtager selv indgå aftale om dette, samt aftale og definerer formularen.

Afsender
Digital Post skal være konfigureret til at anvende KOMBIT som afsendersystem, og der skal være opsat et materialeID, som kan anvendes af Fordelingskomponenten.

Når serviceaftale oprettes, skal Digital Post SysID og materialeID angives, samt en e-mail, hvor en afsender kan kontaktes i forbindelse med modtagelse af en anmodning gennem Digital Post.

Tilslutning til simpel SFTP på Serviceplatformen.

Modtager
Konfiguration af KLE-emne, KLE-emnefacet i relation til myndighed og system, så anmodninger kan rutes korrekt til et modtagersystem eller Digital Post.

Tilslutning til simpel SFTP på Serviceplatformen.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/SP/Distribution/3

UUID: 74d3c5f5-1b3c-4c6d-8366-1241f055d332

EntityId: http://sp.serviceplatformen.dk/service/fordeling/3

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/SP/Distribution/3

UUID: 74d3c5f5-1b3c-4c6d-8366-1241f055d332

EntityId: http://sp.serviceplatformen.dk/service/fordeling/3