AutoPASS Formidlingssentral AutoPASS Collection and Forwarding Central. Design filutveksling

Transkript

1 6.2 - AutoPASS Collection and Forwarding Central Design filutveksling

2 DOKUMENTSTATUS Document number: xx Status Version Date Final Authorisation Name Date Signature Author Norwegian Public Roads Administration Fridtjof Dypveit / Trond Clausen FD 2/33

3 INNHOLDSFORTEGNELSE DOKUMENTSTATUS... 2 INNHOLDSFORTEGNELSE... 3 DEFINISJONER OG FORKORTELSER... 5 FORKORTELSER... 6 REFERANSER KOMMUNIKASJONSGRENSESNITT GENERELT SYSTEMSKISSE KRAV TIL KOMMUNIKASJON MELLOM OPERATØR, UTSTEDER OG ACFC KRAV TIL PROGRAMVARE FOR TILGANG TIL WEBAPPLIKASJON FILOVERFØRING GENERELT KATALOGSTRUKTUR OVERFØRING AV FILER TIL ACFC OVERFØRING AV FILER FRA ACFC FEILSJEKKING I FTP BYTTE AV PASSORD PÅ FTP-SERVER FORMIDLING AV BOMSTASJONSTABELL BESKRIVELSE DATAUTVEKSLINGSFORMAT SEKVENSGANG FORMIDLING AV SVARTELISTE BESKRIVELSE DATAUTVEKSLINGSFORMAT MELDINGSFLYT SEKVENSGANG FORMIDLING AV UTSTEDERLISTE BESKRIVELSE DATAUTVEKSLINGSFORMAT MELDINGSFLYT /33

4 5.4 SEKVENSGANG FORMIDLING AV STATUSLISTER MED KVITTERING BESKRIVELSE DATAUTVEKSLINGSFORMAT MELDINGSFLYT SEKVENSGANG NEDLASTING AV STATUSLISTE FRA SENTRAL BACKUP-KATALOG FORMIDLING AV TRANSAKSJONSLISTER MED KVITTERING BESKRIVELSE DATAUTVEKSLINGSFORMAT MELDINGSFLYT SEKVENSGANG FORMIDLING AV AKTØRTABELL BESKRIVELSE DATAUTVEKSLINGSFORMAT MELDINGSFLYT SEKVENSGANG WEBAPPLIKASJON MELDINGER, VARSLER OG ALARMER FEILKODER FOR STATUSLISTER (NBS) FEILKODER FOR BOMSTASJONSFIL (TST) FEILKODER FOR BLACKLISTER (NAT) FEILKODER FOR TRANSAKSJONSLISTER KREDIT (TIF / TIC) FEILKODER FOR KVITTERING PÅ TRANSAKSJONSLISTER (TIF/ TIC) SENDESKJEMA /33

5 DEFINISJONER OG FORKORTELSER AutoPASS CREATE EasyGo EasyGo+ Utsteder (Issuer) Operatør (Operator) Toll Charger Toll Service Provider Norsk system/tjeneste for bompengebetaling Prosjektet definere EasyGo +-tjeneste Skandinavisk tjeneste for bompengebetaling. AutoPASS er den norske delen av denne tjenesten. Utvidelse av EasyGo hvor også Østerrike (kun tunge biler) er integrert i EasyGo-tjenesten (operativ fra 2013). se Toll Service Provider (TSP) se Toll Charger (TC) Entitet som opererer/drifter et betalingsanlegg/bomstasjon (inkludert utstyr i vegkant). Forkortes TC. Entitet som utsteder OBE og som inngår kontrakter med brukere om bruk av betalingstjenesten. Forkortes TSP. 5/33

6 FORKORTELSER ACFC ACT AIT BCFC BIN CEN CPE CS DSRC EFC EN FTP HGC HGV ISO KDC KDF MLFF NAC NAT OBE OBU PAN PISTA RSE TC TIC TIF TSP TSPA TST VPN AutoPASS Collection and Forwarding Central (for Norwegian actors) Actor Table Accepted Issuer Table BroBizz Collection and Forwarding Central (for other than Norwegian actors) (part of the original EasyGo solution not to be used when EasyGo Hub is implemented) First part of the PAN no. identifying the issuer Committee European de Normalisation Charging Point Equipment Central System (also called Toll Administration System) Dedicated Short Range Communication Electronic Fee Collection European Norm File Transfer Protocol Heavy Goods Vehicle Confirmation Heavy Goods Vehicle International Standardisation Organisation Key Distribution File Confirmation Key Distribution File Multi-Lane Free Flow Not Accepted Table Confirmation Not Accepted Table On Board Equipment On Board Unit Personal Account Number Pilot on Interoperable Systems for Tolling Applications Road Side Equipment Toll Charger Transaction Information File Confirmation Transaction Information File Toll Service Provider Toll Service Provider Agreement Toll Station Table Virtual Private Network 6/33

7 REFERANSER Dette dokumentet bygger på og henviser til følgende dokumentener: Ref. Nr Dokument navn Utarbeidet av Dokument nr. Dato [1] 201 Requirements for central systems and collection and forwarding centrals [2] 203 Technical requirements data format and interface specifications EasyGo EasyGo [3] 205 Key distribution Ver 1,0 EasyGo [4] 208 Requirements for VPN access to the EasyGo HUB [5] ACFC Requirement Specification EasyGo Statens vegvesen 7/33

8 1 KOMMUNIKASJONSGRENSESNITT 1.1 GENERELT Dette dokumentet beskriver et overordnet design for kommunikasjonstekniske løsninger ved AutoPass Formidlingssentral (AFS). Engelsk betegnelse på AFS er AutoPASS Collection and Forwarding System (ACFC). I dette dokument er brukt begrepet ACFC. Det henvises til ref [2] for en beskrivelse av grensesnittformatene ved utvekslingen, samt til ref. [1], [3] og [4] for andre aspekter ved datautvekslingen. Designet beskrevet i dette dokumentet er basert på dagens løsning. IKT-systemer som kommuniserer med ACFC (sentralsystemet og EasyGo HUB) er basert på dette designet. Rundt ACFC er bygd en kommunikasjons-infrastruktur som skal sørge for sikker og pålitelig datakommunikasjon mellom sentralsystemene til norske bompengeanlegg. Norske bompengeaktører er enten operatører (offisiell betegnelse er Toll Charger TC) eller utstedere (offisiell betegnelse er Toll Service Provider - TSP). I tillegg kommuniserer ACFC med danske/svenske bompengeanlegg via EasyGo HUB, som er en tilsvarende datautvekslingssentral på dansk/svensk side. En prinsippskisse av den generelle dataflyten i EasyGo er vist i figuren under. TC ASFINAG TSP Øresund TSP ASFINAG TC Øresund TC Fjellinien TC Storebælt TSP Fjellinien TSP Storebælt TC Molslinien EasyGo HUB ACFC TC Trøndelag TSP Trøndelag.... TC Scandlines DK TC... n TC Scandlines SE TSP... n TSP Svinesund TSP... n TC Scandlines D TC... n Fig 1: Generell dataflyt i EasyGo Lokale norske transaksjoner og andre data blir ikke sendt gjennom EasyGo HUB, men håndteres internt i ACFC. 1.2 SYSTEMSKISSE Bomselskapenes sentralsystemer kommuniserer med ACFC ved bruk av FTP / VPN over internett. ACFC benytter en standardisert protokollstakk som ikke krever at de andre aktørene må installere spesialutviklet programvare. Som databærer for protokollstakken 8/33

9 benyttes kommersielt tilgjengelig internett. Det forutsettes at utstedere/operatører har (evt. etablerer) tilgang til kommersielt tilgjengelig internett med den sikkerhetsarkitektur og kapasitet som kreves. Fig 2: Prinsippskisse av kommunikasjons-arkitektur i AutoPASS Bomselskapene / sentralsystemene (på figuren kalt «Operator»), tilbys et felles filbasert grensesnitt mot ACFC (på figuren kalt «Transaction Central»). For norske selskaper som inngår i ASB, vil dette være et felles grensesnitt med ulike aktøridentifikatorer (også kalt BIN-koder) og tilganger. ACFC er basert på leverandørens egen FTP-server implementasjon, og tilbyr import/eksport av filer via FTP-protokollen. Filoverføringen sikres ved at FTPprotokollen kun tillates utført via en VPN tunnel i et etablert VPN-samband mellom Leverandørens brannmur og tilsvarende brannmurkonfigurasjon hos Bomselskapene / sentralsystemene. 1.3 KRAV TIL KOMMUNIKASJON MELLOM OPERATØR, UTSTEDER OG ACFC I dette avsnittet beskrives krav til programvare hos operatør/utsteder Internett/VPN Tilkobling til Autopass Formidlingssentral skjer via en internett/vpn-forbindelse. VPN klient må konfigureres i operatørens/utstederens brannmur. VPN-klienten må støtte IPSec (IP security protocol), definert av IETF (Internet Engineering Task Force). 9/33

10 1.3.2 FTP Filutveksling skjer gjennom FTP (File Transfer Protocol) ZIP Utveksling av filer med ACFC foregår komprimert på zip-format. Operatør/utsteder må ha installert programvare (Pkzip/WinZip) for komprimering/dekomprimering til dette formatet. 1.4 KRAV TIL PROGRAMVARE FOR TILGANG TIL WEBAPPLIKASJON Systemet har et Web-basert brukergrensesnitt som aksesseres ved hjelp av en standard nettleser. 10/33

11 2 FILOVERFØRING 2.1 GENERELT FTP benyttes som overføringsprotokoll mellom ACFC og utsteder/operatør. Det overføres flere ulike filer mellom ACFC og utsteder/operatør. Formatene for disse filene er beskrevet i ref. [2]. De ulike operatørene/utstederen må sjekke ACFC for eventuelt nye filer i henhold til sendeplanen. De mest kritiske filene er statuslister og svartelister. I tillegg må det periodisk sjekkes for følgende filtyper, som kan sendes på vilkårlig tidspunkt: - Transaksjonslister - Transaksjonslistekvitteringer - Bomstasjonstabell - Utstederliste - Aktørregister Filene er rene ascii filer, men komprimeres vha pkzip ved overføringene. 2.2 KATALOGSTRUKTUR Hver operatør/usteder har sin egen dedikerte hjemmekatalog på ACFC sin FTP server. Strukturen på denne hjemmekatalogen er beskrevet under. Katalogen har en struktur for filer som skal overføres til ACFC, og en struktur for filer som skal overføres fra ACFC. Hver utsteder/operatør har kun tilgang til sin egen katalogstruktur. Dersom et selskap fungerer både som operatør og utsteder i systemet, vil dette selskapet ha to BIN-koder, og dermed 2 sett brukernavn/passord til FTP-serveren, samt to uavhengige hjemmekataloger. En forklaring på de enkelte katalogene for hver utsteder/operatør er gitt under: 11/33

12 Katalog Beskrivelse Tilgang for aktør ACFC <actor> Basiskatalogen til FTP serveren. Den inneholder hjemmekatalogene til hver operator/utsteder. <bin kode> Den spesifikke operator/utsteder sin hjemmekatalog. BIN kode benyttes for navnsetting av katalogen. Den enkelte operatør/utsteder ser kun katalogstrukturen som finnes med rot i denne katalogen. BIN koden har første siffer 0 for utsteder og første siffer = 1 for operatør. Lese Skrive X. out Katalogstruktur for å laste filer ned fra ACFC. X X Backup StatusBackup new Inneholder kopier/backup av filer som utveksles fra ACFC til en utsteder/operator. Den vil kun være lesbar for den enkelte aktør. Lenke til sentral backup-katalog for statusfiler. Operatør kan laste ned backup av statusfiler herfra. Inneholder nye filer fra ACFC til en utsteder/operator, men som ikke har blitt lastet ned ennå. X. in Katalogstruktur for å laste filer opp til ACFC X X completed rejected new Temp Inneholder filer som med suksess har blitt prosessert av ACFC Inneholder filer som ACFC ikke har klart å prosessere. Inneholder import filer fra en aktør som er overført med suksess og som er klar til å bli prosessert av ACFC. Utsteder/operatør benytter denne katalogen for å overføre filer vha ftp til ACFC. Når han er ferdig med å laste opp en fil til ftp serveren flyttes den over til katalogen new. X X X X X X X X X Administrator (STAS) har full lese-/skrivetilgang til hele katalogstrukturen. 2.3 OVERFØRING AV FILER TIL ACFC Filoverføring til ACFC har følgende forløp 1. Aktør lager fil som skal overføres til ACFC 2. Aktør komprimerer filen til zip-format. 3. Aktør logger seg på ACFC sin FTP server ftp inv <server> user <brukernavn> <passord> 4. Aktør setter overføringsmodus til binary vha ftp kommandoen bin 5. Aktør endrer katalog til In\Temp vha ftp kommandoen cd In\Temp 12/33

13 6. Aktør overfører fila til ACFC vha ftp kommandoen put < filnavn> 7. Når fila er overført med suksess flyttes den til katalog In\New vha ftp kommandoen rename <filnavn>..\new\<filnavn> 8. Aktør logger seg fra ftp server quit Etter import overfører ACFC importerte filer i Completed katalogen (eller til Rejectedkatalogen dersom noe gikk galt). Operatør/utsteder kan om ønskelig sjekke disse katalogene for å verifisere resultatet av opplastingen. Alle feil vil uansett generere en melding fra ACFC til avsender. 2.4 OVERFØRING AV FILER FRA ACFC Generelt vil overføring av filer fra ACFC har følgende forløp: 1. Aktør logger seg på ACFC sin FTP server ftp inv <server> user <brukernavn> <passord> 2. Aktør endrer katalog til Out\new cd Out\new 3. Aktør kjører ftp kommandoen ls for å få en liste over filer som er tilgjengelig for nedlasting 4. Aktør setter overføringsmodus til binary vha ftp kommandoen bin 5. Aktør kjører ftp kommandoen get <filnavn> for å få lastet ned ønskelig fil 6. Når fila er overført kjører aktør ftp kommandoen delete <filnavn>. 7. Aktør logger seg fra ftp server quit 8. Aktør dekomprimerer mottatt fil Hver fil som legges ut på den enkelte aktørs import-område skrives samtidig til backup-katalogen. På denne måten vil ACFC alltid beholde en backup av filer som aktør laster ned fra ACFC. Operatør/utsteder har lesetilgang til backup-katalogen under sitt hjemområde, og kan dersom ønskelig laste filene på nytt derfra. 2.5 FEILSJEKKING I FTP Dersom ACFC i sin validering/sjekk av filer oppdager feil skal den utstede feilmeldinger med feilkoder som angitt i Kap. 10. Det forutsettes at operatør/utsteder sjekker returkode/resultat fra alle kommandoer som kjøres mot FTP-serveren. 2.6 BYTTE AV PASSORD PÅ FTP-SERVER Det er ikke lagt opp til periodisk bytte av passord på FTP-server. Dersom operatør/utsteder ønsker å bytte passord, kan han ta kontakt med STAS for å gjøre dette. Dersom det anses nødvendig kan STAS på samme måte ta kontakt med operatør/utsteder og avtale passordbytte/nytt passord. 13/33

14 3 FORMIDLING AV BOMSTASJONSTABELL 3.1 BESKRIVELSE Operatøren lager oversikt over sine bomstasjoner og ved endringer eller når de er en ny operatør legger de sin bomstasjonstabell ut på ACFC sin FTP-server. ACFC distribuerer alltid komplett bomstasjonstabell. Den inneholder alltid en sammensetning av siste versjon av bomstasjonstabellene fra alle operatørene For utstederen blir det kun en fil å forholde seg til. Komplett bomstasjonstabell distribueres kun til utsteder. 3.2 DATAUTVEKSLINGSFORMAT Beskrivelse av filnavn og filformat av bomstasjonstabellen er beskrevet i [3]. 3.3 SEKVENSGANG Operatør sender bomstasjon fil til ACFC 1. Operatør skal ved endringer lage ny bomstasjonstabell 2. Operatøren logger seg på ACFC sin FTP-server 3. Utsteder overfører komprimert bomstasjonfil til katalogen In\Temp 4. Når fila er overført med suksess flytter utsteder bomstasjonsfila over til katalogen In\New med FTP-kommando rename. 5. ACFC oppdager ny bomstasjonsfil 6. ACFC tolker fila og lagrer den i databasen 7. ACFC flytter fila til In\completed katalogen ACFC lager ny regional bomstasjon fil 1. ACFC oppdager endringer i bomstasjonstabellen i databasen 2. ACFC lager ny komplett regional bomstasjonstabell som oversendes easygo HUB ACFC henter ny komplett bomstasjonsfil fra easygo HUB 1. ACFC henter ned og importerer ny bomstasjonsfil fra easygo HUB 2. ACFC lager ny komplett bomstasjonsfil som eksporteres ut til ut til katalogen Out\new til alle utstederene. Fila er nå tilgjengelig for nedlasting for utstederne. ACFC legger også en kopi av denne fila i katalogen Out\backup til alle utstederne for backup for den enkelte utsteder Utsteder henter komplett bomstasjon fil fra ACFC 1. Utsteder sjekker ved jevne mellomrom ACFC sin FTP server for ny bomstasjonsfil 2. Utsteder laster ned ny komplett bomstasjonsfil 3. Utsteder sletter den nedlastede bomstasjonsfilen fra FTP-serveren. En kopi av denne fila finnes i katalog Out\backup 14/33

15 4 FORMIDLING AV SVARTELISTE 4.1 BESKRIVELSE Svartelister utveksles kun pga utenlandstrafikk, mao. det produseres ikke svartelister fra norske utstedere som distribueres til norske operatører. For svartelister over norske brukere skjer følgende: Utstederne lager og distribuerer sin svarteliste til ACFC. Svartelistene fra alle utstederene samler ACFC opp til en samlet regional svarteliste som oversendes EasyGo HUB for videre distribusjon til svenske/danske operatører. For svartelister over dansk/svenske brukere skjer følgende: Utstederne lager og distribuerer sin svarteliste til EasyGo HUB. Svartelistene fra alle utstederene samler EasyGo HUB opp til en samlet regional svarteliste som oversendes ACFC for videre distribusjon til norske operatører. 4.2 DATAUTVEKSLINGSFORMAT Beskrivelse av filnavn og filformat av svarteliste er beskrevet i [3]. 4.3 MELDINGSFLYT Operatør 1 Operatør 2 EasyGo NCFC HUB ACFC Utsteder 1 Utsteder 2 Svarteliste (NAT) Kvittering (NAC) Svarteliste (NAT) Regional Svarteliste (NAT) Kvittering (NAC) Kvittering (NAC) Komplett Svarteliste (NAT) Komplett Svarteliste (NAC) Komplett Svarteliste (NAC) Fremmed Svarteliste (NAT) Fremmed Svarteliste (NAT) 4.4 SEKVENSGANG Utsteder sender svarteliste fil ACFC 1. Utsteder sender ny svarteliste til ACFC 2. Operatøren logger seg på ACFC sin FTP-server 3. Utsteder overfører komprimert svarteliste til katalogen In\Temp 4. Når fila er overført med suksess flytter utsteder svartelistefila over til katalogen In\New med FTP-kommando rename. 15/33

16 5. ACFC oppdager ny svarteliste 6. ACFC tolker, validerer og sender kvittering til utsteder for fila 7. ACFC lagrer fila i databasen 8. ACFC flytter fila til In\completed katalogen. AutoPASS Formidlingssentral Utsteder sender regional svarteliste til easygo HUB 1. I henhold til sendeplan oversender utsteder svarteliste til easygo HUB ACFC mottar nye svartelister fra easygo HUB 1. ACFC laster svartelister opp databasen 2. ACFC legger i kopi av den samlede svartelista i katalogene Out\new og Out\Backup til operatørene 3. ACFC plukker ut de rader i svartelista som ikke tilhører regionen til ACFC. Denne fremmed svartelista distribueres ut til alle operatørene 16/33

17 5 FORMIDLING AV UTSTEDERLISTE 5.1 BESKRIVELSE Utstederlisten er et uttrekk fra aktørregisteret i ACFC. Aktørregisteret er tilgjengelig via ACFC Webapplikasjon, se avsnitt 9. ACFC distribuerer alltid ut ny utstederliste når det er nye/endrede data i aktørregisteret eller den importerer en ny utstederliste fra EasyGo HUB. Den distribueres kun til operatørene og inneholder gyldige BIN for utstedere. 5.2 DATAUTVEKSLINGSFORMAT Beskrivelse av filnavn og filformat av utstederliste er beskrevet i [3]. 5.3 MELDINGSFLYT Endringer på aktørregisteret. En utsteder i aktør registeret har endret BIN eller en det har kommet til en ny utsteder. AFS sender automatisk ut ny utstederliste EasyGo NCFCHUB ACFC Operatør 1 Operatør 2 Utstederliste Utstederliste (WHT) Utstederliste (WHT) Utstederliste (WHT) 5.4 SEKVENSGANG Utstederliste endres 1. Ny utstederfil mottas fra easygo HUB. Dersom det endres på lokal utsteder sender ACFC regional utstederliste til easygo HUB først 2. ACFC oppdager endringen og lager automatisk ny utstederliste. 3. Fila legges ut på Out\new katalogen til hver enkelt operatør. En kopi av fila legges også på Out\backup katalogen Operatør henter utstederliste 1. Utsteder sjekker ved jevne mellomrom ACFC sin FTP server for ny utstederfil 2. Utsteder laster ned ny utstederliste. 3. Utsteder sletter den nedlastede utstederliste fil fra FTP-serveren. En kopi av denne fila finnes i katalog Out\backup 17/33

18 6 FORMIDLING AV STATUSLISTER MED KVITTERING 6.1 BESKRIVELSE ACFC lager komplett statusfil basert på mottatte statusfiler fra utstederene samt HGV fil fra EasyGo HUB. Denne komplette statusfila distribueres til alle operatørene. Mangler det en statusliste fra en utsteder eller siste statusliste fra en utsteder ikke ble godkjent blir siste godkjente versjon benyttet. På et konfigurerbart tidspunkt på dagen blir gyldig statusfil eksportert ut til alle operatørene. Statuslisten er sortert på stigende brikkenummer. 6.2 DATAUTVEKSLINGSFORMAT Beskrivelse av filnavn og filformat av status fil og kvittering på status fil er beskrevet i ref. [3]. Brikkeutsteder-kode i body skal ha lik verdi med utsteder-kode i header. Ved all formidling av statusfiler skal status fila komprimeres før utsendelse. Dette gjelder både ved sending fra utsteder og ved utsendelse fra ACFC. Operatør må dekomprimere fila før den tas i bruk. Pkzip benyttes for komprimering og dekomprimering. 6.3 MELDINGSFLYT Utsteder 1 Utsteder 2 ACFC Operatør 1 Operatør 2 Status fil (NBS) Kvittering status fil (NBR) Status fil (NBS) «requirement» Max 10 minutter etter mottak av status fil skal kvitteringsfil sendes tilbake. Kvittering status fil (NBR) Samlet status fil (NBS) På et bestem tidspunkt sendes samlet statusfil ut til alle utstedere. AFS logger når operatør henter samlet statusfil. Samlet status fil (NBS) 6.4 SEKVENSGANG Utsteder sender statusfil til ACFC 1. Utstederen lager statusfil over sine brikker. 2. Utsteder komprimerer statusfil vha pkzip. 3. Utsteder logger seg på ACFC sin FTP server. 4. Utsteder overfører statusfil til katalogen In\Temp i henhold til sendeskjema 5. Når fila er overført med suksess flytter utsteder statusfila over til katalogen In\New 6. ACFC dekomprimerer statusfil fra utsteder 7. ACFC tolker, validerer og sender en kvittering tilbake til utsteder. 8. ACFC laster statusfila inn i databasen. 9. ACFC flytter statusfil til In\Completed 18/33

19 6.4.2 ACFC lager komplett statusfil(ref dok 203) 1. ACFC starter prosessen med å lage komplett statusfil i henhold til sendeskjema. Den komplette status fila inneholder HGV registeret fra utstedere som ikke tilhører ACFC 2. ACFC sjekker om alle utstederene har overført ny statusfil. ACFC sender varslemelding til de utstedere som ikke har overholdt tidsfristen. 3. ACFC lager gyldig komplett statusfil fra databasen. Utsteder id i filnavn og header settes til ACFC komprimerer fila vha pkzip 5. ACFC lagrer fila i egen katalogstruktur for ACFC for backup. 6. ACFC kopierer den nye komplette statusfila ut til katalogen Out\new som finnes i hjemmekatalogen til alle operatørene Operatør henter komplett statusfil fra ACFC 1. Operatør logger seg på ACFC sin FTP-server i henhold til sendeskjema. 2. Operatør henter siste komplette status fil som finnes på katalogen Out\new 3. ACFC lagrer i egen logg i databasen (Filtype, filnavn, operatør id og tidspunkt) at operatøren har lastet ned fila. 4. Operatøren sletter status fila når den er overført med suksess. ( ACFC har kopi av statusfil i databasen samt i egen katalogstruktur. 5. Operatøren dekomprimerer status fil vha pkzip. 6.5 NEDLASTING AV STATUSLISTE FRA SENTRAL BACKUP-KATALOG En backup av en statusliste legges ikke ut i backup katalogen til hver enkelt operatør. Dette fordi statuslister fra ACFC til operatørene er alle identiske. For statuslister fra ACFC vedlikeholdes dette i stedet i en sentral katalogstruktur. Dersom det er behov for resending av gammel status fil kan denne hentes fra denne sentrale backup katalogen. Det er lagt ut en lenke til katalogen fra operatørens Out -katalog. 1. Operatør logger seg på ACFC sin FTP-server 2. Operatør skifter katalog til fellesområde ved FTP-kommando cd Out\StatusBackup 3. Operatør henter ønsket statusliste 19/33

20 7 FORMIDLING AV TRANSAKSJONSLISTER MED KVITTERING 7.1 BESKRIVELSE En transaksjonsliste fra en operatør til utsteder vil mhp header, body og footer forbli uforandret i prosessen fra operatør til utsteder. Det samme gjelder kvitteringer. ACFC vil håndtere alle transaksjonsfiler som ikke har blitt distribuert til utsteder når videreformidlingsprosessen starter. Dette er uavhengig av hvor mange transaksjonsfiler den enkelte operatør har sendt. Når ACFC mottar transaksjonsfil med transaksjonslister utenfor sendeskjema vil prosessen med å videreformidle transaksjonslister kun bli basert på den mottatte transaksjonsfil. En operatør mottar varselmelding dersom operatøren ikke har sendt transaksjonsfil siste døgn En utsteder mottar en varselmelding dersom utstederen ikke har sendt kvittering på transaksjonsfil innen en konfigurerbar tid. Dersom en operatør i løpet av siste døgn ikke har hatt fremmedpasseringer skal likevel en tom transaksjonsfil sendes til fastsatt tidspunkt. Utsteder skal kvittere på mottatt tom transaksjonsfil. Transakjsonslister som skal til utsteder som ikke tilhører ACFC oversendes easygo HUB for videre behandling. Kvitteringer på translister som skal til operatør som ikke tilhører ACFC oversendes easygo HUB for videre behandling. 7.2 DATAUTVEKSLINGSFORMAT Beskrivelse av filnavn og filformat av transaksjonsfil og kvittering på transaksjonsfil er beskrevet i ref.[3]. Følgende presiseres vedr. transaksjonsliste: FileSequence i hovedheader og i header på transaksjonsliste i transaksjonsfil fra operatør skal være identisk og likt filnavnet I transaksjonsfil fra ACFC til utsteder trenger det ikke dato og sekvensnummer være identisk i filnavn, hovedheader, og header på transaksjonsliste. En transaksjonsfil inneholder et antall transaksjonslister. En transaksjonsfil fra operatør kan kun inneholde en transaksjonsliste pr mottaker. Header, body og footer til en transaksjonsliste forblir uendret i fil fra operatør til omgruppert fil til utsteder. 20/33

21 7.3 MELDINGSFLYT Utsteder 2 ACFC Operatør 1 Utsteder 1 Operatør 2 Transaksjonsfil (TDF) Transaksjonsfil (TDF) Transfil (TDF) Transaksjonsfil (TDF) Transfil fra opertatør 1 kan inneholde to translister. En til utsteder 1 og en til utsteder 2 Kvittering på transfil (TDR) Kvittering på transfil (TDR) AFS omgrupperer mottatte translister. Flytter translistene som skal til samme utsteder inn til en felles transfil. En transfil kan inneholde flere translister med forskjellig avsender av transliste Transfil til utsteder 1 kan inneholde to translister. En fra operatør 1 og en fra operatør 2 Kvittering transliste ( TDR) Kvittering transliste (TDR) 7.4 SEKVENSGANG Operatør sender transaksjonsfil gjennom ACFC til den enkelte utsteder 1. Operatøren lager ny transaksjonsfil som inneholder en transaksjonsliste pr utsteder. 2. Operatøren logger seg på ACFC sin ftp server. 3. Operatøren starter å overføre transaksjonsfil til katalogen In\Temp 4. Operatøren overfører fila til katalogen In\New når fila ble overført med suksess. 5. ACFC oppdager en ny transaksjonsfil. 6. ACFC tolker, validerer fila. ACFC overfører fila til utsteder ACFC videresender transaksjonslister til utstederne 1. ACFC starter prosessen med å videresende transaksjonslister ut til utstederne i henhold til sendeskjema 2. Operatør lsger en fil til hver utsteder som skal motta en transaksjonsliste. Fila skal inneholde kun en transaksjonslister fra operatør. 3. ACFC validerer at de transaksjonslister som den har fått inn er de samme som sendes ut. 4. Hver fil legges på katalogen Out\new for den enkelte utsteder. En kopi av fila legges på katalogen Out\backup for den enkelte utsteder Utsteder henter transaksjonsfil fra ACFC 1. Utsteder logger seg på ACFC sin ftp server i henhold til sendeskjema. 2. Utseder henter ned ny transaksjonsliste fra ACFC 3. Utsteder sletter transaksjonsfila på ftp serveren ( En kopi finnes i backup katalogen) 4. Utsteder logger seg av ftp server Utsteder sender kvittering på transaksjonsliste til operatør via ACFC 1. Utsteder lager kvitteringsfil. 2. Utsteder logger seg på ACFC sin ftp server i henhold til sendeskjema 3. Utsteder overfører kvitteringsfil til katalog In\Temp 4. Utsteder overfører fila til In\New når fila er overført med suksess. 21/33

22 5. Utsteder logger seg av ftp server 6. ACFC oppdager ny kvitteringsfil 7. ACFC tolker og validerer fila. ACFC laster fila inn i databasen 8. ACFC markerer hvilke transaksjonslister som er blitt kvittert. AutoPASS Formidlingssentral ACFC sender ut omgrupperte kvitteringer på transaksjonsliste tilbake til operatør 1. ACFC starter prosessen med å sende ut transaksjonslister i henhold til sende skjema 2. Det blir laget en fil til hver operatør som skal motta en kvittering på en transaksjonsliste. 3. ACFC legger disse filene på katalogen Out\new og Out\backup til hver enkelt operatør Operatør henter ned kvitteringene 1. Operatør logger seg på ftp server til ACFC i henhold til sendeskjema 2. Operatøren henter ned ny kvitteringsfil fra ACFC 3. Operatør sletter fila dersom den overføres med suksess. 4. Operatør logger seg av ftp server 22/33

23 8 FORMIDLING AV AKTØRTABELL 8.1 BESKRIVELSE Aktørregisteret sendes fra easygo HUB til ACFC ved oppdatering av aktørregisteret i ACFC webapplikasjon. Når easygo HUB sender ny aktørfil til ACFC vil den nye fila bli distribuert til alle utstedere og operatører tilknyttet ACFC 8.2 DATAUTVEKSLINGSFORMAT Filformat for aktørtabell er definert i ref[3]. 8.3 MELDINGSFLYT Meldingsflyt er logisk identisk med utstederliste. Se kapittel SEKVENSGANG Sekvensgang er logisk identisk med utstederliste. Fila distribueres i tillegg til alle utstederene. Se kapittel /33

24 9 WEBAPPLIKASJON Autopass formidlingssentral skal utstyres med en webapplikasjon som er tilgjengelig for alle operatører og utstedere i systemet. I webapplikasjonen kan følgende finnes: - Aktørregister med informasjon om operatører og utstedere i Autopass-systemet. - Rapporter over fremmedpasseringer/statistikk fra formidlingssentralen - Informasjon om bomstasjoner - Sendeskjema for transaksjonslister og statuslister - Informasjon om hvem som er aktiv supervisor for systemet For hver operatør/utsteder i systemet vil det bli opprettet en superbruker som får tilgang til å administrere brukere og tilgang til webapplikasjonen for personer tilknyttet sin aktør i AutoPASS. Superbrukeren har også tilgang til å vedlikeholde informasjonen i aktørregisteret for sin aktør. Supervisor har tilgang til utvidet funksjonalitet i webapplikasjonen. Dette er beskrevet i ref[4]. 24/33

25 10 MELDINGER, VARSLER OG ALARMER Når det oppstår feilsituasjoner under formidling av filene skal ACFC generere meldinger, varsler og alarmer som sendes via epost. Ved sending av alarmer til operatør/utsteder skal epostadresse til mottaker finnes fra aktørregisteret i ACFC. Feilkoder og mottaker er angitt under. Feilmeldingen inneholder en beskrivende tekst om i hvilken fil, og hvor i filen feilen oppsto FEILKODER FOR STATUSLISTER (NBS) Feilkode Nivå Mottaker Beskrivelse Feil Tom fil Feil Korrupt fil - ikke lesbar Feil Uventet slutt på fil (end-of-file) Feil Formatfeil i header Feil [line x] Formatfeil i body Feil Ugyldig avsender i header Feil Ugyldig avsender i filnavn Feil Advarsel Feil Feil Header i statusliste har ikke autorisert utstederkode. Uoverensstemmelse i statusliste header. Dato og sekvensnummer på forrige statusliste stemmer ikke. Feil i dato og/eller sekvensnummer. Data utenfor gyldighetsområdet Feil Denne status filen er allerede lastet Feil Filen er allerede lastet inn tidligere Feil Feil Feil Feil Feil Ugyldig verdi i feltet Shadow_Issuer. Feil funnet på linje %1!. Verdi %2! Ugyldig PAN (Country_Code+Issuer_ID+ServiceNumber). Er ikke i henhold til IssuerList. Feil funnet på linje %1!. Verdi %2! Ugyldig verdi i feltet Vehicle_Class. Feil funnet på linje %1!. Verdi %2! Ugyldig verdi i feltet Override. Feil funnet på linje %1!. Verdi %2! Ugyldig verdi i feltet NationalCode. Feil funnet på linje %1!. Verdi %2! Feil Ugyldig verdi i feltet Validity. Feil funnet på 25/33

26 10868 Feil Feil Feil Feil linje %1!. Verdi %2! Ugyldig verdi i feltet Valid_From. Feil funnet på linje %1!. Verdi %2! Ugyldig verdi i feltet Valid_To. Feil funnet på linje %1!. Verdi %2! Valid_From må ikke være større enn Valid_To. Feil funnet på linje %1!. Verdi %2! Overlappende periode (Valid_From og Valid_To) for en brikke. Feil funnet på linje %1!. Verdi %2! 10.2 FEILKODER FOR BOMSTASJONSFIL (TST) Feilkode Nivå Mottaker Beskrivelse Advars el Feil Supervisor Feil Fil mottatt fra ulovelig aktør Tom fil Feil format i felt %1! (%2!). Den skal ha følgende format %3! Feil Uventet slutt på fil (end-of-file) Feil Formatfeil i header Feil [line x] Formatfeil i body Feil Record-count stemmer ikke med header Feil Formatfeil i footer Feil Ugyldig avsender i header Feil Ugyldig mottaker i header Feil Ugyldig avsender i filnavn Feil Bomstasjonsfil må sendes fra en operatør.%1! er ikke en gyldig operatør kode Feil Filen er allerede lastet inn tidligere Feil Feil Feil Feil Ulovlig actor_id. Feil funnet på linje %1!. Verdi %2! Feil verdi i kolonnen type_of_station funnet. Lovlige verdier er 01, 02, 03, 04. Feil funnet på linje %1!. Verdi %2! Ulovlig direction_code. Lovlige verdier er 11,12. Feil funnet på linje %1!. Verdi %2! Feltet Station direction description må fylles ut når feltet station_direction_code er benyttet Feil Feltet network code er påkrevd. Feil funnet på 26/33

27 10806 Feil Feil Feil Feil Feil Feil Feil Advarsel Feil linje %1!. Feltet network name er påkrevd. Feil funnet på linje %1!. Feltet station_code er påkrevd. Feil funnet på linje %1!. Feltet station_name er påkrevd. Feil funnet på linje %1!. Feltet network_code er et numerisk felt. Feil funnet på linje %1!. Verdi %2! Feltet station_code er et numerisk felt. Feil funnet på linje %1!. Verdi %2! Feltet actor_id må være identisk med sender. Feil funnet på linje %1!. Verdi %2! Feltet country_id inneholder ulovlig country_code. ISO Alpha-2 benyttes. Feil funnet på linje %1!. Verdi %2! Uoverensstemmelse i header. Dato og sekvensnummer på forrige sekvensnummer stemmer ikke. Uoverensstemmelse i header. Det er allerede lastet opp(importert en fil av nyere versjon enn denne FEILKODER FOR BLACKLISTER (NAT) Feilkode Nivå Mottaker Beskrivelse Advars el Feil Supervisor Feil Fil mottatt fra ulovelig aktør Tom fil Feil format i felt %1! (%2!). Den skal ha følgende format %3! Feil Uventet slutt på fil (end-of-file) Feil Formatfeil i header Feil [line x] Formatfeil i body Feil Record-count stemmer ikke med header Feil Formatfeil i footer Feil Ugyldig avsender i header Feil Ugyldig mottaker i header Feil Ugyldig avsender i filnavn Feil Blacklist må sendes fra en utsteder. %1! er ikke en gyldig utsteder kode Feil Filen er allerede lastet inn tidligere. 27/33

28 Feil Advarsel Advarsel Advarsel Feil Ulovlig verdi i feltet action to take Ulovlig verdi i feltet reason of non acceptance Feltet pan i svartelista er numerisk. Feil funnet på linje %1!. Verdi %2! Uoverensstemmelse i header. Dato og sekvensnummer på forrige sekvensnummer stemmer ikke. Uoverensstemmelse i header. Det er allerede lastet opp(importert en fil av nyere versjon enn denne FEILKODER FOR TRANSAKSJONSLISTER KREDIT (TIF / TIC) Feilkode Nivå Mottaker Beskrivelse Feil Ugyldig filnavn Feil Korrupt fil - ikke lesbar Feil Formatfeil i header Feil [line x] Formatfeil i body Feil Formatfeil i footer Feil Ugyldig avsender i header Feil Ugyldig mottaker i header Feil Feil Feil Feil Feil Feil Feil Feil Header i transaksjonsfil har ikke autorisert operatørkode. Formatfeil i transaksjonsliste delheader. Formatfeil i transaksjonsliste delfooter. Delheader i transaksjonsliste har ikke autorisert operatørkode. Delheader i transaksjonsliste har ikke autorisert utstederkode. Uoverensstemmelse i transaksjonsliste header. Dato og sekvensnummer på forrige transaksjonsliste stemmer ikke. Feil i dato og/eller sekvensnummer AFS (000000) skal være mottaker av en transaksjonsfil. Feil i hovedheader. 28/33

29 10514 Feil Filen er allerede lastet inn tidligere Feil Feil AutoPASS Formidlingssentral Ugyldig PAN (Country_Code+Issuer_ID+ServiceNumber). Er ikke i henhold til IssuerList. Feil funnet på linje %1!. Verdi %2! Ugyldig verdi i feltet Vehicle_Class.Feil funnet på linje %1!. Verdi %2! Feil Ugyldig verdi i feltet NationalCode Feil Ugyldig verdi i feltet Type_of_Transit Feil Feil Tollplaza ID er ugyldig. Den finnes ikke i tollplaza tabellen for sender av fila. Ugyldig verdi i feltet Shadow Issuer. Dersom ingen shadow issuer benyttes skal feltet fylles med blank Feil Ugyldig Receiver Identifier funnet i header Feil Ugyldig Sender Identifier funnet i header Feil For ikke-autopass OBU skal de 6 første karakterene i feltet RND1 inneholder Contract Provider Feil Lane eksisterer ikke for angitt Plaza Feil Feil Feil Feil Feil Summen av krav for currency 1 for en transliste stemmer ikke overens med feltet summert krav i tilsvarende trailer. Summen av krav for currency 2 for en transliste stemmer ikke overens med feltet summert krav i tilsvarende trailer. En transaksjonsliste kan kun inneholde transaksjoner for en valuta. Header indikerer at det finnes transaksjoner for både Currency1 og Currency2 Header indikerer at det finnes rader for Currency2. Men feltet Currency2 er blankt I AutoPass skal Currency2 kun inneholde referanse til fremmed valuta Feil I AutoPass skal Currency1 alltid være NOK Feil Feil Feil Feil Currency2 er ikke blank, mens feltet Number_of_Records_Curr2 er 0. Currency2 skal da være blank En transaksjonsliste skal kun inneholde en valuta. Valutaen er angitt i header. Det skal ikke være lik valutabenevnelse på Currency1 og Currency2. Sett Currency2 til blank. Dersom feltet Text Description ikke skal inneholde verdi bør det settes til blank og ikke fylles med 0. Feltet finnes fra posisjon Feil For ikke-autopass OBU skal tegnene 6 og 7 i 29/33

30 10941 Feil Feil Feil Feil Feil Feil Feil Feil Feil MAC1 inneholde Mode of Operation. Ugyldig verdi i funnet. Gyldige verdier er 00 (ingen verdi), 01 (Normal) og 02 (Degraded) For ikke-autopass OBU skal tegnene 8 og 9 i MAC2 inneholde Level of Security. Ugyldig verdi i funnet. Gyldige verdier er 00,01,02 For ikke-autopass OBU skal tegnet nr 3 i MAC2 inneholde Change of class indicator. Ugyldig verdi i funnet. Gyldige verdier er 0,1 For ikke-autopass OBU skal tegnene 1 og 2 i MAC2 inneholde Manual Class Entry. Ugyldig verdi i funnet. Gyldige verdier er fra 00 til 99 For ikke-autopass OBU skal tegnet 4 i MAC2 inneholde Pre DAC Exit(Cladd Automatic Detction). Ugyldig verdi i funnet. Gyldige verdier er fra 0 til 9 For ikke-autopass OBU skal tegnet 5 i MAC2 inneholde Post DAC Exit(Cladd Automatic Detction). Ugyldig verdi i funnet. Gyldige verdier er fra 0 til 9 For ikke-autopass OBU skal tegnet 6 i MAC2 inneholde DAC Entry. Ugyldig verdi i funnet. Gyldige verdier er fra 0 til 9 For ikke-autopass OBU skaltegnet 7 i MAC2 inneholde Height detector entry. Ugyldig verdi i funnet. Gyldige verdier er fra 0 til 9 Ugyldig PAN (Country_Code+Issuer_ID+ServiceNumber). Er ikke korrekt lengde på PAN/OBU ihht Issuerlist for utsteder. Servicenumber er lik og licenceplate number er tom. En av feltene må fylles ut FEILKODER FOR KVITTERING PÅ TRANSAKSJONSLISTER (TIF/ TIC) Feilkode Nivå Mottaker Beskrivelse Feil Ugyldig filnavn Feil Korrupt fil - ikke lesbar Feil Formatfeil i header Feil [line x] Formatfeil i body Feil Formatfeil i footer Feil Ugyldig avsender i header Feil Ugyldig mottaker i header Feil Header i transaksjonsfil har ikke autorisert 30/33

31 10108 Feil Feil Advars el Feil Feil Feil Feil Feil Supervisor Feil operatørkode. AutoPASS Formidlingssentral Delheader i transaksjonsliste har ikke autorisert operatørkode. Delheader i transaksjonsliste har ikke autorisert utstederkode. Kvittering på transaksjonsliste ikke mottatt innen tidsgrense Feil i dato og/eller sekvensnummer Header i kvittering på transaksjonsfil har ikke autorisert utstederkode. AFS (000000) skal være mottaker av en kvittering på transaksjonsfil. Feil i hovedheader. Feil i delheader på kvitteringsfil. Operatørkode i identifikasjon av transaksjonsliste er ikke identisk med feltet mottaker(operatør) Feil i delheader på kvitteringsfil. Den angitte transaksjonsliste finnes ikke. Feil i delheader på kvitteringsfil. Den angitte transaksjonsliste er allerede blitt kvittert for Feil Filen er allerede lastet inn tidligere Feil Feil Feil Feil Feil Feil Feil Summen av antall godkjente transaksjoner og antall avviste transaksjoner stemmer ikke med antall transaksjoner i den opprinnelige transaksjonslisten for currency1 Summen av antall godkjente transaksjoner og antall avviste transaksjoner stemmer ikke med antall transaksjoner i den opprinnelige transaksjonslisten for currency2 Summen av godkjente krav og avviste krav stemmer ikke med summens av krav i den opprinnelige transaksjonslisten for currency1 Summen av godkjente krav og avviste krav stemmer ikke med summens av krav i den opprinnelige transaksjonslisten for currency2 Summen av avviste krav for currency 1 for en transliste stemmer ikke overens med feltet summert avviste krav i tilsvarende trailer. Summen av avviste krav for currency 2 for en transliste stemmer ikke overens med feltet summert avviste krav i tilsvarende trailer. Den avviste transaksjonen finnes ikke i en opprinnelige transaksjonslisten. Feil funnet på linje %1! Feil Ugyldig verdi i feltet Reason Of Rejection. 31/33

32 10912 Feil Feil Mulige verdier er mellom 1 og 16. Ugyldig verdi i feltet Reason Of RejectionII. Mulig verdi er 00 Det skal ikke være lik valutabenevnelse på Currency1 og Currency2. Sett Currency2 til blank. 32/33

33 11 SENDESKJEMA ACFC skal sende ut samleliste for transaksjonslister og statuslister en gang per døgn. Sendeskjema for de enkelte filtypene konfigureres av Supervisor i ACFC Webapplikasjon. Man vil finne informasjon om aktivt sendeskjema i webapplikasjonen. 33/33