ZTL Firenze Inserimento Automatico

Introduzione In seguito alla variazione dell ordinanza del giugno 2011 che regola la modalità di rilascio dei permessi portale per le categorie abilitate, non è più possibile trasmettere le targhe da autorizzare con un file giornaliero in quanto l orario di arrivo presso la struttura del veicolo, che determina la data di inizio e fine permesso, viene attributo automaticamente dal sistema all atto dell inserimento. Le autorimesse pubbliche hanno pertanto chiesto di fornire loro la possibilità di trasmettere le targhe in maniera automatizzata, nel momento che vengono registrate sui loro applicativi di gestione parcheggio. Il presente documento definisce le specifiche di interfaccia del servizio da utilizzare per la trasmissione dei dati al Portale, che consente di abilitare una targa all accesso ZTL, richiamabili con opportune implementazioni dagli applicativi in uso alle categorie abilitate. Pagina 2 di 7

1 Logica di funzionamento Il client dovrà connettersi via protocollo https al servizio fornendo i seguenti dati: CAMPO VALORI MAX LEN TIPO NULLO DESCRIZIONE utente 20 A N user id con cui l utente si è registrato al portale password 20 A N password con cui l utente si è registrato al portale codice fiscale 16 A N codice fiscale inserito al momento della registrazione targa 15 A N targa a cui si deve rilasciare il permesso targa italiana 0/1 1 N N targa italiana o straniera (italiana = 1, straniera = 0) tipo veicolo 1/2/3 1 N N tipo di veicolo associato alla targa (1 = Autoveicolo, 2 = Autocarro, 3 = Motoveicolo) nome A S nome della persona a cui viene rilasciato il permesso (obbligatorio solo per la categoria cognome A S cognome della persona a cui viene rilasciato il permesso (obbligatorio solo per la categoria comune A S comune di residenza della persona a cui viene rilasciato il permesso (obbligatorio solo per la categoria numero di contrassegno A S numero di contrassegno della persona a cui viene rilasciato il permesso (obbligatorio solo per la categoria (A = alfanumerico, N = numerico) Pagina 3 di 7

Una volta letti i dati il servizio effettuerà i seguenti controlli: - verifica delle credenziali di accesso - verifica se la password è scaduta - verifica se il codice fiscale, utente e password appartengono all utente amministratore o meno. Nel caso in cui si tratti di amministratore significa che il permesso va rilasciato per invalidi e quindi sarà un permesso H24 su settore tutti + corsie. In caso contrario il settore assegnato sarà quello associato all utente e l orario del permesso dipenderà dall ora di imputazione n ore con n che di pende dalla categoria di appartenenza dell utente - verifica del credito nel caso in cui l utente appartenga ad una categoria con permesso oneroso - in caso che i controlli effettuati abbiano dato esito positivo, si procede all inserimento del permesso - nel caso di permesso invalidi il settore assegnato è A + corsie, altrimenti il settore è quello assegnato all'utente che sta rilasiando il permesso - alla decurtazione del credito nel caso di permesso oneroso - all invio della mail nel caso di superamento della soglia del credito Il servizio risponderà una stringa contente le seguenti informazioni separate da carattere : codice_ritorno data_ora messaggio/errore Vediamo quali sono i codici di ritorno: -1 errore 0 OK 1 formato non corretto di uno dei campi richiesti 2 credenziali errate 3 password scaduta 4 credito insufficiente 5 errore nell inserimento del permesso 6 permesso già presente 7 categoria non abilitata 8 settore utente sconosciuto Pagina 4 di 7

2 Definizione delle strutture dati Il tracciato per lo scambio dati tra il client ed il servizio è specificato nel seguente file. <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace="http://ztl.autostrade.it" xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://ztl.autostrade.it" xmlns:intf="http://ztl.autostrade.it" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/xmlschema">  <wsdl:types> <schema elementformdefault="qualified" targetnamespace="http://ztl.autostrade.it" xmlns="http://www.w3.org/2001/xmlschema"> <element name="rilasciopermesso"> <complextype> <sequence> <element name="utente" type="xsd:string"/> <element name="password" type="xsd:string"/> <element name="codicefiscale" type="xsd:string"/> <element name="targa" type="xsd:string"/> <element name="targaitaliana" type="xsd:int"/> <element name="tipoveicolo" type="xsd:int"/> <element name="nome" type="xsd:string"/> <element name="cognome" type="xsd:string"/> <element name="comune" type="xsd:string"/> <element name="numerocontrassegno" type="xsd:string"/> </sequence> </complextype> </element> <element name="rilasciopermessoresponse"> <complextype> <sequence> <element name="rilasciopermessoreturn" type="xsd:string"/> </sequence> </complextype> </element> </schema> </wsdl:types> <wsdl:message name="rilasciopermessorequest"> <wsdl:part element="impl:rilasciopermesso" name="parameters"/> </wsdl:message> <wsdl:message name="rilasciopermessoresponse"> <wsdl:part element="impl:rilasciopermessoresponse" name="parameters"/> </wsdl:message> <wsdl:porttype name="rilascioautomaticopermesso"> <wsdl:operation name="rilasciopermesso"> <wsdl:input message="impl:rilasciopermessorequest" name="rilasciopermessorequest"/> <wsdl:output message="impl:rilasciopermessoresponse" name="rilasciopermessoresponse"/> </wsdl:operation> </wsdl:porttype> <wsdl:binding name="rilascioautomaticopermessosoapbinding" type="impl:rilascioautomaticopermesso"> <wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/> <wsdl:operation name="rilasciopermesso"> <wsdlsoap:operation soapaction=""/> <wsdl:input name="rilasciopermessorequest"> <wsdlsoap:body use="literal"/> </wsdl:input> <wsdl:output name="rilasciopermessoresponse"> <wsdlsoap:body use="literal"/> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="rilascioautomaticopermessoservice"> <wsdl:port binding="impl:rilascioautomaticopermessosoapbinding" name="rilascioautomaticopermesso"> <wsdlsoap:address location="https://ztl.comune.fi.it/tzi/services/rilascioautomaticopermesso "/> </wsdl:port> </wsdl:service> </wsdl:definitions> Pagina 5 di 7

3 Criticità del sistema Nel caso in cui il web service non sia disponibile, le strutture dovranno produrre ed inviare tramite mail all indirizzo scrivi@serviziallastrada.it, un file che SAS provvederà ad inserire con una procedura di import, analoga a quella già esistente. Pagina 6 di 7

Il tracciato del file sarà il seguente: CAMPO codice fiscale targa giorno arrivo ora arrivo VALORI/ FORMATO dd/mm/yyyy hh:mm targa italiana 0/1 tipo veicolo 1/2/3 nome cognome comune numero di contrassegno MAX LEN TIPO NULLO DESCRIZIONE 16 A N codice fiscale inserito al momento della registrazione 15 A N targa a cui si deve rilasciare il permesso 10 D N giorno arrivo presso la struttura 5 O N Ora arrivo presso la struttura 1 N N Indica se la targa è italiana o straniera (1 = italiana, 0 = straniera) 1 N N tipo di veicolo associato alla targa (1 = Autoveicolo, 2 = Autocarro, 3 = Motoveicolo) A S nome della persona a cui viene rilasciato il permesso (obbligatorio solo per la categoria A S cognome della persona a cui viene rilasciato il permesso ( obbligatorio solo per la categoria A S comune di residenza della persona a cui viene rilasciato il permesso ( obbligatorio solo per la categoria A S numero di contrassegno della persona a cui viene rilasciato il permesso ( obbligatorio solo per la categoria Il file sarà un di tipo csv con i campi separati dal carattere ; Pagina 7 di 7