Snitfladebeskrivelse for Pension persons andel af varmetillæg (26) KMD Boligstøtte Version 0.9.1, 26.2.2016
Indholdsfortegnelse Indholdsfortegnelse Ændringer i forhold til forrige version... 2 1 Brug af snitfladebeskrivelsen... 3 2 Formål og målgrupper... 3 2.1 Hvad er formålet med snitfladen?... 3 2.2 Hvem er målgrupperne?... 3 3 Snitfladens arkitektur... 3 3.1 Teknisk implementering... 4 4 Garantier... 4 5 Protokol for dataudveksling... 4 5.1 Hvordan opbygges datastrømmen?... 4 5.2 Hvilke(t) tegnsæt skal anvendes?... 4 5.3 Hvilke datastrukturer skal anvendes?... 4 5.4 Hvilke dataformater skal anvendes?... 4 6 Validering af data... 4 6.1 Hvordan håndteres fejl?... 5 7 Test... 5 8 Sikkerhed... 5 KMD 1970-2099. Alle rettigheder forbeholdes. Dette materiale er ophavsretligt beskyttet og må ikke kopieres i videre omfang end forudsat i ophavsretsloven.
Ændringer i forhold til forrige version Ændringer i forhold til forrige version Første version oprettet af JGV Anden version med enkelte tilretninger v. JGV 15-09-2016 Side 2
Brug af snitfladebeskrivelsen 1 Brug af snitfladebeskrivelsen Denne snitfladebeskrivelse udgør grundlaget for indgåelse af konkrete aftaler med KMDs kunder om udveksling af data med KMD Boligstøtte baseret på snitfladen Pension persons andel af varmetillæg (26). Grundlag for indgåelse af aftaler. Den er desuden et praktisk arbejdsredskab til støtte for kommunikationen mellem kunderne og KMD om snitfladens anvendelse. Beskrivelsen må ikke overdrages eller kopieres i videre omfang end forudsat i ophavsretsloven men kun udlånes til softwareleverandører i forbindelse med etablering af snitfladen samt ved fremtidige ændringer. Henvendelser vedrørende snitfladen rettes hos KMD til: Business Line Manager, KMD Boligstøtte, Udlån til andre leverandører. Kontakt til KMD. Jon Grove Hermansen KMD Odense Niels Bohrs Alle 185 5220 Odense SØ Telefon, 4460 1000 Supporthenvendelser vedrørende brug af snitfladen rettes hos KMD til Boligstøtte support gruppen, mail KMDBOT-VIP@kmd.dk Kontakt til support i KMD. 2 Formål og målgrupper 2.1 Hvad er formålet med snitfladen? Formålet med snitfladen er at gøre det muligt at hente varmetillæg fra boligstøttesystemet til brug for beregning i pensionssystemet. 2.2 Hvem er målgrupperne? Sagsbehandlere, som anvender pensionsløsningen og de udviklere/forretningsspecialister, der skal udvikle den nye pensionsløsning. 3 Snitfladens arkitektur Snitfladen er en ekstern webservice, hvor boligstøttesystemet udstiller en ekstern webservice, som Pensionssystemet kan kalde for at få hente de ønskede oplysninger. For at anvende snitfladen skal der anvendes et FOCES certifikat og der logges de nødvendige oplysninger jf. afsnit 7. Servicen er en SOAP service. 15-09-2016 Side 3
Garantier 3.1 Teknisk implementering Boligstøttesystemet opretter, udstiller og ejer en ekstern webservice (EWS), som pensionssystemet kan kalde. 4 Garantier Der er et ændrings- og opsigelsesvarsel på 3 måneder. 5 Protokol for dataudveksling 5.1 Hvordan opbygges datastrømmen? Der kaldes med end struktur som beskrevet i punkt 5.3. 5.2 Hvilke(t) tegnsæt skal anvendes? UTF-8 5.3 Hvilke datastrukturer skal anvendes? INPUT: CPRNR STRING -> EJERS CPR.NR. VIRKNINGSDATO DATETIME -> VIRKNINGSDATO OUTPUT: CPRNR STRING -> EJERS CPR.NR. KOMMUNENR SHORT -> KOMMUNENUMMER BOS/BOY STRING -> BOS =BOLIGSIKRING/ BOY =BOLIGYDELSE VARMETILLG INT -> VARMETILLÆG VIRKNINGSDATO DATETIME -> VIRKNINGSDATO 5.4 Hvilke dataformater skal anvendes? Se ovenfor. 6 Validering af data Datavalidering afspejles i systemets forretningsregler, som ikke er beskrevet nærmere. 15-09-2016 Side 4
Test 6.1 Hvordan håndteres fejl? Hvis personen ikke findes på en aktiv boligstøttesag, returneres en passende return/reason (R/R) kode med en tilhørende tekst. Øvrige/andre fejlkoder kan aftales under udviklings- og testforløbet. Hvis snitfladen ikke svarer, fejlmelder det kaldende system snitfladen hos det udstillende system via fællespostkasse eller POB. 7 Test Der udstilles en teststub, der kan generere et mindre antal forskellige svar ved kald med forskelligt input. Testdata og testmiljø, samt data heri aftales nærmere på et senere tidspunkt. 8 Sikkerhed Webservicen udarbejdes jævnfør retningslinjerne i OWSA-T modellen. For at kalde webservicen skal der anvendes et funktionscertifikat. Der henvises i øvrigt til KMDs sikkerhedsregler og sikkerhedsstandarden ISO 27001. 15-09-2016 Side 5