Integration 1411_B Hent information om helbredsprocent Integrationsbeskrivelse - version 2.4.1

Transkript

1 Integration - version Kommunernes Data & Infrastruktur KDI

2 Versionshistorik Relevans Dato Initialer Version Kommentarer EHE Teknisk beskrivelse godkendt XMHL Integration til Kommunal Pension er fjernet i hele dokumentet. Tillige er funktionaliteten på SP relateret til denne fjernet, så transformering af data, routing og håndtering af fejlkode 251 udgår. Afsnit 4 er opdateret. Opdateret med opdateret snitflade hos KMD (P15-1_B) Opdateret med forudsætninger og vilkår for tilslutning er tilføjet i kapitel 1.5. Omskrevet vilkår for konkrete parter (kapitel 2.x.3). XMHL Opdateret med ny snitfladebeskrivelse og WSDL fra KMD (P15-1_B) Ændring af brug af dato i request i afsnit XMHL Der er tilføjet information om udfyldning af request i afsnit XMHL Opdateret [WSDL-SP] Der er tilføjet en note vedr. validering på Serviceplatformen i afsnit XMHL Opdateret [WSDL-SP] pga. opsplitning af SF1411_A og SF1411_B i to separate services. Derudover mindre redaktionelle rettelser: Fjernet referencen [SPRef]. Opdateret afsnit om Service Management med ny kontakt- . Opdateret afsnit om test i forbindelse med udvikling. Fjernet afsnit om Service Management i afsnit 3.1 og 3.2. XMHL Opdateret med ny version af [P15-1] og [Bilag]. Ændring påvirker ikke denne service. Referencer Ref. Titel Kommentarer [STS-Sikkerhed] [WSDL-SP] [Bilag] Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link n refererer til SF1411_B Teknisk Spec zip som indeholder WSDL på Serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link er%20release.aspx n refererer til SF1411_B Bilag zip som indeholder WSDL af eksterne interfaces, samt yderligere dokumentation, som er placeret i samme mappe som integrationsbeskrivelsen, se link er%20release.aspx [WSDL-EXT] HentHelbredsProcentOplysning2_0.wsdl Se gældende version af [Bilag] [P15-1] P15-1 Løsningsbeskrivelse Ver 1.18 Se gældende version af [Bilag] KOMBIT A/S Halfdansgade København S CVR Side 2 af 32

3 [SF1411_A_v3] [SF1411_B] [SF1411_D_v3] [SF1411_E] [GVF] [KDIDrift] [KDITest] SF1411_X rne for de relaterede integrationer vedr. social pension Reference til Generelle vilkår og forudsætninger, der skal være på plads før Snitflader kan anvendes: Filen Generelle vilkår og forudsætninger.pdf, som ligger her: Hjemmeside med informationer om drift og forvaltning af KDIs Services Hjemmeside med informationer om ibrugtagning og test af KDIs Services: De fire beskrivelser om social pension er indbyrdes afhængige og bør læses i sammenhæng. KOMBIT A/S Halfdansgade København S CVR Side 3 af 32

4 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Forudsætninger for produktionssætning af integration social pension Kontekst for integrationsparter Kontekst for Fagsystem [!@FS@!] Kontekst for KMD Social Pension Kommunedel [!@KSPK@!] Specifikation for integrationsparter Specifikation af endpoints for Fagsystem [!@FS@!] Specifikation af endpoints for KMD Social Pension Kommunedel [!@KSPK@!] Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen [!@Systematic@!] KOMBIT A/S Halfdansgade København S CVR Side 4 af 32

5 1 Overordnet beskrivelse 1.1 Integrationens formål Formålet med integrationen er at hente oplysninger om en given persons kommunale helbredssag, herunder oplysninger om: Sagens (helbredskort) status Sagens ejer Helbredsprocent Sygeforsikring Fagsystemet må kun modtage de informationer, der er hjemmel til at anvende. Dataafgrænsning på de forskellige typer af information vil blive aftalt ifm. indgåelse af aftalen om brug af integrationen. Informationerne kommer fra det kommunale pensionssystem KMD Social Pension Kommunedel. Integrationen benyttes bl.a. af fagsystemer, som beregner ydelser med anvendelse af helbredsprocenten, f.eks.kommunale fagløsninger, der håndterer helbredstillæg (herefter omtalt som Fagsystem) Sammenhæng til andre snitflader I forbindelse med monopolbruddet sker der en løbende udskiftning af det nuværende pensionssystem KMD Social Pension. KMD Social Pension består af to dele: KMD Social Pension Kommunedel, som varetager systemunderstøttelsen af de kommunale opgaver, og KMD Social Pension UDK-del, som varetager systemunderstøttelsen af opgaver for UDK. KMD Social Pension Kommunedel erstattes fremadrettet af Social Pension Kommune og KMD Social Pension UDK-del erstattes af UDK Pension. Dette afsnit giver en introduktion til den samlede løsning for området social pension og sammenhængen mellem integrationerne. Det er en fælles tekst, som går igen i alle integrationsbeskrivelser, der omhandler social pension (SF1411). Følgende integrationsbeskrivelser indgår i gruppen: SF1411_A Hent informationer om social pension [SF1411_A] SKAL PT. IKKE BRUGES SF1411_A_V3 Hent informationer om social pension [SF1411_A_V3] SF1411_B Hent helbredsprocent [SF1411_B] SF1411_D Besked om informationer om social pension [SF1411] SKAL PT. IKKE BRUGES SF1411_D_V3 Besked om informationer om social pension [SF1411_D_V3] SF1411_E Besked om helbredsprocent [SF1411_E] Formålet med gruppen af snitflader er at udveksle informationer om social pension samt ændringer i informationer om social pension. Informationerne udveksles mellem fagsystemer (f.eks. Kommunernes Ydelsessystem herefter KY) og de tre pensionssystemer KMD Social Pension, UDK Pension og Social Pension Kommune (andre systemer kan komme til). Serviceplatformen samt fag- og pensionssystemernes snitflader til støttesystemet Beskedfordeler (herefter: Beskedfordeler) beskrives i følgende integrationsbeskrivelser: KOMBIT A/S Halfdansgade København S CVR Side 5 af 32

6 SF1460_A Modtag besked [SF1460_A] SF1460_B Vedligeholde værdiliste i beskedabonnement [SF1460_B] SF1460_C Aflever besked [SF1460_C] SF1460_D Modtag besked via pull [SF1460_D] Transitionen består af fire faser, som er beskrevet nedenfor. Forventet tidsplan for de to nye pensionssystemer kan ses på Nuværende: Begge snitflader er udstillet af KMD Social Pension Data udstilles af det nuværende pensionssystem, KMD Social Pension. KMD Social Pension udstiller: SF1411_A Hent informationer om social pension [SF1411_A] skal pt. ikke bruges SF1411_B Hent helbredsprocent [SF1411_B] SF1411_D Besked om informationer om social pension [SF1411_D] forventes ikke idriftsat SF1411_E Besked om helbredsprocent [SF1411_E] UDK Pension idriftsættes big bang UDK Pension idriftsættes og afløser KMD Social Pension. Den kommunale del af løsningen kører videre hos KMD i en interimsløsning. UDK Pension udstiller: SF1411_A_V3 Hent informationer om social pension [SF1411_A_V3] SF1411_D_V3 Besked om informationer om social pension [SF1411_D_V3] KMD Social Pension interim udstiller: SF1411_B Hent helbredsprocent [SF1411_B] SF1411_E Besked om helbredsprocent [SF1411_E] Social Pension Kommune idriftsættes big bang (forventet) Social Pension Kommune idriftsættes og afløser KMD Social Pension interim. UDK Pension udstiller: SF1411_A_V3 Hent informationer om social pension [SF1411_A_V3] SF1411_D_V3 Besked om informationer om social pension [SF1411_D_V3] KMD Social Pension Kommune udstiller: SF1411_B Hent helbredsprocent [SF1411_B] SF1411_E Besked om helbredsprocent [SF1411_E] KOMBIT A/S Halfdansgade København S CVR Side 6 af 32

7 Målarkitektur: UDK Pension og Social Pension Kommune De to nye pensionssystemer er taget i brug. Det forventes, at integrationerne tilpasses den ønskede målarkitektur og udgives som en ny version af servicen, V4. UDK Pension udstiller: SF1411_V1_V4 Hent informationer om social pension [SF1411_A_V4] SF1411_D_V4 Besked om informationer om social pension [SF1411_D_V4] Social Pension Kommune udstiller følgende for migrerede kommuner: SF1411_B Hent helbredsprocent [SF1411_B] SF1411_E Besked om helbredsprocent [SF1411_E] KOMBIT A/S Halfdansgade København S CVR Side 7 af 32

8 KMD Social Pension Serviceplatformen Fagsystem(n) 1.2 Overordnet forretningsflow i integrationen Følgende forretningsflow indgår i integrationen: IF01 Hent helbredsprocent Fagsystemet forespørger om informationer relateret til en borgers helbredssag via en synkron service udstillet på Serviceplatformen. Serviceplatformen gennemstiller kaldet til en synkron service hos det kommunale pensionssystem, KMD Social Pension. KMD Social Pension svarer på forespørgslen, og Serviceplatformen gennemstiller svaret til fagsystemet. Integrationen er en gennemstillingsintegration. Integrationens forretningsflow er illustreret på nedenstående diagram: IF01 Hent helbredsprocent Hent oplysninger EP_FS1 Gennemstilling EP_KS1 Send oplysninger KOMBIT A/S Halfdansgade København S CVR Side 8 af 32

9 1.3 Servicebetingelser for den samlede integration Servicemål Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Flow IF01 Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. [Afklaring/KDF indsæt servicemål for KMD Social Pension] Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder [Afklaring/KDF indsæt servicemål for KMD Social Pension] Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. [Afklaring/KDF indsæt servicemål for KMD Social Pension] Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage. [Afklaring/KDF indsæt servicemål for KMD Social Pension] Ved mindre opdateringer for Serviceplatformen: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time. Ved større og kritiske opdateringer: Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services for Serviceplatformen: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer. [Afklaring/KDF indsæt servicemål for KMD Social Pension] Service Management Informationer om driftsmeddelelser, forespørgsler og kontaktinformationer, findes på siden for Drift og Forvaltning af KDIs Services her: [KDIDrift] 1.4 Teststrategi Test i forbindelse med udvikling Den planlagte test af services til installation på Serviceplatformen omfatter pt., at der udfører automatiserede tests af services og unittests. KOMBIT A/S Halfdansgade København S CVR Side 9 af 32

10 Der er tale om en robust test af sikkerhed, routing og anden kernefunktionalitet i integrationen, samt mere en simpel test af, om de enkelte operationer kan benyttes, stikprøvekontrol. Testen omfatter ikke samtlige dataelementer i operationerne. Leverandøren af Serviceplatformen er ansvarlig for denne test. Det generelle udgangspunkt for KOMBITs teststrategi er, at alle involverede parter har gennemført en robust systemtest af egen løsning, før der gennemføres test parterne imellem. Generelle informationer om ibrugtagning og test, samt kontaktinformationer for specifikke ønsker, kan findes via [KDITest]. 1.5 Forudsætninger for produktionssætning af integration social pension For at kunne anvende snitfladen er der en række vilkår og forudsætninger, som skal være opfyldt af den integrationspart, der skal tilsluttes. Ved integrationspart skal forstås anvendersystemer, kildesystem osv. Disse vilkår og forudsætninger er opdelt i en generelle vilkår og forudsætninger, som gælder på tværs af snitfladerne og i specifikke vilkår og forudsætninger for tilslutning til selve snitfladen. De generelle vilkår og forudsætninger er beskrevet i et samlet dokument [GVF], mens de specifikke aktiviteter, der skal udføres som forudsætning for tilslutning af en integrationspart, er beskrevet for hver enkelt integrationspart i kapitel Køreplan for Implementering Nedenstående diagram viser køreplanen for udrulningen, som anvendersystem inden for KOMBITs rammearkitektur under monopolbrudsprojektet følger. Det væsentlige i køreplanen er faserne, mens en egentlig tidsplan vil følge den faktiske implementeringsplan. Aktiviteter, som er forudsætninger og betingelser i forbindelse med ibrugtagning af en snitflade, som følge af en udrulning af et anvendersystem, vil referere til den fase, den hensigtsmæssigt kan udføres i. Serviceplatformen: Ved idriftsættelse af en snitflade er alle aktiviteter afsluttet, og snitfladen er klar til anvendelse. Eksternt system: Alle aktiviteter i forhold til Serviceplatformen er afsluttet, men der kan være yderligere aktiviteter i forbindelse med tilslutning af et anvendersystem eller en kommune i forhold til kildesystemet. Anvender-/fagsystem og kommune: Ved tilslutning af et anvendersystem og/eller en kommune, er der en række aktiviteter op til idriftsættelse, dels af aftalemæssig karakter, og dels også af konfigurationsmæssig karakter, som skal udføres. Er der aktiviteter, som medfører konfiguration på Serviceplatformen, vil dette ske i forbindelse med leverandørens oprettelse af serviceaftalen for kommunen. KOMBIT A/S Halfdansgade København S CVR Side 10 af 32

11 1.5.2 Særlige vilkår [Til brug for servicekataloget på Serviceplatformen er der behov for kort at beskrive vilkår der er specifikke for den pågældende integration. Det vil typisk være indgåelse af aftale mellem anvendersystem og kildesystem. Aftale inde for rammearkitekturen skal ikke beskrives. Er der ingen specifikke vilkår for integrationen anvendes nedenstående tekst. Vilkår for servicen Der er ingen specielle vilkår for brug af nærværende service ud over de generelle vilkår, der er beskrevet under vilkår for hhv. leverandører og kommuner.] Supplerende information om tilslutning Integrationerne mellem KMD Social Pension og Serviceplatformen er certifikatbaseret. KMD meddeles KOMBIT s OCES certifikat senest tre uger før, grænsefladerne kan tages i brug. [Afklaring/KDF: Tilføj yderligere dokumentation med vejledning i brug af sikkerhedsmodellen, herunder brug af Security Token Servicen, støttesystemer, mv. i Rammearkitekturen, når denne modtages fra STS] KOMBIT A/S Halfdansgade København S CVR Side 11 af 32

12 2 Kontekst for integrationsparter 2.1 Kontekst for Fagsystem Lovhjemmel og forvaltningsmæssigt formål [Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen. Det skal afklares med de myndigheder, der anvender fagsystemet, hvilke data de har hjemmel til at se og dermed, hvilken dataafgrænsning, der skal være] Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelig og dækkende analyse. Henvisningen til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering. Det forvaltningsmæssige formål med integrationen er, at fagsystemet indhenter oplysninger om helbredsprocent for en person, samt for en eventuel ægtefælle, så oplysningerne kan indgå i oplysning og beregning af sager om andre ydelser og personlige helbredstillæg Kapacitets- og servicekrav [Udfyldes med oplysninger om forventet kapacitet og servicekrav] Specifikke forhold for tilslutning af system Sikkerheden mellem fagsystemet og Serviceplatformen er tokenbaseret, så de nødvendige rettigheder skal oprettes i det fælleskommunale støttesystem Adgangsstyring før idriftsættelse. ID Aktivitet Opgavekategori TS101 TS102 Anmodning om Serviceaftale Godkendelse af serviceaftale Konfiguration Administrati onsmodul Komponent Ansvarlig Udførende Fase og afhængighed Konfiguration Administrationsmodul Leverandøren af fagsystem Leverandøren af fagsystem Fase 2.2 Kommune Kommune Fase 2.2 Kommentar TS101 - Leverandøren skal anmode om indgåelse af serviceaftale for de Kommuner og myndigheder, der skal bruge servicen, i rammearkitekturens administrationsmodul, og myndigheden skal godkende denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. TS102 - Kommune skal godkende ovenstående serviceaftale. KOMBIT A/S Halfdansgade København S CVR Side 12 af 32

13 2.2 Kontekst for KMD Social Pension Kommunedel KMD Social Pension Kommunedel er dataleverandør Lovhjemmel og forvaltningsmæssigt formål [Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelig og dækkende analyse. Henvisningen til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering. [Udfyldes med det forvaltningsmæssige formål, der ligger til grund for anvendelsen i fagsystemet.] Kapacitets- og servicekrav [Udfyldes med oplysninger om forventet kapacitet og servicekrav] Specifikke forhold for tilslutning af system Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfladen, for at en kommune gennem et KMD Social pension kommunedel kan benytte snitfladen. ID Aktivitet Opgavekategori TS201 TS202 Verificer at instruks for databehandlin g er gældende og korrekt Konfigurer KOMBIT s certifikat Aftale Konfiguration KMD Social Pension Kommunedel KMD Social pension Kommune Komponent Ansvarlig Udførende Fase og afhængighed Leverandøren af fagsystem Fase 1 KDI KMD Fase 1 Kommentar Kan være samme aftale som i SF1411_A TS202 og SF1411_E TS203 TS201 - Når en leverandør behandler data for en kommune, bør der foreligge en instruks for håndtering, opbevaring og behandling af disse data fra kommunen. Når datamassen eller dataudvekslingen ændres bør denne instruks gennemgås og opdateres, hvilket er tilfældet i forbindelse med integration via Serviceplatformen. Det er leverandørens ansvar at sikre at kommunen gennemgår og om nødvendigt opdaterer databehandler instruks eller aftale for leverandørens løsning. TS202 - Der skal gives adgang for Serviceplatformen til at kalde KMD Social pension med KOMBIT s OCES certifikat, hvilket betyder at certifikatet konfigureres i KMD Social pensions sikkerhedsmodul. KOMBIT A/S Halfdansgade København S CVR Side 13 af 32

14 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for Fagsystem Integrationen udstilles som en service på Serviceplatformen, således at fagsystemet kan foretage et opslag og få information om en persons helbredsprocent Overordnet forretningslogik Fagsystemet kalder Serviceplatformen, som udstiller en synkron service, der udstiller informationer om helbredsprocent for en given person: 1. Fagsystemet kalder EP_FS1 2. Serviceplatformen returnerer et synkront svar til fagsystemet Oversigt over endpoints ID Navn Reference til WSDL Servicenavn på Serviceplatformen EP_F S1 OpslagsserviceHelbred sprocent [WSDL-SP] wsdl/token/opslagsservicehelbredsproc entservice.wsdl Servicenavn: OpslagsserviceHelbredsprocentService Operationsnavn: HentHelbredsProcentOperation OpslagsserviceHelbred sprocent Version på Serviceplatfo rmen Beskrivelse af endpoint EP_FS1 OpslagsserviceHelbredsprocent Transportspecifikation Integrationsmønster Integrationen er en synkron web service udstillet af Serviceplatformen og kaldt af fagsystemer Serviceudstiller Serviceplatformen er serviceudstiller Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Oplysninger om endpoint er angivet i tabellen i afsnit Teknisk retning for udveksling Fagsystemet kalder en service udstillet på Serviceplatformen. KOMBIT A/S Halfdansgade København S CVR Side 14 af 32

15 Dataretning for udveksling Serviceplatformen udstiller data fra KMD Social Pension Kommunedel til fagsystemet Service invokation / Triggers Endpoint kaldes af fagsystemet, når der opstår behov for at få oplysninger om en persons helbredssag f.eks. i forbindelse med udregning af ydelser og personlige tillæg Dataspecifikation Forespørgsler Der forespørges på informationer om helbredsprocent for én person ad gangen. Forespørgsler sker med følgende input parametre til webservicen. Forespørgslen består af standard CallContext for Serviceplatformen og et Request. CallContext: Feltnavn Type Beskrivelse OnBehalfOfUser string Navn på det kaldende system (udfyldes kun af systemer, der kalder Serviceplatformen med certifikat informationen skal ikke bruges af kildesystemet) CallerServiceCallerIdentifier string Transaktionsid. UUID genereres af afsender. OBS! Dette felt er obligatorisk og skal udfyldes, selvom det ikke fremgår af schemaet. AccountingInfo string Afdelingsnavn defineres af det kaldende system; f.eks. Sagsafklaring eller Sagskontrol i fagsystemet (udfyldes kun af systemer, der kalder Serviceplatformen med certifikat informationen skal ikke bruges af kildesystemet) Request: KOMBIT A/S Halfdansgade København S CVR Side 15 af 32

16 Feltnavn Type Beskrivelse ID URN Pensionistens CPR-nr: urn:oio:cpr-nr:nnnnnnnnnn FraTidspunkt datetime Se beskrivelse nedenfor. bool TilTidspunkt datetime Se beskrivelse nedenfor. bool Myndighed URN Forespørgende kommunes cvr-nummer: urn:oio:cvr-nr:nnnnnnnn SagsomraadeKode String Fagsystemet tildeles en SagsomraadeKode ifm. indgåelse af aftale om brug af servicen. Informationen bruges til dataafgrænsning jf. lovhjemmel angivet i afsnit Fejl! Henvisningskilde ikke fundet.. Dataafgrænsningen sker i kildesystemet. CallerServiceCallerIdentifier skal altid udfyldes af fagsystemet. De andre felter i CallContext bruges pt. ikke. Alle felter i Request skal udfyldes. Datosøgning sker i henhold til følgende retningslinjer: Der kan søges på dags dato eller på en periode. Hvis StartDate ikke er udfyldt, tildeles StartDate =dags dato. Hvis EndDate ikke udfyldes, tildeles EndDate værdien af Startdate + 1 dag. Eksempel: Hvis inputfelter vedr. Start- og EndDate er udfyldt således: StartDate = EndDate = (blank/ikke udfyldt), så tildeles EndDate værdien Hvis der søges på en periode skal både fra- og tiltidspunkt være udfyldt og fratidspunkt skal være mindre end tiltidspunkt. Hvis en slutdato løber uendeligt / er ukendt, sættes GraenseIndikator til true, dvs. antages uendelig til Svar Servicen returnerer et svar med nedenstående felter. Omfanget af data, der kan ses hos modtageren, skal afgrænses på baggrund af den SagsområdeKode, der er indsendt i forespørgslen (se afsnit Fejl! Henvisningskilde ikke fundet.). KOMBIT A/S Halfdansgade København S CVR Side 16 af 32

17 Der returneres kun den sidste registrering (dette svarer til indholdet af KMD SP, Kommune). [Afklaring/KDF afsnit ovenfor skal evt. opdateres ifm. aftale med KMD] Feltnavn Type Beskrivelse ID UUID/ URN Helbredssagens unikke identifikation. KMD SP: URN med følgende indhold (værdi som sendt til KMD Sag): urn:oio:kmd:sag:leverandoer_coid_sagsnoegle:nnnnnnnnnnnnnnnnnnnnnnn NoteTekst string Udfyldes ikke. Tidspunkt datetime Udfyldes med tidsstempel for ændring eller oprettelse af sagsobjektet. LivscyklusKode string Udfyldes med Oprettet (Ny sag) eller Rettet (Ændret sag). KMD SP: Udfyldes altid med Rettet. BrugerRef URN Udfyldes med bruger der har ændret eller oprettet sagen hvis kendt "urn:oio:objekttype:kspid:<racfid>" KMD SP: Udfyldes ikke. AttributListe TilstandListe RelationListe Se nedenfor Se nedenfor Se nedenfor KOMBIT A/S Halfdansgade København S CVR Side 17 af 32

18 Denne definition er fælles for alle virkninger, og beskrives derfor kun her Feltnavn Type Beskrivelse FraTidspunkt datetime Dato (og eventuel tid) for virkningens start. Tidspunkt er inklusive bool Hvis værdien udelades eller GraenseIndikator sættes til true antages TilTidspunkt AktoerRef datetime bool AktoerType string Kode NoteTekst URN Udfyldes ikke. uendelig fra Dato (og eventuel tid) for virkningens slut. Tidspunkt er eksklusive OBS! Hvis kun dato er udfyldt, skal det være dagen efter sidste dag. Hvis værdien udelades eller GraenseIndikator sættes til true antages uendelig til. Hvis TilTidspunkt angives som dato(/tid) skal det være større end (dvs. efter) FraTidspunkt. Udfyldes med bruger der har ændret eller oprettet sagen hvis kendt "urn:oio:objekttype:kspid:<racfid>" KMD SP: Udfyldes ikke. Udfyldes med Bruger hvis AktoerRef er angivet. KMD SP: Udfyldes ikke. KOMBIT A/S Halfdansgade København S CVR Side 18 af 32

19 Feltnavn Type Beskrivelse AttributListe Se specifikationen nedenfor FremdriftStatus Kode string Udfyldes med sagens status i henhold til OIO-Sag: (Mappes bedst muligt til sagsstatus i systemet) Opstået : Noget kræver myndighedens ageren. Oplyst : Sagen er fuldt oplyst. Afgjort : Der er truffet afgørelse om sagen, fx bevilling eller afslag. Der må ikke tilføjes mere til sagen. Bestilt : Indsats, betalingsrække etc. er bestilt hos udfører. Udført : Det bestilte er udført. Afsluttet : Sagsbehandling er fuldført. Hsagsaktoer Hsagsklasse Hsagspart KMD SP: Udfyldes med Afgjort. Se nedenfor Se nedenfor Se nedenfor KOMBIT A/S Halfdansgade København S CVR Side 19 af 32

20 Feltnavn Type Beskrivelse Brugervendt Noegle string Udfyldes med den nøgleværdi der anvendes i præsentationen (sagsnummer). HelbredsProcent Heltal Personlig helbredsprocent. Værdisæt: SelskabId URN Forsikringsselskabets CVR-nummer (urn:oio:cvr-nr:nnnnnnnn) For Sygeforsikringen Danmark udfyldes med urn:oio:cvrnr: SelskabNavn string Navnet på forsikringsselskabet (Sygeforsikringen Danmark ). Kode string Forsikringsgruppe kode klassifikation ( 1, 2, 5, S, Ej oplyst, Nej ). S = Basis sygeforsikring Tekst string Forsikringsgruppe navn til præsentation ( 1, 2, 5, S, Ej oplyst, Nej ). KOMBIT A/S Halfdansgade København S CVR Side 20 af 32

21 Der udfyldes en instans af Hsagsaktoer: Ejer (kommune) Feltnavn Type Beskrivelse Rolle URN Fast værdi: " urn:oio:rolle:ejer". Type URN Fast værdi: "urn:oio:objekttype:myndighed". Indeks string Udfyldes ikke. ReferenceID URN Sagens ejer myndighed (=Kommune) cvr-nummer: "urn:oio:cvrnr:nnnnnnnn". KOMBIT A/S Halfdansgade København S CVR Side 21 af 32

22 Der udfyldes to instanser af Hsagsklasse: KLE emne og KLE handling Feltnavn Type Beskrivelse Rolle URN Fast værdi: "urn:oio:rolle:primaerklasse". Type URN Fast værdi: "urn:oio:objekttype:klasse". Indeks string Udfyldes ikke. ReferenceID URN Sagens primære KLE emneklasse: "urn:oio:kle:nn.nn.nn". Feltnavn Type Beskrivelse Rolle URN Fast værdi: "urn:oio:rolle:handlingklasse". Type URN Fast værdi: "urn:oio:objekttype:klasse". Indeks string Udfyldes ikke. ReferenceID URN Sagens primære KLE emneklasse: "urn:oio:kle-handling:xnn". KOMBIT A/S Halfdansgade København S CVR Side 22 af 32

23 Der angives en instans af HsagsPart for den primære part (Pensionisten). Feltnavn Type Beskrivelse Rolle URN Fast værdi: "urn:oio:rolle:primaerpart" Type URN Fast værdi: "urn:oio:objekttype:person" Indeks string Udfyldes ikke ReferenceID URN Pensionistens CPR-nr: "urn:oio:cpr-nr:nnnnnnnnnn" Sikkerhed Servicen skal udstilles som en fælleskommunal service, der benytter det fælleskommunale støttesystem Adgangsstyring til at autentikere og autorisere, som defineret i RA STS [STS-Sikkerhed]. Det kan være relevant for sagen at lave opslag på borgere, der bor i en anden kommune end den, der ejer pensionssagen. Det er fagsystemets ansvar at sikre, at en myndighed kun kan forespørge på borgere, der indgår i myndighedens egne sager. [Afklaring/KDF Det skal afklares med fagsystemerne, om de har behov for at lave opslag på borgere, der er bosiddende i en anden kommune.] KOMBIT A/S Halfdansgade København S CVR Side 23 af 32

24 KMD Social Pension forventes ikke at udføre dataafgrænsning, så det er fagsystemets ansvar at sikre, at der kun modtages de data, der er hjemmel til, og som der i øvrigt er indgået aftale om. Dataafgrænsningen skal logges i fagsystemet. [Afklaring/KDF Der er indlagt mulighed for dataafgrænsning i snitflade ved angivelse af sagsområdekode. Det skal vurderes, om det er nødvendigt at lave en mapning af, hvad der må modtages ved de forskellige SagsområdeKoder.] Leverancesikkerhed og fejlhåndtering Såfremt endpointet er utilgængelig, er det fagsystemets ansvar at gentage kaldet. I retursvaret vil der indgå en HeaderResponseStructure. Følgende fejl indgår i HeaderResponseStructure: ResponseReturnIdentifier ResponseReasonIdentifier ResponseReasonText 0 0 Ok. Data returneres OK. Ingen sag fundet Valideringsfejl: EndDate er mindre end StartDate Personnummer er ikke udfyldt Forespørgende kommune er ukendt 900 Teknisk fejl. Kontakt KMD Social Pension. Svaret OK. Ingen sag fundet returneres, hvis der ikke er udstedt helbredskort. KOMBIT A/S Halfdansgade København S CVR Side 24 af 32

25 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Værdi Tidsrum Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. Svartid Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder Tilgængelighed Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. Spidsbelastningsperiode Må antages at være i perioden 06:00-18:00 på arbejdsdage Servicevinduer Ved mindre opdateringer: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time. Ved større og kritiske opdateringer: Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer. 3.2 Specifikation af endpoints for KMD Social Pension Kommunedel [!@KSPK@!] Snitfladen benyttes til at udstille informationer om social pension for en given person via et online opslag. Opslaget foretages af Serviceplatformen på vegne af det forespørgende system Overordnet forretningslogik Serviceplatformen kalder pensionssystemet, som udstiller en synkron service, der udstiller informationer om social pension for en given person: 1. Serviceplatformen kalder EP_KS1 2. Pensionssystemet returnerer et synkront svar til Serviceplatformen Oversigt over endpoints ID Navn Reference til WSDL EP _K S1 OpslagsserviceSocialPensionKMD [WSDL-EXT]\ HentHelbredsProcentOplysning2_0 Servicenavn: HentHelbredsProcentOplysning KOMBIT A/S Halfdansgade København S CVR Side 25 af 32

26 Operationsnavn: HentHelbredsProcentOperation Beskrivelse af endpoint EP_KS1 OpslagsserviceSocialPensionKMD Transportspecifikation Integrationsmønster Serviceplatformen kalder KMD Social Pension via en SOAP 1.2 Web Service snitflade Serviceudstiller KMD Social Pension er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Servicen er implementeret som en SOAP web service snitflade og benytter http via en krypteret kanal Teknisk endpoint Oplysninger om endpoint er angivet i tabellen i afsnit Teknisk retning for udveksling Serviceplatformen foretager en forespørgsel mod KMD Social Pension Dataretning for udveksling KMD Social Pension udleverer oplysninger om social pension for en given person Service invokation / Triggers Endpoint kaldes af fagsystemet i forbindelse med udregning af ydelser og personlige tillæg Dataspecifikation Dataspecifikationen for servicen findes i følgende schema-filer: Input: [WSDL-EXT] / Se filen HentHelbredsProcentRequestStructure2_0.xsd Output: [WSDL-EXT] / Se filen HentHelbredsProcentRequestStructure2_0.xsd Der henvises til afsnit Fejl! Henvisningskilde ikke fundet. for yderligere information om indholdet i dataelementer. Se også P15-1 Løsningsbeskrivelse [P15-1]. Valideringer fremgår af ovennævnte dokument og/eller WSDL defineret i afsnit Fejl! Henvisningskilde ikke fundet.. KOMBIT A/S Halfdansgade København S CVR Side 26 af 32

27 Sikkerhed Kommunikationen mellem Serviceplatformen og KMD følger OWSA-T modellen 1 for sikker kommunikation mellem serviceaftager og serviceudbyder baseret på SSL-kryptering samt autentifikation og autorisation via KOMBIT s OCES virksomhedscertifikat indsat i SOAP http-kontekst. Ved brug af KMD Social Pensions opslagsservice [P15-1] skal Serviceplatformen kunne identificeres via et godkendt OCES virksomhedscertifikat, som er knyttet til KMD s sikkerhedssystem (KSP/CICS). Sikkerhedsstyringen til grænsefladerne sker på leverandørniveau i KMD Social Pension, her vil det være Serviceplatformen være leverandør. Alle certifikater skal gennemgå en godkendelsesprocedure i KMD. KMD meddeles leverandørens certifikat senest tre uger før, grænsefladerne kan tages i brug. Autorisation til at se pensionsdata aflæses i det certifikat, der giver rettighed til at anvende grænsefladerne. Den anvendte sikkerhedsmodel omfatter ikke OCES medarbejdercertifikat niveauet. Servicen udstillet af KMD Social Pension placeres på en server, som kræver SSL/HTTPS og et OCESklientvirksomhedscertifikat, som er godkendt hos godkendt CA, primært Dan-ID. Certifikatholderen skal være oprettet i KMD sikkerhedssystem. Snitfladens URI adresse publiceres ikke på Digitaliser.dk. Servicen vil være tilgængelig via internettet. URI adressen udleveres til Serviceplatformen af KMD i forbindelse med aftalt brug af grænsefladen Leverancesikkerhed og fejlhåndtering I tilfælde af fejl / timeout i kommunikationen med KMD Social Pension vil Serviceplatformen informere det kaldende fagsystem med angivelse af fejlen. Da der er tale om en forespørgsel, der kan kaldes gentagne gange for samme person, vil fagsystemet selv være ansvarlig for at kalde igen Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Afklaring/KDF indsæt servicemål for KMD Social Pension] [Afklaring/KDF indsæt servicemål for KMD Social Pension] [Afklaring/KDF indsæt servicemål for KMD Social Pension] [Afklaring/KDF indsæt servicemål for KMD Social Pension] [Afklaring/KDF indsæt servicemål for KMD Social Pension] 1 OWSA-T modellen definerer Anvender som Serviceaftager og KMD som Serviceudbyder. KOMBIT A/S Halfdansgade København S CVR Side 27 af 32

28 KOMBIT A/S Halfdansgade København S CVR Side 28 af 32

29 4 Beskrivelse for integrationsplatforme 4.1 Beskrivelse for Serviceplatformen Nærværende afsnit angiver den integrationsfunktionalitet, som Serviceplatformen håndterer i interaktionen mellem integrationsparter. En integration kan understøttes af flere integrationsflows, som er beskrevet separat i dette afsnit. I hvert integrationsflow indgår der en række endpoints. Hvert endpoint er specificeret i integrationsbeskrivelserne for integrationsparterne, jf. ovenstående afsnit 3. Jf. figuren nedenfor indgår følgende komponenter og endpoints i integrationen. Serviceplatformen KMD Social Pension EP_KS1 IF01 Hent Helbredsprocent EP_FS1 Fagsystem(n) Oversigt over integrationsflows ID Navn IF01 Hent helbredsprocent Integrationsflow IF01: Hent helbredsprocent Integrationsflowet er beskrevet i afsnit Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_FS1 OpslagsserviceHelbredsprocent EP_KS1 OpslagsserviceSocialPensionKMD Integrationstype Integrationen er en gennemstillingsintegration. KOMBIT A/S Halfdansgade København S CVR Side 29 af 32

30 Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. Sekvensen for den endelige integration er illustreret på nedenstående diagram: Fagsystem(n) Serviceplatformen KMD Social Pension EP_KS1 EP_FS1 Svar Datatransformering N/A Datapersistering N/A Databerigelse N/A Routing N/A Orkestrering N/A Sikkerhed Kildesystemet er certifikatbaseret. Fagsystemet er tokenbaseret. EP_FS1 er udstillet som en fælleskommunal service, og fagsystemet er anvendersystem i det fælleskommunale støttesystem Adgangsstyring. I EP_KS1 autentikeres og autoriseres via certifikater. Serviceplatformen skal således tilgå KMD Social Pension med et certifikat jf. OWSA-T. KOMBIT A/S Halfdansgade København S CVR Side 30 af 32

31 Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen Testdata og testfaciliteter [Afklaring/Programmet: Programmets udmelding om teststrategi, programlog-id #1] Konfiguration N/A Supplerende information Der skal ikke udføres forretningsvalidering på Serviceplatformen Tilslutning til integrationspart: Serviceplatformen Dette kapitel liste de forudsætninger, som skal være opfyldt for at Serviceplatformen kan udstille den pågældende snitflade. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TSP01 TSP02 TSP03 Konfiguration Konfiguration Registrering af KMD Social Pension og udstillede services i STS Organisation Registrering af Serviceinform ation for services udstillet af KMD Social Pension i Serviceplatfor men Registrering af KMD Social Pension og udstillede services i Administrationsmodul Konfiguration STS Organisation Serviceplatform en Administrations modul KDI KDI Fase 1 Kan udføres samme SF1411_A TSP02 KDI KDI Fase 1 Kan udføres samme SF1411_A TSP04 KDI KDI Fase 1 Kan udføres samme SF1411_A TSP06 KOMBIT A/S Halfdansgade København S CVR Side 31 af 32

32 TSP01 - KMD Social Pension skal oprettes STS Organisation, hvis dette ikke allerede er sket, med de services, som udstilles af denne, og som er beskrevet i denne Snitflade. TSP02 - Der skal registres information vedrørende KMD Social Pension services i Serviceplatformen, så der kan oprettes serviceaftaler for kommunerne, bl.a. skal logiske og fysiske endpoint skal være relateret. TSP03 - KMD Social Pension skal oprettes STS Administrationsmodul, hvis dette ikke allerede er sket, med de services, som udstilles af denne, og som er beskrevet i denne Snitflade. KOMBIT A/S Halfdansgade København S CVR Side 32 af 32