Sei sulla pagina 1di 138

>> Specifiche Integrazione Web Services

RTI

Gestione Richieste Patenti Web


Servizio di Sviluppo
SVI

Specifiche integrazione WebServices.doc

Versione 2.2-31/01/2011
Uso esterno Riservato al Cliente

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Indice dei contenuti


GENERALITA ............................................................................................................ 6
1.1 Lista di distribuzione .......................................................................................... 6
1.2 Tabella delle versioni ......................................................................................... 6
1.3 Definizioni e acronimi ........................................................................................ 6
2 INTRODUZIONE .......................................................................................................... 7
2.1 Scopo del documento ......................................................................................... 7
2.2 Applicabilit ....................................................................................................... 7
3 SPECIFICHE DI INTEGRAZIONE ....................................................................................... 8
3.1 Modalit di integrazione..................................................................................... 8
3.2 Autenticazione e autorizzazione......................................................................... 8
3.2.1
Specifiche dello schema XSD di Input..................................................... 8
4 SERVIZI DI GESTIONE RICHIESTE PATENTI WEB. ................................................................. 9
4.1 Servizio di CANCELLAZIONE PRENOTAZIONE PATENTE .................................... 10
4.1.1
Definizione ........................................................................................... 10
4.1.2
Specifiche dello schema XSD di Input................................................... 10
4.1.3
Specifiche dello schema XSD di Output................................................. 11
4.2 Servizio di VISUALIZZAZIONE FACSIMILE PRENOTAZIONE.............................. 12
4.2.1
Definizione ........................................................................................... 12
4.2.2
Specifiche dello schema XSD di Input................................................... 13
4.2.3
Specifiche dello schema XSD di Output................................................. 13
4.3 Servizio di VISUALIZZAZIONE DETTAGLIO PRENOTAZIONE PER CONVERSIONE
14
4.3.1
Definizione ........................................................................................... 15
4.3.2
Specifiche dello schema XSD di Input................................................... 15
4.3.3
Specifiche dello schema XSD di Output................................................. 16
4.4 Servizio di VISUALIZZAZIONE DETTAGLIO PRENOTAZIONE PER DUPLICATO... 18
4.4.1
Definizione ........................................................................................... 18
4.4.2
Specifiche dello schema XSD di Input................................................... 19
4.4.3
Specifiche dello schema XSD di Output................................................. 20
4.5 Servizio di INSERIMENTO PRENOTAZIONE PER CONVERSIONE........................ 22
4.5.1
Definizione ........................................................................................... 22
4.5.2
Specifiche dello schema XSD di Input................................................... 22
4.5.3
Specifiche dello schema XSD di Output................................................. 24
4.6 Servizio di INSERIMENTO PRENOTAZIONE PER DUPLICATO ............................ 26
4.6.1
Definizione ........................................................................................... 26
4.6.2
Specifiche dello schema XSD di Input................................................... 27
4.6.3
Specifiche dello schema XSD di Output................................................. 29
4.7 Servizio di MODIFICA PRENOTAZIONE PER CONVERSIONE .............................. 31
4.7.1
Definizione ........................................................................................... 31
4.7.2
Specifiche dello schema XSD di Input................................................... 31
4.7.3
Specifiche dello schema XSD di Output................................................. 33
4.8 Servizio di MODIFICA PRENOTAZIONE PER DUPLICATO................................... 35
4.8.1
Definizione ........................................................................................... 36
1

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 2 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Specifiche dello schema XSD di Input................................................... 36


4.8.2
4.8.3
Specifiche dello schema XSD di Output................................................. 38
4.9 Servizio di RICERCA PRENOTAZIONE ............................................................... 40
4.9.1
Definizione ........................................................................................... 40
4.9.2
Specifiche dello schema XSD di Input................................................... 41
4.9.3
Specifiche dello schema XSD di Output................................................. 43
4.10
Servizio di CANCELLAZIONE RICHIESTA ESAME ......................................... 44
4.10.1
Definizione ........................................................................................... 45
4.10.2
Specifiche dello schema XSD di Input................................................... 45
4.10.3
Specifiche dello schema XSD di Output................................................. 46
4.11
Servizio di VISUALIZZAZIONE DETTAGLIO RICHIESTA PER ESAME ............ 47
4.11.1
Definizione ........................................................................................... 47
4.11.2
Specifiche dello schema XSD di Input................................................... 48
4.11.3
Specifiche dello schema XSD di Output................................................. 49
4.12
Servizio di INSERIMENTO RICHIESTA PER ESAME ...................................... 51
4.12.1
Definizione ........................................................................................... 51
4.12.2
Specifiche dello schema XSD di Input................................................... 52
4.12.3
Specifiche dello schema XSD di Output................................................. 53
4.13
Servizio di MODIFICA RICHIESTA PER ESAME ............................................ 55
4.13.1
Definizione ........................................................................................... 55
4.13.2
Specifiche dello schema XSD di Input................................................... 56
4.13.3
Specifiche dello schema XSD di Output................................................. 58
4.14
Servizio di RICERCA RICHIESTA ESAME ...................................................... 60
4.14.1
Definizione ........................................................................................... 61
4.14.2
Specifiche dello schema XSD di Input................................................... 61
4.14.3
Specifiche dello schema XSD di Output................................................. 63
4.15
Servizio di FACSIMILE RICHIESTA ESAME .................................................. 65
4.15.1
Definizione ........................................................................................... 65
4.15.2
Specifiche dello schema XSD di Input................................................... 66
4.15.3
Specifiche dello schema XSD di Output................................................. 67
4.16
Servizio di RICERCA FOGLIO ROSA PER PRIMA STAMPA............................. 67
4.16.1
Definizione ........................................................................................... 68
4.16.2
Specifiche dello schema XSD di Input................................................... 68
4.16.3
Specifiche dello schema XSD di Output................................................. 69
4.17
Servizio di STAMPA FOGLIO ROSA .............................................................. 70
4.17.1
Definizione ........................................................................................... 71
4.17.2
Specifiche dello schema XSD di Input................................................... 71
4.17.3
Specifiche dello schema XSD di Output................................................. 72
4.18
Servizio di RICERCA FOGLIO ROSA PER RISTAMPA..................................... 73
4.18.1
Definizione ........................................................................................... 74
4.18.2
Specifiche dello schema XSD di Input................................................... 74
4.18.3
Specifiche dello schema XSD di Output................................................. 75
4.19
Servizio di RISTAMPA FOGLIO ROSA .......................................................... 76
4.19.1
Definizione ........................................................................................... 77
4.19.2
Specifiche dello schema XSD di Input................................................... 77
4.19.3
Specifiche dello schema XSD di Output................................................. 78
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 3 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5 APPENDICE A: COMMON TYPES .....................................................................................79


DI SEGUITO VIENE FORNITA LA DESCRIZIONE DEI COMMON TYPE UTILIZZATI DAI SERVIZI. .................79
5.1 Tipi Complessi .................................................................................................. 79
5.1.1
LoginType............................................................................................. 79
5.1.2
MessaggioType ..................................................................................... 80
5.1.3
ErrorType ............................................................................................. 80
5.1.4
LuogoResidenzaType ............................................................................ 81
5.1.5
LuogoNascitaType ................................................................................ 82
5.1.6
LuogoNascitaItalianoType .................................................................... 83
5.1.7
LuogoNascitaEsteroType ...................................................................... 83
5.1.8
LuogoNascitaEsteroRicercaType ........................................................... 84
5.1.9
AnagraficaRichiedenteType .................................................................. 85
5.1.10
AnagraficaCompattaType ..................................................................... 86
5.1.11
DatiAnagraficiRicercaType.................................................................... 87
5.1.12
TipoAnagraficaSpecialeType ................................................................. 88
5.1.13
PatenteItalianaType ............................................................................. 88
5.1.14
ElencoPrescrizioniTecnicheType ........................................................... 89
5.1.15
DettaglioPrenotazioneConversioneType ............................................... 89
5.1.16
DettaglioPrenotazioneDuplicatoType.................................................... 93
5.1.17
InserimentoPrenotazioneConversioneType .......................................... 96
5.1.18
InserimentoPrenotazioneDuplicatoType............................................... 99
5.1.19
ElencoAnomalieType .......................................................................... 101
5.1.20
IdentificativoRichiestaEsameType ...................................................... 101
5.1.21
DettaglioRichiestaEsameEstesoType .................................................. 103
5.1.22
DatiRichiestaEsameType .................................................................... 106
5.1.23
LuogoNascitaRicercaType................................................................... 108
5.1.24
DettaglioPrenotazioneConversioneOutputType .................................. 108
5.1.25
DettaglioPrenotazioneDuplicatoOutputType ....................................... 108
5.1.26
IdentificativoPrenotazioneType.......................................................... 108
5.1.27
DettaglioRichiestaEsameOutputType.................................................. 108
5.1.28
DocumentoOutputRichiestaEsameType .............................................. 108
5.1.29
DettaglioPrenotazioneType ................................................................ 108
5.1.30
DettaglioRichiestaType....................................................................... 108
5.1.31
DettaglioFoglioRosaType .................................................................... 108
5.2 Tipi Semplici................................................................................................... 108
5.2.1
MarcaOperativaPrenotazioneType ...................................................... 108
5.2.2
MotivoRichiestaConversioneType ....................................................... 108
5.2.3
MotivoRichiestaDuplicatoType............................................................ 108
5.2.4
ElencoMotivoRichiestaType ................................................................ 108
5.2.5
StatoPrenotazioneType ...................................................................... 108
5.2.6
PatenteEsteraType ............................................................................. 108
5.2.7
MarcaOperativaType........................................................................... 108
5.2.8
SiNoType ............................................................................................ 108
5.2.9
SessoType .......................................................................................... 108
5.2.10
FileType.............................................................................................. 108
5.2.11
IndCategoriaAType............................................................................. 108
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 4 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

CambioManualeConvEsteraType ......................................................... 108


5.2.12
5.2.13
CategoriaDisponibileType ................................................................... 108
5.2.14
CategoriaRichiestaType ...................................................................... 108
5.2.15
PrescrizioniTecnicheType ................................................................... 108
5.2.16
CharDue ............................................................................................. 108
5.2.17
CharQuattro........................................................................................ 108
5.2.18
CharCinque ......................................................................................... 108
5.2.19
CharSei ............................................................................................... 108
5.2.20
CharOtto............................................................................................. 108
5.2.21
CharDieci ............................................................................................ 108
5.2.22
CharSedici .......................................................................................... 108
5.2.23
VarCharOtto ....................................................................................... 108
5.2.24
VarCharDieci....................................................................................... 108
5.2.25
MarcaOperativaRichiestaEsameType .................................................. 108
5.2.26
StatoRichiestaType............................................................................. 108
5.2.27
MarcaOperativaFoglioRosaType.......................................................... 108
5.2.28
VarCharVentidue ................................................................................ 108
5.2.29
VarCharTrentacinque.......................................................................... 108
5.2.30
VarCharTrentacinqueMinLenghtZero .................................................. 108
5.2.31
VarCharTrenta .................................................................................... 108
5.2.32
VarCharCinque ................................................................................... 108
6 APPENDICE B: GESTIONE ANAGRAFICHE SPECIALI............................................................ 108
6.1 Regole per inserire/modificare una anagrafica speciale ................................ 108
6.2 Regole per ricercare una anagrafica speciale ................................................. 108
6.3 Tabella caratteri diacritici ammessi................................................................ 108

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 5 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

GENERALITA

1.1

Lista di distribuzione
Ruolo

Organizzazione

Responsabile del Servizio

Servizio SVI

Program Office

RTI

Responsabile del Progetto

RTI

Direttore dei Lavori

Ministero dei Trasporti Dipartimento per i


Trasporti Terrestri Direzione Generale per la
Motorizzazione

1.2

1.3

Tabella delle versioni


Versione

Data

Note

1.0

29-03-2010

Nascita del documento

1.1

07-10-2010

2.0

16-12-2010

2.1

17-01-2011

Modificato il paragrafo 5.1.4 ed aggiunti i


paragrafi 5.1.29, 5.1.30 e 5.1.31
aggiunti i paragrafi 4.17,4.17 e modificato il
4.20
Modificati tutti i paragrafi del capitolo 4 per
aggiunta delle URL accessibili da
www.ilportaledellautomobilista.it

2.2

31-01-2011

Eliminato ws emissione on line

Definizioni e acronimi
Termine

Definizione

DTT

Dipartimento per i Trasporti Terrestri appartenente al Ministero


dei Trasporti

RTI

Raggruppamento temporaneo di imprese che ha ottenuto


laggiudicazione del contratto Rep. 3198.
Costituito da EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per lInformatica
S.p.A.

SIDTT

Sistema Informativo Dipartimento Trasporti Terrestri

SIC

Sistema Informativo Centrale

Servizio SVI

Servizio di Sviluppo del software

SOAP

Simple Object Access Protocol

XML

eXtensible Markup Language

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 6 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Termine
XSD

2
2.1

Definizione
XML Schema Definition

INTRODUZIONE
Scopo del documento

Il presente documento intende fornire la specifica dei servizi, realizzati con la tecnologia dei
Web Services, per linserimento di prenotazioni di richieste di patente.
2.2

Applicabilit

I contenuti del documento si applicano alle attivit eseguite nellambito del Servizio SVI, per il
Sistema Informativo Centralizzato (SIC).

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 7 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

SPECIFICHE DI INTEGRAZIONE

3.1

Modalit di integrazione

I servizi per laccesso alle funzioni di prenotazione di richieste di patenti, sono realizzati con
Web Services che utilizzano lo standard SOAP per lo scambio di messaggi in formato XML. Tutti
i Web Services realizzati sono di tipo sincrono, il servizio viene eseguito immediatamente e la
comunicazione dellesito delloperazione viene fornita nella risposta.
3.2

Autenticazione e autorizzazione

Lautenticazione di un utente che intende lanciare un web service avviene seguendo quanto
previsto dallo standard WS-Security.
Il messaggio SOAP da inviare per ogni web service contenuto in questo documento si compone
popolando opportunamente lheader e il body:

Per ogni web service, nellheader c il tag wsse:Security, che al suo interno contiene lo
UsernameToken, nel quale sono specificati username e password.

Nel body viene inserita la struttura della richiesta specifica.

3.2.1 Specifiche dello schema XSD di Input

Ogni richiesta deve essere composta dai seguenti elementi:

Header
o

Contiene le informazioni necessarie per lautenticazione e lautorizzazione


dellutente.

Body
o

Contiene il corpo della richiesta.

Esempio:
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 8 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<?xml version="1.0" encoding="UTF-8"?>


<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header>
<wsse:Security
xmlns:wsse="http://docs.oasisopen.org/wss/2004/01/oasis-200401-wss-wssecurity-secext1.0.xsd"
SOAP-ENV:mustUnderstand="1">
<wsse:UsernameToken
xmlns:wsu="http://docs.oasisopen.org/wss/2004/01/oasis-200401-wss-wssecurityutility-1.0.xsd"
wsu:Id="XWSSGID-1253605895203984534550">
<wsse:Username>OFBGAB1001</wsse:Username>
<wsse:Password
Type="http://docs.oasisopen.org/wss/2004/01/oasis-200401-wss-usernametoken-profile-1.0#PasswordText">
****
</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
Inserire qui il corpo di ogni web service specifico come descritto nei
capitoli seguenti
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
4

SERVIZI DI GESTIONE RICHIESTE PATENTI WEB.

Questi servizi permetteranno la gestione di una prenotazione di una richiesta di patente, per i
motivi richiesta deterioramento, smarrimento, riclassificazione, conversione estera,
conversione militare ed esame.
Per i dettagli su obbligatoriet di informazioni per ogni singolo servizio e quant altro concerne
una prenotazione, si potr fare riferimento al manuale utente della applicazione Gestione
Richieste Patenti Web.
Gli esiti delle richieste saranno fornite nel messaggio XML di risposta, come indicato pi avanti
nel documento.
In fondo a questo documento viene fornita lappendice contenete i CommonTypes utilizzati
nellambito dei servizi web descritti.
Il manuale utente dellapplicazione web disponibile tramite un link sullapplicazione web.
Tutti i servizi passeranno per la validazione dellxsd.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 9 di 138

Specifiche Integrazione Web Services

4.1

Specifiche integrazione WebServices.doc

Servizio di CANCELLAZIONE PRENOTAZIONE PATENTE

Il servizio Cancellazione Prenotazione Patente permette agli operatori professionali di


cancellare fisicamente una prenotazione di richiesta di patente di competenza della specifica
agenzia o autoscuola.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una prenotazione, sono dettagliate nel manuale utente della applicazione Gestione Richieste
Patenti Web e sono definite negli XSD di Input e Output.
4.1.1 Definizione

Nome del
servizio

CancellazionePrenotazione.
Le URI possibili per richiamare il WS sono
/services/cancellazionePrenotazione
/services/cancellazionePrenotazionePIN (dal Portale dell'Automobilista)

Operazione

cancellazionePrenotazione

Input

Una stringa contenente il messaggio XML conforme allo schema descritto nella
sezione Specifiche dello schema XSD di Input di questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema descritto nella
sezione Specifiche dello schema XSD di Output di questo servizio.

Wsdl

Le uri possibili per reperire il file WSDL sono:


/services/cancellazionePrenotazione/cancellazionePrenotazione.wsdl
/services/cancellazionePrenotazionePIN/cancellazionePrenotazionePIN.wsdl

4.1.2 Specifiche dello schema XSD di Input


Lelemento che ci si aspetta in input cancellazionePrenotazioneRequest, di tipo
IdentificativoPrenotazioneType.
Lo schema composto dai seguenti elementi principali:

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 10 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata.

marcaOperativa: il campo chiave che consente di specificare quale prenotazione


deve essere cancellata. Il campo obbligatorio. La marca operativa deve soddisfare i
vincoli definiti nel MarcaOperativaPrenotazioneType, la cui struttura descritta
nellappendice CommonTypes in fondo a questo documento.

Esempio
<dtt:cancellazionePrenotazioneRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativa>75RM000489</dtt:marcaOperativa>
</dtt:cancellazionePrenotazioneRequest>
4.1.3 Specifiche dello schema XSD di Output
Lelemento inviato in output per questo servizio cancellazionePrenotazioneResponse, di
tipo EsitoCancellazioneType.
Lo schema composto dai seguenti elementi principali:

marcaOperativa, messaggio: restituiti se loperazione va a buon fine. La marca


operativa coincide con la marca operativa data in input al servizio.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine. Per la struttura dellErrorType si rimanda allappendice
CommonTypes.

Esempio
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 11 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:cancellazionePrenotazioneResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:marcaOperativa>75RM000490</dtt:marcaOperativa>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di cancellazione eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:cancellazionePrenotazioneResponse>

4.2

Servizio di VISUALIZZAZIONE FACSIMILE PRENOTAZIONE

Il servizio Visualizzazione Facsimile Prenotazione permette agli operatori professionali di


visualizzare lanteprima di una patente di competenza della specifica agenzia o autoscuola.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una prenotazione, sono dettagliate nel manuale utente della applicazione Gestione Richieste
Patenti Web e sono definite negli XSD di Input e Output.
4.2.1 Definizione

Nome del
servizio

FacsimilePrenotazione
Le URI possibili per richiamare il WS sono:
/services/facsimilePrenotazione
/services/facsimilePrenotazionePIN (dal Portale dell'Automobilista )

Operazione

facsimilePrenotazione

Input

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Input di questo
servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Output di
questo servizio.

Wsdl

Le uri possibili per reperire il file WSDL sono:


/services/facsimilePrenotazione/facsimilePrenotazione.wsdl

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 12 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

/services/facsimilePrenotazionePIN/facsimilePrenotazionePIN.wsdl

4.2.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta
IdentificativoPrenotazioneType.

in

input

facsimilePrenotazioneRequest,

di

tipo

Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata.

marcaOperativa: il campo chiave che consente di specificare la prenotazione per cui


deve essere visualizzato il facsimile. Il campo obbligatorio. La marca operativa deve
soddisfare i vincoli definiti nel MarcaOperativaPrenotazioneType, la cui struttura
descritta nellappendice CommonTypes in fondo a questo documento.

Esempio
<dtt:facsimilePrenotazioneRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativa>75RM000347</dtt:marcaOperativa>
</dtt:facsimilePrenotazioneRequest>

4.2.3 Specifiche dello schema XSD di Output


Lelemento inviato in output per questo servizio facsimilePrenotazioneResponse, di tipo
DocumentoOutputPrenotazioneType.
Lo schema composto dai seguenti elementi principali:

marca operativa, facsimile, messaggio: restituiti se loperazione va a buon fine. Il


campo facsimile contiene il pdf dellanteprima della patente. La marca operativa
coincide con la marca operativa data in input al servizio. Per la struttura dei sottotipi
utilizzati si rimanda allappendice CommonTypes.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 13 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine. Per la struttura dellErrorType si rimanda allappendice
CommonTypes.

Esempio
<dtt:facsimilePrenotazioneResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:marcaOperativa>75RM000347</dtt:marcaOperativa>
<dtt:facsimile>JVBERi0xLjQKJeLjz9MKMSAwIG9iaiA8PC9GaWx0ZX</dtt:facsimile>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di visualizzazione facsimile eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:facsimilePrenotazioneResponse>

4.3

Servizio di VISUALIZZAZIONE DETTAGLIO PRENOTAZIONE PER CONVERSIONE

Il servizio Visualizzazione Dettaglio Prenotazione per Conversione permette agli operatori


professionali di visualizzare il dettaglio di una prenotazione di richiesta di patente, per
conversione Militare o Estera, di competenza della specifica agenzia o autoscuola.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una prenotazione, sono dettagliate nel manuale utente della applicazione Gestione Richieste
Patenti Web e sono definite negli XSD di Input e Output.
4.3.1 Definizione

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 14 di 138

Specifiche Integrazione Web Services

Nome del
servizio

Specifiche integrazione WebServices.doc

DettaglioPrenotazioneConversione
Le URI possibili per richiamare il WS sono:
/services/dettaglioPrenotazioneConversione
/services/dettaglioPrenotazioneConversionePIN (dal Portale dell'Automobilista)

Operazione

dettaglioPrenotazioneConversione

Input

Una stringa contenente il messaggio XML conforme allo schema descritto nella
sezione Specifiche dello schema XSD di Input di questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema descritto nella
sezione Specifiche dello schema XSD di Output di questo servizio.

Wsdl

Le uri possibili per reperire il file WSDL sono:


/services/dettaglioPrenotazioneConversione/dettaglioPrenotazioneConversione.wsdl
/services/dettaglioPrenotazioneConversionePIN/dettaglioPrenotazioneConversionePIN.wsdl

4.3.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta in input dettaglioPrenotazioneConversioneRequest, di tipo
IdentificativoPrenotazioneType.
Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata.

marcaOperativa: il campo chiave che consente di specificare per quale prenotazione


si desidera visualizzare il dettaglio. Il campo obbligatorio. La marca operativa deve
soddisfare i vincoli definiti nel MarcaOperativaPrenotazioneType, la cui struttura
descritta nellappendice CommonTypes in fondo a questo documento.

Esempio
<dtt:dettaglioPrenotazioneConversioneRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 15 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativa>75RM000242</dtt:marcaOperativa>
</dtt:dettaglioPrenotazioneConversioneRequest>

4.3.3 Specifiche dello schema XSD di Output


Lelemento di output per questo servizio dettaglioPrenotazioneConversioneResponse, di
tipo DettaglioPrenotazioneConversioneOutputType.
Lo schema composto dai seguenti elementi principali:

dettaglioPrenotazioneConversione, messaggio: restituiti se loperazione va a buon


fine. La marca operativa coincide con la marca operativa data in input al servizio. I
campi definiti per DettaglioPrenotazioneConversioneType coincidono con loutput della
corrispettiva maschera dellapplicazione web GestioneRichiestePatentiWeb, per cui si
rimanda al manuale. La descrizione della struttura dei tipi contenuti in
DettaglioPrenotazioneConversioneType e di MessaggioType fornita nellappendice
CommonTypes in fondo a questo documento.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 16 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:dettaglioPrenotazioneConversioneResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:dettaglioPrenotazioneConversione>
<dtt:marcaOperativa>75RM000242</dtt:marcaOperativa>
<dtt:statoPrenotazione>APPROVATA</dtt:statoPrenotazione>
<dtt:dataVariazioneStato>2009-06-04</dtt:dataVariazioneStato>
<dtt:dataApprovazione>2009-06-04</dtt:dataApprovazione>
<dtt:dataInserimento>2009-06-04</dtt:dataInserimento>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>ESTERA</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>SANTE</dtt:nome>
<dtt:cognome>TEODOLI</dtt:cognome>
<dtt:dataNascita>1941-09-07</dtt:dataNascita>
<dtt:codiceFiscale>TDLSNT41P07H501Y</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZgAASUkqAAgAAAAA</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>ROMA</dtt:provinciaNascita>
<dtt:comuneNascita>ROMA</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 17 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:provinciaResidenza>ROMA</dtt:provinciaResidenza>
<dtt:comuneResidenza>ROMA</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>90</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>A1 = A1</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>A1</dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCatA>N</dtt:cambioAutomaticoCatA>
<dtt:dataAbilitazioneCategoriaA>2008-10-10</dtt:dataAbilitazioneCategoriaA>
<dtt:abilitazioneCategoriaA>1</dtt:abilitazioneCategoriaA>
<dtt:patenteItalianaPrecedente/>
<dtt:patenteEstera>AA78782332</dtt:patenteEstera>
<dtt:statoEsteroRilascio>ANTILLE OL.</dtt:statoEsteroRilascio>
<dtt:elencoAnomalie/>
</dtt:dettaglioPrenotazioneConversione>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di visualizzazione del dettaglio della
prenotazione eseguita con successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:dettaglioPrenotazioneConversioneResponse>

4.4

Servizio di VISUALIZZAZIONE DETTAGLIO PRENOTAZIONE PER DUPLICATO

Il servizio Visualizzazione Dettaglio Prenotazione per Duplicato permette agli operatori


professionali di visualizzare il dettaglio di una prenotazione di richiesta di patente per
Deterioramento, Riclassificazione e Smarrimento, di competenza della specifica agenzia o
autoscuola.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una prenotazione, sono dettagliate nel manuale utente della applicazione Gestione Richieste
Patenti Web e sono definite negli XSD di Input e Output.
4.4.1 Definizione

Nome del
servizio

DettaglioPrenotazioneDuplicato
Le URI possibili per richiamare il WS sono :
/services/ dettaglioPrenotazioneDuplicato
/services/dettaglioPrenotazioneDuplicatoPIN (dal Portale dell'Automobilista)

Operazione

dettaglioPrenotazioneDuplicato

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 18 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Input

Una stringa contenente il messaggio XML conforme allo schema descritto nella
sezione Specifiche dello schema XSD di Input di questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema descritto nella
sezione Specifiche dello schema XSD di Output di questo servizio.

Wsdl

Le uri possibili per reperire il file WSDL sono:


/services/dettaglioPrenotazioneDuplicato/dettaglioPrenotazioneDuplicato.wsdl
/services/dettaglioPrenotazioneDuplicatoPIN/dettaglioPrenotazioneDuplicatoPIN.wsdl

4.4.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta in input dettaglioPrenotazioneDuplicatoRequest, di tipo
IdentificativoPrenotazioneType.
Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata.

marcaOperativa: il campo chiave che consente di specificare per quale prenotazione


si desidera visualizzare il dettaglio. Il campo obbligatorio. La marca operativa deve
soddisfare i vincoli definiti nel MarcaOperativaPrenotazioneType, la cui struttura
descritta nellappendice CommonTypes in fondo a questo documento.

Esempio
<dtt:dettaglioPrenotazioneDuplicatoRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativa>75RM000347</dtt:marcaOperativa>
</dtt:dettaglioPrenotazioneDuplicatoRequest>

4.4.3 Specifiche dello schema XSD di Output


Lelemento di output per questo servizio dettaglioPrenotazioneDuplicatoResponse, di
tipo DettaglioPrenotazioneDuplicatoOutputType.
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 19 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Lo schema composto dai seguenti elementi principali:

dettaglioPrenotazioneDuplicato, messaggio: restituiti se loperazione va a buon


fine. La marca operativa coincide con la marca operativa data in input al servizio. I
campi definiti per DettaglioPrenotazioneDuplicatoType coincidono con loutput della
corrispettiva maschera dellapplicazione web GestioneRichiestePatentiWeb, per cui si
rimanda al manuale. La descrizione della struttura dei tipi contenuti in
DettaglioPrenotazioneDuplicatoType e di MessaggioType fornita nellappendice
CommonTypes in fondo a questo documento.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

Esempio
<dtt:dettaglioPrenotazioneDuplicatoResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:dettaglioPrenotazioneDuplicato>
<dtt:marcaOperativa>75RM000347</dtt:marcaOperativa>
<dtt:statoPrenotazione>INSERITA</dtt:statoPrenotazione>
<dtt:dataVariazioneStato>2009-07-27</dtt:dataVariazioneStato>
<dtt:dataInserimento>2009-07-27</dtt:dataInserimento>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>DETERIORAMENTO</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>DADOL</dtt:nome>
<dtt:cognome>DADA</dtt:cognome>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 20 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:dataNascita>1962-02-16</dtt:dataNascita>
<dtt:codiceFiscale>DDADDL62B16B963W</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZgAASUkqAA</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>CASERTA</dtt:provinciaNascita>
<dtt:comuneNascita>CASERTA</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>AGRIGENTO</dtt:provinciaResidenza>
<dtt:comuneResidenza>AGRIGENTO</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>99</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>A3 = A3</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>A3</dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCategA>N</dtt:cambioAutomaticoCategA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA ACCOMPAGNATO DA TITOLARE DI
PATENTE</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA IN ORARIO
DIURNO</dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
<dtt:patentePrecedente>
<dtt:numeroPatente>RM1234789</dtt:numeroPatente>
</dtt:patentePrecedente>
<dtt:elencoAnomalie>
<dtt:anomalia>PRESCRIZIONI TECNICHE DIFFERENTI DA PATENTE
POSSEDUTA</dtt:anomalia>
<dtt:anomalia>DATA SCADENZA PATENTE POSSEDUTA ASSENTE</dtt:anomalia>
</dtt:elencoAnomalie>
</dtt:dettaglioPrenotazioneDuplicato>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di visualizzazione del dettaglio della
prenotazione eseguita con successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:dettaglioPrenotazioneDuplicatoResponse>
4.5

Servizio di INSERIMENTO PRENOTAZIONE PER CONVERSIONE

Il servizio Inserimento Prenotazione per Conversione permette agli operatori professionali di


inserire una prenotazione di richiesta di patente per conversione Militare ed Estera, di
competenza della specifica agenzia o autoscuola.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 21 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne


una prenotazione, sono dettagliate nel manuale utente della applicazione Gestione Richieste
Patenti Web e sono definite negli XSD di Input e Output.
4.5.1 Definizione

Nome del
servizio

InserimentoPrenotazioneConversione
Le URI possibili per richiamare il WS sono:
/services/inserimentoPrenotazioneConversione
/services/inserimentoPrenotazioneConversionePIN (dal Portale dell'Automobilista)

Operazione

inserimentoPrenotazioneConversione

Input

Una stringa contenente il messaggio XML conforme allo schema descritto nella sezione
Specifiche dello schema XSD di Input di questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema


DettaglioPrenotazioneConversioneOutput.xsd, contenente lesito della richiesta e gli eventuali
dati da trasmettere associati alla richiesta effettuata.

Wsdl

Le uri possibili per reperire il file WSDL sono:


/services/inserimentoPrenotazioneConversione/inserimentoPrenotazioneConversione.wsdl
/services/inserimentoPrenotazioneConversionePIN/inserimentoPrenotazioneConversionePIN.wsdl

4.5.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta in input inserimentoPrenotazioneConversioneRequest, di
tipo InserimentoPrenotazioneConversioneInputType.
Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata.

inserimentoPrenotazioneConversione: la descrizione della struttura dei tipi


contenuti in InserimentoPrenotazioneConversioneType fornita nellappendice
CommonTypes in fondo a questo documento.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 22 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:inserimentoPrenotazioneConversioneRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:inserimentoPrenotazioneConversioneType>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>ESTERA</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>FRANCESCO</dtt:nome>
<dtt:cognome> ROSSI</dtt:cognome>
<dtt:dataNascita>1941-09-07</dtt:dataNascita>
<dtt:codiceFiscale>RSSFNC41P07H501L</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZgAASUkq</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>roma</dtt:provinciaNascita>
<dtt:comuneNascita>ROMA</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>roma</dtt:provinciaResidenza>
<dtt:comuneResidenza>ROMA</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>90</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>A1 = A1</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>A1</dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCatA>N</dtt:cambioAutomaticoCatA>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 23 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:dataAbilitazioneCategoriaA>2008-1010</dtt:dataAbilitazioneCategoriaA>
<dtt:abilitazioneCategoriaA>1</dtt:abilitazioneCategoriaA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA ACCOMPAGNATO DA TITOLARE DI
PATENTE</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche></dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
<dtt:patenteEstera>AA78782332</dtt:patenteEstera>
<dtt:statoEsteroRilascio>ANTILLE OL.</dtt:statoEsteroRilascio>
</dtt:inserimentoPrenotazioneConversioneType>
</dtt:inserimentoPrenotazioneConversioneRequest>

4.5.3 Specifiche dello schema XSD di Output


Lelemento di output per il servizio inserimentoPrenotazioneConversioneResponse, di
tipo DettaglioPrenotazioneConversioneOutputType.
Lo schema composto dai seguenti elementi principali:

dettaglioPrenotazioneConversione, messaggio: restituiti se loperazione va a buon


fine. I campi definiti per DettaglioPrenotazioneConversioneType coincidono con loutput
della corrispettiva maschera dellapplicazione web GestioneRichiestePatentiWeb, per cui
si rimanda al manuale. La descrizione della struttura dei tipi contenuti in
DettaglioPrenotazioneConversioneType e di MessaggioType fornita nellappendice
CommonTypes in fondo a questo documento.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 24 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:inserimentoPrenotazioneConversioneResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:dettaglioPrenotazioneConversione>
<dtt:marcaOperativa>75RM000494</dtt:marcaOperativa>
<dtt:statoPrenotazione>INSERITA</dtt:statoPrenotazione>
<dtt:dataVariazioneStato>2009-12-10</dtt:dataVariazioneStato>
<dtt:dataInserimento>2009-12-10</dtt:dataInserimento>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>ESTERA</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>FRANCESCO</dtt:nome>
<dtt:cognome>ROSSI</dtt:cognome>
<dtt:dataNascita>1941-09-07</dtt:dataNascita>
<dtt:codiceFiscale>RSSFNC41P07H501L</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZgAASUkqAA</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>ROMA</dtt:provinciaNascita>
<dtt:comuneNascita>ROMA</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 25 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>ROMA</dtt:provinciaResidenza>
<dtt:comuneResidenza>ROMA</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>90</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>A1 = A1</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>A1</dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCatA>N</dtt:cambioAutomaticoCatA>
<dtt:dataAbilitazioneCategoriaA>2008-10-10</dtt:dataAbilitazioneCategoriaA>
<dtt:abilitazioneCategoriaA>1</dtt:abilitazioneCategoriaA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA ACCOMPAGNATO DA TITOLARE DI
PATENTE</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
<dtt:patenteItalianaPrecedente/>
<dtt:patenteEstera>AA78782332</dtt:patenteEstera>
<dtt:statoEsteroRilascio>ANTILLE OL.</dtt:statoEsteroRilascio>
</dtt:dettaglioPrenotazioneConversione>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di inserimento eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:inserimentoPrenotazioneConversioneResponse>

4.6

Servizio di INSERIMENTO PRENOTAZIONE PER DUPLICATO

Il servizio Inserimento Prenotazione per Duplicato permette agli operatori professionali di


inserire una prenotazione di richiesta di patente, di duplicato per Deterioramento,
Riclassificazione e Smarrimento, di competenza della specifica agenzia o autoscuola.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una prenotazione, sono dettagliate nel manuale utente della applicazione Gestione Richieste
Patenti Web e sono definite negli XSD di Input e Output.
4.6.1 Definizione

Nome del
servizio

InserimentoPrenotazioneDuplicato
Le URI possibili per richiamare il WS sono:

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 26 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

/services/inserimentoPrenotazioneDuplicato
/services/inserimentoPrenotazioneDuplicatoPIN (dal Portale dell'Automobilista)
Operazione

inserimentoPrenotazioneDuplicato

Input

Una stringa contenente il messaggio XML conforme allo schema descritto nella sezione
Specifiche dello schema XSD di Input di questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema descritto nella sezione
Specifiche dello schema XSD di Output di questo servizio.

Wsdl

Le uri possibili per reperire il file WSDL sono:


/services/inserimentoPrenotazioneDuplicato/inserimentoPrenotazioneDuplicato.wsdl

/services/inserimentoPrenotazioneDuplicatoPIN/inserimentoPrenotazioneDuplicatoPIN.wsdl

4.6.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta in input inserimentoPrenotazioneDuplicatoRequest, di tipo
InserimentoPrenotazioneDuplicatoInputType.
Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata

inserimentoPrenotazioneDuplicato: la descrizione della struttura dei tipi contenuti


in InserimentoPrenotazioneDuplicatoType fornita nellappendice CommonTypes in
fondo a questo documento.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 27 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:inserimentoPrenotazioneDuplicatoRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:inserimentoPrenotazioneDuplicatoType>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>RICLASSIFICAZIONE</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>ANTONIO</dtt:nome>
<dtt:cognome>RONDINE</dtt:cognome>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZgAASUkqAAgAA</dtt:foto>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>AGRIGENTO</dtt:provinciaResidenza>
<dtt:comuneResidenza>AGRIGENTO</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>90</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>A1 = A1</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>A1</dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCatA>N</dtt:cambioAutomaticoCatA>
<dtt:abilitazioneCategoriaA>1</dtt:abilitazioneCategoriaA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA ACCOMPAGNATO DA TITOLARE DI
PATENTE</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche></dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
<dtt:patentePrecedente>
<dtt:numeroPatente>RM1800010Y</dtt:numeroPatente>
</dtt:patentePrecedente>
</dtt:inserimentoPrenotazioneDuplicatoType>
</dtt:inserimentoPrenotazioneDuplicatoRequest>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 28 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

4.6.3 Specifiche dello schema XSD di Output


Lelemento di output per questo servizio inserimentoPrenotazioneDuplicatoResponse, di
tipo DettaglioPrenotazioneDuplicatoOutputType.
Lo schema composto dai seguenti elementi principali:

dettaglioPrenotazioneDuplicato, messaggio: restituiti se loperazione va a buon


fine. I campi definiti per DettaglioPrenotazioneDuplicatoType coincidono con loutput
della corrispettiva maschera dellapplicazione web GestioneRichiestePatentiWeb, per cui
si rimanda al manuale. La descrizione della struttura dei tipi contenuti in
DettaglioPrenotazioneDuplicatoType e di MessaggioType fornita nellappendice
CommonTypes in fondo a questo documento.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

Esempio
<dtt:inserimentoPrenotazioneDuplicatoResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:dettaglioPrenotazioneDuplicato>
<dtt:marcaOperativa>75RM000496</dtt:marcaOperativa>
<dtt:statoPrenotazione>INSERITA</dtt:statoPrenotazione>
<dtt:dataVariazioneStato>2009-12-10</dtt:dataVariazioneStato>
<dtt:dataInserimento>2009-12-10</dtt:dataInserimento>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 29 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:motivoRichiesta>RICLASSIFICAZIONE</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>ANTONIO</dtt:nome>
<dtt:cognome>RONDINE</dtt:cognome>
<dtt:dataNascita>1977-01-01</dtt:dataNascita>
<dtt:codiceFiscale>RNDNTN77A01A054E</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZgAASUkqAAg</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>FROSINONE</dtt:provinciaNascita>
<dtt:comuneNascita>ACUTO</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>AGRIGENTO</dtt:provinciaResidenza>
<dtt:comuneResidenza>AGRIGENTO</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>90</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>A1 = A1</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>A1</dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCategA>N</dtt:cambioAutomaticoCategA>
<dtt:abilitazioneCategoriaA>1</dtt:abilitazioneCategoriaA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA ACCOMPAGNATO DA TITOLARE DI
PATENTE</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
<dtt:patentePrecedente>
<dtt:numeroPatente>RM1800010Y</dtt:numeroPatente>
</dtt:patentePrecedente>
<dtt:elencoAnomalie>
<dtt:anomalia>PRESCRIZIONI TECNICHE DIFFERENTI DA PATENTE
POSSEDUTA</dtt:anomalia>
</dtt:elencoAnomalie>
</dtt:dettaglioPrenotazioneDuplicato>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di inserimento eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:inserimentoPrenotazioneDuplicatoResponse>

4.7

Servizio di MODIFICA PRENOTAZIONE PER CONVERSIONE

Il servizio Modifica Prenotazione per Conversione permette agli operatori professionali di


modificare una prenotazione di richiesta di patente, per conversione Militare ed Estera, di
competenza della specifica agenzia o autoscuola.
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 30 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una prenotazione, sono dettagliate nel manuale utente della applicazione Gestione Richieste
Patenti Web e sono definite negli XSD di Input e Output.
4.7.1 Definizione

Nome del
servizio

ModificaPrenotazioneConversione
Le URI possibili per richiamare il WS sono
/services/modificaPrenotazioneConversione
/services/modificaPrenotazioneConversionePIN (dal Portale dellAutomobilista)

Operazione

modificaPrenotazioneConversione

Input

Una stringa contenente il messaggio XML conforme allo schema descritto nella sezione
Specifiche dello schema XSD di Input di questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema descritto nella sezione
Specifiche dello schema XSD di Output di questo servizio.

Wsdl

Le uri possibili per reperire il file WSDL sono:


/services/modificaPrenotazioneConversione/modificaPrenotazioneConversione.wsdl
/services/modificaPrenotazioneConversionePIN/modificaPrenotazioneConversionePIN.wsdl

4.7.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta in input modificaPrenotazioneConversioneRequest, di tipo
DettaglioPrenotazioneConversioneInputType.
Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata.

dettaglioPrenotazioneConversione: la descrizione della struttura dei tipi contenuti in


DettaglioPrenotazioneConversioneType fornita nellappendice CommonTypes in fondo
a questo documento.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 31 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:modificaPrenotazioneConversioneRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:dettaglioPrenotazioneConversione>
<dtt:marcaOperativa> 75RM000494</dtt:marcaOperativa>
<dtt:statoPrenotazione>INSERITA</dtt:statoPrenotazione>
<dtt:dataVariazioneStato>2009-10-12</dtt:dataVariazioneStato>
<dtt:dataApprovazione>2009-10-12</dtt:dataApprovazione>
<dtt:dataInserimento>2009-10-12</dtt:dataInserimento>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>ESTERA</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>FRANCESCO</dtt:nome>
<dtt:cognome>ROSSI</dtt:cognome>
<dtt:dataNascita>1941-09-07</dtt:dataNascita>
<dtt:codiceFiscale>RSSFNC41P07H501L</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZgAASUkqA</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>ROMA</dtt:provinciaNascita>
<dtt:comuneNascita>ROMA</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 32 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>ROMA</dtt:provinciaResidenza>
<dtt:comuneResidenza>ROMA</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>999</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>A1 = A1</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>A1</dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCatA>N</dtt:cambioAutomaticoCatA>
<dtt:dataAbilitazioneCategoriaA>2008-10-10</dtt:dataAbilitazioneCategoriaA>
<dtt:abilitazioneCategoriaA>1</dtt:abilitazioneCategoriaA>
<dtt:validitaPatenteRichiestaMM>11</dtt:validitaPatenteRichiestaMM>
<dtt:validitaPatenteRichiestaAA>04</dtt:validitaPatenteRichiestaAA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA ACCOMPAGNATO DA TITOLARE DI
PATENTE</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche></dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche></dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
<dtt:patenteEstera>AA78782332 </dtt:patenteEstera>
<dtt:statoEsteroRilascio>ANTILLE OL.</dtt:statoEsteroRilascio>
</dtt:dettaglioPrenotazioneConversione>
</dtt:modificaPrenotazioneConversioneRequest>

4.7.3 Specifiche dello schema XSD di Output


Lelemento di output per questo servizio modificaPrenotazioneConversioneResponse, di
tipo DettaglioPrenotazioneConversioneOutputType.
Lo schema composto dai seguenti elementi principali:

dettaglioPrenotazioneConversione, messaggio: restituiti se loperazione va a buon


fine. La marca operativa coincide con la marca operativa data in input al servizio. I
campi definiti per DettaglioPrenotazioneConversioneType coincidono con loutput della
corrispettiva maschera dellapplicazione web GestioneRichiestePatentiWeb, per cui si
rimanda al manuale. La descrizione della struttura dei tipi contenuti in
DettaglioPrenotazioneConversioneType e di MessaggioType fornita nellappendice
CommonTypes in fondo a questo documento.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 33 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt: modificaPrenotazioneConversioneResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:dettaglioPrenotazioneConversione>
<dtt:marcaOperativa>75RM000494</dtt:marcaOperativa>
<dtt:statoPrenotazione>INSERITA</dtt:statoPrenotazione>
<dtt:dataVariazioneStato>2009-12-10</dtt:dataVariazioneStato>
<dtt:dataInserimento>2009-12-10</dtt:dataInserimento>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>ESTERA</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>FRANCESCO</dtt:nome>
<dtt:cognome>ROSSI</dtt:cognome>
<dtt:dataNascita>1941-09-07</dtt:dataNascita>
<dtt:codiceFiscale>RSSFNC41P07H501L</dtt:codiceFiscale>
<dtt:foto> /9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZg AASU</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>ROMA</dtt:provinciaNascita>
<dtt:comuneNascita>ROMA</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 34 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>ROMA</dtt:provinciaResidenza>
<dtt:comuneResidenza>ROMA</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>999</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>A1 = A1</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>A1</dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCatA>N</dtt:cambioAutomaticoCatA>
<dtt:dataAbilitazioneCategoriaA>2008-10-10</dtt:dataAbilitazioneCategoriaA>
<dtt:abilitazioneCategoriaA>1</dtt:abilitazioneCategoriaA>
<dtt:validitaPatenteRichiestaMM>11</dtt:validitaPatenteRichiestaMM>
<dtt:validitaPatenteRichiestaAA>4</dtt:validitaPatenteRichiestaAA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA ACCOMPAGNATO DA TITOLARE DI
PATENTE</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
<dtt:patenteItalianaPrecedente/>
<dtt:patenteEstera>AA78782332</dtt:patenteEstera>
<dtt:statoEsteroRilascio>ANTILLE OL.</dtt:statoEsteroRilascio>
</dtt:dettaglioPrenotazioneConversione>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di modifica eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:modificaPrenotazioneConversioneResponse>

4.8

Servizio di MODIFICA PRENOTAZIONE PER DUPLICATO

Il servizio Modifica Prenotazione per Duplicato permette agli operatori professionali di


modificare una prenotazione di richiesta di patente, di duplicato per Deterioramento,
Riclassificazione e Smarrimento, di competenza della specifica agenzia o autoscuola.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una prenotazione, sono dettagliate nel manuale utente della applicazione Gestione Richieste
Patenti Web e sono definite negli XSD di Input e Output.
4.8.1 Definizione

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 35 di 138

Specifiche Integrazione Web Services

Nome del
servizio

Specifiche integrazione WebServices.doc

ModificaPrenotazioneDuplicato
Le URI possibili per richiamare il WS sono:
/services/modificaPrenotazioneDuplicato
/services/modificaPrenotazioneDuplicatoPIN (dal Portale dellAutomobilista)

Operazione

modificaPrenotazioneDuplicato

Input

Una stringa contenente il messaggio XML conforme allo schema descritto nella
sezione Specifiche dello schema XSD di Input di questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema descritto nella
sezione Specifiche dello schema XSD di Output di questo servizio.

Wsdl

Le uri possibili per reperire il file WSDL sono:


/services/modificaPrenotazioneDuplicato/modificaPrenotazioneDuplicato.wsdl
/services/modificaPrenotazioneDuplicatoPIN/modificaPrenotazioneDuplicatoPIN.wsdl

4.8.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta in input modificaPrenotazioneDuplicatoRequest, di tipo
DettaglioPrenotazioneDuplicatoInputType.
Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata.

dettaglioPrenotazioneDuplicato: la descrizione della struttura dei tipi contenuti in


DettaglioPrenotazioneDuplicatoType fornita nellappendice CommonTypes in fondo a
questo documento.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 36 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:modificaPrenotazioneDuplicatoRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:dettaglioPrenotazioneDuplicato>
<dtt:marcaOperativa>75RM000496</dtt:marcaOperativa>
<dtt:statoPrenotazione>INSERITA</dtt:statoPrenotazione>
<dtt:dataVariazioneStato>2009-12-10</dtt:dataVariazioneStato>
<dtt:dataInserimento>2009-12-10</dtt:dataInserimento>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>RICLASSIFICAZIONE</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>ANTONIO</dtt:nome>
<dtt:cognome>RONDINE</dtt:cognome>
<dtt:dataNascita>1977-01-01</dtt:dataNascita>
<dtt:codiceFiscale>RNDNTN77A01A054E</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZgAAkqAAg</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>FROSINONE</dtt:provinciaNascita>
<dtt:comuneNascita>ACUTO</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>AGRIGENTO</dtt:provinciaResidenza>
<dtt:comuneResidenza>AGRIGENTO</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>90</dtt:civicoResidenza>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 37 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>A2 = A2</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>A2</dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCategA>N</dtt:cambioAutomaticoCategA>
<dtt:abilitazioneCategoriaA>2</dtt:abilitazioneCategoriaA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA ACCOMPAGNATO DA TITOLARE DI
PATENTE</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
<dtt:patentePrecedente>
<dtt:numeroPatente>RM1800010Y</dtt:numeroPatente>
</dtt:patentePrecedente>
</dtt:dettaglioPrenotazioneDuplicato>
</dtt:modificaPrenotazioneDuplicatoRequest>

4.8.3 Specifiche dello schema XSD di Output


Lelemento di output per questo servizio modificaPrenotazioneDuplicatoResponse, di
tipo DettaglioPrenotazioneDuplicatoOutputType.
Lo schema composto dai seguenti elementi principali:

dettaglioPrenotazioneDuplicato, messaggio: restituiti se loperazione va a buon


fine. La marca operativa coincide con la marca operativa data in input al servizio. I
campi definiti per DettaglioPrenotazioneDuplicatoType coincidono con loutput della
corrispettiva maschera dellapplicazione web GestioneRichiestePatentiWeb, per cui si
rimanda al manuale. La descrizione della struttura dei tipi contenuti in
DettaglioPrenotazioneDuplicatoType e di MessaggioType fornita nellappendice
CommonTypes in fondo a questo documento.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 38 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:modificaPrenotazioneDuplicatoResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:dettaglioPrenotazioneDuplicato>
<dtt:marcaOperativa>75RM000496</dtt:marcaOperativa>
<dtt:statoPrenotazione>INSERITA</dtt:statoPrenotazione>
<dtt:dataVariazioneStato>2009-12-10</dtt:dataVariazioneStato>
<dtt:dataInserimento>2009-12-10</dtt:dataInserimento>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>RICLASSIFICAZIONE</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>ANTONIO</dtt:nome>
<dtt:cognome>RONDINE</dtt:cognome>
<dtt:dataNascita>1977-01-01</dtt:dataNascita>
<dtt:codiceFiscale>RNDNTN77A01A054E</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZgAASUkqAA</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>FROSINONE</dtt:provinciaNascita>
<dtt:comuneNascita>ACUTO</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>AGRIGENTO</dtt:provinciaResidenza>
<dtt:comuneResidenza>AGRIGENTO</dtt:comuneResidenza>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 39 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>90</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>A2 = A2</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>A2</dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCategA>N</dtt:cambioAutomaticoCategA>
<dtt:abilitazioneCategoriaA>2</dtt:abilitazioneCategoriaA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA ACCOMPAGNATO DA TITOLARE DI
PATENTE</dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
<dtt:patentePrecedente>
<dtt:numeroPatente>RM1800010Y</dtt:numeroPatente>
</dtt:patentePrecedente>
<dtt:elencoAnomalie>
<dtt:anomalia>PRESCRIZIONI TECNICHE DIFFERENTI DA PATENTE
POSSEDUTA</dtt:anomalia>
</dtt:elencoAnomalie>
</dtt:dettaglioPrenotazioneDuplicato>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di modifica eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:modificaPrenotazioneDuplicatoResponse>

4.9

Servizio di RICERCA PRENOTAZIONE

Il servizio Ricerca Prenotazione permette agli operatori professionali di ricercare una


prenotazione di richiesta di patente, di competenza della specifica agenzia o autoscuola.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una prenotazione, sono dettagliate nel manuale utente della applicazione Gestione Richieste
Patenti Web e sono definite negli XSD di Input e Output.
4.9.1 Definizione

Nome del servizio

RicercaPrenotazione
Le URI possibili per richiamare il WS sono:
/services/ricercaPrenotazione

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 40 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

/services/ricercaPrenotazionePIN (dal Portale dellAutomobilista)


Operazione

ricercaPrenotazione

Input

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Input di
questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Output di
questo servizio.

Wsdl

Le uri possibili per reperire il file WSDL sono:


/services/ricercaPrenotazione/ricercaPrenotazione.wsdl
/services/ricercaPrenotazionePIN/ricercaPrenotazionePIN.wsdl

4.9.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta
InfoRicercaPrenotazioneType.

in

input

ricercaPrenotazioneRequest,

di

tipo

Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata

Obbligatorio uno dei seguenti criteri di ricerca (in alternativa fra di loro):

marcaOperativaRicerca

statoEDate

statoEDateECodOperatore

codOperatoreECognome: consente di effettuare la ricerca delle prenotazioni


per codice operatore e cognome del conducente. Se le anagrafiche speciali sono
abilitate possibile specificare anche il tipo di anagrafica speciale. In questa
sede lunico valore ammesso per questo dato 1, che indica ANAGRAFICA
CON CARATTERI DIACRITICI. Se questo valore viene specificato significa che il
cognome o/e il nome del conducente dato in input contiene uno dei caratteri
indicati nella tabella dellAppendice B: Gestione Anagrafiche Speciali.

numero Pagina

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 41 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio criterio di ricerca marcaOperativaRicerca


<dtt:ricercaPrenotazioneRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativaRicerca>75RM000015</dtt:marcaOperativaRicerca>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:ricercaPrenotazioneRequest>
Esempio criterio di ricerca statoEDate
<dtt:ricercaPrenotazioneRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:statoEDate>
<dtt:statoPrenotazione>INSERITA</dtt:statoPrenotazione>
<dtt:dataVariazioneStatoDA>2009-06-01</dtt:dataVariazioneStatoDA>
<dtt:dataVariazioneStatoA>2009-06-30</dtt:dataVariazioneStatoA>
</dtt:statoEDate>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:ricercaPrenotazioneRequest>
Esempio criterio di ricerca statoEDateECodOperatore
<dtt:ricercaPrenotazioneRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 42 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

</dtt:login>
<dtt:statoEDateECodOperatore>
<dtt:statoEDate>
<dtt:statoPrenotazione>APPROVATA</dtt:statoPrenotazione>
<dtt:dataVariazioneStatoDA>2009-06-01</dtt:dataVariazioneStatoDA>
<dtt:dataVariazioneStatoA>2009-06-30</dtt:dataVariazioneStatoA>
</dtt:statoEDate>
<dtt:codiceOperatore>0001</dtt:codiceOperatore>
</dtt:statoEDateECodOperatore>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:ricercaPrenotazioneRequest>
Esempio criterio di ricerca codOperatoreECognome
<dtt:ricercaPrenotazioneRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:codOperatoreECognome>
<dtt:codiceOperatore>0001</dtt:codiceOperatore>
<dtt:cognome>PREDATA</dtt:cognome>
<dtt:tipoAnagraficaSpeciale>3</dtt:tipoAnagraficaSpeciale>
</dtt:codOperatoreECognome>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:ricercaPrenotazioneRequest>

4.9.3 Specifiche dello schema XSD di Output


Lelemento inviato in output per questo servizio ricercaPrenotazioneResponse, di tipo
RicercaPrenotazioneOutputType.
Lo schema composto dai seguenti elementi principali:

elencoPrenotazioni, messaggio: restituiti se loperazione va a buon fine. I campi


definiti per ElencoPrenotazioniType coincidono con loutput della corrispettiva maschera
dellapplicazione web GestioneRichiestePatentiWeb, per cui si rimanda al manuale. La
descrizione della struttura dei tipi contenuti in ElencoPrenotazioniType e di
MessaggioType fornita nellappendice CommonTypes in fondo a questo documento.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 43 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:ricercaPrenotazioneResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:elencoPrenotazioni>
<dtt:dettaglioPrenotazione>
<dtt:marcaOperativa>75RM000015</dtt:marcaOperativa>
<dtt:statoPrenotazione>RILASCIATA</dtt:statoPrenotazione>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:dataVariazioneStato>2009-11-23</dtt:dataVariazioneStato>
<dtt:nome>GG</dtt:nome>
<dtt:cognome>DD</dtt:cognome>
<dtt:motivoRichiesta>ESTERA</dtt:motivoRichiesta>
<dtt:presenzaAn>N</dtt:presenzaAn>
<dtt:presenzaFoto>S</dtt:presenzaFoto>
</dtt:dettaglioPrenotazione>
<dtt:numeroRecordTotali>1</dtt:numeroRecordTotali>
<dtt:numeroRecordPagina>10</dtt:numeroRecordPagina>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:elencoPrenotazioni>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di ricerca eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:ricercaPrenotazioneResponse>

4.10 Servizio di CANCELLAZIONE RICHIESTA ESAME


Il servizio Cancellazione Richiesta Esame permette agli operatori professionali di cancellare
fisicamente una richiesta per esame di competenza della specifica agenzia o autoscuola.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una richiesta per esame, sono dettagliate nel manuale utente della applicazione Gestione
Richieste Patenti Web e sono definite negli XSD di Input e Output.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 44 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

4.10.1 Definizione

Nome del
servizio

CancellazioneRichiestaEsame
Le URI possibili per richiamare il WS sono:
/services/cancellazioneRichiestaEsame
/services/cancellazioneRichiestaEsamePIN (dal Portale dellAutomobilista)

Operazione

cancellazioneRichiestaEsame

Input

Una stringa contenente il messaggio XML conforme allo schema descritto nella
sezione Specifiche dello schema XSD di Input di questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema descritto nella
sezione Specifiche dello schema XSD di Output di questo servizio.

Wsdl

Le uri possibili per reperire il file WSDL sono:


/services/cancellazioneRichiestaEsame/cancellazioneRichiestaEsame.wsdl
/services/cancellazioneRichiestaEsamePIN/cancellazioneRichiestaEsamePIN.wsdl

4.10.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta in input cancellazioneRichiestaEsameRequest, di tipo
IdentificativoRichiestaEsameType.
Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata.

marcaOperativa: uno dei campi chiave che consente di specificare quale richiesta
deve essere cancellata. Il campo obbligatorio. La marca operativa deve soddisfare i
vincoli definiti nel MarcaOperativaRichiestaEsameType, la cui struttura descritta
nellappendice CommonTypes in fondo a questo documento.

codiceOperatore: uno dei campi chiave che consente di specificare loperatore che
ha inserito la richiesta che deve essere cancellata. Il campo obbligatorio.

uffOperativo: uno dei campi chiave che consente di specificare lufficio operativo che
ha inserito la richiesta che deve essere cancellata. Il campo obbligatorio.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 45 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:cancellazioneRichiestaEsameRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativa>98RM463752</dtt:marcaOperativa>
<dtt:codiceOperatore>0001</dtt:codiceOperatore>
<dtt:uffOperativo>R2</dtt:uffOperativo>
</dtt:cancellazioneRichiestaEsameRequest>

4.10.3 Specifiche dello schema XSD di Output


Lelemento inviato in output per questo servizio cancellazioneRichiestaEsameResponse,
di tipo EsitoCancellazioneRichiestaEsameType.
Lo schema composto dai seguenti elementi principali:

marcaOperativa, messaggio: restituiti se loperazione va a buon fine. La marca


operativa coincide con la marca operativa data in input al servizio.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine. Per la struttura dellErrorType si rimanda allappendice
CommonTypes.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 46 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:cancellazioneRichiestaEsameResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:marcaOperativa>98RM463752</dtt:marcaOperativa>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di cancellazione eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:cancellazioneRichiestaEsameResponse>

4.11 Servizio di VISUALIZZAZIONE DETTAGLIO RICHIESTA PER ESAME


Il servizio Visualizzazione Dettaglio Richiesta per Esame permette agli operatori professionali di
visualizzare il dettaglio di una richiesta per esame, di competenza della specifica agenzia o
autoscuola.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una richiesta per esame, sono dettagliate nel manuale utente della applicazione Gestione
Richieste Patenti Web e sono definite negli XSD di Input e Output.
4.11.1 Definizione

Nome del servizio

DettaglioRichiestaEsame
Le URI possibili per richiamare il WS sono:
/services/dettaglioRichiestaEsame
/services/dettaglioRichiestaEsamePIN (dal Portale dellAutomobilista)

Operazione

dettaglioRichiestaEsame

Input

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Input di
questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Output di
questo servizio.

Wsdl

Le uri possibili per reperire il file WSDL sono:


/services/dettaglioRichiestaEsame/dettaglioRichiestaEsame.wsdl

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 47 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

/services/dettaglioRichiestaEsamePIN/dettaglioRichiestaEsamePIN.wsdl

4.11.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta in input dettaglioRichiestaEsameRequest, di tipo
IdentificativoRichiestaEsameType.
Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata

marcaOperativa: uno dei campi chiave che consente di specificare quale richiesta
deve essere visualizzata. Il campo obbligatorio. La marca operativa deve soddisfare i
vincoli definiti nel MarcaOperativaRichiestaEsameType, la cui struttura descritta
nellappendice CommonTypes in fondo a questo documento.

codiceOperatore: uno dei campi chiave che consente di specificare loperatore che
ha inserito la richiesta che deve essere visualizzata. Il campo obbligatorio.

uffOperativo: uno dei campi chiave che consente di specificare lufficio operativo che
ha inserito la richiesta che deve essere visualizzata. Il campo obbligatorio.

Esempio
<dtt:dettaglioRichiestaEsameRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativa>98RM463752</dtt:marcaOperativa>
<dtt:codiceOperatore>0001</dtt:codiceOperatore>
<dtt:uffOperativo>R2</dtt:uffOperativo>
</dtt:dettaglioRichiestaEsameRequest>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 48 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

4.11.3 Specifiche dello schema XSD di Output


Lelemento inviato in output per questo servizio dettaglioRichiestaEsameResponse, di
tipo DettaglioRichiestaEsameOutputType.
Lo schema composto dai seguenti elementi principali:

dettaglioRichiestaEsame e messaggio: restituiti se loperazione va a buon fine. La


marca operativa coincide con la marca operativa data in input al servizio. I campi
definiti per DettaglioRichiestaEsameEstesoType coincidono con loutput della
corrispettiva maschera dellapplicazione web GestioneRichiestePatentiWeb, per cui si
rimanda al manuale. La descrizione della struttura dei tipi contenuti in
DettaglioRichiestaEsameEstesoType e di MessaggioType fornita nellappendice
CommonTypes in fondo a questo documento.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

Esempio
<dtt:dettaglioRichiestaEsameResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:dettaglioRichiestaEsame>
<dtt:marcaOperativa>98RM463752</dtt:marcaOperativa>
<dtt:ufficioOperativo>R2</dtt:ufficioOperativo>
<dtt:codiceOperatore>0001</dtt:codiceOperatore>
<dtt:dataIscrizione>2009-06-18</dtt:dataIscrizione>
<dtt:datiAnagrafici>
<dtt:nome>TIZIO</dtt:nome>
<dtt:cognome>PINCOPALLO</dtt:cognome>
<dtt:dataNascita>1961-11-11</dtt:dataNascita>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 49 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:codiceFiscale>PNCPLP61S11H501A</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZgAASUkqAA</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>ROMA</dtt:provinciaNascita>
<dtt:comuneNascita>ROMA</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>ROMA</dtt:provinciaResidenza>
<dtt:comuneResidenza>ROMA</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>DEI TRE PINI</dtt:indirizzoResidenza>
<dtt:civicoResidenza>19</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>CS</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>CS</dtt:categoriaRichiesta>
<dtt:validitaPatenteRichiestaMM>1</dtt:validitaPatenteRichiestaMM>
<dtt:validitaPatenteRichiestaAA>1</dtt:validitaPatenteRichiestaAA>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:abilitazioneCategoriaA/>
<dtt:patenteItalianaPrecedente>
<dtt:numeroPatente>RM6361832Y</dtt:numeroPatente>
</dtt:patenteItalianaPrecedente>
<dtt:categoriaPossedutaEstesa>BS</dtt:categoriaPossedutaEstesa>
<dtt:categoriaPosseduta>BS</dtt:categoriaPosseduta>
</dtt:dettaglioRichiestaEsame>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di ricerca eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:dettaglioRichiestaEsameResponse>

4.12 Servizio di INSERIMENTO RICHIESTA PER ESAME


Il servizio Inserimento Richiesta per Esame permette agli operatori professionali di inserire una
richiesta per esame, di competenza della specifica agenzia o autoscuola.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una richiesta per esame, sono dettagliate nel manuale utente della applicazione Gestione
Richieste Patenti Web e sono definite negli XSD di Input e Output.
4.12.1 Definizione

Nome del
servizio

InserimentoRichiestaEsame

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 50 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Le URI possibili per richiamare il WS sono:


/services/inserimentoRichiestaEsame
/services/inserimentoRichiestaEsamePIN (dal Portale dellAutomobilista)
Operazione

inserimentoRichiestaEsame

Input

Una stringa contenente il messaggio XML conforme allo schema descritto


nella sezione Specifiche dello schema XSD di Input di questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema descritto


nella sezione Specifiche dello schema XSD di Output di questo servizio.

Wsdl

Le uri possibili per reperire il file WSDL sono:


/services/inserimentoRichiestaEsame/inserimentoRichiestaEsame.wsdl
/services/inserimentoRichiestaEsamePIN/inserimentoRichiestaEsamePIN.wsdl

4.12.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta in input inserimentoRichiestaEsameRequest, di tipo
InserimentoRichiestaEsameInputType.
Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata.

datiRichiestaEsame: la descrizione della struttura dei tipi contenuti in


DatiRichiestaEsameType fornita nellappendice CommonTypes in fondo a questo
documento.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 51 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:inserimentoRichiestaEsameRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:datiRichiestaEsameType>
<dtt:ufficioOperativo>R2</dtt:ufficioOperativo>
<dtt:codiceOperatore>0001</dtt:codiceOperatore>
<dtt:dataIscrizione>2009-06-18</dtt:dataIscrizione>
<dtt:datiAnagrafici>
<dtt:nome>tizio</dtt:nome>
<dtt:cognome>pincopallo</dtt:cognome>
<dtt:tipoAnagraficaSpeciale></dtt:tipoAnagraficaSpeciale>
<dtt:dataNascita>1961-11-11</dtt:dataNascita>
<dtt:codiceFiscale>PNCPLP61S11H501A</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZgSUkqAA</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaEstero>
<dtt:localitaEsteraNascita>Localita</dtt:localitaEsteraNascita>
<dtt:statoEsteroNascita>ITALIA</dtt:statoEsteroNascita>
</dtt:luogoNascitaEstero>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>Roma</dtt:provinciaResidenza>
<dtt:comuneResidenza>Roma</dtt:comuneResidenza>
<dtt:toponimoResidenza>via</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>dei tre pini</dtt:indirizzoResidenza>
<dtt:civicoResidenza>19a</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 52 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:categoriaDisponibile>CS</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>CS</dtt:categoriaRichiesta>
<dtt:validitaPatenteRichiestaMM>01</dtt:validitaPatenteRichiestaMM>
<dtt:validitaPatenteRichiestaAA>01</dtt:validitaPatenteRichiestaAA>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:abilitazioneCategoriaA></dtt:abilitazioneCategoriaA>
<dtt:patenteItalianaPrecedente>
<dtt:numeroPatente>RM6361832Y</dtt:numeroPatente>
</dtt:patenteItalianaPrecedente>
<dtt:categoriaPossedutaEstesa>BS</dtt:categoriaPossedutaEstesa>
<dtt:categoriaPosseduta>BS</dtt:categoriaPosseduta>
</dtt:datiRichiestaEsameType>
</dtt:inserimentoRichiestaEsameRequest>

4.12.3 Specifiche dello schema XSD di Output


Lelemento inviato in output per questo servizio inserimentoRichiestaEsameResponse, di
tipo DettaglioRichiestaEsameOutputType.
Lo schema composto dai seguenti elementi principali:

dettaglioRichiestaEsame e messaggio: restituiti se loperazione va a buon fine. I


campi definiti per DettaglioRichiestaEsameEstesoType coincidono con loutput della
corrispettiva maschera dellapplicazione web GestioneRichiestePatentiWeb, per cui si
rimanda al manuale. La descrizione della struttura dei tipi contenuti in
DettaglioRichiestaEsameEstesoType e di MessaggioType fornita nellappendice
CommonTypes in fondo a questo documento.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 53 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:inserimentoRichiestaEsameResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:dettaglioRichiestaEsame>
<dtt:marcaOperativa>98RM463752</dtt:marcaOperativa>
<dtt:ufficioOperativo>R2</dtt:ufficioOperativo>
<dtt:codiceOperatore>0001</dtt:codiceOperatore>
<dtt:dataIscrizione>2009-06-18</dtt:dataIscrizione>
<dtt:datiAnagrafici>
<dtt:nome>TIZIO</dtt:nome>
<dtt:cognome>PINCOPALLO</dtt:cognome>
<dtt:dataNascita>1961-11-11</dtt:dataNascita>
<dtt:codiceFiscale>PNCPLP61S11H501A</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZgAASUkqAAA</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaEstero>
<dtt:localitaEsteraNascita>Localita</dtt:localitaEsteraNascita>
<dtt:statoEsteroNascita>ITALIA</dtt:statoEsteroNascita>
</dtt:luogoNascitaEstero>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>Roma</dtt:provinciaResidenza>
<dtt:comuneResidenza>Roma</dtt:comuneResidenza>
<dtt:toponimoResidenza>via</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>dei tre pini</dtt:indirizzoResidenza>
<dtt:civicoResidenza>19a</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>CS</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>CS</dtt:categoriaRichiesta>
<dtt:validitaPatenteRichiestaMM>01</dtt:validitaPatenteRichiestaMM>
<dtt:validitaPatenteRichiestaAA>01</dtt:validitaPatenteRichiestaAA>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 54 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:abilitazioneCategoriaA></dtt:abilitazioneCategoriaA>
<dtt:patenteItalianaPrecedente>
<dtt:numeroPatente>RM6361832Y</dtt:numeroPatente>
</dtt:patenteItalianaPrecedente>
<dtt:categoriaPossedutaEstesa>BS</dtt:categoriaPossedutaEstesa>
<dtt:categoriaPosseduta>BS</dtt:categoriaPosseduta>
</dtt:dettaglioRichiestaEsame>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di inserimento eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:inserimentoRichiestaEsameResponse>

4.13 Servizio di MODIFICA RICHIESTA PER ESAME


Il servizio Modifica Richiesta per Esame permette agli operatori professionali di modificare una
richiesta per esame, di competenza della specifica agenzia o autoscuola.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una richiesta per esame, sono dettagliate nel manuale utente della applicazione Gestione
Richieste Patenti Web e sono definite negli XSD di Input e Output.
4.13.1 Definizione

Nome del servizio

ModificaRichiestaEsame
Le URI possibili per richiamare il WS sono:
/services/modificaRichiestaEsame
/services/modificaRichiestaEsamePIN (dal Portale dellAutomobilista)

Operazione

modificaRichiestaEsame

Input

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Input di
questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Output di
questo servizio.

Wsdl

Le URI possibili per reperire il file WSDL sono:

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 55 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

/services/modificaRichiestaEsame/modificaRichiestaEsame.wsdl
/services/modificaRichiestaEsamePIN/modificaRichiestaEsamePIN.wsdl

4.13.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta in input modificaRichiestaEsameRequest, di tipo
ModificaRichiestaEsameInputType.
Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata

marcaOperativa: il campo chiave che consente di specificare quale richiesta deve


essere modificata. Il campo obbligatorio. La marca operativa deve soddisfare i vincoli
definiti nel MarcaOperativaRichiestaEsameType, la cui struttura descritta
nellappendice CommonTypes in fondo a questo documento.

datiRichiestaEsame: la descrizione della struttura dei tipi contenuti in


DettaglioRichiestaEsameType fornita nellappendice CommonTypes in fondo a questo
documento.

Esempio
<dtt:modificaRichiestaEsameRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 56 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesRichiestaEsame.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativa>98RM463754</dtt:marcaOperativa>
<dtt:datiRichiestaEsameType>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:datiAnagrafici>
<dtt:nome>CAROLINA</dtt:nome>
<dtt:cognome>ROSSITTO</dtt:cognome>
<dtt:dataNascita>1970-12-21</dtt:dataNascita>
<dtt:codiceFiscale>RSSCLN70T61A089U</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZgAASUkqAAA</dtt:foto>
<dtt:sesso>F</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>AGRIGENTO</dtt:provinciaNascita>
<dtt:comuneNascita>AGRIGENTO</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>AGRIGENTO</dtt:provinciaResidenza>
<dtt:comuneResidenza>AGRIGENTO</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PIO XI</dtt:indirizzoResidenza>
<dtt:civicoResidenza>99</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>B = B</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>B </dtt:categoriaRichiesta>
<dtt:validitaPatenteRichiestaMM>09</dtt:validitaPatenteRichiestaMM>
<dtt:validitaPatenteRichiestaAA>09</dtt:validitaPatenteRichiestaAA>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:abilitazioneCategoriaA></dtt:abilitazioneCategoriaA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA ACCOMPAGNATO DA TITOLARE DI
PATENTE</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA IN ORARIO
DIURNO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche></dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
</dtt:datiRichiestaEsameType>
</dtt:modificaRichiestaEsameRequest>

4.13.3 Specifiche dello schema XSD di Output


Lelemento inviato in output per questo servizio modificaRichiestaEsameResponse, di tipo
DettaglioRichiestaEsameOutputType.
Lo schema composto dai seguenti elementi principali:

dettaglioRichiestaEsame e messaggio: restituiti se loperazione va a buon fine. La


marca operativa coincide con la marca operativa data in input al servizio. I campi
definiti per DettaglioRichiestaEsameEstesoType coincidono con loutput della
corrispettiva maschera dellapplicazione web GestioneRichiestePatentiWeb, per cui si

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 57 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

rimanda al manuale. La descrizione della struttura dei tipi


DettaglioRichiestaEsameEstesoType e di MessaggioType fornita
CommonTypes in fondo a questo documento.

contenuti in
nellappendice

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 58 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:modificaRichiestaEsameResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:dettaglioRichiestaEsame>
<dtt:marcaOperativa>98RM463754</dtt:marcaOperativa>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:datiAnagrafici>
<dtt:nome>CAROLINA</dtt:nome>
<dtt:cognome>ROSSITTO</dtt:cognome>
<dtt:dataNascita>1970-12-21</dtt:dataNascita>
<dtt:codiceFiscale>RSSCLN70T61A089U</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/4QAWRXhpZgAASUkqAAA</dtt:foto>
<dtt:sesso>F</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>AGRIGENTO</dtt:provinciaNascita>
<dtt:comuneNascita>AGRIGENTO</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>AGRIGENTO</dtt:provinciaResidenza>
<dtt:comuneResidenza>AGRIGENTO</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PIO XI</dtt:indirizzoResidenza>
<dtt:civicoResidenza>99</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>B = B</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>B</dtt:categoriaRichiesta>
<dtt:validitaPatenteRichiestaMM>9</dtt:validitaPatenteRichiestaMM>
<dtt:validitaPatenteRichiestaAA>9</dtt:validitaPatenteRichiestaAA>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:abilitazioneCategoriaA/>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA ACCOMPAGNATO DA TITOLARE DI
PATENTE</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA IN ORARIO
DIURNO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
<dtt:patenteItalianaPrecedente/>
</dtt:dettaglioRichiestaEsame>
<dtt:messaggio>

4.14 Servizio di RICERCA RICHIESTA ESAME


Il servizio Ricerca Richiesta Esame permette agli operatori professionali di ricercare una
richiesta per esame, di competenza della specifica agenzia o autoscuola.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una richiesta per esame, sono dettagliate nel manuale utente della applicazione Gestione
Richieste Patenti Web e sono definite negli XSD di Input e Output.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 59 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

4.14.1 Definizione

Nome del servizio

RicercaRichiestaEsame
Le URI possibili per richiamare il WS sono:
/services/ricercaRichiestaEsame
/services/ricercaRichiestaEsamePIN (dal Portale dellAutomobilista)

Operazione

ricercaRichiestaEsame

Input

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Input di
questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Output di
questo servizio.

Wsdl

Le URI possibili per reperire il file WSDL sono:


/services/ricercaRichiestaEsame/ricercaRichiestaEsame.wsdl
/services/ricercaRichiestaEsamePIN/ricercaRichiestaEsamePIN.wsdl

4.14.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta
InfoRicercaRichiestaEsameType.

in

input

ricercaRichiestaEsameRequest,

di

tipo

Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata

codiceOperatore: uno dei campi chiave che consente di specificare loperatore che
ha inserito la richiesta che deve essere ricercata. Il campo obbligatorio.

uffOperativo: uno dei campi chiave che consente di specificare lufficio operativo che
ha inserito la richiesta che deve essere ricercata. Il campo obbligatorio.

Obbligatorio almeno uno dei seguenti:


o

marcaOperativaRichiestaEsame

patenteItaliana

codiceFiscale

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 60 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

datiAnagrafici

numero Pagina

Esempio - criterio di ricerca marcaOperativaRichiestaEsame


<dtt:ricercaRichiestaEsameRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesRichiestaEsame.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:codOperatore>0001</dtt:codOperatore>
<dtt:uffOperativo>R1</dtt:uffOperativo>
<dtt:marcaOperativaRichiestaEsame>98RM463673</dtt:marcaOperativaRichiestaEsame>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:ricercaRichiestaEsameRequest>
Esempio - criterio di ricerca patenteItaliana
<dtt:ricercaRichiestaEsameRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesRichiestaEsame.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:codOperatore>0001</dtt:codOperatore>
<dtt:uffOperativo>R1</dtt:uffOperativo>
<dtt:patenteItaliana>
<dtt:numeroPatente>98RM463673</dtt:numeroPatente>
</dtt: patenteItaliana >
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:ricercaRichiestaEsameRequest>
Esempio - criterio di ricerca codiceFiscale
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 61 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:ricercaRichiestaEsameRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesRichiestaEsame.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:codOperatore>0001</dtt:codOperatore>
<dtt:uffOperativo>R1</dtt:uffOperativo>
<dtt:codiceFiscale>TDRSFT70T21H501D</dtt:codiceFiscale>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:ricercaRichiestaEsameRequest>
Esempio - criterio di ricerca datiAnagrafici
<dtt:ricercaRichiestaEsameRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesRichiestaEsame.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:codOperatore>0001</dtt:codOperatore>
<dtt:uffOperativo>R1</dtt:uffOperativo>
<dtt:datiAnagrafici>
<dtt:nome>R1</dtt:nome>
<dtt:cognome>R1</dtt:cognome>
<dtt:dataNascita>1970-11-11</dtt:dataNascita>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>AGRIGENTO</dtt:provinciaNascita>
<dtt:comuneNascita>AGRIGENTO</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:ricercaRichiestaEsameRequest>
4.14.3 Specifiche dello schema XSD di Output
Lelemento inviato in output per questo servizio ricercaRichiestaEsameResponse, di tipo
RicercaRichiestaEsameOutputType.
Lo schema composto dai seguenti elementi principali:

elencoRichiesteEsame e messaggio: restituiti se loperazione va a buon fine. I


campi definiti per ElencoRichiestaEsameType coincidono con loutput della corrispettiva
maschera dellapplicazione web GestioneRichiestePatentiWeb, per cui si rimanda al
manuale. La descrizione della struttura dei tipi contenuti in ElencoRichiestaEsameType e
di MessaggioType fornita nellappendice CommonTypes in fondo a questo documento.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 62 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:ricercaRichiestaEsameResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:elencoRichiesteEsame>
<dtt:dettaglioRichiesta>
<dtt:marcaOperativa>98RM463673</dtt:marcaOperativa>
<dtt:statoPrenotazione>ATTIVO</dtt:statoPrenotazione>
<dtt:dataInserimento>2009-09-18</dtt:dataInserimento>
<dtt:codiceOperatore>0001</dtt:codiceOperatore>
<dtt:cognome>TOPO</dtt:cognome>
<dtt:nome>LINO</dtt:nome>
<dtt:presenzaFoto>S</dtt:presenzaFoto>
</dtt:dettaglioRichiesta>
<dtt:numeroRecordTotali>1</dtt:numeroRecordTotali>
<dtt:numeroRecordPagina>10</dtt:numeroRecordPagina>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:elencoRichiesteEsame>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di ricerca eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:ricercaRichiestaEsameResponse>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 63 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

4.15 Servizio di FACSIMILE RICHIESTA ESAME


Il servizio Facsimile Richiesta Esame permette agli operatori professionali di emettere il
facsimile di una patente, di competenza della specifica agenzia o autoscuola.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una richiesta per esame, sono dettagliate nel manuale utente della applicazione Gestione
Richieste Patenti Web e sono definite negli XSD di Input e Output.
4.15.1 Definizione

Nome del servizio

FacsimileRichiestaEsame
Le URI possibili per richiamare il WS sono:
/services/facsimileRichiestaEsame
/services/facsimileRichiestaEsamePIN (dal Portale dellAutomobilista)

Operazione

facsimileRichiestaEsame

Input

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Input di
questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Output di
questo servizio.

Wsdl

Le URI possibili per reperire il WSDL sono:


/services/facsimileRichiestaEsame/facsimileRichiestaEsame.wsdl
/services/facsimileRichiestaEsamePIN/facsimileRichiestaEsamePIN.wsdl

4.15.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta in input facsimileRichiestaEsameRequest, di tipo
IdentificativoRichiestaEsameType.
Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 64 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

marcaOperativa: uno dei campi chiave che consente di specificare a quale richiesta
appartiene il facsimile della patente che deve generare. Il campo obbligatorio. La
marca
operativa
deve
soddisfare
i
vincoli
definiti
nel
MarcaOperativaRichiestaEsameType, la cui struttura descritta nellappendice
CommonTypes in fondo a questo documento.

codiceOperatore: uno dei campi chiave che consente di specificare loperatore che
ha inserito la richiesta per la quale deve essere generato il facsimile. Il campo
obbligatorio.

uffOperativo: uno dei campi chiave che consente di specificare lufficio operativo che
ha inserito la richiesta per la quale deve essere generato il facsimile. Il campo
obbligatorio.

Esempio
<dtt:facsimileRichiestaEsameRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativa>98RM463740</dtt:marcaOperativa>
<dtt:codiceOperatore>0001</dtt:codiceOperatore>
<dtt:uffOperativo>R2</dtt:uffOperativo>
</dtt:facsimileRichiestaEsameRequest>

4.15.3 Specifiche dello schema XSD di Output


Lelemento inviato in output per questo servizio facsimileRichiestaEsameResponse, di
tipo DocumentoOutputRichiestaEsameType.
Lo schema composto dai seguenti elementi principali:

marcaOperativa, pdf e messaggio: La marca operativa coincide con la marca


operativa data in input al servizio. I campi definiti per FileType coincidono con loutput
della corrispettiva maschera dellapplicazione web GestioneRichiestePatentiWeb, per cui
si rimanda al manuale. La descrizione della struttura dei tipi contenuti in FileType e di
MessaggioType fornita nellappendice CommonTypes in fondo a questo documento.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 65 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

Esempio
<dtt:facsimileRichiestaEsameResponse
xmlns:pren="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:marcaOperativa>98RM463740</dtt:marcaOperativa>
<dtt:pdf>JVBERi0xLjQKJeLjz9MKMyAwIG9iaiA8PC9GaWx0ZXIvRmxhdGVE</dtt:pdf>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di visualizzazione facsimile eseguita
con successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:facsimileRichiestaEsameResponse>

4.16 Servizio di RICERCA FOGLIO ROSA PER PRIMA STAMPA


Il servizio Ricerca Foglio Rosa permette agli operatori professionali di ricercare un foglio rosa,
di competenza della specifica agenzia o autoscuola, al fine di eseguire una sua stampa.
Il foglio rosa viene generato da un batch notturno, quindi sar disponibile dal giorno dopo la
richiesta se non prevede lesame di teoria e il giorno dopo il superamento dellesame di teoria
per richiesta con prova di teoria.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una prenotazione, sono dettagliate nel manuale utente della applicazione Gestione Richieste
Patenti Web e sono definite negli XSD di Input e Output.
4.16.1 Definizione

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 66 di 138

Specifiche Integrazione Web Services

Nome del
servizio

Specifiche integrazione WebServices.doc

RicercaFoglioRosa
Le URI possibili per richiamare il WS sono:
/services/ricercaFoglioRosaStampa
/services/ricercaFoglioRosaStampaPIN (dal Portale dellAutomobilista)

Operazione

ricercaFoglioRosaStampa

Input

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Input di questo
servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Output di
questo servizio.

Wsdl

Le URI possibili per reperire il file WSDL sono:


/services/ricercaFoglioRosaStampa/ricercaFoglioRosaStampa.wsdl
/services/ricercaFoglioRosaStampaPIN/ricercaFoglioRosaStampaPIN.wsdl

4.16.2 Specifiche dello schema XSD di Input


L elemento che ci si
InfoRicercaFoglioRosaType.

aspetta

in

input

ricercaFoglioRosaRequest,

di

tipo

Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata

marcaOperativaFoglioRosa: uno dei campi chiave che consente di specificare a


quale prenotazione deve essere visualizzata. Il campo obbligatorio. La marca
operativa deve soddisfare i vincoli definiti nel MarcaOperativaFoglioRosaType, la cui
struttura descritta nellappendice CommonTypes in fondo a questo documento.

codiceOperatore: uno dei campi chiave che consente di specificare loperatore che
ha inserito la prenotazione che deve essere visualizzata. Il campo obbligatorio. Il
Codice Operatore deve corrispondere con la matricola di accesso.

ufficioOperativo: uno dei campi chiave che consente di specificare lufficio operativo
che ha inserito la prenotazione che deve essere visualizzata. Il campo obbligatorio.

numeroPagina: il campo che consente di specificare quale pagina si intende


visualizzare. Il campo obbligatorio.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 67 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:ricercaFoglioRosaRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativaFoglioRosa>98RM463675</dtt:marcaOperativaFoglioRosa>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:ricercaFoglioRosaRequest>

4.16.3 Specifiche dello schema XSD di Output


Lelemento inviato in output per questo servizio ricercaFoglioRosaResponse, di tipo
RicercaFoglioRosaOutputType.
Lo schema composto dai seguenti elementi principali:

foglioRosa e messaggio: restituiti se loperazione va a buon fine. I campi definiti per


FoglioRosaType coincidono con loutput della corrispettiva maschera dellapplicazione
web GestioneRichiestePatentiWeb, per cui si rimanda al manuale. La descrizione della
struttura dei tipi contenuti in FoglioRosaType e di MessaggioType fornita
nellappendice CommonTypes in fondo a questo documento.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 68 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:ricercaFoglioRosaResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:foglioRosa>
<dtt:dettaglioFoglioRosa>
<dtt:marcaOperativaFoglioRosa>98RM463675</dtt:marcaOperativaFoglioRosa>
<dtt:statino>R4RQ2H</dtt:statino>
<dtt:dataEmissione>2009-11-03</dtt:dataEmissione>
<dtt:cognome>TEODOLI</dtt:cognome>
<dtt:nome>CAROLINA</dtt:nome>
</dtt:dettaglioFoglioRosa>
<dtt:numeroRecordTotali>10</dtt:numeroRecordTotali>
<dtt:numeroRecordPagina>10</dtt:numeroRecordPagina>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:foglioRosa>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di ricerca eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:ricercaFoglioRosaResponse>

4.17 Servizio di STAMPA FOGLIO ROSA


Il servizio Stampa Foglio Rosa permette agli operatori professionali di chiamare la stampa, che
restituisce il pdf contenente i dati dei foglio rosa selezionato, in formato A4, di competenza
della specifica agenzia o autoscuola. Dopo la prima stampa potr essere stampato con la
funzione di ristampa.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una prenotazione, sono dettagliate nel manuale utente della applicazione Gestione Richieste
Patenti Web e sono definite negli XSD di Input e Output.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 69 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

4.17.1 Definizione

Nome del servizio

StampaFoglioRosa
Le URI possibili per richiamare il WS sono:
/services/stampaFoglioRosa
/services/stampaFoglioRosaStampaPIN (dal Portale
dellAutomobilista)

Operazione

stampaFoglioRosa

Input

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Input di
questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Output di
questo servizio.

Wsdl

Le URI possibili per reperire il file WSDL sono:


/services/stampaFoglioRosa/stampaFoglioRosa.wsdl
/services/stampaFoglioRosaPIN/stampaFoglioRosaPIN.wsdl

4.17.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta
InfoStampaFoglioRosaType.

in

input

stampaFoglioRosaRequest,

di

tipo

Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata

marcaOperativaFoglioRosa: uno dei campi chiave. Il campo obbligatorio. La


marca operativa deve soddisfare i vincoli definiti nel MarcaOperativaFoglioRosaType, la
cui struttura descritta nellappendice CommonTypes in fondo a questo documento.

statino: uno dei campi chiave che consente di specificare il codice statino legato al
Foglio Rosa che si intende ristampare. Il campo obbligatorio.

codiceOperatore: uno dei campi chiave che consente di specificare loperatore che
ha inserito la prenotazione. Il campo obbligatorio. Il campo obbligatorio. Il Codice
Operatore deve corrispondere con la matricola di accesso.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 70 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

ufficioOperativo: uno dei campi chiave che consente di specificare lufficio operativo
che ha inserito la. Il campo obbligatorio.

Esempio
<dtt:stampaFoglioRosaRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativaFoglioRosa>98RM463740</dtt:marcaOperativaFoglioRosa>
<dtt:statino>R4RS7T</dtt:statino>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
</dtt:stampaFoglioRosaRequest>

4.17.3 Specifiche dello schema XSD di Output


Lelemento inviato in output per questo servizio stampaFoglioRosaResponse, di tipo
DocumentoFoglioRosaOutputType.
Lo schema composto dai seguenti elementi principali:

marcaOperativaFoglioRosa, foglioRosa e messaggio: restituiti se loperazione va a


buon fine. La marca operativa coincide con la marca operativa data in input al servizio.
I campi definiti per FoglioRosaType coincidono con loutput della corrispettiva maschera
dellapplicazione web GestioneRichiestePatentiWeb, per cui si rimanda al manuale. La
descrizione della struttura dei tipi contenuti in MarcaOperativaFoglioRsaType,
FoglioRosaType e di MessaggioType fornita nellappendice CommonTypes in fondo a
questo documento.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 71 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:stampaFoglioRosaResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:marcaOperativaFoglioRosa>98RM463740</dtt:marcaOperativaFoglioRosa>
<dtt:foglioRosa>JVBERi0xLQKJeLjz9MKMyAwIG9iaiA8PC 9GaWx0</dtt:foglioRosa>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di stampa del foglio rosa eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:stampaFoglioRosaResponse>

4.18 Servizio di RICERCA FOGLIO ROSA PER RISTAMPA


Il servizio Ricerca Foglio Rosa Ristampa permette agli operatori professionali di ricercare un
foglio rosa, di competenza della specifica agenzia o autoscuola, al fine di eseguire una sua
ristampa. Un foglio rosa pu essere ristampato subito dopo la prima stampa e fino a emissione
della patente.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una prenotazione, sono dettagliate nel manuale utente della applicazione Gestione Richieste
Patenti Web e sono definite negli XSD di Input e Output.
4.18.1 Definizione

Nome del
servizio

RicercaFoglioRosaRistampa
Le URI possibili per richiamare il WS sono:
/services/ricercaFoglioRosaRistampa
/services/ricercaFoglioRosaRistampaPIN (dal Portale dellAutomobilista)

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 72 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Operazione

ricercaFoglioRosaRistampa

Input

Una stringa contenente il messaggio XML conforme allo schema descritto


nella sezione Specifiche dello schema XSD di Input di questo servizio.

Output

Una stringa contenente il messaggio XML conforme allo schema descritto


nella sezione Specifiche dello schema XSD di Output di questo servizio.

Wsdl

Le URI possibili per reperire il file WSDL sono:


/services/ricercaFoglioRosaRistampa/ricercaFoglioRosaRistampa.wsdl
/services/ricercaFoglioRosaRistampaPIN/ricercaFoglioRosaRistampaPIN.wsdl

4.18.2 Specifiche dello schema XSD di Input


L elemento che ci si
InfoRicercaFoglioRosaType.

aspetta

in

input

ricercaFoglioRosaRequest,

di

tipo

Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata

marcaOperativaFoglioRosa: uno dei campi chiave che consente di specificare a


quale prenotazione deve essere visualizzata. Il campo obbligatorio. La marca
operativa deve soddisfare i vincoli definiti nel MarcaOperativaFoglioRosaType, la cui
struttura descritta nellappendice CommonTypes in fondo a questo documento.

codiceOperatore: uno dei campi chiave che consente di specificare loperatore che
ha inserito la prenotazione che deve essere visualizzata. Il campo obbligatorio. Il
Codice Operatore deve corrispondere con la matricola di accesso.

ufficioOperativo: uno dei campi chiave che consente di specificare lufficio operativo
che ha inserito la prenotazione che deve essere visualizzata. Il campo obbligatorio.

numeroPagina: il campo che consente di specificare quale pagina si intende


visualizzare. Il campo obbligatorio.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 73 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:ricercaFoglioRosaRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativaFoglioRosa>98RM463675</dtt:marcaOperativaFoglioRosa>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:ricercaFoglioRosaRequest>

4.18.3 Specifiche dello schema XSD di Output


Lelemento inviato in output per questo servizio ricercaFoglioRosaResponse, di tipo
RicercaFoglioRosaOutputType.
Lo schema composto dai seguenti elementi principali:

foglioRosa e messaggio: restituiti se loperazione va a buon fine. I campi definiti per


FoglioRosaType coincidono con loutput della corrispettiva maschera dellapplicazione
web GestioneRichiestePatentiWeb, per cui si rimanda al manuale. La descrizione della
struttura dei tipi contenuti in FoglioRosaType e di MessaggioType fornita
nellappendice CommonTypes in fondo a questo documento.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

Esempio
<dtt:ricercaFoglioRosaResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:foglioRosa>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 74 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:dettaglioFoglioRosa>
<dtt:marcaOperativaFoglioRosa>98RM463675</dtt:marcaOperativaFoglioRosa>
<dtt:statino>R4RQ2H</dtt:statino>
<dtt:dataEmissione>2009-11-03</dtt:dataEmissione>
<dtt:cognome>TEODOLI</dtt:cognome>
<dtt:nome>CAROLINA</dtt:nome>
</dtt:dettaglioFoglioRosa>
<dtt:numeroRecordTotali>10</dtt:numeroRecordTotali>
<dtt:numeroRecordPagina>10</dtt:numeroRecordPagina>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:foglioRosa>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di ricerca eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:ricercaFoglioRosaResponse>

4.19 Servizio di RISTAMPA FOGLIO ROSA


Il servizio Ristampa Foglio Rosa permette agli operatori professionali di emettere e stampare il
Foglio Rosa, relativo ad una richiesta per esame, di competenza della specifica agenzia o
autoscuola. Un foglio rosa pu essere ristampato subito dopo la prima stampa e fino a
emissione della patente.
Il servizio prevede lo scambio di due differenti messaggi XML di Input e di Output, i cui schema
XSD sono allegati al documento.
Le specifiche informazioni sullobbligatoriet degli attributi per il servizio e quantaltro concerne
una richiesta per esame, sono dettagliate nel manuale utente dell applicazione Gestione
Richieste Patenti Web e sono definite negli XSD di Input e Output.
4.19.1 Definizione

Nome del servizio

RistampaFoglioRosa
Le URI possibili per richiamare il WS sono:
/services/ristampaFoglioRosa
/services/ristampaFoglioRosaPIN (dal Portale dellAutomobilista)

Operazione

ristampaFoglioRosa

Input

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Input di
questo servizio.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 75 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Output

Una stringa contenente il messaggio XML conforme allo schema


descritto nella sezione Specifiche dello schema XSD di Output di
questo servizio.

Wsdl

Le URI possibili per reperire il file WSDL :


/services/ristampaFoglioRosa/ristampaFoglioRosa.wsdl
/services/ristampaFoglioRosaPIN/ristampaFoglioRosaPIN.wsdl

4.19.2 Specifiche dello schema XSD di Input


L elemento che ci si aspetta
InfoRistampaFoglioRosaType.

in

input

ristampaFoglioRosaRequest,

di

tipo

Lo schema composto dai seguenti elementi principali:

login: consente di indicare il PIN dellautoscuola/agenzia se lautenticazione tramite PIN


abilitata

marcaOperativaFoglioRosa: uno dei campi chiave. Il campo obbligatorio. La


marca operativa deve soddisfare i vincoli definiti nel MarcaOperativaFoglioRosaType, la
cui struttura descritta nellappendice CommonTypes in fondo a questo documento.

statino: uno dei campi chiave che consente di specificare il codice statino legato al
Foglio Rosa che si intende ristampare. Il campo obbligatorio.

codiceOperatore: uno dei campi chiave che consente di specificare loperatore che
ha inserito la prenotazione. Il campo obbligatorio. Il campo obbligatorio. Il Codice
Operatore deve corrispondere con la matricola di accesso.

ufficioOperativo: uno dei campi chiave che consente di specificare lufficio operativo
che ha inserito la. Il campo obbligatorio.

Esempio
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 76 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:ristampaFoglioRosaRequest
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativaFoglioRosa>98RM463740</dtt:marcaOperativaFoglioRosa>
<dtt:statino>R4RS7T</dtt:statino>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
</dtt:ristampaFoglioRosaRequest>

4.19.3 Specifiche dello schema XSD di Output


Lelemento inviato in output per questo servizio ristampaFoglioRosaResponse, di tipo
DocumentoFoglioRosaOutputType.
Lo schema composto dai seguenti elementi principali:

marcaOperativaFoglioRosa, foglioRosa e messaggio: restituiti se loperazione va a


buon fine. La marca operativa coincide con la marca operativa data in input al servizio.
I campi definiti per FoglioRosaType coincidono con loutput della corrispettiva maschera
dellapplicazione web GestioneRichiestePatentiWeb, per cui si rimanda al manuale. La
descrizione della struttura dei tipi contenuti in MarcaOperativaFoglioRsaType,
FoglioRosaType e di MessaggioType fornita nellappendice CommonTypes in fondo a
questo documento.

errore: elenco di errori rilevati durante lesecuzione delloperazione se tale operazione


non va a buon fine.

Esempio
<dtt:ristampaFoglioRosaResponse
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:marcaOperativaFoglioRosa>98RM463740</dtt:marcaOperativaFoglioRosa>
<dtt:foglioRosa>JVBERi0xLQKJeLjz9MKMyAwIG9iaiA8PC 9GaWx0</dtt:foglioRosa>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di stampa del foglio rosa eseguita con
successo</dtt:descrizioneMessaggio>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 77 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

</dtt:messaggio>
</dtt:ristampaFoglioRosaResponse>

APPENDICE A: COMMON TYPES

Di seguito viene fornita la descrizione dei common type utilizzati dai servizi.
5.1

Tipi Complessi

5.1.1 LoginType

<complexType name="LoginType">
<annotation>
<documentation>
Definisce le credenziali di login: il codice pin utente
</documentation>
</annotation>
<sequence>
<element name="codicePin" type="dtt:VarCharOtto"
minOccurs="0" maxOccurs="1" />
</sequence>
</complexType>

5.1.2 MessaggioType
Definisce i messaggi che avvisano dellesito dellelaborazione. un dato che compare sempre
in output. Il messaggio caratterizzato da un codice e da una descrizione estesa.

<complexType name="MessaggioType">
<annotation>
<documentation>
Definisce i messaggi di risposta.
</documentation>
</annotation>
<sequence>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 78 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<element name="codiceMessaggio" type="string" minOccurs="0"


maxOccurs="unbounded" />
<element name="descrizioneMessaggio" type="string"
minOccurs="0" maxOccurs="unbounded" />
</sequence>
</complexType>

Esempio
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione eseguita con successo
</dtt:descrizioneMessaggio>
</dtt:messaggio>

5.1.3 ErrorType
Definisce gli errori che si verificano durante lelaborazione. un dato che compare sempre in
output. Lerrore caratterizzato da un codice e da una descrizione estesa.

<complexType name="ErrorType">
<annotation>
<documentation>Definisce gli errori.</documentation>
</annotation>
<sequence>
<element name="codiceErrore" type="string" minOccurs="0"
maxOccurs="unbounded" />
<element name="descrizioneErrore" type="string"
minOccurs="0" maxOccurs="unbounded" />
</sequence>
</complexType>

Esempio
<dtt:errore>
<dtt:codiceErrore>01</dtt:codiceErrore>
<dtt:descrizioneErrore>Cancellazione richiesta di patente fallita
OPERAZIONE NON CONSENTITA ESISTE FOGLIO ROSA GIA' EMESSO
</dtt:descrizioneErrore>
</dtt:errore>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 79 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.4 LuogoResidenzaType
Definisce i dati relativi al luogo di residenza. La provincia e il comune devono essere definiti
per esteso.

<complexType name="LuogoResidenzaType">
<sequence>
<element name="provinciaResidenza" type="string"
minOccurs="1" maxOccurs="1">
</element>
<element name="comuneResidenza" type="string" minOccurs="1"
maxOccurs="1">
</element>
<element name="toponimoResidenza" type="dtt:VarCharCinque"
minOccurs="1" maxOccurs="1">
</element>
<element name="indirizzoResidenza" type="dtt:VarCharTrentaquattro"
minOccurs="1" maxOccurs="1">
</element>
<element name="civicoResidenza" type="dtt:VarCharSei" minOccurs="1"
maxOccurs="1">
</element>
<element name="capResidenza" type="dtt:VarCharCinque"
minOccurs="1" maxOccurs="1">
</element>
</sequence>
</complexType>

Esempio
<dtt:datiResidenza>
<dtt:provinciaResidenza>ROMA</dtt:provinciaResidenza>
<dtt:comuneResidenza>ROMA</dtt:comuneResidenza>
<dtt:toponimoResidenza>via</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>pinnn</dtt:indirizzoResidenza>
<dtt:civicoResidenza>19</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 80 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.5 LuogoNascitaType
Consente di specificare il luogo di nascita del conducente. Vengono messe a disposizione due
alternative: il luogo di nascita italiano, caratterizzato da provincia e comune di nascita, che
devono essere fornite sempre per esteso e il luogo di nascita estero, caratterizzato da stato
estero e localit, anche esse da fornire sempre per esteso.

<complexType name="LuogoNascitaType">
<choice>
<element name="luogoNascitaItaliano"
type="dtt:LuogoNascitaItalianoType">
</element>
<element name="luogoNascitaEstero"
type="dtt:LuogoNascitaEsteroType">
</element>
</choice>
</complexType>
Esempio
Di seguito viene mostrato come valorizzare lxml volendo indicare il luogo di nascita italiano.
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>ROMA</dtt:provinciaNascita>
<dtt:comuneNascita>ROMA</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
Di seguito viene mostrato come valorizzare lxml volendo indicare il luogo di nascita estero.
<dtt:luogoNascita>
<dtt:luogoNascitaEstero>
<dtt:localitaEsteraNascita>PARIGI</dtt:localitaEsteraNascita>
<dtt:statoEsteroNascita>FRANCIA</dtt:statoEsteroNascita>
</dtt:luogoNascitaEstero>
</dtt:luogoNascita>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 81 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.6 LuogoNascitaItalianoType
Consente di specificare il luogo di nascita del conducente qualora sia nato in Italia. I dati che
necessario specificare sono la provincia e il comune di nascita. Entrambi questi valori devono
essere forniti tramite la descrizione estesa.

<complexType name="LuogoNascitaItalianoType">
<sequence>
<element name="provinciaNascita" type="string"></element>
<element name="comuneNascita" type="string"></element>
</sequence>
</complexType>
Esempio
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>ROMA</dtt:provinciaNascita>
<dtt:comuneNascita>ROMA</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>

5.1.7 LuogoNascitaEsteroType
Consente di specificare il luogo di nascita del conducente qualora sia nato allestero. I dati che
necessario specificare sono lo stato estero e la localit di nascita. Entrambi questi valori
devono essere forniti tramite la descrizione estesa.

<complexType name="LuogoNascitaEsteroType">
<sequence>
<element name="localitaEsteraNascita"
type="dtt:VarCharVentidue">
</element>
<element name="statoEsteroNascita" type="string"></element>
</sequence>
</complexType>

Esempio

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 82 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:luogoNascitaEstero>
<dtt:localitaEsteraNascita>PARIGI</dtt:localitaEsteraNascita>
<dtt:statoEsteroNascita>FRANCIA</dtt:statoEsteroNascita>
</dtt:luogoNascitaEstero>
5.1.8 LuogoNascitaEsteroRicercaType
Consente di specificare, nellambito della ricerca per dati anagrafici, il luogo di nascita del
conducente qualora sia nato allestero. Lunico dato richiesto lo stato estero di nascita, che
deve essere fornito tramite una descrizione estesa.

<complexType name="LuogoNascitaEsteroRicercaType">
<sequence>
<element name="statoEsteroNascita" type="string"></element>
</sequence>
</complexType>

Esempio
<dtt:luogoNascitaEstero>
<dtt:statoEsteroNascita>FRANCIA</dtt:statoEsteroNascita>
</dtt:luogoNascitaEstero>

5.1.9 AnagraficaRichiedenteType
Consente di specificare, per esteso, i dati anagrafici del conducente. I dati che devono essere
specificati sono il nome, il cognome, il tipo anagrafica speciale (se abilitate), la data di nascita,
il codice fiscale, la foto (se abilitata), il sesso e il luogo di nascita.
I dati anagrafici (nome, cognome, data di nascita e tipo di anagrafica speciale) devono
soddisfare le condizioni esistenti in relazione alle anagrafiche speciali. Le condizioni relative alle
anagrafiche speciali sono descritte nellappendice B: Gestione Anagrafiche Speciali.
La foto pu essere fornita in input solo se la provincia di riferimento dellautoscuola/agenzia
abilitata allacquisizione della foto. I controlli su formato e dimensione della foto sono gli stessi
presenti sulla web application Gestione Richieste Patenti Web.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 83 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<complexType name="AnagraficaRichiedenteType">
<sequence>
<element name="nome" type="dtt:VarCharTrentacinqueMinLenghtZero"
minOccurs="0" maxOccurs="1">
</element>
<element name="cognome" type="dtt:VarCharTrentacinque" minOccurs="1"
maxOccurs="1">
</element>
<element name="tipoAnagraficaSpeciale" type="string"
minOccurs="0" maxOccurs="1">
</element>
<element name="dataNascita" type="date" minOccurs="1"
maxOccurs="1">
</element>
<element name="codiceFiscale" type="dtt:CharSedici"
minOccurs="0" maxOccurs="1">
</element>
<element name="foto" type="dtt:FileType" minOccurs="0"
maxOccurs="1" nillable="true">
</element>
<element name="sesso" type="dtt:SessoType" minOccurs="1"
maxOccurs="1">
</element>
<element name="luogoNascita" type="dtt:LuogoNascitaType"
minOccurs="1" maxOccurs="1">
</element>
</sequence>
<complexType>
Esempio

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 84 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:datiAnagrafici>
<dtt:nome>GG<dtt>
<dtt:cognome>DD</dtt:cognome>
<dtt:dataNascita>1979-07-12</dtt:dataNascita>
<dtt:codiceFiscale>DDXGGX79L12L802U</dtt:codiceFiscale>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>CROTONE</dtt:provinciaNascita>
<dtt:comuneNascita>VERZINO</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>

5.1.10 AnagraficaCompattaType
Consente di specificare i dati anagrafici del conducente nel caso di prenotazioni per
Deterioramento, Smarrimento e Riclassificazione, ovvero quando si ha a disposizione una
patente precedente. I dati che devono essere specificati sono il nome, il cognome, il tipo
anagrafica speciale (se abilitate), la data di nascita e la foto (se abilitata).
I dati anagrafici (nome, cognome, data di nascita e tipo di anagrafica speciale) devono
soddisfare le condizioni esistenti in relazione alle anagrafiche speciali. Le condizioni relative alle
anagrafiche speciali sono descritte nellappendice B: Gestione Anagrafiche Speciali.

<complexType name="AnagraficaCompattaType">
<sequence>
<element name="nome" type="dtt:VarCharTrentacinqueMinLenghtZero"
minOccurs="0" maxOccurs="1">
</element>
<element name="cognome" type="dtt:VarCharTrentacinque" minOccurs="1"
maxOccurs="1">
</element>
<element name="tipoAnagraficaSpeciale" type="string"
minOccurs="0" maxOccurs="1">
</element>
<element name="foto" type="dtt:FileType" minOccurs="0"
maxOccurs="1">
</element>
</sequence>
</complexType>
Esempio

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 85 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:datiAnagrafici>
<dtt:nome></dtt:nome>
<dtt:cognome>MqUP</dtt:cognome>
<dtt:tipoAnagraficaSpeciale>7</dtt:tipoAnagraficaSpeciale>
</dtt:datiAnagrafici>

5.1.11 DatiAnagraficiRicercaType
Consente di specificare i dati anagrafici del conducente nel caso si stia effettuando una ricerca
per dati anagrafici. I dati obbligatori che devono essere specificati sono il cognome, la data di
nascita, il tipo anagrafica speciale (se abilitata) e il luogo di nascita (per cui si rimanda a
LuogoNascitaRicercaType).
I dati anagrafici (nome, cognome, data di nascita e tipo di anagrafica speciale) devono
soddisfare le condizioni esistenti in relazione alle anagrafiche speciali. Le condizioni relative alle
anagrafiche speciali sono descritte nellappendice B: Gestione Anagrafiche Speciali.

<complexType name="DatiAnagraficiRicercaType">
<sequence>
<element name="nome" type="dtt:VarCharTrentacinqueMinLenghtZero"
minOccurs="0" maxOccurs="1">
</element>
<element name="cognome" type="dtt:VarCharTrentacinque" minOccurs="1"
maxOccurs="1">
</element>
<element name="tipoAnagraficaSpeciale" type="string"
minOccurs="0" maxOccurs="1">
</element>
<element name="dataNascita" type="date" minOccurs="1"
maxOccurs="1">
</element>
<element name="luogoNascita"
type="dtt:LuogoNascitaRicercaType" minOccurs="1"
maxOccurs="1">
</element>
</sequence>
</complexType>

Esempio
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 86 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<dtt:datiAnagrafici>
<dtt:nome>GIULIANO<dtt>
<dtt:cognome>ROSSI</dtt:cognome>
<dtt:dataNascita>2009-06-18</dtt:dataNascita>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>ROMA</dtt:provinciaNascita>
<dtt:comuneNascita>ROMA</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>

5.1.12 TipoAnagraficaSpecialeType
Codice che identifica il tipo di trattamento da adottare nella stampa per la produzione di
anagrafiche con caratteristiche particolari.

<complexType name="TipoAnagraficaSpecialeType">
<sequence>
<element name="tipoAnagraficaSpeciale" type="string"
minOccurs="0" maxOccurs="1" />
</sequence>
</complexType>
Esempio
<dtt:tipoAnagraficaSpeciale>5</dtt:tipoAnagraficaSpeciale>

5.1.13 PatenteItalianaType
Consente di specificare il numero di patente italiana, gi in possesso del conducente

<complexType name="PatenteItalianaType">
<sequence>
<element name="numeroPatente" minOccurs="0" maxOccurs="1"
nillable="true">
<simpleType>
<restriction base="string">
<minLength value="9" />
<maxLength value="10" />
<whiteSpace value="collapse"/>
</restriction>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 87 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

</simpleType>
</element>
</sequence>
</complexType>
Esempio
<dtt:patenteItalianaPrecedente>
<dtt:numeroPatente>RM6361832Y</dtt:numeroPatente>
</dtt:patenteItalianaPrecedente>

5.1.14 ElencoPrescrizioniTecnicheType
Consente di specificare leventuale elenco di prescrizioni tecniche della patente. Possono essere
indicate al massimo 4 prescrizioni.

<complexType name="ElencoPrescrizioniTecnicheType">
<sequence>
<element name="PrescrizioniTecniche"
type="dtt:PrescrizioniTecnicheType" minOccurs="0"
maxOccurs="4" />
</sequence>
</complexType>
Esempio
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche> GUIDA IN ORARIO DIURNO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>OCCHIALI</dtt:PrescrizioniTecniche>
<dtt:prescrizioniTecniche>LENTE OPACA</dtt:prescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>

5.1.15 DettaglioPrenotazioneConversioneType
E lelenco di tutte le informazioni inerenti la richiesta di prenotazione per conversione. Dette
informazioni vengono fornite in input, in caso di modifica, e restituite in output nel caso di
inserimento, di dettaglio e della modifica stessa.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 88 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<complexType name="DettaglioPrenotazioneConversioneType">
<sequence>
<element name="marcaOperativa"
type="dtt:MarcaOperativaPrenotazioneType" minOccurs="1"
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 89 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

maxOccurs="1" />
<element name="dataPresentazione" type="date" minOccurs="0"
maxOccurs="1" nillable="true" />
<element name="statoPrenotazione"
type="dtt:StatoPrenotazioneType" minOccurs="0" maxOccurs="1"/>
<element name="dataVariazioneStato" type="date"
minOccurs="1" maxOccurs="1" />
<element name="dataApprovazione" type="date" minOccurs="0"
maxOccurs="1" nillable="true" />
<element name="dataInserimento" type="date" minOccurs="1"
maxOccurs="1" />
<element name="ufficioOperativo" type="dtt:CharDue"
minOccurs="1" maxOccurs="1" />
<element name="codiceOperatore" type="dtt:CharQuattro"
minOccurs="1" maxOccurs="1" />
<element name="motivoRichiesta"
type="dtt:MotivoRichiestaConversioneType" minOccurs="1"
maxOccurs="1" />
<element name="datiAnagrafici"
type="dtt:AnagraficaRichiedenteType" minOccurs="1"
maxOccurs="1" />
<element name="datiResidenza" type="dtt:LuogoResidenzaType"
minOccurs="1" maxOccurs="1" />
<element name="categoriaDisponibile"
type="dtt:CategoriaDisponibileType" minOccurs="1"
maxOccurs="1" />
<element name="categoriaRichiesta"
type="dtt:CategoriaRichiestaType" minOccurs="1"
maxOccurs="1"/>
<element name="cambioAutomatico" type="dtt:SiNoType"
minOccurs="1" maxOccurs="1" />
<element name="cambioAutomaticoCatA" type="dtt:SiNoType"
minOccurs="1" maxOccurs="1" />
<element name="dataAbilitazioneCategoriaA" type="date"
minOccurs="0" maxOccurs="1" nillable="true" />
<element name="abilitazioneCategoriaA"
type="dtt:IndCategoriaAType" minOccurs="0" maxOccurs="1"
nillable="true" />
<element name="cambioManualeConvEstera"
type="dtt:CambioManualeConvEsteraType" minOccurs="0"
maxOccurs="1" nillable="true" />
<element name="validitaPatenteRichiestaMM" type="integer"
minOccurs="0" maxOccurs="1" nillable="true"/>
<element name="validitaPatenteRichiestaAA" type="integer"
minOccurs="0" maxOccurs="1" nillable="true"/>
<element name="elencoPrescrizioniTecniche"
type="dtt:ElencoPrescrizioniTecnicheType" minOccurs="0"
maxOccurs="1" nillable="true" />
<element name="patenteItalianaPrecedente"
type="dtt:PatenteItalianaType" minOccurs="0" maxOccurs="1"
nillable="true" />
<element name="patenteEstera" type="dtt:PatenteEsteraType"
minOccurs="0" maxOccurs="1" nillable="true" />
<element name="statoEsteroRilascio" type="string"
minOccurs="0" maxOccurs="1" nillable="true" />
<element name="dataScadenzaPatDaConvertire" type="date"
minOccurs="0" maxOccurs="1" nillable="true" />
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 90 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<element name="elencoAnomalie"
type="dtt:ElencoAnomalieType" minOccurs="0" maxOccurs="1"
nillable="true" />
</sequence>
</complexType>
Esempio
<dtt:dettaglioPrenotazioneConversione>
<dtt:marcaOperativa>75RM000489</dtt:marcaOperativa>
<dtt:statoPrenotazione>INSERITA</dtt:statoPrenotazione>
<dtt:dataVariazioneStato>2009-10-12</dtt:dataVariazioneStato>
<dtt:dataApprovazione>2009-10-12</dtt:dataApprovazione>
<dtt:dataInserimento>2009-10-12</dtt:dataInserimento>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>ESTERA</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>FRANCESCO</dtt:nome>
<dtt:cognome>ROSSI</dtt:cognome>
<dtt:dataNascita>1941-09-07</dtt:dataNascita>
<dtt:codiceFiscale>RSSFNC41P07H501L</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEABgAAQAUUUUAFFFFABKKKAC/9k=</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>ROMA</dtt:provinciaNascita>
<dtt:comuneNascita>ROMA</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>ROMA</dtt:provinciaResidenza>
<dtt:comuneResidenza>ROMA</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>999</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>A1 = A1</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>A1</dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCatA>N</dtt:cambioAutomaticoCatA>
<dtt:dataAbilitazioneCategoriaA>2008-10-10</dtt:dataAbilitazioneCategoriaA>
<dtt:abilitazioneCategoriaA>1</dtt:abilitazioneCategoriaA>
<dtt:validitaPatenteRichiestaMM>11</dtt:validitaPatenteRichiestaMM>
<dtt:validitaPatenteRichiestaAA>04</dtt:validitaPatenteRichiestaAA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>OCCHIALI</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche></dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche></dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
<dtt:patenteEstera>AA78782332 </dtt:patenteEstera>
<dtt:statoEsteroRilascio>ANTILLE OL.</dtt:statoEsteroRilascio>
</dtt:dettaglioPrenotazioneConversione>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 91 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.16 DettaglioPrenotazioneDuplicatoType
E lelenco di tutte le informazioni inerenti la richiesta di prenotazione per duplicato. Dette
informazioni vengono fornite in input, in caso di modifica, e restituite in output nel caso di
inserimento, di dettaglio e della modifica stessa.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 92 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<complexType name="DettaglioPrenotazioneDuplicatoType">
<sequence>
<element name="marcaOperativa"
type="dtt:MarcaOperativaPrenotazioneType" minOccurs="1"
maxOccurs="1" />
<element name="dataPresentazione" type="date" minOccurs="0"
maxOccurs="1" nillable="true" />
<element name="statoPrenotazione"
type="dtt:StatoPrenotazioneType" minOccurs="1" maxOccurs="1"/>
<element name="dataVariazioneStato" type="date" minOccurs="0"
maxOccurs="1" nillable="true" />
<element name="dataApprovazione" type="date" minOccurs="0"
maxOccurs="1" nillable="true" />
<element name="dataInserimento" type="date" minOccurs="1"
maxOccurs="1"/>
<element name="ufficioOperativo" type="dtt:CharDue"
minOccurs="1" maxOccurs="1" />
<element name="codiceOperatore" type="dtt:CharQuattro"
minOccurs="1" maxOccurs="1" />
<element name="motivoRichiesta"
type="dtt:MotivoRichiestaDuplicatoType" minOccurs="1"
maxOccurs="1" />
<element name="datiAnagrafici"
type="dtt:AnagraficaRichiedenteType" minOccurs="1"
maxOccurs="1" />
<element name="datiResidenza" type="dtt:LuogoResidenzaType"
minOccurs="1" maxOccurs="1" />
<element name="categoriaDisponibile"
type="dtt:CategoriaDisponibileType" minOccurs="1"
maxOccurs="1" />
<element name="categoriaRichiesta"
type="dtt:CategoriaRichiestaType" minOccurs="1" maxOccurs="1"
/>
<element name="cambioAutomatico" type="dtt:SiNoType"
minOccurs="1" maxOccurs="1" />
<element name="cambioAutomaticoCategA" type="dtt:SiNoType"
minOccurs="1" maxOccurs="1" />
<element name="abilitazioneCategoriaA"
type="dtt:IndCategoriaAType" minOccurs="0" maxOccurs="1"
nillable="true" />
<element name="elencoPrescrizioniTecniche"
type="dtt:ElencoPrescrizioniTecnicheType" minOccurs="0"
maxOccurs="1" nillable="true" />
<element name="patentePrecedente"
type="dtt:PatenteItalianaType" minOccurs="1" maxOccurs="1"/>
<element name="elencoAnomalie"
type="dtt:ElencoAnomalieType" minOccurs="0" maxOccurs="1"
nillable="true" />
</sequence>
</complexType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 93 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:dettaglioPrenotazioneDuplicato>
<dtt:marcaOperativa>75RM000394</dtt:marcaOperativa>
<dtt:statoPrenotazione>INSERITA</dtt:statoPrenotazione>
<dtt:dataApprovazione>2009-10-12</dtt:dataApprovazione>
<dtt:dataInserimento>2009-10-12</dtt:dataInserimento>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>DETERIORAMENTO</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>ANTONIO</dtt:nome>
<dtt:cognome>RONDINE</dtt:cognome>
<dtt:dataNascita>1941-09-07</dtt:dataNascita>
<dtt:codiceFiscale>RNDNTN77A01A054E</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEABgAAQAUUUUAFFFFABKKKAC/9k=</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>FROSINONE</dtt:provinciaNascita>
<dtt:comuneNascita>ACUTO</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>AGRIGENTO</dtt:provinciaResidenza>
<dtt:comuneResidenza>AGRIGENTO</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>99</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>D = B + C + D</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>D </dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCategA>N</dtt:cambioAutomaticoCategA>
<dtt:abilitazioneCategoriaA></dtt:abilitazioneCategoriaA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>OCCHIALI</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche> </dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche></dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
<dtt:patentePrecedente>
<dtt:numeroPatente>RM1800010Y</dtt:numeroPatente>
</dtt:patentePrecedente>
</dtt:dettaglioPrenotazioneDuplicato>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 94 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.17 InserimentoPrenotazioneConversioneType
E lelenco di tutte le informazioni fornite in input per una richiesta di prenotazione per
conversione.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 95 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<complexType name="InserimentoPrenotazioneConversioneType">
<sequence>
<element name="ufficioOperativo" type="dtt:CharDue"
minOccurs="1" maxOccurs="1" />
<element name="codiceOperatore" type="dtt:CharQuattro"
minOccurs="1" maxOccurs="1" />
<element name="motivoRichiesta"
type="dtt:MotivoRichiestaConversioneType" minOccurs="1"
maxOccurs="1" />
<element name="datiAnagrafici"
type="dtt:AnagraficaRichiedenteType" minOccurs="1"
maxOccurs="1" />
<element name="datiResidenza" type="dtt:LuogoResidenzaType"
minOccurs="1" maxOccurs="1" />
<element name="categoriaDisponibile"
type="dtt:CategoriaDisponibileType" minOccurs="1"
maxOccurs="1" />
<element name="categoriaRichiesta"
type="dtt:CategoriaRichiestaType" minOccurs="1"
maxOccurs="1"/>
<element name="cambioAutomatico" type="dtt:SiNoType"
minOccurs="1" maxOccurs="1" />
<element name="cambioAutomaticoCatA" type="dtt:SiNoType"
minOccurs="1" maxOccurs="1" />
<element name="dataAbilitazioneCategoriaA" type="date"
minOccurs="0" maxOccurs="1" />
<element name="abilitazioneCategoriaA"
type="dtt:IndCategoriaAType" minOccurs="0" maxOccurs="1" />
<element name="cambioManualeConvEstera"
type="dtt:CambioManualeConvEsteraType" minOccurs="0"
maxOccurs="1" nillable="true"/>
<element name="validitaPatenteRichiestaMM" type="integer"
minOccurs="0" maxOccurs="1" />
<element name="validitaPatenteRichiestaAA" type="integer"
minOccurs="0" maxOccurs="1" />
<element name="elencoPrescrizioniTecniche"
type="dtt:ElencoPrescrizioniTecnicheType" minOccurs="0"
maxOccurs="1" />
<element name="patenteItalianaPrecedente"
type="dtt:PatenteItalianaType" minOccurs="0" maxOccurs="1" />
<element name="patenteEstera" type="dtt:PatenteEsteraType"
minOccurs="0" maxOccurs="1" />
<element name="statoEsteroRilascio" type="string"
minOccurs="0" maxOccurs="1" />
<element name="dataScadenzaPatDaConvertire" type="date"
minOccurs="0" maxOccurs="1" />
</sequence>
</complexType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 96 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:inserimentoPrenotazioneConversioneType>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>ESTERA</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>FRANCESCO</dtt:nome>
<dtt:cognome> ROSSI</dtt:cognome>
<dtt:dataNascita>1941-09-07</dtt:dataNascita>
<dtt:codiceFiscale>RSSFNC41P07H501L</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEABgAAQAUUUUAFFFFABKKKAC/9k=</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>roma</dtt:provinciaNascita>
<dtt:comuneNascita>ROMA</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>roma</dtt:provinciaResidenza>
<dtt:comuneResidenza>ROMA</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>90</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>A1 = A1</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>A1</dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCatA>N</dtt:cambioAutomaticoCatA>
<dtt:dataAbilitazioneCategoriaA>2008-10-10</dtt:dataAbilitazioneCategoriaA>
<dtt:abilitazioneCategoriaA>1</dtt:abilitazioneCategoriaA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
<dtt:patenteEstera>AA78782332</dtt:patenteEstera>
<dtt:statoEsteroRilascio>ANTILLE OL.</dtt:statoEsteroRilascio>
</dtt:inserimentoPrenotazioneConversioneType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 97 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.18 InserimentoPrenotazioneDuplicatoType
E lelenco di tutte le informazioni fornite in input per una richiesta di prenotazione per
duplicato.

<complexType name="InserimentoPrenotazioneDuplicatoType">
<sequence>
<element name="ufficioOperativo" type="dtt:CharDue"
minOccurs="1" maxOccurs="1" />
<element name="codiceOperatore" type="dtt:CharQuattro"
minOccurs="1" maxOccurs="1" />
<element name="motivoRichiesta"
type="dtt:MotivoRichiestaDuplicatoType" minOccurs="1"
maxOccurs="1" />
<element name="datiAnagrafici"
type="dtt:AnagraficaCompattaType" minOccurs="1"
maxOccurs="1"/>
<element name="datiResidenza" type="dtt:LuogoResidenzaType"
minOccurs="1" maxOccurs="1" />
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 98 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<element name="categoriaDisponibile"
type="dtt:CategoriaDisponibileType" minOccurs="0"
maxOccurs="1" />
<element name="categoriaRichiesta"
type="dtt:CategoriaRichiestaType" minOccurs="0"
maxOccurs="1"/>
<element name="cambioAutomatico" type="dtt:SiNoType"
minOccurs="1" maxOccurs="1" />
<element name="cambioAutomaticoCatA" type="dtt:SiNoType"
minOccurs="1" maxOccurs="1" />
<element name="abilitazioneCategoriaA"
type="dtt:IndCategoriaAType" minOccurs="0" maxOccurs="1"/>
<element name="elencoPrescrizioniTecniche"
type="dtt:ElencoPrescrizioniTecnicheType" minOccurs="0"
maxOccurs="1"/>
<element name="patentePrecedente"
type="dtt:PatenteItalianaType" minOccurs="1" maxOccurs="1" />
</sequence>
</complexType>
Esempio
<dtt:inserimentoPrenotazioneDuplicatoType>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>DETERIORAMENTO</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>ANTONIO</dtt:nome>
<dtt:cognome>RONDINE</dtt:cognome>
<dtt:foto>/9j/4AAQSkZJRgABAQEABgAAQAUUUUAFFFFABKKKAC/9k=</dtt:foto>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>FROSINONE</dtt:provinciaResidenza>
<dtt:comuneResidenza>ACUTO</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>90</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile></dtt:categoriaDisponibile>
<dtt:categoriaRichiesta></dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCatA>N</dtt:cambioAutomaticoCatA>
<dtt:abilitazioneCategoriaA></dtt:abilitazioneCategoriaA>
<dtt:patentePrecedente>
<dtt:numeroPatente>RM1800010Y</dtt:numeroPatente>
</dtt:patentePrecedente>
</dtt:inserimentoPrenotazioneDuplicatoType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 99 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.19 ElencoAnomalieType
E lelenco delle eventuali anomalie non bloccanti
inserimento/modifica della stessa.

associate alla prenotazione in fase di

<complexType name="ElencoAnomalieType">
<sequence>
<element name="anomalia" type="string" minOccurs="0"
maxOccurs="unbounded" />
</sequence>
</complexType>
Esempio
<dtt:elencoAnomalie>
<dtt:anomalia>ANAGRAFICA CON CARATTERISTICHE SPECIALI NON CENSITA IN BANCA
DATI</dtt:anomalia>
</dtt:elencoAnomalie>

5.1.20 IdentificativoRichiestaEsameType
E lelenco delle informazioni che identificano univocamente una richiesta per esame

<complexType name="IdentificativoRichiestaEsameType">
<annotation>
<documentation>
Definisce l'identificativo di una richiesta per esame.
</documentation>
</annotation>
<sequence>
<element name="login" type="dtt:LoginType" minOccurs="1"
maxOccurs="1" />
<element name="marcaOperativa"
type="dtt:MarcaOperativaRichiestaEsameType" minOccurs="1"
maxOccurs="1" />
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 100 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<element name="codiceOperatore" type="dtt:CharQuattro"


minOccurs="1" maxOccurs="1" />
<element name="uffOperativo" type="dtt:CharDue"
minOccurs="1" maxOccurs="1" />
</sequence>
</complexType>

Esempio
<dtt:identificativoRichiestaEsame
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativa>98RM463752</dtt:marcaOperativa>
<dtt:codiceOperatore>0001</dtt:codiceOperatore>
<dtt:uffOperativo>R2</dtt:uffOperativo>
</dtt:identificativoRichiestaEsame>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 101 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.21 DettaglioRichiestaEsameEstesoType
E lelenco di tutte le informazioni, restituite in output, inerenti la richiesta per esame.

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 102 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<complexType name="DettaglioRichiestaEsameEstesoType">
<annotation>
<documentation>
Definisce il dettaglio dei dati di una richiesta per
esame.
</documentation>
</annotation>
<sequence>
<element name="marcaOperativa"
type="dtt:MarcaOperativaRichiestaEsameType" minOccurs="1"
maxOccurs="1" />
<element name="marcaOperativaPrecedente"
type="dtt:MarcaOperativaType" minOccurs="0" maxOccurs="1"
nillable="true" />
<element name="ufficioOperativo" type="dtt:CharDue"
minOccurs="1" maxOccurs="1" />
<element name="codiceOperatore" type="dtt:CharQuattro"
minOccurs="1" maxOccurs="1" />
<element name="dataIscrizione" type="date" minOccurs="0"
maxOccurs="1" nillable="true" />
<element name="datiAnagrafici"
type="dtt:AnagraficaRichiedenteType" minOccurs="1"
maxOccurs="1" />
<element name="datiResidenza" type="dtt:LuogoResidenzaType"
minOccurs="1" maxOccurs="1" />
<element name="categoriaDisponibile"
type="dtt:CategoriaDisponibileType" minOccurs="1"
maxOccurs="1" />
<element name="categoriaRichiesta"
type="dtt:CategoriaRichiestaType" minOccurs="1"
maxOccurs="1"/>
<element name="validitaPatenteRichiestaMM" type="integer"
minOccurs="0" maxOccurs="1" nillable="true" />
<element name="validitaPatenteRichiestaAA" type="integer"
minOccurs="0" maxOccurs="1" nillable="true" />
<element name="cambioAutomatico" type="dtt:SiNoType"
minOccurs="1" maxOccurs="1" />
<element name="abilitazioneCategoriaA"
type="dtt:IndCategoriaAType" minOccurs="0" maxOccurs="1"
nillable="true" />
<element name="elencoPrescrizioniTecniche"
type="dtt:ElencoPrescrizioniTecnicheType" minOccurs="0"
maxOccurs="1" nillable="true" />
<element name="patenteItalianaPrecedente"
type="dtt:PatenteItalianaType" minOccurs="0" maxOccurs="1"
nillable="true" />
<element name="categoriaPossedutaEstesa"
type="dtt:CategoriaDisponibileType" minOccurs="0"
maxOccurs="1" nillable="true" />
<element name="categoriaPosseduta"
type="dtt:CategoriaRichiestaType" minOccurs="0" maxOccurs="1"
nillable="true" />
</sequence>
</complexType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 103 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:dettaglioRichiestaEsame>
<dtt:marcaOperativa>98RM463676</dtt:marcaOperativa>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:datiAnagrafici>
<dtt:nome>LINO</dtt:nome>
<dtt:cognome>ROSSI</dtt:cognome>
<dtt:dataNascita>1970-12-21</dtt:dataNascita>
<dtt:codiceFiscale>RSSLNI70T21Z505F</dtt:codiceFiscale>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaEstero>
<dtt:localitaEsteraNascita>SANTO DOMINGO</dtt:localitaEsteraNascita>
<dtt:statoEsteroNascita>DOM</dtt:statoEsteroNascita>
</dtt:luogoNascitaEstero>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>ROMA</dtt:provinciaResidenza>
<dtt:comuneResidenza>ROMA</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>09</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>A1 = A1</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>A1</dtt:categoriaRichiesta>
<dtt:validitaPatenteRichiestaMM>9</dtt:validitaPatenteRichiestaMM>
<dtt:validitaPatenteRichiestaAA>9</dtt:validitaPatenteRichiestaAA>
<dtt:cambioAutomatico>S</dtt:cambioAutomatico>
<dtt:abilitazioneCategoriaA>1</dtt:abilitazioneCategoriaA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA IN ORARIO DIURNO</dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
<dtt:patenteItalianaPrecedente/>
</dtt:dettaglioRichiestaEsame>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 104 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.22 DatiRichiestaEsameType
Insieme delle informazioni fornite in input in fase di inserimento e modifica di una richiesta per
esame.

<complexType name="DatiRichiestaEsameType">
<sequence>
<element name="marcaOperativaPrecedente"
type="dtt:MarcaOperativaType" minOccurs="0" maxOccurs="1"
nillable="true" />
<element name="ufficioOperativo" type="dtt:CharDue"
minOccurs="1" maxOccurs="1" />
<element name="codiceOperatore" type="dtt:CharQuattro"
minOccurs="1" maxOccurs="1" />
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 105 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<element name="dataIscrizione"
type="date" minOccurs="0" maxOccurs="1" nillable="true"/>
<element name="datiAnagrafici"
type="dtt:AnagraficaRichiedenteType" minOccurs="1" \
maxOccurs="1" />
<element name="datiResidenza" type="dtt:LuogoResidenzaType"
minOccurs="1" maxOccurs="1" />
<element name="categoriaDisponibile"
type="dtt:CategoriaDisponibileType" minOccurs="1"
maxOccurs="1" />
<element name="categoriaRichiesta"
type="dtt:CategoriaRichiestaType" minOccurs="1"
maxOccurs="1"/>
<element name="validitaPatenteRichiestaMM" type="integer"
minOccurs="1" maxOccurs="1" />
<element name="validitaPatenteRichiestaAA" type="integer"
minOccurs="1" maxOccurs="1" />
<element name="cambioAutomatico" type="dtt:SiNoType"
minOccurs="1" maxOccurs="1" />
<element name="abilitazioneCategoriaA"
type="dtt:IndCategoriaAType" minOccurs="0" maxOccurs="1" />
<element name="elencoPrescrizioniTecniche"
type="dtt:ElencoPrescrizioniTecnicheType" minOccurs="0"
maxOccurs="1" />
<element name="patenteItalianaPrecedente"
type="dtt:PatenteItalianaType" minOccurs="0" maxOccurs="1"
nillable="true"/>
<element name="categoriaPosseduta"
type="dtt:CategoriaDisponibileType" minOccurs="0"
maxOccurs="1" nillable="true"/>
</sequence>
</complexType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 106 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:datiRichiestaEsameType>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:datiAnagrafici>
<dtt:nome>CAROLINA</dtt:nome>
<dtt:cognome>ROSSITTO</dtt:cognome>
<dtt:dataNascita>1970-12-21</dtt:dataNascita>
<dtt:codiceFiscale>RSSCLN70T61A089U</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEABgAAQAUUUUAFFFFABKKKAC/9k=</dtt:foto>
<dtt:sesso>F</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>AGRIGENTO</dtt:provinciaNascita>
<dtt:comuneNascita>AGRIGENTO</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>AGRIGENTO</dtt:provinciaResidenza>
<dtt:comuneResidenza>AGRIGENTO</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>PO</dtt:indirizzoResidenza>
<dtt:civicoResidenza>90</dtt:civicoResidenza>
<dtt:capResidenza>00100</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>B = B</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>B </dtt:categoriaRichiesta>
<dtt:validitaPatenteRichiestaMM>09</dtt:validitaPatenteRichiestaMM>
<dtt:validitaPatenteRichiestaAA>09</dtt:validitaPatenteRichiestaAA>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:abilitazioneCategoriaA></dtt:abilitazioneCategoriaA>
<dtt:elencoPrescrizioniTecniche>
<dtt:PrescrizioniTecniche>COPRI OCCHIO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche>GUIDA IN ORARIO DIURNO</dtt:PrescrizioniTecniche>
<dtt:PrescrizioniTecniche></dtt:PrescrizioniTecniche>
</dtt:elencoPrescrizioniTecniche>
</dtt:datiRichiestaEsameType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 107 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.23 LuogoNascitaRicercaType
Consente di specificare, nellambito della ricerca per dati anagrafici, il luogo di nascita del
conducente.

<complexType name="LuogoNascitaRicercaType">
<choice>
<element name="luogoNascitaItaliano"
type="dtt:LuogoNascitaItalianoType">
</element>
<element name="luogoNascitaEstero"
type="dtt:LuogoNascitaEsteroRicercaType">
</element>
</choice>
</complexType>

Esempio
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>AGRIGENTO</dtt:provinciaNascita>
<dtt:comuneNascita>AGRIGENTO</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>

<dtt:luogoNascita>
<dtt:luogoNascitaEstero>
<dtt:statoEsteroNascita>BRASILE</dtt:provinciaNascita>
</dtt:luogoNascitaEstero>
</dtt:luogoNascita>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 108 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.24 DettaglioPrenotazioneConversioneOutputType
E lelenco dettagliato delle informazioni che identificano univocamente una prenotazione per
conversione.

<complexType name="DettaglioPrenotazioneConversioneOutputType">
<choice>
<sequence>
<element name="dettaglioPrenotazioneConversione"
type="dtt:DettaglioPrenotazioneConversioneType"
minOccurs="0" maxOccurs="1" />
<element name="messaggio" type="dtt:MessaggioType"
minOccurs="0" maxOccurs="unbounded">
</element>
</sequence>
<element name="errore" type="dtt:ErrorType" minOccurs="0"
maxOccurs="unbounded">
</element>
</choice>
</complexType>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 109 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:dettaglioPrenotazioneConversioneResponse>
<dtt:dettaglioPrenotazioneConversione>
<dtt:marcaOperativa>75RM000528</dtt:marcaOperativa>
<dtt:statoPrenotazione>INSERITA</dtt:statoPrenotazione>
<dtt:dataVariazioneStato>2010-03-23</dtt:dataVariazioneStato>
<dtt:dataInserimento>2010-03-23</dtt:dataInserimento>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>MILITARE</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>VUJJ</dtt:nome>
<dtt:cognome>COJJ</dtt:cognome>
<dtt:dataNascita>1980-12-14</dtt:dataNascita>
<dtt:codiceFiscale>BBBBBB80A66H501B</dtt:codiceFiscale>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaEstero>
<dtt:localitaEsteraNascita>LONDRA</dtt:localitaEsteraNascita>
<dtt:statoEsteroNascita>GR. BRETAGNA</dtt:statoEsteroNascita>
</dtt:luogoNascitaEstero>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>AOSTA</dtt:provinciaResidenza>
<dtt:comuneResidenza>AOSTA</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>DEI GATTI NANI</dtt:indirizzoResidenza>
<dtt:civicoResidenza>112</dtt:civicoResidenza>
<dtt:capResidenza>00122</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>BS</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>BS</dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCatA>N</dtt:cambioAutomaticoCatA>
<dtt:patenteItalianaPrecedente/>
<dtt:elencoAnomalie/>
</dtt:dettaglioPrenotazioneConversione>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di visualizzazione del dettaglio della
prenotazione eseguita con successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:dettaglioPrenotazioneConversioneResponse>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 110 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.25 DettaglioPrenotazioneDuplicatoOutputType
E lelenco dettagliato delle informazioni che identificano univocamente una prenotazione per
duplicato.

<complexType name="DettaglioPrenotazioneDuplicatoOutputType">
<choice>
<sequence>
<element name="dettaglioPrenotazioneDuplicato"
type="dtt:DettaglioPrenotazioneDuplicatoType"
minOccurs="0" maxOccurs="1" />
<element name="messaggio" type="dtt:MessaggioType"
minOccurs="0" maxOccurs="unbounded">
</element>
</sequence>
<element name="errore" type="dtt:ErrorType" minOccurs="0"
maxOccurs="unbounded">
</element>
</choice>
</complexType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 111 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:dettaglioPrenotazioneDuplicatoResponse>
<dtt:dettaglioPrenotazioneDuplicato>
<dtt:marcaOperativa>75RM000531</dtt:marcaOperativa>
<dtt:statoPrenotazione>INSERITA</dtt:statoPrenotazione>
<dtt:dataVariazioneStato>2010-03-24</dtt:dataVariazioneStato>
<dtt:dataInserimento>2010-03-24</dtt:dataInserimento>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:motivoRichiesta>DETERIORAMENTO</dtt:motivoRichiesta>
<dtt:datiAnagrafici>
<dtt:nome>STEFANO</dtt:nome>
<dtt:cognome>TEODOLI</dtt:cognome>
<dtt:dataNascita>1970-12-21</dtt:dataNascita>
<dtt:codiceFiscale>TDLSFN70T21H501O</dtt:codiceFiscale>
<dtt:foto>/9j/4AAQSkZJRgABAQEAYABgAAD/</dtt:foto>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>ROMA</dtt:provinciaNascita>
<dtt:comuneNascita>ROMA</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>ROMA</dtt:provinciaResidenza>
<dtt:comuneResidenza>ROMA</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>NAZIONALE</dtt:indirizzoResidenza>
<dtt:civicoResidenza>123</dtt:civicoResidenza>
<dtt:capResidenza>00123</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>D = B + C + D</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>D</dtt:categoriaRichiesta>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:cambioAutomaticoCategA>N</dtt:cambioAutomaticoCategA>
<dtt:patentePrecedente>
<dtt:numeroPatente>RM6363039P</dtt:numeroPatente>
</dtt:patentePrecedente>
<dtt:elencoAnomalie>
<dtt:anomalia>PRESCRIZIONI TECNICHE DIFFERENTI DA PATENTE
POSSEDUTA</dtt:anomalia>
</dtt:elencoAnomalie>
</dtt:dettaglioPrenotazioneDuplicato>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di visualizzazione del dettaglio della
prenotazione eseguita con successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:dettaglioPrenotazioneDuplicatoResponse>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 112 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.26 IdentificativoPrenotazioneType
E lelenco delle informazioni che identificano univocamente una prenotazione.

<complexType name="IdentificativoPrenotazioneType">
<sequence>
<element name="login" type="dtt:LoginType" minOccurs="1"
maxOccurs="1" />
<element name="marcaOperativa"
type="dtt:MarcaOperativaPrenotazioneType" minOccurs="1"
maxOccurs="1" />
</sequence>
</complexType>

Esempio
<dtt:identificativoPrenotazione
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.dtt.it/xsd/PrenotaPatenteWS
./CommonTypesPrenotazionePatente.xsd ">
<dtt:login>
<dtt:codicePin></dtt:codicePin>
</dtt:login>
<dtt:marcaOperativa>75RM000489</dtt:marcaOperativa>
</dtt:identificativoPrenotazione>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 113 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.27 DettaglioRichiestaEsameOutputType
E lelenco dettagliato delle informazioni che identificano univocamente una richiesta per
esame.

<complexType name="DettaglioRichiestaEsameOutputType">
<choice>
<sequence>
<element name="dettaglioRichiestaEsame"
type="dtt:DettaglioRichiestaEsameEstesoType"
minOccurs="0" maxOccurs="1" />
<element name="messaggio" type="dtt:MessaggioType"
minOccurs="0" maxOccurs="unbounded">
</element>
</sequence>
<element name="errore" type="dtt:ErrorType" minOccurs="0"
maxOccurs="unbounded">
</element>
</choice>
</complexType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 114 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:dettaglioRichiestaEsameResponse>
<dtt:dettaglioRichiestaEsame>
<dtt:marcaOperativa>98RM463798</dtt:marcaOperativa>
<dtt:ufficioOperativo>R1</dtt:ufficioOperativo>
<dtt:codiceOperatore>1010</dtt:codiceOperatore>
<dtt:datiAnagrafici>
<dtt:nome>LUCA</dtt:nome>
<dtt:cognome>TANTARI</dtt:cognome>
<dtt:dataNascita>1973-12-11</dtt:dataNascita>
<dtt:codiceFiscale>TNTLCU73T11H501C</dtt:codiceFiscale>
<dtt:sesso>M</dtt:sesso>
<dtt:luogoNascita>
<dtt:luogoNascitaItaliano>
<dtt:provinciaNascita>ROMA</dtt:provinciaNascita>
<dtt:comuneNascita>ROMA</dtt:comuneNascita>
</dtt:luogoNascitaItaliano>
</dtt:luogoNascita>
</dtt:datiAnagrafici>
<dtt:datiResidenza>
<dtt:provinciaResidenza>ROMA</dtt:provinciaResidenza>
<dtt:comuneResidenza>ROMA</dtt:comuneResidenza>
<dtt:toponimoResidenza>VIA</dtt:toponimoResidenza>
<dtt:indirizzoResidenza>TOSCANINI</dtt:indirizzoResidenza>
<dtt:civicoResidenza>15</dtt:civicoResidenza>
<dtt:capResidenza>00125</dtt:capResidenza>
</dtt:datiResidenza>
<dtt:categoriaDisponibile>B = B</dtt:categoriaDisponibile>
<dtt:categoriaRichiesta>B</dtt:categoriaRichiesta>
<dtt:validitaPatenteRichiestaMM>5</dtt:validitaPatenteRichiestaMM>
<dtt:validitaPatenteRichiestaAA>9</dtt:validitaPatenteRichiestaAA>
<dtt:cambioAutomatico>N</dtt:cambioAutomatico>
<dtt:abilitazioneCategoriaA/>
<dtt:patenteItalianaPrecedente/>
</dtt:dettaglioRichiestaEsame>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di visualizzazione dettaglio eseguita
con successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:dettaglioRichiestaEsameResponse>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 115 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.28 DocumentoOutputRichiestaEsameType

<complexType name="DocumentoOutputRichiestaEsameType">
<choice>
<sequence>
<element name="marcaOperativa"
type="dtt:MarcaOperativaRichiestaEsameType"
minOccurs="1" maxOccurs="1" />
<element name="pdf" type="dtt:FileType"></element>
<element name="messaggio" type="dtt:MessaggioType"
minOccurs="0" maxOccurs="unbounded">
</element>
</sequence>
<element name="errore" type="dtt:ErrorType" minOccurs="0"
maxOccurs="unbounded">
</element>
</choice>
</complexType>

Esempio
<dtt:documentoOutputRichiestaEsame
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:marcaOperativa>98RM463740</dtt:marcaOperativa>
<dtt:pdf>JVBERi0xLjQKJeLjz9MKMyAwIG9iaiA8PC9</dtt:pdf>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di emissione online del foglio rosa
eseguita con successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:documentoOutputRichiestaEsame>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 116 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.29 DettaglioPrenotazioneType
E lelenco di tutte le informazioni inerenti il singolo record restituito in output dal servizio
Ricerca Prenotazione.

<complexType name="DettaglioPrenotazioneType">
<annotation>
<documentation>
Rappresenta un record della lista delle prenotazioni
ricercate
</documentation>
</annotation>
<sequence>
<element name="marcaOperativa"
type="dtt:MarcaOperativaPrenotazioneType" minOccurs="1"
maxOccurs="1" />
<element name="statoPrenotazione"
type="dtt:StatoPrenotazioneType" minOccurs="0" maxOccurs="1"/>
<element name="codiceOperatore" type="dtt:CharQuattro"
minOccurs="1" maxOccurs="1" />
<element name="dataVariazioneStato" type="date"
minOccurs="1" maxOccurs="1" />
<element name="nome" type="string" minOccurs="0"
maxOccurs="1" />
<element name="cognome" type="string" minOccurs="1"
maxOccurs="1" />
<element name="motivoRichiesta"
type="dtt:ElencoMotivoRichiestaType" minOccurs="1"
maxOccurs="1" />
<element name="presenzaAn" type="dtt:SiNoType" minOccurs="1"
maxOccurs="1" />
<element name="presenzaFoto" type="dtt:SiNoType"
minOccurs="1" maxOccurs="1" />
</sequence>
</complexType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 117 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<pren:ricercaPrenotazioneOutput
xmlns:pren="http://www.dtt.it/xsd/PrenotaPatenteWS">
<pren:elencoPrenotazioni>
<pren:dettaglioPrenotazione>
<pren:marcaOperativa>75RM000015</pren:marcaOperativa>
<pren:codiceOperatore>1010</pren:codiceOperatore>
<pren:dataVariazioneStato>2009-06-23</pren:dataVariazioneStato>
<pren:cognome>DD</pren:cognome>
<pren:motivoRichiesta>ESTERA</pren:motivoRichiesta>
<pren:presenzaAn>N</pren:presenzaAn>
<pren:presenzaFoto>S</pren:presenzaFoto>
</pren:dettaglioPrenotazione>
<pren:dettaglioPrenotazione>
<pren:marcaOperativa>75RM000211</pren:marcaOperativa>
<pren:codiceOperatore>0001</pren:codiceOperatore>
<pren:dataVariazioneStato>2009-06-05</pren:dataVariazioneStato>
<pren:cognome>PREDATA</pren:cognome>
<pren:motivoRichiesta>MILITARE</pren:motivoRichiesta>
<pren:presenzaAn>N</pren:presenzaAn>
<pren:presenzaFoto>S</pren:presenzaFoto>
</pren:dettaglioPrenotazione>
<pren:dettaglioPrenotazione>
<pren:marcaOperativa>75RM000242</pren:marcaOperativa>
<pren:codiceOperatore>1010</pren:codiceOperatore>
<pren:dataVariazioneStato>2009-06-04</pren:dataVariazioneStato>
<pren:cognome>TEODOLI</pren:cognome>
<pren:motivoRichiesta>ESTERA</pren:motivoRichiesta>
<pren:presenzaAn>N</pren:presenzaAn>
<pren:presenzaFoto>S</pren:presenzaFoto>
</pren:dettaglioPrenotazione>
<pren:numeroRecordTotali>3</pren:numeroRecordTotali>
<pren:numeroRecordPagina>10</pren:numeroRecordPagina>
</pren:elencoPrenotazioni>
<pren:messaggio>
<pren:codiceMessaggio>02</pren:codiceMessaggio>
<pren:descrizioneMessaggio>operazione eseguita con
successo</pren:descrizioneMessaggio>
</pren:messaggio>
</pren:ricercaPrenotazioneOutput>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 118 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.1.30 DettaglioRichiestaType
E lelenco di tutte le informazioni inerenti il singolo record restituito in output dal servizio
Ricerca Richiesta Esame.

<complexType name="DettaglioRichiestaType">
<annotation>
<documentation>
Rappresenta il record della richiesta ricercata
</documentation>
</annotation>
<sequence>
<element name="marcaOperativa"
type="dtt:MarcaOperativaRichiestaEsameType" minOccurs="1"
maxOccurs="1" />
<element name="statoPrenotazione"
type="dtt:StatoRichiestaType" minOccurs="1" maxOccurs="1" />
<element name="dataInserimento" type="date" minOccurs="1"
maxOccurs="1" />
<element name="codiceOperatore" type="dtt:CharQuattro"
minOccurs="1" maxOccurs="1" />
<element name="cognome" type="string" minOccurs="1"
maxOccurs="1" />
<element name="nome" type="string" minOccurs="0"
maxOccurs="1" />
<element name="presenzaFoto" type="dtt:SiNoType"
minOccurs="1" maxOccurs="1" />
</sequence>
</complexType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 119 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Esempio
<dtt:ricercaRichiestaEsameOutput
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:elencoRichiesteEsame>
<dtt:dettaglioRichiesta>
<dtt:marcaOperativa>98RM463673</dtt:marcaOperativa>
<dtt:statoPrenotazione>ATTIVO</dtt:statoPrenotazione>
<dtt:dataInserimento>2009-09-18</dtt:dataInserimento>
<dtt:codiceOperatore>0001</dtt:codiceOperatore>
<dtt:cognome>TOPO</dtt:cognome>
<dtt:nome>LINO</dtt:nome>
<dtt:presenzaFoto>S</dtt:presenzaFoto>
</dtt:dettaglioRichiesta>
<dtt:numeroRecordTotali>1</dtt:numeroRecordTotali>
<dtt:numeroRecordPagina>10</dtt:numeroRecordPagina>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:elencoRichiesteEsame>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di ricerca eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:ricercaRichiestaEsameOutput>

5.1.31 DettaglioFoglioRosaType
E lelenco di tutte le informazioni inerenti il singolo record restituito in output dal servizio
Ricerca Foglio Rosa.

<complexType name="DettaglioFoglioRosaType">
<annotation>
<documentation>
Rappresenta un record della lista dei Foglio Rosa
ricercati
</documentation>
</annotation>
<sequence>
<element name="marcaOperativaFoglioRosa"
type="dtt:MarcaOperativaFoglioRosaType" minOccurs="1"
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 120 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

maxOccurs="1" />
<element name="statino" type="dtt:CharSei" minOccurs="1"
maxOccurs="1" />
<element name="dataEmissione" type="date" minOccurs="1"
maxOccurs="1" />
<element name="cognome" type="string" minOccurs="1"
maxOccurs="1"/>
<element name="nome" type="string" minOccurs="0"
maxOccurs="1"/>
</sequence>
</complexType>

Esempio
<dtt:ricercaFoglioRosaOutput
xmlns:dtt="http://www.dtt.it/xsd/PrenotaPatenteWS">
<dtt:foglioRosa>
<dtt:dettaglioFoglioRosa>
<dtt:marcaOperativaFoglioRosa>98RM463682</dtt:marcaOperativaFoglioRosa>
<dtt:statino>R4RQ2H</dtt:statino>
<dtt:dataEmissione>2009-11-03</dtt:dataEmissione>
<dtt:cognome>TEODOLI</dtt:cognome>
<dtt:nome>CAROLINA</dtt:nome>
</dtt:dettaglioFoglioRosa>
<dtt:numeroRecordTotali>10</dtt:numeroRecordTotali>
<dtt:numeroRecordPagina>10</dtt:numeroRecordPagina>
<dtt:numeroPagina>1</dtt:numeroPagina>
</dtt:foglioRosa>
<dtt:messaggio>
<dtt:codiceMessaggio>02</dtt:codiceMessaggio>
<dtt:descrizioneMessaggio>Operazione di ricerca eseguita con
successo</dtt:descrizioneMessaggio>
</dtt:messaggio>
</dtt:ricercaFoglioRosaOutput>

5.2

Tipi Semplici

5.2.1 MarcaOperativaPrenotazioneType
<simpleType name="MarcaOperativaPrenotazioneType">
<restriction base="string">
<length value="10"></length>
<pattern value="75[A-Za-z][A-Za-z][0-9][0-9][0-9][0-9][0-9][0-9]">
</pattern>
</restriction>
</simpleType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 121 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.2.2 MotivoRichiestaConversioneType
<simpleType name="MotivoRichiestaConversioneType">
<restriction base="string">
<enumeration value="ESTERA" />
<enumeration value="MILITARE" />
</restriction>
</simpleType>

5.2.3 MotivoRichiestaDuplicatoType
<simpleType name="MotivoRichiestaDuplicatoType">
<restriction base="string">
<enumeration value="DETERIORAMENTO" />
<enumeration value="SMARRIMENTO" />
<enumeration value="RICLASSIFICAZIONE" />
</restriction>
</simpleType>

5.2.4 ElencoMotivoRichiestaType
<simpleType name="ElencoMotivoRichiestaType">
<restriction base="string">
<enumeration value="ESTERA" />
<enumeration value="MILITARE" />
<enumeration value="DETERIORAMENTO" />
<enumeration value="SMARRIMENTO" />
<enumeration value="RICLASSIFICAZIONE" />
</restriction>
</simpleType>

5.2.5 StatoPrenotazioneType
<simpleType name="StatoPrenotazioneType">
<restriction base="string">
<enumeration value="APPROVATA" />
<enumeration value="RIVEDERE" />
<enumeration value="INSERITA" />
<enumeration value="RIFIUTATA" />
<enumeration value="RILASCIATA" />
<enumeration value="BLOCCATA DA RICHIESTA" />
<enumeration value="BLOCCATA DA UP" />
</restriction>
</simpleType>

5.2.6 PatenteEsteraType
<simpleType name="PatenteEsteraType">
<restriction base="string">
<minLength value="1"></minLength>
<maxLength value="12"></maxLength>
<whiteSpace value="collapse"/>
</restriction>
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 122 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

</simpleType>

5.2.7 MarcaOperativaType
<simpleType name="MarcaOperativaType">
<annotation>
<documentation>
Definisce in generale il formato di una marca operativa.
</documentation>
</annotation>
<restriction base="string">
<length value="10"></length>
<pattern
value="[0-9][0-9][A-Za-z][A-Za-z][0-9][0-9][0-9][0-9][0-9][0-9]">
</pattern>
</restriction>
</simpleType>

5.2.8 SiNoType
<simpleType name="SiNoType">
<annotation>
<documentation>
Definisce la selezione dei valori S (si) e N (no).
</documentation>
</annotation>
<restriction base="string">
<enumeration value="S" />
<enumeration value="N" />
</restriction>
</simpleType>

5.2.9 SessoType
<simpleType name="SessoType">
<restriction base="string">
<enumeration value="F" />
<enumeration value="M" />
</restriction>
</simpleType>
5.2.10 FileType
<simpleType name="FileType">
<restriction base="base64Binary"></restriction>
</simpleType>

5.2.11 IndCategoriaAType
<simpleType name="IndCategoriaAType">
<restriction base="string">
<enumeration value="" />
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 123 di 138

Specifiche Integrazione Web Services

<enumeration
<enumeration
<enumeration
<enumeration
</restriction>
</simpleType>

Specifiche integrazione WebServices.doc

value="1"
value="2"
value="3"
value="4"

/>
/>
/>
/>

5.2.12 CambioManualeConvEsteraType
<simpleType name="CambioManualeConvEsteraType">
<restriction base="string">
<enumeration value="B" />
<enumeration value="C" />
</restriction>
</simpleType>

5.2.13 CategoriaDisponibileType
<simpleType name="CategoriaDisponibileType">
<restriction base="string">
<enumeration value="" />
<enumeration value="AS" />
<enumeration value="A1 = A1" />
<enumeration value="A2 = A2" />
<enumeration value="A3 = A3" />
<enumeration value="A4 = A4" />
<enumeration value="B = B" />
<enumeration value="BE = B + BE" />
<enumeration value="BS" />
<enumeration value="B1 = B1" />
<enumeration value="C = B + C" />
<enumeration value="CE = B + BE + C + CE" />
<enumeration value="CS" />
<enumeration value="C1 = B + C1" />
<enumeration value="D = B + C + D" />
<enumeration value="DE = B + BE + C + CE + D + DE" />
<enumeration value="DK = B + BE + C + D + DE" />
<enumeration value="DS" />
<enumeration value="DX = DW" />
<enumeration value="DW = B + D" />
<enumeration value="DY = B + BE + D" />
<enumeration value="DZ = B + BE + D + DE" />
<enumeration value="D1 = B + C1 + D1" />
<enumeration value="D9 = B + D1" />
<enumeration value="HE = B + BE + C1" />
<enumeration value="JE = B + BE + D1" />
<enumeration value="XE = B + BE + C" />
<enumeration value="YE = B + BE + C + D" />
<enumeration value="ZE = B + BE + C1 + D1 + HE" />
</restriction>
</simpleType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 124 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.2.14 CategoriaRichiestaType
<simpleType name="CategoriaRichiestaType">
<restriction base="string">
<enumeration value="" />
<enumeration value="AS" />
<enumeration value="A1" />
<enumeration value="A2" />
<enumeration value="A3" />
<enumeration value="A4" />
<enumeration value="B " />
<enumeration value="BE" />
<enumeration value="BS" />
<enumeration value="B1" />
<enumeration value="C " />
<enumeration value="CE" />
<enumeration value="CS" />
<enumeration value="C1" />
<enumeration value="D " />
<enumeration value="DE" />
<enumeration value="DK" />
<enumeration value="DS" />
<enumeration value="DX" />
<enumeration value="DW" />
<enumeration value="DY" />
<enumeration value="DZ" />
<enumeration value="D1" />
<enumeration value="D9" />
<enumeration value="HE" />
<enumeration value="JE" />
<enumeration value="XE" />
<enumeration value="YE" />
<enumeration value="ZE" />
</restriction>
</simpleType>

5.2.15

PrescrizioniTecnicheType

<simpleType name="PrescrizioniTecnicheType">
<restriction base="string">
<enumeration value="" />
<enumeration value="COPRI OCCHIO" />
<enumeration value="GUIDA ACCOMPAGNATO DA TITOLARE DI PATENTE"/>
<enumeration value="GUIDA IN ORARIO DIURNO" />
<enumeration value="GUIDA NON AUTORIZZATA IN AUTOSTRADA" />
<enumeration value="GUIDA SENZA PASSEGGERI" />
<enumeration value="GUIDA SENZA RIMORCHIO" />
<enumeration value="LENTE OPACA" />
<enumeration value="LENTE PROTETTIVA" />
<enumeration value="LENTI A CONTATTO" />
<enumeration value="NIENTE ALCOOL" />
<enumeration value="OCCHIALI" />
<enumeration value="OCCHIALI O LENTI A CONTATTO" />
<enumeration value="PERCORSO LIMITATO" />
<enumeration value="PROTESI UDITIVA" />
<enumeration value="PROTESI UDITIVA AD ENTRAMBE LE ORECCHIE" />
<enumeration value="PROTESI UDITIVA AD UN ORECCHIO" />
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 125 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<enumeration value="VELOCITA' DI GUIDA LIMITATA" />


</restriction>
</simpleType>

5.2.16

CharDue

<simpleType name="CharDue">
<annotation>
<documentation>
Definisce i vincoli da rispettare per l'inserimento di
una stringa di 2 caratteri
</documentation>
</annotation>
<restriction base="string">
<length value="2"></length>
</restriction>
</simpleType>

5.2.17 CharQuattro
<simpleType name="CharQuattro">
<annotation>
<documentation>
Definisce i vincoli da rispettare per l'inserimento di
una stringa di 4 caratteri
</documentation>
</annotation>
<restriction base="string">
<length value="4"></length>
</restriction>
</simpleType>

5.2.18 CharCinque
<simpleType name="CharCinque">
<annotation>
<documentation>
Definisce i vincoli da rispettare per l'inserimento di
una stringa di 5 caratteri
</documentation>
</annotation>
<restriction base="string">
<length value="5"></length>
</restriction>
</simpleType>

5.2.19 CharSei
<simpleType name="CharSei">
<annotation>
<documentation>
Definisce i vincoli da rispettare per l'inserimento di
una stringa di 6 caratteri
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 126 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

</documentation>
</annotation>
<restriction base="string">
<length value="6"></length>
</restriction>
</simpleType>

5.2.20 CharOtto
<simpleType name="CharOtto">
<annotation>
<documentation>
Definisce i vincoli da rispettare per l'inserimento di
una stringa di 8 caratteri
</documentation>
</annotation>
<restriction base="string">
<length value="8"></length>
</restriction>
</simpleType>

5.2.21 CharDieci
<simpleType name="CharDieci">
<annotation>
<documentation>
Definisce i vincoli da rispettare per l'inserimento di
una stringa di 10 caratteri
</documentation>
</annotation>
<restriction base="string">
<length value="10"></length>
</restriction>
</simpleType>

5.2.22 CharSedici
<simpleType name="CharSedici">
<annotation>
<documentation>
Definisce i vincoli da rispettare per l'inserimento di
una stringa di 16 caratteri
</documentation>
</annotation>
<restriction base="string">
<length value="16"></length>
</restriction>
</simpleType>

5.2.23 VarCharOtto
<simpleType name="VarCharOtto">
<restriction base="string">
RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda
AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 127 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

<maxLength value="10"></maxLength>
</restriction>
</simpleType>

5.2.24 VarCharDieci
<simpleType name="VarCharDieci">
<restriction base="string">
<maxLength value="10"></maxLength>
</restriction>
</simpleType>

5.2.25 MarcaOperativaRichiestaEsameType
<simpleType name="MarcaOperativaRichiestaEsameType">
<annotation>
<documentation>
Definisce il formato di una marca operativa per esame.
</documentation>
</annotation>
<restriction base="string">
<length value="10"></length>
<pattern
value="98[A-Za-z][A-Za-z][0-9][0-9][0-9][0-9][0-9][0-9]">
</pattern>
</restriction>
</simpleType>

5.2.26 StatoRichiestaType
<simpleType name="StatoRichiestaType">
<restriction base="string">
<enumeration value="ATTIVO" />
<enumeration value="BLOCCATO_REVERSIBILE" />
<enumeration value="BLOCCATO_NON_REVERSIBILE" />
<enumeration value="BLOCCATO_PRESENZA_OSTATIVO" />
<enumeration value="BLOCCATO_ASSENZA_MINORAZIONI" />
</restriction>
</simpleType>

5.2.27 MarcaOperativaFoglioRosaType
<simpleType name="MarcaOperativaFoglioRosaType">
<restriction base="string">
<length value="10"></length>
<pattern value="98[A-Za-z][A-Za-z][0-9][0-9][0-9][0-9][0-9]
[0-9]"></pattern>
</restriction>
</simpleType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 128 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

5.2.28 VarCharVentidue
<simpleType name="VarCharVentidue">
<restriction base="string">
<minLength value="1"></minLength>
<maxLength value="22"></maxLength>
<whiteSpace value="collapse"></whiteSpace>
</restriction>
</simpleType>

5.2.29 VarCharTrentacinque
<simpleType name="VarCharTrentacinque">
<restriction base="string">
<minLength value="1"></minLength>
<maxLength value="35"></maxLength>
<whiteSpace value="collapse"></whiteSpace>
</restriction>
</simpleType>

5.2.30 VarCharTrentacinqueMinLenghtZero
<simpleType name="VarCharTrentacinqueMinLenghtZero">
<restriction base="string">
<minLength value="0"></minLength>
<maxLength value="35"></maxLength>
<whiteSpace value="collapse"></whiteSpace>
</restriction>
</simpleType>
5.2.31 VarCharTrenta
<simpleType name="VarCharTrenta">
<restriction base="string">
<minLength value="1"></minLength>
<maxLength value="30"></maxLength>
<whiteSpace value="collapse"></whiteSpace>
</restriction>
</simpleType>

5.2.32 VarCharCinque
<simpleType name="VarCharCinque">
<restriction base="string">
<minLength value="1"></minLength>
<maxLength value="5"></maxLength>
<whiteSpace value="collapse"></whiteSpace>
</restriction>
</simpleType>

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 129 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

APPENDICE B: GESTIONE ANAGRAFICHE SPECIALI

I servizi sono stati realizzati tenendo in considerazione la gestione delle anagrafiche speciali.
Quando verranno abilitate le anagrafiche speciali, sar possibile specificare Anagrafiche con
nome e/o cognome con caratteri diacritici
6.1

Regole per inserire/modificare una anagrafica speciale

I valori che entrano in gioco per inserire/modificare una anagrafica speciale sono:

Nome: sempre obbligatorio

Cognome: sempre obbligatorio

Tipo di anagrafica speciale: consente di specificare se lanagrafica diacritica, ovvero


almeno uno tra nome e cognome presenta dei caratteri diacritici. In questo caso
bisogna specificare in input che il tipo di anagrafica speciale ha valore 1: ANAGRAFICA
CON CARATTERISTICHE DIACRITICHE.

Se viene fornito in input il tipo di anagrafiche speciali, ma le anagrafiche non sono abilitate,
verr restituito un errore.
Bisogna tenere in considerazione che se si intende inserire/modificare una anagrafica speciale,
i campi nome e cognome dati in input non verranno convertiti in lettere maiuscole, ma
verranno salvati, cos come forniti in input, in archivio.

6.2

Regole per ricercare una anagrafica speciale

I valori che entrano in gioco per ricercare una anagrafica speciale sono:

6.3

Nome: ove presente, sempre opzionale

Cognome: sempre obbligatorio

Tipo di anagrafica speciale: consente di specificare se lanagrafica ricercata diacritica,


ovvero almeno uno tra nome e cognome presenta dei caratteri diacritici. In questo caso
bisogna specificare in input che il tipo di anagrafica speciale ha valore 1: ANAGRAFICA
CON CARATTERISTICHE DIACRITICHE.
Tabella caratteri diacritici ammessi

I caratteri diacritici consentiti nel servizio sono i seguenti:

A acuta

a acuta

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 130 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

A grave

a grave

A circonflessa

a circonflessa

A dieresi

a dieresi

A breve

a breve

A linea

a linea

A tilde

a tilde

A tondo

a tondo

A ogonek

a ogonek

Insieme AE

Insieme ae

C acuta

c acuta

C punto

c punto

C circonflessa

c circonflessa

C caron

c caron

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 131 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

C cedilla

c cedilla

D caron

d caron

Eth

Eth

Eth

Eth

E acuta

e acuta

E grave

e grave

E punto

e punto

E circonflessa

e circonflessa

E dieresi

e dieresi

E caron

e caron

E breve

e breve

E linea

e linea

E ogonek

e ogonek

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 132 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

G punto

g punto

G circonflessa

g circonflessa

G breve

g breve

G cedilla

g cedilla

H circonflessa

h circonflessa

H barra

h barra

I senza punto

i punto

i senza punto

I acuta

i acuta

I grave

i grave

I punto

I circonflessa

i circonflessa

I dieresi

i dieresi

I breve

i breve

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 133 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

I linea

i linea

I tilde

i tilde

I ogonek

i ogonek

Insieme IJ

Insieme ij

J circonflessa

j circonflessa

K cedilla

k cedilla

L acuta

l acuta

L punto

l punto

L caron

l caron

L cedilla

l cedilla

L barra traversa

l barra traversa

N acuta

n acuta

N caron

n caron

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 134 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

N tilde

n tilde

N cedilla

n cedilla

Eng

Eng

O acuta

o acuta

O grave

o grave

O circonflessa

o circonflessa

O dieresi

o dieresi

O breve

o breve

O linea

o linea

O tilde

o tilde

O doppia acuta

o doppia acuta

O barra

o barra

Insieme OE

Insieme oe

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 135 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

Insieme OE

Insieme oe

R acuta

r acuta

R caron

r caron

R cedilla

r cedilla

S acuta

s acuta

S circonflessa

s circonflessa

S caron

s caron

S caron

s caron

S cedilla

s cedilla

Doppia s

T caron

t caron

T cedilla

t cedilla

Thorn

Thorn

T barra

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 136 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

t barra

U acuta

u acuta

U grave

u grave

U circonflessa

u circonflessa

U dieresi

u dieresi

U breve

u breve

U linea

u linea

U tilde

u tilde

U tondo

u tondo

U ogonek

u ogonek

U doppia acuta

u doppia acuta

W circonflessa

w circonflessa

Y acuta

y acuta

Y circonflessa

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 137 di 138

Specifiche Integrazione Web Services

Specifiche integrazione WebServices.doc

y circonflessa

Y dieresi

y dieresi

Y dieresi

Z acuta

z acuta

Z punto

z punto

Z caron

z caron

RTI EDS Italia S.p.A./Consorzio Poste Contact /Auselda


AED Group S.p.A./Postel S.p.A./Gepin Generale per
lInformatica S.p.A.
Uso esterno Riservato al Cliente

Pagina 138 di 138