Sistema Integral Multicanal de Atención al Ciudadano

Transcripción

1 Sistema Integral Multicanal de Atención al Ciudadano PAI_CONTRATO_INTEGRACION_JUSTICIA_CONS ULTA_INEXISTENCIA_ANTECEDENTES_DELITOS_ SEXUALES_v3_v001 Servicio de Consulta de Inexistencia de Antecedentes DIRECCION GENERAL DE TECNOLOGIAS Versión 001 Marzo de 2016

2 Índice 1. Control del documento Información general Histórico de revisiones Estado del documento Introducción Alcance Objetivos Audiencia Glosario Referencias Descripción del Sistema Proceso de Consulta de Inexistencia de Antecedentes Penales por Delitos Sexuales Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales a través de petición WebService Datos de Acceso a la Plataforma de Interoperabilidad para el Servicio de Consulta de Inexistencia de Antecedentes Penales por Delitos Sexuales Intercambio de mensajes Interfaz proporcionada por la Plataforma de Interoperabilidad para el Servicio de Consulta de Inexistencia de Antecedentes Penales por Delitos Sexuales Protocolo Síncrono Protocolo Asíncrono Servicio de Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales Mensaje de Petición al Servicio de Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales Formato de los Datos de la Petición al Servicio de Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales Mensaje de Respuesta al Servicio de Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales Formato de los Datos de la Respuesta del Servicio de Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales Datos Específicos Formato Datos Específicos Peticiones Asíncronas Mensaje de Petición Asíncrona Mensaje de Confirmación de Petición Formato del Mensaje de Confirmación de Petición Mensaje de Solicitud de Respuesta Formato del Mensaje de Solicitud de Respuesta Mensaje de Respuesta Asíncrona SoapFaults Mensaje de SoapFault Formato del Mensaje de SoapFault Esquemas de Validación del servicio Respuestas de negocio devueltas por el servicio / 53

3 3.5 Errores devueltos por la plataforma mediante el esquema SOAP FAULT Estructura de los mensajes SOAP firmados ANEXO I. DETALLE Y RESTRICCIONES DE LA CONSULTA DE INEXISTENCIA DE ANTECEDENTES PENALES POR DELITOS SEXUALES ANEXO II. EJEMPLOS de peticiones / 53

4 1. Control del documento 1.1 Información general Título Creado por DGTIC Contrato de Integración para Servicio de Consulta de Inexistencia de Antecedentes Revisado por Lista de distribución Nombre del fichero PAI_CONTRATO_INTEGRACION_JUSTICIA_CONSULTA_INEXISTENCIA_A NTECEDENTES_DELITOS_SEXUALES_v3_v Histórico de revisiones Versió n 0 01/03/2016 Fecha Autor Observaciones Ministerio de Hacienda y AAPP Documentación original, se toma como base del presente documento el documento creado por el Ministerio de Justicia:DI_Justicia_Consulta_Inexistencia_Antecedentes_ Penales_Delitos_SexualesV1.7 Adaptación de la documentación original al formato de la DGTIC. Modificaciones en el apartado Descripción del Sistema con información adicional referente a la PAI Eliminación de referencias al sistema SVD que no tienen relevancia en el ámbito de la PAI. Cambios en las url de los servicios para reflejar las ofrecidas por la PAI 1 15/03/2016 DGTIC En el apartado de errores del sistema se sustituye Contacte con el CAID por Reporte la incidencia Se eliminan los ejemplos de peticiones y respuestas firmadas con formatos distintos a WS-Security En el apartado de esquemas se separa en dos tablas, una para el Modelo Síncrono y otra para el Modelo Asíncrono para una mayor claridad en las direcciones URL de los ficheros. Se ha modificado el nombre del documento, modificado la tabla 'errores devueltos por la plataforma', modificado el wsdl y cambiadas las referencias a las urls de producción y preproducción. 1.3 Estado del documento Responsable aprobación Fecha 4 / 53

5 5 / 53

6 2. Introducción El presente documento es una adaptación de la documentación original creada por el Ministerio de Hacienda y administraciones Publicas al ámbito y formato la Plataforma Autonómica de Interoperabilidad (a partir de ahora PAI), creada y gestionada por la DGTIC, en él se particulariza el uso a través de la PAI del Servicio de Consulta de Inexistencia de Antecedentes Penales por Delitos Sexuales del Ministerio de Justicia. La PAI actuará como intermediario para el consumo del servicio proporcionado por la Plataforma de Intermediación desarrollada por el Ministerio de Hacienda y Administraciones Públicas (MINHAP) Para consumir adecuadamente el servicio que a continuación presentamos a través de la PAI se debe tener presente el manual de usuario para el consumo de servicios de verificación de la GVA. 2.1 Alcance Este documento tiene un enfoque técnico y describe lo que hace el servicio y como consumir el mismo. Detalla que parámetros espera y que parámetros o excepciones de error devuelve. 2.2 Objetivos El objetivo principal del contrato de integración es permitir conocer la definición de la estructura de invocación al Servicio de Consulta de Inexistencia de Antecedentes Penales por Delitos Sexuales. Ministerio de Justicia. De este modo el usuario final podrá realizar el consumo del servicio web correctamente. 2.3 Audiencia Nombre y Apellidos Rol Tabla 1: Audiencia 2.4 Glosario Intermediador Término Definición Sistema informático que hace de intermediación entre el consumo directo de un webservice, que es el que ofrece en última (a efectos del intermediador) instancia la funcionalidad, y el consumidor del servicio. Tabla 2: Glosario 2.5 Referencias Referencia Título 6 / 53

7 Tabla 3: Referencias 7 / 53

8 3. Descripción del Sistema En la política de hacer más sencilla la relación del ciudadano con la Administración General del Estado, la Ley 30/1992, de 26 de noviembre, de Régimen Jurídico de las Administraciones Públicas y del Procedimiento Administrativo Común establece, en su artículo 35.f) el derecho del ciudadano a no presentar aquellos documentos «que ya se encuentren en poder de la Administración actuante». Igualmente, en el artículo 6 de la Ley 11/2007, de 22 de Junio, de Acceso Electrónico de los ciudadanos a los Servicios Públicos, LAECSP, se reconoce el derecho a no aportar los datos y documentos que obren en poder de las Administraciones Públicas, las cuales utilizarán medios electrónicos para recabar dicha información siempre que, en el caso de datos de carácter personal, se cuente con el consentimiento de los interesados. El Servicio de verificación de datos, permite que cualquier organismo de la Administración, pueda verificar dichos datos, sin necesidad de solicitar la aportación de los correspondientes documentos acreditativos, permitiendo así hacer efectiva esta supresión. La Plataforma de Intermediación de Servicios del Estado, (PID), permite intermediar cualquier tipo de certificado emitido por los Organismos Estatales que sea necesario dentro de cualquier procedimiento de tramitación que requiera de dicha información. Dicha plataforma hace uso de la infraestructura existente del Servicio de Verificación de Datos (SVD) para reaprovechar todas las características de estabilidad, monitorización y disponibilidad de la misma. Paralelamente, en el ámbito de la Comunidad Valenciana, existe la Plataforma Autonómica de Interoperabilidad de la Comunidad Valenciana, PAI, que actuará de nodo de interoperabilidad entre la PID y los organismos gestores de la Administración Autonómica y Local en la Comunidad Valenciana, susceptibles de proporcionar algún tipo de trámite administrativo a los ciudadanos. En el presente documento se trata el Servicio de Consulta de Inexistencia de Antecedentes Penales por Delitos Sexuales, que será el encargado consultar los datos de Inexistencia de Antecedentes Penales por Delitos Sexuales de un ciudadano. El servicio de consulta de datos de Inexistencia de Antecedentes Penales por Delitos Sexuales (SVDDELSEXWS01) permite obtener si existe una posible coincidencia en el Registro Central de Penados (en el Registro Central de Delincuentes Sexuales a partir de la entrada en vigor del Real Decreto 1110/2015, de 11 de Diciembre) del ciudadano objeto de la consulta. Los datos de los distintos certificados serán proporcionados por el Ministerio de Justicia. 8 / 53

9 3.1 Proceso de Consulta de Inexistencia de Antecedentes Penales por Delitos Sexuales La Plataforma de Interoperabilidad será la responsable de consultar los servicios del Ministerio de Justicia para obtener los datos correspondientes. Las aplicaciones externas que deseen consultar estos servicios, lo harán a través de la Plataforma de Interoperabilidad. Ésta será la responsable de la identificación y autenticación de usuarios, así como del tratamiento de los mensajes intercambiados con los servicio publicados por el Ministerio de Justicia Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales a través de petición WebService Los usuarios (Aplicaciones Externas) podrán acceder a los distintos servicios a través de los WebService expuestos por la Plataforma de Interoperabilidad. Para ello, las unidades gestoras enviarán a dicho WebService una petición firmada con un certificado reconocido. El sistema autorizará la consulta en caso de que la aplicación que realiza la consulta tenga el permiso necesario. Una vez autorizada la operación, se enrutará la petición del usuario al Servicio del Ministerio de Justicia para obtener los datos requeridos Recibida la respuesta con los datos de la consulta, y tras realizar el tratamiento correspondiente, ésta será enviada a la aplicación externa. La PAI utilizará WS-Security como tipo de firma en la respuesta dada al usuario. Todas las operaciones realizadas quedarán registradas, con la consiguiente firma electrónica y sellado de tiempo, sin almacenar en ningún momento los datos de carácter personal intercambiados en la lógica de negocio. En los siguientes puntos, se especifican los mensajes que se intercambian en las comunicaciones establecidas durante la consulta. 9 / 53

10 3.2 Datos de Acceso a la Plataforma de Interoperabilidad para el Servicio de Consulta de Inexistencia de Antecedentes Penales por Delitos Sexuales A continuación se detallan los datos de acceso al servicio de Consulta de Inexistencia de Antecedentes Penales por Delitos Sexuales Datos de Acceso al Servicio de consulta de Inexistencia de Antecedentes Penales por Delitos Sexuales Endpoint Pre Producción Síncrono Endpoint Pre Producción Asíncrono Endpoint Producción Síncrono Endpoint Producción Asíncrono SoapAction Petición Síncrona SoapAction Petición Asíncrona SoapAction Solicitud de Respuesta Código de Certificado Versión SCSP Tipo de Firma admitida Respuesta Cifrada wsdl peticionsincrona peticionasincrona solicitudrespuesta SVDDELSEXWS01 V3 WS-Security NO Tabla 4.- Datos de acceso al servicio 10 / 53

11 3.3 Intercambio de mensajes Todos los mensajes intercambiados deben firmarse y para ello es necesario disponer de un certificado digital que sea reconocido por la PAI y la PID (@firma). El intercambio de mensajes entre los clientes que deseen utilizar este servicio y la Plataforma de Interoperabilidad, se realizará mediante protocolo SCSP Versión 3. La especificación del protocolo SCSP V3 se encuentra disponible en el Portal web de Administración Electrónica ( dependiente del Ministerio de Hacienda y Administraciones Públicas, y dentro de este en el área de descargas. Las peticiones realizadas a la plataforma de Interoperabilidad para obtener información acerca de este servicio se pueden llevar a cabo a través de dos tipos de comunicaciones: Comunicación síncrona en la cual, un cliente realiza una petición al servicio deseado y permanece a la espera de la respuesta. En el modo síncrono no se aceptan ni soportan múltiples solicitudes aunque el esquema de SCSP V3 permita el envío de varias solicitudes en una única petición, el modelo de petición síncrono sólo admitirá una única solicitud de información dentro de cada petición recibida. El intercambio de mensajes será el siguiente. Figura 1. Esquema comunicaciones peticiones síncronas 11 / 53

12 Comunicación asíncrona en la cual, el cliente podrá realizar una petición con múltiples (1 o más) solicitudes, sin necesidad de permanecer a la escucha de la respuesta con el socket abierto. El intercambio de mensajes será el siguiente: Figura 2. Esquema comunicaciones peticiones asíncronas Los mensajes de petición y respuesta de las comunicaciones síncronas y asíncronas siguen el mismo esquema de validación. Sin embargo para las comunicaciones asíncronas se han definido dos nuevos mensajes a intercambiar: Mensaje de Confirmación de Petición y Mensaje de Solicitud de Respuesta. 12 / 53

13 Sexuales Interfaz proporcionada por la Plataforma de Interoperabilidad para el Servicio de Consulta de Inexistencia de Antecedentes Penales por Delitos A continuación se introduce el WSDL que describe los servicios de red como un conjunto de puntos finales que operan sobre mensajes que contienen información orientada a documentos o a procesos Protocolo Síncrono Este servicio contiene la operación peticionsincrona. El tipo de transporte para la operación es SOAP. El valor que tome la variable servidor de conexión dependerá del entorno sobre el que se realice la petición: Preproducción: Producción: <?xml version="1.0" encoding="utf-8"?> <WL5G3N0:definitions targetnamespace=" xmlns:wl5g3n0=" xmlns:wl5g3n1=" xmlns:wl5g3n2=" xmlns:wl5g3n3=" xmlns:wl5g3n4=" xmlns:wl5g3n5=" <WL5G3N0:types> <xsd:schema xmlns=" xmlns:con- Pet=" xmlns:desp=" xmlns:ds=" xmlns:http=" xmlns:mime=" xmlns:pet=" xmlns:resp=" xmlns:sf=" xmlns:soap=" xmlns:soapenc=" xmlns:solr=" xmlns:wsdl=" 13 / 53

14 xmlns:xs=" xmlns:xsd=" <xsd:import namespace=" schemaloca- tion=" tossexuales_v3_00?schema/pai_bus_ver/justicia/inexistenciaantecedentesdeli- tossexuales/sincrona/wsdl/datos-especificos"/> <xsd:import namespace=" schemalocation=" <xsd:import namespace=" schemalocation=" <xsd:import namespace=" schemalocation=" </xsd:schema> </WL5G3N0:types> <WL5G3N0:message name="peticionmessage"> <WL5G3N0:part element="wl5g3n1:peticion" name="peticion"/> </WL5G3N0:message> <WL5G3N0:message name="respuestamessage"> <WL5G3N0:part element="wl5g3n2:respuesta" name="respuesta"/> </WL5G3N0:message> <WL5G3N0:message name="faultscsp"> <WL5G3N0:part element="wl5g3n3:atributos" name="fault"/> </WL5G3N0:message> <WL5G3N0:portType name="peticionporttype"> <WL5G3N0:operation name="peticionsincrona"> <WL5G3N0:input message="wl5g3n4:peticionmessage"/> <WL5G3N0:output message="wl5g3n4:respuestamessage"/> <WL5G3N0:fault message="wl5g3n4:faultscsp" name="faultscsp"/> </WL5G3N0:operation> </WL5G3N0:portType> <WL5G3N0:binding name="justiciainexistenciadelitossexualesbinding" type="wl5g3n4:peticionporttype"> <WL5G3N5:binding style="document" transport=" <WL5G3N0:operation name="peticionsincrona"> <WL5G3N5:operation soapaction="peticionsincrona" style="document"/> <WL5G3N0:input> <WL5G3N5:body use="literal"/> </WL5G3N0:input> <WL5G3N0:output> <WL5G3N5:body use="literal"/> </WL5G3N0:output> <WL5G3N0:fault name="faultscsp"> <WL5G3N5:fault name="faultscsp" use="literal"/> </WL5G3N0:fault> 14 / 53

15 </WL5G3N0:operation> </WL5G3N0:binding> <WL5G3N0:service name="justiciainexistenciadelitossexualesbindingqsservice"> <WL5G3N0:documentation>OSB Service</WL5G3N0:documentation> <WL5G3N0:port binding="wl5g3n4:justiciainexistenciadelitossexualesbinding" name="justiciainexistenciadelitossexualesbindingqsport"> <WL5G3N5:address location=" </WL5G3N0:port> </WL5G3N0:service> </WL5G3N0:definitions> Figura 3. WSDL del servicio síncrono Protocolo Asíncrono Este servicio contiene dos operaciones operación peticionasincrona y solicitudrespuesta. El tipo de transporte para la operación es SOAP. El valor que tome la variable servidor de conexión dependerá del entorno sobre el que se realice la petición: Preproducción: Producción: <?xml version="1.0" encoding="utf-8"?> <WL5G3N0:definitions targetnamespace=" xmlns:wl5g3n0=" xmlns:wl5g3n1=" xmlns:wl5g3n2=" xmlns:wl5g3n3=" xmlns:wl5g3n4=" xmlns:wl5g3n5=" xmlns:wl5g3n6=" xmlns:wl5g3n7=" <WL5G3N0:types> <xsd:schema xmlns=" xmlns:con- Pet=" xmlns:desp=" xmlns:ds=" xmlns:http=" xmlns:mime=" xmlns:pet=" xmlns:resp=" xmlns:sf=" 15 / 53

16 xmlns:soap=" xmlns:soapenc=" coding/" xmlns:solr=" xmlns:wsdl=" /ws dl" xmlns:xs=" xmlns:xsd=" <xsd:import namespace=" schemalocation=" <xsd:import namespace=" schemalocation=" <xsd:import namespace=" schemalocation=" <xsd:import namespace=" schemalocation=" <xsd:import namespace=" schemalocation=" SCHEMA/pai_bus_ver/JUSTICIA/inexistenciaantecedentesdelitossexuales/asincrona/wsdl/confirmacion-peticion"/> <xsd:import namespace=" schemalocation=" </xsd:schema> </WL5G3N0:types> <WL5G3N0:message name="peticionmessage"> <WL5G3N0:part element="wl5g3n1:peticion" name="peticion"/> </WL5G3N0:message> <WL5G3N0:message name="respuestamessage"> <WL5G3N0:part element="wl5g3n2:respuesta" name="respuesta"/> </WL5G3N0:message> <WL5G3N0:message name="solicitudrespuesta"> <WL5G3N0:part element="wl5g3n3:solicitudrespuesta" name="solicitudrespuesta"/> </WL5G3N0:message> <WL5G3N0:message name="confirmacionpeticion"> <WL5G3N0:part element="wl5g3n4:confirmacionpeticion" name="confirmacionpeticion"/> </WL5G3N0:message> <WL5G3N0:message name="faultscsp"> <WL5G3N0:part element="wl5g3n5:atributos" name="fault"/> 16 / 53

17 </WL5G3N0:message> <WL5G3N0:portType name="peticionporttype"> <WL5G3N0:operation name="peticionasincrona"> <WL5G3N0:input message="wl5g3n6:peticionmessage"/> <WL5G3N0:output message="wl5g3n6:confirmacionpeticion"/> <WL5G3N0:fault message="wl5g3n6:faultscsp" name="faultscsp"/> </WL5G3N0:operation> <WL5G3N0:operation name="solicitudrespuesta"> <WL5G3N0:input message="wl5g3n6:solicitudrespuesta"/> <WL5G3N0:output message="wl5g3n6:respuestamessage"/> <WL5G3N0:fault message="wl5g3n6:faultscsp" name="faultscsp"/> </WL5G3N0:operation> </WL5G3N0:portType> <WL5G3N0:binding name="justiciainexistenciadelitossexualesasincronabinding" type="wl5g3n6:peticionporttype"> <WL5G3N7:binding style="document" transport=" <WL5G3N0:operation name="peticionasincrona"> <WL5G3N7:operation soapaction="peticionasincrona" style="document"/> <WL5G3N0:input> <WL5G3N7:body use="literal"/> </WL5G3N0:input> <WL5G3N0:output> <WL5G3N7:body use="literal"/> </WL5G3N0:output> <WL5G3N0:fault name="faultscsp"> <WL5G3N7:fault name="faultscsp" use="literal"/> </WL5G3N0:fault> </WL5G3N0:operation> <WL5G3N0:operation name="solicitudrespuesta"> <WL5G3N7:operation soapaction="solicitudrespuesta" style="document"/> <WL5G3N0:input> <WL5G3N7:body use="literal"/> </WL5G3N0:input> <WL5G3N0:output> <WL5G3N7:body use="literal"/> </WL5G3N0:output> <WL5G3N0:fault name="faultscsp"> <WL5G3N7:fault name="faultscsp" use="literal"/> </WL5G3N0:fault> </WL5G3N0:operation> </WL5G3N0:binding> <WL5G3N0:service name="justiciainexistenciadelitossexualesasincronabindingqsservice"> <WL5G3N0:documentation>OSB Service</WL5G3N0:documentation> <WL5G3N0:port binding="wl5g3n6:justiciainexistenciadelitossexualesasincronabinding" name="justiciainexistenciadelitossexualesasincronabindingqs- Port"> <WL5G3N7:address location=" > </WL5G3N0:port> </WL5G3N0:service> </WL5G3N0:definitions> 17 / 53

18 Figura 4. WSDL del servicio asíncrono Servicio de Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales Mensaje de Petición al Servicio de Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales A continuación se recoge el esquema de validación del mensaje de petición que debe recibir el servicio web de Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales. Como se aprecia en la Figura 5. Diagrama del mensaje de petición del Servicio, la petición estará formada por dos ramas de información, la rama definida como Atributos y, la de Solicitudes. La rama Atributos, contiene los datos de control relativos a toda la petición y, la rama Solicitudes contiene la información concreta de la petición realizada. La rama Transmisiones contiene información con: DatosGenericos que siguen el esquema especificado en el proyecto de Sustitución de Certificado en Soporte Papel, el cual recoge todas las consideraciones legales a tener en cuenta en la transmisión de datos entre Administraciones. DatosEspecificos, contendrá todos los datos de la petición dada por el Ministerio de Justicia. El detalle de esta rama se ve en el apartado Datos Específicos. A continuación se define el significado de las distintas etiquetas utilizadas sobre la definición del esquema de petición: 18 / 53

19 Figura 5. Diagrama del mensaje de petición del Servicio 19 / 53

20 Figura 6. Diagrama de la rama de DatosGenericos del mensaje de petición del Servicio Formato de los Datos de la Petición al Servicio de Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales En la siguiente tabla se resume el tipo de dato y la información que contienen cada uno de los campos del mensaje de petición. Ubicación Nombre Tipo Etiqueta Obligatoria Campo Obligatorio Descripción Petición Atributos BLOQUE Sí No procede Peticion /Atributos IdPeticion String(26) Sí Sí Bloque Único Contiene los datos de control, relativos a toda la petición (n solicitudes). Identificador de petición único en el sistema El sistema no validará si el número de peticiones recibidas es correlativo, solo la unicidad del ID de petición. Peticion /Atributos NumElementos Int Sí Sí Se aconseja el siguiente formato: número de serie del certificado X509v3 + identificador secuencial por organismo. Número de elementos de la petición. Sobre la rama SolicitudTransmision, se pueden incluir varias solicitudes en una misma petición al sistema, este campo contendrá el número de solicitudes realizadas en la petición Peticion /Atributos TimeStamp String(29) Sí Sí En el caso de peticiones síncronas el valor de este nodo debe ser 1. Fecha y hora del envío del mensaje. Formato: Peticion /Atributos Estado BLOQUE No No procede Bloque único AAAA-MM- DDThh:mm:ss.mmm hh:mm 20 / 53

21 Peticion/Atributos/Estado CodigoEstado String(4) No No Peticion/Atributos/Estado CodigoEstadoSecundario String(16) No No Peticion/Atributos/Estado LiteralError String(255) No No Peticion/Atributos/Estado TiempoEstimadoRespuesta Int No No Peticion /Atributos CodigoCertificado String(64) Si Si Peticion Solicitudes BLOQUE Si No procede Peticion /Solicitudes SolicitudTransmision BLOQUE Sí No procede Peticion /Solicitudes /SolicitudTransmision Peticion /Solicitudes DatosGenericos Peticion /Solicitudes DatosGenericos/ Emisor Peticion /Solicitudes DatosGenericos/ Emisor DatosGenericos BLOQUE Sí No procede Emisor BLOQUE Sí No procede NifEmisor String(10) Sí Sí Contiene información sobre el estado de la petición. Código identificativo del estado En el mensaje de Petición no tiene relevancia. Código de error secundario En el mensaje de Petición no tiene relevancia. Texto del error En el mensaje de Petición no tiene relevancia Tiempo estimado de respuesta Se trata de una etiqueta opcional y su valor no es relevante en las Peticiones. Código del certificado del servicio que se solicita en la petición El mismo valor que va en la parte de Datos Genéricos de la solicitud. Lo define cada emisor, y un mismo organismo emisor no puede tener dos iguales. SVDDELSEXWS01 Bloque único Engloba la lista de solicitudes de transmisión que se envían. Bloque que se repite de 1 a n veces. Contiene los datos relativos a una solicitud de transmisión. Bloque único Contiene los datos genéricos sobre una transmisión. Bloque único Contiene datos del organismo emisor que ofrece el servicio. Al recibir la petición el sistema comprobará que el NIF del Emisor es correcto. Nif del Emisor El valor que debe tomar esta variable para este servicio es: S A NombreEmisor String(50) Sí Sí Nombre o razón social del emisor El valor que debe tomar esta 21 / 53

22 variable para este servicio es: Ministerio de Justicia. Peticion /Solicitudes DatosGenericos Peticion /Solicitudes DatosGenericos/ Solicitante Peticion /Solicitudes DatosGenericos/ Solicitante Peticion /Solicitudes DatosGenericos/ Solicitante Peticion /Solicitudes DatosGenericos/ Solicitante Peticion /Solicitudes DatosGenericos/ Solicitante/ Procedimiento Peticion /Solicitudes DatosGenericos/ Solicitante/ Procedimiento Peticion /Solicitudes DatosGenericos/ Solicitante Solicitante BLOQUE Sí No procede Bloque único Contiene datos del organismo al que pertenece la persona o aplicación que solicita los datos. IdentificadorSolicitante String(10) Sí Sí NIF del organismo NombreSolicitante String(50) Sí Sí UnidadTramitadora String(250) No Sí Procedimiento BLOQUE Si No procede CodProcedimiento String(20) Si Si NombreProcedimiento String(100) Si Si Finalidad String(250) Sí Sí Nombre o razón social del organismo Nombre de la Unidad Tramitadora que realiza la petición Bloque único Contiene datos del procedimiento que autoriza la consulta. Código del Procedimiento que autoriza al usuario a realizar la consulta Nombre del Procedimiento que autoriza al usuario a realizar la consulta Contiene el motivo o causa por la que se necesita realizar la consulta de los datos. Peticion /Solicitudes DatosGenericos/ Solicitante Peticion /Solicitudes DatosGenericos/ Solicitante Peticion /Solicitudes DatosGenericos/ Solicitante/ Funcionario Peticion /Solicitudes DatosGenericos/ Solicitante/ Funcionario Consentimiento String (3) Sí Sí Funcionario BLOQUE Si No procede NombreCompletoFuncionario String(122) Si Si NifFuncionario String(10) Si Si Los valores admitidos son: Si Ley Este BLOQUE contendrá información relativa al empleado público que realiza la solicitud. Etiqueta que contiene el nombre completo del empleado público que realiza la solicitud. Etiqueta que contiene el NIF del empleado público que realiza la solicitud. Peticion /Solicitudes IdExpediente String(25) No Si Identificador del 22 / 53

23 Expediente que justifica la consulta. DatosGenericos/ Solicitante Peticion /Solicitudes DatosGenericos Peticion /Solicitudes DatosGenericos/Titular Titular BLOQUE Sí No procede TipoDocumentacion String Si Sí Bloque único Contiene datos del ciudadano sobre el que se va a realizar la consulta. Los valores posibles son: NIF NIE Pasaporte Número de documento según el TipoDocumentacion. Este campo contiene el número de documento del ciudadano del que se quiere consultar sus datos, según se trate de un ciudadano español o extranjero. La codificación de este campo es la siguiente: Peticion /Solicitudes DatosGenericos/Titular Documentación String(14) Si Si NIF (ciudadano español): 8 dígitos + Carácter Control. NIE (ciudadano extranjero): [X,Y,Z] + 7 dígitos + Carácter Control. Pasaporte. Aquellos NIFs y NIEs que tengan menos de 8 dígitos deberán ser rellenados con 0 s por la izquierda (Respetando la letra inicial de los NIE s) Peticion /Solicitudes DatosGenericos/Titular NombreCompleto String(122) No Sí Nombre completo del titular de la solicitud. Peticion /Solicitudes DatosGenericos/Titular Peticion /Solicitudes DatosGenericos/Titular Peticion /Solicitudes Nombre String(40) Si Sí Apellido1 String(40) Si Sí Nombre del titular de la solicitud. Primer Apellido del titular de la solicitud. Apellido2 String(40) No Sí Segundo Apellido del 23 / 53

24 DatosGenericos/Titular titular de la solicitud. Peticion /Solicitudes DatosGenericos/ Peticion /Solicitudes DatosGenericos/ Transmision Peticion /Solicitudes DatosGenericos/ Transmision Peticion /Solicitudes DatosGenericos/ Transmision Peticion /Solicitudes DatosGenericos/ Transmision Peticion/ Transmisiones / TransmisionDatos/ Transmision BLOQUE Sí No procede CodigoCertificado String(64) Sí Sí IdSolicitud String(40) Sí Sí IdTransmision String(29) No Sí FechaGeneracion String(29) No Sí DatosEspecificos BLOQUE Si No procede Si la nacionalidad es española, el segundo apellido es obligatorio. Bloque único. Contiene los datos del certificado que se va a solicitar. El código del certificado al que se accede. El mismo valor que va en el nodo Atributos. Lo define cada emisor, y un mismo organismo emisor no puede tener dos iguales. Para este servicio el código es: SVDDELSEXWS01 Identificador de la solicitud Único para el organismo solicitante. En el caso de las peticiones asíncronas con múltiples solicitudes, identifica cada una de las solicitudes individuales que van englobadas en la petición. Identificador de la transmisión Único para el organismo solicitante. Fecha y hora de la generación de la transmisión. Formato: AAAA-MM- DDThh:mm:ss.mmm hh:mm Bloque único Contiene los datos de transmisión que se solicita al organismo emisor y que tienen relación específica con el certificado que se está solicitando. La rama de Datos Específicos estará formada por dos subramas: Consulta y Retorno. Para comprender en detalle ambas ramas véanse los puntos Datos Específicos y Formato Datos Específicos 24 / 53

25 Mensaje de Respuesta al Servicio de Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales A continuación se recoge el mensaje de respuesta que debe devolver el servicio Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales. Como se aprecia en la Figura 7. Diagrama del mensaje de respuesta del Servicio. La respuesta estará formada por dos ramas de información, la rama definida como Atributos, y la de Transmisiones. La rama Atributos contiene los datos de control relativos a toda la respuesta y la codificación de la respuesta obtenida. La rama Transmisiones contiene información con: DatosGenericos que siguen el esquema especificado en el proyecto de Sustitución de Certificado en Soporte Papel, el cual recoge todas las consideraciones legales a tener en cuenta en la transmisión de datos entre Administraciones. DatosEspecificos, contendrá todos los datos de la respuesta dada por el Ministerio de Justicia e información de errores cuando aplique. En el caso de las multipeticiones (peticiones asíncronas con múltiples solicitudes), se especificará en esta rama el resultado individual de cada consulta perteneciente a la multipetición. El detalle de esta rama se ve en el siguiente apartado. 25 / 53

26 Figura 7. Diagrama del mensaje de respuesta del Servicio 26 / 53

27 Figura 8. Diagrama de la rama DatosGenericos del mensaje de respuesta del Servicio Formato de los Datos de la Respuesta del Servicio de Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales En la siguiente tabla se resume el tipo de dato y la información que contienen cada uno de los campos del mensaje de respuesta del servicio. Ubicación Nombre Tipo Etiqueta Obligatoria Campo Obligatorio Descripción Respuesta Atributos BLOQUE Sí No procede Atributos IdPeticion String(26) Sí Sí Atributos NumElementos Int Sí Sí Bloque Único Contiene los datos de control, relativos a toda la petición (n solicitudes). Identificador de petición único en el sistema Esta etiqueta contiene el mismo valor que el introducido sobre la etiqueta IdPetición del mensaje de petición. Número de elementos de la petición Sobre la rama SolicitudTransmision, se pueden incluir varias solicitudes en una misma petición al sistema, este campo contendrá el número de solicitudes realizadas en una petición concreta. Para una petición síncrona este valor siempre debe ser 1. Para una petición asíncrona el máximo valor permitido para este campo es Atributos TimeStamp String(29) Sí Sí Fecha y hora del envío del mensaje Formato: AAAA-MM- DDThh:mm:ss.mmm h 27 / 53

28 h:mm Atributos Respuesta /Atributos/Estado Respuesta /Atributos/Estado Respuesta /Atributos/Estado Respuesta /Atributos/Estado Estado BLOQUE No No procede CodigoEstado String(4) No No CodigoEstadoSecundario String(16) No No LiteralError String(255) No No TiempoEstimadoRespuest a Int No No Bloque único Contiene información sobre el estado de la petición. Código identificativos del estado de la petición En el caso de las peticiones síncronas contendrá siempre el valor En el caso de las asíncronas contendrá el valor 0003 si la respuesta ya está disponible o bien el valor 0002, en caso de que la respuesta aún no esté disponible, caso en el que en la respuesta no habrá transmisiones y se devolverá un nuevo TER (Tiempo Estimado de Respuesta). Código de error secundario, para incorporar códigos de error internos de los sistemas. Descripción del estado de la petición. En el caso de las peticiones síncronas contendrá siempre el valor TRAMITADA. En el caso de las asíncronas contendrá el valor TRAMITADA si la respuesta ya está disponible o bien el valor EN PROCESO, en caso de que la respuesta aún no esté disponible caso en el que en la respuesta no habrá transmisiones y se devolverá un nuevo TER (Tiempo Estimado de Respuesta). Tiempo estimado de respuesta. Su valor no es relevante cuando la comunicación es síncrona 28 / 53

29 Atributos CodigoCertificado String(64) Si Si Respuesta Transmisiones BLOQUE Si No procede Respuesta /Solicitudes Peticion /Solicitudes /SolicitudTransmision Transmisiones / TransmisionDatos/Dat osgenericos Transmisiones / TransmisionDatos/Dat osgenericos/ Emisor Transmisiones / TransmisionDatos/Dat osgenericos/ Emisor Transmisiones / TransmisionDatos/Dat osgenericos Transmisiones / TransmisionDatos/Dat osgenericos/ Solicitante Transmisiones / TransmisionDatos/Dat TransmisionDatos BLOQUE Sí No procede DatosGenericos BLOQUE Sí No procede Emisor BLOQUE Sí No procede NifEmisor String(10) Sí Sí NombreEmisor String(50) Sí Sí Solicitante BLOQUE Sí No procede IdentificadorSolicitante String(10) Sí Sí Código del certificado del servicio que se solicita en la petición. El mismo valor que va en la parte de Datos Genéricos de la solicitud. Lo define cada emisor, y un mismo organismo emisor no puede tener dos iguales. El campo contendrá el valor: SVDDELSEXWS01 Bloque único que engloba la lista de transmisiones de datos que se envían. Bloque que se repite de 1 a n veces Contiene los datos relativos a una transmisión de datos. Bloque único Contiene los datos genéricos sobre una transmisión. Bloque único Contiene datos del emisor del servicio. Al recibir la petición externa el sistema comprobará que el NIF es correcto. Nif del Emisor El valor que debe tomar esta variable para este servicio es: S A Nombre o razón social El valor que debe tomar esta variable para este servicio es: Ministerio de Justicia. Bloque único Contiene datos del solicitante de la transmisión. CIF del Organismo al que pertenece la persona o aplicación que solicita los datos. NombreSolicitante String(50) Sí sí Organismo al que pertenece la persona o aplicación que 29 / 53

30 osgenericos/ Solicitante solicita los datos. Transmisiones/ TransmisionDatos / DatosGenericos/ Solicitante Transmisiones/ TransmisionDatos / DatosGenericos/ Solicitante Transmisiones/ TransmisionDatos / DatosGenericos/ Solicitante Transmisiones/ TransmisionDatos / DatosGenericos/ Solicitante Transmisiones / TransmisionDatos/Dat osgenericos/ Solicitante Transmisiones / TransmisionDatos/Dat osgenericos/ Solicitante Transmisiones / TransmisionDatos/Dat osgenericos/ Solicitante Transmisiones / TransmisionDatos/Dat osgenericos/ Solicitante/ Funcionario Transmisiones / TransmisionDatos/Dat osgenericos/ Solicitante/ Funcionario Peticion /Solicitudes DatosGenericos/ Solicitante UnidadTramitadora String(250) No Si Procedimiento BLOQUE Si No procede CodProcedimiento String(20) Si Si NombreProcedimiento String(100) Si Si Finalidad String(250) Sí Sí Consentimiento String (3) Sí Sí Funcionario BLOQUE Sí No procede NombreCompletoFuncion ario String(122) Sí Sí NifFuncionario String(10) Sí Sí IdExpediente String(25) No Sí Unidad Tramitadora a la que pertenece la persona o aplicación que solicita los datos. Bloque único Contiene datos del procedimiento en base al cual se autoriza la consulta. Código del Procedimiento en base al cual se autoriza la consulta. Nombre del Procedimiento en base al cual se autoriza la consulta. Contiene el motivo o causa por la que se necesita realizar la consulta de datos. Los valores posibles son: - Si - Ley Este BLOQUE contendrá información relativa al empleado público que realiza la solicitud. Nombre completo del empleado público que realiza la solicitud. NIF del empleado público que realiza la solicitud. Bloque único Contiene el identificador del expediente para el que es necesario realizar la consulta. 30 / 53

31 Transmisiones / TransmisionDatos/Dat osgenericos Transmisiones / TransmisionDatos/Dat osgenericos/titular Titular BLOQUE Sí No procede TipoDocumentacion String Sí Sí Bloque único. Contiene datos del ciudadano cuya información se desea consultar. Los valores posibles son único valor posible es: NIF NIE Pasaporte Número de documento según el TipoDocumentacion. Transmisiones / TransmisionDatos/Dat osgenericos/titular Documentación String(14) Si Si Este campo contiene el número de documento del ciudadano del que se han consultado los datos, según se trate de un ciudadano español o extranjero. La codificación de este campo es la siguiente: Transmisiones / TransmisionDatos/Dat osgenericos/titular Transmisiones / TransmisionDatos/Dat osgenericos/titular Transmisiones / TransmisionDatos/Dat osgenericos/titular Transmisiones / TransmisionDatos/Dat osgenericos/titular Transmisiones / TransmisionDatos/Dat NombreCompleto String(122) No Sí Nombre String(40) No Sí Apellido1 String(40) No Sí Apellido2 String(40) No Sí DNI (ciudadano español): 8 dígitos + Carácter Control. NIE (ciudadano extranjero): [X,Y,Z] + 7 dígitos + Carácter Control. Pasaporte Nombre completo del titular de la solicitud Nombre del titular de la solicitud. Primer Apellido del titular de la solicitud Segundo Apellido del titular de la solicitud Transmision BLOQUE Sí No procede Bloque único Contiene los datos del certificado que 31 / 53

32 osgenericos/ Transmisiones / TransmisionDatos/Dat osgenericos/ Transmision Transmisiones / TransmisionDatos/Dat osgenericos/ Transmision Transmisiones / TransmisionDatos/Dat osgenericos/ Transmision Transmisiones / TransmisionDatos/Dat osgenericos/ Transmision Transmisiones / TransmisionDatos/ CodigoCertificado String(64) Sí Sí IdSolicitud String(40) Sí Sí IdTransmision String(29) Si Sí FechaGeneracion String(29) Si Sí DatosEspecificos BLOQUE Si No procede solicitado. Código del certificado solicitado. El mismo valor que va en la parte de Atributos de la solicitud. Lo define cada emisor, y un mismo organismo emisor no puede tener dos iguales. El campo contendrá el valor: SVDDELSEXWS01 Identificador de la solicitud, único para el organismo solicitante. En el caso de las Multipeticiones (peticiones asíncronas con múltiples solicitudes), identifica cada una de las solicitudes individuales que van englobadas en la petición Código de la transmisión, único para el organismo emisor. Fecha y hora de la generación del certificado Formato: AAAA-MM- DDThh:mm:ss.mmm h h:mm Bloque único Contiene los datos de transmisión que se responden desde el organismo emisor y que tienen relación específica con el certificado que se está solicitando. En un mensaje de respuesta del proceso de Consulta, la rama de Datos Específicos estará formada por subramas: Para comprender en detalle las ramas véanse los puntos Datos Específicos y Formato Datos Específicos. 32 / 53

33 33 / 53

34 Datos Específicos A continuación se recoge el diagrama del esquema de validación de los DatosEspecificos de la Petición y Respuesta al usuario. 34 / 53

35 Figura 9. Diagrama de Datos Específicos de Respuesta del Servicio Formato Datos Específicos En la siguiente tabla se resume el tipo de dato y la información que contienen cada uno de los campos del mensaje de datos específicos. Ubicación Nombre Tipo Etiquet a obligat oria DatosEspecificos DatosEspecificos/Cons ulta Consulta Nacionalidad BLOQ UE String( 3) Si Si Campo obligat orio No procede Si Bloque único Descripción Contiene información sobre el mediador para el que se va a realizar la consulta. Código de la Nacionalidad Contiene la Nacionalidad del ciudadano del que realizaremos la consulta. La codificación corresponde a la norma ISO NUMERICO. Ante un ciudadano con doble nacionalidad puede especificarse cualquiera de las nacionalidades del ciudadano. DatosEspecificos/Cons ulta DatosEspecificos/Cons ulta Sexo NombrePadre String( 1) String( 100) No No Si Si Sexo Sexo correspondiente al ciudadano del que se realiza la consulta los valores posibles son: H (Hombre) M (Mujer) Nombre del Padre Nombre del Padre del Ciudadano objeto de la consulta. El campo será obligatorio para ciudadanos con Nacionalidad Española y siempre que no se incluya el campo NombreMadre Nombre de la Madre DatosEspecificos/Cons ulta NombreMadre String( 100) No Si Nombre de la Madre del Ciudadano objeto de la consulta. El campo será obligatorio para ciudadanos con Nacionalidad Española y si no se incluye el NombrePadre DatosEspecificos/Cons ulta PaisNacimiento String( 3) Si Si Código del País de Nacimiento Contiene el País de Nacimiento del ciudadano del que realizaremos la consulta. 35 / 53

36 La codificación corresponde a la norma ISO NUMERICO. Código de la Provincia de Nacimiento DatosEspecificos/Cons ulta ProvinciaNacimi ento String( 2) No Si Contiene la Provincia de Nacimiento del Ciudadano objeto de la consulta. La codificación será la utilizada por INE. El campo es obligatorio para ciudadanos nacidos en España Código de la Población de Nacimiento DatosEspecificos/Cons ulta CodPoblacionN acimiento String( 5) No Si Contiene la Población de Nacimiento del Ciudadano objeto de la consulta. La codificación será la utilizada por INE. El campo es obligatorio para ciudadanos nacidos en España DatosEspecificos/Cons ulta DatosEspecificos/Cons ulta PoblaciónNacim iento FechaNacimient o String( 100) String( 10) No Sí Si Si Población de Nacimiento Contiene la descripción de la Población de Nacimiento El campo es obligatorio para ciudadanos nacidos en el Extranjero Fecha de Nacimiento Fecha de Nacimiento del ciudadano objeto de la consulta. Debe venir en el formato DD/MM/AAAA admitiéndose los formatos: 00/MM/AAAA Para el caso de no conocer el día de nacimiento 00/00/AAAA Para el caso de no conocer ni día ni mes de nacimiento 00/00/0000 Para el caso de no conocer ni día ni mes ni año de nacimiento No se permiten consultas de años anteriores a 1920 y tampoco consultas de menores de edad DatosEspecificos/Cons ulta Mail String( 100) No Si del titular consultado Teléfono del titular consultado DatosEspecificos/Cons ulta Teléfono String( 15) No Si El teléfono tendrá los siguientes formatos: / 53

37 DatosEspecificos Retorno BLOQ UE Sí No procede Bloque único Contiene la información de respuesta para una consulta realizada. DatosEspecificos/Reto rno Estado BLOQ UE Sí No procede Bloque único Contiene información del estado de la respuesta obtenida. DatosEspecificos/Reto rno / Estado CodigoEstado String( 1) Sí Si Código de estado o error Véase Tabla 8.- Códigos de error SCSP DatosEspecificos/Reto rno / Estado LiteralError String( 255) Si Si Descripción de estado de la respuesta Véase Tabla 8.- Códigos de error SCSP DatosEspecificos/Reto rno CSV String( 22) No Si Código Seguro de Verificación DatosEspecificos/Reto rno URL String No Si URL Donde se verificará el CSV anteriormente devuelto Peticiones Asíncronas A continuación se define el intercambio de mensajes para una petición a través de una comunicación asíncrona Mensaje de Petición Asíncrona El mensaje de petición seguirá las especificaciones definidas para el servicio creado, véase el punto Mensaje de Petición al Servicio de Consulta de Datos de Inexistencia de Antecedentes Penales por Delitos Sexuales Mensaje de Confirmación de Petición 37 / 53

38 Figura 10. Diagrama del mensaje de Confirmacion de Peticion del Servicio Formato del Mensaje de Confirmación de Petición En la siguiente tabla se resume el tipo de dato y la información que contienen cada uno de los campos del mensaje de Confirmación de Petición. Ubicación Nombre Tipo Etiqueta Obligatoria Campo Obligatorio Descripción ConfirmacionPeticio n ConfirmacionPeticio n /Atributos Atributos BLOQUE Sí No procede Bloque Único. Contiene los datos de control, relativos a toda la petición (n solicitudes). IdPeticion String(26) Sí Sí Identificador de petición único en el sistema. Cada petición que se recibe debe llevar un número único en el sistema, este número 38 / 53