Integration SF1590_E_V1 Afsend Betalingsanmodning til NemKonto Integrationsbeskrivelse - version 1.0.0

Transkript

1 Integration SF1590_E_V1 Afsend Betalingsanmodning til NemKonto Integrationsbeskrivelse - version Kommunernes Data- og Infrastrukturfællesskab - KDI

2 Versionshistorik Relevans Dato Initialer Version Kommentarer Udgivet xpml Draft / mangler test og implementeringsopgaver Referencer Ref. Titel Kommentarer [GVF] [Tek-Vejl] [Servicekatalog] Findes her: [Hovedoplysninger] [Bilag] [WSDL] Integration Generelle vilkår og forudsætninger Generelle vilkår og forudsætninger.pdf Findes her: Teknisk vejledning Findes her: s servicekatalog Transaktionsspor og Fejlbehandling ved servicekald Findes her: med reference til Referencedokumenter, Transaktionsspor og Fejlbehandling ved servicekald.pdf. Bilagssamling til integrationsbeskrivelsen SF1590_E V1 Afsend Betalingsanmodninger til NemKonto Bilag zip Findes her: under området Økonomi eller direkte med reference til SF1590_E_V1. BetalingsanmodningTilNemKontoAfsend Findes her: [Bilag] BetalingsanmodningTilNemKontoAfsend.r756.zip. Generelle vilkår og forudsætninger, der skal være på plads før Snitflader kan anvendes Den anbefales, at leverandører af fagsystemer og kildesystemer orienterer sig heri. NB: Der refereres ikke hertil i nærværende dokument. Fælles datastruktur for services udstillet på Serviceplatforen. Indgår i servicenes input og output payload. Samler bilag, som knytter sig til integrationen. Samlet pakke, som teknisk beskriver services, som de er udstillet på. Indeholder to WSDL er for hhv. Afsend- og den korresponderende Hent-service. KOMBIT A/S Halfdansgade København S CVR Side 2 af 55

3 [NemKonto- Anvendelse] Bekendtgørelse af lov om offentlige betalinger m.v. Denne information kan også tilgås via Nem- Konto på [NemKonto- Lovgrundlag] [NemKonto- Håndbog] Lovgrundlag Nemkonto håndbogen Findes her: [Bilag] / _samlet hã ndbog pdf. Lovgrundlaget for indførelsen af NemKonto er en del af Lov om offentlige betalinger. Forretningsorienteret. Fagsystemet bør orientere sig i dette materiale. NB: Der refereres ikke hertil i nærværende dokument. [NemKonto Ydelsesarter] [NKS-KMD] Ydelsesarter Findes her: Generelle Forretningsbetingelser for KMD A/S Yderligere information findes i kapitel 6 i [NemKonto-Håndbog] Findes her: [Bilag] / _Generelle_forretningsbetingelser_ver_aug20031.pdf. [NKS-Datale- verandør- Opl.] [NKS-Dataleverandøraftale] [NKS-Tilslutningsinfo] [NKS-SFB] Oplysningsskema for Dataleverandør Findes her: [Bilag] / _Oplysningsskema til Dataleverandoer1.pdf. Dataleverandøraftale Findes her: [Bilag] / _dataleverandoeraftale _support1.pdf. Tilslutningsinformations skema Findes her: [NKS-Dataleverandøraftale] / Bilag 1a Snitfladebeskrivelse NemKonto Systemet Dataleverandør er her den specifikke myndighed, som i kontekst af ét fagsystem benytter integrationen. Indgår i [Dataleverandør-Aftale]. Dataleverandør er her den specifikke myndighed, som i kontekst af ét fagsystem benytter integrationen. Bilag 1b til aftalen finder ikke anvendelse. Dette skema udfyldes pr. fagsystem, som skal tilsluttes. Findes her: [Bilag] / Snitflade_beskrivelse_for_ukomplette_og_komp_v KOMBIT A/S Halfdansgade København S CVR Side 3 af 55

4 [NKS- XMLDoc] XML skemaer for ukomplette og komplette betalinger til NKS Findes her: Findes her: [Bilag] / _XML Skemaer for komplette og ukomplette betalinger t1.pdf. [NKS-MQ] Vejledning i opsætning af MQ Findes her: Findes her: [Bilag] / MQ-vejledning.pdf. [NKS-Tilslutningsprøve] Tilslutningsprøve drejebog Betalinger [NKS-Test] [NKS-Guide] Findes her: Findes her: [Bilag] / Tilslutningsprve drejebog 23.pdf. Testspecifikationer Findes her: Findes her: [Bilag] / _Testspecifikationer1.pdf. Tilslutningsguide Beskrivelse af specifikationer for tilslutningsprøven. Findes her: Findes her: [Bilag] / Tilslutningsguide til NemKonto aug 2013.pdf. KOMBIT A/S Halfdansgade København S CVR Side 4 af 55

5 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen NemKontos hovedopgaver Afleveringsfrister Afledte krav ift. bogføring Gruppering af betalingsanmodninger Servicebetingelser for den samlede integration Teststrategi Forudsætninger for produktionssætning Kontekst for integrationsparter Kontekst for udbetalende fagsystem [!@IP-BET@!] Kontekst for NemKonto [!@IP-NemKonto@!] Specifikation for integrationsparter Specifikation af endpoints for udbetalende fagsystem [!@IP-BET@!] Specifikation af endpoints for SP [!@SP@!] Specifikation af endpoints for NemKonto Systemet [!@NKS@!] Beskrivelse for integrationsplatforme Beskrivelse for [!@Systematic@!] KOMBIT A/S Halfdansgade København S CVR Side 5 af 55

6 1 Overordnet beskrivelse 1.1 Integrationens formål Integrationen giver et fagsystem adgang til udbetaling via NemKonto. NemKonto understøtter komplette og ukomplette betalinger, som resulterer i en pengeoverførsel mellem betalers bankkonto og modtagers bankkonto. NemKonto er understøttet i systemet NemKonto System, NKS. Integrationens er tiltænkt de fagsystemer, som ikke ønsker at tilgå NKS direkte, fx hvor fagsystemet har behov for at sende mere end betalingsanmodninger pr. år 1, og samtidig ikke ønsker at etablere en infrastruktur med en MQ Server. Integrationen formidler betalingsanmodninger uændret fra fagsystem til NKS. 1.2 Overordnet forretningsflow i integrationen Gennemførelse af betaling i NKS er asynkron. Først sender fagsystemet først betalingsanmodninger til NKS. Herefter behandler NKS betalingsanmodningen, dvs. validerer og komplementerer ukomplette betalinger. NKS sender herefter valide komplette betalingsanmodninger til pengeinstituttet, PI. Figur 1 angiver, hvordan et fagsystem afsender betalingsanmodning til. kvitterer synkront med en transportkvittering. En positiv transportkvittering bekræfter, at betalingsanmodningen er lagt på fagsystemets kø til NKS. For yderligere detaljer se afsnit Såfremt betalingsanmodningen accepteres af NKS, og betalingsoverførelsen gennemføres af pengeinstituttet, da vil fagsystemet modtage to positive forretningssvar. Første forretningssvar ifm. NKS accept og første formatvalidering af betalingsanmodningen. Andet forretningsvar, når NKS har fået bekræftelse på modtagelse i pengeinstituttet. De to forretningssvar vil komme i sekvens. Efter det sidste positive forretningssvar er modtaget, kan der komme et negativt forretningssvar, hvis PI ikke kan gennemføre betalingsoverførelsen. NKSs behandling af en betalingsanmodning kan resultere i en negativ validering. NKSs sender da et negativt forretningssvar for denne betalingsanmodning. Det stopper den videre behandling i NKS af betalingsanmodningen. NKS fortsætter behandlingen af forsendelsens øvrige betalingsanmodninger, såfremt de valideres positivt. Forretningssvar m.m. er beskrevet i afsnit 3. Figur 2 angiver, hvordan fagsystemet henter sine forretningssvar. Der er tale om en kontinuerlig forespørgsel på forretningsvar pga. af den asynkrone svarmodel i NKS. For yderligere detaljer se afsnit Betalingsanmodninger sendes i bundter. Forretningssvar gives enten for hele bundet eller for betalingsanmodninger indenfor et bundt. Der vil i forretningssvaret altid være reference til bundet. 1 De betalingsanmodninger pr. år er en tærskelværdi sat af NKS. Under tærskelværdien kan fagsystemet benytte en MQ Client opkobling. Over tærskelværdien skal fagsystemet benytte en MQ Server, som alt andet lige giver en anden omkostning for fagsystemet. KOMBIT A/S Halfdansgade København S CVR Side 6 af 55

7 NKS Serviceplatfom ØiR-service Fagsystem Integrationsbeskrivelse Fagsystemet skal i forbindelse med en afsendelse af en betalingsanmodning sende en korresponderende finansbilag til myndighedens (kreditors) bogføringssystem. NKS Betalingsanmodning Afsend Service Straksleverance Afsend Betalingsanmodning Modtag svar Modtag Betalingsanmodning Afsend svar Valider Betalings- Anmodning Fejl Dan Negativ Transportkvittering Ok Placer på Fagsystem NKS-kø (Ud) Ok Dan Positiv Transportkvittering Placer Betalingsanmodning på Fagsystem NKS-kø (Ind) Behandel Betalingsanmodning Figur 1 - NKS Betalingsanmodning Afsend - Flow KOMBIT A/S Halfdansgade København S CVR Side 7 af 55

8 Pengeinstitut NKS Serviceplatfom ØiR-service Fagsystem Integrationsbeskrivelse NKS Forretningssvar Hent Service Straksleverance OK Modtag Svar Betalingsanmodning Hent Forretningssvar Modtag svar Modtag Anmodning Forretningssvar Afsend svar Valider Anmodning Forretningssvar Fejl Dan Negativ Transportsvar Dan Forretningsvar Ok Læs forretningssvar på Fagsystem NKS-kø (Ind) Behandel Betalingsanmodning Valider Betalings- Anmodning Fejl Placer forretningssvar på Fagsystem NKS-kø (Ud) Ok Ok Fejl Modtag Betalingsanmodning Gennemfør Betaling Figur 2 - NKS Forretningssvar Hent - Flow KOMBIT A/S Halfdansgade København S CVR Side 8 af 55

9 1.2.1 Integrationens begreber Nedenfor er angivet enkelte begreber, som er nyttige for læsningen af integrationsbeskrivelsen. De kan med fordel suppleres med Ordliste i [NKS-SFB], samt definitioner i [HovedOplysninger]. AfsenderItSystemInstans Det system, som afsender betalingsanmodninger til NemKonto. Typisk vil det være et fagsystem, fx KY. Der er tale om den enkelte fysiske instans af et it-system, heraf navnet. I STS Administration anvendes begrebet it-system. Indgår i HovedOplysning, AfsenderItSystemInstans. Alias: Fagsystem, Anvendersystem Teknisk repræsentation: UUID AfsenderOrganisation Den myndighed, som har dataansvar for datavideregivelse eller dataforespørgsel fra AfsenderItSystemInstans. Defineret i STS Organisation, som myndighed. Indgår i HovedOplysning, AfsenderOrganisation. Alias: Kommune, AfgivendeMyndighed Teknisk repræsentation: urn:oio:cvr:cvr-nummer:xxxxxxxx ModtagerItSystemInstans Logisk er det NemKonto Systemet, NKS. 2 Indgår i HovedOplysning, AfsenderOrganisation. Alias: Kildesystem Teknisk repræsentation: UUID ModtagerOrganisation Den myndighed, som har dataansvar for datamodtagelse i NemKonto, Digitaliseringsstyrelsen. 2 Defineret i STS Organisation, som myndighed. Indgår i HovedOplysning, ModtagerOrganisationFejl! Bogmærke er ikke defineret. Alias: Myndighed Teknisk repræsentation: urn:oio:cvr:cvr-nummer:xxxxxxxx Dataleverandør Dataleverandør er den specifikke myndighed, som i kontekst af ét fagsystem (AfsenderItSystemInstans) benytter integrationen. Benytter samme myndighed integrationen i kontekst af et andet fagsystem, da vil myndigheden optræde som en anden Dataleverandør. 2 Begrebet er medtaget her, da det indgår i KOMBITs model for dataoverdragelse. Karakteren af integrationen gør, af værdien ikke skal angives ifm. den aktuelle dataudveksling. KOMBIT A/S Halfdansgade København S CVR Side 9 af 55

10 NKS NemKonto Systemet, som ejes af Digitaliseringsstyrelsen, som ligeledes er den dataansvarlige for systemet. KMD A/S er databehandler for systemet. Alias: NemKonto PI Komplet betaling Ukomplet betaling Pengeinstitut system / clearingscentral En komplet betaling er fuldt udfyldt inkl. modtagerkontonummer af den udbetalende myndighed og videresendes uændret til betalingsafviklende pengeinstitut. En betaling fra en offentlig myndighed, der skal kompletteres med kontonummeret fra enten en Nemkonto eller en Specifik konto inden den sendes videre til det betalingsafviklende pengeinstitut. 1.3 NemKontos hovedopgaver Ganske overordnet kan NKS beskrives ved to af dets hovedopgaver: - Omdanne en ukomplet betaling til en kompletteret betaling - Distribution af kompletterede betalingsanmodninger til myndighedens pengeinstituts it-system I en betalingsanmodning af typen Ukomplet betaling er modtageren af betalingsoverførelsen angivet ved et cpr-nummer, cvr-nummer, SE-nummer eller P-nummer. NKS har information om borgeres og virksomheders NemKonti. NKS kompletterer den ukomplette betaling ved opslag i denne information. NKS påfører betalingsanmodningen den fremsøgte Nem- Kontos registrerings- og konto-oplysninger. Herved bliver betalingen komplet. Figur 3 er taget fra [NKS-XMLDoc]. Her kan der læses mere, ligesom der findes en detaljeret beskrivelse i [NKS-SFB]. Figur 3 - Komplettere ukomplette betalinger KOMBIT A/S Halfdansgade København S CVR Side 10 af 55

11 1.4 Afleveringsfrister Aftalen om brug af NemKonto angiver frister for aflevering af betalingsanmodninger (betalingsordre) til NKS. Overholdes fristen, da garanterer NemKonto og pengeinstituttet, at betalingsoverførslen gennemføres som angivet. Det gælder både, når betaler og betalingsmodtager benytter samme pengeinstitut og forskellige pengeinstitutter. Ekspeditionsdagen er dagen, hvor betalingsanmodningen modtages af NKS. Udbetalingsdagen er den dato, hvor betalingen er tilgængelig på betalinsmodtagers konto. Den ønskede udbetalingsdag angiver fagsystemet i betalingsanmodningen. Kan NKS eller pengeinstituttet ikke imødekomme ønsket, fordi afleveringsfristen er overskredet, så vil betalingsoverførslen blive gennemført på førstkommende mulige udbetalingsdato. For de konkrete afleveringsfrister henvises til [NKS-SFB]. Opsummeret gælder, at afleveres betalingsanmodninger før kl. 06 på ekspeditionsdagen, så kan betalinger være til udbetaling på første efterfølgende hverdag. Historisk har det være muligt at sende enkeltvise betalingsanmodninger frem til kl og få dem til udbetaling den efterfølgende hverdag. Det er fortsat muligt. Der er dog ingen garanti herfor. Kan NKS eller pengeinstituttet ikke imødekomme ønsket, fordi afleveringsfristen er overskredet, så vil betalingsoverførslen blive gennemført på førstkommende mulige udbetalingsdato. 1.5 Afledte krav ift. bogføring Det udbetalende fagsystem skal danne og afsende et bogføringsgrundlag, som modsvarer de afsendte betalingsanmodninger. Bogføringsgrundlaget dækker den finanskontering, som skal foretages mellem fagsystemets mellemregningskonto for udbetaling og kommunens finanskonto (bankkonto). Finanskonteringen skal foregå umiddelbart i umiddelbar sammenhæng med afsendelse af betalingsanmodninger. Modtager fagsystemet besked fra NKS om, at en betalingsanmodning ikke kunne gennemføres (fx fordi betalingsmodtager ikke har registreret en NemKonto), da skal fagsystemet foretage en korrigerede modpostering, dvs. afsende et ny bogføringsgrundlag. Til afsendelse af bogføringsgrundlag anvendes integrationen SF1590_A Afsend økonomipostering til ØiR (Finans), se servicekataloget på Gruppering af betalingsanmodninger Det udbetalende fagsystem skal vælge, om betalinsanmodninger skal grupperes. KOMBIT A/S Halfdansgade København S CVR Side 11 af 55

12 1.6.1 Grupperede betalingsanmodninger Figur 4 - Gruppering af betalingsanmodninger fra [NKS-SFB] Ikke grupperede betalingsanmodninger Figur 5 - Ikke grupperede betalingsanmodninger fra [NKS-SFB] Der er oplagte fordele og ulemper i begge modeller. Fagsystemet bør i sine overvejelser inddrage afstemningsbehovet i kommunens bogholderi. Anvender fagsystemet registrantbogføring er det muligt i finansbilaget (SF1590_A) at angive en entydig reference til en betalingsanmodning. Denne reference skal kunne genfindes på debitors KOMBIT A/S Halfdansgade København S CVR Side 12 af 55

13 kontoudtog for at opnå en effektiv afstemningsproces. Her vil det ikke være tilstrækkeligt at gruppere betalingsanmodninger, da det er i Payment info (elementet DebitPurpose 3 ), at denne reference findes. 1.7 Servicebetingelser for den samlede integration Servicemål Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Under afklaring] 1 sekund svartid for webservicekald for hhv. afsendelse af betalingsanmodning og hentning af forretningssvar. [Under afklaring] [Under afklaring] [Under afklaring] Service Management Eventuelle tilretninger og præciseringer i integrationens beskrivelse og specifikation vil indtil integrationen ligger på s eksterne testmiljø, blive håndteret af Kommunernes Data og Infrastruktur (KDI). Spørgsmål vedr. specifikation sendes til kdi@kombit.dk. KDI 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å, vil den overgå til s governanceproces. Adgangen hertil fremgår af Teststrategi Overordnet Det generelle udgangspunkt for KOMBITs teststrategi er, at alle involverede parter, dvs. fagsystemerne, kildesystemet (her NKS) og har gennemført en robust systemtest af egen løsning, før der gennemføres test parterne imellem. Dette antages gældende på forhånd for NKS, som er et kørende system i produktion siden Der er alene tale om en standard tilslutning set med perspektiv fra NKS, som har en fast proces for tilslutningsprøve, [NKS-Tilslutningsprøve]. NKS tilbyder som standard alene adgang til sit testsystem ifm. denne tilslutningsprøve. 3 Se [NKS-SFB]. Bemærk at feltet i SWITFT har max længde på 35 karakterer. Pengeinstituttet viser kun 20 karakterer KOMBIT A/S Halfdansgade København S CVR Side 13 af 55

14 Hvert udbetalende fagsystem, som skal benytte NemKonto skal succesfuldt gennemføre tilslutningsprøven. Testkriterierne er fælles for alle fagsystemer, [NKS-Test]. har som standard kun adgang til test ift. NKS ifm. et fagsystems tilslutningsprøv. Her gennemføres en hul-igennem-test. Ovennævnte er præmis for teststrategien for denne integration, dvs. der er ikke planlagt eller bestilt ændringer ift. NKSs testsetup Test i forbindelse med udvikling på Den planlagte test af services til installation på omfatter pt., at der udfører automatiserede tests af services og unittests. Der er tale om en robust test af sikkerhed, routing og anden kernefunktionalitet i integrationen, samt mere en simpel som modsvarer [NKS-Tilslutningsprøve]. Testen skal endvidere omfatte test af VPN-forbindelsen mellem s og NKSs driftsmiljøer. Leverandøren af er ansvarlig for denne test Testfaciliteter og testmiljø Der er etableres simple testdrivere og teststubbe for simulering af fagsystem og kildesystem. Scope skal være lig [NKS-Test] suppleret med de svar, som selv genererer jf. afsnit 4. Teststubbe skal kunne genbruges af fagsystemerne ifm. deres løbende integrationstest jf. afsnit Teststubbe skal dokumenteres, så de anvendte testcases og testdata er tilgængelig for fagsystemerne Testdata Tekniske testdata jf. [NKS-Test] suppleret med testdata dækkende s svar- og fejlkoder NKS - Kildesystemintegrationstest Det forudsættes, at sammen med KMD A/S, der er leverandør af VPN-opkobling (CAP-IP) mellem Serviceplaformen og NKS har testet denne forbindelse. gennemfører pr. fagsystem, som skal tilsluttes, en MQ-Ping test for kontrol af Channel- og kø-opsætning. Tilsvarende gør NSK, hvor det er NKS, der transmitterer, til. Ifm. etablering af den første tilslutning mellem NKS og gennemfører en test svarende til et fagsystems tilslutningsprøve [NKS-Test]. KOMBIT A/S Halfdansgade København S CVR Side 14 af 55

15 Det betyder, at der for det første fagsystem vil gennemføres to tilslutningsprøver Testfaciliteter og testmiljø foretager denne test både fra Exttest og Produktion. Channel er den samme, kø-navne er forskellige Testdata Ifm. første tilslutning afvendes tekniske testdata jf. [NKS-Test] Fagsystem Anvenderintegrationstest Testen har til formål at verificere, at fagsystemet benytter de af serviceplatformen udstillede services korrekt. Dvs. indgangsbetingelse før tilslutningsprøven jf. afsnit Testen har som udgangspunkt samme scope som for tilslutningsprøven, der er fastlagt af NKS. Har fagsystemet behov for yderligere testfaciliterer fx en mere omfattende test af flere integrationer i sammenhæng med mere forretningsnære testcases, da skal det særskilt aftales med KDI Testfaciliteter og testmiljø Testen gennemføres i Exttest. Testen benytter de teststubbe, som har etableret til egen systemtest jf. afsnit Fagsystemet skal via en service request til s Helpdesk kunne få til at skifte mellem test mode stubbe til test mod NKS i forbindelse med tilslutningsprøven Testdata Testcase og testdata er fastlagt af NKS samt, jf dokumentation af teststubbe, jf. afsnit Fagsystem - Anvendersystem end-to-end-test - Tilslutningsprøve Fagsystemets forretningsmæssig end-to-end-test er begrænse til det scope, som NKS har fastlagt for den obligatoriske tilslutningsprøve, [NKS-Tilslutningsprøve]. Tilslutningsprøven gælder fagsystemet og de herunder omfattede dataansvarlige myndigheder. Der er en mindre pris for gennemførelse af tilslutningsprøven. Den fremgår af prislisten for myndigheders tilslutning til NKS, Testen aftales og koordineres med, se afsnit Testen gennemføres kun en gang. Det er en forudsætning, at fagsystemet succesfuldt har gennemført en robust systemtest af sine services. KOMBIT A/S Halfdansgade København S CVR Side 15 af 55

16 Testfaciliteter og testmiljø Testen gennemføres i Exttest. Testen benytter sig af samme den fagsystemspecifikke channel mellem s og NKSs MQ Servere. Kø-navne har et test-post-fix. Pga. serviceplatformens skemavalidering har fagsystemet ikke mulighed for at gennemføre den test, som omfatter bad xml. 4 Testen skal dog stadig gennemføres jf. krav fra NKS, og det skal sikres at fagsystemet kan håndtere fejl, som kan opstå her. Denne del af testen gennemføres derfor med assistance fra. Fagsystemet afleverer i en manuel proces testdata til indeholdende bad xml jf. kravene i [NKS-Test]. placerer testdata på fagsystemets udgående kø til NKS. NKS returnerer forretningssvaret receipt0 jf. afsnit , som helt standardmæssigt placeres på den indgående kø til fagsystemet Testdata Fastlagt af NKS jf. [NKS-Test]. 1.9 Forudsætninger for produktionssætning For at kunne anvende snitfladen er der en række vilkår og forudsætninger, som skal være opfyldt af en tilslutningspart, der skal tilsluttes. Ved tilslutningspart skal forstås anvendersystemer, kildesystem osv. Disse vilkår og forudsætninger er opdelt i generelle vilkår og forudsætning, som gælder på tværs af snitfladerne, og i specifikke vilkår og forudsætninger for tilslutning til selve snitfladen. De generelle vilkår og forudsætninger er beskrevet [GVF], mens de specifikke aktiviteter, der skal udføres som forudsætning for tilslutning af en tilslutningspart, er beskrevet for hver enkelt tilslutningspart i kapitel 2.Køreplan for Implementering Køreplan for Implementering Nedenstående diagram viser den køreplan for udrulningen som anvendersystem inden for KOM- BIT rammearkitektur under monopolbrudsprojektet følger. Det væsentlige i køreplanen er faserne, mens en egentlig tidsplan vil følge af den faktiske implementeringsplan. Aktiviteter, som er forudsætninger og betingelser i forbindelse med ibrugtagning af en snitflade, som følge af en udrulning af et anvendersystem, vil referere til den fase, den hensigtsmæssigt kan udføres i. : Ved idriftsættelse af en snitflade er alle aktiviteter afsluttet, og snitfladen er klar til anvendelse Kildesystem: Alle aktiviteter i forhold til serviceplatformen er afsluttet, men der kan være yderligere aktiviteter i forbindelse med tilslutning af et anvendersystem eller en kommune. 4 Denne fejl vil kun optræde i en af tre situationer. 1) har fjernet skemavalideringen på sin serviceudstilling og fagsystemet sender i samme periode en ikke lovlig XML. Som ej heller opdages ifm. dannelse af den detaljerede logning på. 2) korrumperer data i transporten internt på. 3) NKS validerer korrekt xml som en fejl. KOMBIT A/S Halfdansgade København S CVR Side 16 af 55

17 Anvendersystem og kommune: Ved tilslutning af et anvendersystem og/eller en kommune, er der en række aktiviteter op til idriftsættelsen, dels af aftalemæssig karakter, og dels også af konfigurationsmæssig karakter. Er der aktiviteter, som medføre konfiguration på, vil dette ske i forbindelse med oprettelse af myndighedens serviceaftalen for kommunen Særlige vilkår For at benytte servicen skal den enkelte myndighed per fagsystem indgå en dataleverandøraftale med NKS, [NKS-Dataleveran-døraftale]. Endvidere forudsættes, at samme myndighed har indgået en PI-aftale med sit pengeinstitut om træk via NemKonto på myndighedens bankkonti. Myndigheden skal i sin databehandleraftale med databehandleren af fagsystemet have givet en instruks om, at databehandleren for myndigheden skal modtage og behandle forretningssvar fra Nemkonto også efter, at myndigheden ikke længere afsender betalingsanmodninger via fagsystemet til NemKonto. KOMBIT A/S Halfdansgade København S CVR Side 17 af 55

18 2 Kontekst for integrationsparter 2.1 Kontekst for udbetalende fagsystem Lovhjemmel og forvaltningsmæssigt formål Fagsystemer, som danner betaling til borgere og virksomheder er forpligtet til at benytte NemKonto jf. lov nr af 27. december 2003, med de ændringer, der følger af 1 i lov nr. 527 af 24. juni 2005, 1 i lov nr. 449 af 22. maj 2006, 5 i lov nr. 346 af 18. april 2007 og lov nr. 503 af 6. juni 2007, [NemKonto-Anvendelse]. Det specifikke hjemmelsgrundlag for den enkelte og faktiske udbetaling, som foretages via NemKonto, er ikke angivet her Ønsker og forventninger til kapacitets- og servicekrav fra denne integrationspart Kapacitetskrav Kommunernes Ydelsessystem forventes at sende betalingsanmodninger ved hver månedskørsel. Derudover vil der løbende blive sende betalingsanmodninger pr. hverdag. Kommunernes Sygedagpenge System forventes at sende betalingsanmodning ved hver månedskørsel. Der vil være et begrænset antal løbende betalingsanmodninger. Social Pension Kommunes behov er ikke fastlagt Krav til driftsafvikling Der vil ifm. månedsafslutning gennemføres et omfattende antal betalingsanmodninger parallelt fra flere fagsystemer. Disse skal være gennemført senest kl. 6, for at NKS garanterer deres behandling, se [NKS-SFB], afsnit: Betingelser for anvendelse af standardsnitfladen / Afleveringsfrister. Af samme reference fremgår de datoer i løbet af året, som har betydning for planlægning af månedskørsler i det enkelte fagsystem. Fagsystemet skal have mulighed for at aflevere frem til kl. 6 ifm. månedskørslen. Der må således ikke være planlagte servicevinduer på disse tidspunkter. I forbindelse med produktionssætning af det enkelte fagsystem aftales en driftsplan for året. Primo oktober måned skal fagsystemet tage sin driftsplan for det kommende år op til revision. Fagsystemet sender det kommende års driftsplan til s Helpdesk seneste 30. november i indeværende år. De løbende betalinger vil gennemføres både i almindelig arbejdstid, her Quick-betalinger og under resten af døgnet. Quick-betalinger vil have spidsbelastning fra kl. 10 frem mod kl Specifikke forsætninger for tilslutning af denne integrationspart Nedenfor er angivet en række forudsætninger, som resulterer i information, som skal anvendes ifm. det enkelte betalingsanmodning. Der er for denne information givet en reference til dens anvendelse [NKS-SFB]. KOMBIT A/S Halfdansgade København S CVR Side 18 af 55

19 Fagsystemet Fagsystemet skal have konfigureret eget kø-system på Fagsystemet skal gennemføre en tilslutningsprøve. Se afsnit Dette kø-system skal være oprettet som Dataleverandør via en [NKS-Dataleverandøraftale]. Det medfører information om: o Systemets kortnavn o Dataleverandørens kortnavn ebms Message Header Element, PartID (1) Myndigheden AfsenderOrganisation Skal have indgået en [NKS-Dataleverandøraftale] ift. det enkelte fagsystem. Det medfører information om: o NKS aftalenummer Core Credit Transfer Initiation Message Group Header, Autorisation Myndigheden skal have oprettet sig I KMD LOS (via NemKonto support), evt. med opdeling af myndigheden i administrative enheder. Opdelingen har til formål at kunne afgrænse adgangen for myndigenes brugere i NKSs brugerdialog. Det medfører information om: o MyndighedsID / Administrativenhed Core Credit Transfer Initiation Message Group Header, Initiating Party/Organisation ID/Prorietary ID/Identification Myndigheden skal have indgået en aftale med sit pengeinstitut om træk på bankkonti ifm. NemKonto-betalinger. En sådan aftale har et o PI aftalenummer Core Credit Transfer Initiation Message Payment Information, Debtor/Organisation Identification/Bank party Id Implementeringsopgaver Faserne følger afsnit Fejl! Henvisningskilde ikke fundet.. ID Aktivitet Opgavekategori Ansvarlig Komponent Udførende Fase og afhængighed Kommentar TS100 Etablering af fælles grundlag for NKS-dataleverandøraftale for fagsystemet Afklaring/Aftale Leverandør af fagsystem Leverandør af fagsystem Fase 2.1 TS101 Fagsystemet skal være oprettet i STS Administrationsmodul Konfiguration STS Administration Leverandør af fagsystem Leverandør af fagsystem Fase 2.1 KOMBIT A/S Halfdansgade København S CVR Side 19 af 55

20 ID Aktivitet Opgavekategori Ansvarlig Komponent Udførende Fase og afhængighed Kommentar TS102 TS103 Bestille opsætning af fagsystemets adgang via til NKS Indhentning af PI-nummer hos kommunen Koordinering Leverandør af fagsystem Koordinering Leverandør af fagsystem Leverandør af fagsystem Leverandør af fagsystem Fase 2.1 Fase 2.2 TS104 Oprettelse af en eller flere administrative enheds-id er pr myndighed NKS / KMD LOS Konfiguration Leverandør af fagsystem Dataansvarlig myndighed for fagsystemet Fase 2.2 TS105 Afklaring af myndighedens brug af NKSbrugergrænseflade Afklaring NKS Leverandør af fagsystem Dataansvarlig myndighed for fagsystemet Fase 2.2 TS106 Opsætning af PI-numre og Administrative enhedsid er Fagsystem Konfiguration Leverandør af fagsystem Leverandør af fagsystem Fase 2.2 Fagsystemet kan have etableret en brugerdialog, så myndigheden selv kan gennemføre registreringen. TS107 Indgåelse af NKS Databehandleraftale Aftale NKS Leverandør af fagsystem Dataansvarlig myndighed for fagsystemet Fase 2.2 Afhængig af TS100 TS108 Fagsystemet skal have etableret adgang til STS Token Service. Konfiguration STS Administration Leverandør af fagsystem Leverandør af fagsystem Fase 2.2 KOMBIT A/S Halfdansgade København S CVR Side 20 af 55

21 ID Aktivitet Opgavekategori Ansvarlig Komponent Udførende Fase og afhængighed Kommentar TS109 TS110 Anmodning om Serviceaftale for dataansvarlig myndighed i fagsystemet Dataansvarlig myndighed for fagsystemet skal godkende serviceaftale for integrationen Konfiguration Konfiguration STS Administration Leverandør af fagsystem STS Administration Leverandør af fagsystem Leverandør af fagsystem Dataansvarlig myndighed for fagsystemet Fase 2.2 Fase 2.2 TS111 Gennemførelse af Tilslutningsprøve Drift Fagsystem Fagprojektet/Central administrator Fagprojektet/Central administrator Fase 2.3 TS100 - NKSs Dataleverandøraftale har en teknisk del, som er fælles for alle myndigheder, som skal anvende fagsystemet. Den del forbereder fagsystemet for 1) at fagsystemet kan lave en bestilling til om opsætning af fagsystemet og bestille den tilsvarende konfiguration hos NKS. 2) Fælles indhold for myndighedens individuelle Dataleverandøraftale. TS102 - Fagsystemet skal være oprettet i STS Administration, for at kan oprette kø-konfigurationer mv. TS103 - Myndigheden skal have aftalt en eller flere PI-aftaler med sit pengeinstitut(-ter). PI-aftalenummeret skal anvendes i fremsendelsen af betalingsanmodning. I fagsystemet skal disse værdier kunne opsættes pr. myndighed. TS104 - En betalingsanmodning indeholder reference til en administrativ enhed hos myndigheden. Brugeradgangen i NKS styres via roller i sammenhæng med en administrativ enhed. En myndighed kan derfor ønske/have bruge for at oprette flere administrative enheder. Myndigheden opretter sine administrative enheder via NKS support, Der opkræves et gebyr her. NB: Kommunale myndigheder har tidligere anvendt enheder oprettet i KMD LOS, som er underlagt Transitionsaftalen mellem KMD A/S og KL. Kommunernes aftaler omkring KMD LOS i den sammenhæng ophører i forlængelse af udfasning af de kritiske fagsystemer. Kommunerne skal derfor i lighed med øvrige myndigheder oprettes via NKS. KOMBIT A/S Halfdansgade København S CVR Side 21 af 55

22 TS105 - Myndigheden skal afklare, om fagsystemets direkte opkobling til NemKonto via giver anledning til at flere/færre af kommunens medarbejdere skal have adgang til brugermodulet i NKS. Bestilling og ajourføring af adgang sker via NKS Support, TS106 - I fagsystemet skal den enkelte myndigheds PI-aftalenumre og Administrative-enheds-id er opsættes. Opsætningen vil afhænge af, om fagsystemet udstiller en brugerdialog i fagsystemet til udførelse af denne opgave. Registrering af Administrative enheds-id er skal angives jf. Tabel 2 TS107 - Myndigheden skal indgå en Dataleverandøraftale med NemKonto/NKS. Basis er det fællesindhold, som er skabt i TS100. TS108 - Fagsystemet skal have etableret federation til STS Sikkerhed ifm. standarden Token-baseret sikkerhed. TS109 - I STS Administration skal der oprettes en anmodning om indgåelse af serviceaftale for myndighedens brug af integrationen, SF1590_E_V1. Anmodningen skal indeholde angivelse af myndighed, dataansvarlig i fagsystemet. TS110 - Dataansvarlig myndighed for fagsystemet skal godkende anmodning (TS109) om serviceaftale for snitflade jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. TS111 - Fagsystemet skal gennemføre tilslutningsprøven jf Kontekst for NemKonto [!@IP-NemKonto@!] Lovhjemmel og forvaltningsmæssigt formål Lovgrundlaget for indførelsen af NemKonto er en del af Lov om offentlige betalinger [NemKonto- Lovgrundlag]. KOMBIT A/S Halfdansgade København S CVR Side 22 af 55

23 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for udbetalende fagsystem Overordnet forretningslogik Det udbetalende fagsystem afsender betalingsanmodninger (også kaldet betalingsordre) til Nem- Konto Systemet, NKS. En betalingsanmodning har en betalingsmodtager og en betaler. En forsendelse af betalingsanmodninger kan bundtes, så den indeholde flere betalingsanmodninger fra samme betaler til en eller flere betalingsmodtagere. En betaler er i denne sammenhæng en myndighed, se afsnit. NKS behandler betalingsanmodningen. NKS sender validerede og kompletterede betalingsanmodninger til betaler (debitors) pengeinstitut. Betalers pengeinstituts gennemfører betalingsoverførsel fra betalers bankkonto til betalingsmodtagers bankkonto. Det kan være indenfor samme pengeinstitut eller mellem pengeinstitutter. Både betalers pengeinstitut og betalingsmodtagers pengeinstitut gennemfører en række valideringer. Fx kontrollerer betalers pengeinstitut, at der er tilstrækkelig kredit på betalers bankkonto. Betalingsmodtagers pengeinstitut vil fx kontrollere, at betalingsmodtager har en aktiv bankkonto i pengeinstituttet. Det betyder, at der løbende og asynkront vil komme forretningssvar på en betalingsanmodning. Som grundregel gælder, at Intet nyt er godt nyt. Dog således, at NKS kvitterer positivt for at have modtaget en betalingsanmodning. Tilsvarende kvitterer betalers pengeinstitut positivt for at have modtaget samme betalingsanmodning. Opstår der valideringsfejl i processen sender den validerende part et negativt forretningssvar herom. Den videre håndtering af betalingsanmodningen ophører i dette tilfælde. I forhold til de gældende afleveringsfrister jf. afsnit 1.4 er transportkvitteringen, som giver ifm. afsendelse betalingsanmodningen (se Figur 1), ikke i kontekst af NKS tilstrækkelig dokumentation for rettidig aflevering. Først, når fagsystemet har modtager første forretningsvar fra NKS, vil fagsystemet kunne verificere, om modtagelsen hos NKS var inde for den aktuelle frist. Det udbetalende fagsystem har forpligtelse til løbende af forespørge på forretningssvar. Forretningssvarene vil vedrøre de af fagsystemet fremsendte betalingsanmodninger. Fagsystemet skal acceptere alle sådanne svar også i det tilfælde, at fagsystemet ikke længere foretager en aktiv databehandling for den myndighed, som har afsendt betalingsanmodningen Betaler Betaler er i betalingsanmodningen identificeret ved Initiating Party. Værdien der angives her er et Administrativ Id eller Myndighedsnavn, se specifikationen af dataelementer [NKS-SFB]. Denne værdi oprettes af myndigheden i en delløsning af NKS, LOS (Linje Organisationssystem). Det er således en anden myndighedsidentifikation, end det cvr-nummer, som anvendes i den fælleskommunale infrastruktur. KOMBIT A/S Halfdansgade København S CVR Side 23 af 55

24 Samme myndighed har mulighed for at angive flere Administrative Id, som skal benyttes ifm. fagsystemet afsendelse af betalingsanmodninger. Dette skal fremgå to steder. For det første skal det være angivet i myndighedens oplysningsskema, [NKS-Dataleverandør-Opl.]. For det andet skal det oplyses ifm. opsætningen af fagsystemets brug af servicen på, da det indgår i s autorisationsmodel, se afsnit Ydelsesart og tilbagehold af betalingsoverførsel Offentlige betalinger skal angives med en ydelsesart. Den anvendes blandt andet, når NKS tilbageholder en betalingsoverførsel pva. SKAT. Tilbageholdelsen betyder, at betalingsmodtageren ikke modtager betalingen direkte, men at betalingen visiteres til SKAT til dækning af betalingsmodtagerens restancer. Tilbageholdelsen indgår i det positive retursvar nummer 8 jf. Tabel 1. Der vil stå "Visiteret til modregning hos SKAT" i stedet for modtagerkonto i feltet Creditor Account BBAN/ IBAN/ Alternative Identification under Original Transaction Information. Mulige ydelsesarter findes her [NemKonto Ydelsesarter]. Ydelsesarten angives i betalingsanmodningen under Payment Transaction i feltet BenefitType (Ydelsesart korttekst), [NKS-SFB]. validerer ikke, om der er angivet korrekt ydelsesart Oversigt over endpoints ID Navn EP_FS01 EP_FS02 NKS Betalingsanmodning Afsend NKS Forretningssvar Hent KOMBIT A/S Halfdansgade København S CVR Side 24 af 55

25 3.1.3 Beskrivelse af endpoint EP_FS01 - Betalingsanmodning Afsend Transportspecifikation Serviceudstiller er serviceudstiller Serviceanvender Fagsystemet er serviceanvender 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]..\package\common\wsdl\NKSBetalingsanmodningAfsend.wsdl Endpoint navn Miljø: Test URI til WSDL [WSDL-SP]..\package\common\wsdl\NKSBetalingsanmodningAfsend.wsdl Endpoint navn Teknisk retning for udveksling Fagsystemet kalder webservicen på Dataretning for udveksling Fagsystemet sender betalingsanmodning til og modtager kvitteringer for aflevering til s MQ Server Service invokation / Triggers Kommunikationen initieres af fagsystemet, ifm. dannelse af nye betalingsanmodninger Dataspecifikation Miljø: Produktion og Test Inputdata [WSDL]...\package\common\view\NKSBetalingsanmodningAfsend_IType.xsd KOMBIT A/S Halfdansgade København S CVR Side 25 af 55

26 Miljø: Produktion og Test Detaljeret dokumentation findes her [NKS-SFB] og [NKS-XML] Outputdata WSDL]..\package\common\view\NKSBetalingsanmodningAfsend_OType.xsd Svar returneres i HovedOplysningerSvar [HovedOplysninger] Fejlkoder vil fremgå af [Servicekataloget] Sikkerhed Servicen udstilles med Token baseret-sikkerhed, LBSB. Hvert fagsystem har sin egen udgående kø til NKS. sikrer via serviceaftale, at et fagsystem, AfsenderItSystemInstans, kun kan sende til egen udgående kø, og kun såfremt den afsendende myndighed, AfsenderOrganisation, har givet sin autorisation via en serviceaftale. validerer endvidere via Tabel 2, at AfsenderOrganisation matcher Identification + Issuer fra: NKSPayment.Core Credit Transfer Initiation message.initiating Party.Organisation ID.Prorprieatry ID Routing til fagsystemet udgående kø sker på basis af rute angivet i Hovedoplysninger. Det er obligatorisk, at fagsystemet udfylder: HovedOplysninger.Rute.AfsenderOrganisation HovedOplysninger.Rute.AfsenderItSystemInstans. autoriserer først adgang til servicen via serviceaftalen. Dernæst krydsvaliderer angivelse i Rute ift. den serviceaftale, serviceadgangen er autoriseret med. Først herefter kan der routes til den fagsystemets udgående kø Logning på Når en betalingsanmodning modtages på skal følgende information logges: s transaktionstidspunkt Servicekaldets HovedOplysninger o TransaktionsId o TransaktionsTid o Rute.AfsenderItSystemInstans o Rute.AfsenderOrganisation Fra NKSPayment o ebms MessageHeader PartyId1 (Dataleverandørs kortnavn) MessageID (ebms message id) KOMBIT A/S Halfdansgade København S CVR Side 26 af 55

27 o o Timestamp (ebms timestamp) Core Credit Transfer Initiation message GrpHeader GrpId (Bundt-reference-nummer) Initiating Party.Organisation ID.Proprietary ID Identification (MyndighedsID eller Administrativ enhed) Issuer (Typeangivelse, MyndighedsId eller administrativ enhed) PmtInf.PmtTxt.PmtID EndToEndId (Betaling Unik Payment Ref.) Leverancesikkerhed og fejlhåndtering Betalingsanmodningen er idempotent. Dvs. fagsystem kan gensende en betalingsanmodning. Hvis NKS har modtaget den, vil NKS konstatere, at der er tale om en genfremsendelse og handle herpå. Fagsystemet vil modtage besked fra, om data er overført til transmissionskøen på Serviceplatform (stored forward acknowledgement). Dette er ikke det samme som, at betalingsanmodningen er sendt eller modtaget i NKS. Fagsystemet skal via EP_FS2 indhente kvittering for korrekt modtagelse og behandling i NKS. Fejl i overførsel til vil blive givet i HovedOplysningerSvar. Fejlkoder vil efter produktionssætning findes og bliver opdateret i [Servicekatalog]. De fremgår ligeledes af 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 [Under afklaring] 1 sekund svartid for webservicekald inkl. tiden for placering på fagsystemets udgående kø. [Under afklaring] [Under afklaring] [Under afklaring] KOMBIT A/S Halfdansgade København S CVR Side 27 af 55

28 3.1.4 Antal af betalingsanmodninger i et bundt Betalingsanmodninger sendes i bundt, dvs. et webservice kald kan indeholde flere betalingsanmodninger. NKS anbefaler i [NKS-SFB], at der ikke sendes mere end betalingsanmodninger i et bundt, dvs. en forsendelse, svarende til 4-6 MB. Det maksimalt tilladte antal er , svarende til MB. For at sikre et hensigtsmæssigt kompromis mellem performance på og forretningens behov for at samle betalingsanmodninger i større grupper bla. for at lette afstemningen i finansbogholderiet, er servicen konfigureret med et maksimalt antal tilladte betalingsanmodninger i et bundt, forsendelse. Værdien, der er fælles for alle fagsystemer, skal være en konfiguration i fagsystemet. Tilsvarende gælder for. Den aktuelle værdi vil fremgå af [Servicekatalog] (default er , svarende til 4-6 MB). KOMBIT A/S Halfdansgade København S CVR Side 28 af 55

29 3.1.5 Beskrivelse af endpoint EP_FS02 Forretningssvar Hent Transportspecifikation Serviceudstiller er serviceudstiller Serviceanvender Fagsystemet er serviceanvender 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]..\package\common\wsdl\NKSForretningssvarHent.wsdl Endpoint navn Miljø: Test URI til WSDL [WSDL]..\package\common\wsdl\NKSForretningssvarHent.wsdl Endpoint navn Teknisk retning for udveksling Fagsystemet kalder webservicen på Dataretning for udveksling En afsendelse af et bundt af betalingsanmodninger under EP_FS1 vil resultere i flere forretningssvar dannet i NKS eller modtaget i NKS fra pengeinstitutterne. NKS videresender løbende forretningssvar til fagsystemets indgående kø på. Fagsystemet skal via servicen hente disse forretningssvar på Service invokation / Triggers Et servicekald kan returnere et forretningssvar. Fagsystemet skal blive ved med at hente, indtil svarer, at der ikke ligger flere forretningsvar til fagsystemet. Et servicekald kan således initiere en sekvens af servicekald. KOMBIT A/S Halfdansgade København S CVR Side 29 af 55

30 Fagsystemet skal initiere kald til minimum hvert [15 minut]. Mellem hvert kald/sekvens af kald skal der minimum gå [1 minut]. Begge værdier skal kunne konfigurers i fagsystemet efter anvisning fra KDI Dataspecifikation Miljø: Produktion og Test Inputdata [WSDL]...\package\common\view\NKSForretningssvarHent_IType.xsd Detaljeret dokumentation findes her [NKS-SFB]. Outputdata [WSDL]..\package\common\view\ NKSForretningssvarHent_OType.xsd Svar returneres i HovedOplysningerSvar [HovedOplysninger] Fejlkoder vil fremgå af [Servicekataloget] Se afsnit for yderligere information og referencer Sikkerhed Servicen udstilles med Token baseret-sikkerhed, LBSB. Hvert fagsystem har sin egen indgående kø fra NKS. sikrer via serviceaftale, at et fagsystem, AfsenderItSystemInstans, kun kan hente fra sin egen indgående kø. Fagsystemet er forpligtet til at hente alle svar vedrørende sine betalingsanmodninger til NKS. Dette gælder også i tilfælde af, at en myndighed ikke længere benytter EP_FS1 og dermed har en aktiv serviceaftale for denne. Det betyder, at autorisationen på myndighedsniveau sker på basis af [KOMBIT] pva. K98 (alle kommuner). [KOMBIT] skal derfor været angivet som afsendende juridisk enhed, AfsenderOrganisation. Serviceaftalen, der autoriserer adgangen til servicen, vil være godkendt af [KOMBIT]. Myndigheden autoriserer denne fremgangsmåde ifm. godkendelse af serviceaftalen for EP_FS1. Routing til fagsystemets indgående kø sker på basis af rute angivet i Hovedoplysninger. Det er obligatorisk, at fagsystemet udfylder: HovedOplysninger.Rute.AfsenderOrganisation = [KOMBIT] HovedOplysninger.Rute.AfsenderItSystemInstans autoriserer først adgang til servicen via serviceaftalen. Dernæst krydsvaliderer angivelse i Rute ift. den serviceaftale, serviceadgangen er autoriseret med. Først herefter kan der routes til den fagsystemets indgående kø. KOMBIT A/S Halfdansgade København S CVR Side 30 af 55

31 Logning på Når et forretningsvar hentes vil logge følgende information før forretningssvaret slettes fra fagsystemets indgående kø: s transaktionstidspunkt Servicekaldets HovedOplysninger o TransaktionsId o TransaktionsTid o Rute.AfsenderItSystemInstans Fra NKSForretningssvar (jf. Tabel 1) o Ved svar af typen Receipt : ebms MessageHeader PartyId1 (Dataleverandørs kortnavn) MessageID (ebms message id) Timestamp (ebms timestamp) o Ved svar af typen Response : ebms MessageHeader PartyId1 (Dataleverandørs kortnavn) MessageID (ebms message id) Timestamp (ebms timestamp) General Information o Initiating Party.OrgID.Proprietary Identification Identification (MyndighedsID eller Administrativ enhed) Issuer (Typeangivelse, MyndighedsId eller administrativ enhed) OrgnlGrpInfAndSts GrpId (Bundt-reference-nummer) OrgnlPmtInf.OrgnlTxtAndSts.PmtID EndToEndId (Betaling Unik Payment Ref.) Leverancesikkerhed og fejlhåndtering Efter at forretningssvaret er returneret i svaret på fagsystemets servicekald, slettes forretningsvaret fra fagsystemets indgående kø. Mister fagsystemet forretningssvaret enten pga. interne forhold eller fx ved forbindelsesproblemer i svarøjeblikket, da kan forretningssvaret ikke genskabes af Serviceplatform. Fagsystemet vil i sin log/fejlhåndtering kende den konkret transaktion via HovedOplysningers TransaktionsID. Fagsystem vil hos kunne få oplyst de korresponderende informationer, som identificerer den eller de betalingsanmodninger forretningssvaret vedrørte, se afsnit Fagsystemet kan nu vælge en eller begge af flg. to strategier: KOMBIT A/S Halfdansgade København S CVR Side 31 af 55