Manual de Usuario WS

ATEX Manual de Usuario: Servicio Web

Autor: Gerencia de Informática Última Modificación: 01/06/2010

MINISTERIO DEL INTERIOR

DIRECCIÓN GENERAL DE TRÁFICO GERENCIA DE INFORMÁTICA

Índice General 1

INTRODUCCIÓN.........................................................................................................................................................5 1.1 1.2 1.3

2

PROPÓSITO..............................................................................................................................................................5 ALCANCE................................................................................................................................................................5 TERMINOLOGÍA Y ACRÓNIMOS...............................................................................................................................5

DESCRIPCIÓN DE LA APLICACIÓN......................................................................................................................6 2.1

DESCRIPCIÓN...........................................................................................................................................................6

Manual Usuario WS (ATEX)

2



2.2 DEFINICIÓN DEL SERVICIO......................................................................................................................................6 2.2.1 Operación consultarMatricula..........................................................................................................................7 2.2.2 Operación consultarBastidor............................................................................................................................8 2.2.3 Operación consultarNive..................................................................................................................................9 2.2.4 Operación consultarPersonaPorDocumento..................................................................................................10 2.2.5 Operación consultarPersonaPorFiliacion......................................................................................................11 2.3 CARACTERÍSTICAS TÉCNICAS DEL SERVICIO WEB................................................................................................13 3

PARÁMETROS DEL SERVICIO..............................................................................................................................14 3.1 3.2 3.3 3.4

SOLICITUDMATRICULA.........................................................................................................................................14 SOLICITUDBASTIDOR............................................................................................................................................15 SOLICITUDNIVE.....................................................................................................................................................15 VEHÍCULO.............................................................................................................................................................16


3


3.4.1 3.4.2 3.4.3 3.4.4 3.4.5 3.4.6 3.4.7 3.4.8 3.4.9 3.4.10 3.4.11 3.4.12 3.4.13


Identificación...................................................................................................................................................17 Titular..............................................................................................................................................................20 Cotitulares.......................................................................................................................................................21 DomicilioVehiculo...........................................................................................................................................21 Duplicados......................................................................................................................................................21 Poseedores.......................................................................................................................................................22 Transferencias.................................................................................................................................................23 Bajas................................................................................................................................................................23 Itvs...................................................................................................................................................................24 Limitaciones...............................................................................................................................................25 Embargos....................................................................................................................................................25 Precintos.....................................................................................................................................................26 Avisos..........................................................................................................................................................26


4



3.4.14 Denegatorias..............................................................................................................................................27 3.4.15 Seguros.......................................................................................................................................................27 3.4.16 Arrendatarios..............................................................................................................................................28 3.4.17 Tutores........................................................................................................................................................28 3.4.18 Conductores habituales..............................................................................................................................28 3.4.19 Servicio autónomo......................................................................................................................................29 3.5 SOLICITUDDOCUMENTOID.....................................................................................................................................29 3.6 SOLICITUDFILIACION............................................................................................................................................30 3.7 PERSONA...............................................................................................................................................................31 3.7.1 IdentificacionPersona.....................................................................................................................................32 3.7.2 DomicilioPersona............................................................................................................................................33 3.7.3 Indicadores......................................................................................................................................................34 3.7.4 Examenes.........................................................................................................................................................34 Manual Usuario WS (ATEX)

5



3.7.5 Incidencias......................................................................................................................................................35 3.7.6 Tramites...........................................................................................................................................................36 3.7.7 Permisos..........................................................................................................................................................39 3.7.8 Sanciones.........................................................................................................................................................39 3.7.9 Matriculas.......................................................................................................................................................40 3.8 LISTAPERSONAS....................................................................................................................................................40 3.9 ATEXFAULT..........................................................................................................................................................41 4

ANEXOS.......................................................................................................................................................................42 4.1 4.2

ERRORES...............................................................................................................................................................42 DOCUMENTACIÓN RELACIONADA.........................................................................................................................44


6



Índice de Ilustraciones y Tablas Tabla 1. SolicitudMatricula....................................................................................................................14 Tabla 2. SolicitudBastidor......................................................................................................................15 Tabla 3. SolicitudNive............................................................................................................................16 Tabla 4. Vehículo....................................................................................................................................17 Tabla 5. Identificación............................................................................................................................20 Tabla 6. Titular........................................................................................................................................21 Tabla 7. Cotitulares.................................................................................................................................21 Manual Usuario WS (ATEX)

7



Tabla 8. DomicilioVehiculo....................................................................................................................21 Tabla 9. Duplicados................................................................................................................................22 Tabla 10. Poseedores..............................................................................................................................23 Tabla 11. Transferencias.........................................................................................................................23 Tabla 12. Bajas........................................................................................................................................24 Tabla 13. Itvs..........................................................................................................................................25 Tabla 14. Limitaciones............................................................................................................................25 Tabla 15. Embargos................................................................................................................................26 Tabla 16. Precintos..................................................................................................................................26 Tabla 17. Avisos......................................................................................................................................26


8



Tabla 18. Denegatorias...........................................................................................................................27 Tabla 19. Seguros....................................................................................................................................27 Tabla 20. Arrendatarios...........................................................................................................................28 Tabla 21. Tutores....................................................................................................................................28 Tabla 22. Conductores habituales...........................................................................................................28 Tabla 23. Servicio autónomo..................................................................................................................29 Tabla 24. SolicitudDocumentoId............................................................................................................29 Tabla 25. SolicitudFiliacion....................................................................................................................30 Tabla 26. Persona....................................................................................................................................31 Tabla 27. IdentificacionPersona..............................................................................................................32


9



Tabla 28. DomicilioPersona....................................................................................................................33 Tabla 29. Indicadores..............................................................................................................................34 Tabla 30. Examenes................................................................................................................................35 Tabla 31. Incidencias..............................................................................................................................35 Tabla 32. Expediciones...........................................................................................................................36 Tabla 33. Prórrogas.................................................................................................................................37 Tabla 34. Duplicados..............................................................................................................................38 Tabla 35. Permisos..................................................................................................................................39 Tabla 36. Sanciones................................................................................................................................39 Tabla 37. Matriculas...............................................................................................................................40


10



Tabla 38. ListaPersonas..........................................................................................................................40 Tabla 39. AtexFault.................................................................................................................................41 Tabla 40. Listado de Errores ATEX........................................................................................................44


11



1 Introducción Este manual de usuario presenta la información útil para el uso de la aplicación ATEX destinada a la consulta de la información de una persona o un vehículo a través del Servicio Web habilitado para ello. Manual Usuario WS (ATEX)

12



1.1 Propósito El propósito de este texto es facilitar dicha información de manera comprensible y sucinta de tal forma que permita tanto el aprendizaje del uso de la aplicación como ser empleado como documento de consulta.


13



1.2 Alcance Este manual está dirigido a los usuarios que vayan a realizar consultas telemáticas de personas o vehículos en el nuevo marco de aplicación a través del Servicio Web disponible.


14



1.3 Terminología y Acrónimos ATEX: Acceso Telemático de Usuarios Externos. @Firma: Entidad que realiza la validación de la firma de los datos y de los certificados utilizados. LDAP: Repositorio de Usuarios. RGV: Registro General de Vehículos. Manual Usuario WS (ATEX)

15



RGP: Registro General de Personas. DGT: Dirección General de Tráfico.


16



2 Descripción de la Aplicación 2.1 Descripción La aplicación ATEX (Acceso Telemático de Usuarios Externos) ofrece a los distintos Agentes Colaboradores la posibilidad de acceder a la información contenida en los Registros Generales Manual Usuario WS (ATEX)

17



de la DGT. El servicio presenta 5 métodos, 3 para la consulta de vehículos y otros 2 para la consulta de personas. La consulta de vehículos se podrá realizar bien introduciendo la matrícula, bastidor o el nive contenida en el Registro General de Vehículos. La consulta de personas ofrece la posibilidad de acceder a la información de una persona, contenida en el Registro General de Personas. La consulta se podrá realizar bien mediante el


18



documento de identificación de la persona (NIF, NIE o CIF) o bien mediante su filiación (nombre y apellidos, o razón social). La información mostrada será controlada y filtrada en función del perfil de los usuarios que accedan a la aplicación.


19



Sólo se permitirá el acceso a aquellos agentes colaboradores que estén dados de alta como usuarios autorizados para la consulta correspondiente. Además, también se validará que tengan acceso para acceder a un tipo de búsqueda u otra.


20



2.2 Definición del Servicio El servicio aquí descrito permitirá a los distintos Agentes Colaboradores realizar de manera online la consulta de la información asociada a una persona o vehículo.


21



2.2.1Operación consultarMatricula Esta operación permite realizar la consulta de vehículos a partir de su matrícula: validará las peticiones recibidas, comprobará si el usuario está autorizado y tiene los permisos necesarios para la consulta de vehículos y en concreto por matrícula, validará los datos introducidos, accederá al RGV, la información recogida del registro será filtrada según el perfil del usuario y devolverá la respuesta.


22



A continuación se describen los parámetros de entrada, salida y de error de este método, pero las estructuras detalladas se pueden encontrar en el apartado 3 Parámetros del Servicio.


23



2.2.1.1 Parámetro de entrada El parámetro que recibe la operación es SolicitudMatricula el cual recoge los datos necesarios para realizar una consulta de un vehículo a partir de su matrícula. A su vez este parámetro se compone de los siguientes elementos: 

Matricula: matrícula del vehículo que se desea buscar. Debe ser válida.



DatosUsuario: recoge los datos relativos al usuario que realice la consulta, a su vez contiene el siguiente elemento:


24





IdUsuario: documento de identidad del usuario que podrá ser

2.2.1.2 Parámetro de salida La operación devolverá un parámetro Vehiculo que contiene la información del vehículo consultado.


25



2.2.1.3 Excepción En caso de que se produzca algún error en el proceso, el servicio web lanzará una excepción AtexFault la cual contendrá una descripción del error producido y el código asociado. En el anexo (ver 4.1 Errores) de este documento se detallan todos los errores que pueden ser lanzados por el servicio.


26



2.2.2Operación consultarBastidor Esta operación permite realizar la consulta de vehículos a partir de su bastidor: validará las peticiones recibidas, comprobará si el usuario está autorizado y tiene los permisos necesarios para la consulta de vehículos y en concreto por bastidor, validará los datos introducidos, accederá al RGV, la información recogida del registro será filtrada según el perfil del usuario y devolverá la respuesta.


27





28



2.2.2.1 Parámetro de entrada El parámetro que recibe la operación es SolicitudBastidor el cual recoge los datos necesarios para realizar una consulta de un vehículo a partir de su bastidor. A su vez este parámetro se compone de los siguientes elementos: 

Bastidor: bastidor del vehículo que se desea buscar. Debe un bastidor válido.





29





IdUsuario: documento de identidad del usuario.



30





31



2.2.3Operación consultarNive Esta operación permite realizar la consulta de vehículos a partir de su nive: validará las peticiones recibidas, comprobará si el usuario está autorizado y tiene los permisos necesarios para la consulta de vehículos y en concreto por nive, validará los datos introducidos, accederá al RGV, la información recogida del registro será filtrada según el perfil del usuario y devolverá la respuesta.


32





33



2.2.3.1 Parámetro de entrada El parámetro que recibe la operación es SolicitudNive el cual recoge los datos necesarios para realizar una consulta de un vehículo a partir de su nive. A su vez este parámetro se compone de los siguientes elementos: 

Nive: nive del vehículo que se desea buscar. Debe un nive válido.





34





IdUsuario: documento de identidad del usuario.



35





36



2.2.4Operación consultarPersonaPorDocumento Esta operación permite realizar la consulta de personas a partir de su documento de identificación: validará las peticiones recibidas, comprobará si el usuario está autorizado y tiene los permisos necesarios para la consulta de personas y en concreto por documento, validará los datos introducidos, accederá al RGP, la información recogida del registro será filtrada según el perfil del usuario y devolverá la respuesta.


37




2.2.4.1 Parámetro de entrada El parámetro de entrada de este método es solicitudDocumentoId el cual recoge los datos necesarios para realizar la consulta de personas. Los elementos de que consta son los siguientes:


38


-


DocumentoId: Número de documento de identificación de la persona a consultar, que puede ser un NIF, un CIF o un NIE.

-

DatosUsuario: recoge los datos relativos al usuario que realice la consulta. A su vez, contiene el siguiente elemento: o IdUsuario: documento de identificación del usuario que realiza la petición que a su vez tiene que coincidir con el documento que aparezca en el certificado usado para firmar la petición mediante el protocolo WS-Security.


39



2.2.4.2 Parámetro de salida La operación devolverá el parámetro persona, el cual contiene toda la información de la persona a la cual el usuario que realiza la petición tiene acceso en función de su perfil.

2.2.4.3 Excepción En caso de que se produzca algún error en el proceso, el servicio web lanzará una excepción AtexFault la cual contendrá una descripción del error producido y el código asociado. En el Manual Usuario WS (ATEX)

40



anexo (ver 4.1 Errores) de este documento se detallan todos los errores que pueden ser lanzados por el servicio.

2.2.5Operación consultarPersonaPorFiliacion Esta operación permite realizar la búsqueda de personas a partir de su filiación: validará las peticiones recibidas, comprobará si el usuario está autorizado y tiene los permisos necesarios Manual Usuario WS (ATEX)

41



para la consulta de personas y en concreto por filiación, validará los datos introducidos, accederá al RGP y devolverá la respuesta. A continuación se describen los parámetros de entrada, salida y de error de este método, pero las estructuras detalladas se pueden encontrar en el apartado 3 Parámetros del Servicio.


42



2.2.5.1 Parámetro de entrada El parámetro de entrada de este método es solicitudFiliacion, el cual recoge los datos necesarios para realizar la búsqueda de personas. Los elementos de que consta son los siguientes: -

PersonaJuridica: campo booleano que indica el tipo de filiación por la cual se quiere realizar la consulta. Si toma el valor “true” el tipo de filiación será jurídica, en caso de que tome el valor “false” el tipo de filiación será física.


43


-


SolicitudPersonaJuridica: datos necesarios para realizar la consulta por filiación de persona jurídica. o RazonSocial: Razón social a consultar. Sólo admite letras, no admite caracteres especiales ni numéricos.

-

SolicitudPersonaFisica: datos necesarios para realizar la consulta por filiación de persona física.


44



o PrimerApellido: primer apellido de la persona a buscar. Este campo es obligatorio para realizar la consulta. Así mismo, sólo se admiten letras. o SegundoApellido: segundo apellido. Este campo es opcional, por tanto no es necesario para realizar la consulta. Sólo admite letras. o Nombre: nombre de la persona a buscar. Este campo es opcional, por tanto no es necesario para realizar la consulta. Sólo admite letras.


45



o FechaNacimiento: fecha de nacimiento de la persona. Este campo es opcional, por tanto no es necesario para realizar la consulta. o AnyoNacimiento: año de nacimiento de la persona. Este campo es opcional, por tanto no es necesario para realizar la consulta. -



46



o IdUsuario: documento de identidad del usuario que realiza la petición que a su vez tiene que coincidir con el documento que aparezca en el certificado usado para firmar la petición mediante el protocolo WS-Security.


47



2.2.5.2 Parámetro de salida La operación devolverá el parámetro listaPersonas, con la lista de personas encontradas que se ajusten al criterio de búsqueda introducido. A continuación se describen los parámetros de entrada, salida y de error de este método, pero las estructuras detalladas se pueden encontrar en el apartado 3 Parámetros del Servicio. -

DatosFiliacion: recoge los datos de cada una de las personas. Se devolverán tantos como personas encontradas:


48



o Filiación: nombre y apellidos de la persona encontrada, en caso de ser persona física, por el contrario si es persona jurídica este campo devolverá la razón social. o DocumentoId: número de documento de identificación de la persona. o Fecha de nacimiento: fecha de nacimiento de la persona en caso de que sea una persona física.


49





50



2.3 Características técnicas del Servicio Web Entorno: Internet. Protocolo: HTTPs sin autenticación requerida con certificado cliente. Mensajes: Estándares utilizados para webservices: -

SOAP version 1.1.


51



-

WSDL version 1.1

-

Webservices for J2EE version 1.1

-

Java API for XML-Based RPC (JAX-RPC) version 1.1

Certificados admitidos: Se permitirán certificados emitidos por FNMT, DNI-e y DGT, siempre que sean de un tipo admitido por @Firma. La lista de certificados admitidos por la plataforma de


52



@Firma 5.0 se detallan en el documento “Declaracion_Practicas de Certificación”, para más información ver la URL siguiente http://www.csi.map.es/csi/pg5a12.htm#62. Firma: Formato de firma de solicitud de registro de entrada y justificantes de registro: XADES versión ETSI TS 101 903 v1.3.2. Infraestructura: se establecerá una conexión segura entre los servidores de la DGT y las plataformas llamantes.


53



Número de peticiones: El número de peticiones concurrentes será limitado y establecido por la DGT. Seguridad: se ha configurado la seguridad del Servidor Web mediante WS-Security. Las peticiones que recibirá el Web Service deberán estar firmadas mediante la especificación de WSSecurity mediante certificados del tipo x509.v3. Se deben utilizar los siguientes algoritmos: CanonicalizationMethod - http://www.w3.org/2001/10/xml-exc-c14n# SignatureMethod - http://www.w3.org/2000/09/xmldsig#rsa-sha1


54



Transform - http://www.w3.org/2001/10/xml-exc-c14n# DigestMethod - http://www.w3.org/2000/09/xmldsig#sha1


55



3 Parámetros del Servicio 3.1 SolicitudMatricula Manual Usuario WS (ATEX)

56



El parámetro SolicitudMatricula sirve de entrada a la operación consultarMatricula del Servicio Web de ATEX, de tal forma que permita a su usuario realizar la consulta de la información de un vehículo a partir de su matrícula. La estructura del parámetro se ha definido en el WSDL “Interfaz ATEX.wsdl” y cuyos elementos se detallan a continuación:


57



Nombre Etiqueta

Tipo

Descripción

1.1

String

Matrícula del vehículo que se quiere consultar.

1.2 1.2.1

String

Datos del usuario que realiza la consulta. Documento de identidad del usuario (CIF, NIF o NIE).

1

Tabla 1. SolicitudMatricula


58



3.2 SolicitudBastidor


59



El parámetro SolicitudBastidor sirve de entrada a la operación consultarBastidor del Servicio Web de ATEX, de tal forma que permita a su usuario realizar la consulta de la información de un vehículo a partir de su bastidor. La estructura del parámetro se ha definido en el WSDL “Interfaz ATEX.wsdl” y cuyos elementos se detallan a continuación:


60



Nombre Etiqueta

Tipo

Descripción

1.1

String

Bastidor del vehículo que se quiere consultar.

1.2 1.2.1

String


1

Tabla 2. SolicitudBastidor


61



3.3 SolicitudNive


62



El parámetro SolicitudNive sirve de entrada a la operación consultarNive del servicio web de ATEX, de tal forma que permita a su usuario realizar la consulta de la información de un vehículo a partir de su nive. La estructura del parámetro se ha definido en el WSDL “Interfaz ATEX.wsdl” y cuyos elementos se detallan a continuación:


63



Nombre Etiqueta

Tipo

Descripción

1.1

String

Nive del vehículo que se quiere consultar.

1.2 1.2.1

String


1

Tabla 3. SolicitudNive


64



3.4 Vehículo El parámetro de respuesta devuelto por las operaciones del WS consultarMatricula, consultarBastidor, consultarNive es Vehiculo, cuya estructura se define en el esquema XSD “Esquema Vehiculo WSDL ATEX.xsd” y cuyos elementos se describen a continuación:


65



Nombre Etiqueta

Multiplicidad

Descripción Elemento raíz, contiene todos la información relativa al vehículo que se ha consultado. Se compone de los siguientes elementos principales:

1.1

Opcional

Contiene los datos que identifican al vehículo.

1.2 1.3

Opcional Opcional

Engloba los datos del titular del vehículo. Datos de los cotitulares del vehículo.

1


66



Nombre Etiqueta 1.4 1.5

Multiplicidad Opcional Opcional

1.6

Opcional

1.7 1.8 1.9

Opcional Opcional Opcional


67

Descripción Domicilio del vehículo. Datos relativos a los duplicados de los permisos de circulación del vehículo. Contiene la información relativa a los poseedores que tenga el vehículo, entendiendo por poseedor el responsable de dicho vehículo cuando existe una cesión temporal del mismo. Engloba los datos referentes a las transferencias a otros titulares del vehículo. Datos relativos a las bajas que haya sufrido el vehículo. Contiene la información del ITV’s del vehículo.



Nombre Etiqueta

Multiplicidad

1.10

Opcional

1.11 1.12 1.13


1.14

Opcional

1.15 1.16

Opcional Opcional


68

Descripción Limitaciones de disposición del vehículo, como por ejemplo la exención del pago de un impuesto. Datos de los embargos que haya sufrido el vehículo. Información de los precintos que haya tenido el vehículo. Avisos o anotaciones que tenga el vehículo. Contiene los datos relativos a las denegatorias que tiene el vehículo, entendiendo por denegatoria… Datos referentes a los seguros del vehículo. Datos de los arrendatarios que haya tenido el vehículo.



Nombre Etiqueta 1.17 1.18 1.19

Multiplicidad Opcional Opcional Opcional

Descripción Datos de los tutores que haya tenido en los trámites el vehículo. Datos de los conductores habituales que haya tenido el vehículo. Engloba los datos referentes a si el titular del vehículo es autónomo.

Tabla 4. Vehículo

Todos estos elementos se detallan a continuación.


69



3.4.1Identificación Contiene los datos identificativos del vehículo. A continuación se describe su estructura y elementos:


70



Nombre Etiqueta

Tipo

Multiplicidad

1.1

Contiene los datos que identifican al vehículo.

1.1.1 1.1.1.1 1.1.1.1.1 1.1.1.1.2 1.1.1.2 1.1.1.3 1.1.1.4


Descripción

String String String Date

71

Opcional Opcional Opcional Opcional Opcional Opcional Opcional

Contiene los datos relativos a la matriculación. Clasificación del tipo de matrícula que lleva el vehículo. Código de la clase de matriculación. Designación de la clase de matriculación. Matrícula del vehículo. Fecha en que se matriculó el vehículo (con la matrícula anterior). Jefatura en la que se realizó la matriculación.



Nombre Etiqueta 1.1.1.4.1 1.1.1.4.2 1.1.1.5 1.1.1.5.1 1.1.1.5.2 1.1.2 1.1.2.1 1.1.2.2 1.1.2.3


Tipo String String String String String String String

72

Multiplicidad Opcional Opcional Opcional Opcional Opcional Opcional Opcional Opcional Opcional

Descripción Código de la jefatura. Designación de la jefatura. Sucursal en la que se realizó la matriculación. Código de la sucursal. Designación de la sucursal. Datos descriptivos del vehículo. Bastidor del vehículo. Nive del vehículo. Marca



Nombre Etiqueta 1.1.2.3.1 1.1.2.3.2 1.1.2.4 1.1.2.5 1.1.2.5.1 1.1.2.5.2 1.1.2.6 1.1.2.6.1 1.1.2.6.2



73


Descripción Código de la marca. Designación de la marca. Modelo Color Código del color. Designación del color. Procedencia Código de la procedencia. Designación de la procedencia.



Nombre Etiqueta 1.1.2.7 1.1.2.7.1 1.1.2.7.2 1.1.2.8 1.1.2.8.1 1.1.2.8.2 1.1.2.9 1.1.2.9.1 1.1.2.9.2


Tipo String String String String String String

74


Descripción Servicio al que está destinado a dar uso el vehículo Código del servicio. Designación del servicio. Tipo de vehículo. Código del tipo de vehículo. Designación del tipo de vehículo. Servicio complementario Código del tipo de vehículo. Designación del tipo de vehículo.



Nombre Etiqueta 1.1.2.10 1.1.2.10.1 1.1.2.10.2 1.1.3 1.1.3.1 1.1.3.1.1 1.1.3.1.2 1.1.3.2 1.1.3.3


Tipo String String

String String float float

75


Descripción Tipo definido por industria Código del tipo de vehículo. Designación del tipo de vehículo. Datos técnicos del vehículo. Tipo de combustible utilizado por el vehículo. Código de la propulsión. Designación de la propulsión. Cilindrada del vehículo en cm3. Potencia fiscal del vehículo en CF



Nombre Etiqueta 1.1.3.4 1.1.3.5 1.1.3.6 1.1.3.6.1

Tipo int int int

Multiplicidad Opcional Opcional Opcional Opcional

1.1.3.6.2

String

Opcional

1.1.3.7 1.1.3.8

String String

Opcional Opcional


76

Descripción Tara del vehículo en Kg. Peso máximo del vehículo en Kg. Número de plazas del vehículo. Número natural de plazas del vehículo. Número de plazas mixtas del vehículo, aparecen como un rango, por ejemplo, si el valor es 2-9 indica que el vehículo puede tener como mínimo 2 o como máximo 9. Código de ITV. Variante.



Nombre Etiqueta 1.1.3.9 1.1.3.10 1.1.3.11 1.1.3.12 1.1.3.13 1.1.3.14 1.1.3.15 1.1.4 1.1.4.1


Tipo String String Int Int float float int String

77


Descripción Versión. Número de Homologación. Masa máxima técnica en Kg. Masa en servicio en Kg. Potencia Neta máxima en Kw. Relación potencia peso. Número de plazas de pie. Matrícula que tenía el vehículo en el extranjero.



Nombre Etiqueta 1.1.4.2 1.1.4.3

Tipo Date

1.1.4.3.1

1a5

1.1.4.3.1.1 1.1.4.3.1.2 1.1.4.4 1.1.5 1.1.5.1



Date Date String

78

Opcional Opcional Opcional Opcional 1a∞

Descripción Fecha de la primera matriculación del vehículo. Lista de las fechas de prórroga del vehículo. Datos relativos a cada una de las fechas de prórroga (período de validez de la matrícula temporal asignada al vehículo). Fecha de inicio del período de validez de la matrícula temporal. Fecha de fin de dicho período. Anotación Lista de rematriculaciones del vehículo. Datos relativos a cada una de las rematriculaciones del vehículo.



Nombre Etiqueta 1.1.5.1.1 1.1.5.1.1.1 1.1.5.1.1.2 1.1.5.1.2 1.1.5.1.3 1.1.6 1.1.6.1

Tipo

Date

Multiplicidad Opcional Opcional Opcional Opcional Opcional Opcional Opcional

1.1.6.2

Date

Opcional


String String Date String

79

Descripción Razón de la rematriculación. Código de la razón. Descripción de la razón. Fecha en que se produjo la rematriculación. Anotación. Fechas de vigencia de características relativas al vehículo. Fecha en la que caduca la ITV vigente. Fecha de caducidad de la matrícula turística en caso de que sea un vehículo turístico.



Nombre Etiqueta 1.1.7

Tipo

Multiplicidad Opcional

1.1.7.1

String

Opcional

1.1.7.2 1.1.7.3

String String

Opcional Opcional

1.1.7.4

String

Opcional

1.1.7.5

String

Opcional


80

Descripción Indicadores del vehículo. Si el valor de este campo es una S el titular del vehículo está bajo tutela, cualquier otro valor indicará lo contrario. Código de la situación del poseedor del vehículo. Código de la limitación de disposición. Si el valor de este campo es una S, el vehículo ha sido sustraído, cualquier otro valor indicará lo contrario. Si el valor de este campo es una S, el vehículo tiene exceso de peso y/o dimensiones, cualquier otro valor indicará lo contrario.



Nombre Etiqueta 1.1.7.6 1.1.7.7 1.1.7.8

Tipo String boolean boolean


Descripción Código de la procedencia del vehículo. Indica si el vehículo tiene bloqueado el cambio de titularidad. Indica si el vehículo matriculado se destina al Renting.

Tabla 5. Identificación


81



3.4.2Titular Nombre Etiqueta

Tipo

Multiplicidad

1.2

Datos del titular del vehículo. 1a∞

1.2.1


Descripción

82

Contiene los datos personales del titular.


Nombre Etiqueta


Tipo

1.2.1.1 1.2.1.1.1 1.2.1.1.2


String String

1.2.1.2


1.2.1.2.1

String

Opcional

1.2.1.2.2

String

Opcional


83

Descripción Contiene la información del titular en caso de que éste sea una persona jurídica, por tanto sólo se devolverán si se cumple esta condición. Cif del titular, en este caso persona jurídica. Razón Social del titular, en este caso persona jurídica. Contiene la información del titular en caso de que éste sea una persona física, por tanto sólo se devolverán si se cumple esta condición. Documento de Identidad del titular, en este caso persona física. El documento de identidad podrá ser el correspondiente a un NIF o a un NIE. Primer apellido del titular.


Nombre Etiqueta 1.2.1.2.3 1.2.1.2.4 1.2.1.2.5 1.2.1.2.6 1.2.2 1.2.2.1 1.2.2.2 1.2.2.3 1.2.2.4



Tipo String String String Date String String String

84


Descripción Segundo apellido del titular. Nombre del titular. Sexo del titular. Fecha de nacimiento del titular. Información del domicilio del titular. Dirección del titular. Pueblo. Municipio. Provincia.


Nombre Etiqueta 1.2.2.4.1 1.2.2.4.2 1.2.2.5


Tipo String String String


Descripción Código de la provincia. Descripción de la provincia. Código postal.

Tabla 6. Titular


85



3.4.3Cotitulares Nombre Etiqueta 1.3 1.3.1 1.3.1.1

Tipo

Multiplicidad

String

1a∞ Opcional

Descripción Datos del titular del vehículo. Contiene los datos personales del titular. Documento de Identidad del cotitular, podrá ser CIF, NIF o NIE.

Tabla 7. Cotitulares


86



3.4.4DomicilioVehiculo Nombre Etiqueta 1.4 1.4.1


Tipo

Multiplicidad

String

Opcional

87

Descripción Domicilio del vehículo. Dirección del vehículo


Nombre Etiqueta 1.4.2 1.4.3 1.4.4 1.4.4.1 1.4.4.2 1.4.5


Tipo String String String String String

Multiplicidad Opcional Opcional Opcional Opcional Opcional Opcional

Descripción Pueblo. Municipio. Provincia. Código de la provincia. Descripción de la provincia. Código postal.

Tabla 8. DomicilioVehiculo


88



3.4.5Duplicados Nombre Etiqueta 1.5

Tipo

Multiplicidad

1.5.1

1a∞

1.5.1.1

Opcional


89

Descripción Lista de duplicados del permiso de conducción del vehículo. Contiene los datos relativos a cada duplicado del permiso de circulación del vehículo. Razón por la cual se expidió el duplicado del permiso de circulación del vehículo.


Nombre Etiqueta 1.5.1.1.1 1.5.1.1.2 1.5.1.2 1.5.1.3 1.5.1.3.1 1.5.1.3.2 1.5.1.4 1.5.1.4.1 1.5.1.4.2



Tipo String String Date String String String String

90


Descripción Código de la razón. Descripción de la razón. Fecha en la que se expidió. Jefatura en la que se hizo. Código de la Jefatura. Designación de la Jefatura. Sucursal en la que se hizo. Código de la sucursal. Designación de la sucursal.



Tabla 9. Duplicados

3.4.6Poseedores Nombre Etiqueta 1.6


Tipo

91

Multiplicidad

Descripción Lista de poseedores del vehículo.


Nombre Etiqueta 1.6.1 1.6.1.1 1.6.1.1.1 1.6.1.1.2 1.6.1.2 1.6.1.3 1.6.1.3.1 1.6.1.3.2 1.6.1.4



Tipo

String String Date String String

92

Multiplicidad 1a∞ Opcional Opcional Opcional Opcional Opcional Opcional Opcional Opcional

Descripción Contiene los datos relativos a cada uno de los poseedores del vehículo. Código de la situación. Designación de la situación. Fecha Jefatura. Código de la Jefatura. Descripción de la Jefatura. Sucursal


Nombre Etiqueta 1.6.1.4.1 1.6.1.4.2 1.6.1.5 1.6.1.6 1.6.1.7 1.6.1.7.1 1.6.1.7.2 1.6.1.7.3 1.6.1.7.4




93


Descripción Código de la sucursal. Descripción de la sucursal. Nombre y apellidos del poseedor. Documento de Identidad del poseedor: CIF, NIF o NIE. Datos del domicilio del poseedor. Dirección del poseedor. Pueblo del poseedor. Municipio del poseedor. Provincia del poseedor.


Nombre Etiqueta 1.6.1.7.4.1 1.6.1.7.4.2 1.6.1.7.5 1.6.1.8


Tipo String String String String


Descripción Código de la provincia. Descripción de la provincia. Código postal del poseedor. Anotación

Tabla 10. Poseedores


94



3.4.7Transferencias Nombre Etiqueta 1.7 1.7.1 1.7.1.1 1.7.1.2 1.7.1.2.1


Tipo

Date String

95

Multiplicidad 1a∞ Opcional Opcional Opcional

Descripción Lista de transferencias que ha sufrido el vehículo Datos relativos a cada una de las transferencias que ha sufrido el vehículo. Fecha en la que se realizó Jefatura. Código de la Jefatura.



Nombre Etiqueta 1.7.1.2.2 1.7.1.3 1.7.1.3.1 1.7.1.3.2



1.7.1.4

String

Opcional

Descripción Designación de la Jefatura. Sucursal. Código de la Sucursal. Designación de la Sucursal. Documento de identidad del titular anterior del vehículo, éste puede ser CIF, NIF o NIE.

Tabla 11. Transferencias


96



3.4.8Bajas Nombre Etiqueta 1.8 1.8.1 1.8.1.1 1.8.1.1.1 1.8.1.1.2


Tipo

Multiplicidad

String String

1a∞ Opcional Opcional Opcional

97

Descripción Lista de bajas que ha sufrido el vehículo Datos relativos a cada una de las bajas que ha sufrido el vehículo. Tipo de baja. Código del tipo de baja. Descripción del tipo de baja.


Nombre Etiqueta 1.8.1.2 1.8.1.3 1.8.1.4 1.8.1.4.1 1.8.1.4.2 1.8.1.5 1.8.1.5.1 1.8.1.5.2 1.8.1.6



Tipo Date Date String String String String

98


Descripción Fecha de comienzo de la baja del vehículo. Fecha de fin del período de baja del vehículo en caso de que no sea una baja definitiva. Jefatura. Código de la Jefatura. Designación de la Jefatura. Sucursal. Código de la Sucursal. Designación de la Sucursal. Motivo de la baja.


Nombre Etiqueta 1.8.1.6.1 1.8.1.6.2


Tipo String String


Descripción Código de la causa. Designación de la causa.

Tabla 12. Bajas


99



3.4.9Itvs Nombre Etiqueta 1.9 1.9.1 1.9.1.1 1.9.1.2 1.9.1.3


Tipo

Multiplicidad

Date Date String


100

Descripción Lista de Itvs que ha pasado el vehículo Datos relativos a cada una de las itvs que ha pasado el vehículo. Fecha de la última ITV Fecha de caducidad Estación en donde se pasó.


Nombre Etiqueta 1.9.1.4 1.9.1.4.1 1.9.1.4.2 1.9.1.5 1.9.1.5.1 1.9.1.5.2 1.9.1.6 1.9.1.6.1 1.9.1.6.2




101


Descripción Provincia en donde se encuentra la Estación en donde se pasó la ITV. Código de la provincia. Designación de la provincia. Motivo por el cual se pasa la ITV. Código del motivo. Designación del motivo. Resultado de la ITV. Código del resultado. Designación del resultado.


Nombre Etiqueta 1.9.1.7 1.9.1.8 1.9.1.9 1.9.1.10 1.9.1.11 1.9.1.11.1 1.9.1.11.1.1 1.9.1.11.1.1.1 1.9.1.11.1.1.2



Tipo String Date int int

String String

102

Multiplicidad Opcional Opcional Opcional Opcional Opcional 1a∞ Opcional Opcional Opcional

Descripción Anotación. Fecha de caducidad de la ITV anterior. Kilometraje. Cuenta horas. Lista de defectos encontrados en el vehículo. Información asociada a cada uno de los defectos. Tipo de defecto. Código del tipo de defecto. Designación del tipo de defecto.


Nombre Etiqueta 1.9.1.11.1.2 1.9.1.11.1.2.1 1.9.1.11.1.2.2


Tipo String String


Descripción Gravedad del defecto. Código de la gravedad. Designación de la gravedad.

Tabla 13. Itvs


103



3.4.10 Limitaciones Nombre Etiqueta 1.10 1.10.1 1.10.1.1 1.10.1.1.1 1.10.1.1.2


Tipo

Multiplicidad

String String


104

Descripción Lista de Limitaciones de Disposición que tiene el vehículo. Datos relativos a cada una de las Limitaciones de Disposición del vehículo. Tipo de Limitación Código del tipo de limitación. Designación del tipo de limitación.


Nombre Etiqueta 1.10.1.2 1.10.1.3 1.10.1.4 1.10.1.5


Tipo String Date String String


Descripción Número de Registro exterior a la DGT. Fecha de la Limitación Información relativa a la entidad gestora externa a la DGT. Anotación.

Tabla 14. Limitaciones


105



3.4.11 Embargos Nombre Etiqueta 1.11 1.11.1 1.11.1.1 1.11.1.2 1.11.1.3


Tipo

Multiplicidad

String Date Date


106

Descripción Lista de los Embargos que tiene el vehículo. Datos relativos a cada uno de los Embargos del vehículo. Número de expediente correspondiente al trámite. Fecha de comienzo del trámite. Fecha en la que se efectuó el embargo.


Nombre Etiqueta 1.11.1.4 1.11.1.4.1 1.11.1.4.2


Tipo String String


Descripción Autoridad que llevó a cabo el embargo. Código de la autoridad. Designación de la autoridad.

Tabla 15. Embargos


107



3.4.12 Precintos Nombre Etiqueta 1.12 1.12.1 1.12.1.1 1.12.1.2 1.12.1.3


Tipo

Multiplicidad

String Date Date


108

Descripción Lista de los Precintos que se han efectuado al vehículo. Datos relativos a cada uno de los Precintos del vehículo. Número de expediente correspondiente al trámite. Fecha de comienzo del trámite. Fecha en la que se ejecutó el precinto.


Nombre Etiqueta 1.12.1.4 1.12.1.4.1 1.12.1.4.2


Tipo String String


Descripción Autoridad que llevó a cabo el precinto. Código de la autoridad. Designación de la autoridad.

Tabla 16. Precintos


109



3.4.13 Avisos Nombre Etiqueta 1.13 1.13.1 1.13.1.1 1.13.1.1.1 1.13.1.1.2


Tipo

Multiplicidad

String String


110

Descripción Lista de los Avisos que tiene el vehículo. Datos relativos a cada uno de los Avisos del vehículo. Jefatura que hizo la anotación del aviso. Código de la Jefatura Designación de la Jefatura


Nombre Etiqueta 1.13.1.2 1.13.1.2.1 1.13.1.2.2 1.13.1.3




Descripción Sucursal que hizo la anotación del aviso. Código de la Sucursal Designación de la Sucursal Anotación del aviso.

Tabla 17. Avisos


111



3.4.14 Denegatorias Nombre Etiqueta 1.14 1.14.1 1.14.1.1 1.14.1.1.1 1.14.1.1.2


Tipo

Multiplicidad

String String


112

Descripción Lista de Denegatorias que tiene el vehículo. Datos relativos a cada uno de las Denegatorias del vehículo. Jefatura que hizo la anotación de la denegatoria. Código de la Jefatura Designación de la Jefatura


Nombre Etiqueta 1.14.1.2 1.14.1.2.1 1.14.1.2.2 1.14.1.3




Descripción Sucursal que hizo la anotación de la denegatoria Código de la Sucursal Designación de la Sucursal Anotación

Tabla 18. Denegatorias


113



3.4.15 Seguros Nombre Etiqueta 1.15 1.15.1 1.15.1.1 1.15.1.1.1 1.15.1.1.2


Tipo

Multiplicidad

String String


114

Descripción Lista de Seguros del vehículo Datos relativos a cada uno de los Seguros del vehículo. Tipo de seguro. Código del tipo de seguro Descripción del tipo de seguro


Nombre Etiqueta 1.15.1.2 1.15.1.3 1.15.1.4 1.15.1.4.1 1.15.1.4.2


Tipo Date Date String String

Multiplicidad Opcional Opcional Opcional Opcional Opcional

Descripción Fecha de inicio del seguro. Fecha de fin del seguro. Entidad aseguradora. Código de la entidad. Descripción de la entidad.

Tabla 19. Seguros


115



3.4.16 Arrendatarios Nombre Etiqueta 1.16 1.16.1 1.16.1.1 1.16.1.2 1.16.1.3


Tipo

Multiplicidad

String Date Date


116

Descripción Lista de arrendatarios del vehículo Datos relativos a cada uno de los arrendatarios del vehículo. Documento de Identidad del arrendatario: CIF, NIF o NIE. Fecha de inicio del arrendamiento. Fecha de fin del arrendamiento.



Tabla 20. Arrendatarios

3.4.17 Tutores Nombre Etiqueta 1.17


Tipo

117

Multiplicidad

Descripción Lista de tutores del vehículo


Nombre Etiqueta 1.17.1 1.17.1.1 1.17.1.2 1.17.1.3


Tipo String String Date

Multiplicidad 1a∞ Opcional Opcional Opcional

Descripción Datos relativos a cada uno de los tutores del vehículo. Documento de Identidad del tutor: CIF, NIF o NIE. Trámite en el que fue tutor. Fecha del trámite del tutor.

Tabla 21. Tutores


118



3.4.18 Conductores habituales Nombre Etiqueta 1.18 1.18.1 1.18.1.1 1.18.1.2


Tipo

Multiplicidad

Descripción Lista de conductores habituales del vehículo

String Date

119

1a∞ Opcional Opcional

Datos relativos a cada uno de los conductores habituales del vehículo. Documento de Identidad del conductor habitual: CIF, NIF o NIE. Fecha de inicio de conductor habitual.


Nombre Etiqueta 1.18.1.3


Tipo Date


Descripción Fecha de fin del conductor habitual.

Tabla 22. Conductores habituales


120



3.4.19 Servicio autónomo Nombre Etiqueta 1.19 1.19.1 1.19.1

Tipo

Multiplicidad

boolean String

Opcional Opcional

Descripción Indicador del servicio del vehículo Indica si el titular del vehículo es autónomo o no. En el caso de que el titular sea un autónomo será obligatorio indicar el código oficial de actividad económica.

Tabla 23. Servicio autónomo Manual Usuario WS (ATEX)

121




122



3.5 solicitudDocumentoId


123



El parámetro solicitudDocumentoId sirve de entrada a la operación consultarPersonaPorDocumento del Servicio Web de ATEX, de tal forma que permita a su usuario realizar la búsqueda de personas a partir de su filiación. La estructura del parámetro se ha definido en el WSDL “Interfaz ATEX.wsdl”, cuyos elementos se detallan a continuación:


124



Nombre Etiqueta

Tipo

1

Descripción Datos relativos a la consulta por documento de identificación.

1.1

String

1.2 1.2.1

String

Número de documento de identificación de la persona consultada, podrá ser un NIF, un CIF o un NIE. Datos del usuario que realiza la consulta. Documento de identificación del usuario que realiza la consulta (NIF, CIF o NIE).

Tabla 24. SolicitudDocumentoId


125



3.6 SolicitudFiliacion


126



El parámetro SolicitudFiliacion sirve de entrada a la operación consultarPersonaPorFiliacion del Servicio Web de ATEX, de tal forma que permita a su usuario realizar la búsqueda de personas a partir de su filiación. La estructura del parámetro se ha definido en el WSDL “Interfaz ATEX.wsdl”, cuyos elementos se detallan a continuación:


127


Nombre Etiqueta


Tipo

Multiplicidad/ Requerido

1 1.1

Datos que contiene una solicitud de consulta por filiación.


Este campo booleano indica si la consulta a realizar es de persona jurídica o física. Tomará el valor “true” para jurídica y “false” para física.

Boolean Opcional

1.2 1.2.1 1.3

Descripción

String

128

Datos necesarios para realizar una consulta cuando la filiación es de persona jurídica. Razón social de la persona a buscar. Datos necesarios para realizar una consulta cuando la filiación es de persona física.




Descripción

String

Opcional

String

Opcional

Primer apellido de la persona consultada. Este campo es obligatorio en caso de que se haya elegido la consulta por filiación física. Segundo apellido de la persona consultada, este campo es opcional, es decir, no es necesario introducirlo para realizar la búsqueda. Nombre de la persona consultada, este campo es opcional, es decir, no es necesario introducirlo para realizar la búsqueda.

Nombre Etiqueta

Tipo

1.3.1

String

1.3.2 1.3.3


129



Nombre Etiqueta

Tipo


1.3.4

Date

Opcional

1.3.5

int

Opcional

1.4 1.4.1

String

Descripción Fecha de nacimiento de la persona consultada, este campo es opcional, es decir, no es necesario introducirlo para realizar la búsqueda. El formato admitido es AAAA-MMDD. Año de nacimiento de la persona consultada, este campo es opcional, es decir, no es necesario introducirlo para realizar la búsqueda. Datos del usuario que realiza la consulta. Documento de identificación del usuario que realiza la consulta (CIF, NIF o NIE).

Tabla 25. SolicitudFiliacion Manual Usuario WS (ATEX)

130




131



3.7 Persona


132



Es el parámetro de respuesta devuelto por la operación consultarPersonaPorDocumento el cual contiene toda la información relativa a la persona consultada. Su estructura se define en el esquema XSD “Esquema Persona WSDL ATEX.xsd,” y sus elementos se describen a continuación:


133




Nombre Etiqueta

Descripción

1

Elemento raíz, contiene toda la información de la persona consultada. Se compone de los siguientes elementos principales:

1.1

Contiene los datos de identificación de la persona.

1.2 1.3

Opcional

1.4

Opcional


134

Domicilio de la persona. Indicadores de la persona consultada. Lista de los exámenes que ha realizado la persona para la obtención de un permiso de conducción.



Multiplicidad/ Requerido Opcional Opcional Opcional Opcional Opcional

Nombre Etiqueta 1.5 1.6 1.7 1.8 1.9

Descripción Engloba los datos referentes a las incidencias de la persona. Datos relativos a los trámites de la persona. Lista de permisos de conducción en vigor y sus datos. Lista de sanciones de la persona y los datos de cada una de ellas. Lista de los vehículos de los cuales la persona consultada es titular.

Tabla 26. Persona


135



Todos estos elementos se detallan a continuación.


136



3.7.1IdentificacionPersona Contiene los datos de identificación de la persona. A continuación se describe su estructura y elementos:


137



Nombre Etiqueta

Tipo


1.1

Contiene los datos que identifican a la persona consultada.

1.1.1

Opcional

1.1.1.1 1.1.1.2

String String

1.1.2


Descripción


138

Contiene los datos relativos a la persona en caso de que ésta sea jurídica, en caso contrario, este campo no será devuelto por el ws. CIF de la persona jurídica. Razón social de la persona jurídica. Contiene los datos relativos a la persona en caso de que ésta sea física, en caso contrario, este campo no será devuelto por el ws.



Nombre Etiqueta

Tipo


1.1.2.1

String

Opcional

1.1.2.2 1.1.2.3 1.1.2.4 1.1.2.5 1.1.2.6

String String String String Date

Opcional Opcional Opcional Opcional Opcional

Descripción Número de documento de identificación de la persona, podrá ser un NIF o un NIE. Primer apellido. Segundo apellido. Nombre. Sexo de la persona. Fecha de nacimiento.

Tabla 27. IdentificacionPersona Manual Usuario WS (ATEX)

139



3.7.2DomicilioPersona


140


Nombre Etiqueta


Tipo


1.2 1.2.1 1.2.2 1.2.3 1.2.4 1.2.4.1 1.2.4.2


Descripción Datos del domicilio de la persona consultada.

String String String String String

141

Opcional Opcional Opcional Opcional Opcional Opcional

Calle y número del domicilio de la persona. Pueblo. Municipio. Provincia. Código de la provincia. Descripción de la provincia.



Nombre Etiqueta

Tipo

1.2.5

String

Multiplicidad/ Requerido Opcional

Descripción Código postal.

Tabla 28. DomicilioPersona


142



3.7.3Indicadores


143


Nombre Etiqueta 1.3 1.3.1 1.3.2 1.3.3 1.3.3.1 1.3.3.2 1.3.4



Tipo


Boolean Boolean

Opcional Opcional Opcional Opcional Opcional

String String Boolean

144

Opcional

Descripción Indicadores de la persona. Campo que indica si la persona necesita llevar lentes para conducir. Documento de identificación del cotitular, podrá ser NIF, CIF o NIE. Este campo indica el cargo de autoescuela que ocupa la persona consultada. Código del cargo. Descripción de este cargo: profesor, director o ambos. Este campo indica si la persona está autorizada y tiene el permiso necesario para la conducción de transporte escolar.





Tipo Boolean

145


Descripción

Opcional

Este campo indica si la persona está autorizada y tiene el permiso necesario para la conducción de transporte de mercancías peligrosas.



Tabla 29. Indicadores

3.7.4Examenes


146


Nombre Etiqueta


Tipo


1.4 1.4.1 1.4.1.1 1.4.1.1.1 1.4.1.1.2 1.4.1.2 1.4.1.3


String String Date

147

1a∞ Opcional Opcional Opcional Opcional Opcional

Descripción Lista de exámenes que la persona ha realizado para la obtención de un permiso de conducción. Datos de cada uno de los exámenes realizados. Tipo de permiso para el cual se realiza el examen. Código del tipo de permiso. Descripción del tipo de permiso. Fecha de solicitud del derecho a examen. Jefatura en la que se realiza el examen.


Nombre Etiqueta 1.4.1.3.1 1.4.1.3.2 1.4.1.4 1.4.1.4.1 1.4.1.4.2 1.4.1.5 1.4.1.6 1.4.1.7




148

Multiplicidad/ Requerido Opcional Opcional Opcional Opcional Opcional Opcional Opcional Opcional

Descripción Código de la jefatura. Descripción de la jefatura. Sucursal de la Jefatura en la que se realiza el examen. Código de la Sucursal. Descripción de la Sucursal. Autoescuela con la que realiza el examen. Centro en el que se realizan las pruebas médicas. Situación en que se encuentra la persona respecto a las pruebas médicas.


Nombre Etiqueta


Tipo


1.4.1.8

Opcional

1.4.1.8.1 1.4.1.8.1.1 1.4.1.8.1.1.1 1.4.1.8.1.1.2 1.4.1.8.1.2 1.4.1.8.1.3

1a∞ Opcional Opcional Opcional Opcional Opcional


String String Date

149

Descripción Lista de resultados obtenidos en las pruebas de que consta el examen del permiso de conducción. Datos relativos a cada uno de los resultados obtenidos. Tipo de examen. Código del tipo de examen. Descripción del tipo de examen. Fecha de realización del examen Calificación obtenida.


Nombre Etiqueta 1.4.1.8.1.3.1 1.4.1.8.1.3.2


Tipo String String

Multiplicidad/ Requerido Opcional Opcional

Descripción Código de la calificación. Descripción de la calificación.

Tabla 30. Examenes


150



3.7.5Incidencias Nombre Etiqueta 1.5 1.5.1 1.5.1.1 1.5.1.1.1


Tipo

String

151

Multiplicidad/ Requerido 1a∞ Opcional Opcional

Descripción Lista de incidencias de la persona consultada. Contiene los datos relativos a cada una de las incidencias. Tipo de incidencia. Código de la incidencia.


Nombre Etiqueta 1.5.1.1.2 1.5.1.2 1.5.1.3 1.5.1.3.1 1.5.1.3.2 1.5.1.4 1.5.1.4.1 1.5.1.4.2




152

Multiplicidad/ Requerido Opcional Opcional Opcional Opcional Opcional Opcional Opcional Opcional

Descripción Descripción de la incidencia. Documento de identificación de la persona. Jefatura en la que se hizo la anotación de la incidencia. Código de la Jefatura. Designación de la Jefatura. Sucursal de la jefatura. Código de la sucursal. Designación de la sucursal.


Nombre Etiqueta 1.5.1.5 1.5.1.6


Tipo Date String


Descripción Fecha de la incidencia. Anotación

Tabla 31. Incidencias


153



3.7.6Tramites 3.7.6.1 Expediciones Nombre Etiqueta

Tipo

1.6.1



Descripción Lista de expediciones de permisos de conducción

154


Nombre Etiqueta 1.6.1.1 1.6.1.1.1 1.6.1.1.1.1 1.6.1.1.1.2 1.6.1.1.2 1.6.1.1.3 1.6.1.1.3.1 1.6.1.1.3.2



Tipo

String String Date String String

155

Multiplicidad/ Requerido 1a∞ Opcional Opcional Opcional Opcional Opcional Opcional Opcional

Descripción Contiene los datos relativos a cada una de las expediciones realizadas. Tipo de permiso expedido. Código del tipo de permiso. Designación del tipo de permiso. Fecha de la expedición. Jefatura en la que se expidió. Código de la Jefatura. Descripción de la Jefatura.


Nombre Etiqueta 1.6.1.1.4 1.6.1.1.4.1 1.6.1.1.4.2 1.6.1.1.5 1.6.1.1.5.1 1.6.1.1.5.2 1.6.1.1.6




156

Multiplicidad/ Requerido Opcional Opcional Opcional Opcional Opcional Opcional Opcional

Descripción Sucursal de la jefatura. Código de la sucursal. Descripción de la sucursal. Origen de la expedición. Código del origen de la expedición. Descripción del origen de la expedición. Indicador de trámite especial.


Nombre Etiqueta 1.6.1.1.7 1.6.1.1.8


Tipo String

Multiplicidad/ Requerido Opcional

String

Opcional

Descripción CIF del centro médico, en caso de ser necesario, en que se realizaron las pruebas médicas. Conjunto de códigos específicos de la DGT.

Tabla 32. Expediciones


157



3.7.6.2 Prorrogas


158


Nombre Etiqueta 1.6.2 1.6.2.1 1.6.2.1.1 1.6.2.1.1.1 1.6.2.1.1.2 1.6.2.1.2 1.6.2.1.3 1.6.2.1.3.1



Tipo


159

Multiplicidad/ Requerido 1a∞ Opcional Opcional Opcional Opcional Opcional Opcional

Descripción Lista de prórrogas de permisos de conducción. Contiene los datos relativos a cada una de las prórrogas. Tipo de permiso prorrogado. Código del tipo de permiso. Designación del tipo de permiso. Fecha de la prórroga. Jefatura en la que se expidió. Código de la Jefatura.


Nombre Etiqueta 1.6.2.1.3.2 1.6.2.1.4 1.6.2.1.4.1 1.6.2.1.4.2 1.6.1.1.5 1.6.1.1.5.1 1.6.1.1.5.2




160


Descripción Descripción de la Jefatura. Sucursal de la jefatura. Código de la sucursal. Descripción de la sucursal. Origen de la expedición. Código del origen de la expedición. Descripción del origen de la expedición.


Nombre Etiqueta 1.6.2.1.5 1.6.2.1.6 1.6.2.1.7


Tipo String String


String

Opcional

Descripción Indicador de trámite especial. CIF del centro médico, en caso de ser necesario, en que se realizaron las pruebas médicas. Conjunto de códigos específicos de la DGT.

Tabla 33. Prórrogas


161



3.7.6.3 Duplicados


162


Nombre Etiqueta 1.6.3 1.6.3.1 1.6.3.1.1 1.6.3.1.1.1 1.6.3.1.1.2 1.6.3.1.2 1.6.3.1.3 1.6.3.1.3.1



Tipo


163


Descripción Lista de duplicados de permisos de conducción. Contiene los datos relativos a cada una de los duplicados. Tipo de permiso duplicado. Código del tipo de permiso. Designación del tipo de permiso. Fecha en que se realiza el duplicado. Jefatura en la que se expidió. Código de la Jefatura.


Nombre Etiqueta 1.6.3.1.3.2 1.6.3.1.4 1.6.3.1.4.1 1.6.3.1.4.2 1.6.1.1.5 1.6.1.1.5.1 1.6.1.1.5.2




164


Descripción Descripción de la Jefatura. Sucursal de la jefatura. Código de la sucursal. Descripción de la sucursal. Origen de la expedición. Código del origen de la expedición. Descripción del origen de la expedición.


Nombre Etiqueta 1.6.3.1.5 1.6.3.1.6 1.6.3.1.7


Tipo String String


String

Opcional

Descripción Indicador de trámite especial. CIF del centro médico, en caso de ser necesario, en que se realizaron las pruebas médicas. Conjunto de códigos específicos de la DGT.

Tabla 34. Duplicados


165



3.7.7Permisos


166


Nombre Etiqueta 1.8 1.8.1 1.8.1.1 1.8.1.2 1.8.1.3 1.8.1.3.1 1.8.1.3.2



Tipo

Date Date String String

167

Multiplicidad/ Requerido 1a∞ Opcional Opcional Opcional Opcional Opcional

Descripción Lista de permisos en vigor de la persona consultada. Datos relativos a cada uno de los permisos. Fecha de comienzo de validez del permiso. Fecha de fin de validez del permiso. Tipo de permiso. Código del permiso. Designación del permiso.



Tabla 35. Permisos


168



3.7.8Sanciones


169


Nombre Etiqueta 1.9 1.9.1 1.9.1.1 1.9.1.1.1 1.9.1.1.2 1.9.1.2 1.9.1.3 1.9.1.4



Tipo

String String String String Date Date

170


Descripción Lista de sanciones que tiene la persona Datos relativos a cada una de las sanciones. Autoridad que impuso la sanción. Código de la autoridad. Designación de la autoridad. Número de expediente de la sanción. Fecha de la sanción. Fecha en la que finaliza la sanción.


Nombre Etiqueta 1.9.1.5 1.9.1.5.1 1.9.1.5.2 1.9.1.6 1.9.1.7 1.9.1.8




171

Multiplicidad/ Requerido Opcional Opcional Opcional Opcional Opcional Opcional

Descripción Tipo de sanción. Código de la sanción. Designación de la sanción. Duración de la sanción. Motivo de la sanción. Anotación relativa a la sanción.



Tabla 36. Sanciones


172



3.7.9 Matriculas Nombre Etiqueta 1.10 1.10.1 1.10.1.1


Tipo

String

173

Multiplicidad/ Requerido 1a∞ Opcional

Descripción Lista de vehículos de los cuales es titular la persona consultada. Matrícula del vehículo. Número de matrícula.



Tabla 37. Matriculas


174



3.8 ListaPersonas


175



El elemento ListaPersonas es el parámetro devuelto por la operación consultarPersonaPorFiliacion como resultado de la búsqueda realizada mediante filiación. Su estructura se define en el esquema XSD “Esquema Persona WSDL ATEX.xsd”.


176


Nombre Etiqueta


Tipo


Descripción

0a

Lista de personas encontradas según la filiación introducida para su búsqueda. Datos de cada una de las personas encontradas. Nombre y apellidos o razón social de la persona. Documento de identificación de la persona.

1 1.1 1.1.1 1.1.2


String String

177




Tipo Date


Descripción Fecha de nacimiento de la persona, en caso de que sea una persona física.

Tabla 38. ListaPersonas


178



3.9 AtexFault


179



En caso de que se produzca algún error en el proceso, el servicio web lanzará una excepción AtexFault la cual contendrá una descripción del error producido y el código asociado. La estructura de este parámetro se ha definido en el esquema XSD “Esquema Vehiculo WSDL ATEX.xsd”, cuyos elementos se detallan a continuación:


180



Nombre Etiqueta 1 1.1 1.2

Tipo String String

Descripción Recoge la excepción lanzada por el servicio web. Código del error producido. Mensaje descriptivo del error.

Tabla 39. AtexFault

En el anexo de este documento se detallan todos los errores que pueden ser lanzados por el servicio.


181



4 Anexos 4.1 Errores


182



A continuación se indican cada uno de las excepciones que puede lanzar el servicio web y la acción a tomar: CODIGO ERROR ATEX00101

MENSAJE DE ERROR

EXPLICACIÓN ERROR La sesión ha caducado debido a inactividad, por favor reanude el proceso.

La sesión ha caducado.


183



ATEX00200

Error Técnico

Se ha producido un error técnico, por favor, inténtelo más tarde o póngase en contacto con el CAU

ATEX00201

Certificado no válido

El certificado digital usado no es válido.


184



ATEX00202 Identificador de usuario no válido.

El identificador del usuario introducido no es válido.

ATEX00300

Se ha producido un error técnico, por favor, inténtelo más tarde o póngase en contacto con el CAU.

Error Técnico.

Se ha producido un error asociado al perfil del usuario, por favor, póngase en contacto con el CAU.

ATEX00301 Error en el perfil de usuario


185



ATEX00302

Usuario no autorizado.

No está autorizado para acceder a la aplicación.

ATEX00400

Error Técnico.


ATEX00401

Error en el perfil de usuario.



186


ATEX00402



Error en el perfil de usuario.

ATEX00500 Matrícula incorrecta.

La matrícula introducida no es correcta.

ATEX00501 Bastidor incorrecto.

El bastidor introducido no es correcto.


187


ATEX00502


El documento de identificación es incorrecto.

ATEX00503 Por favor, seleccione Tipo de filiación.


188

El número de documento introducido no es correcto.

Falta el tipo de filiación por la que se va a buscar, por favor, introdúzcala.



ATEX00504 La razón social es incorrecta.

La razón social introducida no es correcta.

ATEX00505 El primer apellido es incorrecto.

El primer apellido que ha introducido es incorrecto.


189



ATEX00506 El segundo apellido es incorrecto.

El segundo apellido que ha introducido es incorrecto.

ATEX00507 El nombre es incorrecto.

El nombre que ha introducido es incorrecto.


190



ATEX00508 Fecha de nacimiento incorrecta.

La fecha de nacimiento que ha introducido es incorrecta.

ATEX00509 Año de nacimiento incorrecto.

El año que ha introducido es incorrecto.


191



ATEX00510 Nive incorrecto.

El nive introducido no es correcto.

ATEX00600 Error Técnico.

Se ha producido un error técnico, por favor, inténtelo más tarde o póngase en contacto con el CAU


192



ATEX00601 Error Técnico.


ATEX00700

Vehículo sin antecedentes.

La información del vehículo no está consultado no está disponible.

ATEX00701

Persona sin antecedentes.

La información de la persona consultada no está disponible.


193



ATEX00800

Error técnico


ATEX99999

Error técnico.

Se ha producido un error técnico, por favor, inténtelo más tarde o póngase en contacto con el CAU. Tabla 40. Listado de Errores ATEX


194



4.2 Documentación relacionada -

Interfaz ATEX.wsdl: WSDL del Servicio Web de ATEX. Contiene también la definición de los parámetros de entrada del servicio: SolicitudMatricula y SolicitudBastidor.


195


-


Esquema Persona WSDL ATEX.xsd: esquema xsd con la definición de los parámetros de respuesta

de

la

consulta

de

personas

(respuesta

de

las

operaciones

consultarPersonaPorDocumento y consultarPersonaPorFiliacion). -

Esquema Vehiculo WSDL ATEX.xsd: esquema xsd con la definición de los parámetros de respuesta de la consulta de vehículos (respuesta de las operaciones consultarMatricula y consultarBastidor).


196


-


Esquema Tipos WSDL ATEX.xsd: esquema auxiliar con la definición de los tipos simples y complejos.


197

Manual de Usuario WS

Recommend Documents