Digital post Integration for virksomheder Via sikker og REST Version 7.0

Transkript

1 Digital post Integration for virksomheder Via sikker og REST Version 7.0 1

2 Indholdsfortegnelse G.1 INTRODUKTION 5 G.1.1 OVERBLIK OVER HVORDAN DIGITAL POST KAN TILGÅS 5 G.1.2 FLOW SOM EN DIGITAL FORSENDELSE GENNEMLØBER FRA MYNDIGHED TIL SLUTBRUGER 6 G.1.3 METADATA (ATTENTIONFORMAT / SAGDOKUMENT) SOM MYNDIGHEDEN PÅFØRER 7 G.1.4 FYSISK STØRRELSE PÅ POST 9 G.1.5 KONFIGURATION SLÅR IGENNEM FOR BÅDE OFFENTLIGE OG PRIVATE AFSENDERE 9 G.2 VIDERESEND POST SOM SIKKER 9 G.2.1 INDHOLDET DER FREMSENDES 9 G.2.2 KONFIGURATION AF AUTOMATISK VIDERESENDELSE 11 G.2.3 GENUDSENDELSESMEKANISME 11 G.2.4 AUTOMATISK PÅFØRTE METADATA 12 DIGITALPOSTMETADATA (VERSION 2) 12 G.3 VIDERESEND POST TIL REST BASERET WEBSERVICE 13 G KVITTERING FOR MODTAGELSE / IDEMPOTENT 13 G GENUDSENDELSESMEKANISME VED SERVICEVINDUE 13 G RESSOURCEOVERSIGT 14 G.3.2 EKSEMPEL PÅ XML 15 G.3.3 XSD-SKEMAER OG TEGNSÆT 15 G.3.4 KONFIGURATION AF WEBSERVICE 16 G.3.5 SIKKERHED 16 G.3.6 FREMSENDELSE AF TESTMEDDELELSE TIL SERVICEN SOM URL EN PEGER PÅ 17 G.3.7 OPERATIONER 18 G MODTAG EN FORSENDELSE 18 G.3.8 RESSOURCER 19 G MEDDELELSE 19 G VEDHAEFTNINGSAMLING 20 G VEDHAEFTNING 20 G.4 INTRODUKTION TIL AFSENDELSE AF POST VIA SYSTEMINTEGRATION 21 G.4.1 IDENTIFICER MYNDIGHEDEN SAMT POSTKASSE HVORTIL FORSENDELSEN SKAL LEVERES 22 G.4.2 OPERATION: HENT OVERSIGT MED KONTAKTBARE MYNDIGHEDER 22 G.4.3 RESSOURCE: MYNDIGHED 23 G.4.4 OPERATION: HENT KONTAKTHIERARKI FOR SPECIFIK MYNDIGHED 23 G.4.5 RESSOURCE: KONTAKTHIERARKI 24 G.4.6 RESSOURCE: POSTKASSEMAPPE 24 G.4.7 RESSOURCE: POSTKASSE 25 G.4.8 RESSOURCE: EMNE 26 G.4.9 RESSOURCE: FELT 26 G.5 AFSENDELSE AF POST VIA SIKKER 27 Digital post Snitflader / Integration for virksomheder / version 7.0 2

3 G.5.1 MANUEL PROCESS - ADRESSERING VIA TAGS 27 G AUTOMATISK INDSÆTTELSE AF REFERENCE TIL DEN MEDDELELSE DER BESVARES. 28 G.5.2 AUTOMATISK PROCES - ADRESSERING VIA VEDHÆFTET XML-FIL 28 G.5.3 KVITTERING FOR SUCCESFULD AFLEVERING (EPOSTFORSENDELSEKVITTERING) 29 EPOSTFORSENDELSEKVITTERING (VERSION 1) 30 G.5.4 FEJLKVITTERING (FEJL) 30 G.6 AFSENDELSE AF POST VIA REST BASERET WEBSERVICE 31 G.6.1 OPERATION: AFLEVER FORSENDELSE 31 G.6.2 RESSOURCE: FORSENDELSE 32 G.6.3 POSTKASSEMETADATA 32 G.6.4 VEDHAEFTNINGSAMLING 33 G.6.5 VEDHAEFTNING 33 Digital post Snitflader / Integration for virksomheder / version 7.0 3

4 Versionshistorik Version Udgivelsesdato Ændringer 7.0 Ændringer som følge af Digital Post 2. For ressourcen Emne er EmneType er ændret til EmneTypeNavn. DigitalPostMetadata er ændret til version 2 og MeddelelseKanBesvaresIndikator er tilføjet. 7.0 Beta Ændringer som følge af Digital Post 2. Ressourcen meddelese er opdateret så det fremgår hvorvidt den kan besvares. Afsnit er tilføjet som beskriver hvordan en virksomhed kan skrive til myndigheder via systemintegration. Afsnit omhandlende den fysiske størrelse på den Digitale Post er opdateret. Beskrivelse af metadata som tilføjes ved automatisk videresendelse er tilføjet. 6.4 Første udgivelse. Vejledningen er blevet til på baggrund af snitfladen REST Afhentningssystem, hvor alt vedrørende hvordan virksomheder kan modtage post fra indbakken via systemkald er flyttet til dette dokument. En beskrivelse af automatisk videresendelse er tilføjet. Digital post Snitflader / Integration for virksomheder / version 7.0 4

5 G.1 Introduktion Denne beskrivelse henvender sig til virksomheder, der har behov for at få overført digitale post fra deres digitale postkasse til egne systemer, heriblandt løsninger. Desuden beskrives den nye funktionalitet, som er introduceret med Digital Post 2, hvormed det er blevet muligt for virksomheder, at initiere og besvare henvendelser til myndigheder via systemkald. I forbindelse med introduktion af ny funktionalitet er flere ressourcer blevet opdateret. Eksisterende videresendelser vil naturligvis benytte de ressourcer der var gældende før idriftsættelse af den opdaterede løsning og som er beskrevet i dokumentsamlingen DigitalPost Snitflader version 6.3. I nærværende dokument er der versionsangivelse på den enkelte ressource og hvor man således kan se hvorvidt den er opdateret i forbindelse med Digital Post 2. G.1.1 Overblik over hvordan digital post kan tilgås Efter indførelse af obligatorisk Digital Post,vil alle virksomheder som udgangspunkt have en digital postkasse, hvortil post fra det offentlige bliver fremsendt. Det er virksomhedens ansvar at tilgå denne post. Nedenfor er vist en oversigt over de forskellige måder hvorpå jeres virksomhed kan vælge at tilgå den digitale post samt de fordele og begrænsninger der er ved hver løsning. Adgang til digital post Fordele og begrænsninger (A) Via virk.dk / e-boks.dk ved anvendelse af standardfunktionalitet Adgang til læse og besvare digital post. Opsætning af advisering når ny post ankommer. Opsætning af arkiveringsregler, der automatisk flytter posten til en mappe. Tildeling af begrænset / fuld adgang til eksterne brugere, eksempelvis revisor. Myndighedspåførte metadata er kun i begrænset omfang tilgængelige. (B) Via virk.dk / e-boks.dk ved anvendelse af udvidet funktionalitet Som standard plus Adgang til udvalgt post for udvalgte medarbejdere Kræver en postfordeler som fordeler posten (Tidligere begrænsning for eksterne brugere er udgået) (C) Via automatisk videresendelse og besvarelse/initiering til sikker Al post bliver videresendt til en konfigureret adresse (Standard tilstand) Post (al post/pr. mappe) bliver videresendt til en konfigureret e- mailadresse (udvidet tilstand) Posten bliver liggende i den digitale postkasse Digital post Snitflader / Integration for virksomheder / version 7.0 5

6 Standardmetadata såsom navnet på afsender er tilgængelig Myndighedspåførte metadata er tilgængelige i XML. Egenudviklede løsninger kan stå for videredistribution og journalisering på baggrund af eventuelle metadata. Det er muligt at besvare post via sikker mail og der kan ligeledes initieres meddelelser til myndigheder via sikker mail (oplysninger om myndigheder og postkasser kan hentes via systemintegration (D). (D) Via systemintegration, (REST/XML) Al post bliver videresendt til et konfigureret REST endpoint (Standard tilstand) Post (al post/pr. mappe) bliver videresendt til et konfigureret REST endpoint (udvidet tilstand) Posten bliver liggende i den digitale postkasse Standardmetadata og myndighedspåførte metadata er tilgængelige i XML. Egenudviklede løsninger kan stå for videredistribution og journalisering på baggrund af eventuelle metadata. Forsendelsestypen er alene tilgængelig i tekstform. Det er er operationer til at besvare, og initiere meddelelser og det er ligeledes muligt at hente oplysninger om myndigheder/postkasser. Formålet med denne vejledning er at uddybe mulighederne (C) og (D). Det skal bemærkes at uanset hvilken af disse integrationsformer der vælges forbliver posten i den digitale postkasse og det er muligt at på et senere tidspunkt at logge på virk.dk / e-boks.dk og tilgå den tidligere videresendte digitale post. Sammenfattet kan det opsummeres, at den primære forskel mellem mulighed (C) og (D) er hvorvidt integrationsformen rent teknisk sker via en løsning (S/MIME) eller via webservice (REST). Når der i denne vejledning refereres til virksomheder, inkluderer det også myndigheder, der optræder som slutbrugere og har behov for at tilgå deres digitale postkasse. G.1.2 Flow som en digital forsendelse gennemløber fra myndighed til slutbruger Hvad sker der fra en forsendelse forsøges afleveret af en myndighed til at den modtages af en virksomhed? Dette besvares lidt forsimplet i det følgende, baseret på videresendelse til en REST baseret webservice: 1. En myndighed ønsker at aflevere en forsendelse til en virksomhed og skal afgøre hvorvidt forsendelsen kan afleveres i virksomhedens digitale postkasse. Digital post Snitflader / Integration for virksomheder / version 7.0 6

7 2. Såfremt virksomheden ikke er fritaget kan myndigheden nu aflevere forsendelsen digitalt ved at angive CVR-nummeret på modtageren. Myndigheden kan vælge at påføre andre metadata såsom P-nummer samt eventuelt berige meddelelsen med egne sags-oplysninger såsom sagstype, dokumenttype, matrikelnummer eller nummerplade for blot at nævne nogle muligheder. 3. Forsendelsen modtages i virksomhedens digitale postkasse. Såfremt virksomheden har konfigureret at automatisk videresendelse eller systemintegration via webservice ønskes vil meddelelsen blive leveret som efterspurgt. 4. Her forudsættes, at virksomheden har konfigureret deres digitale postkasse til at al post skal forsøges afleveret til en webservice, som virksomheden selv udstiller. Hele forsendelsen inklusive vedhæftninger og metadata vil da blive forsøgt afleveret som en samlet operation. 5. Webservicen, som virksomheden udstiller, skal være i stand til at kunne modtage OIOXML ressourcen Meddelelse. Dette er et XML-dokument, der beskriver hele forsendelsen inklusiv hoveddokument samt eventuelle vedhæftninger og metadata. 6. Virksomheden eller dennes leverandør kan selv implementere logik, der gør det muligt at opsætte egne regler for håndtering, behandling og journalisering af post afhængig af oplysningerne, der er tilgængelige i forsendelsen. 7. Virksomheden eller dennes leverandør kan implementere logik, der gør det muligt at besvare en modtaget meddelelse. Metadata til brug ved besvarelsen er indeholdt i den modtagne meddelelse. G.1.3 Metadata (Attentionformat / Sagdokument) som myndigheden påfører Den afsendende myndighed kan vælge at berige en forsendelse med metadata. Dette kan ske via nedenstående to vedhæftede XML filer. Det er op til hver enkelt myndighed at vurdere om de vil anvende denne mulighed og i hvilket omfang. Det må forventes at omfanget løbende bliver udvidet. attention.xml. En vedhæftning som myndigheden kan vælge at vedlægge i forbindelse med aflevering af en meddelelse. Filen modsvarer attentionfeltet på et traditionelt fysisk brev. Det afhænger af den enkelte myndighed hvorvidt filen er medtaget samt hvad den indeholder. Filen kan bl.a. indeholde p-nummer via feltet ProductionUnitIdentifier. Filen indeholder OIOXML-ressourcen AttentionFormat. Bemærk, at filen ikke bliver skemavalideret i forbindelse med modtagelsen i digital post. Det er derfor vigtigt at den service som virksomheden udstiller, er i stand til at modtage en forsendelse på trods for, at denne fil ikke kan skemavalideres. Nedenfor fremgår opbygningen af ressourcen. Specielt skal det bemærkes, at det er muligt at angive en adresse på slutmodtageren samt at elementet AttentionObjektSamling kan indeholde vilkårlige nøgle-værdi-par, som den enkelte myndigheden tilbyder. Digital post Snitflader / Integration for virksomheder / version 7.0 7

8 Nedenfor er vist et fiktivt eksempel på hvordan XML kunne se ud. Eksemplet viser en henvendelse til Digitaliseringsstyrelsen hvor P-nummer er angivet samt ekstra metadata som beskriver indholdet af dokumentet. sagdokument.xml. En vedhæftning, som er beregnet til struktureret beskrivelse af indholdet af meddelelsen. Digital post anvendes blot som transportmedie og forholder sig ikke til indholdet af denne fil. Filen indeholder OIOXML-ressourcen Sagdokument. Det skal bemærkes at filen ikke er blevet skemavalideret ved modtagelse i digital post og virksomhedens service, der modtager en forsendelse, ikke må fejle på trods for at filen ikke kan skemavalideres. Ovenstående metadata vil være tilgængelig uanset om der vælges automatisk videresendelse eller meddelelsen afleveres via webservice. Det er muligt at læse mere om ovenstående på digitaliseringsstyrelsens hjemmeside. Området benævnes under et for Attentionformat. Digital post Snitflader / Integration for virksomheder / version 7.0 8

9 G.1.4 Fysisk størrelse på post Digital post vil som udgangspunkt ikke overstige nedenstående begrænsninger. Samlet størrelse på meddelelser fra en myndighed. Størrelsen af hoveddokument + vedhæftninger (incl. metadata) kan være på op til 99,5 Megabyte. Såfremt virksomheden har opsat videresendelse via sikker vil det kun være meddelelser op til 10 Megabyte der videresendes. Hvis meddelelsen overstiger dette bliver der i stedet fremsendt en meddelelse om at en stor forsendelse er tilgængelig via slutbrugergrænsefladen. Virksomheder der har opsat videresendelse via REST skal være forberedt på at kunne modtage op til 99,5 Megabyte. Maksimale størrelse på en forsendelse til en myndighed. Myndighederne kan konfigurere hvor store forsendelser de vil tillade at modtage. Som udgangspunkt er grænsen 10 Megabyte, men hver enkelt myndighed har mulighed for at hæve denne grænse individuelt per postkasse. Det betyder at ved henvendelse til en myndighed hvor der er behov for at aflevere mere end 10 Megabyte skal det via et systemkald på forhånd afgøres hvorvidt myndigheden tillader det. Myndigheden kan maksimalt tillade 99,5 Megabyte. (se Postkasse. PostkasseIndholdStørrelseMaal for detaljer). Maksimale antal vedhæftninger - 10 vedhæftninger. Metadatafiler, som også er vedhæftninger, er inkluderet i denne grænse. Bemærk, at dertil kommer at både kryptering og signering af et dokument forøger størrelsen med ca. 1/3 hver. Det betyder at det antal bytes, der modtages vil være noget større som følge heraf (78%). Ved modtagelse via XML er indholdet yderligere base64 indkodet hvilket igen forøger størrelsen med ca. 1/3. Dette kan have betydning for opsætning af REST endpoint respektive konfiguration af konti. På et REST endpoint skal man således kunne modtage meddelelser på 99,5 Megabyte plus base64 indkodning og kryptering. G.1.5 Konfiguration slår igennem for både offentlige og private afsendere Virksomhedens digitale postkasse kan tilgås både fra virk.dk under digital post og/eller via e- Boks. Uanset hvorfra virksomhedens digitale postkasse tilgås, er det den samme postkasse, der konfigureres. Med andre ord slår konfigurationen igennem begge steder uanset hvorfra konfigurationen sker og vil virke for både post fra offentlige afsendere såvel som private afsendere virksomheden har tilmeldt sig. G.2 Videresend post som sikker G.2.1 Indholdet der fremsendes Digital post som afleveres til en digitale postkasse, der har opsat automatisk videresendelse til en adresse, vil blive forsøgt videresendt til den angivne adresse. en der fremsendes har følgende karakteristika: Afsenderen er indgaaende@prod.e-boks.dk Af emnefeltet fremgår navnet på den afsendende myndighed samt titlen på meddelelsen. Med henblik på at afhjælpe manuel fordeling af posten, indsættes der i starten af e- mailen metadata der beskriver forsendelsen. Dette vil blandt andet være oplysninger Digital post Snitflader / Integration for virksomheder / version 7.0 9

10 som afsenderen har beriget meddelelsen med via attention.xml som er udtrukket og oplyst i tekstform. Eksempel: Automatisk videresendt meddelelse fra Digital Post Afsender af meddelelsen: #AfsenderNavn# Meddelelsen blev modtaget: 22-08/2013 KL Videresendt fra postkasse tilhørende:#cvr-nr + #ProfilNavn# P-nummer: Organisationsenhed: Attention person: adresse: [DKAL attention metadata] Oprindelig meddelelse fremgår nedenfor Kære byggeansvarlige Hvis hoveddokumentet ikke er formateret som HTML eller ren tekst vil det være vedlagt som en vedhæftning, med navnet message.pdf. Samtlige vedhæftninger vil være vedlagt. Automatiske påførte metadata vil være tilstede i struktureret form via XML fil som altid påføres. Indholdet af denne fil beskriver forsendelsen, heriblandt tidspunkt hvor den er modtaget samt afsenderen. Eventuelle påhæftede metadata fra myndigheden, dvs. attentionformattet (attention.xml) og/eller oplysninger om sagen (sagdokument.xml), vil være vedlagt. Digital post Snitflader / Integration for virksomheder / version

11 G.2.2 Konfiguration af automatisk videresendelse I den digitale postkasse, hvad enten den tilgås fra virk.dk eller e-boks.dk, under indstillinger vælges menupunktet Systemintegration. Herfra kan vælges Opret videresendelse hvorved nedenstående skærmbillede fremkommer. Ovenfor skal angives den adresse hvortil post skal videresendes samt uploades det tilhørende certifikat. Videre skal det angives hvilken version af snitflade man ønsker at benytte. G.2.3 Genudsendelsesmekanisme Ved automatisk videresendelse af en forsendelse via , hvor modtagerens system ikke svarer, gentages forsøg på forsendelse efter følgende genudsendelsesmønster. Første genudsendelse efter 3 min. Anden genudsendelse efter 10 min Tredje genudsendelse efter 20 min Herefter forsøges genudsendt efter 30 min og efterfølgende hver 10 minut i 10 timer. Herefter oprettes en notifikation i slutbrugergrænsefladen om at meddelelse ikke kan sendes og der foretages ikke yderligere. Digital post Snitflader / Integration for virksomheder / version

12 Bemærk, virksomheden angiver ved opsætning af videresendelse, hvorvidt det modtagende e- mail system kvitterer for modtagelse. G.2.4 Automatisk påførte metadata Forsendelsen bliver automatisk beriget med nedenstående metadata. Dette sker via XML-fil der vedhæftes. Filen har navnet DigitalPostMetadata.XML og indholdet fremgår nedenfor. DigitalPostMetadata (version 2) Formål Indeholder metadata om forsendelsen. X ud for et felt angiver at feltet altid vil være udfyldt. Et XSD skema, der beskriver ressourcen og de enkelte felter kan findes på digitaliser.dk X MeddelelseIdentifikator Identificerer entydigt meddelelsen. X MeddelelseAfsenderNavn Navn på den myndighed der har afsendt den digitale meddelelse. MeddelelseAfsenderCVRnummerI dentifikator CVR-nummeret på myndigheden der afleverede meddelelsen. X ModtagelseDatoTid Angiver tidspunktet hvor meddelelsen blev modtaget i slutbrugerens digitale postkasse. X MeddelelseTraadIdentifikator Alle meddelelser bliver tildelt en dialogtråd af Digital post. MeddelelseTidsfristDato MeddelelseTidsfristTekst ModtagerProfilNavn Dato der angiver at der er en tidsfrist forbundet med meddelelsen. Et notat som afsender kan tilknytte til afsendelsen til at beskrive tidsfristen. Profilnavn på den digitale postkasse der er videresendt fra. X ModtagerIdentitet CVR-nummer den digitale postkasse som meddelelsen af afleveret i. TilmeldingsgruppeNavn TilmeldingsgruppeIdentifikator Tekstuel beskrivelse af den tilmeldingsgruppe der ligger til grund for forsendelsen. Identifikation af den tilmeldingsgruppe som ligger til grund for forsendelsen. X MeddelelseKanBesvaresIndikator Angiver hvorvidt denne meddelelse kan besvares. Dette kræver at den afsendende myndighed har opsat mulighed herfor. Digital post Snitflader / Integration for virksomheder / version

13 G.3 Videresend post til REST baseret webservice Ved integration via webservice skal virksomheden udstille en REST baseret webservice, som vil blive kaldt når der er ny post til virksomheden. Myndigheden/virksomheden kan således via et eksternt system løbende modtage meddelelser. I det følgende beskrives hvordan levering kan garanteres samt information om de data der udveksles. G Kvittering for modtagelse / idempotent Hvis en meddelelse afleveres til den angivne URL og servicen som URL en peger på modtager meddelelsen, men det succesfulde retursvar ikke når at blive returneret på grund af tekniske problemer, vil meddelelsen blive forsøgt leveret igen indtil servicen returnerer med et positivt retursvar. I ovenstående situation er det afgørende, at servicen på trods for at meddelelsen tidligere er modtaget succesfuldt returnerer med en succesfuld bekræftelse for modtagelsen igen (httpstatuskode 200). Dette designprincip kaldes idempotent og er medvirkende til at garantere sikker levering. G Genudsendelsesmekanisme ved servicevindue Hvis den service som URL en peger på af en eller anden grund ikke svarer, eksempelvis som følge af et servicevindue, så starter følgende genudsendelsesmekanisme. 1. Det første døgn forsøges meddelelsen afleveret med en høj gentagelsesfrekvens. 2. Fra dag 2. optræder en advarsel såfremt en bruger logger på løsningen, som informerer om at levering ikke var mulig. 3. Fra dag 2. og til og med dag 30. forsøges meddelelsen genleveret en gang i døgnet. Der bliver samtidig udsendt en til den adresse der er angivet på afhentningssystemet i forbindelse med opsætning, som informerer om problemet. 4. Dag 31. Levering opgives og der advares herom ved logon på løsningen. I denne situation vil der optræde en knap genudsend som gør det muligt at bestille en genudsendelse. Alle meddelelser, der ikke er modtaget en succesfuld kvittering for ved aflevering, vil da blive forsøgt genleveret i løbet af de kommende 24 timer. Digital post Snitflader / Integration for virksomheder / version

14 G Ressourceoversigt Ressourcer er OIOXML dataobjekter der udveksles. Nedenstående oversigt beskriver de forskellige OIOXML ressourcer der indgår og deres sammenhæng. Servicen modtager en Meddelelse som kan indeholde vedhæftninger. MeddelelseReferenceSamling Meddelelse MeddelelseFESDmetadata VedhaeftningSamling PostkasseMetadata Signaturbevis Vedhaeftning AfsenderMetadata Ressourcer er rodobjekter i modsætning til typer som skal inkluderes i andre rodobjekter. Ressourcer er vist med fuldt optrukken kant, og typer er vist med stiplet kant. En reference fra en ressource til en anden ressource er vist med en fuldt optrukken pil. En stiplet pil viser at en type eller ressource er inkluderet som en del af en anden type eller ressource. Samtlige ressourcer og typer har tilknyttet et XSD skema. Indholdet af hver ressource og type, dvs. de enkelte XML elementer, fremgår af en tabel i det følgende. Det er ikke alle ressourcer der er tilgængelige når meddelelsen modtages som slutbruger. De pågældende ressourcer er nævnt nedenfor. Meddelelse Indeholder information om en meddelelse, heriblandt afsender, titel, modtagelsestidspunkt, selve det binære indhold samt evt. vedhæftninger og deres indhold. VedhaeftningSamling Beskriver en liste af vedhæftninger Vedhaeftning Beskriver en vedhæftning, heriblandt titel, format, samt en reference til det binære indhold. Specielt vil de nævnte metadata optræde som vedhæftede filer. Digital post Snitflader / Integration for virksomheder / version

15 G.3.2 Eksempel på XML Nedenfor er vist et eksempel på XML, som vil kunne blive afleveret til servicen. G.3.3 XSD-skemaer og tegnsæt XML en der udveksles er underlagt OIOXML standarden. Denne standard har til formål at ensarte navngivningen af felter der indgår XML en der udveksles samt stiller krav til genbrug af tidligere specifikationer i det om fang de findes og er dækkende. Den OIOXML ressource, der leveres til servicen er navngivet meddelelse og er underlagt et XSD skema som er tilgængeligt på digitaliser.dk: Indholdet af brevet samt indholdet af hver vedhæftning er base64 encoded. Alle XML dokumenter der afleveres skal være encoded i UTF8. Alle tekster må uanset hvilken encoding der er anvendt kun indeholde karakterer, som er indeholdt i ISO (Latin-1, Western European). For samtlige snitflader forudsættes at indholdet af meddelelser, dokumenter og vedhæftninger, hvor filtypen (FilFormatNavn) er TXT og HTM, er encoded i ISO Digital post Snitflader / Integration for virksomheder / version

16 G.3.4 Konfiguration af webservice I den digitale postkasse, hvad enten den tilgås fra virk.dk eller e-boks.dk, under indstillinger vælges menupunktet videresendelse. Herfra kan vælges Opret afhentningssystem hvorefter nedenstående skærmbillede fremkommer. Oplysninger der skal angives til konfigurationen: 1. URL: angiver end point på den service, der skal kaldes. 2. Kontaktoplysninger: specielt anvendes adressen til at informere om problemer med aflevering til servicen. Det er vigtigt at holde adressen under kontaktoplysninger opdateret, da den anvendes til at orientere om post ikke kan afleveres. G.3.5 Sikkerhed Webservicen skal være konfigureret til at anvende HTTPS. Servicen bør validere klientcertifikatet, dvs. sikre at det er e-boks der foretager kaldet, og at alle andre der måtte kalde ignoreres. Digital post Snitflader / Integration for virksomheder / version

17 G.3.6 Fremsendelse af testmeddelelse til servicen som URL en peger på Under udvikling i integrationstestmiljøet er det muligt at foretage testforsendelser via knappen test. Herved vil en testmeddelelse blive forsøgt leveret til den service URL en peger på, og httpstatuskoden, der blev returneret, vil fremgå så snart den er tilgængelig. Digital post Snitflader / Integration for virksomheder / version

18 G.3.7 Operationer Servicen, som virksomheden udstiller, skal kunne håndtere følgende kald. G Modtag en forsendelse URL konfigureret i den digitale postkasse Formål PUT Anvendes af virksomheder til at modtage meddelelser via systemkald fra deres indbakke. Virksomheden skal udstille en service der overholder følgende. Idempotent Hver meddelelse kan unikt identificeres via MeddelelseURLreference som er defineret i meddelelsen. Såfremt den samme meddelelse modtages flere gange er det afgørende at der ved efterfølgende modtagelse returneres med http status koden 200 som angiver succesfuld modtagelse, idet forsendelsen ellers vil blive forsøgt leveret igen og igen via genudsendelsesmekanismen. Input content (OIOXML) Meddelelse Ressourcen, der er afleveret i virksomhedens digitale postkasse som forsøges afleveret. Http svar 200 Succes. Skal returneres efter at data er persisteret lokalt og tjener som afslutning på transaktionen. Digital post Snitflader / Integration for virksomheder / version

19 G.3.8 Ressourcer Samtlige ressourcer for funktionsområdet er dokumenteret i det følgende. Hver ressource modsvares af et XSD skema af samme navn. G Meddelelse Meddelelse (version 2) Formål RESSOURCE Ressourcen indeholder informationer om en meddelelse heriblandt dokumenter og NemSMS er. R MeddelelseIdentifikator Reference til meddelelsen. Anvendes ved besvarelse. R MeddelelseTypeNavn Vil altid være Meddelelse. R AfsenderNavn Afsenderens navn. R Signaturbevis Ikke udfyldt. R MeddelelseServicebeskedTekst Ikke udfyldt. R MeddelelseTitelTekst Emnet som henvendelsen drejer sig om. R MeddelelseIndholdData Selve det binære indhold af meddelelsen indkodet i Base64 formatet. R FilformatNavn Angiver formatet af meddelelsens indhold. R IndholdsdataStoerrelseMaal Størrelsen på indholdet af meddelelsen i kilobytes før Base64 encoding. R MeddelelseTraadIdentifikator Ikke udfyldt. R MeddelelseModtagetDatoTid Modtagelsestidspunktet. R VedhaeftningSamling Liste af vedhæftninger. R PostkasseMetadata Ikke udfyldt. R MeddelelseFESDmetadata Ikke udfyldt. R MeddelelseTidsfristDato En dato som angiver at der er en tidsfrist forbundet med meddelelsen. R MeddelelseTidsfristTekst Et notat som afsender kan tilknytte til afsendelsen. Eksempelvis til at beskrive tidsfristen. R MeddelelseKanBesvaresIndikator Angiver hvorvidt den afsendende myndighed tillader at denne meddelelse kan besvares. Digital post Snitflader / Integration for virksomheder / version

20 R KorrelationIdentifikator Ikke udfyldt G VedhaeftningSamling VedhaeftningSamling (version 1) Formål TYPE Typen indeholder en liste informationer om vedhæftede dokumenter eller bilag. Indeholder en liste af typen Vedhaeftning G Vedhaeftning Vedhaeftning (version 1) Formål TYPE Typen indeholder information om en vedhæftning, inklusiv reference til selve indholdet et dokument eller bilag. R VedhaeftningNavn Navnet på dokumentet. File extension fremgår af FilformatNavn. R VedhaeftningIndholdData Selve indholdet af vedhæftningen indkodet i Base64 formatet. R FilformatNavn Angiver formatet på vedhæftningens indhold. Formatnavnet er endelsen af det filnavn, som man ville give indholdet skulle det gemmes som en fil. F.eks. pdf, docx. R IndholdStoerrelseMaal Størrelsen af filen i kilobytes før Base64 encoding. R MIMEcontentIdentifikator Vedhæftninger i en S/MIME afsendelse bliver tildelt en MIME Content-ID, således at der i teksten i afsendelsen kan refereres til vedhæftninger, f.eks. ved indlejring af billeder i teksten. For at kunne genskabe denne afsendelser med indlejrede vedhæftninger, bliver Content-ID bevaret og er tilgængelig via dette felt. R R VedhaeftningOprindelig AfsenderNavn VedhaeftningOprindelig ModtagetDatoTid Ikke udfyldt. Ikke udfyldt. Digital post Snitflader / Integration for virksomheder / version

21 R VedhaeftningOprindelig AfsenderCVRnummer Identifikator Ikke udfyldt. G.4 Introduktion til afsendelse af post via systemintegration Med Digital Post 2 er det blevet muligt for virksomheder at skrive og besvare meddelelser til det offentlige via systemintegration fra egne systemer. I det følgende skelner vi imellem hvorvidt det er virksomheden eller myndigheden der initierer kommunikationen. I tilfælde af at det er virkomheden omtales det i det følgende at virksomheden initierer en forsendelse. Hvis det er myndigheden der starter kommunikationen, så kan virksomheden vælge at besvare meddelelsen. Bemærk at en meddelelse alene kan besvares hvis myndigheden har valgt at tilbyde dette på fremsendelsestidspunktet. For at virksomheden på forhånd kan afgøre hvorvidt meddelelsen er besvarbar er det nødvendigt at se på det nye felt MeddelelseKanBesvaresIndikator i metadata for den fremsendte meddelelse. Nedenfor fremgår de trin der er påkrævet for at en virksomhed bliver i stand til at aflevere forsendelser til en myndighed fra egne systemer. Hvert enkelt trin uddybes efterfølgende: 1. Opsæt systemintegration. Virksomheden skal via slutbrugergrænsefladen på virk.dk eller i e-boks.dk konfigurere at den ønsker at aflevere forsendelser via eksterne systemer samt hvilken type af integration der ønskes sikker eller REST. 2. Ved initierende henvendelser identificer myndigheden og postkassen hvortil forsendelsen skal afleveres. Hvis der er tale om at virksomheden ønsker at initiere en henvendelse skal virksomheden indledningsvist identificere hvilken myndighed samt hvilken postkasse hos myndigheden som henvendelsen skal adresseres til. Dette sikre at forsendelsen bliver afleveret til den rette afdeling hos myndigheden på lige fod med at virksomhedsbruger på virk.dk eller i e-boks.dk valgte en postkassen og rettede henvendelse fra slutbrugergrænsefladen. 3. Aflever forsendelsen. Dette kan ske på følgende måder: Enten a. Via sikker fra egen klient, eller b. Via xml fra egen web service. Digital post Snitflader / Integration for virksomheder / version

22 G.4.1 Identificer myndigheden samt postkasse hvortil forsendelsen skal leveres I forbindelse med at en virksomhed ønsker at initiere en henvendelse til en myndighed skal virksomheden vælge en postkasse hvortil forsendelsen skal afleveres. Konkret er der behov for at identificere den postkasse og eventuelt det emne henvendelsen vedrører for den aktuelle myndighed. Nedenfor beskrives hvordan dette sker i praksis ved at udføre REST kald: 1. Kald operation der returnerer oversigt over kontaktbare myndigheder. 2. Kald operation der returnerer kontakthierarki for den aktuelle myndighed. Af svaret kan nedenstående udledes: a. Find den relevante postkasse fra det modtagne kontakthierarki. b. Hvis postkassen har tilknyttet en valgliste af emner så vælg det emne der bedst beskriver hvad henvendelsen vedrører. Bemærk at myndigheder på postkassen kan kræve at et emne skal vælges i forbindelse med at de kontaktes. c. Hvis emnet har tilknyttet metadata kan det være påkrævet at angive disse i forbindelse med henvendelsen. Der kan maksimalt være to metadatafelter som myndigheden kræver udfyldt. d. Specielt kan der være tilknyttet en formular til den valgte postkasse / emne. I givet fald er det alene muligt at rette henvendelse hertil via slutbrugergrænsefladen eftersom formularer ikke kan besvares / skrives til via systemkald. G.4.2 Operation: Hent oversigt med kontaktbare myndigheder /afsendersystem/{sysid}/myndigheder Formål Input parametre GET Operationen giver via systemkald adgang til en oversigt over kontaktbare myndigheder. Et efterfølgende kald vil give adgang til deteljer for en specifik myndighed. Sysid Angiver id på virksomhedens / myndighedens afsendersystem som findes via slutbrugergrænsefladen. Output content (OIOXML) Myndighed Samling Samling af ressourcen Myndighed. Indeholder en komplet oversigt over kontaktbare myndigheder. Fejlkoder (udover de generelle) Digital post Snitflader / Integration for virksomheder / version

23 G.4.3 Ressource: Myndighed Myndighed (version 1) Formål Anvendes i oversigten med kontaktbare myndigheder. TYPE R MyndighedIdentifikator Identifikation af myndigheden som anvendes ved efterfølgende kald der henter detaljer. R MyndighedNavn Angiver navn på myndighed. G.4.4 Operation: Hent kontakthierarki for specifik myndighed /afsendersystem/{sysid}/kontakthierarki/{myndighedsid} Formål GET Operationen giver via systemkald adgang til myndighedens komplette kontakthierarki. Samtlige postkasser inklusiv deres placering i mappestrukturen fremgår. Konfigurationsindstillinger for hver enkelt postkasse er ligeledes tilgængelig. Svartid Svartiden vil være proportional med antallet af data der er oprettet. En myndighed med sammenlagt 20 postkasser vil i 96% af kaldene opleve en svartid på under 10 sekunder. Input parametre Sysid Angiver id for virksomhedens / myndighedens afsendersystem som findes via slutbrugergrænsefladen. myndighedsid Identifikation af myndigheden via MyndighedIdentifikator fra tidligere kald. Output content (OIOXML) KontaktHierarki Komplet mappe- og postkassestruktur for hele myndigheden. Fejlkoder (udover de generelle) Digital post Snitflader / Integration for virksomheder / version

24 G.4.5 Ressource: KontaktHierarki RESSOURCE KontaktHierarki (version 2) Formål Adgang til konfigurationen af myndighedens kontakthierarki. R PostkasseMappeSamling Samling af postkassemapper. R PostkasseSamling Samling af postkasser. G.4.6 Ressource: PostkasseMappe PostkasseMappe (version 2) Formål Konfigurationsindstillinger for en postkassemappe. TYPE R PostkasseMappeNavn Navnet på mappen. R PostkasseMappeSamling Samling af postkassemapper. Dvs. eventuelle undermapper. R PostkasseSamling Samling af postkasser. Digital post Snitflader / Integration for virksomheder / version

25 G.4.7 Ressource: Postkasse Postkasse (version 2) Formål Adgang til konfigurationsindstillinger via systemkald. TYPE R PostkasseIdentifikator Entydig angivelse af postkassen. R PostkasseNavn Navnet på Postkassen. R PostkasseStandardIndikator Angiver hvorvidt postkassen er myndighedens standardpostkasse. En myndighed kan have een standardpostkasse. I denne situation behøver slutbrugeren ikke at vælge en postkasse. R R PostkassePaakraevetEmne Indikator PostkasseStandardEmne Identifikator Angiver hvorvidt slutbrugeren skal vælge emne når der rettes henvendelse via postkassen. Indtastningsfelter og nøgleord kan tilknyttes direkte på postkassen. Hertil anvendes standardemnet. Se forklaring under ressourcen emne. R PostkasseEmneSamling Samling af Postkasse Emner. R PostkasseIndholdStørrelseMaal Angiver det maksimale antal bytes der kan sendes til postkassen. Konkret betyder det at summen af indholdet for hovedokument og vedhæftninger ikke må overstige dette antal. Normalt er grænsen 10 Megabyte, men myndigheden kan vælge at sætte grænsen op. Digital post Snitflader / Integration for virksomheder / version

26 G.4.8 Emne (version 2) Formål Ressource: Emne TYPE En postkasse kan have tilknyttet emner. Når virksomheden retter henvendelse via postkassen kan/skal (afhænger af opsætning) virksomheden angive et emne. Standard Emne Emner gør det muligt for myndigheden at tilknytte indtastningsfelter som virksomheden skal udfylde i forbindelse med at der rettes henvendelse. Indtastningsfelter kan også være påkrævet uden at et emne er valgt såfremt postkassens standardemne har tilknyttet indtastningsfelter. R PostkasseEmneIdentifikator Entydig angivelse af emnet. R EmneNavn Angiver navnet på emnet. R EmneFeltSamling En samling af indtastningsfelter på en postkasse eller på et postkasseemne. R EmneTypeNavn Mulige værdier Tekst. Angiver at svaret er tekstbaseret og kan foretages via systemintegration. Formular. Angiver at svaret kræver udfyldelse af en formular, hvilket ikke er muligt via systemintegration. Dette kræver indlogning i slutbrugergrænsefladen. G.4.9 Felt (version 2) Formål Ressource: Felt TYPE En postkasse og/eller postkasseemner kan tilknyttes indtastningsfelter som slutbrugeren kan/skal udfylde i forbindelse med at der initieres en henvendelse via postkassen/emnet. Konfigurationsindstillinger for et felt fremgår her. R FeltNavn Beskriver et indtastningsfelt. Indtastningsfelter tilknyttes en postkasse eller et postkasseemne. R FeltESDHnavn Denne værdi skal anvendes til referere feltet ved system kald. R FeltPaakraevetIndikator Angiver hvorvidt det er påkrævet at en slutbruger udfylder feltet i forbindelse med at vedkommende retter henvendelse via dette Digital post Snitflader / Integration for virksomheder / version

27 emne. G.5 Afsendelse af post via sikker Med Digital Post 2 er det blevet muligt for virksomheder at skrive og besvare meddelelser til det offentlige via sikker fra egen mailklient. Det forudsætter at virksomheden har opsat systemintegration via sikker . Der skelnes imellem 2 typer af integration for sikker e- mail. 1. Manuel process: Angivelse af tags i selve mailen, eller 2. Automatisk process: Vedhæftning af Xml fil der beskriver hvortil posten skal afleveres. I begge tilfælde skal virksomheden signerer med det certifikat der blev angivet under opsætningen. Virksomheden skal anvende e-boks OCES certifikat til kryptering. Det kan hentes via LDAP samt via slutbrugergrænsefladen. G.5.1 Manuel process - adressering via tags For virksomheder, hvor forsendelser ønskes håndteret direkte i en standard mailklient er dette muligt, såfremt mailklienten (eller en del af infrastrukturen) understøtter S/MIME formatet. Konkret kan dette ske ved at virksomheden tilføjer specielle tags i starten af meddelelsen som beskrevet i det følgende. For at Digital Post kan finde disse tags må der ikke være formateringer i tag et. Dette vil blive tolket som en fejl. 1. Såfremt der er tale om en besvarelse skal den oprindelige meddelelse der besvares fremgå af svaret. Konkret gøres dette ved i svaret at angive ##OriginalMeddelelseIdentifikator=x## hvor x referere MeddelelseIdentifikator på den meddelelse der besvares. Hvis ikke denne er angivet vil det blive opfattet som en ny henvendelse initieret af virksomheden. Se efterfølgende afsnit for hvordan dette tag kan blive indsat automatisk. 2. Såfremt der er tale om initiering af en ny dialog med en myndighed skal meddelelsen adresseres til den korrekte afdeling hos myndigheden. Dette sker ved på forhånd at identificere myndighedens postkasse samt eventuelt vælge et foruddefineret emne for denne postkasse. a. Angiv postkasse ##PostkasseId=xxxx## b. Angiv emne ##EmneId=xxxx## 3. Myndigheden kan have opsat at en postkasse kræver ekstra metadata i forbindelse med en henvendelse. Disse kan være påkrævede, og skal i givet fald udfyldes forud for Digital post Snitflader / Integration for virksomheder / version

28 aflevering. I et tænkt eksempel kan nævnes matrikelnummer. Da vil tagget ##Metadata Matrikelnummer=[feltværdi]## skulle tilføjes hvor værdien Matrikelnummer kommer fra FeltESDHnavn i forbindelse med at man har hentet information om postkassen via REST (se ressource G.4.7-G.4.9). I [feltværdi] indsættes den aktuelle værdi. I det beskrevne eksempel med matrikelnummer kunne værdien være 2948 og den indsatte linje ville dermed være ##Metadata Matrikelnummer=2948##. Hvorvidt et felt skal angives i forbindelse med henvendelse til en postkasse, fremgår af egenskabsbeskrivelsen i ressourcen Felt (G.4.9). Egenskaben FeltPaakraevetIndikator angiver om feltet skal angives. Hvorvidt en meddelelse kan besvares afgør den afsendende myndighed på afsendelsestidspunktet. Dette vil fremgå af den meddelelse der modtages via feltet MeddelelseKanBesvaresIndikator 4. Emnefeltet bliver anvendt som titel på meddelelsen. Tag et [Ref.nr] fjernes automatisk såfremt det fremgår af svaret. Vær opmærksom på at emnefeltet ikke nødvendigvis bliver krypteret, hvorfor det bør det undlades at skrive følsomme oplysninger i dette felt. 5. Selve indholdet af meddelelsen SKAL tilføjes til body, ligesom eventuelle vedhæftninger KAN tilføjes. 6. Fremsend den signerede og krypterede til indgaaende@prod.e-boks.dk. Såfremt den fremsendte S/MIME forsendelse indeholder beskeden i flere formater er det kun et format der præsenteres for myndigheden. Såfremt flere formater er til stede i en forsendelsen udvælges en efter følgende prioritet: Html, Rich Text Format, Text. En afsendelse via Outlook indeholder eksempelvis både meddelelsen i en tekst og html udgave. Da HTML har højere prioritet vil denne udgave blive valgt og videresendt til myndighedens digitale postkasse. G Automatisk indsættelse af reference til den meddelelse der besvares. Hvis virksomheden ønsker at anvende den manuelle process kan det tag der angiver den originale meddelelse der besvares med fordel blive indsat automatisk indsættes. Virksomheden kan konfigurere dette i slutbrugergrænsefladen under systemingtegration under videresenelse via , ved at sætte kryds i Indsæt reference til original besked. Dette vil betyde at den meddelelse der afleveres vil få indsat ##OriginalMeddelelseIdentifikator## automatisk. Herved bliver det muligt at trykke besvar direkte i mailklienten, da svaret nu vil indeholde en reference til den besked der besvares. G.5.2 Automatisk proces - adressering via vedhæftet xml-fil Hvis virksomheden ønsker at anvende den automatiske proces slipper medarbejderne for at skulle indsætte tags, i stedet skal der vedhæftes en fil med navnet EpostForsendelseMetadata.xml. Formatet på denne fremgår nedenfor. Digital post Snitflader / Integration for virksomheder / version

29 EpostForsendelseMetadata (version 1) Formål TYPE Indeholder information om hvortil forsendelsen skal adresseres samt det fysiske brev, eventuelt inklusiv vedhæftninger. C SystemIdentifikator Refererer det afsendersystem som meddelelsen er blevet sendt via. C MeddelelseIdentifikator Identifikator for afsendelsen. Afsendersystemet har ansvaret for at generere id der er globalt unikke på tværs af alle afsendersystemer. Se afsnittet MeddelelsesIdentifikator i Digital post - Snitflade for detaljer om formatet. C PostkasseMetadata Ved initiering af en ny henvendelse fremgår her den myndighed samt postkasse der rettes henvendelse til. Bemærk at myndigheden eventuelt kan kræve at et emne og eventuelle indtastningsfelter er udfyldt. C OriginalMeddelelseIdentifikator Ved besvarelse fremgår her MeddelelsesIdentifikator fra den besked der besvares. G.5.3 Kvittering for succesfuld aflevering (EpostForsendelseKvittering) For at give virksomheden sikkerhed for, at forsendelsen er nået frem og blevet accepteret af Digital post, returnerer Digital post en kvittering. Kvitteringen indeholder både en tekstuel beskrivelse, som er beregnet til en manuel proces, samt en vedhæftet XML fil, som er beregnet til automatisk behandling. Kvitteringen sendes som en sikker e-post forsendelse til den adresse der blev anvendt til at aflevere forsendelsen. Kvitteringen er signeret med Digital Post s certifikat og krypteret med det certifikat som virksomheden har angivet i slutbrugergrænsefladen. Disse kvitteringer identificeres ved at der i emnefeltet står Kvittering: efterfulgt af det samme som stod i den meddelelse der kvitteres for (vær dog opmærksom på at indholdet i [Ref.Nr.=xxx] udskiftes hvis angivet). Kvitteringen indeholder en ID som reference til den afsendelse, der kvitteres for. Kvitteringen har følgende indhold i sin body hvor navn og id henholdsvis vil være navnet på postkassen/emnet og id den identificere postkassen og emnet. ##DKALForsendelseKvittering## ##SysId=43## ##MeddelelseId= ## ##Postkasse=Navn(Id)## ##Emne=Navn(Id)## Digital post Snitflader / Integration for virksomheder / version

30 Den vedhæftet fil har navnet EpostForsendelseKvittering.xml, og indeholder de samme oplysninger i XML. Et eksempel er vist nedenfor: <EpostForsendelseKvittering xmlns="urn:oio:dkal:2.0.0"> <SystemIdentifikator>43</SystemIdentifikator> <MeddelelseIdentifikator> </MeddelelseIdentifikator> <PostkasseMetadata> <PostkasseIdentifikator>12</PostkasseIdentifikator> </PostkasseMetadata> <AfsendelseDatoTid> T12:34:56</AfsendelseDatoTid> </EpostForsendelseKvittering> EpostForsendelseKvittering (version 1) Formål Indeholder informationer om den forsendelse, der kvitteres på. SystemIdentifikator (SysId) MeddelelseIdentifikator (MeddelelseId) PostkasseMetadata OriginalMeddelelseIdentifikator AfsendelseTidspunktDatoTid Refererer det afsendersystem som meddelelsen er blevet sendt via. Refererer meddelelsen der kvitteres for. Angiver den MeddelelseId den oprindelige meddelelse havde / fik tildelt. Ved initiering af en ny dialog fremgår her den postkasse der er rettet henvendelse til. Ved besvarelse fremgår her den besked der er besvaret. Tidspunktet hvor den oprindelige meddelelse der kvitteres for blev afsendt. G.5.4 Fejlkvittering (Fejl) I tilfælde af at en forsendelse ikke kan afleveres til myndigheden sendes en fejlkvittering retur til den adresse hvorfra afsendelsen fandt sted. Dette sker altid og kræver ingen opsætning. Fejlkvitteringer kan identificeres ved at emnefeltet starter med teksten Fejlkvittering:. Selve fejlen er beskrevet både tekstuelt samt via en vedhæftet XML fil. Se snitfladens bilag A5 for en beskrivelse af mulige fejlkoder. Vedhæftningen er beskrevet via skemaet Fejl.XSD som ligeledes er uddybet i det nævnte bilag. Fejlskemaet findes i en version 2 som altid vil blive anvendt i denne situation. Heraf fremgår årsagen til at forsendelsen ikke kunne afleveres. Reference til den forsendelse der fejlede findes via feltet EpostForsendelseKvittering, der indeholder de samme oplysninger som ved en succesfuld aflevering. Digital post Snitflader / Integration for virksomheder / version

31 Nedenfor ses et eksempel på en fejlkvittering. <?xml version="1.0" encoding="utf-8"?> <Fejl xmlns:xsi=" xmlns:xsd=" xmlns="urn:oio:dkal:2.0.0"> <FejlKode xmlns="urn:oio:dkal:1.0.0">4949</fejlkode> <FejlTekst xmlns="urn:oio:dkal:1.0.0">meddelelsesid findes i forvejen MeddelelseIdentifikator = </FejlTekst> <FejlIdentifikator xmlns="urn:oio:dkal:1.0.0"> </fejlidentifikator> <EpostAfsendelseKvittering xmlns="urn:oio:dkal:1.0.0"> <SystemIdentifikator>9119</SystemIdentifikator> <MeddelelseIdentifikator xmlns="urn:oio:dkal:2.0.0"> </meddelelseidentifikator> <PostkasseMetadata xmlns="urn:oio:dkal:2.0.0"> <PostkasseIdentifikator xmlns="urn:oio:dkal:1.0.0">2536</postkasseidentifikator> <PostkasseEmneIdentifikator xmlns="urn:oio:dkal:1.0.0">3043</postkasseemneidentifikator> <MetadataSamling> <Metadata> <MetadataNoegleNavn xmlns="urn:oio:dkal:1.0.0">pfr OBligatorisk</MetadataNoegleNavn> <MetadataVaerdiTekst>43</MetadataVaerdiTekst> </Metadata> </MetadataSamling> </PostkasseMetadata> <AfsendelseDatoTid> T14:07: :00</AfsendelseDatoTid> </EpostAfsendelseKvittering> </Fejl> G.6 Afsendelse af post via REST baseret webservice G.6.1 Operation: Aflever forsendelse /afsendersystem/{sysid}/forsendelse/{meddelelsesid} Formål Input parametre PUT Operationen giver adgang til at aflevere forsendelser som xml via egen web service. sysid Angiver id på virksomhedens / myndighedens afsendersystem som findes via slutbrugergrænsefladen. meddelelsesid Identifikator for afsendelsen. Afsendersystemet har ansvaret for at generere id der er globalt unikke på tværs af alle afsendersystemer. Se afsnittet MeddelelsesIdentifikator i Digital post - Snitflade for detaljer om formatet. Input (OIOXML) Digital post Snitflader / Integration for virksomheder / version

32 Forsendelse Indeholder information om hvortil forsendelsen skal adresseres samt hovedddokument, og inklusiv eventuelt vedhæftninger. Fejlkoder (udover de generelle) G.6.2 Ressource: Forsendelse Forsendelse (version 1) Formål TYPE Indeholder information om hvortil forsendelsen skal adresseres samt det fysiske brev, eventuelt inklusiv vedhæftninger. C PostkasseMetadata Ved initiering af en ny henvendelse fremgår her den myndighed samt postkasse der rettes henvendelse til. C OriginalMeddelelseIdentifikator Ved besvarelse fremgår her MeddelelsesIdentifikator fra den besked der besvares. C MeddelelseTitelTekst Titlen på meddelelsen. C MeddelelseIndholdData Data i dette felt skal være indkodet i Base64 formatet. Bemærk krav i forbindelse med HTML forsendelser som fremgår af Digital post - Snitflader afsnittet Generelle vilkår. C FilformatNavn Angiver formatet på meddelelsens indhold. Formatnavnet er endelsen af det filnavn, som blev opgivet da indholdet blev gemt F.eks. pdf, docx, txt, htm. C VedhaeftningSamling Indeholder information om afsendelsens vedhæftninger, inklusiv selve indholdet eller reference til det. G.6.3 PostkasseMetadata TYPE PostkasseMetadata (version 2) Formål Typen indeholder metadata fra en postkasse for en meddelelse. Digital post Snitflader / Integration for virksomheder / version

33 Indeholder en liste af elementer, som består af nedenstående to felter og en liste af metadata nøgle/værdi-sæt. C PostkasseIdentifikator Angiver postkassen. C PostkasseEmneIdentifikator Angiver emnet. MetadataSamling, en samling af nøgle/værdi-sæt. C MetadataNoegleNavn Nøglen C MetadataVaerdiTekst Værdien G.6.4 VedhaeftningSamling VedhaeftningSamling (version 1) Formål TYPE Typen indeholder en liste informationer om vedhæftede dokumenter eller bilag. Indeholder en liste af typen Vedhaeftning G.6.5 Vedhaeftning Vedhaeftning (version 1) Formål TYPE Typen indeholder information om en vedhæftning, inklusiv reference til selve indholdet et dokument eller bilag. C VedhaeftningNavn Navnet på dokumentet. File extension fremgår af FilformatNavn. C VedhaeftningIndholdData Selve indholdet af vedhæftningen indkodet i Base64 formatet. C FilformatNavn Angiver formatet på vedhæftningens indhold. Formatnavnet er endelsen af det filnavn, som man ville give indholdet skulle det gemmes som en fil. F.eks. pdf, docx. R IndholdStoerrelseMaal Anvendes ikke. R MIMEcontentIdentifikator Anvendes ikke. R VedhaeftningOprindelig AfsenderNavn Anvendes ikke. Digital post Snitflader / Integration for virksomheder / version