BESKRIVELSE 1 (7) 30.1.2007 Itella einvoice Repository Connection FTP - grensesnitt for erc
Itella erc FTP API 1.2 2 Innhold 1. Generelt...3 2. Virtuelle kataloger (innkommende faktura)...3 3. Tjenester for erc-brukere...4 4. Støttede fakturaformater...5 5. Eksempler på FTP-sesjoner...6
Itella erc FTP API 1.2 3 1. Generelt Dette dokumentet beskriver grensesnittet ved bruk av FTP (filoverførings-protokoll) til Itella einvoice Repository Connection (erc). Det blir benyttet av FTP-brukere for å laste ned fakturaer i ulike formater fra erc. Senere i dokumentet vil benevnelsen FTP-grensesnitt bli benyttet som referanse til Itella erc FTP grensesnitt 1.2. FTP servere som implementerer Itella erc FTP interface 1.2: erc.itella.net Standard tegnsett for data lagret i Itella erc er ISO-8859-15 (Latin 9). Tegnsettet blir benyttet for alle tekstfiler som ikke inneholder et annet og spesielt definert tegnsett. Det kodete kjennetegnet brukt i xml-filer er ISO-8859-1 (Latin1), selv om dataene er ISO-8859-15. Når det er mulig, anbefales bruk av binær modus ved overførsler via FTP. 2. Virtuelle kataloger (innkommende faktura) FTP-grensesnittet benytter begrepet virtuelle kataloger. De ligner på vanlige FTP-kataloger på den måten at FTP-brukeren ser dataene som filer i kataloger. Bildet av katalogene er imidlertid skapt i prosessen ved hjelp av informasjonen som ligger i Itella erc. Det er derfor bare en mindre forskjell i egenskapene som skiller virtuelle kataloger fra vanlige filbaserte kataloger. Følgende virtuelle katalogoversikter for innkommende fakturaer er støttet av FTP-grensesnittet for ercbrukere: FTP dir Type Anon Auth Description /bills R/O Nei Ja Alle fakturaer /bills-new R/W Nei Ja Alle nye fakturaer Virtuelle katalogstrukturer for katalogoversiktene; /bills og /bills-new er identiske. Forskjellen er at bare nye fakturaer (dvs. de som ikke er merket med lest ) er synlige i /bills-new virtuelle katalog oversikt, mens samtlige fakturaer er synlige i /bills virtuelle katalog oversikt.
Itella erc FTP API 1.2 4 3. Tjenester for erc-brukere Brukere av erc tjenesten får opprettet en egen konto og et passord for FTP-grensesnittet. Konfigurasjon av FTP-bruker: Vert: Bruker: Passord: Sti for alle fakturaer: Sti for nye fakturaer: erc.itella.net einvoice kontonummer (EBA), gitt av Itella gitt av Itella /bills/by-ebid/ebid/data.type /bills-new/by-ebid/ebid/data.type Mottak av liste over samtlige fakturaer i Itella erc /bills /bills/by-ebid NLST or LIST /bills/by-ebid NLST or LIST List of invoices: /bills/by-ebid/ebid1 /bills/by-ebid/ebid2 Max 100000 fakturaer kan oppbevares samtidig. Hvis det ligger flere enn 100000 fakturaer arkivert vil man få feilkode 550. Mottak av en enkelt faktura ved hjelp av ebid (Electronic Bill Identifier) /bills/by-ebid/ebid/data.type NLST or LIST /bills/by-ebid/ebid/data.type RETR Fakturainnhold Mottak av liste over nye fakturaer i Itella erc /bills-new /bills-new/by-ebid NLST or LIST See /bills NLST or LIST See /bills/by-ebid. Bare uleste fakturaer (dvs; de som er merket ulest ) blir oppført på listen. Bare de 1000 første fakturaene blir returnert.
Itella erc FTP API 1.2 5 Mottak av en enkelt ny faktura ved bruk av ebid (Electronic Bill Identifier) /bills-new/by-ebid/ebid /bills-new/by-ebid/ebid/data.type NLST or LIST See /bills/by-ebid/ebid. Fakturaen identifisert av ebid må ikke være merket lest. NLST or LIST See /bills/by-ebid/ebid/data.type. Fakturaen identifisert av ebid må ikke være merket lest. RETR See /bills/by-ebid/ebid/data.type. Fakturaen identifisert av ebid må ikke være merket lest. DELE Ved sletting av en fil blir den merket lest og hele katalogen blir fjernet. Å fjerne en faktura merket lest er tillatt og lykkes alltid. 4. Støttede fakturaformater Følgende fakturaformater støttes av Itella erc: Strukturerte dataformater EDIFACT (INVOIC D.96A, Itellas spesifikasjon) Finvoice e2b v.3.4 (minimum e2b Basis Profil) PDF TIF ZIP (PDF + fakturavedlegg som ZIP-pakke) Formater for visuelle formål PDF TIF Andre formater Att.zip (vedlegg eller zippede filer) Digital signatur Verified_mediatype.ps7 (signaturfil) Alle typer data kan bli bekreftet ved bruk av digital signatur. Enhver datatype har en individuell signaturfil.
Itella erc FTP API 1.2 6 5. Eksempler på FTP-sesjoner Listing av nye fakturaer ved bruk av ebid vert: erc.itella.net brukernavn: BELS990000064W passord: anasalas FTP=<<< 220 erc.itella.net FTP server ready. FTP=>>> user BELS990000064W FTP=<<< 331 Password required for BELS990000064W. FTP=>>> PASS... FTP=<<< 230 User BELS990000064W logged in. FTP=>>> PORT 192,89,176,33,155,136 FTP=<<< 200 PORT command successful. FTP=>>> LIST /bills-new/by-ebid FTP=<<< 150 Opening ASCII mode data connection for file list FTP=<<< 226-"/" is current directory. FTP=<<< 226 Transfer complete. ------------ BEGIN RESULTS ---------------- /bills-new/by-ebid/belfb265d463d9711d797be000629c340fc/ /bills-new/by-ebid/belf394875a3d9811d791d3000629c340fc/ /bills-new/by-ebid/belcd97d88c3dbf11d7bc46000629c340fc/ /bills-new/by-ebid/bele3b49a943dbd11d7b254000629c340fc/ /bills-new/by-ebid/bel716a18783dbe11d79f45000629c340fc/ /bills-new/by-ebid/bela2d5c03c3d2911d7b947000629c340fc/ /bills-new/by-ebid/bel595595e83d3011d78720000629c340fc/ /bills-new/by-ebid/belcc83eefa3d3211d7959a000629c340fc/ /bills-new/by-ebid/bel09d9351e39da11d79a3802070123b37c/ /bills-new/by-ebid/bel0a8e4a3039da11d79a3802070123b37c/ /bills-new/by-ebid/bel0bc6e1aa39da11d79a3802070123b37c/ ------------ END RESULTS ----------------
Itella erc FTP API 1.2 7 Mottak av en enkelt ny faktura ved bruk av ebid vert: erc.itella.net brukernavn: BELS990000064 W passord: anasalas FTP=<<< 220 erc.itella.net FTP server ready. FTP=>>> user BELS990000064W FTP=<<< 331 Password required for BELS990000064W. FTP=>>> PASS... FTP=<<< 230 User BELS990000064W logged in. FTP=>>> PORT 192,89,176,33,155,136 FTP=<<< 200 PORT command successful. FTP=>>> LIST /bills-new/by-ebid/belfb265d463d9711d797be000629c340fc/data.xml FTP=<<< 150 Opening ASCII mode data connection for file list FTP=<<< 226-"/" is current directory. FTP=<<< 226 Transfer complete. ------------ BEGIN RESULTS ----------------... ------------ END RESULTS ---------------- Merke en enkel faktura som lest ( seen flag ) vert: brukernavn: passord: erc.itella.net BELS990000064W Anasalas FTP=<<< 220 www.itella.net FTP server ready. FTP=>>> user BELS990000064W FTP=<<< 331 Password required for BELS990000064W. FTP=>>> PASS... FTP=<<< 230 User BELS990000064W logged in. FTP=>>> DELE /bills-new/by-ebid/ BELFB265D463D9711D797BE000629C340FC/data.xml FTP=<<< 250 DELE command successfull.