Status
Kategori
Webservice / Serviceplatformen
DebitorRegistreringAfsend

Formål

Servicen understøtter, at fagsystemet kan oprette og ajourføre sine krav i kommunens debitorsystem. Servicen understøtter her og nu dataudveksling, straksleverance, af debitorregistreringer under en debitorkonto.

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

Formål

Servicen understøtter, at fagsystemet kan oprette og ajourføre sine krav i kommunens debitorsystem. Servicen understøtter her og nu dataudveksling, straksleverance, af debitorregistreringer under en debitorkonto.

Beskrivelse

For uddybning af servicen se den vedhæftede dokumentation.

Eksternt testmiljø

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

UUID: f5a2be30-a6e2-4162-86e9-9e6a756e8060

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

Produktionsmiljø

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

UUID: f5a2be30-a6e2-4162-86e9-9e6a756e8060

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

Webservice / Serviceplatformen
DemoService

Formål

Servicens formål er at vise, at man via et simpelt servicekald har teknisk adgang til Serviceplatformen.

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

Webservice / Serviceplatformen
DistributionService

Formål

Man kan tilslutte sig Fordelingskomponent som modtagersystem eller afsendersystem eller begge dele. Der udstilles et sæt services til et afsendersystem og et andet sæt services til et modtagersystem. Disse er beskrevet hver for sig nedenfor.

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

Webservice / Fælleskommunalt Sags- og Dokumentindeks
DokumentIndeksService

Formål

Servicen anvendes til fysisk sletning af dele af forretningsobjektet Dokument i Sags- og Dokumentindeks.

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

Webservice / Digitalisering - Udsatte Børn og Unge 3.0
DUBUSagHent

Formål

Med webservicen kan et anvendersystem tilgå sager og dokumenter i løsningen DUBU, som en sagsbehandler har bevilget adgang til.

Der returneres kun data om sager, som anvendersystemet (datarekvirenten) har fået tildelt adgang til.

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

Webservice / Serviceplatformen
DUPLAÅrsopgørelseHent

Formål

Formålet med servicen er at levere udvalgte data for en liste af årsopgørelser fra et eller flere indkomstår om én eller flere personer.

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 denne aftale.

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

Webservice / Serviceplatformen
DækningAfskrivningRegistreringAfsend

Formål

Servicens formål er, at debitorsystemet kan informere fagsystemet om de indbetalinger og afskrivninger, som er foretaget på krav oprettet af og overført fra fagløsningen til debitorsystemet.

Beskrivelse

For uddybning af servicen se den vedhæftede dokumentation.

Eksternt testmiljø

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

UUID: 67275f52-f9a2-484e-a869-92cad1a5572c

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

Produktionsmiljø

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

UUID: 67275f52-f9a2-484e-a869-92cad1a5572c

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

Webservice / Serviceplatformen
eSkattekortService

Formål

Servicen er en synkron webservice, hvormed et anvendersystem kan hente oplysninger om skattekort fra SKATs løsning eIndkomst.

Beskrivelse

Et anvendersystem forespørger på oplysninger om skattekort ved kald af service på Serviceplatformen, som gennemstiller kaldet fra fagsystemet til SKATs løsning eIndkomst. eIndkomst svarer synkront på kaldet til Serviceplatformen, som gennemstiller kaldet fra eIndkomst til fagsystemet.

Anvendersystemet identificerer sig med det SE-nr. som ansættelsesforholdet er oprettet under. Herudover medgives personnummer for borgeren, samt periode man ønsker at hente et skattekort for. Det er også muligt at hente en liste med skattekort fra en dato og frem til det aktuelle gyldige skattekort.

Output er:
- Skattekort eller liste af skattekort. Skattekort kan være hoved- eller bi-kort.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/SKAT/eSkattekort/2

UUID: 47d79e13-02cf-42f3-ad7e-2654b2a70427

EntityId: http://skat.serviceplatformen.dk/service/eskattekort/2

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/SKAT/eSkattekort/2

UUID: 47d79e13-02cf-42f3-ad7e-2654b2a70427

EntityId: http://skat.serviceplatformen.dk/service/eskattekort/2

Webservice / Fælleskommunalt Klassifikationssystem
FacetService

Formål

Servicen anvendes til at arbejde med enkeltobjekter af typen "Facet".
Servicen udstiller otte OIO-operationer.

Beskrivelse

Med servicesystemrollen ”Udstil” kan operationerne List, Læs og Soeg benyttes:

- List tager flere objekt-UUID’er som input og returnerer objekternes egenskaber. Objekters ændringer kan tilvælges.
- Læs tager et objekt-UUID som input og returnerer objektets egenskaber. Objekters ændringer kan tilvælges.
- Soeg tager et eller flere søgekriterier som input og returnerer de objekt-UUID’er, der matcher kriterierne.

Med servicesystemrollen ”Rediger” kan operationerne Importer, Opret, Passiver, Ret og Slet benyttes:

- Importer tager et objekts egenskaber inkl. objekt-UUID som input, skaber objektet med livscyklustilstand ”Importeret” og returnerer en status.
- Opret tager et objekts egenskaber ekskl. objekt-UUID som input, skaber objektet med livscyklustilstand ”Oprettet” og returnerer en status og et objekt-UUID.
- Passiver tager et objekt-UUID som input, ændrer objekts livscyklustilstand til ”Passiveret” og returnerer en status.
- Ret tager et objekts egenskaber inkl. objekt-UUID som input, opdaterer objektets egenskaber og returnerer en status.
- Slet tager et objekt-UUID som input, ændrer objektets livscyklustilstand til ”Slettet” og returnerer en status.

Servicen anvender følgende sikkerhedsmodel:
SAML Token

Eksternt testmiljø

Endpoint: https://klassifikation.eksterntest-stoettesystemerne.dk/facet/7

Produktionsmiljø

Endpoint: https://klassifikation.stoettesystemerne.dk/facet/7

Formål

Servicen anvendes til at arbejde med enkeltobjekter af typen "Facet".
Servicen udstiller otte OIO-operationer.

Beskrivelse

Med servicesystemrollen ”Udstil” kan operationerne List, Læs og Soeg benyttes:

- List tager flere objekt-UUID’er som input og returnerer objekternes egenskaber. Objekters ændringer kan tilvælges.
- Læs tager et objekt-UUID som input og returnerer objektets egenskaber. Objekters ændringer kan tilvælges.
- Soeg tager et eller flere søgekriterier som input og returnerer de objekt-UUID’er, der matcher kriterierne.

Med servicesystemrollen ”Rediger” kan operationerne Opret, Importer, Passiver, Ret og Slet benyttes:

- Opret tager et objekts egenskaber ekskl. objekt-UUID som input, skaber objektet med livscyklustilstand ”Oprettet” og returnerer en status og et objekt-UUID.
- Importer tager et objekts egenskaber inkl. objekt-UUID som input, skaber objektet med livscyklustilstand ”Importeret” og returnerer en status.
- Passiver tager et objekt-UUID som input, ændrer objekts livscyklustilstand til ”Passiveret” og returnerer en status.
- Ret tager et objekts egenskaber inkl. objekt-UUID som input, opdaterer objektets egenskaber og returnerer en status.
- Slet tager et objekt-UUID som input, ændrer objektets livscyklustilstand til ”Slettet” og returnerer en status.

Servicen anvender følgende sikkerhedsmodel:
SAML Token

Eksternt testmiljø

Endpoint: https://klassifikation.eksterntest-stoettesystemerne.dk/facet_6

Produktionsmiljø

Endpoint: https://klassifikation.stoettesystemerne.dk/facet_6

Webservice / Serviceplatformen
FakturaInformationAfsend

Formål

Formålet med servicen er at give et faktureringssystem mulighed for at oversende en elektronisk faktura til et fagsystem til behandling og eventuel godkendelse eller afvisning.

Servicen indgår i et asynkront integrationsmønster med FakturaInformationSvarAfsend, hvor fagsystemet kan sende et svar på fakturabehandlingen.

Beskrivelse

For uddybning af integrationen se den vedhæftede dokumentation.

Eksternt testmiljø

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

UUID: 68b85457-8219-4677-a213-79f4253158c7

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

Produktionsmiljø

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

UUID: 68b85457-8219-4677-a213-79f4253158c7

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