Sede Electrónica del Automóvil - Colegio Oficial de Gestores
Contents
1. 1 1 Sobre el Documento El presente documento contiene las especificaciones t cnicas del servicio web SEA EITV de la Sede Electr nica del Autom vil En concreto esta especificaci n es la expresi n de m s bajo nivel de las funcionalidades requeridas del servicio web SEA ElTV y est enfocada principalmente a las Plataformas inform ticas de los Gestores Administrativos y Colegios Profesionales de Gestores Administrativos Este documento corresponde a la versi n 5 7 1 de la Sede Electr nica del Autom vil puesta en producci n el d a 15 de julio de 2015 1 2 Objetivo La ficha t cnica electr nica o tarjeta ElTV es un documento electr nico emitido por los fabricantes de veh culos autom viles o los importadores o sus representantes legales o por las autoridades competentes en inspecci n t cnica de veh culos en las Comunidades Aut nomas y que acredita las caracter sticas t cnicas de los autom viles fabricados as como el historial de sus inspecciones t cnicas o de sus modificaciones introducidas a lo largo de su vida til El objetivo del sistema SEA EITV Sede Electr nica del Autom vil Inspecci n T cnica de Veh culos Electr nica es permitir a las Plataformas de los Gestores Administrativos obtener de manera telem tica informaci n sobre tarjetas de Inspecci n T cnica de Veh culo electr nicas registradas en el Registro de Veh culos Prematriculados de la DGT Direcci n General de Tr fico O 20132. Gestores 1880 SAU P gina 3 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 1 3 Alcance SEA EITV es un servicio web destinado a recibir y procesar consultas de datos EITV enviadas por las Plataformas Inform ticas de los Gestores Administrativos Primero la Plataforma del Gestor env a la consulta de los datos de una tarjeta EITV al servicio SEA EITV En la consulta se indican entre otros datos el n mero de bastidor del veh culo VIN y el identificador del veh culo proporcionado por la DGT NIVE Una vez recibida SEA ElTV valida el contenido y formato de la consulta y la transfiere a la DGT Si la consulta puede efectuarse correctamente SEA ETIV devuelve los datos de la tarjeta EITV a la Plataforma cliente En caso de que se produzcan incidencias el servicio SEA ElTV devuelve una lista con los errores producidos y su descripci n A continuaci n se listan las principales funcionalidades que ofrece el servicio web SEA EITV 1 Recepci n y tramitaci n de consultas de datos ElTV registradas en el Registro de Veh culos Prematriculados de la DGT 2 Validaci n de consultas de datos El TV y comunicaci n de los posibles errores 3 Entrega de datos El TV en formato XML seg n especificaciones de la DGT 4 Entrega de datos El TV en formato PDF O 2013 Gestores 1880 SAU P gina 4 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 1 4 Acr nimos DGT Direcc
3. indican las entidades emisoras admitidas Firmaprofesional Camerfirma FNMT F brica Nacional de Moneda y Timbre ACCV Autoritat de Certificaci de la Comunitat Valenciana o A OO N Izenpe 2 5 3 Firma Digital Cuando sea requerida la firma digital de mensajes y documentos se realizar seg n el est ndar XADES versi n ETSI TS 101 903 v1 3 2 2 5 4 Acceso al Servicio El servicio web SEA EITV dispone de un entorno de pruebas y de un entorno de producci n Seguidamente se detallan los accesos a los dos entornos Acceso al Entorno de Producci n El servicio web est disponible en la siguiente URL pendiente de confirmar El documento WSDL est publicado en la siguiente URL pendiente de confirmar O 2013 Gestores 1880 SAU P gina 14 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 Acceso al Entorno de Pruebas El servicio web en entorno de pruebas est disponible de lunes a viernes de 9 00h a 14 00h El servicio web est disponible en la siguiente URL pendiente de confirmar El documento WSDL est publicado en la siguiente URL pendiente de confirmar O 2013 Gestores 1880 SAU P gina 15 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 3 Anexo Descripci n de los Errores A continuaci n se listan los c digos y mensajes que devuelve el servicio web SEA EITV en caso de error C digo EITV00000
4. la validaci n sea positiva el sistema devuelve el resultado de la consulta con los datos de la tarjeta EITV El m todo getDataElTV satisface la primitiva de transmisi n Request Response por lo que se establece un mensaje de entrada y uno de salida A continuaci n se detallan los dos mensajes y sus par metros O 2013 Gestores 1880 SAU P gina 9 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 Request Message Nombre EITVQueryWS_getDataElTV Objetivo Recibir la consulta de ficha t cnica electr nica firmada por el Gestor Lista de Par metros Par metro 1 agencyFiscalld 2 agentFiscalld 3 customDossierNumber 4 externalSystemFiscalld 5 nive 6 vin 7 xmlB64 Tipo string string string string string string string Descripci n CIF de la Gestor a del Gestor que realiza la consulta CIF del Gestor que realiza la consulta N mero de expediente en la Plataforma cliente CIF de la Plataforma que realiza la conexi n a SEA Identificador del veh culo proporcionado por la DGT NIVE El NIVE es opcional en tal caso debe informase en blanco N mero de bastidor del veh culo Documento XML codificado en Base64 con los datos la consulta de tarjeta EITV firmados con el certificado del Gestor En el anexo Formato de la Consulta de Tarjeta EITV se detalla toda la informaci n relativa a la estructura y formato de los campos que debe cumplir el documento XML con
5. los datos de la consulta 2013 Gestores 1880 SAU P gina 10 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 Response Message Nombre EITVQueryWS_getDataElTVResponse Objetivo Entregar la respuesta de la consulta de tarjeta EITV Indicar los errores producidos Lista de Par metros Par metro Tipo 1 codeHG string 2 dossierNumbe string 3 errorCodes eitvQueryError 4 xmldata string 5 ficha string Descripci n C digo de homologaci n de Gestor N mero que identifica el tr mite dentro en SEA Lista de los errores producidos en el env o de la consulta de tarjeta EITV Para cada error producido se indica su c digo y descripci n Se trata de un elemento opcional que aparecer tantas veces como errores se hayan producido En el Anexo Descripci n de los Errores se muestra la lista de errores posibles con su c digo y descripci n Documento XML codificado en base64 con el resultado de la consulta de tarjeta EITV En el Manual de usuario del servicio de consulta datos de tarjeta EITV de la DGT ver referencia n 2 en apartado Referencias se describe el formato de la respuesta de la consulta de tarjeta EITV Documento PDF codificado en base64 con el resumen de los datos de la consulta EITV El PDF contiene el CSV del documento para poder verificar su autenticidad en la Sede Electr nica del Autom vil O 2013 Gestores 1880 SAU P gina 11 de 19 Sede Electr nic
6. lt xs element lt xs element lt xs element lt xs sequence gt lt xs complexType gt lt xs element gt lt xs element name Firma_ lt xs sequence gt lt xs complexType gt lt xs element gt lt xs schema gt Firmados gt name AGENT_DOI type xs string gt name AGENCY_DOI type xs string gt name VIN type xs string gt name NIVE type xs string gt name TEXTO_LEGAL type xs string gt Gestor type xs base64Binary gt 2013 Gestores 1880 SAU P gina 19 de 19
7. 15 2 4 Descripci n de los Usuarios El servicio web SEA EITV cuenta con un nico tipo de usuario la Plataforma del Gestor Administrativo A continuaci n se detalla el usuario Plataforma 2 4 1 La Plataforma La Plataforma del Gestor o Plataforma Cliente es el nico tipo de usuario que interacciona con los servicios web de la Sede La Plataformas son sistemas inform ticos que dan soporte al Gestor Administrativo en materia de tramitaci n de expedientes de tr fico El Gestor a trav s de su Plataforma env a solicitudes e inicia tr mites en la Sede Electr nica del Autom vil Seg n los designios del Gestor la Plataforma se comunica con uno de los cuatro servicios de la Sede consulta de tarjetas El TV matr cula telem tica cambio de titularidad telem tico y autorizaci n provisional de circulaci n O 2013 Gestores 1880 SAU P gina 13 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 2 5 Entorno Operacional A continuaci n se especifica el entorno operacional del servicio web SEA ElTV protocolo de comunicaci n firma y certificado digital y acceso al servicio 2 5 1 Protocolo de Comunicaci n El servicio web SEA EITV utiliza el protocolo SOAP 1 1 sobre HTTP SSL TLS y est especificado mediante un documento WSDL 2 5 2 Certificado Digital Se requiere operar con un certificado digital reconocido a nombre del Gestor solicitante Plataforma cliente A continuaci n se
8. 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 2 2 Descripci n de los M todos A continuaci n se resumen los servicios disponibles y las operaciones m todos asociados Las secciones de este cap tulo detallan el funcionamiento de cada m todo as como sus par metros de entrada y salida Servicio M todo Descripci n Asociado Consulta getDataElTV Informa sobre los datos de una ficha t cnica electr nica a partir del n mero de de tarjeta bastidor del veh culo VIN y opcionalmente el identificador del veh culo EITV proporcionado por la DGT NIVE El identificador NIVE es opcional en la consulta de datos EITV As mismo el NIVE siempre se informa en los datos t cnicos devueltos en la consulta 2 2 1 M todo getDataElTV El m todo getDataElTV permite realizar consultar datos de tarjetas ElTV registradas en el Registro de Veh culos Prematriculados de la DGT a partir n mero de bastidor del veh culo VIN y opcionalmente el identificador del veh culo proporcionado por la DGT NIVE A continuaci n se describe el flujo de trabajo asociado al m todo getDataElTV 1 Recepci n de la consulta de tarjeta EITV 2 Validaci n de la firma del Gestor 3 Validaci n del formato y contenido de la consulta 4 En caso de que la validaci n sea negativa el sistema devuelve la lista con los errores producidos y su descripci n ver Anexo Descripci n de los Errores 5 En caso de que
9. EITV00001 EITV00101 EITV00102 EITV00103 EITV00120 EITV00121 EITV00111 EITV00112 EITV00114 EITV00115 EITV00117 EITV00118 EITV00122 EITV00123 EITV00333 Descripci n EITV Consulta No disponible Error t cnico al crear la request Error al validar XML con esquema No se encuentra el Sistema Externo con el NIF CIF facilitado No se encuentra el Cliente con los datos facilitados El DOI del gestor en la request no corresponde con el del XML El DOI de la gestoria en la request no corresponde con la del XML Respuesta de DGT vac a Respuesta de DGT err nea El elemento FIRMA para la firma del gestor no existe o est vac o La firma del gestor no es valida La firma del gestor no es un documento XML El elemento CONTENT de la firma del gestor no existe o esta vac o Firma del gestor no valida los datos firmados no corresponden con la solicitud El titular del certificado no se corresponde con el del gestor Error gen rico en la validaci n O 2013 Gestores 1880 SAU P gina 16 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 4 Anexo Formato de la Consulta de Tarjeta EITV La consulta de datos de tarjeta ElTV es el par metro de entrada principal del m todo getDataElTV del servicio web SEA ElTV La consulta se transmite mediante un documento XML cuya estructura y formato de campos se especifican mediante un esquema XSD ver Anexo Esquema XSD Consulta de Tarjeta ElTV El o
10. Gestores 1880 SAU Sede Electr nica del Autom vil Consulta de datos EITV Proyecto Sede Electr nica del Autom vil SEA Contenido Consulta de datos ElTV Identificador SEA19202412 Versi n v5 Creaci n del Documento Pere Mil 17 jun 2015 13 21 ltima Modificaci n Pere Mil 01 jul 2015 15 34 Exportaci n a PDF Pere Mil 01 jul 2015 15 34 PI Urquinaona 6 Planta 16 08010 Barcelona Tel 933 436 668 Fax 933 437 984 info gaa9 com Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 NDICE 1 Introducci n 3 1 1 Sobre el Documento 3 1 2 Objetivo 3 1 3 Alcance 4 1 4 Acr nimos 5 1 5 Referencias 6 1 6 Estructura del Documento 7 2 Descripci n del Servicio 8 2 1 Visi n General 8 2 2 Descripci n de los M todos 9 2 3 Consideraciones y Restricciones 12 2 4 Descripci n de los Usuarios 13 2 5 Entorno Operacional 14 Anexo Descripci n de los Errores 16 4 Anexo Formato de la Consulta de Tarjeta ElTV 17 4 1 Descripci n de Tipos Primitivos 17 4 2 Solicitud de Emisi n Elemento Ra z 18 5 Anexo Esquema XSD Consulta de Tarjeta EITV 19 O 2013 Gestores 1880 SAU P gina 2 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 1 Introducci n Este cap tulo ofrece una visi n general del documento de especificaci n t cnica del servicio web SEA ElTV de la Sede Electr nica del Autom vil
11. a del Autom vil Consulta de datos EITV v5 01 jul 2015 2 3 Consideraciones y Restricciones A continuaci n se indican las pre condiciones restricciones y dem s consideraciones que deben tenerse cuenta antes de utilizar el servicio SEA EITV 2 3 1 Consideraciones DGT La Unida de Ordenaci n Normativa de la Direcci n General de Tr fico establece las directivas restricciones y condiciones que debe satisfacer la consulta de tarjetas ElTV La mayor a de estas consideraciones est n descritas en el Manual de usuario del servicio de consulta datos de tarjeta EITV de la DGT ver referencia n 2 en apartado Referencias No obstante la Direcci n General de Tr fico puede comunicar por otros canales dem s consideraciones no incluidas en los manuales aqu citados A Con el objetivo agilizar y asegurar la comunicaci n entre las Plataformas cliente y los servicios de la Sede Electr nica del Autom vil es deber de las Plataformas conocer en detalle las consideraciones t cnicas y funcionales establecidas por la Unida de Ordenaci n Normativa de la Direcci n General de Tr fico as como adecuar sus sistemas inform ticos conforme a lo establecido La Sede Electr nica del Autom vil transmitir a las Plataformas Cliente los manuales y dem s consideraciones que reciba de la Direcci n General de Tr fico O 2013 Gestores 1880 SAU P gina 12 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 20
12. bjetivo de esta secci n es ayudar en la comprensi n del esquema XSD y facilitar el dise o de consultas de tarjeta EITV en formato XML esperado O E esquema en formato XSD se puede consultar en el Anexo Esquema XSD Consulta de Tarjeta EITV 4 1 Descripci n de Tipos Primitivos A continuaci n se describe mediante ejemplos la gram tica utilizada para especificar los tipos b sicos de la consulta de tarjeta EITV Ejemplo Descripci n Muestra Num ricos integer 5 N mero entero de exactamente 5 d gitos 00025 integer 1 60 N mero entero comprendido entre 1 y 60 ambos 60 incluidos integer 6 N mero entero positivo incluye el cero de exactamente 6 03923 d gitos decimal 4 N mero decimal de exactamente 4 d gitos 04 50 decimal 6 2 N mero decimal positivo incluye el cero de exactamente 0014 10 6 d gitos de los cuales como m ximo dos se destinan a expresar la parte fraccionaria decimal lt 999 99 N mero decimal positivo incluye el cero menor que 0 001 999 99 Alfanum ricos char Cadena de caracteres de exactamente 1 car cter a char 6 Cadena de caracteres de exactamente 6 caracteres AB3420 string Texto de longitud ilimitada Texto de ejemplo string 12 Texto de longitud m xima 12 caracteres Ana Garc a 2013 Gestores 1880 SAU P gina 17 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 4 2 Solicitud de Emisi n Elemento Ra z El elemento ra z de la
13. consulta de datos de tarjeta ElTV est formada por una serie de elementos que agrupan conjuntos de datos relacionados A continuaci n se describen los elementos de la ra z lt ConsultaTarjeta gt y sus sub elementos Elemento Obl Tipo Descripci n Datos xX complexType Datos de la consulta de datos de tarjeta EITV Firmados DOI x string NIF CIF o NIE del Gestor Gestor DOI Xx string NIF CIF o NIE de la Gestor a Gestor a VIN Xx string 17 N mero de bastidor del veh culo NIVE x string 32 Identificador del veh culo proporcionado por la DGT El NIVE es opcional en tal caso debe informase en blanco Texto x string Texto legal prefijado por el Consejo General Legal Firma xX base64Binary Firma de los datos de la consulta de datos de tarjeta EITV realizada Gestor mediante el certificado digital del Gestor y codificada en Base64 A Importante Firma Gestor La firma debe ser generada previa visualizaci n y aceptaci n del Gestor de los datos que firma 2013 Gestores 1880 SAU P gina 18 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 5 Anexo Esquema XSD Consulta de Tarjeta EITV lt xml version 1 0 encoding UTF 8 7 gt lt xs schema xmlns xs http www w3 org 2001 XMLSchema gt lt xs element name ConsultaTarjeta gt lt xs complexType gt lt xs sequence gt lt xs element name Datos_ lt xs complexType gt lt xs sequence gt lt xs element lt xs element
14. de la Sede Electr nica del Autom vil El objetivo es proporcionar un marco descriptivo t cnico y detallado que ayude a los sistemas cliente a comunicarse con la Sede y a utilizar sus servicios 2 1 Visi n General El servicio de consulta de tarjetas ElTV se enmarca en el sistema de informaci n formado por las Plataformas cliente de los Gestores la Sede Electr nica del Autom vil y la Direcci n General de Tr fico A continuaci n se describe el proceso t pico de consulta de tarjetas EITV y se ilustra el papel que juega la Sede en l 1 El Gestor ordena a su Plataforma el env o de la consulta tarjetas El TV a la Sede Electr nica del Autom vil 2 La Plataforma efect a el env o de la consulta a la Sede 3 La Sede valida la firma digital del Gestor y verifica el formato y contenido de la consulta recibida Si la consulta est en orden la Sede transfiere la consulta a la Direcci n General de Tr fico 4 Finalmente la Sede devuelve el resultado de la consulta con los datos de la tarjeta EITV indicada A La consulta de tarjetas ElTV debe entregarse firmada digitalmente con el certificado digital del Gestor Gestor Administrativo El sistema SEA verifica las firma del Gestor y valida el formato y contenido de la consulta recibida 4 Gesti n de expedientes de tr fico c w 2 Consulta tarjeta el TV Tramitaci n Plataforma 4 Env o datos tarjeta el TV O 2013 Gestores 1880 SAU P gina 8 de
15. i n General de Tr fico EITV Tarjeta de Inspecci n T cnica de Veh culos Electr nica HTTP Hypertext Transfer Protocol NIVE N mero de Identificaci n del Veh culo SEA Sede Electr nica del Autom vil SSL Secure Sockets Layer SOAP Simple Object Access Protocol TSL Transport Layer Security URL Uniform Resource Locator VIN Vehicle Identification Number WSDL Web Services Description Language XML Extensible Markup Language O 2013 Gestores 1880 SAU P gina 5 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 1 5 Referencias A continuaci n se citan las referencias y documentos relacionados con el el servicio web SEA ElTV 1 Documento de requisitos de usuario de la Sede Electr nica del Autom vil Fichero Autor Identificador Versi n Fecha Descripci n RA SEA Documento de Requisitos de Usuario paf Gestores 1880 SAU SEA8063147 221 28 may 2013 16 15 Especificaci n de requisitos de usuario de la Sede Electr nica del Autom vil Es la expresi n de m s alto nivel de las funcionalidades requeridas del sistema y est enfocada principalmente al colectivo de Gestores Administrativos a los Colegios Profesionales de Gestores y al Consejo General de Colegios de Gestores de Espa a 2 Manual de usuario del servicio de consulta datos de tarjeta El TV de la DGT Fichero Autor Identificador Versi n Fecha Descripci n DGT EITV Manual de Usuario 1 2 paf Gerencia Inform t
16. ica de la Direcci n General de Tr fico ND 1 2 19 de octubre de 2010 Manual de usuario que describe las funcionalidades de la aplicaci n EITV de la Direcci n General de Tr fico dise ada para dar cumplimiento a la Orden Ministerial TC 2536 2006 de 26 de julio por la que se autoriza la emisi n y transmisi n telem tica de la tarjeta ITV electr nica O 2013 Gestores 1880 SAU P gina 6 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 1 6 Estructura del Documento El resto del documento esta dividido en los cap tulos siguientes Descripci n del Servicio y Anexo Descripci n de los Errores El cap tulo Descripci n del Servicio ofrece la especificaci n t cnica del servicio web SEA EITV En el anexo Descripci n de los Errores se listan los c digos y mensajes de error que pueden producirse en las llamadas a los distintos m todos del servicio web SEA ElITV En el anexo Formato de la Consulta de Tarjeta EITV se detalla toda la informaci n relativa a la estructura y formato de los campos que debe cumplir el documento XML con los datos de la consulta de tarjeta EITV El anexo Esquema XSD Consulta de Tarjeta ElTV contiene el esquema XSD de la consulta de datos de tarjeta EITV O 2013 Gestores 1880 SAU P gina 7 de 19 Sede Electr nica del Autom vil Consulta de datos EITV v5 01 jul 2015 2 Descripci n del Servicio El presente cap tulo describe el servicio web SEA ElTV
Download Pdf Manuals
Related Search