SF Print på Serviceplatformen Integrationsbeskrivelse - version 2.1.6

Transkript

1 Integrationsbeskrivelse - version Kommunernes Datafællesskab - KDF

2 Versionshistorik Relevans Dato Initialer Version Kommentarer sej 0.1 Første version DGJ Ny version med rutning af Digital Post på Serviceplatformen EDM Ny version med flere operationer til direkte rutning EDM Ny version med sammenlægning af enkelt brev og masseforsendelse EDM Ny version med ren gennemstilling af services fra SOAP til REST EDM Opdatering efter internt review JSE Sendt til integrationsplatform EDM Ny version baseret på arkitekturindstilling per EDM Opdateret med automatisk kanalvalg på Serviceplatform EDM Opdateret med interne review kommentarer JJN 0.6 Referencerettelser mm EHE Teknisk beskrivelse godkendt EDM Opdateret med kommentarer fra Serviceplatform og fagprojekter EDM Fjernet /fil i URL i EDM Uddybning af Serviceplatformen som afsendersystem i EDM SystemId lavet til Systemvalg i , Afsendersystem fjernet i Serviceplatformen finder SystemId/Afsendersystem ud fra myndighed i serviceaftalen EDM Opdatering omkring Beskedfordeler. I afsnit 1.5 forudsætninger, afsnit og omkring Abonnement og værdilister. Afsnit 3.4 omkring Beskedkuvert EDM Beskrevet kanalvalg S for NemSMS fra SF2250 i afsnit og samt Register-tilmelding er en forudsætning i afsnit Referencer Ref Titel Kommentarer [SPref] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: [BFref] [Afklaring/KDF indsæt reference dokumentation af servicemål for BF] Endnu ikke udarbejdet [SIKKERHED] Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v [STS-Sikkerhed] Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link KOMBIT A/S Halfdansgade København S CVR Side 2 af 87

3 [SFTP] [VBF] [Digital Post] USM0005 Vejledning til Serviceplatformens SFTP Service.pdf Se vilkår Underbilag 2N - Vilkår for integration til støttesystemet Beskedfordeler version 2.0 på nedenstående link Notat - Kvitteringer i KOMBIT snitflader.docx Vejledning med xsd. Digitaliseringsstyrelsens dokumentation [Fjernprint] [Fejlhåndtering] Digitaliseringsstyrelsens dokumentation [SF1460_A] Modtag besked Beskrivelse af protokol for Beskedfordeler [SF1460_B] Vedligehold værdiliste i beskedabonnement Beskrivelse af protokol for Beskedfordeler [SF1460_C] Aflever besked Beskrivelse af protokol for Beskedfordeler [SF1460_D] Modtag besked via pull Beskrivelse af protokol for Beskedfordeler [WSDL-SP] [WSDL-EXT] Integrationsbeskrivelsen refererer til SF1600 Teknisk Spec zip som indeholder WSDL/WADL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link Integrationsbeskrivelsen refererer til SF1600 Bilag zip som indeholder WSDL/WADL/XSD af eksterne interfaces, som er placeret i samme mappe som integrationsbeskrivelsen, se link Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Forespørgsel på tilmeldingsstatus Ændring i tilmeldingsstatus via BeskedFordeler Afsende enkelte breve, direkte eller batch (masseafsendelse) Status og kvitteringer via BeskedFordeler Generelle forudsætninger KOMBIT A/S Halfdansgade København S CVR Side 3 af 87

4 1.3 Servicebetingelser for den samlede integration Servicemål Service Management Lifecycle Management Teststrategi Test i forbindelse med udvikling Test i forbindelse med produktionssætning Forudsætninger for produktionssætning af integration Forudsætninger for funktionalitet på Serviceplatformen Forudsætninger for tilslutning til integrationspart: Fagsystemer Forudsætninger for tilslutning til integrationspart: Ekstern system Kontekst for integrationsparter Kontekst for KY Lovhjemmel og forvaltningsmæssigt formål Kapacitets- og servicekrav Specifikke forhold for tilslutning af system Kontekst for KSD Lovhjemmel og forvaltningsmæssigt formål Kapacitets- og servicekrav Specifikke forhold for tilslutning af system Kontekst for Ejendomsskat Lovhjemmel og forvaltningsmæssigt formål Kapacitets- og servicekrav Specifikke forhold for tilslutning af system Specifikation for integrationsparter Specifikation af endpoints for KY, KSD og Ejendomsskat Overordnet forretningslogik Oversigt over endpoints Beskrivelse af endpoint EP_SP1 - Spoerg_tilmelding_SP Beskrivelse af endpoint EP_SP2 - Afsend_brev_SP Beskrivelse af endpoint EP_BF1 - ModtagBesked Beskrivelse af endpoint EP_BF2 - AdministrerVaerdiliste Service Management Testplan Specifikation af endpoints for Digital Post Overordnet forretningslogik KOMBIT A/S Halfdansgade København S CVR Side 4 af 87

5 3.2.2 Oversigt over endpoints Beskrivelse af endpoint EP_DP1 - Spoerg_tilmelding_DP Beskrivelse af endpoint EP_DP2 - Afsend_brev_DP Beskrivelse af endpoint EP_DP3 - Masseafsend_brev_DP] Beskrivelse af endpoint EP_DP4 - Modtag_kvittering_DP Beskrivelse af endpoint EP_DP5 - Kvitter_kvittering_DP Beskrivelse af endpoint EP_DP6 - Hent_tilmeldingsliste_DP Beskrivelse af endpoint EP_DP7 - Hent_tilmeldinger_delliste_DP Service Management Testplan Specifikation af endpoints for Fjernprint Overordnet forretningslogik Oversigt over endpoints Beskrivelse af endpoint EP_FP1 - Afsend_brev_FP Beskrivelse af endpoint EP_FP2 - Hent_status_FP Beskrivelse af endpoint EP_FP3 - Hent_statusdetalje_FP Service Management Testplan Specifikation af endpoints mellem Serviceplatformen og BeskedFordeler Overordnet forretningslogik Oversigt over endpoints Beskrivelse af endpoint EP_BF3 AfsendBesked Service Management Testplan Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen Oversigt over integrationsflows Integrationsflow IF01: Forespørg tilmelding DP (og NemSMS) Integrationsflow IF02: Afsend brev Integrationsflow IF03: Beskedfordel status print Integrationsflow IF04: Beskedfordel ændringer tilmeldinger DP KOMBIT A/S Halfdansgade København S CVR Side 5 af 87

6 1 Overordnet beskrivelse 1.1 Integrationens formål Formålet er at forsyne kommunale systemer (kaldet fagsystemer efterfølgende) med mulighed for at afsende breve til borgere og virksomheder enten via Digitaliseringsstyrelsens Digital Post løsning eller som fysisk brev via kommunens Fjernprintløsning. Der skal understøttes Fjernprintløsninger individuelt for de enkelte kommuner, forudsat de understøtter Fjernprint standard snitfladerne defineret af Digitaliseringsstyrelsen. For at kunne fordele printet mellem Digital Post og Fjernprint (kanalvalg) samt lave differentieret indhold afhængig af tilmelding til Digital Post, udstiller Serviceplatformen ligeledes en service, hvor fagsystemet kan forespørge på status for tilmelding til Digital Post for borgeren. Denne service understøtter også status omkring tilmelding til NemSMS. 1.2 Overordnet forretningsflow i integrationen Serviceplatformen skal understøtte følgende forretningsgange ved gennemstilling til Digital Post og Fjernprint: - Forespørgsel på tilmeldingsstatus - Ændring i tilmeldingsstatus via BeskedFordeler - Afsende enkelte breve, direkte eller batch (masseafsendelse) - Status og kvitteringer via BeskedFordeler Fagsystemerne har tre muligheder for afsendelse af breve til hhv. Digital Post og Fjernprint: - Fagsystemet kan selv foretage valg af kanal ud fra bl.a. tilmeldingsstatus fra Digital Post, som kan hentes via Serviceplatform med løbende opdateringer via BeskedFordeler - Fagsystemet kan lade Serviceplatformen vælge kanalen ud fra den dagligt indlæste tilmeldingsliste fra Digital Post placeret på Serviceplatformen. - Fagsystemet kan endelige lade den af kommunen valgte Fjernprint-løsning forestå kanalvalg under forudsætning af, at det understøttes af den valgte løsning. En Fjernprint-leverandør skal tage betaling for hver overførsel til Digital Post. De tre muligheder er understøttet af en og samme service udstillet på Serviceplatformen. Det betyder, at fagsystemet, såfremt der er et forretningsmæssigt behov herfor, løbende kan skifte mellem de tre muligheder for kanalvalg Forespørgsel på tilmeldingsstatus Digital Post udstiller en service, hvor der kan forespørges om borgeren er tilmeldt Digital Post eller NemSMS (begge tjenester leveres af eboks). Digital Post og NemSMS har hver sit SystemId for hver kommune. Serviceplatformen udstiller en synkron SOAP service, hvor fagsystemet kan forespørge på tilmeldingsstatus for en personer, som gennemstilles til Digital Post med OIOREST. Fagsystemerne kan gemme denne status på sagen. Tegningen nedenfor beskriver denne funktionalitet. KOMBIT A/S Halfdansgade København S CVR Side 6 af 87

7 Digital Post (eboks) Serviceplatform Fagsystem(n) Integrationsbeskrivelse Tilmeldingsstatus Forespørg på tilmeldinger Forespørg tilmelding Modtag resultat Hent tilmelding Returner synkront Tilmelding Database Hent tilmelding Returner synkront Ændring i tilmeldingsstatus via BeskedFordeler Serviceplatformen henter tilmeldingslister fra Digital Post (og tilsvarende NemSMS) dagligt per myndighed. Herefter sammenlignes listen med gårsdagens liste, som opbevares og opdateres i et replika på Serviceplatformen, for at afgøre, hvilke forretningsmæssige tilmeldingsændringer, som har fundet sted. Tilmeldingsændringer afleveres til BeskedFordeler med en besked per hændelse. Fagsystemer skal oprette et abonnement i BeskedFordeler med angivelse af filtre på kuvertens metadata, herunder relevante personhændelser og personnumre. Fagsystemets adgang til typer af personhændelser fra BeskedFordeler skal opsættes i det fælleskommunale støttesystem Adgangsstyring. Abonnement opsættes med et filter på DokumentId som indeholder reference til fagsystemet. Fagsystemet vil således kun kunne modtage personhændelser fra BeskedFordeler på angivne beskedtyper og som er indeholdt i fagsystemets abonnement. Integrationen er en orkestreringsintegration, som integrerer til BeskedFordeler. KOMBIT A/S Halfdansgade København S CVR Side 7 af 87

8 Digital Post Serviceplatformen Beskedfordeler Fagsystem (n) Integrationsbeskrivelse Nedenfor er illustreret flowet i integrationen: Modtag tilmeldingsændringer Digital Post Modtag Besked Modtag Besked Distribuer besked til dueslag Udstil besked Hent tilmeldingsliste Send Besked Tilmelding replika Udstil tilmeldingsliste Dan forretningshændelser Tilmeldingsdatabase KOMBIT A/S Halfdansgade København S CVR Side 8 af 87

9 Serviceplatformen skal beregne ændringer i tilmeldingerne ud fra gårsdagens lister, som derfor skal gemmes i Serviceplatformen i et replika. For hver person der enten er tilmeldt eller afmeldt i forhold til den forgående liste genereres en hændelsesbesked. Beskederne genereres individuelt for tilmeldinger/ afmeldinger i forhold til både Digital Post og NemSMS BeskedFordeler modtager beskederne og udregner hvilke abonnementer, som skal modtage beskeden og distribuerer herefter beskeder til de korrekte dueslag. Fagsystemerne kan selv opsætte og administrere deres dueslag. Fagsystemet modtager beskeden og behandler den efter egne forretningsregler jf. snitflade SF1460_A/SF1460_D. Denne snitflade omhandler kun Serviceplatformens modtagelse af personhændelser og afsendelse af forretningshændelser vedr. person (Part) Afsende enkelte breve, direkte eller batch (masseafsendelse) Serviceplatformen udstiller en fælles SOAP services til afsendelse af breve til både Digital Post og Fjernprint, som benyttes, når der afsendes breve direkte (enkeltafsendelse) eller batch (masseafsendelse). Der kan kun afsendes et brev af gangen til servicen. Fagsystemet kan ud fra borgerens tilmelding til Digital Post vælge den rigtige kanal eller lade Serviceplatformen vælge kanal ud fra tilmeldings-replika på Serviceplatformen. Et brev må ikke overstiger en størrelse på 10 MByte. Fagsystemet vælger den korrekte kanal Digital Post (D), Fjernprint (F) eller automatisk (A), ud fra tilmeldingsstatus fra Digital Post (eboks) samt NemSMS (S). Hvis fagsystemet ønsker at lade Fjernprint lave kanalvalg, sendes alt til Fjernprint (P). For afsendelse til Fjernprint vælger Serviceplatformen den aktuelle Fjernprintløsning baseret på rutning fra Serviceaftale/Sikkerhed, som beskriver kommunens aftale med Fjernprint. Fjernprint-leverandøren skal understøtte grænseflader og funktionalitet defineret af Digitaliseringsstyrelsen. Fagsystemet vælger desuden om afsendelse er direkte D (enkelt afsendelse) eller batch M (masseafsendelse). Digital Post har krav om, at batch-kørsler skal sende til en specifik masseafsendelsesservice, så derfor skal dette vælges. Bemærk at hvis modtageren er en virksomhed (CVR-nummer) skal posten altid sendes digitalt. Virksomheder kan dog fritages, hvis de ikke har digital adgang. [KDF/Afklaring om virksomheder optræder i tilmeldingslister]. Fagsystemet skal levere alle print i PDF A-1a format. Ved afsendelse kodes filen med BASE64 og inkluderes i servicens XML parameterstruktur. Det kaldende fagsystem håndterer alle fejl, herunder eventuel genfremsendelse som fysisk brev i tilfælde af fejl fra eboks på mail afsendelse (Kan ske hvis borgeren har afmeldt samme dag). Modtagersystemerne håndterer at give fejl, hvis man gensender et brev, som ikke har fejlet. Tegningen nedenfor beskriver denne funktionalitet. KOMBIT A/S Halfdansgade København S CVR Side 9 af 87

10 Fjernprint(n) Digital Post (eboks) Serviceplatform Fagsystem(n) Integrationsbeskrivelse Print på Serviceplatformen Afsend brev direkte eller batch Afsend brev Mapning til DP brev D Kanalvalg A F / P Organisation Ja direkte Nej Ja DigitalPost Nej Tilm. replika Viderestil til kommunens fjernprint Afsend direkte digital post Afsend batch digital post Afsend status Afsend status Afsend brev KOMBIT A/S Halfdansgade København S CVR Side 10 af 87

11 1.2.4 Status og kvitteringer via BeskedFordeler Serviceplatformen skal afhente kvitteringer fra Digital Post periodisk. Masseafsendelse processes om natten, og kan hentes ca. 1 døgn efter (afleveret før kl. 17 kan afhentes kl 8 efter 17 kan afhentes kl. 17). Kvitteringslister slettes automatisk efter 7 dage. Det normale mønster for at hente kvitteringer er: 1. Afhent lister af kvitteringer fra Digital Post og videresend på BeskedFordeler 2. Kvitter for kvitteringsliste Tilsvarende kan der læses status fra Fjernprint, hvor rutningen sker ud fra Serviceaftale/Sikkerhed. 1. Statusliste på ønskede forsendelser læses 2. Indikerer status, at der er sket en fejl, hentes detailoplysninger for forsendelsen. 3. Status videresendes på BeskedFordeler Ved skift til anden Fjernprintleverandør skal Serviceplatformen have mulighed for at hente status fra den gamle leverandør i op til 1 måned fra leverandørskiftet. Serviceplatformen holder en cache af SystemId per myndighed for Digital Post, NemSMS og Fjernprint fra it-systemer i Organisation. Tegningen nedenfor beskriver denne funktionalitet KOMBIT A/S Halfdansgade København S CVR Side 11 af 87

12 Digital Post (eboks) Fjernprint(n) Serviceplatform Beskedfordeler Fagsystem Integrationsbeskrivelse Print på Serviceplatformen Status og kviteringer via Beskedfordeler Hent besked Afsend besked Placer i dueslag Organisation Hent kvitteringer Omdan kvittering til besked Kvitter for kvitteringer Hent statusændringer Behandl status Hent statusdetalje Omdan status til besked Hent kvitteringer Returner kvitteringer Kvitter for liste Kvitteringer Hent Status i tidsinterval Afsend Statusliste Hent Statusdetaljer Afsend Statusdetalje Forsendelse status Generelle forudsætninger Følgende forudsættes: Kommunerne indgår fornødne aftaler med Digital Post (eboks) omkring levering af Digital Post (og NemSMS), og al afregning for afsendelse tilgår den enkelte kommune. Der skal betales tilslutning af kommunen for hver dokumenttype, som defineres i Digital Post. Kommunen kan vælge at benytte samme dokumenttype (F.eks. Brev fra kommunen ) til alle typer print uanset brevskabelon, og så angive typen i overskriften. KOMBIT A/S Halfdansgade København S CVR Side 12 af 87

13 Kommunerne opretter serviceaftale med leverandør af Fjernprintløsning omkring fysisk post, og foretager nødvendig administration i forbindelse hermed. Serviceaftale/Sikkerhed danner grundlaget for rutningen i Serviceplatformen. Fjernprintleverandøren skal overholde Digitaliseringsstyrelsens standard grænseflader og funktionalitet for Fjernprint. Ved leverandørskift skal det være muligt at kunne hente status fra den gamle leverandør i op til 1 måned efter leverandørskiftet. Kommunens Fjernprintleverandør håndterer fysisk forsendelse: Kuvertering, frankering, placering af adresse mm. Kommunerne skal opsætte forsendelsestype i Fjernprint, uanset leverandør, på samme måde. Fagsystemet danner selv dokumenter til forsendelse. Dvs. det forudsættes at der ikke skal vedligeholdes skabeloner i forbindelse med de modtagne printfiler. Fagsystemet skal håndtere gensendelse/genudskrivning ved fejl, som gør at print ikke afleveres på udskriftsdatoen. Protokollen fra Serviceplatform til Kildesystem (Digital Post/NemSMS og Fjernprint) er OIO- REST, som defineret af Digitaliseringsstyrelsen. Serviceplatformen oprettes hos Digital Post, NemSMS (e-boks), Register og Fjernprint som et "standardafsendersystem" med eget certifikat. Hver myndighed, dvs. kommunerne, opretter Serviceplatformen som afsendersystem i administrationsportalen hos Digital Post, NemSMS (e-boks), Register og Fjernprint, og tilknytter relevante tilmeldingsgrupper og indholdstyper (materialer) som borgerne kan tilmelde sig. 1.3 Servicebetingelser for den samlede integration Digital Post har krav om, at masseafsendelser af breve skal afsendes til en specifik masseafsendelsesservice. Derfor skal alle periodiske kørsler fra fagsystemerne altid vælge Prioritet M for at sikre den korrekte masseafsendelse til Digital Post Servicemål Parameter Forespørgsel på tilmeldingsstatus Ændring i tilmeldingsstatus via BF Afsend enkelte breve Status og kvitteringer via BF Tidsrum Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse et tidsrum for åbningstid. Reelt er der ingen begrænsninger. Beskedfordeler driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [BFref]. Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse et tidsrum for åbningstid. Reelt er der ingen begrænsninger. Beskedfordeler driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [BFref]. KOMBIT A/S Halfdansgade København S CVR Side 13 af 87

14 Digitaliseringsstyrelsen Fjernprint vil ikke forpligtige sig til at oplyse et tidsrum for åbningstid. Reelt er der ingen begrænsninger. Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives åbningstid. Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse et tidsrum for åbningstid. Reelt er der ingen begrænsninger Digitaliseringsstyrelsen Fjernprint vil ikke forpligtige sig til at oplyse et tidsrum for åbningstid. Reelt er der ingen begrænsninger. Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives åbningstid. Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse et tidsrum for åbningstid. Reelt er der ingen begrænsninger. Digitaliseringsstyrelsen Fjernprint vil ikke forpligtige sig til at oplyse et tidsrum for åbningstid. Reelt er der ingen begrænsninger. Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives åbningstid. Svartid Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om [SPref]: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om [SPref]: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om [SPref]: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om [SPref]: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse svartider. Digitaliseringsstyrelsen Fjernprint vil ikke forpligtige sig til at oplyse svartider. Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives åbningstid. Svartid for Beskedfordeler er beskrevet i [BFref]. Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse svartider. Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse svartider. Digitaliseringsstyrelsen Fjernprint vil ikke forpligtige sig til at oplyse svartider. Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives åbningstid. Svartid for Beskedfordeler er beskrevet i [BFref]. Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse svartider. Digitaliseringsstyrelsen Fjernprint vil ikke forpligtige sig til at oplyse svartider. Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives åbningstid. Tilgængelighed Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Tilgængelighed for Beskedfordeler er beskrevet i [BFref]. Tilgængelighed for Beskedfordeler er beskrevet i [BFref]. KOMBIT A/S Halfdansgade København S CVR Side 14 af 87

15 Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse et servicemål for tilgængelighed Digitaliseringsstyrelsen Fjernprint vil ikke forpligtige sig til at oplyse et servicemål for tilgængelighed. Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives et servicemål for tilgængelighed. Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse et servicemål for tilgængelighed. Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse et servicemål for tilgængelighed Digitaliseringsstyrelsen Fjernprint vil ikke forpligtige sig til at oplyse et servicemål for tilgængelighed. Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives et servicemål for tilgængelighed. Digitaliseringsstyrelsen Fjernprint vil ikke forpligtige sig til at oplyse et servicemål for tilgængelighed. Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives et servicemål for tilgængelighed. Spidsbelastningsperiode Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse spidsbelastningsperioder. Digitaliseringsstyrelsen Fjernprint vil ikke forpligtige sig til at oplyse spidsbelastningsperioder. Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives spidsbelastningsperioder. Spidsbelastning for Beskedfordeler er beskrevet i [BFref]. Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse spidsbelastningsperioder. Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse spidsbelastningsperioder. Digitaliseringsstyrelsen Fjernprint vil ikke forpligtige sig til at oplyse spidsbelastningsperioder. Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives spidsbelastningsperioder. Spidsbelastning for Beskedfordeler er beskrevet i [BFref]. Digitaliseringsstyrelsen Digital Post vil ikke forpligtige sig til at oplyse spidsbelastningsperioder. Digitaliseringsstyrelsen Fjernprint vil ikke forpligtige sig til at oplyse spidsbelastningsperioder. Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives spidsbelastningsperioder. Servicevinduer 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: 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: 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: 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. Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. KOMBIT A/S Halfdansgade København S CVR Side 15 af 87

16 06:00. Varsling: 1. uge, Varighed: max 3 timer 06:00. Varsling: 1. uge, Varighed: max 3 timer 06:00. Varsling: 1. uge, Varighed: max 3 timer 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 [SPref]. 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 [SPref]. 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 [SPref]. 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 [SPref]. [Afklaring/KDF: Servicevinduer for Digitaliseringsstyrelsen Digital Post og Digitaliseringsstyrelsen Fjernprint] Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives information om servicevinduer. Servicevinduer for Beskedfordeler er beskrevet i [BFref]. [Afklaring/KDF: Servicevinduer for Digitaliseringsstyrelsen Digital Post og Digitaliseringsstyrelsen Fjernprint] [Afklaring/KDF: Servicevinduer for Digitaliseringsstyrelsen Digital Post og Digitaliseringsstyrelsen Fjernprint] Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives information om servicevinduer. Servicevinduer for Beskedfordeler er beskrevet i [BFref]. [Afklaring/KDF: Servicevinduer for Digitaliseringsstyrelsen Digital Post og Digitaliseringsstyrelsen Fjernprint] Fjernprint-leverandører kan aftales individuelt for en kommune, og der kan derfor ikke angives information om servicevinduer Service Management Eventuelle tilretninger og præciseringer i integrationens beskrivelse og specifikation, vil indtil integrationen ligger på Serviceplatformens eksterne testmiljø, blive håndteret af Kommunernes Data Fællesskab (KDF). Spørgsmål vedr. specifikation sendes til [email protected]. KDF sørger for at involverede parter i integrationen oplyses om tilretningerne og præciseringerne. Se oversigten over hvornår de enkelte integrationer forventes at være tilgængelige i eksternt testmiljø her: Når servicen er tilgængelig i det eksterne testmiljø på Serviceplatformen, vil den overgå til Serviceplatformens governanceproces. Beskrivelse af denne tilgår senere Incident Management [Afklaring/KDF: Udfyldes med relevant tværgående opsummering.] Det er KDFs forventning, at dette punkt kan udfyldes med udgangspunkt i den nuværende driftsaftale for Serviceplatformen afsnit 25. Incidents forventes på denne baggrund at skulle rapporteres til følgende kontaktpunkt hos Service Desk-leverandøren, TDC Hosting (telefon: , mail: [email protected]). KOMBIT A/S Halfdansgade København S CVR Side 16 af 87

17 Problem Management [Afklaring/KDF: Udfyldes med relevant tværgående opsummering.] Change Management [Afklaring/KDF: Udfyldes med relevant tværgående opsummering.] Lifecycle Management [Afklaring/KDF: Udfyldes med relevant tværgående opsummering.] 1.4 Teststrategi [Indhold afventer generel afklaring af test] Test i forbindelse med udvikling [Indhold afventer generel afklaring af test] Testfaciliteter og testmiljø [Indhold afventer generel afklaring af test] Testdata [Indhold afventer generel afklaring af test] Test i forbindelse med produktionssætning [Afklaring/KOMBIT: Det skal afklares hvilke evt. andre krav, der er behov for. Det kan fx være behov for beskrive verifikation af produktionssætning.] I forbindelse med produktionssætning er det omfattet af gældende aftale med Systematic, at der gennemføres følgende 3 prøver: Overtagelsesprøve Idriftsættelsesprøve Driftsprøve Hertil kommer en kapacitetstest der sikrer at Serviceplatformen og Digital Post kan håndtere de mængder systemet påtænker at afsende uden for mange timeouts. 1.5 Forudsætninger for produktionssætning af integration Leverandøren skal være oprettet som tilslutningspart i rammearkitekturens administrationsmodul, og leverandøren skal oprette en tilslutningsaftale for it-systemet i administrationsmodulet. Leverandøren skal tiltræde, og overholde, vilkårene i den til enhver tid gældende aftale for tilslutning af itsystemer til den fælleskommunale rammearkitektur. Leverandøren af It-systemet er ansvarlige for at It-systemet tilsluttes via rammearkitekturens administrationsmodul, med den, eller de, systemtyper (brugervendt system, anvendersystem og/eller serviceudbyder), der er relevante for It-systemet jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. KOMBIT A/S Halfdansgade København S CVR Side 17 af 87

18 [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] Forudsætninger for funktionalitet på Serviceplatformen [Afklaring/KDF det skal angives, hvilke certifikater der skal foreligge for at kunne benytte integrationen] Leverandøren skal anmode om indgåelse af serviceaftale for de myndigheder, der skal bruge servicen, i rammearkitekturens administrationsmodul, og myndigheden skal godkender denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. De nødvendige beskedtyper og opsætninger skal være oprettet i Beskedfordeler, så systemet kan sende de beskeder, der indgår i integrationen jf. Vilkår for integration til støttesystemet Beskedfordeler [VBF]. Leverandøren skal være oprettet som tilslutningspart på SF1460_C Forudsætninger for tilslutning til integrationspart: Fagsystemer Leverandøren skal anmode om indgåelse af serviceaftale for de myndigheder, der skal bruge servicen, i rammearkitekturens administrationsmodul, og myndigheden skal godkender denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. De nødvendige abonnementer og opsætninger skal være oprettet i Beskedfordeler, så systemet kan modtage de beskeder, der indgår i integrationen jf. Vilkår for integration til støttesystemet Beskedfordeler [STS-Sikkerhed]. Leverandøren skal være oprettet som tilslutningspart på SF1460_A/SF1460_D og SF1460_B Forudsætninger for tilslutning til integrationspart: Ekstern system [Afklaring/KDF det skal angives, hvilke certifikater der skal foreligge for at kunne benytte integrationen] KOMBIT A/S Halfdansgade København S CVR Side 18 af 87

19 2 Kontekst for integrationsparter 2.1 Kontekst for KY Lovhjemmel og forvaltningsmæssigt formål Det forvaltningsmæssige formål er at kommunikere med borgere. Lovhjemmel i forbindelse hermed anses for at være implicit givet Kapacitets- og servicekrav Ca breve pr. måned. En forsendelse forventes at fylde ca. 20 KByte (30 KByte v/ base 64), og en masseforsendelse vil indeholde maksimum omkring breve for en kommune. Dvs. filstørrelse omkring 1100 MByte der samlet skal afsendes. Minimum 90% af disse forsendelser forventes afsendt via Digital Post et brev ad gangen Specifikke forhold for tilslutning af system Det skal sikres, at kommunen har aftaler med Digital Post og en Fjernprint-leverandør, således at både fagsystem og Serviceplatformen kender kommunens SystemId for både Digital Post og Fjernprint samt Fjernprint-URL gennem Serviceaftale/Sikkerhed. Uden disse kan Serviceplatformen ikke rute forsendelsen til den korrekte modtager samt afhente tilmeldinger og status. 2.2 Kontekst for KSD Lovhjemmel og forvaltningsmæssigt formål Det forvaltningsmæssige formål er at kommunikere med borgere. Lovhjemmel i forbindelse hermed anses for at være implicit givet Kapacitets- og servicekrav Ca breve pr. måned. En forsendelse forventes at fylde ca. 20 KByte (30 KByte v/ base 64), og en masseforsendelse vil indeholde maksimum omkring breve for en kommune. Dvs. filstørrelse omkring 660 MByte. Minimum 90% af disse forsendelser forventes afsendt via Digital Post et brev ad gangen Specifikke forhold for tilslutning af system Det skal sikres, at kommunen har aftaler med Digital Post og en Fjernprint-leverandør, således at både fagsystem og Serviceplatformen kender kommunens SystemId for både Digital Post og Fjernprint samt Fjernprint-URL gennem Serviceaftale/Sikkerhed. Uden disse kan Serviceplatformen ikke rute forsendelsen til den korrekte modtager samt afhente tilmeldinger og status. KOMBIT A/S Halfdansgade København S CVR Side 19 af 87

20 2.3 Kontekst for Ejendomsskat Lovhjemmel og forvaltningsmæssigt formål Det forvaltningsmæssige formål er at kommunikere med borgere. Lovhjemmel i forbindelse hermed anses for at være implicit givet Kapacitets- og servicekrav Ca. 2,1 mio breve en gang årligt samt et mindre antal ad-hoc forsendelser. En forsendelse forventes at fylde ca. 20 KByte (30 KByte v/ base 64), og en masseforsendelse vil indeholde maksimum omkring breve for en kommune. Dvs. filstørrelse omkring 7,5 GByte. Minimum 90% af disse forsendelser forventes afsendt via Digital Post et brev ad gangen Specifikke forhold for tilslutning af system Det skal sikres, at kommunen har aftaler med Digital Post og en Fjernprint-leverandør, således at både fagsystem og Serviceplatformen kender kommunens SystemId for både Digital Post og Fjernprint samt Fjernprint-URL gennem Serviceaftale/Sikkerhed. Uden disse kan Serviceplatformen ikke rute forsendelsen til den korrekte modtager samt afhente tilmeldinger og status. KOMBIT A/S Halfdansgade København S CVR Side 20 af 87

21 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for KY, KSD og Ejendomsskat Integrationen benyttes til at afsende breve (digitale og fysiske) samt forespørge på tilmelding til Digital Post via Serviceplatformen (SP). Desuden vil fagsystemerne modtager kvitteringer fra Digital Post og status fra Fjernprint via BeskedFordeler fra Serviceplatformen Overordnet forretningslogik Når et fagsystem ønsker at afsende breve, enten digitalt eller fysisk, skal fagsystemet først spørge på, om modtageren er tilmeldt Digital Post på SP Endpoint EP_SP1, hvor svaret kan benyttes i forbindelse med formatering af brevet og senere til afsendelse til enten Digital Post eller Fjernprint. Fagsystemet modtager ændringer til tilmeldinger gennem BeskedFordeler (EP_BF01). Hvis fagsystemet skal afsende et brev benyttes Endpoint EP_SP2, hvor kanalvalg sættes til Digital Post, Fjernprint eller automatisk (D, F, A, P) samt prioritering Direkte eller Masseafsendelse (D, M). Serviceplatformen ruter til kommunens Fjernprintleverandør fra Serviceaftale/Sikkerhed. Status for direkte afsendelsen til Digital Post returneres i kaldet til EP_SP2 (synkront svar). For masseafsendelse til Digital Post eller Fjernprint bliver kvitteringer og status returneret gennem BeskedFordeler (EP_BF01). Fagsystemerne har mulighed for at abonnere, gennem Endpoint EP_BF02, på ændringer i tilmelding til Digital Post (og NemSMS) samt status på print gennem BeskedFordeler, hvor de gennem Endpoint EP_BF1 modtager beskederne. Serviceplatformen sørger for at placere ændringer til tilmeldingerne samt status på print på BeskedFordeler Oversigt over endpoints ID Navn EP_SP1 EP_SP2 EP_BF1 EP_BF2 Spoerg_tilmelding_SP Afsend_brev_SP ModtagBeskeder [SF1460_D/SF1460_A] AdministrerVaerdiliste [SF1460_B] Beskrivelse af endpoint EP_SP1 - Spoerg_tilmelding_SP Transportspecifikation Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender Fagsystemerne, KY, KSD, ESR, er serviceanvendere. KOMBIT A/S Halfdansgade København S CVR Side 21 af 87

22 Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice, version Teknisk endpoint [Udfyldes med teknisk endpoint] Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL [WSDL-SP] Se filen PrintService.wsdl Endpoint navn [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP [Afklaring/SP: Endelig IP skal indsættes] Miljø: Test URI til WSDL [WSDL-SP] Se filen PrintService.wsdl Endpoint navn [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP [Afklaring/SP: Endelig IP skal indsættes] Teknisk retning for udveksling Fagsystemet kalder Serviceplatformen Dataretning for udveksling Serviceplatformens webservice sender svar til det kaldende fagsystem Service invokation / Triggers Kommunikationen initieres af, at fagsystemet ønsker at vide om borgeren er tilmeldt Digital Post og/eller NemSMS Dataspecifikation Servicen kaldes med SpoergTilmeldingRequest og den returnerer SpoergTilmeldingResponse. Ved fejl returneres standard KOMBIT SOAP fault. Se Transportkvittering i [Fejlhåndtering] Detaljeret dokumentation af grænseflader findes på [Digital Post]. KOMBIT A/S Halfdansgade København S CVR Side 22 af 87

23 SpoergTilmeldingRequest Niv Feltnavn Kard Værdisæt Betegnelse 1 AfsenderMyndighed Objekttype 1..1 String Klassifikation = Myndighed 2 ReferenceID 1..1 URN Kommunens CVR-nr (URN urn:oio:cvr-nr:xxxxxxxx ) 1 TilmeldingRequest CPR-nr eller CVR-nr skal være udfyldt 2 Systemvalg 1..1 Char D =Digital Post (eller N =NemSMS) 2 IndholdstypeId 1..1 Den indholdstype (DP/SMS) der spørges på 2 CVR-nr 0..1 String 8-ciftret tal uden bindestreg 2 CPR-nr 0..1 String 10-ciftret tal uden bindestreg SpoergTilmeldingResponse Niv Feltnavn Kard Værdisæt Betegnelse 1 boolean 1..1 Bool true/false Miljø: Produktion Inputdata Outputdata [WSDL-SP]/XSD [WSDL-SP]/XSD Miljø: Test Inputdata [WSDL-SP]/XSD KOMBIT A/S Halfdansgade København S CVR Side 23 af 87

24 Outputdata [WSDL-SP]/XSD Sikkerhed Sikkerhed mellem fagsystemerne og Serviceplatformen er tokenbaseret, som defineret i UC-SEC- 06 i RA STS [STS-Sikkerhed]. Servicen er en gennemstilling til Digital Post Leverancesikkerhed og fejlhåndtering Servicen er ikke forretningskritisk. Quality of Service er At least once. I tilfælde af fejl kan det kaldende system forsøge at gentage forespørgslen 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 Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. Må antages at være i perioden 06:00-18:00 på arbejdsdage 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. KOMBIT A/S Halfdansgade København S CVR Side 24 af 87

25 3.1.4 Beskrivelse af endpoint EP_SP2 - Afsend_brev_SP Transportspecifikation Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender Fagsystemerne, KY, KSD, ESR, er serviceanvendere Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice, version Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL [WSDL-SP] Se filen PrintService.wsdl Endpoint navn [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP [Afklaring/SP: Endelig IP skal indsættes] Miljø: Test URI til WSDL [WSDL-SP] Se filen PrintService.wsdl Endpoint navn [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP [Afklaring/SP: Endelig IP skal indsættes] Teknisk retning for udveksling Fagsystemet kalder synkrone service på Serviceplatformen Dataretning for udveksling Fagsystemet afsender data til Fjernprint Service invokation / Triggers Kommunikation initieres når fagsystemet har behov for at afsende et brev til modtageren. KOMBIT A/S Halfdansgade København S CVR Side 25 af 87

26 Dataspecifikation Servicen kaldes med AfsendBrevSPRequest og den returnerer AfsendBrevSPResponse. Ved fejl returneres standard KOMBIT SOAP fault. AfsendBrevSPRequest består af AfsenderMyndighed og BrevSPBody Detaljeret dokumentation af grænseflader og XSD findes på [Fjernprint]. AfsendBrevFPRequest Niv Feltnavn Kard Værdisæt Betegnelse 1 AfsenderMyndighed 1..1 String 2 Objekttype 1..1 String Klassifikation = Myndighed 2 ReferenceID 1..1 URN Kommunens CVR-nr (URN urn:oio:cvr-nr:xxxxxxxx ) 1 BrevSPBody AfsendelsesID 1..1 String (1..30) UUID eller løbenummer oprettet af afsendersystem. Skal være unik inden for et afsendersystem. De første 6 tegn indeholder SystemIdentifikator (MyndighedsId overfor Digital Post, NemSMS eller Fjernprint) med foranstillede nuller, de næste 3 tegn er AfsenderSystem ( KY-, KSD, E&R...) og de sidste 21 tegn angiver et unikt nummer for dokumentet f.eks. et løbenummer med foranstillede nuller KSD Kanalvalg 1..1 String D for DigitalPost, F for fysisk post eller A for automatisk på SP eller P for automatisk på Fjernprint. S for NemSMS. 2 Prioritet 1..1 String D for Direkte og M for Masseafsendelse 2 ForsendelseI 1..1 Complex ForsendelseI.xsd fra [Fjernprint] [KDF/Afklaring liste over Fagsystem-forkortelser KY-, KSD, ESR ] AfsendBreveResponse Niv Feltnavn Kard Værdisæt Betegnelse KOMBIT A/S Halfdansgade København S CVR Side 26 af 87

27 1 [Standard KOMBIT fejl struktur] Hvis der er fejl returneres en KOMBIT SOAP fault. Miljø: Produktion Inputdata Outputdata [WSDL-SP]/XSD [WSDL-SP]/XSD Miljø: Test Inputdata Outputdata [WSDL-SP]/XSD [WSDL-SP]/XSD Sikkerhed Sikkerhed mellem fagsystemerne og Serviceplatformen er tokenbaseret, som defineret i UC-SEC- 06 i RA STS [STS-Sikkerhed] Leverancesikkerhed og fejlhåndtering Det er vigtigt, at alle breve, der bestilles via printkomponenten på Serviceplatformen, afsendes rettidigt til borgeren. Quality of Service skal derfor være mindst At Least Once. I tilfælde af fejl kan afsenderen forsøge at genfremsende beskeden med samme AfsendelsesID. Såfremt afsendelsen allerede er sket ved en genfremsendelse, ignoreres hele meddelelsen Såfremt et eller flere breve fejler senere i processen (via asynkron tilbagemelding), og afsenderen vælger at forsøge genfremsendelse skal dette ske på et nyt AfsendelsesID, da meddelelsen ellers afvises som en dublet. Afsender skal kunne styre, hvor mange parallelle tråde der sender samtidig. Såfremt der kommer mange time-out i en periode, skal grænsen kunne sættes ned, så modtagersystemerne ikke overbelastes Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. KOMBIT A/S Halfdansgade København S CVR Side 27 af 87

28 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. Må antages at være i perioden 06:00-18:00 på arbejdsdage 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 Beskrivelse af endpoint EP_BF1 - ModtagBesked Beskrivelsen af endpoint EP_BF1 findes i Modtag besked [SF1460_A] og Modtag besked via pull [SF1460_D]. Beskedfordeler udstiller beskeder fra Digital Post og Fjernprint. Endpoint benyttes af fagsystemerne i forbindelse med besked om tilmeldingsændringer, status og kvitteringer Abonnementsvilkår Fagsystemet skal oprette abonnement på følgende beskedtyper: Digital Post tilmelding NemSMS tilmelding Status print Beskedtypen Digital Post tilmelding. Fagsystemerne skal desuden oprette abonnement på Objekt: ObjektType = Person eller Virksomhed og ObjektID = CPR-nummer' eller CVR-nummer KOMBIT A/S Halfdansgade København S CVR Side 28 af 87

29 ObjektTypen Person har UUID fa-edeb-40c bb7de17a7b Virksomhed har UUID <Indsæt UUID for virksomhed>. ObjektID CPR-nummer administreres vha. værdilisten Personkreds og CVR-nummer administreres vha. værdilisten Virksomhedkreds. Abonnementet oprettes ved angivelse af følgende abonnementsudtryk: (((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektType = faedeb-40c bb7de17a7b ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.Objekt- Registrering[0].ObjektId )) OR ((((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektType = <UUID for virksomhed> ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektId )) Beskedtypen NemSMS tilmelding. Fagsystemerne skal desuden oprette abonnement på Objekt: ObjektType = Person eller Virksomhed og ObjektID = CPR-nummer' eller CVR-nummer ObjektTypen Person har UUID fa-edeb-40c bb7de17a7b Virksomhed har UUID <Indsæt UUID for virksomhed>. ObjektID CPR-nummer administreres vha. værdilisten Personkreds og CVR-nummer administreres vha. værdilisten Virksomhedkreds. Abonnementet oprettes ved angivelse af følgende abonnementsudtryk: (((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektType = faedeb-40c bb7de17a7b ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.Objekt- Registrering[0].ObjektId )) OR ((((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektType = <UUID for virksomhed> ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektId )) Beskedtypen Status print. Fagsystemerne skal desuden oprette abonnement på ObjektType = Dokument og ObjektID = DokumentId' ObjektTypen Dokument har UUID [Indsæt UUID for Dokument]. ObjektID DokumentId er UUID eller løbenummer oprettet af afsendersystem. Skal være unik inden for et afsendersystem. De første 6 tegn indeholder SystemIdentifikator (MyndighedsId overfor Digital Post, NemSMS eller Fjernprint) med foranstillede nuller, de næste 3 tegn er AfsenderSystem ( KY-, KSD, E&R...) og de sidste 21 tegn angiver et unikt nummer for dokumentet f.eks. et løbenummer med foranstillede nuller KSD og oprettes af fagsystemet. Abonnementet oprettes ved angivelse af følgende abonnementsudtryk: KOMBIT A/S Halfdansgade København S CVR Side 29 af 87

30 ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektType = [Indsæt UUID for Dokument] ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].ObjektId LIKE KSD% )) Værdilisterne Personkreds og Virksomhedkreds vedligeholdes som angivet i afsnit Dataspecifikation Dataspecifikationen for beskedkuverten findes i følgende schema-filer: Miljø: Produktion og Test Inputdata [SF1460_D] Outputdata Dataspecifikationen for indholdet af selve beskedindholdet findes i følgende schema-filer: Miljø: Produktion og Test Inputdata Outputdata [Udfyldes af Systematic senere indholdet beskrevet svarer afsnit Fejl! Henvisningskilde ikke fundet.] Se afsnit Fejl! Henvisningskilde ikke fundet. for en beskrivelse af indholdet i beskedkuvert og indhold Beskrivelse af endpoint EP_BF2 - AdministrerVaerdiliste Beskrivelsen af endpoint findes i Vedligehold værdiliste i beskedabonnement [SF1460_B]. Beskedfordeler udstiller administrationsinterface til vedligehold af værdilister i beskedabonnementer. Endpoint kaldes af fagsystemerne i forbindelse med vedligehold af værdilister i beskedabonnement Værdiliste Fagsystemerne skal vedligeholde værdilister for de personkredse og adresselister, det ønsker at abonnere på. Værdilisterne skal oprettes med følgende navn: Personkreds Personkreds KOMBIT A/S Halfdansgade København S CVR Side 30 af 87

31 Virksomhedsliste Virksomhedkreds Service Management Beskrivelsen af Service Management findes i Modtag besked [SF1460_A], Modtag besked via pull [SF1460_D] og Vedligehold værdiliste i beskedabonnement [SF1460_B] Incident Management [Afklaring/Programmet rejst emne: skal der være SPOC på integrationer?] Problem Management [Afklaring/Programmet rejst emne: skal der være SPOC på integrationer?] Change Management [Afklaring/Programmet rejst emne: skal der være SPOC på integrationer?] Testplan Integrationstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unit tests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] Produktionssætningstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unit tests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 3.2 Specifikation af endpoints for Digital Post Integrationen benyttes til at afsende breve til Digital Post, videresende tilmeldingsændringer til BeskedFordeler samt afhente kvitteringer fra Digital Post Overordnet forretningslogik Serviceplatformen viderestiller servicekald fra fagsystemerne på en SOAP webservice grænseflade til Digital Post på en OIOREST grænseflade. Således kan fagsystemerne gennem Serviceplatformen: 1. forespørge på om borgeren er tilmeldt til Digital Post (og NemSMS) KOMBIT A/S Halfdansgade København S CVR Side 31 af 87

32 2. afsende et brev til Digital Post 3. masseafsende et brev til Digital Post (afsendes et af gangen og behandles i batch) 4. hente kvitteringer for afsendelserne 5. kvittere for kvitteringerne Desuden henter Serviceplatformen dagligt en kopi af tilmeldinger til Digital Post for at sende ændringer til disse tilmeldinger til BeskedFordeleren, hvor fagsystemerne kan abonnere på disse. På Serviceplatformen sikrer vi i aftaleindgåelse og vedligehold at der per Myndighed er registreret og persisteret SystemId for Digital Post, NemSMS og Fjernprint. Grænsefladebeskrivelser og XSD finder på [Digital Post] Oversigt over endpoints ID Navn EP_DP1 EP_DP2 EP_DP3 EP_DP4 EP_DP5 EP_DP6 EP_DP7 Spoerg_tilmelding_DP Afsend_brev_DP Masseafsend_brev_DP Modtag_kvittering_DP Kvitter_kvittering_DP Hent_tilmeldingsliste_DP Hent_tilmeldinger_delliste_DP Beskrivelse af endpoint EP_DP1 - Spoerg_tilmelding_DP Transportspecifikation Serviceudstiller Digital Post er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en OIO-REST Teknisk endpoint OIO-REST kaldet er: HTTP GET /afsendersystem/{sysid}/tilmeldinger/{indholdstypeid}?cpr=xxxxxxxxx eller HTTP GET /afsendersystem/{sysid}/tilmeldinger/{indholdstypeid}?cvr=xxxxxxx KOMBIT A/S Halfdansgade København S CVR Side 32 af 87

33 Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP Miljø: Test URI til WSDL Endpoint navn Endpoint IP Teknisk retning for udveksling Serviceplatformen kalder Digital Post for at spørge på, om borgeren er tilmeldt Digital Post (eller NemSMS) Dataretning for udveksling Digital Post giver et svar til Serviceplatformen Service invokation / Triggers Når et fagsystem skal vide om en borger er tilmeldt Digital Post Dataspecifikation Kaldet er specificeret i Bilag-A1--REST--Afsendersystem-v631-uden-ndringsmarkering.pdf, afsnit A Forespørg om en slutbruger ønsker en specifik indholdstype. [Digital Post] Miljø: Produktion Inputdata Outputdata SysId Status (BOOL) (OIOXML) Miljø: Test Inputdata Outputdata Hvis er der standard fejl i forbindelse med kaldet er de beskrevet i Bilag-A5-REST http-returkoder-og-fejlkoder-v63-uden-ndringsmarkering.pdf. KOMBIT A/S Halfdansgade København S CVR Side 33 af 87

34 Sikkerhed Sikkerhed mellem Serviceplatformen og Digital Post er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC-06. [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet på Serviceplatformen, ( hvor der også ligger vejledning til udviklere, samt demoprojekter.] Leverancesikkerhed og fejlhåndtering At least once. SP kan forespørge flere gange hvis der opstår fejl 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 [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Beskrivelse af endpoint EP_DP2 - Afsend_brev_DP Transportspecifikation Serviceudstiller Digital Post er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som OIOREST. KOMBIT A/S Halfdansgade København S CVR Side 34 af 87

35 Teknisk endpoint [Udfyldes med teknisk endpoint] OIO-REST kaldet er: HTTP PUT /afsendersystem/{sysid}/afsendelser/{meddelelsesid} Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP Miljø: Test URI til WSDL Endpoint navn Endpoint IP Teknisk retning for udveksling Serviceplatformen kalder Digital Post Dataretning for udveksling Serviceplatformen overfører brevet til Digital Post Service invokation / Triggers Når et fagsystem afsender et brev til Digital Post via Serviceplatformen Dataspecifikation [Udfyld specifikation for både input og output data. Dataelementer specificeres med elementnavn, datatype, feltlængde, valgfri/tvungen, evt. bemærkning til anvendelse, og krav til validering.] Kaldet er specificeret i Bilag-A1--REST--Afsendersystem-v631-uden-ndringsmarkering.pdf, afsnit A1.3.1 Enkeltafsendelse / opdater en afsendelse. [Digital Post] Miljø: Produktion Inputdata Afsendelse (OIOXML) Outputdata KOMBIT A/S Halfdansgade København S CVR Side 35 af 87

36 Miljø: Test Inputdata Outputdata Sikkerhed Sikkerhed mellem Serviceplatformen og Digital Post er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC-06. [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet på Serviceplatformen, ( hvor der også ligger vejledning til udviklere, samt demoprojekter.] Leverancesikkerhed og fejlhåndtering At least once. Digital Post afviser forsendelser med samme afsendelsesid, og brevet skal sendes med et nyt afsendelsesid 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 [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] KOMBIT A/S Halfdansgade København S CVR Side 36 af 87

37 3.2.5 Beskrivelse af endpoint EP_DP3 - Masseafsend_brev_DP] Transportspecifikation Serviceudstiller Digital Post er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som OIO-REST Teknisk endpoint OIO-REST kaldet er: HTTP PUT /afsendersystem/{sysid}/masseafsendelser/{mid} [Udfyldes med teknisk endpoint] Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP Miljø: Test URI til WSDL Endpoint navn Endpoint IP Teknisk retning for udveksling Serviceplatformen kalder Digital Post Dataretning for udveksling Serviceplatformen overfører brevet til Digital Post Service invokation / Triggers Når et fagsystem afsender flere breve (masseafsendelse) til Digital Post via Serviceplatformen. KOMBIT A/S Halfdansgade København S CVR Side 37 af 87

38 Dataspecifikation Kaldet er specificeret i Bilag-A1--REST--Afsendersystem-v631-uden-ndringsmarkering.pdf, afsnit A1.3.2 Aflever masseforsendelse. [Digital Post] Miljø: Produktion Inputdata Outputdata Afsendelse (OIOXML) Fejlkode Miljø: Test Inputdata Outputdata Sikkerhed Sikkerhed mellem Serviceplatformen og Digital Post er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC-06 [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet på Serviceplatformen, ( hvor der også ligger vejledning til udviklere, samt demoprojekter.] Leverancesikkerhed og fejlhåndtering At least once. Fagsystemet skal afsende med et entydigt mid (meddelelsesid) Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Værdi [Udfyldes med tidsrummet hvor der sikres normal drift] KOMBIT A/S Halfdansgade København S CVR Side 38 af 87

39 Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Beskrivelse af endpoint EP_DP4 - Modtag_kvittering_DP Transportspecifikation Serviceudstiller Digital Post er serviceudstiller Serviceanvender Serviceplatform er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en OIO-REST service Teknisk endpoint OIO-REST kaldet er: HTTP GET /afsendersystem/{sysid}/masseafsendelser/kvitteringsliste Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP Miljø: Test URI til WSDL Endpoint navn Endpoint IP Teknisk retning for udveksling Serviceplatformen kalder Digital Post OIO-REST service for at hente kvitteringsliste. KOMBIT A/S Halfdansgade København S CVR Side 39 af 87

40 Dataretning for udveksling Digital Post sender svar til Serviceplatformen Service invokation / Triggers Serviceplatformen kalder periodisk ofte et døgn efter en masseafsendelse for at hente kvitteringslisten fra afsendelser. SysId henter fra cache per myndighed Dataspecifikation Kaldet er specificeret i Bilag-A1--REST--Afsendersystem-v631-uden-ndringsmarkering.pdf, afsnit A1.3.3 Hent kvitteringsliste for masseforsendelser. [Digital Post] Miljø: Produktion Inputdata Outputdata SysId MasseforsendelseKvitteringSamling (OIOXML) Eller Fejlkode Miljø: Test Inputdata Outputdata Sikkerhed Sikkerhed mellem Serviceplatformen og Digital Post er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC-06. [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet på Serviceplatformen, ( hvor der også ligger vejledning til udviklere, samt demoprojekter.] Leverancesikkerhed og fejlhåndtering At least once. SP skal kunne læse samme kvittering igen, indtil der kvitteres for kvitteringen via EP_DP5 KOMBIT A/S Halfdansgade København S CVR Side 40 af 87

41 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 [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Beskrivelse af endpoint EP_DP5 - Kvitter_kvittering_DP Transportspecifikation Serviceudstiller Digital Post er serviceudstiller Serviceanvender Serviceplatform er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en OIO-REST service Teknisk endpoint OIO-REST kaldet er: HTTP DELETE /afsendersystem/{sysid}/masseafsendelser/kvitteringsliste/{id} Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP Miljø: Test KOMBIT A/S Halfdansgade København S CVR Side 41 af 87

42 URI til WSDL Endpoint navn Endpoint IP Teknisk retning for udveksling Serviceplatformen kalder Digital Post OIO-REST service for at kvittere for modtagelse af kvitteringsliste, hvorefter den fjernes hos Digital Post Dataretning for udveksling Digital Post sender svar til Serviceplatformen Service invokation / Triggers Serviceplatformen kalder Digital Post for at kvittere for kvitteringslisten fra en masseafsendelse, når denne er returneret til fagsystemet. SysId hentes fra cache per myndighed Dataspecifikation Kaldet er specificeret i Bilag-A1--REST--Afsendersystem-v631-uden-ndringsmarkering.pdf, afsnit A1.3.4 Kvitter for kvitteringsliste (masseforsendelser). [Digital Post] Miljø: Produktion Inputdata SysId Id for kvitteringsliste Outputdata Fejlkode Miljø: Test Inputdata Outputdata Sikkerhed Sikkerhed mellem Serviceplatformen og Digital Post er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC-06. [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet KOMBIT A/S Halfdansgade København S CVR Side 42 af 87

43 på Serviceplatformen, ( hvor der også ligger vejledning til udviklere, samt demoprojekter.] Leverancesikkerhed og fejlhåndtering At least once 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 [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Beskrivelse af endpoint EP_DP6 - Hent_tilmeldingsliste_DP Transportspecifikation Serviceudstiller Digital Post er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en OIO-REST Teknisk endpoint OIO-REST kaldet er: HTTP GET /afsendersystem/{sysid}/tilmeldingsliste Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL KOMBIT A/S Halfdansgade København S CVR Side 43 af 87

44 Endpoint navn Endpoint IP Miljø: Test URI til WSDL Endpoint navn Endpoint IP Teknisk retning for udveksling Serviceplatformen kalder Digital Post for at hente tilmeldingslister Dataretning for udveksling Digital Post giver en tilmeldingsliste til Serviceplatformen Service invokation / Triggers Den køres dagligt for hver kommune. SysId hentes fra cache per myndighed Dataspecifikation Kaldet er specificeret i Bilag-A1--REST--Afsendersystem-v631-uden-ndringsmarkering.pdf, afsnit A Hent tilmeldingsliste. [Digital Post] Miljø: Produktion Inputdata Outputdata SysId TilmeldingSamlingReferenceSamling (OIOXML) Miljø: Test Inputdata Outputdata Sikkerhed Sikkerhed mellem Serviceplatformen og Digital Post er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed],UC-SEC-06 [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række KOMBIT A/S Halfdansgade København S CVR Side 44 af 87

45 krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet på Serviceplatformen, ( hvor der også ligger vejledning til udviklere, samt demoprojekter.] Leverancesikkerhed og fejlhåndtering At least once. SP skal kunne hente listen flere gange hvis der opstår fejl 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 [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Beskrivelse af endpoint EP_DP7 - Hent_tilmeldinger_delliste_DP Transportspecifikation Serviceudstiller Digital Post er serviceudstiller Serviceanvender Serviceplatformen er serviceanvendere Teknologisk understøttelse Snitfladen er implementeret som OIO-REST Teknisk endpoint OIO-REST kaldet er: HTTP GET /afsendersystem/{sysid}/tilmeldingsliste/ {tilmeldingslisteid}/{dellisteid} Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion KOMBIT A/S Halfdansgade København S CVR Side 45 af 87

46 URI til WSDL Endpoint navn Endpoint IP Miljø: Test URI til WSDL Endpoint navn Endpoint IP Teknisk retning for udveksling Serviceplatformen kalder Digital Post Dataretning for udveksling Digital Post OIO-REST service sender svar til Serviceplatformen Service invokation / Triggers Daglig opdatering af Tilmeldinger fra Digital Post pr. kommune. SysId hentes fra cache per myndighed Dataspecifikation Kaldet er specificeret i Bilag-A1--REST--Afsendersystem-v631-uden-ndringsmarkering.pdf, afsnit A Hent en del af en tilmeldingsliste. Miljø: Produktion Inputdata SysId TilmeldingListeId DelIsterId Outputdata TilmeldingData (CSV) Miljø: Test Inputdata Outputdata KOMBIT A/S Halfdansgade København S CVR Side 46 af 87

47 Sikkerhed Sikkerhed mellem Serviceplatformen og Digital Post er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC-06 [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet på Serviceplatformen, ( hvor der også ligger vejledning til udviklere, samt demoprojekter.] Leverancesikkerhed og fejlhåndtering At least once. SP skal kunne hente listen flere gange hvis der opstår fejl 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 [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Service Management Incident Management [Afklaring/Programmet rejst emne: skal der være SPOC på integrationer?] Problem Management [Afklaring/Programmet rejst emne: skal der være SPOC på integrationer?] KOMBIT A/S Halfdansgade København S CVR Side 47 af 87

48 Change Management [Afklaring/Programmet rejst emne: skal der være SPOC på integrationer?] Testplan Integrationstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unit tests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] Produktionssætningstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unit tests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 3.3 Specifikation af endpoints for Fjernprint Integrationen benyttes til at afsende breve til Fjernprint samt hente status for forsendelserne i Fjernprint Overordnet forretningslogik Serviceplatformen kan afsende et brev fra et fagsystem til Fjernprint på Endpoint EP_FP1. Serviceplatformen får afsendersystem fra fagsystemet og ruter ud fra Serviceaftale/Sikkerhed, som henviser til kommunens Fjernprint. Serviceplatformen kan hente status for Fjernprint på Endpoint EP_FP2. Ved fejl eller statusændringer kan der efterfølgende hentes detaljer om forsendelsen på Endpoint EP_FP3. Serviceplatformen henter afsendersystem fra cache per myndighed fra it-systemer i Organisation Oversigt over endpoints ID Navn EP_FP1 EP_FP2 EP_FP3 Afsend_brev_FP Hent_status_FP Hent_statusdetalje_FP KOMBIT A/S Halfdansgade København S CVR Side 48 af 87

49 3.3.3 Beskrivelse af endpoint EP_FP1 - Afsend_brev_FP Transportspecifikation Serviceudstiller Fjernprint er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som OIOREST Teknisk endpoint OIOREST kaldet er: HTTP PUT /Fjernprint/{afsendersystem}/enkeltforsendelse/{afsendelsesid) Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP Miljø: Test URI til WSDL Endpoint navn Endpoint IP Teknisk retning for udveksling Serviceplatformen kalder Fjernprint OIOREST service Dataretning for udveksling Serviceplatformen overfører brevene til Fjernprint Service invokation / Triggers Når et fagsystem afsender et brev til Fjernprint via Serviceplatformen Dataspecifikation Kaldet er specificeret Stralfors Connect System_til_system.pdf, afsnit [Fjernprint] KOMBIT A/S Halfdansgade København S CVR Side 49 af 87

50 Miljø: Produktion Inputdata Afsendersystem AfsendelsesID ForsendelseI (OIOXML ForsendelseI.xsd fra [Fjernprint]) Outputdata Miljø: Test Inputdata Outputdata Sikkerhed Sikkerhed mellem Serviceplatformen og Fjernprint er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC-06 [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet på Serviceplatformen, ( hvor der også ligger vejledning til udviklere, samt demoprojekter.] Leverancesikkerhed og fejlhåndtering At least once. Modtager skal håndtere at samme AfsendelseID modtages flere gange. Ved fejl skal Serviceplatformen logge fejlen og forsøge igen efter et kortere tidsinterval. Ved gentagne fejl skal Serviceplatformen sende fejl retur til fagsystemet, da printet er datofastsat og derfor skal laves om, hvis det ikke kan afleveres indenfor det døgn det er skabt Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Værdi [Udfyldes med tidsrummet hvor der sikres normal drift] KOMBIT A/S Halfdansgade København S CVR Side 50 af 87

51 Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Beskrivelse af endpoint EP_FP2 - Hent_status_FP Transportspecifikation Serviceudstiller Fjernprint er serviceudstiller Serviceanvender Serviceplatform er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en OIO-REST service Teknisk endpoint OIO-REST kaldet er: HTTP POST / Fjernprint/{afsendersystem}/log Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP Miljø: Test URI til WSDL Endpoint navn Endpoint IP Teknisk retning for udveksling Serviceplatformen kalder Fjernprint OIO-REST service for at hente metadata for status. KOMBIT A/S Halfdansgade København S CVR Side 51 af 87

52 Dataretning for udveksling Fjernprint sender svar til Serviceplatformen Service invokation / Triggers Serviceplatformen kalder periodisk for at hente statuslisten fra Fjernprint i tidsinterval (siden sidste kald) for at returnere denne til fagsystemet gennem BeskedFordeler. afsendersystem hentes fra cache per myndighed Dataspecifikation Kaldet er specificeret Stralfors Connect System_til_system.pdf, afsnit [Fjernprint] Miljø: Produktion Inputdata Afsendersystem TransaktionsLogForsendelserI (OIOXML TransaktionsLogForsendelserI.xsd fra [Fjernprint] Outputdata TransaktionsLogForsendelseSoegeresultatSamling (OIOXML TransaktionsLogForsendelseSoegeresultatSamling.xsd fra [Fjernprint]) Miljø: Test Inputdata Outputdata Sikkerhed Sikkerhed mellem Serviceplatformen og Fjernprint er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC-06 [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet på Serviceplatformen, ( hvor der også ligger vejledning til udviklere, samt demoprojekter.] Leverancesikkerhed og fejlhåndtering At least once. SP skal kunne læse samme status igen Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. KOMBIT A/S Halfdansgade København S CVR Side 52 af 87

53 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Beskrivelse af endpoint EP_FP3 - Hent_statusdetalje_FP Transportspecifikation Serviceudstiller Fjernprint er serviceudstiller Serviceanvender Serviceplatform er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en OIO-REST service Teknisk endpoint OIO-REST kaldet er: HTTP GET /Fjernprint/1.0.0/{sysid}/enkeltforsendelse/log/{afsendelsesid} eller HTTP GET /Fjernprint/1.0.0/{sysid}/enkeltforsendelse/log/id/{forsendelsesid} afhængig af kaldet fra Fagsystemet, hvor enten afsendelsesid eller forsendelseid er udfyldt. Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP KOMBIT A/S Halfdansgade København S CVR Side 53 af 87

54 Miljø: Test URI til WSDL Endpoint navn Endpoint IP Teknisk retning for udveksling Serviceplatformen kalder Fjernprint OIO-REST service for at få detaljeret stats for en forsendelse fra statuslisten (fra EP_FP4) Dataretning for udveksling Fjernprint sender svar til Serviceplatformen Service invokation / Triggers Serviceplatformen kalder Fjernprint for at hente status-detaljer for en forsendelse eller masseafsendelse. Afsendersystem (sysid) hentes fra cache per myndighed Dataspecifikation Kaldet er specificeret Stralfors Connect System_til_system.pdf, afsnit [Fjernprint]. Miljø: Produktion Inputdata SysId AfsendelsesId eller ForsendelsesId Outputdata ForsendelseO (OIOXML fosendelseo.xsd fra [Fjernprint] Miljø: Test Inputdata Outputdata Sikkerhed Sikkerhed mellem Serviceplatformen og Fjernprint er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC-06 [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række KOMBIT A/S Halfdansgade København S CVR Side 54 af 87

55 krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet på Serviceplatformen, ( hvor der også ligger vejledning til udviklere, samt demoprojekter.] Leverancesikkerhed og fejlhåndtering At least once 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 [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Service Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer?] Problem Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer?] Change Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer?] Testplan Integrationstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unit tests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] KOMBIT A/S Halfdansgade København S CVR Side 55 af 87

56 Produktionssætningstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unit tests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 3.4 Specifikation af endpoints mellem Serviceplatformen og BeskedFordeler Integrationen leverer hændelser omkring personers tilmelding til Digital Post til fagsystemer via BeskedFordeler samt status/kvittering fra print Overordnet forretningslogik Serviceplatformen henter tilmeldingslister per myndighed fra Digital Post (og NemSMS). SystemId hentes fra cache per myndighed fra it-systemer i Organisation. Serviceplatformen beregner hvilke hændelser, som er foretaget ud fra gårsdagens liste og dagens liste, med data i ændringen. Serviceplatformen afsender beskeden til BeskedFordeler på EP_BF3. Serviceplatformen gemmer dagligt listen, transformerer data til beskedindhold og udsender beskeder via BeskedFordeler. Serviceplatformen henter periodisk kvitteringer fra Digital Post og status fra Fjernprint. Serviceplatformen beregner hvilke hændelser, som er sket med afsende breve (digitalt og fysisk) og afsender beskeden til BeskedFordeler på EP_BF3. Fagsystemerne vil hente beskeder via EP_BF Oversigt over endpoints ID Navn EP_BF3 AfsendBesked Beskrivelse af endpoint EP_BF3 AfsendBesked Beskrivelsen af endpoint EP_BF3 findes i Aflever besked [SF1460_C]. Serviceplatformen sender tilmelding-, status- og kvitteringsinformation. Endpoint kaldes ved ændring i Digital Post, NemSMS eller Fjernprint Dataspecifikation En besked består af en kuvert og et beskedindhold. KOMBIT A/S Halfdansgade København S CVR Side 56 af 87

57 Beskedkuverten dataspecifikation Dataspecifikationen for beskedkuverten findes i følgende schema-filer: Miljø: Produktion og Test Inputdata [SF1460_C] Outputdata [SF1460_C] Beskedkuverten skal udfyldes, således at det er muligt at abonnere på ændringer. Værdier angivet med er faste værdier, der skal sættes ind i Beskedkuverten. Andre værdier skal afsendersystemet selv udfylde. [De fleste Id er er baseret på UUID dog med undtagelse af: KLE - urn:oio:kle:nn.nn.nn CPR - urn:oio.cpr:nnnnnnnnnn CVR - urn:oio:cvr:nnnnnnnn PNR urn:oio:pnr:nnnnnnnnnn Fuldtnavn - urn:oio:fuldtnavn:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Adresse - urn:oio:adresse:nnnn;nnnn,aaaa;aa;aaaa;aaaa da disse ikke repræsenteret af et UUID og derfor skal benytte urn.] Den forretningsmæssige hændelse (beskedtype) kan være: 1. Digital Post tilmelding Person er tilmeldt eller afmeldt Digital Post 2. NemSMS tilmelding Person er tilmeldt eller afmeldt NemSMS (SF2250) 3. Status print Status/Kvittering fra Digital Post og Fjernprint Det skal bemærkes at Serviceplatformen skal genere et UUID for hver udtrækskørsler, som identificerer hændelsen til Beskedfordeler og placeres i ObjektRegistreringId. Digital Post tilmelding: Element Beskrivelse værdifelt SP udfyldelse af værdifelt Filtreringsdata Beskedtype Digital Post tilmelding [Afklaring/KDF indsæt UUID for Digital Post tilmelding ] BeskedAnsvarligAktør Digital Post [Afklaring/KDF indsæt UUID for aktøren Digital Post ] KOMBIT A/S Halfdansgade København S CVR Side 57 af 87

58 TilladtModtager Bopælskommune Indsæt urn:oio:cvr:nnnnnnnn fra cache (Myndighed/SysId) RelateretObjekt ObjektId ObjektType Objektregistrering ObjektRegistreringId UUID for hændelsen, der ligger til grund for beskeden Indsæt UUID for udtrækskørsel på SP. RegistreringsAktoer Serviceplatformen [Afklaring/KDF UUID for Serviceplatformen ] Registreringstidspunkt Tidspunkt for hændelsens udsendelse fra kilden. Indsæt tidsstempel i DateTime format. ObjektAnsvarligMyndighed Bopælskommune Indsæt urn:oio:cvr:nnnnnnnn fra cache (Myndighed/SysId) ObjektId ObjektType ObjektHandling Leveranceinformation Dannelsestidspunkt CPR-nummer på borgeren eller CVR-nummer for virksomhed Forretningsobjektet Person eller Virksomhed Tilmeldt Digital Post eller Afmeldt Digital Post Tidspunkt hvor beskeden opstod urn:oio:cpr:nnnnnnnnnn PERSON- NUMMER fra record (uden bindestreg) eller urn:oio:cvr:nnnnnnnnn CVR-nummer fra record (uden bindestreg) UUID for forretningsobjektet Person eller Virksomhed [Afklaring/KDF indsæt UUID for Tilmeldt Digital Post eller Afmeldt Digital Post ] Indsæt tidsstempel for dannelse af beskeden på SP i DateTime format. KOMBIT A/S Halfdansgade København S CVR Side 58 af 87

59 Sikkerhedsklassificering Personfølsomt [Afklaring/KDF indsæt UUID for Personfølsomt ] GyldighedFra Tidspunkt hvor hændelsen opstod Indsæt tidsstempel i DateTime format. NemSMS tilmelding (SF2250): Element Beskrivelse værdifelt SP udfyldelse af værdifelt Filtreringsdata Beskedtype NemSMS tilmelding [Afklaring/KDF indsæt UUID for NemSMS tilmelding ] BeskedAnsvarligAktør NemSMS [Afklaring/KDF indsæt UUID for aktøren NemSMS ] TilladtModtager Bopælskommune Indsæt urn:oio:cvr:nnnnnnnn fra cache (Myndighed/SysId) RelateretObjekt (1) ObjektId ObjektType Objektregistrering ObjektRegistreringId UUID for hændelsen, der ligger til grund for beskeden Indsæt UUID for udtrækskørsel på SP. RegistreringsAktoer Serviceplatformen [Afklaring/KDF UUID for Serviceplatformen ] Registreringstidspunkt Tidspunkt for hændelsens udsendelse fra kilden Indsæt tidsstempel i DateTime format. ObjektAnsvarligMyndighed Bopælskommune Indsæt urn:oio:cvr:nnnnnnnn fra cache (Myndighed/SysId) KOMBIT A/S Halfdansgade København S CVR Side 59 af 87

60 ObjektId DokumentId urn:oio:cpr:nnnnnnnnnn PERSON- NUMMER fra record (uden bindestreg) eller urn:oio:cvr:nnnnnnnnn CVR-nummer fra record (uden bindestreg) ObjektType ObjektHandling Leveranceinformation Dannelsestidspunkt Forretningsobjektet Dokument Tilmeldt NemSMS eller Afmeldt NemSMS Tidspunkt hvor beskeden opstod [Afklaring/KDF indsæt UUID for forretningsobjektet Dokument ] [Afklaring/KDF indsæt UUID for Tilmeldt NemSMS eller Afmeldt NemSMS ] Indsæt tidsstempel for dannelse af beskeden på SP i DateTime format. Sikkerhedsklassificering Personfølsomt [Afklaring/KDF indsæt UUID for Personfølsomt ] GyldighedFra Tidspunkt hvor hændelsen opstod Indsæt tidsstempel i DateTime format. Status print: Element Beskrivelse værdifelt SP udfyldelse af værdifelt Filtreringsdata Beskedtype Status print [Afklaring/KDF indsæt UUID for Status print ] BeskedAnsvarligAktør Digital Post eller Fjernprint [Afklaring/KDF indsæt UUID for aktøren Digital Print eller Fjernprint ] TilladtModtager Bopælskommune Indsæt urn:oio:cvr:nnnnnnnn fra cache (Myndighed/SysId) RelateretObjekt KOMBIT A/S Halfdansgade København S CVR Side 60 af 87

61 ObjektId ObjektType Objektregistrering ObjektRegistreringId UUID for hændelsen, der ligger til grund for beskeden Indsæt UUID for udtrækskørsel på SP. RegistreringsAktoer Serviceplatformen [Afklaring/KDF UUID for Serviceplatformen ] Registreringstidspunkt Tidspunkt for hændelsens udsendelse fra kilden Indsæt tidsstempel i DateTime format. ObjektAnsvarligMyndighed UUID for borgerenes bopælskommune [SP indsæt [Afklaring/KDF indsæt felt] fra cache] ObjektId DokumentId urn:oio:dokumentid:xxxxxxxxxxxxxxxxxxxxxxxxx fra MeddelsesIdentifikator eller AfsendelsesIdentifikator fra record (uden bindestreg) ObjektType UUID for det relaterede forretningsobjektet Dokument [Afklaring/KDF indsæt UUID for forretningsobjektet Dokument ] ObjektHandling Handlingen Afsendt", "Modtaget Fjernprint", "Fejlet", "Klar", "Afleveret til print og kuvertering", "Modtaget Post Danmark", "Modtaget Digital Post", "Tilbagekaldt", "Opdatering fra Post Danmark" eller "Afleveret Digital Post" [Afklaring/KDF indsæt UUID for Afsendt", "Modtaget Fjernprint", "Fejlet", "Klar", "Afleveret til print og kuvertering", "Modtaget Post Danmark", "Modtaget Digital Post", "Tilbagekaldt", "Opdatering fra Post Danmark", "Afleveret Digital Post"] Leveranceinformation KOMBIT A/S Halfdansgade København S CVR Side 61 af 87

62 Dannelsestidspunkt Tidspunkt hvor beskeden opstod Tidsstempel i DateTime format for dannelse af beskeden på SP Sikkerhedsklassificering Internt [Afklaring/KDF indsæt UUID for Internt ] GyldighedFra Tidspunkt hvor hændelsen opstod Indsæt tidsstempel i DateTime format Beskedindhold dataspecifikation Dataspecifikationen for indholdet af selve beskeden findes i følgende schema-filer: Miljø: Produktion og Test Inputdata [Udfyldes af Systematic senere indholdet svarer til nedenstående tabel] Outputdata For status print vil beskeden indeholde: StatusPrintBesked Ni v Feltnavn Kard Værdisæt Betegnelse Feltnavn DP 1 AfsendelseIdentifikator 1..1 String (1..38) MeddelelseIndetifikator 1 ForsendelseIdentifikator 0..1 Integer 1 KanalKode 0..1 String Digital Post eller Fysisk Post Digital Post 1 AfsendelseModtager 0..1 String CPR/CVR AfsendelseModtager 1 AfsendelsesModtager- Type 0..1 String P eller V Fra DP, sættes til P hvis Af- sendelses- Modtager er AfsendelseModtagerType KOMBIT A/S Halfdansgade København S CVR Side 62 af 87

63 10 langt ellers sættes til V. 1 PersonName 0..1 String 1 TransaktionsDatoTid 1..1 DateTime 1 BrugerNavn 0..1 String ( ) 1 EnhedTekst 0..1 String ( ) 1 AfsenderSystem-Identifikator 1..1 String 1 TransaktionsStatusKode 1..1 String Afsendt", "Modtaget Straalfors Connect", "Fejlet", "Klar", "Afleveret til print og kuvertering", "Modtaget Post Danmark", "Modtaget Digital Post", "Tilbagekaldt", "Opdatering fra Post Danmark", "Afleveret Digital Post" FejlKode=0 => Modtaget Digital Post FejlKode<>0 => Fejlet Modtaget Straalfors Connect mappes til Modtaget Fjernprint 1 ForsendelseType-Identifikator 1 ForsendelseHaendelse- Samling 1..1 MeddelelseIndholdstype- Identifikator 0..1 Complex KOMBIT A/S Halfdansgade København S CVR Side 63 af 87

64 2 ForsendelseHaendelse- TypeKode 2 ForsendelseHaendelse- DatoTid 2 ForsendelseHaendelse- Beloeb 2 ForsendelseHaendelse- Tekst 0..1 Integer FejlKode=0 => 23, Fejl- Kode<>0 => DateTime 0..1 Decimal 0..1 Decimal N/A FejlKode + KvitteringTekst Service Management Beskrivelsen af Service Management findes i Aflever besked [SF1460_C] Incident Management [Indhold afventer generel afklaring af governancestrukturer.] Problem Management [Indhold afventer generel afklaring af governancestrukturer.] Change Management [Indhold afventer generel afklaring af governancestrukturer.] Testplan Integrationstest [Indhold afventer generel afklaring af test] Produktionssætningstest [Indhold afventer generel afklaring af test] KOMBIT A/S Halfdansgade København S CVR Side 64 af 87

65 Fagsystem Integrationsbeskrivelse 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 integrationsflow, som vil være beskrevet hver for sig i nærværende afsnit. I hvert integrationsflow vil der indgå en række endpoints. Hvert endpoint vil være specificeret i integrationsbeskrivelserne for integrationsparterne, jf. ovenstående afsnit 3. Jf. figuren nedenfor indgår følgende komponenter og endpoints i integrationen. Serviceplatformen EP_DP1 EP_SP1 EP_SP2 IF01 IF02 EP_DP2 EP_DP3 EP_DP4 EP_DP5 EP_DP6 Digital Post EP_DP7 SF1460_A EP_BF1 SF1460_B EP_BF2 Beskedfordeler SF1460_C SF1460_C EP_BF3 IF03 IF04 EP_FP1 EP_FP2 EP_FP3 Fjernprint Oversigt over integrationsflows ID Navn IF01 IF02 IF03 Forespørg tilmelding DP (og NemSMS) Afsend brev Beskedfordel status print KOMBIT A/S Halfdansgade København S CVR Side 65 af 87

66 IF04 Beskedfordel ændringer tilmeldinger DP Integrationsflow IF01: Forespørg tilmelding DP (og NemSMS) Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_SP1 Spoerg_tilmelding_SP Afsnit EP_DP1 Spoerg_tilmelding_DP Afsnit Integrationstype Dette er en gennemstillingsintegration, som gennemstiller et SOAP webservice kald på Serviceplatformen til OIOREST kald på Digital Post Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. Fagsystem Serviceplatformen Digital Post Synkront kald for hent data SP gennemstiller til Digital Post Digital Post returner data til SP SP returnerer data til FS EP_SP1 EP_DP Datatransformering N/A Datapersistering Ingen Databerigelse N/A Routing N/A KOMBIT A/S Halfdansgade København S CVR Side 66 af 87

67 Orkestrering Ingen Sikkerhed Sikkerheden er baseret på et OCES certifikat i OIOREST protokollen som beskrevet i UC-SEC-06 [Sikkerhed] Logning Ingen særlige krav Testdata og testfaciliter [Indhold afventer generel afklaring af test] Konfiguration [Udfyldes med oplysninger om hvilke parametre der skal være konfigurerbare, hvilken personkreds/brugertype der skal have konfigurationsmulighed - og hvor ofte der vil være behov for at ændre konfigurationen.] Supplerende information Integrationsflow IF02: Afsend brev Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_SP2 Afsend_brev_SP Afsnit EP_DP2 Afsend_brev_DP Afsnit EP_DP3 Masseafsend_brev_DP Afsnit EP_FP1 Afsend_brev_FP Afsnit Integrationstype Dette er en transformations- og omdirigeringsintegration, som modtager et SOAP webservice kald på Serviceplatformen i Fjernprint format og transformere det til Digital Post format til OIOREST kald på Digital Post eller endpoint ruter til kommunens Fjernprint-leverandør fra information i ITsystemer i Organisation. Valg af Fjernprint-leverandør sker ved datafangst under serviceaftaleindgåelsen efter de modeller, der aftales i forbindelse med integrationer, hvor Serviceplatformen skal fungere som proxy-services. I dette regi skal man også kunne indsamle de data, der er nødvendige for at kunne understøtte Fjernprint-leverandør skift og mulighed for at hente status, fra den gamle leverandør i op til 1 måned efter leverandørskiftet. KOMBIT A/S Halfdansgade København S CVR Side 67 af 87

68 Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. Fagsystem Serviceplatformen Digital Post Fjernprint Synkront kald for Afsende brev Serviceplatformen laver kanalvalg ved A automatisk gennem opslag i replika og sætte kanalvalg EP_SP2 Valg af kilde Kanalvalg="D", Prioritet="D" Enkelt afsendelse til DP Mapning til DP XML EP_DP2 Masseafsendelse til DP Mapning til DP XML Kanalvalg="D", Prioritet="M" EP_DP3 Kanalvalg="F" eller "P" Afsendelse til FP Endpoint routning til kommunen fjernprintleverandør EP_FP1 Hvis afsendersystem har sat Kanalvalg til A, skal Serviceplatformen finde kanalen ved at spørge i Serviceplatformens replika af tilmeldinger for at sætte det korrekte kanalvalg Datatransformering XML til Digital Post er et subset af XML til Fjernprint. Derfor udstilles services på Serviceplatformen med Fjernprint XML, som ved kald til Digital Post skal transformeres til Digital Post XML. Nedenstående tabeller viser mapning mellem FP og DP format. 7.2 Enkeltforsendelse Tabel 1 ForsendelseI RESSOURCE Formål Kommentar Ressourcen beskriver i detaljer den forsendelse, som skal sendes. En forsendelse kan sendes med fysisk eller Digital Post: Digital Post: o Modtager skal angives med CPR eller CVR KOMBIT A/S Halfdansgade København S CVR Side 68 af 87

69 o Alle filformater kan sendes o Transaktions-, Dokument, KanalUafhængige- og Digitale parametre skal udfyldes o Post og printparametre skal ikke udfyldes Fysisk post: o Modtager skal angives i form af struktureret eller ustruktureret adresse o Filer med format TNO eller PDF kan sendes o Transaktions-, Dokument, KanalUafhængige-, Post og printparametres skal udfyldes o Digitale parametre skal ikke udfyldes. Hvis kanalen, enten fysisk eller Digital Post, er prioriteret på forsendelsestypen, skal alle krævede felter udfyldes, og alle parametergrupperne skal angives. XSD ForsendelsesI.xsd Krævet Feltnavn Beskrivelse DP Mapning X AfsendelsesIdentifikator UUID eller løbenummer oprettet af afsendersystem. Skal være unik indenfor et afsendersystem. MeddelelesIdentifikator ForsendelsesTypeIdentifikator Reference til forsendelsestype, der angiver indhold og muligheder for de forskellige parametre. Forsendelsesty-pen skal have en gyldig version. X ForsendelseModtager Forsendelsens modtager angivet som CPR/CVR eller fysisk post adresse (struktu-reret eller ustruktureret). Se Tabel 2, ForsendelseModtager, for yderligere oplysninger. X FilFormatNavn Formatet på Meddelelse- IndholdData. Hvis kanalen på forsendelsen er fysisk post, skal formatet være PDF eller TNO. Alle formater kan sendes med Digital Post. X MeddelelseIndholdData Base64 encoded binær fil som ønskes fremsendt til Se Tabel 2 Afsendelse.xsd FilFormatNavn Afsendelse.xsd KOMBIT A/S Halfdansgade København S CVR Side 69 af 87

70 modtager. (pdf ved print eller tekst ved sms) MeddelelsesIndholdData TransaktionsParametreI Samling af parametre, der beskriver transaktionen som f.eks. Transaktions- DatoTid. Samlingen indeholder de parametre, der skal anvendes, når forsendelsen opret-tes. De enkelte parametre er beskrevet i Tabel 5 TransaktionsParametreI. X DokumentParametre Parametre der beskriver det dokumentet, som skal sendes, og den sag, som forsendelsen tilhører. Herunder titel og brevdato. De enkelte parametre er beskrevet i Tabel 6 DokumentParametre. KanalUafhængigeParametreI PrintParametre DigitalPostParametre Alle de parametre, som gør sig gældende både for digital og fysisk post. De enkelte parametre er beskrevet i Tabel 7 KanalUafhængigeParametreI. Samling af parametre, der fortæller hvordan en forsendelse til fysisk post skal printes. De enkelte parametre er beskrevet i Tabel 8 PrintParametre. Samling af parametre, der beskriver forsendelsen til Digital Post. De enkelte parametre er beskrevet i Tabel 9 DigitalePostParametre. Se Tabel 9 KOMBIT A/S Halfdansgade København S CVR Side 70 af 87

71 PostParametre BilagSamling Samling af parametre, der samlet beskriver hvordan forsendelsen skal sendes med fysisk post. De enkelte parametre er beskrevet i Tabel 11 PostParametre. Samling af bilag, der skal vedhæftes dokumentet. De enkelte parametre er beskrevet i Tabel 12 Bilag- Samling. Se Tabel 12 Tabel 2 ForsendelseModtager TYPE Formål Adresse på modtager i forhold til at kunne sende med fysisk og Digital Post. Kommentar Krævet Feltnavn Beskrivelse DP Mapning AfsendelseModtager ModtagerAdresse Modtagers CPR eller CVR nummer til brug ved digitalforsendelse. Se Tabel 3 SlutbrugerIdentitet. Modtagers fysiske postadresse. Se Tabel 4 KontaktOplysning. Afsendelse.xsd AfsendelseModtager Tabel 3 SlutbrugerIdentitet TYPE Formål Kommentar Oplysninger på modtager, der bruges til forsendelse med Digital Post Der angives CVR/CPR alt efter om der er tale om en privatperson eller en virksomhed/organisation. Krævet Feltnavn Beskrivelse DP Mapning X CPRnummerIdentifikator CPR nummer angives, hvis forsendelsen skal sendes til en privatperson. CPRnummerIdentifikator KOMBIT A/S Halfdansgade København S CVR Side 71 af 87

72 X CVRnummerIdentifikator CVR nummer angives, hvis forsendelsen skal sendes til en virksomhed/organisation. CVRnummerIdentifikator Tabel 4 KontaktOplysning TYPE Formål Kommentar Adresse på modtager eller afsender i struktureret eller ustruktureret form. Skal udfyldes for modtager, hvis forsendelsen skal sendes med fysisk post. Skal forsendelsen sendes med fysisk post kan adressen på modtager angives på to måder: Struktureret (Felt og indhold skal passe sammen) Ustruktureret (6 adresselinjer med valgfrit indhold) For alle adresser skal følgende felter udfyldes: PersonName navn på modtager CountryIdentificationCode landekode som f.eks. DK Krævede felter på struktureret (Vejnavn, nummer og bogstav og postnummer) eller ustruktureret adresse (første adresselinje) Hvis PaatrykAfModtagerAdresse er ja skal modtageradresse være angivet. Hvis PaatrykAfAfsenderAdresse er Ja skal afsenderadresse være angivet. Krævet Feltnavn Beskrivelse DP Mapning X PersonName Struktureret adresse. Navn på modtager af forsendelsen f.eks. Peter Jensen. CoNavn Struktureret adresse. Co navn X StreetName Struktureret adresse. Vejnavn X StreetBuildingIdentifier Struktureret adresse. Husnummer og bogstav. FloorIdentifier SuiteIdentifier Struktureret adresse. Sal eller etage. Struktureret adresse. Beskriver lokationen af f.eks. en lejlighed på en etage. Kan for eksempel være Lejlighed 19. KOMBIT A/S Halfdansgade København S CVR Side 72 af 87

73 MailDeliverySublocationIdentifier Struktureret adresse. Stednavn. X PostCodeIdentifier Struktureret adresse. Postnummer f.eks DistrictSubdivisionIdentifier PostOfficeBoxIdentifier Struktureret adresse. By f.eks. Århus C Struktureret adresse. Postbox. X PostalAddressFirstLineText Første linje i en ustruktureret adresse. Vælges en ustruktureret adresse er første linje et krævet felt. PostalAddressSecondLineText PostalAddressThirdLineText PostalAddressFourthLineText PostalAddressFifthLineText PostalAddressSixthLineText PostCodeIdentifier Anden linje i en ustruktureret adresse. Tredje linje i en ustruktureret adresse. Fjerde linje i en ustruktureret adresse. Femte linje i en ustruktureret adresse. Sjette linje i en ustruktureret adresse. Parameteren skal kun anvendes af Printerapplikationen. Postnummer til ustruktureret adresse. Anvendes primært af printerapplikationen. Skal angives for danske adresser dvs. hvis CountryIdentificationCode er DK. Skal være et validt dansk postnummer. X CountryIdentificationCode Landekode til ustruktureret adresse som f.eks. DK eller DE. Anvendes til at angive, hvilket land forsendelsen skal sendes til. Landekoden skal KOMBIT A/S Halfdansgade København S CVR Side 73 af 87

74 følge ISO-3166 og der kan anvendes apha-2 eller alpha- 3. Angives både for struktureret og ustruktureret adresse. Tabel 5 TransaktionsParametreI TYPE Formål Kommentar Samling af parametre, der beskriver transaktionen af forsendelsen. Skal udfyldes for alle forsendelser. Krævet Feltnavn Beskrivelse DP Mapning TransaktionsDatoTid MasseForsendelseIdentifikator KvitteringsTypeKode Kvitterings Tidspunkt hvor forsendelsen er produceret i afsendersystemet. Hvis meddelelsen er en del af en masseforsendelse angives masseforsendelsens GUID i dette felt. Angiver for hvilke status-værdier der ønskes kvittering. Kan have værdierne Ingen, Alle eller Kun fejl. Ved kvittering specificeres den -adresse hvortil kvitteringer ønskes sendt til. Skal angives hvis KvitteringsTypeKode er Alle eller Kun fejl. Den kviteringsmail der afsendes til modtager, vil være tilpasset både mennesker og maskiner. Selve mail bodyen vil oplyse om status skift på forsendelsen i almindelig tekst, med anvendelse af relevante felter. Til denne mail tilføjes en XML repræsentation af forsendelsen som den også vil fremstå i forsendelse-slog. Dette XML dokument vedhæftes som attachment. KOMBIT A/S Halfdansgade København S CVR Side 74 af 87

75 Tabel 6 DokumentParametre TYPE Formål Kommentar Samling af parametre, der beskriver det dokumentet, som skal sendes, og den sag, som forsendelsen tilhører. Skal udfyldes for alle forsendelser. Krævet Feltnavn Beskrivelse DP Mapning TitelTekst Titel på dokumentet. Ved forsendelser til eboks, må der maksimalt angives 50 tegn. Afsendelse.xsd MeddelelseTitelTekst UUIDIdentifikator ID på dokumentet MeddelelsesIdentifikator BrevDato MeddelelsesFormatObjekt Den dato, som er brevdato inde i dokumentet MeddelelsesFormatet giver mulighed for at overføre metadata fra myndigheder til virksomheder. Objektet kan indeholde et hvilket som helst XML format, der skal sendes igennem Strålfors Connect. Ifølge Digitaliseringsstyrelsen skal SagsDokumentFormat eller AttentionFormat anvendes på nuværende tidspunkt. Objektet sendes igennem Strålfors Connect uden at blive valideret eller påvirket på nogen måde. Afsendelse.xsd FilformatNavn Tabel 7 KanalUafhængigeParametreI TYPE Formål Kommentar Samling af parametre, der gør sig gældende både for fysisk eller Digital Post. Skal udfyldes for alle forsendelser. Krævet Feltnavn Beskrivelse DP Mapning EnhedTekst Afsenders organisatoriske enhed KOMBIT A/S Halfdansgade København S CVR Side 75 af 87

76 X BrugerNavn Identifikation af den bruger, der har produceret forsendelsen. Bruger skal være sat, hvis PaatrykBrevDatoIndikator er Ja. KonteringsGruppeTekst ForsendelseAfsender PaatrykAfsenderAdresseIndikator PaatrykModtagerAdresseIndikator PaatrykBrevdatoIndikator KanalKode HasteBrevIndikator Angiver konteringsgruppe til opdeling af faktura Afsenders kontaktoplysninger bruges til påtryk af afsenderadresse og vises i forsendelsesloggen. Se KontaktOplysning, Tabel 4, for beskrivelse af adressen. Angiver om afsenderadresse skal påtrykkes dokument Angiver om modtageradressen skal påtrykkes dokument Angiver om brevets dato og bruger skal påtrykkes dokument Opsætning af en tvungen kanal til forsendelse af meddelelse. Kan være Digital Post eller fysisk post. Indikator som angiver at print og kuvertering af forsendelsen skal opprioriteres. Tabel 8 PrintParametre TYPE Formål Kommentar Samling af parametre, der beskriver hvordan dokumentet skal printes. Skal kun angives for fysisk post. Krævet Feltnavn Beskrivelse DP Mapning KOMBIT A/S Halfdansgade København S CVR Side 76 af 87

77 SimplexDuplexKode FarveSHKode KuvertTypeKode Angiver hvordan dokumentet skal printes. Kan være simplex eller duplex Angiver hvordan dokumentet skal printes. Kan være sort/hvid (SH) eller farve Angiver kuverttype printet skal forsendes i. Kan være C5, C4 eller MA. Parameterværdien MA kan ikke anvendes i denne version. Tabel 9 DigitalePostParametre TYPE Formål Kommentar Samling af parametre, der samlet beskriver de parametre, der skal anvendes til forsendelse af Digital Post. Skal kun angives for Digital Post. Se beskrivelse af OIOREST grænsefladeflade til Digital Post, hvis der ønskes mere information om følgende parametre: MeddelelseIndholdstypeIdentifikator, MeddelelseSvarTypeNavn MeddelelseSvarPostkasseIdentifikator MeddelelseSvarEmneIdentifikator MeddelelseFESDmetadata MedsendDokumentRegistrering- Indikator Krævet Feltnavn Beskrivelse DP Mapning AfsendelseDatoTid MeddelelseIndholdstype- Identifikator Angiver tidspunktet hvor forsendelsen bliver tilgængelig for modtageren. Datoen kan maksimalt være 5 dage ud i fremtiden. Tidsangivelsen bliver ikke benyttet i den Digitale Postløsning, der ses kun på datoen. Angiver indholdstypen som forsendelsen vedrører. Modtager af forsendelsen kan til- og afmelde sig tilmeldingsgrupper hos Digital Post, som indeholder en eller flere indholdstyper. Hvis slutbrugeren er tilmeldt en Afsendelse.xsd AfsendelseDatoTid Afsendelse.xsd MeddelelseIndholdstype- Identifikator KOMBIT A/S Halfdansgade København S CVR Side 77 af 87

78 tilmeldingsgruppe som indeholder denne indholdstype vil slutbrugeren modtage afsendelsen. MeddelelseSvarType- Navn MeddelelseSvarPostkasse-Identifikator MeddelelseSvarPostkasseIdentifikator MeddelelseSvarEmne- Identifikator MeddelelseFESDmetadata Angiver hvorvidt besvarelse er muligt samt hvordan svarpostkassen bestemmes. Kan være standard, angivet eller ikkemuligt. Standard: svar er muligt såfremt en svarpostkasse er angivet på indholds-typen i den Digitale Postløsning. Angivet: Svarpostkassen fremgår af feltet MeddelelseSvarPost- KasseIdenti-fikator og MeddelelseSvarEmne-Identifikator. ikkemuligt: slutbrugeren kan ikke besvare afsendelsen. Såfremt feltet ikke er udfyldt anvendes standard. Postkasse for tilbagesvar. Skal kun angives når feltet MeddelelseSvarTypeNavn har værdien Angivet. Angiver det emne, som modtageren skal anvende ved evt. besvarelse. Emnet skal kun angives hvis MeddelelseSvar- PostkasseIdentifikator er angivet. Emnet skal være tilknyttet den angivne postkasse. Afsendelse.xsd MeddelelseSvarType- Navn Afsendelse.xsd Afsendelse.xsd MeddelelseSvarEmne- Identifikator Afsendelse.xsd X Metadata fra ESDH-system. Se Tabel 10 MeddelelseFESDmetadata. MeddelelseFESDmetadata MedsendDokument-RegistreringIndikator Indikerer om oplysninger fra ESDH skal medsendes KOMBIT A/S Halfdansgade København S CVR Side 78 af 87

79 Tabel 10 MeddelelseFESDmetadata TYPE Formål Typen indeholder FESD-metadata. Felterne i denne type er en del af FESD standarden. De er alle af typen Universally Unique Identifier (UUID). Se beskrivelse af OIOREST grænsefladeflade til Digital Post, hvis der ønskes mere information. Krævet Feltnavn Beskrivelse DP Mapning FESDaktoerIdentifikator FESDsagIdentifikator MeddelelseFESDmetadata.xsd FESDsagsklassifikation- Identifikator Identificerer et dokument via en UUID Identificerer aktøren via en UUID. Identificerer sagen via en UUID. Klassifikation af sagen via en UUID. FESDaktoerIdentifikator Kommentar FESDdokumentIdentifikator MeddelelseFESDmetadata.xsd FESDdokumentIdentifikator MeddelelseFESDmetadata.xsd FESDsagIdentifikator MeddelelseFESDmetadata.xsd FESDsagsklassifikation- Identifikator Tabel 11 PostParametre TYPE Formål Samling af parametre, der samlet beskriver hvordan forsendelsen skal sendes med fysisk post. Skal kun angives for fysisk post. Kommentar Krævet Feltnavn Beskrivelse DP Mapning PostKategoriKode Postomdelingskategori, der angiver pris og hvor hurtigt KOMBIT A/S Halfdansgade København S CVR Side 79 af 87

80 forsendelsen skal være fremme ved modtager. Kan være Prioritaire, Economique, Bulk, Rekommanderet, Rekommanderet med modtagerbevis og Forkyndelse. Parameterværdierne Bulk, Rekommanderet, Rekommanderet med modtager-bevis og Forkyndelse kan ikke anvendes i denne version. I version 1.1 og version 1.5 er det kun Prioritaire og Economique, der kan anvendes. AllokeringsIdentifikator ReturposthaandteringHos- LeverandoerIndikator InformationVedAdresse- AendringIndikator SideKvantitet Anvendes ved større forsendelser til at henvise til produktionsplan ved print og kuvertering. Kombinationen af AllokeringsID og forsendelsestype (ForsendelsestypeID)skal passe med produktionsplanen oprettet i administrations-portalen. Angiver om håndtering af returneret fysisk post skal ske hos leverandøren. I så fald destrueres forsendelsen ved uanbringelighed. Angiver om forsendelsen skal leveres til modtager ved adresseændring med returnering af information om ny adresse til afsender Ved oprettelse af forsendelse skal SideKvantitet kun angives af printerapplikationen. I forsendelses-loggen returneres det samlede antal sider for forsendelsen (Hoveddokument og bilag). KOMBIT A/S Halfdansgade København S CVR Side 80 af 87

81 Tabel 12 BilagSamling TYPE Formål Typen indeholder en liste af Bilag eller referencer til bilag, der er tilknyttet forsendelsen. Indeholder en liste af typen Bilag. Se Tabel 13 Bilag. Mappes til DP VedhaeftningSamling Tabel 13 Bilag TYPE Formål Kommentar Bilag der skal sendes sammen med forsendelsens hoveddokument. Bilag håndteres forskellig alt efter om de sendes med fysisk eller Digital Post. Fysisk post: Bilag printes i forlængelse af hoveddokumentet, og hele forsendelsen sendes i samme kuvert (både hoveddokument og bilag) Digital Post: Modtager vil modtage én forsendelse i den digitale postløsning, hvor bilagene er tilknyttede Det enkelte bilag kan være en af de følgende tre typer: Krævet Binær information givet i feltet VedhaeftningIndholdData URL referencer (VedhaeftningIndholdURLreference), disse vil hvis VedhaeftSomIndholdDataIndikator er sat blive hentet centralt i Strålfors Connect og sendt med som bilag til den digitale postløsning, hvis denne ikke er sat, vil URL referencen blive sendt videre til den digitale postløsning. Referencer til bilag der allerede ligger i den digitale postløsning. Det-te angives med feltet BilagIdentifikator. Feltnavn Beskrivelse DP Mapning X BilagNavn Navn på bilag Vedhaeftning.xsd VedhaeftningNavn X FilformatNavn Format på VedHaeftningIndholdData eller Vedhaeftning- IndholdURLreference. Hvis forsendelsen skal sendes med fysisk post skal formatet være TNO eller PDF. Ved BilagID ses der bort fra formatet i behandlingen af forsendelsen. Vedhaeftning.xsd FilformatNavn KOMBIT A/S Halfdansgade København S CVR Side 81 af 87

82 X BilagSorteringsIndeks-Identifikator Rækkefølge på bilag Vedhaeftning.xsd X BilagIdentifikator ID på bilagsdokumentet Vedhaeftning.xsd BilagIdentifikator X VedhaeftningIndholdData Den fil som ønskes fremsendt til modtager Vedhaeftning.xsd VedhaeftningIndhold- Data X URL reference til bilag, der skal vedhæftes Vedhaeftning.xsd VedhaeftningIndhold-URLreference VedhaeftningIndhold- URLreference X VedhaeftSomIndholdData-Indikator Indikator for om bilag skal vedhæftes digitale forsendelser som komplet vedhæftning (fremfor som reference) Vedhaeftning.xsd Datapersistering N/A Databerigelse N/A Routing Ved Digital Post (Kanalvalg= D ) benyttes Prioritet til ruting til: Prioritet= D EP_DP2 Afsend_brev_DP Prioritet= M EP_DP3 Masseafsend_brev_DP Ved Fjernprint (Kanalvalg= F og P vil Serviceplatformen rute til den Fjernprint-leverandør, som kommunen har valgt gennem informationer fra IT-systemer i Organisation Orkestrering Ingen orkestrering. KOMBIT A/S Halfdansgade København S CVR Side 82 af 87

83 Sikkerhed Sikkerheden hos kilde er certifikatbaseret, mens fagsystemerne anvender rammearkitekturens sikkerhedsmodel. Derfor skal Serviceplatformen foretage veksling mellem sikkerhedsmodeller som beskrevet i UC-SEC-06 i [SIKKERHED] Logning Ingen særlige krav til logning Testdata og testfaciliter [Indhold afventer generel afklaring af test] Konfiguration [Udfyldes med oplysninger om hvilke parametre der skal være konfigurerbare, hvilken personkreds/brugertype der skal have konfigurationsmulighed - og hvor ofte der vil være behov for at ændre konfigurationen.] Supplerende information Integrationsflow IF03: Beskedfordel status print Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_DP4 Modtag_kvittering_DP Afsnit EP_DP5 Kvitter_kvittering_DP Afsnit EP_FP2 Hent_status_FP Afsnit EP_FP3 Hent_statusdetalje_FP Afsnit EP_BF3 AfsendBesked Afsnit Integrationstype Dette er en orkestreringsintegration, som henter transaktionslog (kvitteringer) fra Digital Post og status fra Fjernprint samt sender dem til Fagsystemerne via BeskedFordeler Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KOMBIT A/S Halfdansgade København S CVR Side 83 af 87

84 Serviceplatformen Digital Post Fjernprint Beskedfordeler Serviceplatformen henter periodisk kvitteringer per myndighed i Digital Post og afsender dem til fagsystemerne via Beskedfordeler. Gentag indtil alt afsendt Hent kvitteringer EP_DP4 EP_BF3 Serviceplatformen kvitterer for kvitteringerne i Digital Post. Kvitter kvitteringer EP_DP5 Serviceplatformen henter periodisk statusændringer per myndighed i Fjernprint, og for hver status hentes statusdetaljer, og afsender status til fagsystemerne via Beskedfordeler. Gentag indtil alt afsendt Hent status EP_FP2 EP_FP3 EP_BF Datatransformering Se afsnit EP_BF3 for indhold af besked Datapersistering N/A Databerigelse N/A Routing Ingen Orkestrering Ingen Sikkerhed Sikkerheden hos kilde er certifikatbaseret, mens fagsystemerne anvender rammearkitekturens sikkerhedsmodel. Derfor skal Serviceplatformen foretage veksling mellem sikkerhedsmodeller som beskrevet i UC-SEC-06 i [SIKKERHED] baseret på Serviceaftale/Sikkerhed Logning [Særlige krav til logning ud over standard logning på SP]. KOMBIT A/S Halfdansgade København S CVR Side 84 af 87

85 Testdata og testfaciliter [Indhold afventer generel afklaring af test] Konfiguration [Udfyldes med oplysninger om hvilke parametre der skal være konfigurerbare, hvilken personkreds/brugertype der skal have konfigurationsmulighed - og hvor ofte der vil være behov for at ændre konfigurationen.] Supplerende information Integrationsflow IF04: Beskedfordel ændringer tilmeldinger DP Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_DP6 Hent_tilmeldingsliste_DP Afsnit EP_DP7 Hent_tilmeldinger_delliste_DP Afsnit EP_BF3 AfsendBesked Afsnit Integrationstype Dette er en orkestreringsintegration, som dagligt per myndighed henter tilmeldingslister fra Digital Post og sammenholder dem med gårsdagens lister og placerer ændringer på beskeder til Bekedfordeler Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KOMBIT A/S Halfdansgade København S CVR Side 85 af 87

86 Serviceplatformen Digital Post Beskedfordeler Serviceplatformen henter dagligt en liste over tilmeldinger (delliste) per myndighed i Digital Post. Serviceplatformen henter efterfølgende tilmeldinger for hver delliste i Digital Post. Gentag indtil alt er modtaget Hent tilmeldinger EP_DP1 Hent tilmeldinger delliste EP_DP2 Sammenlign dagens tilmeldinger med gårsdagen og beregn tilmeldingsændringer til BF. Gentag til lister slut EP_BF Datatransformering Ingen Datapersistering Tilmeldingslisterne fra Digital Post gemmes til sammenligning med næste dags lister i et tilmeldingsreplika. Serviceplatformen beregner disse ændringer. Persisteringen etableres som et replika, som også benyttes til automatisk kanalvalg ved at afsendelse af breve Databerigelse N/A Routing Ingen Orkestrering Ingen Sikkerhed Sikkerheden hos kilde er certifikatbaseret, mens fagsystemerne anvender rammearkitekturens sikkerhedsmodel. Derfor skal Serviceplatformen foretage veksling mellem sikkerhedsmodeller som beskrevet i UC-SEC-06 i [SIKKERHED] baseret på Serviceaftale/Sikkerhed Logning [Særlige krav til logning ud over standard logning på SP]. KOMBIT A/S Halfdansgade København S CVR Side 86 af 87

87 Testdata og testfaciliter [Indhold afventer generel afklaring af test] Konfiguration [Udfyldes med oplysninger om hvilke parametre der skal være konfigurerbare, hvilken personkreds/brugertype der skal have konfigurationsmulighed - og hvor ofte der vil være behov for at ændre konfigurationen.] Supplerende information KOMBIT A/S Halfdansgade København S CVR Side 87 af 87