Tilslutning til ecomone Basis (OIO Faktura) 1. november 2009, Version 1.1
1. POST DANMARKS ECOMONE BASIS (OIO FAKTURA)... 3 1.1 BEGREBER... 3 2 KANALER... 3 3 MODEL FOR DATAUDVEKSLING... 4 4 KOMMUNIKATION... 6 4.1 SECURE FTP (SFTP)... 6 5 BILAG A, MAPNING OG FORMATER... 7 6 BILAG B, XML KVITTERINGSLISTE... 8 6.1 FELTBESKRIVELSE... 8 6.2 EKSEMPEL... 10 6.3 XSD... 10 Side 2 af 10
1. Post Danmarks ecomone Basis (OIO Faktura) ecomone Basis (OIO Faktura) er en løsning, der er specielt designet til forsendelse af elektroniske fakturaer ved indlevering i et aftalt standard format. Ved ecomone Basis (OIO Faktura) kan elektroniske fakturaer indleveres i formaterne, OIOXML 0.7, OIOUBL 2.01, ecomone fakturaformat 1.0 eller ecomone EDIFACT D96A. Herefter kan fakturaer via ecomone leveres til VANS, ecomone Online eller andre virksomheder og institutioner tilsluttet ecomone. Etablering og udveksling af data mellem Kunden og, kan foretages som beskrevet i dette dokument. 1.1 Begreber : Forretningsenhed i Post Danmark der har udviklet og leverer ecomone. ecomone: Kommunikationsløsning udviklet og leveret af. Afsender: Virksomheden eller den offentlige myndighed, som sender forsendelser til sine kunder, ansatte eller handelspartnere via Post Danmarks ecomone løsning. Modtager: Virksomhed, offentlig myndighed, privatperson eller medarbejder, som har valgt at modtage post fra Afsender via en af ecomone løsningens kanaler. 2 Kanaler ecomone Basis (OIO Faktura) indeholder mulighed for at sende til følgende kanaler: Kunder i ecomone netværket* ecomone giver Kunder mulighed for at tilslutte deres ERP system eller lignende direkte til netværket for modtagelse af handelsdokumenter i deres eget ønskede format via en aftalt kommunikationsform, fx Secure FTP. ecomone Online ecomone Online er et web interface og arkiv rettet mod mindre virksomheder og institutioner. Her kan Modtageren oprette sig som bruger på baggrund af CVR nummer og tilmelde sig modtagelse af elektroniske handelsdokumenter fra relevante handelspartnere. VANS VANS er det kommunikationsnetværk, som distribuerer de elektroniske regninger mm. på baggrund af GLN nummer (tidligere EAN). ecomone er tilsluttet VANS netværket og giver således mulighed for distribution til Modtagere der ønsker modtagelse via denne kanal, fx offentlige myndigheder. *Både afsendelse og modtagelse Side 3 af 10
3 Model for dataudveksling Afsendelse af fakturaer for ecomone Basis (OIO Faktura) forudsætter at Kunden benytter et af følgende standard formater: a) OIOXML 0.7 b) OIOUBL 2.01 c) ecomone fakturaformat 1.0 (recordbaseret eller kommasepareret). Se dokumentet ecomone Faktura Layout og eksempler for yderligere oplysninger. Dokumentet kan rekvireres hos. d) ecomone EDIFACT D96A. Se dokumentet EDIFACT D96A, ecomone Subset. Dokumentet kan rekvireres hos. Kunden leverer fil i aftalt standard format og Post Danmark sørger for mapning og konvertering til relevante modtager formater. Flowet er beskrevet i nedenstående figur. ecomone Basis Basis (OIO (OIO Faktura) Afsender ecomone Modtager(e) data Standard format Konvertering Intermediært format Modtager format Modtager ecomone Modtager format program Data ecomone database Modtager ecomone Online HTML, PDF & CSV Kvitteringsfil(er) Tilmeldingsliste Tilmeldingsliste Kvitteringsfil(er) Modtager VANS OIOXML Forsendelser Tilmeldinger Kvitteringer Side 4 af 10
ecomone Basis (OIO Faktura) giver mulighed for at sende til følgende kanaler: Kunder i ecomone netværket ecomone Online VANS Efter modtagelse af fil(er) opdeler forsendelserne til henholdsvis ecomone, ecomone Online og VANS på baggrund af Modtagernes tilmeldinger og s aftale med Afsender. har behov for at vide, hvorledes modtagerne skal identificeres i Kundens dokumenter. Identifikationen af modtagerne kan for eksempel være et GLN nummer (tidligere EAN nummer) eller CVR-nummer. Se Bilag A for yderligere information om mapning og formater. Når har behandlet forsendelserne kan en XML formateret kvitteringsliste efter aftale sendes til Kunden, som beskriver hvilke modtagere, der har modtaget Kundens dokumenter og hvordan de er modtaget (ecomone, ecomone Online, VANS). Format for kvitteringsliste fremgår af Bilag B. Tilmeldingssliste kan efter aftale benyttes for kanalen ecomone Online. Tilmeldingslisten viser hvilke handelspartnere der via web interfacet, ecomone Online har tilmeldt sig modtagelse af fakturaer eller andre handelsdokumenter gennem denne kanal. Format for tilmeldingsliste kan rekvireres hos. Side 5 af 10
4 Kommunikation tilbyder følgende kommunikationsform for ecomone Basis (OIO Faktura): Kommunikationsform Kryptering Afsender henter og afleverer data secure ftp (sftp) Krypteret ssh-tunnel Ja, sftp med brug af brugeridentifikation og kodeord. Det er ikke muligt at bruge nøglepar. 4.1 Secure ftp (sftp) Secure ftp har de samme grundlæggende egenskaber som almindelig ftp, men Secure ftp anvender desuden kryptering af dataforbindelsen. Kryptering foregår via SSH (Secure Shell) og filer overføres i en såkaldt SSH-tunnel. På Unix systemer er ssh, scp og sftp standard, men der kan være udfordringer i at automatisere sftpbaserede filoverførsler med brug af brugeridentifikation og kodeord, dvs. uden nøglepar. På Windows er der mange og billige sftp programmer på markedet. Datasikkerhed Ved overførsel af filer, er brugeridentifikation, kodeord og data krypteret. Når filer befinder sig på Post Danmarks ftp/ssh-server, er de beskyttet af firewall og adgangsrettigheder på serveren. Side 6 af 10
5 Bilag A, Mapning og formater I forbindelse med afsendelse og modtagelse af elektroniske fakturaer, findes der forskellige muligheder for formatering af dokumentdata. Følgende format-muligheder eksisterer ved ecomone Basis OIO Faktura: a) OIOXML 0.7 b) OIOUBL 2.01 c) ecomone fakturaformat 1.0 (recordbaseret eller kommasepareret) d) ecomone EDIFACT D96A ad a) Afsendelse og modtagelse i OIOXML format: Opbygningen af dette format følger Bekendtgørelse om information i OIOXML elektronisk regning til brug for elektronisk afregning med offentlige myndigheder. Læs mere og hent evt. bekendtgørelsen på IT- og Telestyrelsens hjemmeside: http://www.itst.dk/arkitektur-og-standarder/lovstof/bekendtgorelser Ad b) Afsendelse og modtagelse i OIOUBL format: Opbygningen af dette format følger reglerne beskrevet af Offentlig Information Online. Læs mere på: http://www.oioubl.info/classes/da/index.html Ad c) har udviklet et fakturaformat der indholdsmæssigt understøtter såvel OIOXML som OIOUBL formaterne. Dette fakturaformat kan anvendes som såvel record-baseret format samt som komma-separeret (CSV) format. Dokumentation af dette format kan rekvireres fra. Ad d) Afsendelse i ecomone EDIFACT D96, som er et EDIFACT format i HANCOM subset. Dokumentationen af dette format kan rekvireres fra. Side 7 af 10
6 Bilag B, XML kvitteringsliste Der dannes en kvitteringsliste for hver leverance, til de Kunder der har tilmeldt sig denne service. Kvitteringslisten indeholder en oversigt over, hvem der har modtaget dokumenter, og på hvilken kanal. En kvitteringsliste vil være navngivet: deliv_<logid>_<jobid>.xml Der findes to afsenderbestemte parametre (se beskrivelse nedenfor) i kvitteringslisten: 1. jobid <jobid> svarer til det navn Kunden giver datafilen ved aflevering (uden ekstension), f.eks. JT308.zip svarer til <jobid> = JT308 2. senderreference Denne oprettes ved materialeindlevering, enten ved læsning fra printfil eller XML fil Listen dannes som en XML formateret fil, som beskrevet nedenfor. 6.1 Feltbeskrivelse Feltnavn / attributnavn Type Beskrivelse electronicaddressid Char(13) ID for den elektroniske adresse som benyttes af til at returnere kvitteringsliste til afsender. deliveryreport Document root version 99.99 Version af denne dokument struktur. P.t. 1.3. Denne værdi vil blive opdateret ved ændringer i fil-strukturen. timestamp YYYY-MM-DDThh:mmTZD Tidspunkt for dannelse af kvitteringslisten Iflg. W3C s profil af ISO 8601 http://www.w3.org/tr/notedatetime sendername Char(100) Kundenavn. senderid Num(18) Identifikationen af Kunde hos jobid Char(100) Kundens job ID. Dette bliver læst fra filnavnet uden ekstension på den zip-fil, der indeholder dokument leverancerne logid Char(15) Unik identifikation af kørslen, tildelt ved udførsel senderinterchangeref Num(30) Valgfri udvekslingsinformatin for afsender. messageid Num(30) s interne ID for en enkelt message. interchangeid Num(30) s interne ID for den enkelte udveksling hvor den message som messageid Side 8 af 10
Feltnavn / attributnavn Type Beskrivelse identificerer, er indeholdt. filename Char(200) Afsenders navn for udvekslingsfilen. zipfilename Char(200) Afsenders navn for batch filen. deliveries channel <channel>+ <totalcount> <recipients> <count> Liste af leverancer til modtagere, opdelt per kanal Liste af modtagere for en given kanal. Kanalen er angivet i parameteren name name Char(8) Mulige værdier er p.t. (P2P, ECM1BOKS & RETURN) recipients <recipient>* Liste af modtagere for en given kanal. recipient Modtager der har modtaget et dokument på den aktuelle kanal. no Num(8) Fortløbende sekvens nummer. custno Char(30) Modtagerens kundenummer hos Kunde eller CPR-nummer recid Char(10) Unik record ID senderreference Char(50) Umodificeret afsender reference felt fra indlæsning. Dette felt medtages kun, såfremt det var specificeret ved indlæsningen/ afsendelsen. matrno Char(15) ekom materiale nr. count Num(8) Antal dokument leverancer for en given kanal totalcount Num(8) Antal dokument leverancer i alt i filen Side 9 af 10
6.2 Eksempel <?xml version="1.0" encoding="iso-8859-1" standalone="yes"?> <ekom2xibdeliveryreport xmlns="http://www.postdanmark.dk/ekom/b2b"> <electronicaddressid>9990000111111</electronicaddressid> <deliveryreport> <ns1:deliveryreport version="1.3" xmlns:ns1="http://www.postdanmark.dk/ekom/deliveryreport"> <ns1:timestamp>2009-11-11t09:15:51.028+01:00</ns1:timestamp> <ns1:sendername>kundenavn</ns1:sendername> <ns1:senderid>1234</ns1:senderid> <ns1:jobid>999902</ns1:jobid> <ns1:logid>100002</ns1:logid> <ns1:senderinterchangeref filename="999902" messageid="999902"/> <ns1:deliveries> <ns1:channel name="ecm1boks"> <ns1:recipients> <ns1:recipient custno="8888888888888" matrno="12345" no="1" recid="1" senderreference="999902"/> </ns1:recipients> <ns1:count>1</ns1:count> </ns1:channel> <ns1:totalcount>1</ns1:totalcount> </ns1:deliveries> </ns1:deliveryreport> </deliveryreport> </ekom2xibdeliveryreport> 6.3 XSD Skema kan rekvireres fra.