Implementazione Ws Pag. 1
Implementazione del Web Service
Allegato tecnico
Sommario
Premessa ... 1
Informazioni generali ... 2
Zone tariffarie ... 2
Tariffe ... 3
Arrotondamento degli importi ... 4
Arrotondamenti e troncamenti Orari ... 4
Inizio sosta e fine sosta ... 5
Agevolazioni mensili ... 5
Agevolazioni Giornaliere ... 5
Flusso informativo – tempo reale ... 6
Flusso informativo per la rendicontazione ... 6
Calendario... 6
Gestione del passaggio da Ora Legale a Ora Solare e viceversa. ... 7
Implementazione nuove tariffe ... 7
Descrizione delle operazioni... 7
Operazioni riguardanti le soste giornaliere ... 8
Operazione di inizio sosta ... 8
Operazione di Fine sosta ... 8
Agevolazione mensile ... 9
Rendicontazione ... 10
Interrogazione per identificativo ... 12
Alcune interpretazioni sulle soste ... 12
Piano di test - Procedura di accreditamento ... 15
Aspetti relativi alla privacy ... 16
Periodo di conservazione ... 16
Premessa
In questo documento vengono illustrate le modalità di scambio dei dati relativi alle soste giornaliere, alle agevolazioni mensili e della rendicontazione, e le nuove implementazioni richieste in merito al miglioramento delle
Implementazione Ws Pag. 2 indicazioni relative all’impiego delle zone per la sosta tramite l’implementazione del il codice via e alle nuove funzionalità per la rilettura dei dati.
Lo scambio dei dati avviene tramite Web Service (WS). La componente server risiede sui server aziendali delle aziende accreditare e la componente client sui server ATAC. ATAC interroga a cadenza regolare di 30 secondi il WS server e storicizza le informazioni lette sui propri server, per cui i dati relativi alle soste, sia che si tratti di soste orarie o agevolazioni mensili, devono essere disponibili entro 30”.
Giornalmente vengono richiesti da ATAC i dati relativi alla rendicontazione relativi alle transazioni chiuse il giorno precedente.
Informazioni generali
Zone tariffarie
Roma è suddivisa in zone tariffate in cui è possibile parcheggiare a fronte del pagamento di un corrispettivo da calcolare adottando le informazioni contenute in Tabella 1.
La Zona tariffaria è caratterizzata da un importo, un orario di vigenza in cui è previsto il pagamento ed il relativo periodo di vigenza cioè i giorni della settimana in cui è previsto il pagamento. In alcune zone tariffarie è prevista l’applicazione di agevolazioni che riguardano esclusivamente la sosta giornaliera. Di seguito (Tabella 1) il riepilogo delle zone tariffarie.
Tabella 1
Codice Zona Tariffaria
Zona Fascia Oraria
Validità settimanale
Tariffa Frazionabile Agevolazione Note
301 1 08:00
19:00
Lun-Sab € 1,00/h al minuto 4€ per 8h
consecutive
minimo 1 minuto di sosta
302 2 08:00
23:00
Lun-Sab € 1,00/h al minuto 4€ per 8h
consecutive
minimo 1 minuto di sosta
303 3 08:00
19:00
Lun-Ven € 1,00/h al minuto 4€ per 8h
consecutive
minimo 1 minuto di sosta
304 4 08:00
20:00
Lun-Sab € 1,00/h al minuto 4€ per 8h
consecutive
minimo 1 minuto di sosta
305 5 08:00
03:00
Lun-Sab € 1,20/h ZTL al minuto 4€ per 8h consecutive
minimo 1 minuto di sosta
306 6 08:00
03:00
Lun-Sab € 1,00/h al minuto 4€ per 8h
consecutive
minimo 1 minuto di sosta
307 7 08:00
20:00
Lun-Ven € 1,00/h al minuto 4€ per 8h
consecutive
minimo 1 minuto di sosta
308 8 08:00
23:00
Lun-Sab € 1,20/h ZTL al minuto 4€ per 8h consecutive
minimo 1 minuto di sosta
309 9 18:00
23:00
Lun-Sab € 1,20/h ZTL al minuto 4€ per 8h consecutive
minimo 1 minuto di sosta
312 12 18:00
03:00
Lun-Sab € 1,20/h ZTL al minuto 4€ per 8h consecutive
minimo 1 minuto di sosta
Implementazione Ws Pag. 3
314 14 20:00
23:00
Lun-Sab € 1,00/h al minuto 4€ per 8h
consecutive
minimo 1 minuto di sosta
315 15 08:00
23:00
Lun-Ven € 1,00/h al minuto 4€ per 8h
consecutive
minimo 1 minuto di sosta
319 19 08:00
18:00
Lun-Sab € 1,00/h al minuto 4€ per 8h
consecutive
minimo 1 minuto di sosta
310 10 08:00
19:00
Lun-Sab 0,5€ per ciascuna ora massimo 2 ore
,2€/12h ,3€/16h
Non frazionabile
311 11 08:00
20:00
Lun-Sab 0,5€ per ciascuna ora massimo 2 ore
,2€/12h ,3€/16h
Non frazionabile
313 13 08:00
19:00
Lun-Ven 0,5€ per ciascuna ora massimo 2 ore
,2€/12h ,3€/16h
Non frazionabile
316 16 08:00
03:00
Lun-Sab 0,5€ per ciascuna ora massimo 2 ore,
2€/12h, 3€/16h.
Non frazionabile
Massimo 16 ore di sosta consecutive.
317 17 08:00
20:00
Lun-Ven 0,5€ per ciascuna ora massimo 2 ore,
2€/12h, 3€/16h
Non frazionabile
318 18 16:00
23:00
Lun-Sab 0,5€ per ciascuna ora massimo 2 ore,
2€/12h, 3€/16h
Non frazionabile
360 60 06:00-
22:00
Lun-Sab € 1,50 prime 12 ore consecutive € 2,50
fino a 16 ore consecutive
Non frazionabile
361 61 06:00-
22:00
Lun-Sab € 2,00 prime 12 ore consecutive € 3,00
fino a 16 ore consecutive
Non frazionabile
362 62 05:15-
00.15
Dom-Gio € 1,50 prime 12 ore consecutive, € 2,50
per le soste maggiori di 12 ore fino a fine vigenza
Non frazionabile
362 62 05:15-
02:15
Ven-Sab € 1,50 prime 12 ore consecutive, € 2,50
per le soste maggiori di 12 ore fino a fine vigenza
Non frazionabile
110 Tutte escluse le zone 60,61,62
agevolazione mensile. La validità
inizia il giorno e l'ora di attivazione
Non frazionabile
Assegnabile ad una sola targa.
Tariffe
La tariffa oraria utilizzata per il pagamento giornaliero può esser frazionabile o non frazionabile. Nel caso sia frazionabile l’unita minima di frazionamento è di un minuto.
Implementazione Ws Pag. 4 La tariffa oraria può variare a secondo della Zona tariffaria o della possibilità di applicare agevolazioni giornaliere previste.
L’agevolazione “4€ per 8h consecutive ha la caratteristica di non essere ripetibile nella fascia di vigenza e si interrompe alla fine della giornata (si applica una sola volta all’interno della giornata di vigenza come riportato in Tabella 13 esempio 10).
L’agevolazione mensile non è frazionabile è può essere acquistata entro il 15° giorno del mese (compreso) per il mese in corso.
2 tariffe di base
Descrizione Importo Durata Frazionabile Nota Tariffa Oraria Fuori ZTL €1,00 1h Al minuto, minimo
1 minuto
-
Tariffa Oraria nella ZTL €1,20 1h Al minuto, minimo 1 minuto
-
3 Tariffe Agevolate
Descrizione Importo Durata Frazionabile Ripetibile Nota Tariffe agevolata
15min
- - - - Non prevista con il pagamento
dematerializzato Tariffe agevolata
8h
€4,00 08h No No L’agevolazione termina con
l’orario di fine vigenza.
Tariffa agevolata mensile
€70,00 1 mese solare
No,
l’importo è fisso.
No -
4 Agevolazioni previste nei parcheggi di prossimità
Descrizione Importo Durata Frazionabile Ripetibile Nota
Tariffa agevolata 2h €0,50 01h No Max 2 ore Per la continuazione della sosta si applica le altre tariffe previste nella Zona
Tariffa agevolata 12h €2,00 12h No No
Tariffa Agevolata 16h €3,00 16h No No -
L’applicazione della tariffa deve avvenire nella modalità più conveniente per il cliente.
Arrotondamento degli importi
Gli importi devono essere arrotondati al centesimo di euro. Quindi per un minuto di sosta, applicando la tariffa di 1€/h (frazionabile al minuto), l’importo arrotondato è 0,02€.
Arrotondamenti e troncamenti Orari
Gli orari che riguardano le soste giornaliere devono essere cosi trattati:
orario di inizio sosta - si opera un troncamento evitando di considerare i secondi.
orario di fine sosta – si opera un arrotondamento per eccesso portando l’orario al minuto successivo.
Per quanto riguarda gli orari che riguardano le “agevolazioni mensili”:
Implementazione Ws Pag. 5
DataOraEmissione: il campo contiene la data e ora, nel formato “dd-mm-yyyy hh:mm:ss”) dell’attivazione dell’abbonamento, quindi non deve essere ne arrotondato ne troncato.
dataInizioValidità: il primo giorno del mese a partire dalle ore 00:00:00.
dataFineValidità: l’ultimo giorno del mese portando l’orario alle ore 23:59:59
Esempi:
1. per la tariffa di 1,00€/h viene attivata una sosta alle ore 15:15:03. L’utente interrompe quasi immediatamente la sosta e, dopo pochi secondi l’attivazione, invia un fine sosta (ad es 15:15:43).
I dati di inizio e fine sosta attesi da Atac sono:
Inizio Fine Zona Tariffaria
15/07/2014 15:15 15/07/2014 15:16 ZONA 06 - € 1,00/h 08:00 03:00 Lun-Sab
ed analogamente i dati attesi della rendicontazione sono:
DataMovimento DataInizio DataFine
15/07/2014 15:15:43 15/07/2014 15:15 15/07/2014 15:16
2. per la tariffa agevolata di 0,50€/h viene attivata una sosta alle ore 11.13. L’utente decide di non rimanere in sosta, ed alle ore 11.15:25 invia un fine sosta.
I dati di inizio e fine sosta attesi da Atac sono:
Inizio Fine Zona Tariffaria
15/07/2014 11:13 15/07/2014 11:16 ZONA 16 - € 0,50/h 08:00 03:00 Lun-Sab
ed analogamente i dati della rendicontazione attesi sono:
DataMovimento DataInizio DataFine
15/07/2014 11:15:25.209 15/07/2014 11:13 15/07/2014 11:16
Inizio sosta e fine sosta
L’architettura del WS è predisposta per permettere la lettura dell’inizio e del fine della sosta in due momenti distinti. I dati di inizio sosta e di fine della sosta vengono ricongiunti successivamente tramite il valore espresso nel campo “identificativo sosta”.
Agevolazioni mensili
Le agevolazioni mensili interessano il mese solare e possono essere attivati anche durante il mese non oltre il 15simo giorno. L’importo è fisso ed ammonta a €70,00 per tutto il periodo.
L’agevolazione mensile è utilizzabile in tutte le zone con esclusione dei parcheggi di scambio ( Zone 60,61,62) .
Agevolazioni Giornaliere
In alcuni ambiti di sosta è possibile applicare le agevolazioni giornaliere previste. In tabella 1 è possibile consultare la tabella delle tariffe attualmente in vigore.
Implementazione Ws Pag. 6 Flusso informativo – tempo reale
Atac ha predisposto che l’interrogazione dei WS server avvenga ogni 30” (secondi). Le aziende devono
predisporre l’infrastruttura per rilasciare i dati nel minor tempo possibile che comunque deve essere al di sotto dei 5 secondi. Per evitare il sovraccarico dei server la quantità massima dei record restituiti dal WS deve essere non superiore a 1000.
Nel flusso devono essere presenti i dati generati nei 30” precedenti relativamente a:
Le soste iniziate e non concluse
Le soste concluse
Le agevolazioni mensili.
La tempestività per il rilascio dei dati è essenziale per il controllo su strada da parte degli ausiliari della sosta.
Flusso informativo per la rendicontazione
Atac ha predisposto le letture delle rendicontazioni ogni giorno dalle ore 04.00 in poi intervallando le interrogazioni di 10 minuti per ogni singola azienda.
Nel flusso di rendicontazione devono essere presenti i dati relativi a:
le soste chiuse il giorno precedente
le agevolazioni mensili attivate il giorno precedente.
Calendario
I giorni festivi infrasettimanali vanno considerati come domenica, tenendo conto delle indicazioni del Codice della Strada e della cartellonistica presente in prossimità delle zone di sosta tariffata.
Per la sola zona 62 (parcheggio di scambio) il giorno feriale in cui ricade la festività (ad esempio Capodanno, Epifania, Pasquetta, 25 Aprile, 1 Maggio, 2 Giugno, 29 Giugno SS Pietro e Paolo, 15 Agosto, 1 Novembre, 8 Dicembre, Natale e S. Stefano) deve essere trattato come feriale.
Implementazione Ws Pag. 7 Gestione del passaggio da Ora Legale a Ora Solare e viceversa.
1) Il passaggio da Ora Solare a Ora Legale avviene solitamente nella notte tra l’ultimo sabato di marzo e la domenica successiva alle ore 02:00 portando le lancette alle ore 03:00. Durante il passaggio da ora Solare a Ora legale (dalle 02:00 alle 03:00) non deve essere possibile effettuare il pagamento della sosta.
2) Il passaggio da ora Legale a Ora Solare avviene solitamente l’ultima domenica di Ottobre (o meglio nella notte tra sabato e domenica) portando indietro di un’ora le lancette dell’orologio. Il calcolo del periodo di sosta sia esso iniziato prima o dopo le ore 02:00 della Domenica o dopo le ore 03:00 si conteggiano normalmente.
Il campo di applicazione è valido in tutte le Zone Tariffate in cui l’orario di vigenza prevede la sosta a pagamento durante questi orari.
Implementazione nuove tariffe
Nel caso in cui vengano cambiate le tariffe, ATAC trasmetterà alle Aziende il nuovo piano tariffario e darà un tempo limite per l’adeguamento. Ogni Azienda deve comunicare di aver completato lo sviluppo necessario a supportare il cambiamento il piano tariffario ai referenti sia di Sistemi Informativi che della Direzione Sosta, al fine di svolgere i necessari test, se richiesti da ATAC.. Per la messa in produzione è necessario che:
1) tutte le nuove tariffe siano state aggiornate;
2) che le nuove tariffe siano state testate dalla direzione Sistemi in ambiente di sviluppo/test.
3) che la rendicontazione sia stata aggiornata;
4) che sia stato concordato il momento della pubblicazione che può avvenire in qualsiasi giorno della settimana dopo le ore 03:00 e fino alle ore 07:00.
Descrizione delle operazioni
Tempo reale
Con questa modalità Atac interroga il WS implementato presso l’azienda per leggere le informazioni relative alle soste o alle agevolazioni mensili
Per leggere le informazioni ATAC utilizza due metodi di interrogazione, in polling con intervallo di 30”:
1. tramite progressivo operazione. Il WS rilascia tutte le informazioni dal progressivo operazione successivo a quello utilizzato per l’interrogazione.
2. tramite data operazione. IL WS rilascia la parte di informazione sulle soste con data inizio o con data fine e le agevolazioni mensili con data emissione corrispondente alla condizione richiesta.
Tabella 5 - GetOperazioniSosta
campo Tipo/Lunghezza Descrizione/note
codiceOperatore String*15 Utente e password devono essere forniti dal provider password String*15 Utente e password devono essere forniti dal provider
dataInizio Date Se dataInizioSpecified= true viene inviata la data ed ora da cui è necessario ricevere i risultati fino al momento attuale
progressivo Integer Progressivo operazione.
Identificativo String *100 Identificativo sosta o Identificativo Abbonamento.
Implementazione Ws Pag. 8 3. Le aziende devono implementare un terzo metodo di interrogazione tramite il parametro “identificativo
sosta” che verrà utilizzato da ATAC in casi straordinari per completare le informazioni mancanti. Il WS, in questo caso , rilascia le informazioni relative alla “sosta” (inizio e fine) o “agevolazione mensile” con identificativo sosta o identificativo abbonamento corrispondete.
Le priorità di lettura dei parametri sono:
se viene indicato un identificativo devono essere restituite solo le operazioni di inizio sosta e fine sosta o abbonamenti relativi all’ identificativo richiesto (senza considerare gli eventuali parametri progressivo e dataInizio)
se viene indicato un progressivo devono essere restituiti tutte le operazioni di inizio sosta, fine sosta e abbonamenti con progressivo operazione maggiore di quello passato come parametro (senza considerare l' eventuale parametro dataInizio) ;
se viene indicata una dataInizio devono essere restituiti tutte le operazioni di inizio sosta, fine sosta e abbonamenti con data successiva a quella passata come parametro.
Operazioni riguardanti le soste giornaliere
Le operazioni relative alla sosta si dividono in due momenti:
1) Inizio Sosta 2) Fine Sosta
I due momenti sono ricollegabili attraverso l’ “Identificativo sosta”. Il servizio server prima di comunicare un
“Fine Sosta” deve aver inviato un “Inizio sosta”.
Il campo “ProgressivoOperazione” deve essere incrementale per identificare correttamente l’operazione sia essa relativa alla sosta o all’agevolazione mensile.
Operazione di inizio sosta public string*10 Targa
public Int32 ProgressivoOperazione (Identificativo univoco del record) public string*100 IdentificativoSosta (Identificativo univoco della sosta) public DateTime DataOraInizio
public string*100 CodiceZonaTariffaria public string*255 DescrizioneZonaTariffaria
public string*7 CodiceVia (Il codice Via identifica univocamente la strada dove avviene la sosta)
L’implementazione del CodiceVia da parte della aziende avverrà in un secondo momento tramite comunicazione da parte di ATAC della banca dati da utilizzare e delle relative informazioni necessarie all’implementazione. L’attivazione di questa informazione sarà comunque subordinata ad una fase di test utilizzando gli ambienti predisposti.
Operazione di Fine sosta public string*10 Targa
public Int32 ProgressivoOperazione (Identificativo univoco del record) public string*100 IdentificativoSosta (Identificativo univoco della sosta) public DateTime DataOra
Implementazione Ws Pag. 9 Di seguito alcuni esempi di ricevimento dati relativi alla sosta.
In data 2014-04-26 alle ore 17:57:00 ATAC interroga il server per ricevere i dati relativi alla sosta inviando l’ultimo “ProgressivoOperazione” e ricevendo le seguenti informazioni:
Tabella 6
CodiceZonaTariffaria DataOraInizio DescrizioneZonaTariffaria IdentificativoSosta ProgressivoOperazione Targa
306 2014-04-26
17:57:00.000
ZONA 06 - € 1,00/h 08:00 03:00 Lun-Sab
196586 480892 XX789PR
Alle ore 18:00 Atac effettua un’altra interrogazione per la ricezione dei dati utilizzando l’ultimo progressivo operazione registrato in banca dati; in questo caso il server invia la chiusura della sosta (fineSosta Tabella 7) relativo alla targa indicata in Tabella 6, riconducibili attraverso l’identificativo sosta.
Tabella 7
DataOra IdentificativoSosta ProgressivoOperazione Targa
2014-04-26 18:01 196586 480905 XX789PR
Per identificare dove è avvenuto il parcheggio il record che descrive l’inizio della sosta deve essere
correttamente popolato. Per una sosta iniziata in Viale Manlio Gelsomini (Zona 06) il codice via corrispondete è 6770.
Agevolazione mensile
Le operazioni relative alle tariffe agevolate riguardano esclusivamente l’attivazione di una nuova tariffa agevolata assegnabile ad una sola targa.
Dati comuni
public string*10 Targa
public Int32 ProgressivoOperazione (Identificativo univoco del record) Dati specifici
public string*100 IdentificativoAbbonamento (Identificativo univoco) public DateTime DataInizioValidita
public DateTime DataFineValidita public DateTime DataOraEmissione public string*100 CodiceZonaTariffaria public string*255 DescrizioneZonaTariffaria public string*255 DescrizioneTipoAbbonamento
public string*255 Categorie (eventuale uso futuro)
nb.: I campi sono tutti obbligatori
In Tabella 8 due esempi di risposte relative alle agevolazioni previste.
Tabella 8 CodiceZo naTariffa ria
DataInizioValidita DataFineValidita DataOraEmissione DescrizioneTi poAbbonam ento
DescrizioneZo naTariffaria
Identifica tivoAbbo namento
Progres sivoOp erazion e
Targa
110 2014-06-01 00:00:00.000
2014-06-30 23:59:59.000
2014-04-18 08:34:55
Abbonament i mensili
AGEVOLAZIO NI ROMA
186010 447795 XX524RK
110 2014-05-01 00:00:00.000
2014-05-31 23:59:59.000
2014-04-28 10:04:07
Abbonament i mensili
AGEVOLAZIO NI ROMA
197747 483962 XX807RA
Implementazione Ws Pag. 10 Come si può notare le date di emissione della agevolazione non coincidono con gli inizi validità.
(In merito alle regole di attivazione delle agevolazioni tariffarie mensili è necessario interfacciarsi con la direzione sosta).
Rendicontazione
ATAC utilizza il metodo “GetMovimentiGiorno” per interrogare il server e ricevere le operazioni di sosta relative al giorno indicato.
L’interrogazione a regime viene effettuata una volta al giorno , nella fascia oraria dalle ore 04:00 alle ore 06:00, con lo scopo di ricevere la rendicontazione giornaliera. Le informazioni si riferiscono alla giornata indicata nel campo
“DataOraEmissione” per la “tariffa agevolata mensile” e per la “Sosta” nel campo “DataOraFine”.
I parametri che ATAC invia al server utilizzando il metodo “GetMovimentiGiorno” sono:
Tabella 9
campo Tipo/Lunghezza Descrizione/note
codiceOperatore String*15 Utente e password devono essere
forniti dal provider e vengono utilizzati da Atac per ogni interrogazione
password String*15 Utente e password devono essere
forniti dal provider e vengono utilizzati da Atac per ogni interrogazione.
data Date Data del giorno da elaborare:
per le soste considerare la data di fine sosta, per l’agevolazione mensile la data del movimento.
Identificativo String*100 Identificativo della sosta o
dell’agevolazione mensile.
1. Le aziende devono implementare un terzo metodo di interrogazione tramite il parametro “identificativo sosta” che verrà utilizzato da ATAC in casi straordinari per completare le informazioni mancanti. Il WS, in questo caso , rilascia le informazioni relative alla rendicontazione della sosta o dell’agevolazione mensile corrispondente all’identificativo richiesto.
Le priorità di lettura dei parametri sono:
se viene indicato un identificativo devono essere restituite le informazioni relative alla rendicontazione della sosta o dell’agevolazione mensile corrispondente all’identificativo richiesto, ignorando il campo data;
se viene indicata una data devono essere restituite tutte le informazioni relative alla rendicontazione della sosta o dell’agevolazione mensile corrispondente emesse nel giorno richiesto.
Il metodo “GetMovimentiGiorno” restituisce il tipo “RendicontoImportiResult” composta dalle seguenti proprietà e metodi:
Tabella 10
Tipo Descrizione/note
Implementazione Ws Pag. 11 Movimenti MovimentoSosta Array di oggetti relative a: Inizio e fine sosta ed
Abbonamento
DescrizioneEsito String*255 Descrizione dell’errore o in caso di successo:
Elaborazione terminata con successo.
Esito Boolean Restituisce false quando lato server sono stati riscontrati problemi.
I Movimenti si riferiscono alle operazioni di sosta ed acquisto di sosta a “tariffa mensile agevolata”. Per la sosta vengono popolate le seguenti informazioni:
Tabella 11
Proprietà/campo Tipo Es Descrizione
CodiceMovimento String*20 2001/20170 Codice interno Azienda
fornitrice.
CodiceZonaTariffaria String*100 107
DataMovimento DateTime 2014-04-12 23:00:50.287 DataInizio DateTime 2014-04-12 18:12:00.000
DataFine DateTime 2014-04-12 23:00:00.000
DescrizioneZonaTariffaria String*255 ZONA 02 - € 1,00/h 08:00 23:00 Lun-Sab
ImportoMovimento Real 4,00
IdentificativoSosta String*100 177817
TipoMovimento String*50 SOSTA
Targa String*10 XX523XS
nb.: I campi sono tutti obbligatori
Per l’acquisto di sosta a “tariffa agevolata mensile” devono essere popolate le seguenti informazioni:
Tabella 12
Proprietà/campo Tipo Es Descrizione
CodiceMovimento String*20 2001/20141 Codice interno
Azienda fornitrice.
CodiceZonaTariffaria String*100 110
DataOraMovimento DateTime 2014-04-12 17:24:07.287
DataInizioValidita DateTime 2014-04-01 00:00:00.000
DataFineValidita DateTime 2014-04-30 23:59:59.999
DescrizioneZonaTariffaria String*255 AGEVOLAZIONI ROMA
ImportoMovimento Real 70,00
IdentificativoAbbonamento String*100 177737
TipoMovimento String*50 ABBONAMENTO
Targa String*10 XX523XS
DataOraEmissione DateTime 2014-04-12 17:24:07.000
DescrizioneTipoAbbonamento String*255 Abbonamenti mensili nb.: I campi sono tutti obbligatori
Implementazione Ws Pag. 12 Interrogazione per identificativo
In questa versione del WS è necessario implementare l’interrogazione tramite “IdentificativoSosta” per ricostruire le parti di transazioni che potrebbero essere non pervenute. Questo tipo di interrogazione interessa: le soste giornaliere, le agevolazioni mensili (tramite l’identificativo Abbonamento) e le rendicontazioni.
Il Ws a fronte di questo tipo di input restituisce le sole informazioni relative all’identificativo sosta richiesto.
Alcune interpretazioni sulle soste
Nella tabella vengono riportate alcune ipotesi estratte fra le domande più frequenti e la corretta interpretazione evidenziata in giallo.
Tabella 13
id
tariffe utilizzate per il calcolo
orario pagamento
inizio sosta
fine sosta
tempo sosta effettivo
tempo sosta tariffata
importo certificato da ATAC
Interpretazioni di
calcolo note
1
ZONA 01 - € 1,00/h
08:00 19:00 Lun-
Sab 08.00:19.00 09:00 09:10 10 min 10 min
ipotesi 1 15 min € 0.20
tariffa forfait 0,20€ per i primi 15 min.
ipotesi 2 10 min € 0.17 € 0.17
tariffa oraria 1€/h frazionata per 10 min
ipotesi 3 10 min € 0.13
tariffa 0,20€ per i primi 15 min.
frazionata per 10 min.
2
ZONA 01 - € 1,00/h
08:00 19:00 Lun-
Sab 08.00:19.00 09:00 09:30 30 min 30 min
ipotesi 1 30 min € 0.45
0,20€ (tariffa forfait per i primi 15 min) + 0,25€
(tariffa oraria 1€/
frazionata per i restanti 15 minuti)
ipotesi 2 30 min € 0.50 € 0.50
tariffa oraria 1€/h frazionata per 30 min
3
ZONA 01 - € 1,00/h
08:00 19:00 Lun-
Sab 08.00:19.00 08:00 17:35
09h 35 min
9 h 35
min
Implementazione Ws Pag. 13
ipotesi 1
09h 35
min € 5.58 € 5.58
4 € (agevolazione 4€ per 8 h) + 1,58€ tariffa oraria 1€/h frazionata per i restanti 95 minuti)
4
ZONA 01 - € 1,00/h
08:00 19:00 Lun-
Sab 08.00:19.00
08:00 giorno 1
13:00 giorno
2 29h 0 min 11h + 5h
ipotesi 1 16h € 12.00
4 € (agevolazione 4€ per 8 h) + 8€
tariffa oraria 1€/h frazionata per le restanti 8 ore)
ipotesi 2 16h € 11.00 € 11.00
4 € (agevolazione 4€ per 8 h giorno 1) + 3€ tariffa oraria 1€/h frazionata per le restanti 3 ore giorno 1) + 4€
(agevolazione 4€
per 8h giorno 2) con sosta autorizzata fino alle ore 16:00 del giorno 2
5
ZONA 10 - € 0,50/h
08:00 19:00 Lun-
Sab 08.00:19.00 08:00 08:30 30 min 1
ipotesi 1 30 min € 0.25
tariffa oraria 0,50€/h per le prime 2h frazionata per 30 min
ipotesi 2 30 min € 0.50 € 0.50
tariffa oraria 0,50€/h per ciascuna delle prime 2h non frazionabile con sosta autorizzata fino alle ore 09:00
Implementazione Ws Pag. 14
6
ZONA 10 - € 0,50/h
08:00 19:00 Lun-
Sab 08.00:19.00 08:00 09:30 1h 30 min 2 h
ipotesi 1 90 min € 0.75
0,50€ (tariffa oraria 0,50€/h per la prima ora) + 0,25€ (tariffa oraria 0,50€/h per la seconda ora frazionata per 30 minuti)
ipotesi 2 90 min € 1.00 € 1.00
0,50€ (tariffa oraria 0,50€/h per la prima ora) + 0,50€ (tariffa oraria 0,50€/h per la seconda ora non frazionabile) con sosta autorizzata fino alle ore 10:00
7
ZONA 10 - € 0,50/h
08:00 19:00 Lun-
Sab 08.00:19.00 08:00 10:30 2h 30 min 12h
ipotesi 1 12 h € 2.00 € 2.00
2€ per le prime 12 ore (di conseguenza la sosta è autorizzata fino alle 19 ora fine orario pagamento )
8
ZONA 10 - € 0,50/h
08:00 19:00 Lun-
Sab 08.00:19.00
18:00 giorno 1
09:00 giorno
2 15 h 1+1
ipotesi 1 2 h € 1.00 € 1.00
0,50€ (tariffa oraria 0,50€/h per la prima ora) + 0,50€ (tariffa oraria 0,50€/h per la prima ora giorno 2)
ipotesi 2 2 h € 2.00
2€ per le prime 12 ore (di conseguenza la sosta è autorizzata fino alle 19 del giorno 2??)
Implementazione Ws Pag. 15
9
ZONA 10 - € 0,50/h
08:00 19:00 Lun-
Sab 08.00:19.00
10:00 giorno 1
16:00 giorno
2 30 h 9+8
ipotesi 1 17 h € 4.00 € 4.00
2 € (per le 9 h del giorno 1) + 2€
(per le 8 h del giorno 2)) con sosta autorizzata fino alle 19:00 del secondo giorno
10
ZONA 02 - € 1,00/h
08:00 23:00 Lun-
Sab 08.00:23.00 00:57 20:56
19h 59 min
12h 56
min
ipotesi 1
12h 56
min € 8.93 € 8.93
4 € (agevolazione 4€ per 8 h) + 4,93€ tariffa oraria 1€/h frazionata per le restanti 4h e 56 min)
11
ZONA 16 - € 0,50/h
08:00 03:00 Lun-
Sab 08.00:03.00
08:00 giorno 1
03:00 giorno
2 19 h - -
questa sosta non è possibile perché in zona 16 max 16 ore di sosta Oppure
SOSTA POSSIBILE FINO ALLE 24,00 PER UN IMPORTO DI 3€, DOPO OCCORRE ATTIVARE UNA NUOVA SOSTA
Piano di test - Procedura di accreditamento Prima fase
La procedura di accreditamento consiste in una serie di test che l’azienda svolge al fine di verificare il corretto calcolo tariffario, ed il corretto abbinamento fra il “Codice Via” e la relativa “Zona tariffaria” sia per quanto riguarda il tempo reale che per la rendicontazione.
Atac fornisce il piano di test per la verifica di tutte le tariffe che deve essere utilizzato dall’azienda. L’Azienda prima di comunicare la volontà di inizio della fase di test avrà avuto cura di testare tutte le sue procedure
Implementazione Ws Pag. 16 adoperando gli stessi strumenti che, una volta perfezionati, verranno utilizzati per la messa in produzione. Le
principali finalità di questa fase di test sono:
1) il corretto calcolo tariffario in tutte le zone tariffate.
2) Il corretto calcolo degli arrotondamenti
3) La verifica della tempistica relativa alla disponibilità delle informazioni.
4) Alcuni test di verifica effettuati con l’applicativo sviluppato dall’azienda.
La durata massima del test è di 15 giorni solari.
Il piano di test da utilizzare è indicato in Tabella 14.
Tabella 14
N° test case Zona Tariffaria
1 Inserimento di una sosta di 1 minuto per ogni Zona tariffaria tutte
2 Inserimento di una sosta di 2h per ogni zona tariffaria tutte
3 Una sosta di 06:30 durante l'orario di vigenza; Inizio Sosta alle ore 20:32 Zona 16
4 Una sosta di 19:00 h durante l'orario di vigenza Zona 1
5 Una sosta con inizio alle ore 07:40 e fine alle ore 09:12 Zona 1
6 Una sosta con inizio alle ore 08:00 per una durata di h 19:00 Zona 16
7 Una sosta di 1:30 Zona 16
8 Una sosta al di sotto dei 60 secondi qualsiasi
9 inserimento soste per i giorni 25 aprile , pasquetta, 2 novembre, 8 dicembre qualsiasi
10 Inserimento di una sosta con inizio alle ore 00:10 di domenica per le zone con vigenza lun-sab 11 Una sosta alle ore 01:00 di venerdì con fine alle ore 08:00 del venerdì Zona 62
12 Una sosta con inizio alle ore 00:15 di venerdì con fine il venerdì successivo (+7gg) 5:16 Zona 62 13 Una sosta di sabato con inizio alle ore 14:00 e fine di domenica ore 9:00 Zona 62
14 una sosta di oltre 12h ore di durata Zona 60 e 61
15 Una sosta di oltre le 16h ore di durata Zona 60,61,62
16 Una sosta di 16 ore con inizio alle ore 21:00 Zona 60 e 61
17 Una sosta di 16 ore Zona 60 e 61
18 Una sosta con inizio e fine in un giorno feriale in cui ricade una festività Zona 62 19 Una sosta con inizio alle ore 02:10 di domenica fino alle ore 08:10 del
lunedì successivo
Zona 16
20 Una sosta con inizio alle ore 02.00 di lunedì (giorno non festivo) della durata di 1 ora
Zona 16
Seconda fase
La seconda fase di test viene effettuata dalla Direzione Sosta allo scopo di verificare l’interfaccia della APP sviluppata dall’ azienda.
Aspetti relativi alla privacy
Per il trattamento dei dati personali e relativamente al dato “TARGA” l’azienda fornitrice del servizio deve riferirsi al vigente D.Lgs. 196/2003 in materia di privacy e del Regolamento europeo 679/2016 – GDPR.
Periodo di conservazione
Le aziende devono conservare I dati per un periodo minimo di 5 anni.
