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

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

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

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/DebitorkontoAnmodningSvarAfsendService_1

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

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

Beskrivelse

Servicen omfatter beskedtypen: DebitorkontoStatusSkift

For uddybning af servicen se den vedhæftede dokumentation.

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/SP/Demo/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

Beskrivelse

Servicen indeholder to operationer:

- Kassér – anvendes til fysisk sletning af dele af forretningsobjektet Dokument, fx sletning af en relation.

- Fjern – anvendes til fysisk sletning af et eller flere forretningsobjekter af typen Dokument. Dokumenter kan også fjernes i sammenhæng med sletning af en eller flere sager – se servicen SagDokumentIndeksService.

Servicen er udstillet med følgende sikkerhedsmodel:

- OIO IDWS

Eksternt testmiljø

Endpoint: https://sagsogdokumentindeks.eksterntest-stoettesystemerne.dk/dokumentindeks/6

Produktionsmiljø

Endpoint: https://sagsogdokumentindeks.stoettesystemerne.dk/dokumentindeks/6

Beskrivelse

Servicen indeholder tre operationer:

- SagListeHent (returnerer en liste over UUID og partinformation (CPR mv.) for de sager datarekvirent har adgang til.)
- SagHent (returnerer detaljer om en specifik sag, herunder en liste med dokument-UUID og tilhørende metadata, der er bevilget adgang til på sagen. Læsningen er baseret på sagens UUID.)
- DokumentFilHent (returnerer en fil, der indeholder selve dokumentet (fx PDF). Læsningen baseres på sagens UUID og dokumentets UUID.)

Beskrivelse

Servicen kræver en liste af PersonCPRNummer og en liste af IndkomstÅr, og returnerer de i dataudvekslingsaftalen specificerede data fra den gældende årsopgørelse for de udvalgte IndkomstÅr for de udvalgte PersonCPRNummer. Med udgangspunkt i DIGST Fælles Retningslinjer for webservices R19, R21 og R22 er der yderligere søgeparametre, som kan benyttes.

Der kan defineres en periode ved at bruge UdstillingRegistreringFra og/eller UdstillingRegistreringTil, som vil resultere i, at der kun leveres årsopgørelser, der i den angivne periode, er registreret som udstillet på GUL og dermed gjort tilgængelig for serviceanvenderne. Dette kan fx bruges til at hente årsopgørelser, der er blevet tilgængelige siden der sidst blev forespurgt på løsningen, ved at udfylde UdstillingRegistreringFra med det tidspunkt, hvor der sidst blev forespurgt.

Som udgangspunkt leveres kun aktuelle årsopgørelser, men ved brug af ÅrsopgørelseGyldigFra og/eller ÅrsopgørelseGyldigTil kan der defineres en periode, som vil resultere i at servicen leverer alle årsopgørelser, som har en gyldighedsperiode, der helt eller delvist overlapper med denne periode.

En given årsopgørelse med tilhørende ÅrsopgørelseOpgørelseNummer ændres ikke, med den undtagelse, at der tilføjes en ÅrsopgørelseGyldigTil, hvis der dannes en ny årsopgørelse for det aktuelle IndkomstÅr, som gør, at denne årsopgørelse ikke længere er den gældende. Det er altså muligt at se, om en årsopgørelse er den gældende årsopgørelse for den aktuelle person i det specifikke år, ved at se, om ÅrsopgørelseGyldigTil er sat. Vær opmærksom på, at en ny årsopgørelse ikke nødvendigvis resulterer i synlige ændringer, da aftalen specificeret i aftalemodulet ikke nødvendigvis omfatter de felter, som er påvirkede.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/DUPLA_1

UUID: a38f0fd8-2a99-40db-b194-56dddf750afb

EntityId: http://entityid.kombit.dk/service/duplaaarsopgoerelsehent/1

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/DUPLA_1

UUID: a38f0fd8-2a99-40db-b194-56dddf750afb

EntityId: http://entityid.kombit.dk/service/duplaaarsopgoerelsehent/1

Beskrivelse

Serviceanvender skal ved hjælp af en aftale i DUPLA Aftalemodul specificere de nødvendige felter i forhold til det konkrete anvendelsesformål. Servicen returnerer udelukkende de felter til serviceanvender, som er specificeret i aftalen.

Strukturen af Forskudsopgørelsen ændres hvert år i takt med at skattelovgivningen ændrer sig. Der vil derfor hvert år være ændringer i servicens indhold, der som regel vil bestå af tilføjelse af data.

Som anvender af servicen skal man derfor være indstillet på, at servicen er genstand for et ”årsrul”, hvor der kan blive tilføjet flere felter til servicesvaret. Alle data er dog valgfri i den forstand, at de til- og fravælges i den profil, der opsættes for en anvender i samarbejde med Udviklings- og forenklingsstyrelsen (UFST), og man vil derfor kun modtage felter, der er i overensstemmelse med den opsatte profil, og ikke nye uventede felter. I den forstand er servicen bagudkompatibel.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/DUPLAForskudsopgorelser_1

UUID: c33b49c3-1e14-4a3e-bace-2724aadf18b1

EntityId: http://entityid.kombit.dk/service/sp/duplaforskudsopgoerelser/1

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/DUPLAForskudsopgorelser_1

UUID: c33b49c3-1e14-4a3e-bace-2724aadf18b1

EntityId: http://entityid.kombit.dk/service/sp/duplaforskudsopgoerelser/1

Beskrivelse

Serviceanvender skal ved hjælp af en aftale i DUPLA Aftalemodul specificere de nødvendige felter i forhold til det konkrete anvendelsesformål. Servicen returnerer udelukkende de felter til serviceanvender, som er specificeret i aftalen.

Strukturen af data ændres hvert år i takt med at skattelovgivningen ændrer sig. Der vil derfor hvert år være ændringer i servicens indhold, der som regel vil bestå af tilføjelse af data.

Som anvender af servicen skal man derfor være indstillet på, at servicen er genstand for et ”årsrul”, hvor der kan blive tilføjet flere felter til servicesvaret.
Alle data er dog valgfri i den forstand, at de til- og fravælges i den profil, der opsættes for en anvender i samarbejde med Udviklings- og forenklingsstyrelsen (UFST), og man vil derfor kun modtage felter der er i overensstemmelse med den opsatte profil, og ikke nye uventede felter. I den forstand er servicen bagudkompatibel.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/DUPLAKontroloplysninger_1

UUID: 794b1262-fbb1-4dbd-860a-aff40e229d85

EntityId: http://entityid.kombit.dk/service/sp/duplakontroloplysninger/1

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/DUPLAKontroloplysninger_1

UUID: 794b1262-fbb1-4dbd-860a-aff40e229d85

EntityId: http://entityid.kombit.dk/service/sp/duplakontroloplysninger/1