SF1691 NemHandel (Modtag efaktura) Integrationsbeskrivelse - version 1.0.0

Transkript

1 Integrationsbeskrivelse - version Kommunernes Datafællesskab - KDF

2 Versionshistorik Relevans Dato Initialer Version Kommentarer sej Overført fra tidligere skabelon sej Fjernet SP fra besk edm Opdateret med Jira AE-44 beslutning edm Opdateret med review kommentarer ehe Teknsik specifikation indarbejdet Referencer Ref Titel Kommentarer [NemHandel] NemHandels hjemmeside [NemHandel- Intro] Introduktion til NemHandel [NemHandel] NemHandel dokumentation Digst. [NemHandel- OIOUBL] OIOUBL Profiler KOMBIT A/S Halfdansgade København S CVR Side 2 af 15

3 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Tilslutning af services Kontekst for integrationsparter Kontekst for KY Specifikation for integrationsparter Specifikation af endpoints for KY Beskrivelse for integrationsplatformen KOMBIT A/S Halfdansgade København S CVR Side 3 af 15

4 1 Overordnet beskrivelse 1.1 Integrationens formål KY integrerer med NemHandel og skal således stille en snitflade til rådighed så der kan modtages OIOUBL-dokumenter, nærmere betegnet faktura, kreditnota og rykkere. KY har ikke behov for at kunne afsende faktura, men skal kunne kvittere for modtagelsen af dokumenter. Da løsningen benytter NemHandel-infrastruktur (OIORASP transport-protokol + OIOUBL-dokumenter) forudsættes denne bekendt. En introduktion kan findes på [NemHandel-Intro]. Generelt NemHandel flow er diagrammeret i Fejl! Henvisningskilde ikke fundet. nedenfor. NemHandel Serviceregister VirkA Afsender OIO RASP VirkB Modtager OIOUBL Figur 1 Overordnet forretningsflow 1. Virksomhed A (VirkA) skal sende et forretningsdokument til Virksomhed B (VirkB), (VirkB kan være en offentlig myndighed). Forretningsdokumentet er repræsenteret vha. OIOUBL standarden. 2. VirkA slår op i NemHandelsRegistret for at finde information om, hvor dokumentet skal sendes hen. Dokumentet sendes til VirkB via en transportprotokol, der overholder OIORASP standarden. 1.2 Overordnet forretningsflow i integrationen I forbindelse med afsendelse af efaktura er forretningsflowet følgende: KOMBIT A/S Halfdansgade København S CVR Side 4 af 15

5 Afsnedersystem NemHandel register Modtagersystem Integrationsbeskrivelse SF1691 Modtag Faktura via NemHandel Send dokument Faktura Rykker Kreditnota Kvittering Modtag Dokument OIOUBL-dok HTTP/OIORASP Returnér endpoint Opret faktura Dan Faktura Slå modtager op i NemHandelregister Afsend Dokument Figur 2 Modtage Faktura flow Send dokument (faktura/kreditnota/rykker) Ekstern part opretter en faktura der skal sendes til Anvendersystemet KY. Format er OIOUBL [NemHandel-OIOUBL]. Parten slår modtager op i NemHandel-registeret mhp. adressering. Der returneres det endpoint dokumentet skal sendes til Med adressedata fra NemHandel kan der nu sendes efaktura KY modtager dokument Flow afsluttes Send kvittering (ApplicationResponse) Modtager kan vælge at sende en forretningskvittering (ApplicationResponse), eksempelvis hvis der er noget galt med semantisk indhold. Bemærk, at det er valgfrit for modtager at modtage ApplicationResponse, derfor kan leverance ikke garanteres. I figuren nedenfor er forsendelse af kvittering vist som følger samme flow, som når der sendes og modtages faktura. Afsender er nu KY. KY slår modtager op i NemHandel-registeret på baggrund af afsender-information i fakturaen (EndPointID). Hvis modtager ikke findes logges dette i KY. NemHandel-register returnerer det endpoint der skal sendes til KY sender ApplicationResponse til endpont KOMBIT A/S Halfdansgade København S CVR Side 5 af 15

6 Afsendersystem NemHandel register Modtagersystem Integrationsbeskrivelse Kvittering modtages af oprindelig afsender. Herefter slutter flow. SF1691 Afsend kvittering via NemHandel Send dokument Faktura Rykker Kreditnota Kvittering Modtag Dokument OIOUBL-dok HTTP/OIORASP Returnér endpoint Opret kvittering Dan Kvittering Slå modtager op i NemHandelregister Afsend Dokument Figur 3 Afsend kvittering flow 1.3 Servicebetingelser for den samlede integration Servicemål Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer NemHandel Sende og Modtage flow Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Nem- Handel. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Nem- Handel. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Nem- Handel. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Nem- Handel. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Nem- Handel. KOMBIT A/S Halfdansgade København S CVR Side 6 af 15

7 1.3.2 Service Management Incident Management Problem Management Change Management Lifecycle Management 1.4 Teststrategi Test i forbindelse med udvikling Testfaciliteter og testmiljø Testdata Test i forbindelse med produktionssætning 1.5 Tilslutning af services Nedenstående er oplysninger om forudsætninger og betingelser, der skal være på plads for at sikre succesfuld tilslutning til integrationsparter Funktionalitet på Serviceplatformen Ingen identificeret da Serviceplatformen ikke benyttes Generelle forhold for tilslutning til integrationspart: NemHandel KY skal registrere sig på NemHandel på deres hjemmeside [NemHandel]. En forudsætning er at anvendersystemet (KY) er registreret i NemHandel-registeret, så systemer der vil sende efaktura kan slå modtager (KY) op mhp afsendelse af efaktura. Dette gøres én gang i en manuel arbejdsgang, hvorfor der ikke er tegnet forretningsmæssigt workflow til dette. Det er en forudsætning at man er oprettet i NemHandel-registeret for at kunne modtage ApplicationResponses. KOMBIT A/S Halfdansgade København S CVR Side 7 af 15

8 De dokumenter, der er krav om at udveksle, svarer til OIOUBL-profilen Procurement-BilSim-1.0, beskrevet i [NemHandel-OIOUBL]. 2 Kontekst for integrationsparter 2.1 Kontekst for KY Lovhjemmel og forvaltningsmæssigt formål Lovhjemmel findes i Aktivlov/Fleksydelseslov af juli , samt Lov om Social Pension 90. Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelig og dækkende analyse. Henvisningen til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering. Det forvaltningsmæssige formål er at indsendelsen af regningskrav fra leverandører (f. eks. tandlæger, optikere, boligudlejere og lign.) sker ved brug af efakturaer, så betalingen af sociale ydelser sker lettere og hurtigere Kapacitets- og servicekrav Forventet volumen er estimeret til /måned jf. bilag Det må forventes at der opstår spidsbelastningsperioder omkring datoer, hvor mange betalinger traditionelt skal falde, f.eks. boligforeninger der sender huslejeregninger Specifikke forhold for tilslutning af system Ingen identificeret. KOMBIT A/S Halfdansgade København S CVR Side 8 af 15

9 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for KY Integrationen benyttes til at sende efaktura til KY Overordnet forretningslogik Den part, der afsender faktura, slår først endpoint op vha. EAN-nr i NemHandel-registeret (ikke beskrevet i dette dokument). Endpoint skal være registeret i NemHandel-registeret. Dernæst sendes faktura til det modtagne endpoint, som er beskrevet herunder. Hvis der skal sendes kvittering (ApplicationResponse) skal oprindelig afsender slås op i NemHandel-registeret Oversigt over endpoints ID Navn EP_FS1 EP_FS2 NemHandel register-opslag ReceiveDocumentService Beskrivelse af endpoint EP_FS1 NemHandel register-opslag Transportspecifikation Serviceudstiller NemHandel register er serviceudstiller Serviceanvender Serviceanvender er de systemer, der sender OIOUBL-dokumenter med NemHandel-standarden Teknologisk understøttelse Snitfladen implementeres som en OIORASP webservice. I praksis anvendes WSDL, se tekniske endpoints Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn inquiry Endpoint IP KOMBIT A/S Halfdansgade København S CVR Side 9 af 15

10 Miljø: Test URI til WSDL Endpoint navn inquiry Endpoint IP Teknisk retning for udveksling Afsender-system inititerer kommunikation med NemHandel-register Dataretning for udveksling Afsendersystem henter NemHandel-endpoint fra NemHandel-register Service invokation / Triggers Når et systemer ønsker at sende en NemHandel-besked til en modtager Dataspecifikation Miljø: Produktion Inputdata for XSD, se Outputdata Miljø: Test Inputdata Som do. PersonHent_IType.xsd Outputdata Sikkerhed Dokumenter sendes og modtages via OIORASP-protokollen. Se de sikkerhedsmæssige krav der knytter sig hertil [NemHandel] Leverancesikkerhed og fejlhåndtering [Udfyldes med oplysninger om den tekniske leverancesikkerhed via snitfladen, herunder fx med henvisning til definitioner i QoS for basic delivery assurances: At most once, At least once, Exactly once og No guarantee. [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med tekniske fejl.] KOMBIT A/S Halfdansgade København S CVR Side 10 af 15

11 [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med forretningsmæssige fejl.] [Ovenstående skal også omfatte information om aftalte timeoutintervaller og regler for genfremsendelse.] Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Værdi Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Beskrivelse af endpoint EP_FS2 - ReceiveDocumentService Transportspecifikation Serviceudstiller KY er serviceudstiller, idet der skal implementeres funktionalitet til at modtage OIOUBL-dokumenter Serviceanvender Serviceanvender er det system, der sender OIOUBL-dokumenter til KY, med NemHandel-standarden Teknologisk understøttelse Snitfladen implementeres som en OIORASP webservice. I praksis anvendes WSDL, se tekniske endpoints Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn {PROD_URL}/services/nemhandel?wsdl ReceiveDocumentService Endpoint IP KOMBIT A/S Halfdansgade København S CVR Side 11 af 15

12 Miljø: Test URI til WSDL Endpoint navn {TEST_URL}/services/nemhandel/?wsdl ReceiveDocumentService Endpoint IP Teknisk retning for udveksling Afsendersystem inititerer kommunikation med KY Dataretning for udveksling Afsendersystem sender OIOUBL-dokument til KY Service invokation / Triggers Når et afsendersystem ønsker at overføre en efaktura til KY Dataspecifikation Miljø: Produktion Inputdata For XSD er, se Outputdata Miljø: Test Inputdata Hent_IType.xsd Outputdata Sikkerhed Dokumenter sendes og modtages via OIORASP-protokollen. Se de sikkerhedsmæssige krav der knytter sig hertil på [NemHandel]. KOMBIT A/S Halfdansgade København S CVR Side 12 af 15

13 Leverancesikkerhed og fejlhåndtering [Udfyldes med oplysninger om den tekniske leverancesikkerhed via snitfladen, herunder fx med henvisning til definitioner i QoS for basic delivery assurances: At most once, At least once, Exactly once og No guarantee. [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med tekniske fejl.] [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med forretningsmæssige fejl.] [Ovenstående skal også omfatte information om aftalte timeoutintervaller og regler for genfremsendelse.] Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Værdi Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Service Management Incident Management [Indhold afventer generel afklaring af governancestrukturer.] Problem Management [Indhold afventer generel afklaring af governancestrukturer.] Change Management [Indhold afventer generel afklaring af governancestrukturer.] KOMBIT A/S Halfdansgade København S CVR Side 13 af 15

14 3.1.6 Testplan Integrationstest Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen Produktionssætningstest Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. KOMBIT A/S Halfdansgade København S CVR Side 14 af 15

15 4 Beskrivelse for integrationsplatformen Løsningen benytter ikke Serviceplatformen, hvorfor dette kapitel er udeladt KOMBIT A/S Halfdansgade København S CVR Side 15 af 15