Upload
trinhnhan
View
216
Download
0
Embed Size (px)
Citation preview
RED SARA
Para solicitar el alta de acceso a la RED SARA, deberemos seguir los siguientes pasos:
- A través del Portal del Ayuntamiento, en el apartado de trámites, se solicitara el alta para acceder a la Red SARA.
- Una vez solicitado el alta a la DPZ, se remitirá el formulario a la dirección: [email protected].
o En el caso que en la DGT preguntasen que tipo de acceso aplicación o servicio web se indicara que se solicita acceso a los dos.
o En el caso que solicitasen la IP de acceso: 10.252.192.94
- La DGT nos enviara un certificado y una vez que lo tengamos llamar al 902 077 292
A continuación se adjunta toda la documentación necesaria.
- Formulario alta
- Manuales de usuario
MINISTERIO DEL INTERIOR
CONDICIONES GENERALES DE USO DEL CERTIFICADO DE IDENTIDAD
ELECTRÓNICA NOV-06
DIRECCIÓN GENERAL DE TRÁFICO
JEFATURA PROVINCIAL DE TRÁFICO DE ZARAGOZA
SUSCRIPTOR DEL CERTIFICADO DE PERSONA JURÍDICA
DENOMINACIÓN O RAZÓN SOCIAL
CIF DIRECCIÓN
TELÉFONO LOCALIDAD
CÓDIGO POSTAL PROVINCIA CODIGO INE (sólo para municipios)
SOLICITANTE DEL CERTIFICADO DE PERSONA JURÍDICA NOMBRE Y APELLIDOS
DNI DIRECCIÓN
TELÉFONO LOCALIDAD
CÓDIGO POSTAL PROVINCIA PAÍS
DATOS DE CONTACTO TELÉFONO FAX
CONDICIONES PARTICULARES
Solicito en nombre del organismo arriba referenciado, el certificado electrónico expedido por la Dirección General de Tráfico (en adelante DGT), y declaro: Conocer y aceptar las condiciones generales de utilización; que los datos aquí expuestos son verdaderos y concuerdan con los registros públicos competentes; que a la fecha ostento facultades idóneas y suficientes, de acuerdo con los datos anteriores, para la presente solicitud.
La cumplimentación de este formulario en todos sus campos es obligatoria y se deberá presentar en la jefatura provincial de tráfico correspondiente.
En Zaragoza, a............. de.......................de 20......
El Solicitante, El Jefe Provincial de Tráfico,
Fdo. ………………………. Fdo.……………………….
MINISTERIO DEL INTERIOR
CONDICIONES GENERALES DE USO DEL CERTIFICADO DE IDENTIDAD
ELECTRÓNICA NOV-06
DIRECCIÓN GENERAL DE TRÁFICO
JEFATURA PROVINCIAL DE TRÁFICO DE ZARAGOZA
Este certificado solo es válido para la relación del organismo con la DGT. Cualquier otro uso que se le dé se considerará una violación de las condiciones de entrega del certificado y supondrá la revocación del certificado de identidad electrónica, sin perjuicio de las acciones administrativas, penales o civiles a las que haya lugar. El suscriptor considera y acepta que los productos y servicios que se anuncian son tal y como se ofrecen individualmente, que no existe ningún tipo de información implícita que implique servicios o prestaciones adicionales a los expresamente mencionados y que la utilización de los mismos es de su exclusiva responsabilidad. La Dirección General de Tráfico verificará la confiabilidad de la firma digital del suscriptor, que el certificado electrónico en el que se pretende confiar no se encuentra registrado en la base de datos de certificados revocados que la Dirección General de Tráfico tiene para el efecto, y que está en vigor. Asimismo, delimitará con precisión los datos que se encuentran firmados electrónicamente en los mensajes que recibe. La clave pública contenida en un certificado es un recurso técnico que puede utilizarse como un medio para cifrar los mensajes de datos que se envían, de tal manera que únicamente el tenedor de la clave privada asociada puede descifrar dicho mensaje y acceder a la información. El solicitante reconoce y acepta que si la clave privada se pierde o se destruye, la información que haya sido cifrada con la clave pública no podrá ser descifrada. Si durante el periodo de vigencia parte o toda la información contenida en el certificado de identidad electrónica pierde actualidad o validez, el suscriptor deberá iniciar el procedimiento de revocación del mismo mediante notificación presencial ante la jefatura provincial de tráfico de la provincia en la que radique, por el titular o persona con poder de representación suficiente. Los certificados deberán utilizarse tal y como son suministrados por la Dirección General de Tráfico. Se encuentra terminantemente prohibida cualquier alteración de los mismos, sin excepción alguna. Los certificados digitales pueden ser utilizados con los siguientes propósitos: Identificación: El suscriptor del certificado puede identificarse e identificar a la persona jurídica a la que representa ante la Dirección General de Tráfico, en una red de comunicaciones demostrando el acceso a la clave privada asociada con la clave pública que se incluye en el certificado digital. Integridad: El uso de la infraestructura de clave pública le permite comprobar a la Dirección General de Tráfico, en cualquier momento, que un mensaje de datos recibido no ha sido alterado desde el momento de su firma. Confidencialidad: La clave pública de un certificado puede ser usada para cifrar todos los documentos que se envían a su titular, impidiendo así que terceras personas tengan acceso a las comunicaciones electrónicas, incluso aunque se transmitan por medios de comunicación inseguros. No repudio: La Dirección General de Tráfico o el suscriptor, cuando reciben un mensaje de datos firmado electrónicamente y respaldado por un certificado electrónico válido y no revocado, pueden demostrar quién es el remitente, y éste no podrá negar el envío de dicho mensaje de datos. La persona que recibe el certificado de identidad electrónica del suscriptor, en adelante el receptor del certificado, declara tener poder de representación del centro para este acto, de acuerdo con la documentación presentada en la jefatura provincial de tráfico. El receptor del certificado acepta utilizar la clave privada y el certificado digital emitido tan sólo para los fines establecidos y de acuerdo con las condiciones generales establecidas en este documento
MINISTERIO DEL INTERIOR
CONDICIONES GENERALES DE USO DEL CERTIFICADO DE IDENTIDAD
ELECTRÓNICA NOV-06
DIRECCIÓN GENERAL DE TRÁFICO
JEFATURA PROVINCIAL DE TRÁFICO DE ZARAGOZA
o las particulares, en su caso. Será responsabilidad del receptor del certificado el posible uso indebido que éste o terceros hagan del mismo. Responderá por la custodia de la clave privada y de su soporte físico evitando su pérdida, revelación, modificación o uso no autorizado. Especialmente deberá abstenerse, sin importar la circunstancia, de anotar en el soporte físico del certificado digital el código de activación o las claves privadas. El receptor del certificado solicitará la revocación del certificado que le ha sido entregado cuando se cumpla alguno de los supuestos previstos para la revocación de los certificados digitales. Asimismo, se abstendrá en toda circunstancia de revelar la clave privada o el código de activación del certificado digital, para su uso a terceras personas, excepto a empleados del suscriptor en los que delegue por escrito la utilización del certificado. El receptor del certificado deberá verificar que toda la información contenida en el certificado es cierta y notificará inmediatamente a la Dirección General de Tráfico en caso de que se haya incluido cualquier información incorrecta o inexacta o en caso de que por alguna circunstancia posterior la información del certificado no corresponda con la realidad. Asimismo, deberá comunicar de manera inmediata el cambio o variación que haya sufrido cualquiera de los datos que aportó para adquirir el certificado, aunque éstos no estuvieran incluidos en el propio certificado. El receptor del certificado informará inmediatamente a la jefatura provincial de tráfico acerca de cualquier situación que pueda afectar la confiabilidad del certificado, que iniciará el procedimiento de revocación del certificado cuando sea necesario. Especialmente, deberá notificar de inmediato la efectiva pérdida, robo o falsificación del soporte físico y cualquier intento de realizar estos actos sobre el mismo, así como el conocimiento por otras personas no autorizadas del código de activación o de las claves privadas, solicitando la revocación del certificado. El solicitante se compromete a comunicar cualquier variación que se produzca respecto de la relación de usuarios autorizados, en particular comunicará la baja de los usuarios autorizados cuando cese la relación laboral con el suscriptor. Acepto las condiciones generales de utilización expresadas.
En Zaragoza, a............. de.......................de 20......
El Solicitante, El Jefe Provincial de Tráfico,
Fdo. ………………………. Fdo. ……………………….
ATMV
Manual de Usuario: Aplicación Web
GERENCIA DE INFORMÁTICA JOSEFA VALCÁRCEL, 44 28027-MADRID
Autor: Gerencia de Informática Última Modificación: 17/08/2010
Manual Usuario (ATMV) 2
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Índice General
1 INTRODUCCIÓN ........................................................................................................................................................4
1.1 PROPÓSITO .............................................................................................................................................................4 1.2 ALCANCE ...............................................................................................................................................................4 1.3 TERMINOLOGÍA Y ACRÓNIMOS ..............................................................................................................................4
2 DESCRIPCIÓN DE LA APLICACIÓN.....................................................................................................................5
2.1 DESCRIPCIÓN .........................................................................................................................................................5 2.2 REQUISITOS DEL SISTEMA ......................................................................................................................................6
3 FUNCIONALIDADES COMUNES............................................................................................................................6
3.1 FLUJO DE PASOS .....................................................................................................................................................6 3.2 ACCESO A LA APLICACIÓN .....................................................................................................................................7 3.3 SELECCIÓN DEL MODO DE USO. ............................................................................................................................13
4 ALTA DE IVTMS.......................................................................................................................................................18
5 GESTIÓN DE IVTMS................................................................................................................................................30
5.1 CONSULTA DE IVTMS .........................................................................................................................................32 5.1.1 Consulta Perfil Entidad Gestora. ...................................................................................................................33 5.1.2 Consulta Perfil “Funcionario” ......................................................................................................................41
5.2 DAR DE BAJA UN IVTM .......................................................................................................................................46
6 CERRAR SESIÓN......................................................................................................................................................52
7 ANEXOS......................................................................................................................................................................53
7.1 MENSAJES DE ERROR DE LA APLICACIÓN .............................................................................................................53
Índice de Ilustraciones y Tablas
Ilustración 1. Flujo de pasos del proceso ................................................................................................. 7 Ilustración 2. Servicio no disponible ....................................................................................................... 9 Ilustración 3. Selección de certificado ................................................................................................... 10 Ilustración 4. Certificado no válido ....................................................................................................... 11 Ilustración 5. Usuario no válido............................................................................................................. 12 Ilustración 9. Pantalla de bienvenida ..................................................................................................... 13 Ilustración 10. Menú de opciones .......................................................................................................... 14 Ilustración 11. Cerrar la sesión .............................................................................................................. 15 Ilustración 12. Información del usuario ................................................................................................. 16 Ilustración 13. Primer paso del proceso................................................................................................. 17 Ilustración 14. Ruta de la situación actual ............................................................................................. 18 Ilustración 15. Alta de IVTMs............................................................................................................... 19 Ilustración 16. Introducción de los datos de alta ................................................................................... 20 Ilustración 17. Dar de alta el IVTMs ..................................................................................................... 21 Ilustración 18. Campos requeridos ........................................................................................................ 22 Ilustración 19. Matrícula incorrecta....................................................................................................... 23
Manual Usuario (ATMV) 3
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Ilustración 20.El bastidor es incorrecto ................................................................................................. 24 Ilustración 21. Documento de identificación incorrecto........................................................................ 25 Ilustración 22. Provincia, municipio y año. .......................................................................................... 26 Ilustración 23. Acumulación de mensajes de error............................................................................... 27 Ilustración 24. Resultado del alta de un IVTM...................................................................................... 28 Ilustración 25. El IVTM ya existe ......................................................................................................... 29 Ilustración 26. Limpiar datos ................................................................................................................. 30 Ilustración 27. Gestión de IVTMs ......................................................................................................... 31 Ilustración 28. Introducción de los datos de búsqueda .......................................................................... 33 Ilustración 29. Consultar los IVTM....................................................................................................... 34 Ilustración 30. Error de validación ........................................................................................................ 35 Ilustración 31. Consulta por fecha ......................................................................................................... 36 Ilustración 32. La búsqueda no produjo resultados ............................................................................... 37 Ilustración 33. La búsqueda produjo demasiados resultados................................................................. 38 Ilustración 34. Resultado consulta ......................................................................................................... 39 Ilustración 35. Selección de un IVTM a consultar ................................................................................ 40 Ilustración 36 Introducción de los datos de búsqueda .......................................................................... 41 Ilustración 37 Consultar los IVTM........................................................................................................ 42 Ilustración 38 La búsqueda no produjo resultados ............................................................................... 43 Ilustración 39 La búsqueda produjo demasiados resultados................................................................. 44 Ilustración 40 Selección de un IVTM a consultar ................................................................................ 45 Ilustración 41. Pantalla detalle del IVTM.............................................................................................. 46 Ilustración 42. Dar de baja el IVTM...................................................................................................... 47 Ilustración 43. Confirmación de una baja. ............................................................................................. 48 Ilustración 44. Resultado correcto de la baja ......................................................................................... 49 Ilustración 45. Resultado incorrecto de la baja...................................................................................... 50 Ilustración 46. Impresión del resultado de la baja del IVTM ................................................................ 51 Ilustración 47. La sesión ha finalizado. ................................................................................................. 52
Tabla 1. Listado de Errores ATMV....................................................................................................... 54
Manual Usuario (ATMV) 4
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
1 Introducción
Este manual de usuario presenta la información útil para el uso de la aplicación ATMV destinada a la
gestión y el tratamiento de los impagos del IVTM mediante la Aplicación Web.
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.
1.2 Alcance
Este manual está dirigido a los usuarios que vayan a realizar gestiones telemáticas de vehículos.
1.3 Terminología y Acrónimos
- ATMV: Acreditación Telemática Impuesto Municipal de Vehículos.
- IVTM: Impuesto de Vehículos de Tracción Mecánica
- @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.
- RGD: Registro General de Deudores
- DGT: Dirección General de Tráfico
Manual Usuario (ATMV) 5
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
2 Descripción de la Aplicación
2.1 Descripción
La aplicación ATMV (Acreditación Telemática Impuesto Municipal de Vehículos) ofrece, a los
distintos Agentes Colaboradores, la posibilidad de acceder a gestión de los impagos del IVTM del
vehículo de una persona contenida en el Registro General de Deudores.
Sólo se permitirá el acceso a aquellos agentes colaboradores que estén dados de alta como usuarios
autorizados para ATMV. Además, se validará que tengan permiso para acceder a las diferentes
funcionalidades según el tipo de agente seleccionado.
Las diferentes funcionalidades a las que se puede tener acceso vía web son:
• Alta del impago en el Registro de Deudores
Esta funcionalidad es la encargada de introducir la información de los impagos
correspondientes a un Vehículo/Titular/Ayuntamiento/Año en el Registro de Deudores ubicado
en la DGT.
• Consulta del Impago del Registro de Deudores
Esta funcionalidad es la encargada de consultar la información de los impagos del Registro de
Deudores ubicado en la DGT.
• Eliminación del Impago del Registro de Deudores
Esta funcionalidad se encarga de eliminar la información de un impago correspondiente a un
Vehículo/Titular/Ayuntamiento/Año del Registro de Deudores ubicado en la DGT.
Manual Usuario (ATMV) 6
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
2.2 Requisitos del sistema
- Navegador web:
• Mozilla Firefox 1.5 o superior
• Internet Explorer 6 o superior
- Certificado digital de usuario admitido por la DGT e instalado en el navegador o disponible
a través de un módulo PKCS#11 instalado en el navegador (caso del DNI-e). Ver apartado
3.2.1.1 Condiciones de acceso.
- La aplicación está optimizada para las siguientes resoluciones de pantalla: 800x600,
1024x768, 1280x1024.
3 Funcionalidades Comunes
3.1 Flujo de pasos
El flujo de pasos de la aplicación por los que deberá pasar el usuario para realizar las operaciones
oportunas sobre los impagos son los siguientes:
- Acceso
- Selección de la operación: alta o gestión de impagos (consulta).
- Introducción de datos
- Resultado
En el caso de eliminación de impagos, supone dos pasos más. Una vez realizada la consulta y obtenido
su resultado, se accederá a la eliminación a través de este resultado, mostrando los detalles de un
impago determinado y posteriormente con el resultado de la eliminación.
Todos estos pasos así como las acciones que deberá realizar el usuario para avanzar en el proceso se
detallan a continuación en el documento.
Manual Usuario (ATMV) 7
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
El usuario podrá saber, en todo momento, en qué punto del trámite se encuentra simplemente
observando la parte superior de la pantalla, donde se indica el flujo de pasos. Esta ruta de pasos será
navegable hacia atrás, es decir, cada elemento individual enlaza con su contenido haciendo clic en él.
Ilustración 1. Flujo de pasos del proceso
3.2 Acceso a la aplicación
3.2.1.1 Condiciones de acceso
Para acceder a la aplicación, dependiendo del tipo de autenticación, las condiciones de acceso son:
1. Mediante un certificado válido:
Manual Usuario (ATMV) 8
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
a. Tener instalado el certificado de usuario adecuado en el navegador utilizado. El
certificado deberá estar admitido por la plataforma @Firma, no debe estar caducado ni
revocado y, además, debe haber sido emitido por una de las entidades válidas para el
trámite. Estas entidades son DGT, FNMT y DNI-e. La lista de certificados admitidos
por la plataforma de @Firma 5.0 se detallan en el documento “Declaracion_Practicas
de Validación”, para más información ver la URL siguiente
http://www.csi.map.es/csi/pg5a12.htm#62.
b. Tener el certificado de servidor correctamente instalado.
2. Disponer de un usuario y contraseña dados de alta en el sistema.
3.2.1.2 Acceso
El acceso a la aplicación se hará a través de los enlaces situados en la intranet de la DGT.
Manual Usuario (ATMV) 9
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
El horario de disponibilidad de la aplicación es de lunes a viernes laborables, de 8:00 a 20:00h. En
caso de que se intente acceder fuera de este horario, se mostrará la siguiente pantalla:
Ilustración 2. Servicio no disponible
La aplicación tiene habilitadas dos condiciones de acceso diferentes:
3.2.1.2.1 Acceso mediante certificado
Manual Usuario (ATMV) 10
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Una vez se selecciona el enlace para acceder a la aplicación, y se accede dentro del horario hábil, se
solicitará al ciudadano que se identifique con su certificado.
Ilustración 3. Selección de certificado
Manual Usuario (ATMV) 11
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
La aplicación lo validará mediante la plataforma de @Firma, comprobando que no esté caducado ni
revocado y que haya sido emitido por una de las entidades admitidas para el trámite, éstas son FNMT
y DNI-e. Si el certificado es correcto, podrá acceder a la aplicación, en caso contrario se mostrará una
pantalla de error con el mensaje “ATMV00201: Certificado no válido”.
Ilustración 4. Certificado no válido
Una vez que se comprueba que el certificado es correcto, se validará que el usuario tenga
efectivamente autorización para acceder a ATMV, distinguiendo si el usuario es una entidad gestora o
bien una jefatura y tiene el perfil Funcionario o Supervisor.
Manual Usuario (ATMV) 12
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
En caso de que el usuario no esté autorizado para acceder a la aplicación se le mostrará el siguiente
mensaje de error: “ATMV00301: Usuario no autorizado”.
Ilustración 5. Usuario no válido
Manual Usuario (ATMV) 13
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
3.3 Selección del modo de uso.
Una vez se ha verificado que el usuario esté autorizado, se accede a la pantalla de bienvenida de
ATMV:
Ilustración 6. Pantalla de bienvenida
Dicha pantalla consta de un menú en el lateral izquierdo donde aparecen las opciones a las que tiene
acceso el usuario y que podrá seleccionar:
- Alta de IVTMs: ver el manual de Alta de IVTMs.
- Gestión de IVTMs: ver el manual de Gestión de IVTMs.
Manual Usuario (ATMV) 14
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
- Ayuda en línea: muestra la explicación de cada pantalla que se pueda mostrar en la
aplicación. Es accesible desde cualquier punto de la aplicación por estar situada en este
menú.
Ilustración 7. Menú de opciones
En la parte superior de la pantalla, en la cabecera se puede visualizar en su parte derecha un literal y
una imagen que proporciona la funcionalidad de Cerrar la sesión, que finaliza la sesión. (Ver
apartado 6 de este documento).
Manual Usuario (ATMV) 15
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Ilustración 8. Cerrar la sesión
Manual Usuario (ATMV) 16
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Así mismo en esta pantalla, en la banda negra, aparecerá el nombre y apellidos del usuario así como la
fecha actual del sistema al que se encuentra conectado.
Ilustración 9. Información del usuario
Manual Usuario (ATMV) 17
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
También aparece resaltado, un poco más abajo y ya en la parte central de la pantalla, el paso del
proceso en el que el usuario se encuentra en estos momentos, que es la Pantalla de bienvenida:
Ilustración 10. Primer paso del proceso
Según se vaya navegando por las diferentes funcionalidades de la aplicación esta ruta irá cambiando,
acorde a la situación actual. Además, se podrá pulsar sobre un elemento de la ruta, ya que es enlazable
a la funcionalidad que describe.
Manual Usuario (ATMV) 18
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Ilustración 11. Ruta de la situación actual
4 Alta de IVTMs
Esta opción permite al usuario dar de alta los impagos asociados a una persona (a partir de su
documento de identificación), coche (mediante su matrícula) y año (actual o anterior al actual).
Se accede aquí una vez se ha seleccionado en el menú lateral izquierdo el enlace “Alta de IVTMs”.
Con esto se visualiza la siguiente pantalla:
Manual Usuario (ATMV) 19
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Ilustración 12. Alta de IVTMs
La pantalla dispone en el lateral izquierdo de un menú donde aparecen las opciones disponibles para el
usuario desde donde podrá dirigirse a cada una de ellas. Así mismo se siguen mostrando los datos del
usuario y el paso del proceso en el que el usuario se encuentra en estos momentos.
Manual Usuario (ATMV) 20
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Para realizar el alta del IVTM, en la parte central de la pantalla aparece un formulario con unas
etiquetas descriptivas y a la derecha de cada una, un recuadro que servirá para darle el valor deseado.
Los valores correspondientes a las etiquetas que se tienen que introducir para realizar correctamente el
alta de un impago son la matrícula, el bastidor, el documento de identificación del titular del vehículo,
la provincia y municipio y el año del impago, siendo opcional únicamente el bastidor del vehículo.
Todos los demás campos serán obligatorios.
Ilustración 13. Introducción de los datos de alta
Manual Usuario (ATMV) 21
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Una vez introducido los valores, se deberá seleccionar “Alta” para proceder al alta del IVTM con los
datos escritos.
Ilustración 14. Dar de alta el IVTMs
Manual Usuario (ATMV) 22
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Como se comentaba anteriormente, todos los campos, excepto el bastidor, son requeridos. En caso de
que no se introduzca alguno de ellos y se seleccione “Alta”, se mostrará en un mensaje el campo
requerido junto al siguiente texto: “El valor del campo es requerido”.
Ilustración 15. Campos requeridos
Manual Usuario (ATMV) 23
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Se deberá introducir una matrícula correcta. La aplicación se encargará de validarla y en caso de que
sea incorrecta se mostrará el siguiente mensaje de error: “ATMV00500: La matrícula es incorrecta”.
Ilustración 16. Matrícula incorrecta
Manual Usuario (ATMV) 24
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
El bastidor no es obligatorio, aún así, si se introduce un valor, la aplicación se encargará de validar si
el valor introducido es correcto y en el caso de que no se cumpla con el formato se mostrará el
siguiente mensaje de error: “ATMV00501: El bastidor es incorrecto”.
Ilustración 17.El bastidor es incorrecto
Se deberá introducir un documento de identificación válido, sólo se admiten letras y números y que
tenga el formato correcto (según el tipo de documento introducido NIF, CIF o NIE). La aplicación se
encargará de validar el documento introducido, en caso de que sea incorrecto se mostrará el siguiente
mensaje de error: “ATMV00502: El documento de identificación es incorrecto”.
Manual Usuario (ATMV) 25
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Ilustración 18. Documento de identificación incorrecto
Se deberá seleccionar una provincia, municipio y año de las posibilidades ofertadas en los
desplegables. La aplicación se encargará de validar los valores y en caso de que sean incorrectos se
mostrará el mensaje de error correspondiente: “ATMV00505: La provincia es incorrecta”
“ATMV00506: El municipio es incorrecto” o “ATMV00504: El año del impago es incorrecto”. Por
defecto siempre hay un valor seleccionado y no se puede seleccionar ninguno vacío.
Manual Usuario (ATMV) 26
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Ilustración 19. Provincia, municipio y año.
En cualquier momento los errores se pueden acumular, es decir, si se encuentran datos no válidos en
más de un campo, si falta rellenar un campo obligatorio y hay un error en otro, si falta más de un
campo obligatorio… Todos los mensajes asociados a estos errores se mostrarán debidamente por
pantalla como se hacía con los anteriores.
Manual Usuario (ATMV) 27
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Ilustración 20. Acumulación de mensajes de error.
Manual Usuario (ATMV) 28
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Una vez realizado el proceso de alta del IVTM, y si todo ha ido correctamente, se mostrará al usuario
el resultado de la operación, que consta de una frase de confirmación del alta del IVTM en el sistema
con el día y hora del mismo, de la siguiente manera: “Alta de IVTM en Acreditación telematica el día
29/01/2010 a las 14:57:56”.
Ilustración 21. Resultado del alta de un IVTM
Desde esta misma pantalla de resultado se podrá volver a completar una nueva alta realizando el
mismo proceso descrito.
Manual Usuario (ATMV) 29
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
En caso de que el impago ya exista o suceda durante el proceso de alta cualquier otro error, se
mostrará un aviso de ello en el lugar del mensaje correcto, como por ejemplo: “ATMV00801: El IVTM
ya existe”. Para ver todos los posibles errores que puede proporcionar la aplicación y su descripción
asociada consultar el apartado 7.1.
Ilustración 22. El IVTM ya existe
Si se desea borrar los campos automáticamente, en vez de hacerlo de uno en uno, se dispone de un
botón: “Limpiar”. Este botón proporciona la facilidad de no tener que borrar por cada alta todos los
campos manualmente.
Manual Usuario (ATMV) 30
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Ilustración 23. Limpiar datos
5 Gestión de IVTMs
Esta opción permite al usuario gestionar los IVTMs, es decir, realizar consultas con los criterios de
búsqueda oportunos. Como resultado se obtendrá un listado de impagos que cumplen los requisitos de
la búsqueda y a partir de ellos se podrá realizar la baja desde el detalle de cada impago individual.
Manual Usuario (ATMV) 31
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Para acceder a este modo de gestión se debe seleccionar en el menú lateral izquierdo el enlace
“Gestión de IVTMs”, con ello se abrirá la siguiente pantalla:
Ilustración 24. Gestión de IVTMs
La pantalla dispone en el lateral izquierdo de un menú donde aparecen las opciones disponibles para el
usuario. Así mismo, se siguen mostrando los datos del usuario, el paso del proceso en el que el usuario
se encuentra en estos momentos y el enlace de la parte superior derecha para finalizar la sesión.
Manual Usuario (ATMV) 32
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
5.1 Consulta de IVTMs
Este tipo de consulta permite realizar la búsqueda de IVTMs a partir de una matrícula, un bastidor, un
documento de identificación, un año de impago, una provincia, un municipio perteneciente a una
provincia, una fecha de alta, o cualquier tipo de combinación de todos los criterios anteriores. Es decir,
ningún campo es obligatorio.
Una persona de una JPT puede tener perfil “Funcionario” o perfil “Supervisor”. La persona que tenga
Perfil funcionario podrá realizar consultas de IVTM´s en base a la mátrícula y/o el año
correspondiente al impago del impuesto.
Como resultado se obtendrá la lista de impagos que se ajusten al criterio de búsqueda introducido.
Manual Usuario (ATMV) 33
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
5.1.1 Consulta Perfil Entidad Gestora.
Las consultas con un perfil Entidad gestora tendrán los mismos permisos que el perfil “Supervisor” a
la hora de realizar consultas de IVTMs.
Para realizar la búsqueda introduzca los criterios deseados en los recuadros correspondientes a la
leyenda de su izquierda.
Ilustración 25. Introducción de los datos de búsqueda
Manual Usuario (ATMV) 34
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Una vez introducido los criterios de búsqueda, seleccione “Consultar” para proceder a la búsqueda de
la información asociada.
Ilustración 26. Consultar los IVTM
Manual Usuario (ATMV) 35
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Aunque ningún campo es obligatorio, aquel que se introduzca deberá ser válido. La aplicación se
encargará de validar el valor introducido, en caso de que sea incorrecto se mostrará el correspondiente
mensaje de error.
Ilustración 27. Error de validación
En el caso de usar la fecha de alta para la consulta, hay que tener en cuenta el formato de entrada. Éste
formato es el siguiente: dd/mm/aaaa, es decir, dos dígitos para el día, otros dos dígitos para el mes y
cuatro dígitos para el año, separados entre ellos por dos barras diagonales (/).
Se permite el uso de un comodín para consultar todos los días de un determinado mes y año. El
comodín que se introduzca será el carácter de porcentaje (%), y se deberá seguir respetando el formato
Manual Usuario (ATMV) 36
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
explicado anteriormente. Por lo tanto, la consulta con comodín tendrá que seguir el siguiente formato:
%/mm/aaaa. Por ejemplo, si deseamos buscar los impagos del sistema para todo el mes de octubre del
año 2008, la consulta sería la siguiente: %/10/2008. Esta información sobre el formato de la fecha se
muestra mediante un mensaje cuando se pasa por la caja de texto correspondiente a la fecha.
Ilustración 28. Consulta por fecha
Manual Usuario (ATMV) 37
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
En caso de que la consulta no genere ningún resultado que se pueda mostrar al usuario, se le notificará
mediante la visualización del siguiente de error: “ATMV00802: La búsqueda no produjo resultados”.
Ilustración 29. La búsqueda no produjo resultados
En el caso de que la consulta tenga que devolver muchos resultados, se mostrarán hasta un máximo de
75 impagos, y esto se indicará al usuario con el mensaje siguiente: “ATMV00803: La búsqueda
produjo demasiados resultados, por favor, delimite la búsqueda.”
Manual Usuario (ATMV) 38
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Ilustración 30. La búsqueda produjo demasiados resultados
Una vez realizada la consulta, y si todo funciona correctamente, se mostrará al usuario el resultado con
una lista de los impagos encontrados. De cada impago, esta lista descriptiva contiene los valores de la
matrícula, identificador del titular, bastidor, el código INE de la provincia y municipio, el año y
finalmente la fecha de alta.
Manual Usuario (ATMV) 39
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Ilustración 31. Resultado consulta
Manual Usuario (ATMV) 40
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Si se desea obtener la información detallada de alguno de los impagos, seleccione sobre el impago que
se desea consultar (sobre cualquier de sus atributos descriptivos).
Ilustración 32. Selección de un IVTM a consultar
Una vez pulsado en la lista sobre un impago se mostrará el detalle del impago en una ventana nueva.
Desde ella se podrá dar de baja el impago que se está visualizando (véase el apartado 5.2) o bien
cancelar dicha visualización y volver a la lista de resultado anterior.
Manual Usuario (ATMV) 41
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
5.1.2 Consulta Perfil “Funcionario”
Para realizar la búsqueda introduzca los criterios deseados en los recuadros correspondientes a la
leyenda de su izquierda.
Ilustración 33 Introducción de los datos de búsqueda
Una vez introducido los criterios de búsqueda, seleccione “Consultar” para proceder a la búsqueda de
la información asociada.
Manual Usuario (ATMV) 42
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Ilustración 34 Consultar los IVTM
En caso de que la consulta no genere ningún resultado que se pueda mostrar al usuario, se le notificará
mediante la visualización del siguiente de error: “ATMV00802: La búsqueda no produjo resultados”.
Manual Usuario (ATMV) 43
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Ilustración 35 La búsqueda no produjo resultados
En el caso de que la consulta tenga que devolver muchos resultados, se mostrarán hasta un máximo de
75 impagos, y esto se indicará al usuario con el mensaje siguiente: “ATMV00803: La búsqueda
produjo demasiados resultados, por favor, delimite la búsqueda.”
Manual Usuario (ATMV) 44
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Ilustración 36 La búsqueda produjo demasiados resultados
Una vez realizada la consulta, y si todo funciona correctamente, se mostrará al usuario el resultado con
una lista de los impagos encontrados. De cada impago, esta lista descriptiva contiene los valores de la
matrícula, identificador del titular, bastidor, el código INE de la provincia y municipio, el año y
finalmente la fecha de alta.
Manual Usuario (ATMV) 45
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Si se desea obtener la información detallada de alguno de los impagos, seleccione sobre el impago que
se desea consultar (sobre cualquier de sus atributos descriptivos).
Ilustración 37 Selección de un IVTM a consultar
Una vez pulsado en la lista sobre un impago se mostrará el detalle del impago en una ventana nueva.
Desde ella se podrá dar de baja el impago que se está visualizando (véase el apartado 5.2) o bien
cancelar dicha visualización y volver a la lista de resultado anterior.
Manual Usuario (ATMV) 46
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
5.2 Dar de baja un IVTM
Esta funcionalidad se encarga de la petición de eliminación de información de un impago
seleccionado.
Para dar de baja un impago específico es necesario que anteriormente se haya obtenido este impago
como resultado de una consulta y visualizar su detalle.
Ilustración 38. Pantalla detalle del IVTM
Manual Usuario (ATMV) 47
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Es en este momento cuando se puede dar de baja el impago pulsando sobre el botón “Dar de baja” o
bien cancelar la baja y volver a la lista de resultados pulsando sobre el botón “Cancelar”.
Ilustración 39. Dar de baja el IVTM
Manual Usuario (ATMV) 48
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Al seleccionar el botón de baja el sistema mostrará un mensaje de confirmación de la eliminación del
IVTM seleccionado.
Ilustración 40. Confirmación de una baja.
Manual Usuario (ATMV) 49
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Cuando se pulse sobre el botón ‘SI’ y si todo ha funcionado correctamente, el sistema mostrará por
pantalla un mensaje de confirmación. El mensaje notificará la confirmación de la baja con la fecha y la
hora de la operación.
En el caso de pulsar ‘NO’ volverá a la lista de resultados al igual que sucede en el botón cancelar.
Ilustración 41. Resultado correcto de la baja
Si por algún problema no se pudiese realizar la baja del impago, se mostrará bajo el detalle del impago
un error con su código y mensaje. Para ver la explicación de cada mensaje de error tratado por la
aplicación se puede consultar el apartado 7.1.
Manual Usuario (ATMV) 50
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Ilustración 42. Resultado incorrecto de la baja
Manual Usuario (ATMV) 51
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
El usuario podrá imprimir el resultado obtenido seleccionando el botón habilitado para ello en la parte
superior derecha, tal y como se muestra en la siguiente imagen.
Ilustración 43. Impresión del resultado de la baja del IVTM
Desde cualquiera de las pantallas mostradas anteriormente referentes tanto a la consulta como a la baja
de impagos, se pueden realizar otras nuevas consultas realizando el mismo proceso descrito
anteriormente, obteniendo el listado de impagos consultado o bien el mensaje de validación o de error.
Manual Usuario (ATMV) 52
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
6 Cerrar sesión
En caso de que el usuario decida seleccionar la opción “Cerrar sesión” desde cualquiera de las
pantallas donde esté disponible esta opción, el usuario finalizará el proceso de consulta y se le
mostrará la siguiente pantalla con el mensaje “La sesión ha finalizado”.
Ilustración 44. La sesión ha finalizado.
Manual Usuario (ATMV) 53
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
7 Anexos
7.1 Mensajes de error de la aplicación
CODIGO ERROR MENSAJE DE ERROR EXPLICACIÓN ERROR
ATMV00100
El servicio no está disponible en este momento. Por favor, inténtelo de lunes a viernes, laborables según el calendario nacional, desde las 8:00 hasta las 20:00h.
El servicio no está disponible, inténtelo de nuevo en el horario de disponibilidad.
ATMV00101
El servicio no está disponible en este momento. Por favor, inténtelo de lunes a viernes, laborables según el calendario nacional, desde las 20:00 hasta las 23:00h
El servicio no está disponible, inténtelo de nuevo en el horario de disponibilidad.
ATMV00102 La sesión ha caducado. La sesión ha caducado debido a inactividad, por favor reanude el proceso.
ATMV00200 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.
ATMV00201 Certificado no válido. El certificado digital usado no es válido (por ejemplo, está revocado).
ATMV00202 Identificador de usuario no válido. El identificador del usuario no es coincidente con el del certificado.
ATMV00300 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.
ATMV00301 Usuario no autorizado. No está autorizado para acceder a la aplicación.
ATMV00400 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.
ATMV00401 Error de configuración de la Entidad. Se ha producido un error asociado a la entidad del usuario, por favor, póngase en contacto con el CAU.
ATMV00500 La matrícula es incorrecta. La matrícula introducida no es correcta.
AMTV00501 El bastidor es incorrecto. El bastidor introducido no es correcto.
ATMV00502 El documento de identificación es incorrecto. El número de documento introducido no es correcto.
Manual Usuario (ATMV) 54
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
ATMV00503 El año del IVTM es incorrecto. El año introducido no es correcto.
ATMV00504 La provincia es incorrecta. La provincia introducida no es correcta.
ATMV00505 El municipio es incorrecto. El municipio seleccionado no es correcto.
ATMV00506 La fecha de alta introducida es incorrecta. La fecha de alta introducida no es correcta. Debe seguir el formato DD/MM/AAAA.
ATMV0600 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.
ATMV00601 Vehículo sin antecedentes. La información del vehículo consultado no está disponible.
ATMV00602 Bastidor incoherente. El bastidor no se corresponde al bastidor asociado a la matrícula.
ATMV00604 El vehículo está dado de baja definitiva. El vehículo está dado de baja definitiva. La operación no se puede realizar.
ATMV00800 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.
ATMV00801 El IVTM ya existe. Se intenta dar de alta un impago que ya está dado de alta.
ATMV00802 La búsqueda no produjo resultados. La consulta realizada no arroja ningún resultado.
ATMV00803 La búsqueda produjo demasiados resultados, por favor, delimite la búsqueda.
La consulta de impagos es muy genérica y produce muchos resultados.
ATMV00804 El IVTM no existe. El impago que se intenta dar de baja no existe.
ATMV99999 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 1. Listado de Errores ATMV
ATMV
Autor: Gerencia de Informática
Última Modificación: 03/06/2009
Manual de Usuario: Servicio Web
GERENCIA DE INFORMÁTICA JOSEFA VALCÁRCEL, 44 28027-MADRID TEL: 91 301 81 40 FAX: 91 301 81 01
Manual Usuario WS (ATMV) 2
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Índice General
1 INTRODUCCIÓN.................................................................................................................................................... 3
1.1 PROPÓSITO ......................................................................................................................................................... 3 1.2 ALCANCE ........................................................................................................................................................... 3 1.3 TERMINOLOGÍA Y ACRÓNIMOS .......................................................................................................................... 3
2 DESCRIPCIÓN DE LA APLICACIÓN................................................................................................................. 4
2.1 DESCRIPCIÓN ..................................................................................................................................................... 4 2.2 CARACTERÍSTICAS TÉCNICAS DEL SERVICIO WEB ............................................................................................. 5 2.3 DEFINICIÓN DEL SERVICIO ................................................................................................................................. 6
2.3.1 Operación altaImpago.................................................................................................................................. 6 2.3.2 Operación consultaImpagos......................................................................................................................... 7 2.3.3 Operación eliminarImpago .......................................................................................................................... 8 2.3.4 Operación eliminacionMasiva ..................................................................................................................... 8
3 PARÁMETROS DEL SERVICIO .......................................................................................................................... 9
3.1 DETALLE PARÁMETROS. .................................................................................................................................... 9 3.2 ATMVFAULT .................................................................................................................................................. 11
4 ANEXOS.................................................................................................................................................................. 11
4.1 ERRORES .......................................................................................................................................................... 11 4.2 FORMATOS DE MATRÍCULAS............................................................................................................................ 14 4.3 CÓDIGOS DE PROVINCIAS Y DE MUNICIPIOS...................................................................................................... 15 4.4 DOCUMENTACIÓN RELACIONADA .................................................................................................................... 15 4.5 EJEMPLOS WS.................................................................................................................................................. 17
4.5.1 Ejemplo WS de ALTA ................................................................................................................................. 17 4.5.2 Ejemplo WS de ALTA ................................................................................................................................. 17 4.5.3 Ejemplo petición WS de CONSULTA ........................................................................................................ 17 4.5.4 Ejemplo petición WS de BAJA MASIVA..................................................................................................... 17
Índice de Ilustraciones y Tablas
Tabla 1. Métodos del Servicio Web de ATMV .................................................................................6 Tabla 2. Detalle parámetros ............................................................................................................10 Tabla 3. ATMVFault ......................................................................................................................11
Manual Usuario WS (ATMV) 3
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
1 Introducción
Este manual de usuario presenta la información útil para el uso de la aplicación ATMV destinada a
la gestión de los impagos del impuesto de tracción mecánica de vehículos a través de los Servicios
Web habilitados.
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.
1.2 Alcance
Este manual está dirigido a los usuarios (organismos públicos) que vayan a realizar la gestión de los
impagos en el nuevo marco de aplicación a través del Servicio Web disponible.
1.3 Terminología y Acrónimos
ATMV: Proyecto de Acreditación Telemática Impuesto Municipal de Vehículos
@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.
RGD: Registro General de Deudores.
INE: Instituto nacional de Estadística
DGT: Dirección General de Tráfico.
VIN: Identificador del vehículo (número de bastidor).
Manual Usuario WS (ATMV) 4
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
2 Descripción de la Aplicación
2.1 Descripción
La aplicación ATMV (Acreditación Telemática Impuesto Municipal de Vehículos) ofrece, a los
distintos Agentes Colaboradores, la posibilidad de acceder a la gestión de los impagos del impuesto
de tracción mecánica de vehículos.
Sólo se permitirá el acceso a aquellos agentes colaboradores que estén dados de alta como usuarios
autorizados para ATMV.
Los servicios a los que se podrá tener acceso vía servicio web son los siguientes:
� Alta del Impago en el Registro de Deudores
Este servicio es el encargado de introducir la información de los impagos correspondientes a un Vehículo/Titular/Ayuntamiento/Año en el Registro de Deudores ubicado en la DGT.
� Consulta del Impago del Registro de Deudores
Este servicio es el encargado de consultar la información de los impagos del Registro de Deudores ubicado en la DGT.
� Eliminación del Impago del Registro de Deudores
Este servicio es el encargado de eliminar la información de un impago correspondiente a un Vehículo/Titular/Ayuntamiento/Año del Registro de Deudores ubicado en la DGT.
� Eliminación Masiva de Impagos del Registro de Deudores
Este servicio es el encargado de eliminar la información de todos los impagos correspondientes a una Diputación y sus Ayuntamientos, o a un Ayuntamiento.
Manual Usuario WS (ATMV) 5
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
2.2 Características técnicas del Servicio Web
Entorno: Internet.
Protocolo: HTTPs sin configuración de autenticación requerida con certificado cliente.
Mensajes: Estándares utilizados para web services:
- SOAP version 1.1.
- WSDL version 1.1
- Webservices for J2EE version 1.1
- Java API for XML-Based RPC (JAX-RPC) version 1.1
Certificados admitidos: DGT, FNMT y DNI-e. La lista de certificados admitidos por la
plataforma de @Firma 5.0 se detalla 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.
Infraestructura: se establecerá una conexión segura entre los servidores de la DGT y las
plataformas llamantes.
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 WS-Security
mediante certificados del tipo x509.v3.
Manual Usuario WS (ATMV) 6
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
2.3 Definición del Servicio
El servicio estará disponible los días laborables de lunes a viernes según el calendario nacional, desde
las 8.00 hasta las 20.00h para los servicios no masivos y de 20:00h a 23:00h para los masivos.
Dispone de cuatro operaciones, las cuales se detallan a continuación:
MÉTODO DESCRIPCIÓN
altaImpago Este servicio da de alta el impago correspondiente a un vehículo/Titular/Ayuntamiento/Año en el Registro de Deudores ubicado en la DGT.
consultaImpagos Este servicio es el encargado de consultar la información de los impagos del Registro de Deudores.
eliminarImpago Este servicio es el encargado de eliminar la información de un impago correspondiente a un Vehículo/Titular/Ayuntamiento/Año del Registro de Deudores ubicado en la DGT.
eliminacionMasiva Este servicio es el encargado de eliminar la información de todos los impagos correspondientes a un año.
Tabla 1. Métodos del Servicio Web de ATMV
2.3.1 Operación altaImpago
Parámetro de entrada: el parámetro que recibe la operación es solicitudAlta el cual recoge los datos
necesarios para realizar un alta del impago de un vehículo a partir de su matrícula. A su vez este
parámetro se compone de los siguientes elementos:
Matrícula del Vehículo Bastidor del Vehículo Identificador del Titular Provincia Municipio Año Impago
Identificador de Entidad Colaboradora
Manual Usuario WS (ATMV) 7
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Parámetro de salida: como respuesta el servicio devolverá un parámetro respuestaAlta que contiene
el resultado de la operación.
Excepción: en caso de que se produzca algún error en el proceso, el servicio web lanzará una
excepción atmvFault la cual contendrá una descripción del error producido y el código asociado. En el
anexo de este documento se detallan todos los errores que pueden ser lanzados por el servicio.
Cada uno de estos parámetros se detalla en el apartado 3 de este documento.
2.3.2 Operación consultaImpagos
Parámetro de entrada: el parámetro que recibe la operación es solicitudConsulta el cual recoge los
datos necesarios para realizar una búsqueda de los impagos. A su vez este parámetro se compone de
los siguientes elementos:
Matrícula del Vehículo Bastidor del Vehículo Identificador del Titular Provincia Municipio Año Impago Fecha de alta en el registro de deudores
Identificador de Entidad Colaboradora
Parámetro de salida: como respuesta el servicio devolverá un parámetro listaImpagos que contiene
el resultado de la operación.
Excepción: en caso de que se produzca algún error en el proceso, el servicio web lanzará una
excepción atmvFault la cual contendrá una descripción del error producido y el código asociado. En el
anexo de este documento se detallan todos los errores que pueden ser lanzados por el servicio.
Cada uno de estos parámetros se detalla en el apartado 3 de este documento.
Manual Usuario WS (ATMV) 8
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
2.3.3 Operación eliminarImpago
Parámetro de entrada: el parámetro que recibe la operación es solicitudEliminacion el cual recoge
los datos necesarios para realizar una baja del impago. A su vez este parámetro se compone de los
siguientes elementos:
Matrícula del Vehículo Bastidor del Vehículo Identificador del Titular Provincia Municipio Año Impago
Identificador de Entidad Colaboradora
Parámetro de salida: como respuesta el servicio devolverá un parámetro respuestaEliminar que
contiene el resultado de la operación.
Excepción: en caso de que se produzca algún error en el proceso, el servicio web lanzará una
excepción atmvFault la cual contendrá una descripción del error producido y el código asociado. En el
anexo de este documento se detallan todos los errores que pueden ser lanzados por el servicio.
Cada uno de estos parámetros se detalla en el apartado 3 de este documento.
2.3.4 Operación eliminacionMasiva
Parámetro de entrada: el parámetro que recibe la operación es solicitudEliminacion el cual recoge
los datos necesarios para realizar una baja masiva de todos los impagos que gestiona el agente
colaborador. A su vez este parámetro se compone de:
Año Impago
Identificador de Entidad Colaboradora Parámetro de salida: como respuesta el servicio devolverá un parámetro respuestaEliminacion que
contiene el resultado de la operación.
Manual Usuario WS (ATMV) 9
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Excepción: en caso de que se produzca algún error en el proceso, el servicio web lanzará una
excepción atmvFault la cual contendrá una descripción del error producido y el código asociado. En el
anexo de este documento se detallan todos los errores que pueden ser lanzados por el servicio.
Cada uno de estos parámetros se detalla en el apartado 3 de este documento.
3 Parámetros del Servicio
3.1 Detalle Parámetros.
A continuación se detallan los parámetros definidos en el WSDL:
Nombre del campo WSDL
Tipo Campo funcional Descripción
matricula String Matrícula del
Vehículo
Matrícula del vehículo. Con tamaño máximo de 9
caracteres, siguiendo los patrones definidos en el
anexo “formato de matrículas”.
bastidor String Bastidor del
Vehículo
Número de bastidor del vehículo de un máximo de
21 caracteres.
idTitular String Identificador
del Titular
Documento de identidad del titular del vehículo
(NIF, CIF, NIE) en formato sin separadores con un
tamaño de 9 caracteres.
provincia String Provincia Código de la provincia de 2 posiciones según el
INE.
municipio String Municipio Código de la provincia de 5 posiciones según el
INE sin dígito de control.
anyoImpago int Año Impago Año en 4 dígitos, mayor del 2007. Corresponderá
al ejercicio del impago.
Manual Usuario WS (ATMV) 10
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Nombre del campo WSDL Tipo Campo funcional Descripción
IdUsuario String Identificador
de Entidad
Colaboradora
Documento de identidad de la entidad gestora de
los impagos (NIF, CIF, NIE) en formato sin
separadores con un tamaño de 9 caracteres. Deberá
corresponderse con el documento de identidad del
certificado de la entidad utilizado para la firma de
los mensajes de intercambio.
codResultado String Código
Resultado
Valor “ATMV00000” para el caso OK, en caso de
error ver apartado “ATMVFault”
mensaje String Descripción
Resultado
“Operación realizada” para el caso OK, en caso de
error ver apartado “ATMVFault”
infoAdicional String Información
adicional al
resultado.
Información adicional al resultado de la operación, donde se podrá mostrar entre otros un texto indicando dentro del mismo la Fecha de alta en el registro de deudores. Ejemplos de textos: ALTA: Alta de Impago en Registro de Deudores el dia 30/09/2008 a las 11:49:21 BAJA: Baja de Impago en Registro de Deudores realizada el dia 30/09/2008 a las 11:49:21 BAJA_MASIVA: Baja masiva de Impagos en
Registro de Deudores realizada el dia 30/09/2008 a
las 11:49:21
fechaAlta String Fecha de alta
en el registro
de deudores
Fecha de alta en el registro de deudores. Tendrá 2 formatos dependiendo del uso: como parámetro de salida tendrá el formato “dd/MM/yyyy HH:mm:ss Ejemplo 04/11/2008 14:58:02” y como parámetro de entrada en la consulta
tendrá el formato string (DD/MM/AAAA o
%/MM/AAAA). .
Tabla 2. Detalle parámetros
Manual Usuario WS (ATMV) 11
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
3.2 ATMVFault
En caso de que se produzca algún error en el proceso, el servicio web lanzará una excepción
ATMVFault 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 WSDL “Interfaz ATMV.wsdl” y cuyos elementos se detallan a
continuación:
Nombre Etiqueta Tipo Descripción <ATMVFault> Resultado de Error <codError> String Código del error producido ( ver códigos de la lista de mensajes del anexo)
<descripcion> String Descripción del error producido ( ver descripción de la lista de mensajes del
anexo) Tabla 3. ATMVFault
En el anexo de este documento se detallan todos los errores que pueden ser lanzados por el servicio.
4 Anexos
4.1 Errores
Código Mensaje mostrado Descripción del error
ATMV00100 ATMV00100. El servicio no está disponible en este momento. Por favor, inténtelo de lunes a viernes, laborables según el calendario nacional, desde las 8:00 hasta las 20:00h.
Este error se produce cuando se intenta acceder a los servicios de alta, consulta y baja de impagos, fuera del horario habilitado (de lunes a viernes, laborables según el calendario nacional, desde las 8:00 hasta las 20:00h).
ATMV00101 ATMV00101. El servicio no está disponible en este momento. Por favor, inténtelo de lunes a viernes, laborables según el calendario nacional, desde las 20:00 hasta las 23:00h.
Este error se produce cuando se intenta acceder al servicio de borrado de masivos fuera del horario habilitado (de lunes a viernes, laborables según el calendario nacional, desde las 20:00 hasta las 23:00h).
Manual Usuario WS (ATMV) 12
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
ATMV00200 ATMV00200. Error Técnico. Este error se produce cuando se produce un error técnico interno a la plataforma ATMV o su comunicación con terceros. Contactar con el CAU.
ATMV00201 ATMV00201. Certificado no válido
Este error se produce cuando el certificado digital utilizado para la autenticación y acceso en la aplicación, no es válido, bien porque está revocado, bien porque la entidad emisora no está admitida para el trámite.
ATMV00202 ATMV00202. Identificador de usuario no válido.
Este error se produce cuando el Id del usuario no coincide con el CIF del certificado digital usado en la firma del mensaje (WS Security).
ATMV00300 ATMV00300. Error Técnico. Este error se produce cuando se produce un error técnico interno a la plataforma ATMV o su comunicación con terceros. Contactar con el CAU.
ATMV00301 ATMV00301: Usuario no autorizado.
Error producido cuando el usuario que intenta acceder a la aplicación no está autorizado.
ATMV00400 ATMV00400: Error técnico. Este error se produce cuando se produce un error técnico interno a la plataforma ATMV o su comunicación con terceros. Contactar con el CAU.
ATMV00401 ATMV00401: Error de configuración del Identificador de la Entidad.
Este error se da cuando no existe o no se encuentra el Id de la Entidad o no tiene asignado ningún Municipio en la BBDD de Municipios.
ATMV00500 ATMV00500 La matrícula es incorrecta.
Este error se produce cuando la Matricula introducida no es correcta en cuanto al formato, o bien no se ha introducido.
ATMV00501 ATMV00501: El bastidor es incorrecto.
Este error ocurre cuando el Bastidor introducido no es correcto en cuanto al formato.
ATMV00502 ATMV00502: El documento de identificación es incorrecto.
El documento de identificación del titular introducido es incorrecto en cuanto a formato.
ATMV00503 ATMV00503: El año del impago es incorrecto.
El año de impago introducido es incorrecto en cuanto a formato.
ATMV00504 ATMV00504. La provincia es incorrecta.
Este error se produce cuando se introduce una Provincia para la cual la Entidad no tiene competencias y sobre la cual no puede realizar Altas, Bajas ni Consultas de Impagos.
ATMV00505 ATMV00505. El municipio es incorrecto.
Este error se produce cuando se introduce un Municipio para el cual la Entidad no tiene competencias y sobre el cual no puede realizar Altas, Bajas ni Consultas de Impagos.
ATMV00506 ATMV00506. La fecha de alta introducida es
Este error se da cuando la fecha de alta del impago en el RGD
Manual Usuario WS (ATMV) 13
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
incorrecta. introducida no es correcta en cuanto a formato o es una fecha futura a la fecha en la que se realiza la Consulta de impagos.
ATMV00600 ATMV00600. Error Técnico. Este error se produce cuando se produce un error técnico interno a la plataforma ATMV o su comunicación con terceros. Contactar con el CAU.
ATMV00601 ATMV00601. Vehículo sin antecedentes.
Este caso ocurre cuando el vehículo cuyo impago se quiere dar de alta, no tiene información asociada en el RGV, es decir, no existe la matrícula del vehículo.
ATMV00602 ATMV00602. Bastidor incoherente.
Este caso se da cuando el vehículo cuyo impago se quiere dar de alta, sí existe en el RGV (existe la matrícula del vehículo) pero el bastidor que el usuario ha introducido no coincide con el que está en el RGV para ese vehículo.
ATMV00604 ATMV00604. El vehículo está dado de baja definitiva.
Este caso ocurre cuando el vehículo cuyo impago se quiere dar de alta, está dado de baja de manera definitiva y por tanto la operación no se puede llevar a cabo.
ATMV00800 ATMV00800.Error técnico. Este error se produce cuando se produce un error técnico interno a la plataforma ATMV o su comunicación con terceros. Contactar con el CAU.
ATMV00801 ATMV00801. El impago ya existe.
Este error se da cuando se intenta dar de alta un impago que ya existe en el RGD.
ATMV00802 ATMV00802: La búsqueda no produjo resultados.
Este error se da cuando se realiza una Consulta de un impago y la búsqueda realizada no produce resultados.
ATMV00803 ATMV00803: La búsqueda produjo demasiados resultados, por favor, delimite la búsqueda.
Este error se da cuando se realiza una Consulta de un impago y la búsqueda realizada produce más de 75 resultados.
ATMV00804 ATMV00804: El impago no existe.
Este error se da cuando se intenta dar de baja un impago que no existe en el RGD.
ATMV99999 ATMV99999. Error técnico. Este error se produce cuando se produce un error técnico interno a la plataforma ATMV o su comunicación con terceros. Contactar con el CAU.
Manual Usuario WS (ATMV) 14
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
4.2 Formatos de Matrículas
Las siguientes tablas recogen los formatos de matrículas válidos que se manejan actualmente en
todas las Bases de Datos de la Dirección General de Tráfico:
FORMATOS ANTIGUOS
Ordinaria sin letras 1 S S 0 0 0 0 0 0 Ordinaria con letras 2 S S 0 0 0 0 L L Remolques 3 S S 0 0 0 0 0 R Vehículos especiales (5 dígitos) 4 S S 0 0 0 0 0 E Vehículos especiales (6 dígitos) 5 S S 0 0 0 0 0 0 E Turísticas 6 0 0 S S 0 0 0 0 Temporal (5 días) 7 S S 0 0 0 0 T 0 0 Temporal (30 días) 8 S S 0 0 0 0 R 0 0
[A-Z]{1,2}[0-9]{4}[TR][0-9]{2} 7,8 [0-9]{2}[A-Z]{1,2}[0-9]{4} 6 [A-Z]{1,2}([0-9]{5,6}[E]|[0-9]{5}[R]) 3,4,5 [A-Z]{1,2}[0-9]{4}([0-9]{2}|[A-Z]{1,2}) 1,2 [ERCTHPVS]?[0-9]{4}[A-Z]{3} NUEVAS
FORMATOS NUEVOS (desde 27 / 07 / 1999. Reglamento de Vehículos)
Ciclomotores C 0 0 0 0 L L L Vehículos históricos H 0 0 0 0 L L L Remolques R 0 0 0 0 L L L Vehículos especiales E 0 0 0 0 L L L Turísticas T 0 0 0 0 L L L Temporal particulares P 0 0 0 0 L L L Temporal empresas sin matricular S 0 0 0 0 L L L Temporal empresas matriculados V 0 0 0 0 L L L
FORMATO NUEVO (desde 18 / 09 / 2000. Ordinarias Europeas)
Ordinarias actuales 0 0 0 0 L L L
Las letras en negrita indican que son fijas, el cero indica un dígito, la letra L indica una letra y la letra S indica la posibilidad de letra o espacio en blanco.
Por ejemplo, en caso de las matrículas viejas ordinarias (formato: SS0000LL) se puede dar el
caso de distintivos de provincia de una sola letra (por ejemplo Madrid). Entonces el formato correcto
Manual Usuario WS (ATMV) 15
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
es emplear la primera posición para el distintivo (M en este ejemplo) y la segunda posición dejarla en blanco. Ejemplos: M 1234JT, TO1234AA, etc. FORMATOS DE MATRICULA Tipo de matricula Clave
Tipo matricula
Formato Ejemplo
Ordinarias Siglas provincia y números
0
MM000000 C 123456
Ordinarias Siglas provincia , números y letras
0 MM0000AA MA1234AB M 1234 A
Remolques 2 MM00000R GR12345R V. Especiales 5 dígitos 5 MM00000VE B 12345VE V. Especiales 6 dígitos 5 MM000000E C 123456E 1.999 (Rglto. De Vehículos) : Ciclomotores 6 C0000XXX C1234BCD Remolques 2 R0000XXX R1234BCD Vehículos especiales 5 E0000XXX E1234BCD 18.09.2000 : Ordinarias 0 0000XXX 1234BCD
4.3 Códigos de provincias y de municipios
Véase la url del INE: www.ine.es
Actualmente disponible en:
www.ine.es/jaxi/menu.do?type=pcaxis&path=%2Ft20%2Fe245%2Fcodmun%2F&file=inebase&L=0
4.4 Documentación relacionada
Interfaz ATMV.wsdl: WSDL del Servicio Web de ATMV. Contiene la definición de todos los
parámetros del servicio.
Interfaz ATMV Masiva.wsdl: WSDL del Servicio Web de ATMV. Contiene la definición de todos los
parámetros del servicio de baja masiva.
Manual Usuario WS (ATMV) 16
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
Manual Usuario WS (ATMV) 17
MINISTERIO DEL INTERIOR
DIRECCIÓN GENERAL DE TRÁFICO
GERENCIA DE INFORMÁTICA
4.5 Ejemplos WS
4.5.1 Ejemplo WS de ALTA
Petición WS: EjemplosWS\peticion_alta.doc
Respuesta WS: EjemplosWS\respuesta_alta.doc
4.5.2 Ejemplo WS de ALTA
Petición WS: EjemplosWS\peticion_alta.doc
Respuesta WS: EjemplosWS\respuesta_alta.doc
4.5.3 Ejemplo petición WS de CONSULTA
Petición WS: EjemplosWS\peticion_consulta.doc
Respuesta WS: EjemplosWS\respuesta_consulta.doc
4.5.4 Ejemplo petición WS de BAJA MASIVA
Petición WS: EjemplosWS\peticion_baja_masiva.doc
Respuesta WS: EjemplosWS\respuesta_baja_masiva.doc