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 |
|
(nessun parametro) |
Verifica se è stata eseguita la login – che ci sia un utente in sessione |
|
|
int pk_anagrafica |
Restituisce gli agganciamenti tra Rimorchi e Motrici per una data Anagrafica |
|
|
int fk_provincia |
Restituisce la lista dei Comuni per Provincia |
|
|
str picf_ragsoc |
Cerca un’Anagrafica per Ragione sociale o Partita IVA |
|
|
int pk_documento |
Restituisce un URL per il download del documento |
|
|
int pk_percorsopredefinito |
Restituisce l’elenco delle tarde associate a un percorso predefinito |
|
|
(nessun parametro) |
Restituisce l’elenco dei gestori pratiche sul portale – Anagrafiche uffici TE |
|
|
(nessun parametro) |
Restituisce l’elenco dei gestori strade per un gestore del portale (portale singolo Ente) – Anagrafiche Enti rilascianti i nullaosta |
|
|
int PK_AnagraficaGestore |
Restituisce l’elenco dei gestori strade per un gestore del portale (portale multi Ente) – Anagrafiche Enti rilascianti i nullaosta |
|
|
(nessun parametro) |
Restituisce l’elenco dei Percorsi predefiniti – Percorsi selezionabili sul portale, con le regole per il fltro in base alla domanda presentata |
|
|
obj pratParams |
Cerca una pratica in base ai parametri di ricerca (Codice pratica e Targa principale) |
|
|
obj gpiParams |
Restituisce l’elenco delle pratiche in attesa di integrazione in base ai parametri di ricerca (PK_Utente) |
|
|
int fk_regione |
Restituisce l’elenco delle Province per una data Regione |
|
|
(nessun parametro) |
Restituisce l’elenco delle Regioni italiane |
|
|
(nessun parametro) |
Restituisce l’elenco delle Nazioni – Stati registrati nell’anagrafica |
|
|
obj praticaFilter |
Restituisce un elenco (tabella) di pratiche in base ai parametri di ricerca (Richiedente, Codice pratica, periodo validità, altro) |
|
|
int pk_anagrafica, str targa |
Restituisce un elenco di Targhe per un Anagrafica, cercando per numero targa |
|
|
(nessun parametro) |
Restituisce il dizionario dei tipi di allegato |
|
|
(nessun parametro) |
Restituisce il dizionario dei tipi di asse |
|
|
(nessun parametro) |
Restituisce il dizionario dei tipi di attrezzature agricole |
|
|
(nessun parametro) |
Restituisce il dizionario dei tipi di comunicazioni di viaggio |
|
|
(nessun parametro) |
Restituisce il dizionario dei tipi di documento |
|
|
(nessun parametro) |
Restituisce il dizionario dei tipi di materiale trasportato |
|
|
(nessun parametro) |
Restituisce il dizionario dei tipi di convlgio (Motrice/Trattore con Rimorchio/Semirimorchio, Veicolo isolato, altro) |
|
|
(nessun parametro) |
Restituisce il dizionario dei tipi di oggetto utilizzati per definire gli allegati obbligatori |
|
|
(nessun parametro) |
Restituisce il dizionario dei tipi di oggetti che definiscono un Percorso (Partenza, Intermedio, Arrivo, Elenco strade, altro) |
|
|
(nessun parametro) |
Restituisce il dizionario dei tipi pratica definiti sul portale (Agricola, Periodica 2a, Singola/Multipla, altro) |
|
|
(nessun parametro) |
Restituisce il dizionario delle voci che definiscono la scorta prescritta dall’istruttore. |
|
|
(nessun parametro) |
Restituisce il dizionario dei tipi di mezzo (Motrice, Rimorchio, Carrello) |
|
|
(nessun parametro) |
Restituisce il dizionario dei tipi di versamento usura (Usura on dovuta, Usura analitica, Usura convenzionale, altro) |
|
|
obj guParams |
Restituisce un Utente in base ai parametri di ricerca (PK_Utente, Username) |
|
|
obj icParams |
Inserisce una comunicazione di viaggio con i parametri specificati (Codice pratica, Targa veicolo, Numero Data e Ora viaggio, altro) |
|
|
obj pratica |
Inserisce (precarica) una domanda di autroizzazione, con i dati specificati (Richeidente, Tipo pratica, Veicolo, Periodo validità, altro) |
|
|
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 |
|
|
(obsolete) |
Sostituita dalla funzione InsertPratica, che permette di passare più parametri al portale TE (lasciata per retrocompatibilità) |
|
|
(obsolete) |
Sostituita dalla funzione UpdateTargaByPK, che permette di passare più parametri al portale TE (lasciata per retrocompatibilità) |
|
|
obj targa |
Aggiorna i dati di un veicolo, in particolare la Data di revisione, verificata in fase di inserimento della domanda |
