KMD Sag II udfasningsassistance Bilag G: Grænsefladedokumentation til KMD Sag Dokumentet er udarbejdet af KMD Version 2.1 Side 1 af 14
Indhold KMD Sag II udfasningsassistance... 1 Bilag G: Grænsefladedokumentation til KMD Sag... 1 Dokument historik... 2 Indledning... 3 Skabelon for beskrivelsen af grænseflader... 3 Generelle kommentarer til grænsefladebeskrivelserne... 3 Beskrivelse af grænseflader til KMD Sag... 4 Grænseflade: Hent Ejerskab... 4 Grænseflade: Hent Sagsbehandler... 4 Grænseflade: Vis KLE... 5 Grænseflade: Modtag Hændelse... 5 Grænseflade: Modtag Advis... 6 Grænseflade: Ret advis... 6 Grænseflade: Modtag doc2archive dokument... 7 Grænseflade: List dokument... 7 Grænseflade: List sager... 8 Grænseflade: Udstil folkeregisterhændelse... 8 Grænseflade: Modtag folkeregisterhændelse... 8 Grænseflade: Hop ind... 9 Grænseflade: Hop ud... 9 Grænseflade: E-indkomst udstil personer med sager... 10 Grænseflade: Modtag indkomstoplysninger... 10 Grænseflade: OIO Sag... 11 Grænseflade: OIO Dokument... 12 Grænseflade: OIO Journal... 12 Grænseflade: OIO Advis... 13 Grænseflade: KMD Indkomst... 13 Grænseflade: Ydelsesoverblik... 14 Noter til grænsefladebeskrivelserne... 14 Dokument historik Versionsnummer Dato for udgivelse Ændringer 1.0 04-02-2013 Oprindeligt dokument. 1.1 22-07-2013 Opdateret med indholdsfortegnelse. 1.2 23-07-2013 Snitflade referencenummer fra integrationsoversigt tilføjet i skema for den enkelte snitflade. 2.0 22-10-2013 Opdateret efter review af KOMBIT 2.1 25-02-2014 Bilag ændret til KS-II Bilag G (fra KS-I Bilag 1) Side 2 af 14
Indledning Som led i udfasningsassistancen vedrørende KMD Sag har KOMBIT bedt om en beskrivelse af de snitflader, der benyttes i forhold til anvendelsen af KMD Sag. Kravene er beskrevet i kravspecifikationen vedrørende udfasningsassistance for KMD Sag afsnit 4.2.3 Integration - Integrationsanalyse. I nærværende dokument beskrives grænseflader til KMD Sag efter den skabelon, som parterne har aftalt. Skabelonen for beskrivelsen angives i tabellen nedenfor. I skabelonen findes desuden en kort beskrivelse af de enkelte elementer i beskrivelsen. I de efterfølgende tabeller beskrives de enkelte grænseflader. Grænseflader anvendes synonymt med snitflader (som er den betegnelse, der har været anvendt i forbindelse med mange andre aktiviteter i udfasningsassistancen). Skabelon for beskrivelsen af grænseflader Grænseflade: <navn på grænseflade> Reference til integrationsoversigt Det referencenummer snitfladen har i integrationsoversigten Afhængighedsforholdet i integrationen (F.eks. KMD Sag Basis er afhængig af LOS for at kunne angive ejerskab af sagsområder) Hvilke dataobjekter er involveret i integrationen Hvad udløser transport af information/data over integrationen Hvad er dataomfanget og hvor ofte anvendes integrationen Hvorvidt integrationen er tilgængelig via grænseflader herunder om grænsefladen er ekstern tilgængelig. Understøttelse af udfasning, evt. tiltag Hvorvidt grænsefladen understøtter udfasningskonceptet, som påvirker grænsefladen inkl. tid og konsekvens. Dækkende valideringsregler, som skal håndteres ifm. afsendelse/modtagelse i grænsefladen (webservice, ftp, MQ og tilsvarende) Angivelse af om snitfladen anvendes synkront eller asynkront sikkerhedskrav/-model (f.eks. anvendelse af certifikater etc.). Databehandleraftaler Krav i forhold til databehandleraftaler og tilsvarende Performance: Svartider, load etc. KMD kommentarer Eventuelt yderligere kommentarer, som ikke nævnt i de øvrige og som kan have betydning for udfasningsassistancen Generelle kommentarer til grænsefladebeskrivelserne Svartider I forbindelse med angivelse af svartider er der tale om svartider målt som tiden fra forespørgselen ankommer til KMDs netværk, til svaret forlader KMDs netværk. Det inkluderer således ikke de svartider/forsinkelser der måtte være i transportnetværk og kundens eget netværk. Omfatter krav til driftstid, tilgængelighed og support. Side 3 af 14
Beskrivelse af grænseflader til KMD Sag Grænseflade: Hent Ejerskab Reference til integrationsoversigt Snitflade nr. 8 KMD Børnefamilieydelse, KMD edagpenge Sygdom, KMD edagpenge Barsel, KMD Social Pension, KMD Opera Sag->Fagsystem KLE-nummer, CPR, kommune->id (afdeling) LOS ID, adresse, adresse dato. Initieres i fagsystemet Ofte formentlig pr. sag Understøttelse af udfasning, evt. tiltag Nej. Til udfasning skal grænsefladen i givet fald eksternaliseres, dvs. der skal tages højde for sikkerhedsdomæner mv. Se under planlagte udviklingstiltag. KMD er ved at udvikle en OIO version af snitfladen, KMD Fordeling KLE skal findes i KMD Sag. CPR og adresse skal findes i P-data. Kommune og afdeling skal findes i LOS. Adresse dato skal være en gyldig dato. da det er en intern snitflade Backend, servicekald Den faktiske svartid er ikke målt, men den estimeres til 0,1 sek. Grænseflade: Hent Sagsbehandler Reference til integrationsoversigt Snitflade nr. 7 KMD Social Pension, KMD Boligstøtte, KMD Institution, KMD Børneydelse, KMD Opera, KMD edagpenge Barsel, KMD edagpenge Sygdom, KMD Aktiv, KMD Underholdsbidrag Sag->Fagsystem KLE-nummer, CPR, kommune->id (afdeling) LOS ID, adresse, adresse dato, sagsbehandler, ansvarlig afdeling. Initieres i fagsystemet Ofte formentlig pr. sag Understøttelse af udfasning, evt. tiltag Nej. Til udfasning skal grænsefladen i givet fald eksternaliseres, dvs. der skal tages højde for sikkerhedsdomæner mv. Se under planlagte udviklingstiltag. KMD er ved at udvikle en OIO version af snitfladen, KMD Fordeling KLE skal findes i KMD Sag. CPR og adresse skal findes i P-data. Kommune og afdeling skal findes i LOS. Adresse dato skal være en gyldig dato. Sagsbehandler skal findes i KSP/CICS. da det er en intern snitflade Backend, servicekald Den faktiske svartid er ikke målt, men den estimeres til 0,1 sek. Side 4 af 14
Grænseflade: Vis KLE Reference til integrationsoversigt Snitflade nr. 6 Opus Debitor, KMD Structura Byggesag, KMD Structura Miljø Sag->Fagsystem Kommune, journalplan, dato, sagstype Initieres i fagsystemet Få gange dagligt Understøttelse af udfasning, evt. tiltag Nej. Til udfasning skal grænsefladen i givet fald eksternaliseres, dvs. der skal tages højde for sikkerhedsdomæner mv. Se under planlagte udviklingstiltag. KMD er ved at udvikle en OIO version af snitfladen, KMD Fordeling Kommune skal findes i LOS. Journalplan og sagstype skal være gyldige. da det er en intern snitflade Backend, servicekald Den faktiske svartid er ikke målt, men den estimeres til 0,2 sek. Grænseflade: Modtag Hændelse Reference til integrationsoversigt Snitflade nr. 1 KMD Social Pension, KMD Boligstøtte, KMD Institution, KMD Børneydelse, KMD Opera, KMD edagpenge Barsel, KMD edagpenge Sygdom, KMD Aktiv, KMD Underholdsbidrag, Opus Debitor, KMD Structura Byggesag, KMD Structura Miljø, KMD Structura Boliganvisning, KMD Rekvirentnet, KMD Arbejdsevnemetode, KMD Betalingsadministration, Opus Barsel, KMD Begravelseshjælp, KMD Structura Ejendomsskattelån, KMD Klientbetaling, KMD Boliglån, KMD Børn og Voksne, Forebyggende Hjemmebesøg. Fagsystem ->Sag Kommune, leverandør, journalplan, dato, sagstype, sagsparter, notattype, sagsbehandler, sagsnøgle, sikkerhedsenhed, ansvarlig afdeling, overskrift, gul lap, notattekst Initieres i fagsystemet 100.000 gange dagligt Understøttelse af udfasning, evt. tiltag Nej. Den eksterne version er OIO Sag. Kommune skal findes i LOS. Leverandør skal findes i KMD Sag. Journalplan og sagstype skal være defineret i Ejerskab. Dato skal være gyldig. Sagsparter og sagsnøgle skal være gyldige. Sikkerhedsenhed og ansvarlig afdeling skal findes i LOS. Sagsbehandler skal findes i KSP/CICS. da det er en intern snitflade Backend, servicekald med MQ KMD kommentarer Fagsystemer som planlægger store samtidige datamængder, dvs. over 1 mio. på et døgn, skal meddele dette af hensyn til svartid på klienter til KMD Sag. Side 5 af 14
Grænseflade: Modtag Advis Reference til integrationsoversigt Snitflade nr. 2 KMD Social Pension, KMD Boligstøtte, KMD Institution, KMD Børneydelse, KMD Opera, KMD edagpenge Barsel, KMD edagpenge Sygdom, KMD A- refusion, KMD Underholdsbidrag, Opus Debitor, KMD Rekvirentnet, KMD Arbejdsevnemetode, KMD Betalingsadministration, KMD Begravelseshjælp, KMD Debitor Fagsystem ->Sag Kommune, leverandør, journalplan, dato, sagstype, part, advistype, sagsbehandler, sagsnøgle, advisnøgle, sikkerhedsenhed, ansvarlig afdeling, status, prioritet, distrikt, betalingsdato, overskrift, advis tekst, afgivende organisation, gul lap, hop Initieres i fagsystemet 20.000 gange dagligt Understøttelse af udfasning, evt. tiltag Nej. Den eksterne version er OIO Advis. Kommune skal findes i LOS. Leverandør skal findes i KMD Sag. Journalplan og sagstype skal være defineret i Ejerskab. Part, advistype, advisnøgle og sagsnøgle skal være gyldige. Distrikt skal være findes i P-data. Sikkerhedsenhed, ansvarlig afdeling og afgivende organisation skal findes i LOS. Sagsbehandler skal findes i KSP/CICS. Status, prioritet og hop skal have gyldige værdier. da det er en intern snitflade Backend, servicekald med MQ Grænseflade: Ret advis Reference til integrationsoversigt Snitflade nr. 3 KMD Opera, KMD Arbejdsevnemetode, KMD Debitor Fagsystem ->Sag Kommune, leverandør, journalplan, dato, sagstype, part, advistype, sagsbehandler, sagsnøgle, advisnøgle, sikkerhedsenhed, ansvarlig afdeling, status, prioritet, distrikt, betalingsdato, overskrift, advis tekst, afgivende organisation, gul lap, hop Initieres i fagsystemet 100 gange om dagen Understøttelse af udfasning, evt. tiltag Nej. Den eksterne version er OIO Advis. Kommune skal findes i LOS. Leverandør skal findes i KMD Sag. Journalplan og sagstype skal være defineret i Ejerskab. Part, advistype, advisnøgle og sagsnøgle skal være gyldige. Distrikt skal være findes i P-data. Sikkerhedsenhed, ansvarlig afdeling og afgivende organisation skal findes i LOS. Sagsbehandler skal findes i KSP/CICS. Status, prioritet og hop skal have gyldige værdier. da det er en intern snitflade Backend, servicekald med MQ Side 6 af 14
Grænseflade: Ret advis Grænseflade: Modtag doc2archive dokument Reference til integrationsoversigt Snitflade nr. 5 KMD Social Pension, KMD Boligstøtte, KMD edagpenge Barsel, KMD edagpenge Sygdom, Opus Barsel, KMD Opera, KMD Underholdsbidrag, Opus Debitor Fagsystem ->doc2rchive ->Sag Kommune, leverandør, dokumentid, part, overskrift, sagsbehandler, sagsid Dos2archive kalder sag 10.000 om dagen Understøttelse af udfasning, evt. tiltag Nej. Den eksterne version er IO manager. Kommune skal findes i LOS. Leverandør skal findes i KMD Sag. Part skal være valid. Sagsbehandler skal findes i KSP/CICS. Sagsid skal være valid da det er en intern snitflade Backend, servicekald med MQ Den faktiske svartid er ikke målt, men den estimeres til 0,7 sek. Grænseflade: List dokument Reference til integrationsoversigt Snitflade nr. 9 KMD Structura Byggesag, KMD Structura Miljø, KMD Boliglån Fagsystem ->Sag Kommune, sagsid, dokumentid, overskrift, ændringstid Fagsystembruger kalder sag Få gange dagligt Understøttelse af udfasning, evt. tiltag Nej. Den eksterne version er OIO Dokument Kommune skal findes i LOS. Sagsid og dokumentid skal findes i KMD Sag. da det er en intern snitflade Webservice Den faktiske svartid er ikke målt, men den estimeres til 0,2 sek. Side 7 af 14
Grænseflade: List sager Reference til integrationsoversigt Snitflade nr. 10 CSC Københavns kommune BUS Fagsystem ->Sag Kommune, sagstype, part, status, sagsbehandler, afdeling Fagsystembruger kalder sag KMD kender ikke omfanget af denne anvendelse Understøttelse af udfasning, evt. tiltag Nej. Den eksterne version er OIO Sag Kommune og afdeling skal findes i LOS. Part skal være valid. Sagsbehandler skal findes i KSP/CICS. Sagstype skal findes i sagstypeplan. da det er en intern snitflade Webservice Den faktiske svartid er ikke målt, men den estimeres til 0,2 sek. Grænseflade: Udstil folkeregisterhændelse Reference til integrationsoversigt Snitflade nr. 11 Opus Debitor, KMD Underholdsbidrag, KMD Børneydelse, KMD Social Pension Sag -> Fagsystem Kommuner, parter, hændelsestype, hændelsestekst Sag modtager besked fra P-data (500 stk) 1 gang dagligt Understøttelse af udfasning, evt. tiltag Nej. Kommuner skal findes i LOS. Hændelsestype skal findes i KMD Sag. da det er en intern snitflade Backend, servicekald med MQ Grænseflade: Modtag folkeregisterhændelse Reference til integrationsoversigt Snitflade nr. 12 P-data P-data ->Sag Kommuner, parter, hændelsestype P-data kalder sag (10.000 stk) 1 gang dagligt Side 8 af 14
Grænseflade: Modtag folkeregisterhændelse Understøttelse af udfasning, evt. tiltag Nej. Kommuner skal findes i LOS. Hændelsestype skal findes i KMD Sag. da det er intern snitflade Dataset. Grænseflade: Hop ind Reference til integrationsoversigt Snitflade nr. 13a KMD Sag kender ikke anvenderne af List Sager. Fagsystem ->Sag Kommune, part, sagsid, dokumentid, transaktion, applikation, funktion Fagsystembruger kalder sag KMD Sag antager 1.000-10.000 gange dagligt Ja Understøttelse af udfasning, evt. tiltag Ja f.eks. via dialogintegration Kommune skal findes i LOS. Sagsid og dokumentid skal være kendt i KMD Sag. Transaktion, applikation og funktion skal være definerede i KMD Sag., når Sag åbnes spørges brugeren om login Kald til.net operation SagEDH.exe Grænseflade: Hop ud Reference til integrationsoversigt Understøttelse af udfasning, evt. tiltag Snitflade nr. 13b KMD Social Pension, KMD Boligstøtte, KMD Institution, KMD Børneydelse, KMD Opera, KMD edagpenge Barsel, KMD edagpenge Sygdom, KMD Aktiv, KMD Underholdsbidrag, Opus Debitor, KMD Structura Byggesag, KMD Structura Miljø, KMD Structura Boliganvisning, KMD Rekvirentnet, KMD Arbejdsevnemetode, KMD Betalingsadministration, Opus Barsel, KMD Begravelseshjælp, KMD Structura Ejendomsskattelån, KMD Klientbetaling, KMD Boliglån, KMD Børn og Voksne, Doc2archive, KMD Indkomst Sag ->fagsystem Fagsystem, kommune, part, sagsid Sagsbruger kalder fagsystem 1.000-10.000 gange dagligt Ja Ja f.eks. via dialogintegration Side 9 af 14
Grænseflade: Hop ud Kommune skal findes i LOS. Sagsid skal være kendt i KMD Sag. Fagsystem skal være defineret i KMD Sag., når fagsystemet åbnes spørges brugeren om logon Kald til.net eller web Grænseflade: E-indkomst udstil personer med sager Reference til integrationsoversigt Snitflade nr. 14a KMD Indkomst Sag ->KMD Indkomst Kommune, parter, sagstype Sag kalder KMD indkomst (1.000.000 stk) en gang om måneden Understøttelse af udfasning, evt. tiltag Nej Kommune skal findes i LOS. Sagstype skal være kendt i KMD Sag. da det er en intern snitflade Dataset Grænseflade: Modtag indkomstoplysninger Reference til integrationsoversigt Snitflade nr. 14 b KMD Indkomst KMD Indkomst -> sag Part, indkomstoplysninger KMD indkomst kalder Sag (3.000.000 stk) en gang om måneden Understøttelse af udfasning, evt. tiltag Nej Part skal være valid. Indkomstoplysninger skal være i dkr. da det er intern snitflade Dataset Side 10 af 14
Grænseflade: Modtag indkomstoplysninger Grænseflade: OIO Sag Reference til integrationsoversigt Snitflade nr. 15 KMD Care, Sealand Care, Convergens profile, Vitae omsorg, Uniq Omsorg, EG Bis-Y, Aalborg it haveservice, Aalborg it sundhedsjournalen, Aalborg it børn og uge systemet, Prisme, IST danmark Dagtilbud, Workbase, Brugerdata KBH, Extens Dagtilbud, Extens Pladsanvisning, GK- Consult daginstitution, IDIS daginstitution Fagsystem ->sag Kommune, leverandør, parter, sagstype, sagsid, sagsbehandler, status, beskrivelse, ansvarlig afdeling, partsrolle Fagsystem kalder sag Antallet af gange grænsefladen er kaldt er opgjort i runde tal som max. antal i løbet af to dage i januar (10. og 14. januar 2013) Sag Opret 600 Sag Læs 13.000 Sag Importer 600 Sag Passiver 0 Sag Søg 1 Sag Ret 20.000 Sag List 0 Sag Slet 3.000 Bemærk at grænsefladen er under udrulning og at omfanget af anvendelsen forventes at stige markant. Ja Understøttelse af udfasning, evt. tiltag Ja Kommune og ansvarlig afdeling skal findes i LOS. Leverandør skal findes i KMD Sag. Sagsid skal være kendt i KMD Sag. Sagsbehandler skal være defineret i KSP/CICS. Sagstype, status og partsrolle skal være kendt i KMD Sag. Certifikat fra kommune og bruger, bruger autoriseret i KSP og tilslutningsaftale med KMD Webservice Databehandleraftaler Se note 5 Det er målt på backend at 98 % af svartiderne ligger under 1 sekund, som er opløsningen på det registrerende system. Svartiden estimeres til at ligge på ca. 0,2 sekund. KMD kommentarer Snitfladen har følgende operationer: Sag Opret Sag Læs Sag Importer Sag Passiver Sag Søg Sag Ret Sag List Sag Slet Side 11 af 14
Grænseflade: OIO Dokument Reference til integrationsoversigt Snitflade nr. 16a Nogle 3. parts systemer. Fagsystem ->sag Kommune, leverandør, dokumentid, part, beskrivelse, dato, overskrift, dokumenttype, status, ansvarlig afdeling, sagsbehandler, sagsid, partsrolle Fagsystem kalder sag Der er pt. ingen trafik på OIO Dokument, men da grænsefladen er under udrulning forventes dette at ændre sig over de kommende måneder. Ja Understøttelse af udfasning, evt. tiltag Ja Kommune og ansvarlig afdeling skal findes i LOS. Leverandør skal findes i KMD Sag. Dokumentsid skal være kendt i KMD Sag med mindre det er opret. Sagsbehandler skal være defineret i KSP/CICS. Dokumenttype, status og partsrolle skal være kendt i KMD Sag. Certifikat fra kommune og bruger, bruger autoriseret i KSP og tilslutningsaftale med KMD Webservice Databehandleraftaler Se note 5 Det er målt på backend at 98 % af svartiderne ligger under 1 sekund, som er opløsningen på det registrerende system. Svartiden estimeres til at ligge på ca. 0,2 sekund. KMD kommentarer Snitfladen har følgende operationer: Dokument Opret Dokument Læs Dokument Importer Dokument Søg Dokument Ret Dokument List Dokument Slet Grænseflade: OIO Journal Reference til integrationsoversigt Snitflade nr. 16b Pt. ingen, da snitfladen ikke er sat i drift. Fagsystem ->sag Kommune, leverandør, journalnotat, status, dato, overskrift, ansvarlig afdeling, sagsbehandler, sagsid Fagsystem kalder sag Ukendt, da snitfladen ikke er færdigudviklet. Ja Understøttelse af udfasning, evt. tiltag Ja Skal i produktion Ukendt, da snitfladen ikke er færdigudviklet. Certifikat fra kommune og bruger, bruger autoriseret i KSP og tilslutningsaftale med KMD Webservice Databehandleraftaler Se note 5 Se note 2. Side 12 af 14
KMD kommentarer Snitfladen forventes at få følgende operationer: Journal Opret Journal Læs Journal Importer Journal Søg Journal Ret Journal List Journal Slet Grænseflade: OIO Advis Reference til integrationsoversigt Snitflade nr. 17 Pt. ingen, da snitfladen ikke er sat i drift. Fagsystem ->sag Kommune, leverandør, status, overskrift, part, dato, advis type, sagsbehandler, ansvarlig afdeling, advis tekst Fagsystem kalder sag Ukendt, da snitfladen ikke er færdigudviklet. Ja Understøttelse af udfasning, evt. tiltag Ja Skal i produktion Kommune skal findes i LOS. Leverandør skal findes i KMD Sag. Advistype skal være kendt i KMD Sag. Certifikat fra kommune og bruger, bruger autoriseret i KSP og tilslutningsaftale med KMD Webservice Databehandleraftaler Se note 5 Se note 2. KMD kommentarer Snitfladen får følgende operationer: Advis Opret Advis Importer Advis Ret Advis Slet Grænseflade: KMD Indkomst Reference til integrationsoversigt Snitflade nr. 20 Se under Modtag indkomstoplysninger Understøttelse af udfasning, evt. tiltag Databehandleraftaler KMD kommentarer Side 13 af 14
Grænseflade: Ydelsesoverblik Reference til integrationsoversigt Snitflade nr. 28 KMD edagpenge barsel, KMD edagpenge sygdom, Opus Barsel, KMD Boligstøtte, KMD børneydelse Sag ->fagsystem Kommune, part, sagstype, dato, indkomst, skat, overskrift Sagsbruger kalder fagsystem 1.000-10.000 gange om dagen Understøttelse af udfasning, evt. tiltag Nej Kommune skal findes i LOS. Sagstype skal være kendt i KMD Sag. da det er en intern snitflade Backend, servicekald Det er målt på backend at 91 % af svartiderne ligger under 1 sekund, som er opløsningen på det registrerende system. Svartiden estimeres til at ligge på ca. 0,4 sekund. Noter til grænsefladebeskrivelserne Note 1: Svartider bliver typisk ikke målt på de interne snitflader. Hvis et fagsystem i forbindelse med implementering af integration, rapporterer at der er problemer med svartiden, vil den blive undersøgt og problemet udbedret. Note 2: Svartiderne på disse snitflader kan ikke oplyses, da snitfladerne er under udarbejdelse. Note 3: Der eksisterer databehandleraftaler med samtlige kommuner i forhold til KMD Sag, men ikke i forhold til den specifikke snitflade. Note 4: Servicemål er som grundlag defineret i TSA en, men kan være ændret i forbindelse med andre aftaler med den enkelte kunde. Note 5: I forbindelse med KMD Sags OIO snitflader er databehandleraftalen mellem den enkelte kommune og KMD. Den fornødne databehandleraftale mellem kommunen og 3. part forudsættes håndteret af kommunen. Side 14 af 14