Questo servizio è stato implementato per l’integrazione dei software terzi con il portale TE-Online. Le funzionalità esposte permettono di interrogare lo stato delle pratiche sul portale, ed inserire (precaricare) nuove domande di autorizzazione, in base ai dizionari e alle regole configurate su ogni singolo portale. Una volta precaricata la domanda, l’utente deve collegarsi sul portale per effettuare il pagamento e la firma del documento generato. Il sistema effettua una validazione sui dati prima di inoltrare la domanda in istruttoria.

 

Per accedere al servizio vengono rilasciate delle chiavi di abilitazione, da utilizzare in fase di autenticazione al servizio. Le chiavi devono essere combinate con una username e una password valide, registrate sul portale TE-Online, per generare un clientId, da passare alla funzione di Login. La stessa chiave può essere utilizzata su tutti i portali TE-Online, ma ogni Ente può decidere di bloccare l’accesso per determinate chiavi in caso di un utilizzo improprio del servizio. Le stesse chiavi devono essere utilizzate anche sul servizio di test:

http://tetest.transitieccezionali.com/WAMswf40/WSTrasportiEccezionali/WSTrasportiEccezionali.asmx

Di seguito la descrizione delle funzioni esposte dal servizio:

Funzione

Parametri

Descrizione

CheckUtenteAutenticato

(nessun parametro)

Verifica se è stata eseguita la login – che ci sia un utente in sessione

GetAgganciamentiAnagrafica

int pk_anagrafica

Restituisce gli agganciamenti tra Rimorchi e Motrici per una data Anagrafica

GetComuni

int fk_provincia

Restituisce la lista dei Comuni per Provincia

GetDatiAnagrafica

str picf_ragsoc

Cerca un’Anagrafica per Ragione sociale o Partita IVA

GetDocumentoUrl

int pk_documento

Restituisce un URL per il download del documento

GetElencoStrade

int pk_percorsopredefinito

Restituisce l’elenco delle tarde associate a un percorso predefinito

GetGestoriPratiche

(nessun parametro)

Restituisce l’elenco dei gestori pratiche sul portale – Anagrafiche uffici TE

GetGestoriStrade

(nessun parametro)

Restituisce l’elenco dei gestori strade per un gestore del portale (portale singolo Ente) – Anagrafiche Enti rilascianti i nullaosta

GetGestoriStrade2

int PK_AnagraficaGestore

Restituisce l’elenco dei gestori strade per un gestore del portale (portale multi Ente) – Anagrafiche Enti rilascianti i nullaosta

GetPercorsoPredefinito

(nessun parametro)

Restituisce l’elenco dei Percorsi predefiniti – Percorsi selezionabili sul portale, con le regole per il fltro in base alla domanda presentata

GetPratica

obj pratParams

Cerca una pratica in base ai parametri di ricerca (Codice pratica e Targa principale)

GetPraticheInIntegrazione

obj gpiParams

Restituisce l’elenco delle pratiche in attesa di integrazione in base ai parametri di ricerca (PK_Utente)

GetProvince

int fk_regione

Restituisce l’elenco delle Province per una data Regione

GetRegioni

(nessun parametro)

Restituisce l’elenco delle Regioni italiane

GetStato

(nessun parametro)

Restituisce l’elenco delle Nazioni – Stati registrati nell’anagrafica

GetStatoPratiche

obj praticaFilter

Restituisce un elenco (tabella) di pratiche in base ai parametri di ricerca (Richiedente, Codice pratica, periodo validità, altro)

GetTarghe

int pk_anagrafica, str targa

Restituisce un elenco di Targhe per un Anagrafica, cercando per numero targa

GetTipoAllegato

(nessun parametro)

Restituisce il dizionario dei tipi di allegato

GetTipoAsse

(nessun parametro)

Restituisce il dizionario dei tipi di asse

GetTipoAttrezzo

(nessun parametro)

Restituisce il dizionario dei tipi di attrezzature agricole

GetTipoComunicazione

(nessun parametro)

Restituisce il dizionario dei tipi di comunicazioni di viaggio

GetTipoDocumento

(nessun parametro)

Restituisce il dizionario dei tipi di documento

GetTipoMateriale

(nessun parametro)

Restituisce il dizionario dei tipi di materiale trasportato

GetTipoMezzo

(nessun parametro)

Restituisce il dizionario dei tipi di convlgio (Motrice/Trattore con Rimorchio/Semirimorchio, Veicolo isolato, altro)

GetTipoOggettoAllegato

(nessun parametro)

Restituisce il dizionario dei tipi di oggetto utilizzati per definire gli allegati obbligatori

GetTipoPercorso

(nessun parametro)

Restituisce il dizionario dei tipi di oggetti che definiscono un Percorso (Partenza, Intermedio, Arrivo, Elenco strade, altro)

GetTipoPratica

(nessun parametro)

Restituisce il dizionario dei tipi pratica definiti sul portale (Agricola, Periodica 2a, Singola/Multipla, altro)

GetTipoScorta

(nessun parametro)

Restituisce il dizionario delle voci che definiscono la scorta prescritta dall’istruttore.

GetTipoTarga

(nessun parametro)

Restituisce il dizionario dei tipi di mezzo (Motrice, Rimorchio, Carrello)

GetTipoVersamentiUsura

(nessun parametro)

Restituisce il dizionario dei tipi di versamento usura (Usura on dovuta, Usura analitica, Usura convenzionale, altro)

GetUtente

obj guParams

Restituisce un Utente in base ai parametri di ricerca (PK_Utente, Username)

InserisciComunicazione

obj icParams

Inserisce una comunicazione di viaggio con i parametri specificati (Codice pratica, Targa veicolo, Numero Data e Ora viaggio, altro)

InsertPratica

obj pratica

Inserisce (precarica) una domanda di autroizzazione, con i dati specificati (Richeidente, Tipo pratica, Veicolo, Periodo validità, altro)

Login

str username, str passwd, str clienId

Effettua l’autenticazione sul servizio. Username e password registrati sul portale TE, clientId generato a partire dalla chiave di abilitazione

SetPratica

(obsolete)

Sostituita dalla funzione InsertPratica, che permette di passare più parametri al portale TE (lasciata per retrocompatibilità)

UpdateTarga

(obsolete)

Sostituita dalla funzione UpdateTargaByPK, che permette di passare più parametri al portale TE (lasciata per retrocompatibilità)

UpdateTargaByPK

obj targa

Aggiorna i dati di un veicolo, in particolare la Data di revisione, verificata in fase di inserimento della domanda