En teknisk introduktion til NemHandel
Indhold > Indledning 3 Standarder 5 OIOUBL 5 OIO RASP 6 OIO SMI 7 Biblioteker 8 Web applikationer 9 Fakturablanket 9 NemHandel Registrering 9 NemHandel.dk 10 Web services 11 NemHandel Aftaleservice 11 NemHandel Serviceregisteret 11 NemHandel VANS Gateway 12 NemHandel Klienten 14
Indledning > NemHandel er en paraplybetegnelse for en række komponenter, der samlet understøtter elektronisk udveksling af forretningsdokumenter i Danmark både i det offentlige og i det private. Formålet med dette dokument er at give et overblik over, hvilke dele NemHandel består af. Med andre ord er dette dokument ikke en introduktion til, hvad NemHandel er eller en motivation for NemHandel, men beskriver kun, hvad NemHandel består af. Samtidig er fokus for dokumentet de komponenter, der leveres af IT- og Telestyrelsen. Private virksomheder kan lave og har lavet udvidelser til NemHandel, men dette sker på almindelige kommercielle vilkår, og disse er ikke omfattet af beskrivelserne i dette dokument. Overordnet set består NemHandel af: En juridisk ramme i form af en bekendtgørelse og nogle tekniske standarder. En fælles infrastruktur i form af internetbaserede services, der drives og betales af staten. Denne infrastruktur suppleres af kommercielle services, men disse omtales ikke i detaljer i dette dokument. En række softwarekomponenter i form af biblioteker og applikationer, der skal hjælpe til med at accelerere udbredelsen af NemHandel. Disse komponenter er alle frigivet under open source licenser. Som antydet ovenfor er visse dele af NemHandel obligatoriske i forhold til handel med det offentlige. Dette er fastlagt i Bekendtgørelse nr. 354 om information i og transport af OIOUBL elektronisk regning til brug for elektronisk afregning med offentlige myndigheder. Bekendtgørelsen gør det obligatorisk for de offentlige myndigheder at understøtte en række af standarderne bag NemHandel senest 1. maj 2011. Bekendtgørelsen refererer til en række standarder, der definerer de tekniske rammer for NemHandel. Dette drejer sig om OIOUBL, OIO RASP samt OIO SMI. Sammenhængen mellem disse standarder kan illustreres gennem nedenstående figur, der viser grundprincippet i en udveksling af et forretningsdokument i NemHandel. 3
> 1. Virksomhed A (VirkA) skal sende et forretningsdokument til Virksomhed B eller til en offentlig myndighed (VirkB). Forretningsdokumentet er repræsenteret vha. OIOUBL standarden. 2. Virksomhed A slår op i NemHandel Serviceregisteret for at finde information om, hvor dokumentet skal sendes hen og hvordan det skal sendes. Grænsefladen til NemHandel Serviceregisteret overholder OIO SMI standarden. 3. Dokumentet sendes til Virksomhed B via en transportprotokol, der overholder OIO RASP standarden. 4
Standarder > OIOUBL OIOUBL er en tilpasning til danske forretningskrav af den internationale standard UBL 2.0 fra standardiseringsorganet OASIS (Organization for the Advancement of Structured Information Standards). OIOUBL er en ren tilpasning af UBL 2.0, hvilket betyder, at et OIOUBL dokument samtidigt er et UBL 2.0 dokument - med andre ord udgør OIOUBL en delmængde af UBL 2.0. XML schemaer for OIOUBL er identiske med UBL 2.0, men disse er suppleret med valideringsværktøjer i form af schematroner, se http://www.oioubl.info/oioubltools/da/oioubltools.html. Bemærk dog at det til enhver tid er selve standarden, der er gældende. De dokumenter, der er medtaget i OIOUBL, udgør en delmængde af UBL 2.0 dokumenterne herunder kataloger, ordre, ordrebekræftelse, faktura og rykker. Fokus for udvælgelsen af delmængden har været at skabe grundlaget for en fuldt automatiseret indkøbsproces. En central del af OIOUBL er de såkaldte profiler, der beskriver standardiserede forretningsprocesser. Med andre ord sætter profilerne de enkelte forretningsdokumenter ind i en procesmæssig kontekst. En oversigt over de relevante NemHandelsprofiler kan findes her http://www.itst.dk/arkitektur-og- standarder/standardisering/datastandardisering/e-handel/oioubl/oversigt-over- NemHandelsprofiler Læse mere om OIOUBL her www.oioubl.info og få en mere uddybende introduktion til OIOUBL her http://www.oioubl.info/classes/da/index.html OIOUBL er efterfølgeren til OIOXML Elektronisk Regning, og generelt dækker NemHandel både OIOUBL og OIOXML Elektronisk Regning. For at lette overgangen til OIOUBL er der blevet udviklet konverteringsstylesheets, der kan konvertere dokumenter mellem OIOUBL og OIOXML Elektronisk Regning. Konverteringsværktøjer og andre OIOUBL værktøjer kan findes her http://www.oioubl.info/oioubltools/da/oioubltools.html Bemærk at den Offentlige VANS Gateway anvender disse stylesheets til konvertering, se afsnittet om NemHandel VANS Gateway nedenfor. Hvis du har spørgsmål eller på anden måde vil deltage aktivt omkring OIOUBL, kan dette ske gennem OIOUBL gruppen på digitalisér.dk http://digitaliser.dk/group/56183 5
> OIO RASP OIO RASP (OIO Reliable Asynchronous Secure Profile) er en transportprotokol til asynkron udveksling af forretningsdokumenter over internettet. OIO RASP er en dansk tilpasning (såkaldt profilering) af en international familie af standarder betegnet WS-*. Til sammen sikrer disse standarder de bagvedliggende forretningsmæssige krav om sikker, pålidelig og uafviselig udveksling af forretningsdokumenter. OIO RASP specificerer dermed en webservice protokolstak baseret på internationale standarder, som et webservice endepunkt skal implementere for at være et OIO RASP kompatibelt endepunkt. Kravene til sikkerhed og pålidelighed er bl.a. sikret gennem kryptering og signering af meddelelser via et OCES funktions- eller virksomhedscertifikat (hvor funktionscertifikatet i de fleste tilfælde vil være det naturlige valg). Brugen af NemHandel til at sende forretningsdokumenter forudsætter dermed at afsenderen anskaffer et certifikat. Læs mere om OCES funktionscertifikat (funktionssignatur) og virksomhedscertifikat (virksomhedssignatur) her: https://danid.dk/export/sites/dk.danid.oc/da/erhverv/signaturprodukter/ Uafviseligheden i RASP profilen vil i praksis betyde, at man kan godtgøre, at et forretningsdokument er blevet sendt i et samhandelsforløb. Som underlæggende transportprotokol for OIO RASP baserede forsendelser kan der vælges mellem HTTP og SMTP (mail) protokollerne. Dette er valgt ud fra, at protokollerne skal være let tilgængelige også for mindre virksomheder. Det er dog ikke et krav, at man som modtager understøtter begge protokoller. Det betyder, at man som afsender skal understøtte begge protokoller, hvis man skal kunne sende til alle NemHandel brugere 1. Offentlige myndigheder understøtter dog i praksis altid modtagelse via HTTP. Find specifikationen af OIO RASP her: http://digitaliser.dk/resource/391706. Hvis du har spørgsmål eller på anden måde vil deltage aktivt omkring RASP, kan det også ske via linket. 1 Der arbejdes på en integration med Dokumentboks, der sikrer, at afsender altid vil kunne aflevere alle meddelelser. Da alle virksomheder vil have en Dokumentboks, vil man via NemHandel kunne nå alle danske virksomheder. 6
> OIO SMI I NemHandel sendes forretningsdokumenter direkte til den forretningsmæssige modtager eller til en part, der agerer på vegne af den forretningsmæssige modtager. Forudsætningen for at dette kan lade sig gøre er, at afsenderen kan slå op i et register, hvor man kan finde det OIO RASP baserede web service endepunkt, dokumentet skal sendes til. Dette muliggøres gennem NemHandel Serviceregisteret, hvor man som afsender kan finde en række informationer om modtageren: Hvilke OIOUBL profiler i hvilke roller han understøtter og dermed hvilke dokumenter han kan modtage, hvilke protokoller modtageren understøtter, hvilket certifikat (offentlig nøgle) forsendelsen skal krypteres med, mm. Grænsefladen til NemHandel Serviceregisteret overholder OIO SMI (OIO Service Metadata Interface UDDI Profile) standarden. OIO SMI er en tilpasning (profilering) af den internationale standard OASIS UDDI version 3.0 for repræsentation af et serviceregister. OIO SMI definerer den struktur, som serviceregistreringer skal overholde i NemHandel Serviceregisteret. Find OIO SMI specifikationen her: http://digitaliser.dk/resource/391720 7
Biblioteker > For at lette adoptering af NemHandel har IT- og Telestyrelsen udgivet referenceimplementationer i form af biblioteker, som implementerer OIO RASP profilen og som kan registrere services i NemHandel registeret, der kan tilgås via et API, der overholder OIO UDDI profilen. Bibliotekerne er tilgængelige under open source licensen MPL 1.1 http://www.mozilla.org/mpl/ Bibliotekerne kan hentes i henholdsvis en.net udgave her: http://digitaliser.dk/group/405467 og i en Java udgave her: http://digitaliser.dk/group/405442. OIO RASP profilen er implementeret som både modtager og afsender og understøtter både HTTP og SMTP som transportprotokol. Bemærk, selvom OIO RASP er en profilering af internationale standarder, har der i praksis vist sig komplikationer mht. at sikre interoperabilitet mellem forskellige implementeringer af disse standarder. Derfor er.net og Java implementeringerne af OIO RASP blevet gennemtestet, så der er sikret interoperabilitet mellem disse. Det anbefales derfor at basere NemHandel løsninger på disse biblioteker i stedet for at udvikle egne implementeringer af OIO RASP profilen. Registrering af services i NemHandel Serviceregisteret understøttes af Address Resolving Services (ARS) biblioteket, der er en integreret del af RASP biblioteket. 8
Web applikationer > En del af den fælles infrastruktur består af et antal web applikationer, der drives af IT- og Telestyrelsen. Fakturablanket Fakturablanket er en web applikation, som IT- og Telestyrelsen stiller frit til rådighed overfor virksomheder, som skal sende fakturaer til offentlige modtagere. Applikationen er rettet mod slutbrugere i de virksomheder, der sender et meget begrænset antal fakturaer til det offentlige, da applikationen er baseret på manuel indtastning af fakturaer. Applikationen er en integreret del af Virk.dk http://virk.dk, se https://www.virk.dk/myndigheder/itst/nemhandel_fakturablanket NemHandel Registrering NemHandel Registreringssitet giver mulighed for at registrere, hvilke forretningsprocesser en NemHandel bruger understøtter, og hvordan disse processer understøttes teknisk. De informationer, der registreres, er: Staminformation om NemHandel brugeren (CVR nummer, adresse, kontaktperson, mm.) Hvilke OIOUBL profiler (forretningsprocesser) der understøttes og i hvilke roller f.eks. simpel fakturering i rollen kunde Hvilke logiske adresser NemHandel brugeren kan identificeres ved f.eks. CVR og EAN numre Hvilket certifikat (offentlig nøgle) forsendelser skal krypteres med Hvilke transportprotokoller der understøttes for modtagelsen af meddelelser f.eks. OIO RASP via http URIer til web service endepunkterne, der kan modtage meddelelser vha. OIO RASP protokollen Disse registreringer gemmes i NemHandel Serviceregisteret (se afsnittet nedenfor om serviceregisteret). Målgruppen for NemHandel Registreringssitet er personer, der har forståelse for virksomhedens understøttelse af OIOUBL herunder viden om konkrete web service endepunkter og brug af de forskellige OIOUBL profiler. Dette vil typisk være virksomhedens leverandør af ERP systemer eller deres IT afdeling. 9
> Profilregistreringssitet kan findes på http://registrering.nemhandel.gov.dk/registrationsite/ NemHandel.dk Siden www.nemhandel.dk har for nuværende status som en ren kampagnesite/oplysningsside for NemHandel, specielt rettet mod små virksomheder uden de store it-kompetencer. 10
Web services > NemHandel infrastrukturen består også at et antal web services, der stilles til rådighed for alle NemHandel løsninger. NemHandel Aftaleservice NemHandel Aftaleservice (Agreement Status Service) er en service til registrering af en virksomheds accept af NemHandel brugervilkårene. Konkret kan en medarbejder via servicen acceptere brugervilkårene på vegne af en virksomhed vha. et medarbejdercertifikat, se https://danid.dk/export/sites/dk.danid.oc/da/erhverv/signaturprodukter/ Disse vilkår skal kun accepteres én gang og er en betingelse for at kunne registrere sig i NemHandel Serviceregisteret og er dermed en forudsætning for at kunne bruge NemHandel. En leverandør kan acceptere NemHandel brugervilkårene på vegne af deres kunder, men leverandøren skal sikre deres kunders accept af dette gennem leverandørens aftalevilkår med kunderne. Brugervilkårene kan findes her: http://aftaler.nemhandel.gov.dk/aftaleroiosi/brugervilkaarnemhandel.htm NemHandel Serviceregisteret NemHandel serviceregisteret er det centrale register, hvor en virksomhed publicerer, hvilke forretningsprocesser (OIOUBL profiler) virksomheden understøtter, og hvordan disse understøttes - se også afsnittet om profilregistreringssitet. Disse serviceregistreringer foretages centralt i et register kaldet UDDI Publish. Herfra replikeres informationen ud til et antal servere, de såkaldte UDDI Discovery registre, der er de registre, der anvendes til opslag ved forsendelser. Denne arkitektur sikrer meget høj tilgængelighed af NemHandel serviceregisteret for opslag. IT- og Telestyrelsen stiller et antal UDDI Discovery servere til rådighed, men det er samtidigt muligt at opstille egne servere, hvis man har specielle krav f.eks. kunne registret udvides med andre serviceregistreringer, der ikke skal være offentligt tilgængelige. Til dette formål er UDDI serveren og et klient bibliotek gjort tilgængeligt under en open source licens her: http://www.softwareborsen.dk/projekter/softwarecenter/serviceorienteretinfrastruktur/openuddi-server og http://www.softwareborsen.dk/projekter/softwarecenter/serviceorienteretinfrastruktur/openuddi-client 11
> En række web services understøtter integration med NemHandel serviceregisteret. Disse kan opdeles i services til henholdsvis registrering, information og opslag i forbindelse med forsendelse. Registreringsservicen Profil Registration Service understøtter registrering af, hvilke OIOUBL profiler der understøttes, og hvordan disse understøttes. Disse registreringer lagres i det centrale UDDI Publish, hvorfra de replikeres ud til UDDI Discovery serverne. Informationsservicen Profile Role Description Service er en service, der udstiller alle NemHandel OIOUBL profiler per rolle, dvs. hvilke dokumenter skal en NemHandel bruger kunne modtage for at agere i en bestemt rolle (kunde/leverandør) i forhold til en bestemt OIOUBL profil. Alle UDDI Discovery serverne stiller en service til rådighed for opslag, der overholder OIO SMI standarden. NemHandel VANS Gateway NemHandel VANS Gateway (Den Offentlige VANS Gateway) er en service, der muliggør at NemHandel brugere kan sende til offentlige modtagere tilkoblet VANS netværket. Den Offentlige VANS Gateway har sikret, at man fra første dag kunne sende til alle offentlige modtagere i Danmark via NemHandel. Den Offentlige VANS Gateway udstiller offentlige modtagere koblet på VANS netværket overfor NemHandel infrastrukturen, sådan at disse optræder på lige fod med andre NemHandel modtagere. Det betyder, at man ved normal brug af NemHandel ikke skal tage højde for denne gateway, da offentlige modtagere set fra afsenderens synspunkt ikke adskiller sig fra andre modtagere koblet direkte på NemHandel. Figuren nedenfor illustrerer, at forsendelsen gennem gateway er en variant af en NemHandel forsendelse, hvor gateway modtager beskeder på vegne af den forretningsmæssige modtager og håndterer videreforsendelsen via VANS. 12
> Den Offentlige VANS Gateway kan modtage OIOXML Elektronisk Regning og OIOUBL dokumenter under profilen NES Profile 5 Basic Billing. OIOUBL dokumenterne bliver i gatewayen konverteret til OIOXML Elektronisk Regning. Dette er gjort for at accelerere adoptionen af OIOUBL, da løsningen sikrer, at man allerede i dag kan sende OIOUBL dokumenter til alle offentlige modtagere. Baggrunden for at vælge understøttelse af netop NES Profile 5 Basic Billing er, at det er den profil, der kommer nærmest OIOXML Elektronisk Regning. Under denne profil kan der kun udveksles faktura og kreditnota, og profilen inkluderer ikke application response, der ikke har et modsvar i OIOXML Elektronisk Regning. Det er overladt til markedet at stille andre gateways til rådighed overfor NemHandel brugerne på forretningsmæssige betingelser. Som eksempel kan nævnes gateways, der tilbyder, at man kan sende til alle modtagere på VANS netværket og ikke kun til de offentlige myndigheder på VANS netværket, eller gateways der tillader brugerne på VANS at sende til NemHandel brugerne. 13
NemHandelsprogrammet > NemHandelsprogrammet er en applikation rettet mod slutbrugere i mindre virksomheder, som gerne vil bruge NemHandel, og som har et økonomi/erp system, der kan håndtere dokumenter i OIOUBL formatet og/eller OIOXML Elektronisk Regning. Det betyder samtidig, at NemHandelsprogrammet ikke selv kan producere OIOUBL dokumenter, men udelukkende er beregnet til sende og modtage dokumenter via NemHandel dog valideres dokumenterne i klienten inden de sendes. Ved modtagelse af dokumenter understøttes kun SMTP protokollen, ved afsendelse understøttes både HTTP og SMTP. Brugsmæssigt er applikationen bevidst designet til at ligne en mail klient, hvor forsendelser placeres i foldere efter hvilken status forsendelsen er i. NemHandelsprogrammet håndterer også registrering i NemHandel Registeret og registrering af brugerens accept af NemHandel brugervilkårene. Applikationen er frigivet under open source licensen Berkeley Software Distribution (BSD) og kan hentes her: http://digitaliser.dk/group/56190 14
Udgivet af: It- og Telestyrelsen Holsteinsgade 63 2100 Ø Telefon: 3545 0000 E-mail: itst@itst.dk