SGNTJ. LexNET. Guía de uso de los Web Services de integración. (profesionales) SGNTJ - LexNET

(1)

SGNTJ

LexNET

Guía de uso de los Web Services de integración

(profesionales)

(2)

(3)

CONTROL DE VERSIONES

Versión Fecha Descripción del cambio

Versión 1.0 27/11/2007 S.G. de Nuevas Tecnologías

Versión 1.1 14/12/2007 Modificación de WS Schema

Versión 1.2 11/01/2008 Modificación de WS Schema

Versión 1.3 24/03/2008 Modificación del servicio ObtenerCabeceras

Versión 1.4 23/04/2008 Añadido nuevo servicio web LoginServicios

Versión 1.5 21/01/08 Modificación del servicio ObtenerCabeceras

Versión 1.6 23/09/09 Añadidos servicios Repartir, Asumir, ObtenerAceptados y ObtenerProcuradores. Además se ha modificado el servicio ObtenerMensaje

Versión 1.7 27/01/2010 Modificación del elemento profesional para que incluya el código de colegiado.

Versión 1.8 20/04/2010 Añadidos servicios ObtenerPendientesRepartir y ObtenerCabecerasPendientesRepartir. Además se ha modificado el servicio ObtenerCabeceras

Versión 1.9 29/12/2010 Añadidos servicios web de EnvioAcusesSGP, ObtenerAvisos. Modificación de servicios: ObtenerCabeceras, ObtenerCabecerasPendientesRepartir, ObtenerMensaje y ObtenerProcuradores. Se ha actualizado el schema de los XML de petición y respuesta.

Versión 3.0 31/08/2011 Se han añadido los servicios web ObtenerPendientesRepartirOtros, ObtenerCabecerasPendientesRepartirOtros,

, BuscarMensajesAuditorias,

BuscarInformeAuditoria. Asimismo, se han modificado los servicios ObtenerCabeceras y ObtenerCabecerasPendientesRepartir incluyendo fechaInicio y fechaFin y el servicio ObtenerProcuradores, incluyendo el idSujeto

Versión 3.0_v2

26/09/2011 Se modifica la descripción de los parámetros fecha,fechaInicio,fechaFin del ws ObtenerAceptados (la descripción incluida en la versión anterior era errónea)

Versión 3.0_v3

03/10/2011 Se introducen correcciones en la descripción de los servicios y en algunas etiquetas de los mensajes de petición/respuesta

(4)

Versión 3.0_v4

09/01/2012 Se incluye el apartado Ejemplo de uso e invocación de los Servicios Web LexNET

Versión 3.0_v5

27/01/2012 Se añade explicación a parámetros de EnviarMensaje

Versión 3.0_v6

18/01/2012 Se añade el servicio web ObtenerHistoricoMensaje

Versión 3.0_v7

26/04/2012 Se añade el envio de mensajes con firma CAdES

Versión 3.0_v8

29/06/2012 Se añade explicación de formato de mensaje MIME/CAdES y parámetro de envio CAdES en EnviarVerificacionLecturaGeneral

Versión 3.0_v9

28/09/2012 Se añade al ws EnviarMensaje descripción relativa a la posibilidad de envío de copias a profesionales

Versión 3.0_v10

01/10/2012 Se añade los es obtenerCabecerasPendientesAsumir y ObtenerPendientesAsumir

Versión 3.0_v11

08/11/2012 Se añade explicación adicional a ObtenerCabeceras

Versión 3.0_v12

10/12/2012 Se añade explicación adicional a ObtenerCabecerasPendientesAsumir

Versión 3.0_v13

03/01/2013 Se añaden ws ObtenerRoles, ConfigRolPorDefecto

Versión 3.0_v13

08/03/2013 Se añaden parámetros de entrada a ObtenerCabeceras

Versión 3.0_v14

16/04/2013 Se añaden parámetros de entrada a EnviarMensaje para envío de escritos de subsanación

Versión 3.0_v15

26/07/2013 Se modifica respuesta de ObtenerMensaje, Se añade nuevos servicios web SolicitudLoginToken, LoginToken, EnviarMensajeToken, EnviarVerificacionLecturaToken y EnviarBloqueToken. Se añade explicación de uso de los servicios web; se distribuyen los servicios por tipología; se añaden anexos en este documento. Se añade explicación uso distintas modalidades de servicios web. Se añade a los SW ObtenerDestinatarios la posibilidad de filtrado de destinatarios por tipo de mensaje. Se añaden rutas a los WSDL de los servicios web

Versión 3.0_v15_2

26/07/2013 Se corrige errata en la documentación de los SW EnviarMensajeToken, EnviarVerificacionLecturaToken y EnviarBloqueToken , ObtenerMensaje (campo observaciones)

(5)

ÍNDICE

ÍNDICE ... 5

1. INTRODUCCIÓN... 9

2. ARQUITECTURAS para invocación A LOS SERVICIOS WEB DE LEXNET ... 11

2.1. Arquitectura de interconexión desde cliente (certificado de usuario) ... 11

2.1.1. Conexión con LexNET ... 11

2.1.2. Ejemplo de uso e invocación de los servicios web LexNET ... 12

2.2. Arquitectura de interconexión desde servidor (certificado de servidor/aplicación) ... 21

2.2.1. Conexión con LexNET ... 21

2.2.2. Ejemplo de uso e invocación de los servicios web LexNET ... 22

3. DESCRIPCIÓN DE LOS SERVICIOS WEB LEXNET ... 30

3.1. De uso general (conexión con certificado de usuario o de aplicación) ... 30

3.1.1. Respuesta de error ... 31 3.1.2. LogOut ... 33 3.1.3. ObtenerRoles ... 35 3.1.4. ConfigRolPorDefecto ... 39 3.1.5. ObtenerDestinatarios ... 43 3.1.6. ObtenerTiposProcedimiento ... 50

(6)

3.1.7. ObtenerPendientes ... 55 3.1.8. ObtenerCabeceras ... 59 3.1.9. ObtenerMensaje ... 71 3.1.10. ObtenerBloque ... 81 3.1.11. TerminarDescarga ... 85 3.1.12. ObtenerHistoricoMensaje ... 88 3.1.13. ObtenerAvisos ... 99

3.2. Exclusivos para conexión con certificado de usuario ...103

3.2.1. Login ...103

3.2.2. EnviarMensaje ...108

3.2.3. EnviarBloque ...119

3.2.4. EnviarVerificacionLectura ...123

3.3. Exclusivos para conexión con certificado de aplicación ...128

3.3.1. SolicitudLoginToken ...129

3.3.2. LoginToken ...132

3.3.3. EnviarMensajeToken ...136

3.3.4. EnviarVerificacionLecturaToken ...148

3.3.5. EnviarBloqueToken ...153

3.4. De uso por Colegios de Procuradores (conexión con certificado de usuario o de aplicación) ...159

(7)

3.4.2. ObtenerCabecerasPendientesRepartir ...166 3.4.3. ObtenerCabecerasPendientesRepartirOtros ...176 3.4.4. ObtenerPendientesRepartir ...187 3.4.5. ObtenerPendientesRepartirOtros ...192 3.4.6. Repartir...197 3.4.7. ObtenerAceptados ...201 3.4.8. ObtenerCabecerasPendientesAsumir ...206 3.4.9. ObtenerPendientesAsumir ...217 3.4.10. Asumir ...221 3.4.11. BuscarMensajesAuditorias ...230 3.4.12. BuscarInformeAuditoria ...238 4. ANEXOS ... 242

4.1. ANEXO I: Códigos usados en los Web Service ...243

4.1.1. Códigos de error devueltos por el servidor ...243

4.1.2. Tipos de perfil de usuario (roles) ...251

4.1.3. Tipos de mensajes (tipoMensaje) ...253

4.1.4. Tipos de entidad (tipoEntidad) ...253

4.1.5. Tipos de SGP (Sistemas de Gestión Procesal) ...254

4.1.6. Tipos de órgano (codtipoOrgano) ...254

4.1.7. Tipos de itineraciones ...257

(8)

4.1.9. Tipos de catálogos ...258

4.1.10. Tipos de orden (idOrden) ...258

4.1.11. Funciones de intervinientes – demandas (idFuncion) ...258

4.1.12. Tipos de materias – demandas (codigoMateria) ...261

4.2. ANEXO II: Recomendaciones para desarrollo de cliente ...280

4.2.1. Descripción ...280

4.2.2. Entorno tecnológico de desarrollo ...283

4.2.3. Requisitos funcionales del cliente...283

4.3. ANEXO III: Guía de cumplimentación de las plantillas de los mensajes de envío ...285

4.3.1. Mensaje formato MIME ...287

4.3.2. Mensaje formato CAdES ...292

4.4. ANEXO V: Tecnologías LexNET. Descripción breve. ...305

4.4.1. Firma electrónica ...305

4.4.2. Plataforma ASF ...307

4.4.3. SMIME ...307

4.4.4. CAdES...309

4.4.5. Sellado de tiempo – TSA del Ministerio de Presidencia ...310

(9)

1. INTRODUCCIÓN

El objeto de este documento es describir las interfaces de Servicios Web dirigidas a profesionales de la plataforma LexNET para que los desarrolladores de aplicaciones puedan integrar y utilizar los servicios ofrecidos por la misma.

Durante la fase de desarrollo, los integradores invocarán los servicios web del entorno de integración del LexNet (https://lexnet3pruebas.justicia.es) y cuya definición WSDL pueden encontrar en https://lexnet3pruebas.justicia.es/services/NombreServicioWeb?wsdl. (Ej: El

WSDL del servicio web de login puede descargarse desde

https://lexnet3pruebas.justicia.es/services/Login?wsdl)

Una vez desarrolladas y antes de su pase a producción, estas aplicaciones habrán tenido que pasar previamente un proceso de homologación de su aplicación en el que se comprobará el funcionamiento adecuado del cliente desarrollado conforme a los requisitos del RD 84/2007 regulador del sistema LexNET. Una vez pasado el proceso de homologación, La Subdirección General de Nuevas Tecnologías de la Justicia asignará un identificador único e intransferible a la aplicación lo que permitirá su intercomunicación con LexNET por servicios web.

Este documento cubre los siguientes aspectos:

Descripción de los distintos tipos de servicios web contemplados en este documento y la arquitectura necesaria para su invocación

(10)

Descripción de la interfaz de Servicios web de la plataforma LexNET mediante la especificación de mensajes XML-SOAP de solicitud y respuesta.

Descripción de ejemplos uso e invocación de los servicios web LexNET para la realización de los procesos principales aportados por el sistema LexNET: envío y descarga de mensajes.

La plataforma LexNET publicará los siguientes Web Services de integración con LexNET: De uso general

De uso por parte de Colegios de Procuradores invocables desde dos tipos de arquitecturas:

Arquitecturas de interconexión desde cliente: SSL con certificado de usuario

Arquitecturas de interconexión desde servidor: SSL con certificado de servidor/aplicación y solicitud de token firmado por el usuario

Todos los servicios web publicados constan de una sola operación. Todas las operaciones reciben como único parámetro de entrada un String con formato XML. Cada servicio publicado dispone de un formato de XML específico que viene definido por el XML Schema de los mensajes a los Web Services. En este Schema se definen todos los mensajes de todos los web services, tanto los de petición, como los de respuesta, incluida la respuesta en caso de error (En el

(11)

apartado 3.1.1 se especifican los códigos de error que devuelven los servicios web, así como su descripción).

2. ARQUITECTURAS PARA INVOCACIÓN A LOS SERVICIOS WEB DE

LEXNET

LexNET posibilita la interconexión e invocación con los servicios web del sistema desde dos arquitecturas que se detallan en los siguientes apartados.

2.1. Arquitectura de interconexión desde cliente (certificado de usuario)

2.1.1. Conexión con LexNET

La primera posibilidad que ofrece LexNET para la invocación de sus servicios web es la interconexión directa desde la ubicación del cliente (usuario). En este tipo de arquitecturas, utilizadas tradicionalmente por aplicaciones de escritorio, es necesario crear en primer lugar un túnel seguro SSL con LexNET utilizando el certificado de usuario. A continuación, LexNET permite iniciar la invocación a sus servicios web, de acuerdo con las funcionalidades requeridas.

(12)

Figura 1 Arquitectura de interconexión cliente-LexNET

2.1.2. Ejemplo de uso e invocación de los servicios web LexNET

El uso de los principales servicios web de LexNET requiere la invocación de los mismos en un orden determinado. A continuación se detalla el proceso de invocación para dos de los procesos más importantes aportados por LexNET, utilizando una arquitectura de invocación desde el cliente con su certificado.

Nota: La descripción detallada de uso e invocación de todos los servicios web ofrecidos por LexNET se encuentra en el apartado 3

2.1.2.1. Autenticación en LexNET y envío de mensajes

El envío de un mensaje a través de LexNET requiere un proceso consistente en los siguientes cinco pasos:

(13)

Figura 2 Proceso envío mensajes

[T1]En primer lugar se realizará un proceso de Autenticación del usuario, en caso de que no se hubiera realizado previamente. Para ello, la aplicación habrá establecido con LexNET una sesión SSL utilizando el certificado digital del usuario. A continuación se realizará una petición al servicio web Login

[T2] A continuación se iniciaría el proceso de envío del mensaje. Esto conlleva la realización de peticiones a los servicios web LexNET y tareas que se detallan a continuación:

(14)

Figura 3 [T2] Envío de mensaje: detalle de peticiones a los ws LexNET

o [T2x] Si la aplicación no había invocado previamente al servicio ObtenerTiposProcedimiento, podría realizarlo para conocer los posibles tipos de procedimiento que podrá enviar como asunto de su mensaje. Se recomienda realizar esta llamada de forma ocasional debido a la carga de datos de este servicio web y a que se trata de una información con pocos cambios a lo largo del tiempo.

(15)

o [T2y] Si la aplicación no había invocado previamente al servicio ObtenerDestinatarios, podría realizarlo para conocer los datos de identificación de los posibles destinatarios de su mensaje. Se recomienda realizar esta llamada de forma ocasional debido a la carga de datos de este servicio web y a que se trata de una información con pocos cambios a lo largo del tiempo. o [T21] La aplicación realizará una petición al servicio web EnviarMensaje donde

detallará los datos previamente solicitados al usuario: destinatario del mensaje, tipo/nº de procedimiento, adjuntos, etc.

o [T22] En respuesta a esta petición, LexNET proporcionará una plantilla de mensaje MIME/CADES (dependiendo del tipo de firma a utilizar).

o [T23] La aplicación deberá cumplimentar la plantilla MIME/CADES obtenida en el paso anterior. Para ello, deberá anexar a la plantilla proporcionada la siguiente información:

Documento principal firmado con el certificado digital del usuario remitente

Documentos adjuntos que el usuario desee enviar (si alguno).

Una vez completada la plantilla de envío (MIME o CADES), la aplicación deberá firmarla con el certificado digital del usuario remitente, generando un documento de envío que remitirá a LexNET.

(16)

o [T24..T24+n] A continuación, el mensaje será enviado a LexNET dividido en n bloques con n llamadas sucesivas al servicio web EnviarBloque.

o [T25..T25+n] En respuesta a cada una de las peticiones a EnviarBloque, LexNET proporcionará una respuesta

o [T26] Una vez obtenidos todos los bloques, LexNET realizará un proceso de sellado de tiempo sobre el mensaje y de firma por parte de LexNET, creando el mensaje final que será enviado al destinatario

o [T27] LexNET proporcionará como respuesta al último bloque el identificador del acuse del envío realizado así como la fecha de sellado del mismo. Este identificador posibilitará la descarga del acuse, en caso deseado.

[T3] A continuación, en caso de que se desee descargar el acuse, el proceso de descarga será similar al proceso de descarga de un mensaje, tal y como se explica en los tiempos [T25] a [T29] del siguiente apartado (Descarga de mensajes).

[T4] La aplicación finalizaría su sesión con LexNET haciendo una invocación al servicio de LogOut.

(17)

La descarga de un mensaje recibido a través de LexNET requiere un proceso consistente en los siguientes tres pasos:

Figura 4 Proceso de descarga de mensajes

[T1]En primer lugar se realizará un proceso de Autenticación del usuario, en caso de que ya no se hubiera realizado previamente. Para ello, la aplicación habrá establecido con LexNET una sesión SSL utilizando el certificado digital del usuario. A continuación se realizará una petición al servicio web Login

(18)

[T2] A continuación se iniciaría el proceso de descarga del mensaje. Esto conlleva la realización de peticiones a los servicios web LexNET y tareas que se detallan a continuación:

(19)

o [T21] En primer lugar, la aplicación realizará una llamada a ObtenerPendientes para conocer los mensajes recibidos nuevos que todavía no se hubiera descargado

o [T22] En respuesta a la petición anterior, LexNET indicará el nº de mensajes cuyo destinatario es el usuario logado que están pendientes de descarga

o [T23] La aplicación podrá solicitar la descarga de la cabecera de los mensajes deseados. Ej: los mensajes pendientes de descarga únicamente o cualquiera que cumpla una serie de condiciones (fecha de envío, etc.)

o [T24] En respuesta, LexNET proporcionará la cabecera de los mensajes solicitados (que cumplen las condiciones indicadas en la petición anterior y cuyo destinatario es el usuario logado).

o [T25] A continuación, la aplicación podrá solicitar la descarga de un mensaje en específico cuyo identificador habrá sido obtenido previamente (Ej: a través ObtenerCabeceras). Para ello, hará una solicitud al servicio web ObtenerMensaje.

Nota: en el caso de aquellos usuarios que requieran la firma de recibí previa a la descarga de su mensaje (Ej: abogados), LexNET requerirá, previa a la solicitud de ObtenerMensaje la invocación de un conjunto de servicios web que

(20)

permitirían el envío del recibí. En este caso, ver la descripción del servicio web EnviarVerificacionLectura.

o [T26] En respuesta, LexNET proporcionará todos los datos del mensaje así como los identificadores de los documentos principal y adjuntos asociados al mensaje, lo que posibilitará su descarga subsiguiente.

o [T27..T27+n] La aplicación podrá solicitar la descarga en bloques de los documentos principal y adjuntos cuyos identificadores fueron obtenidos en el paso anterior. Para ello, se realizará sucesivas llamadas al servicio web ObtenerBloque.

o [T28..T28+n] LexNET proporcionará los bloques de los documentos solicitados.

o [T29] Una vez, descargados todos los bloques del documento principal y de todos los adjuntos, la aplicación realizará una solicitud al servicio web TerminarDescarga, para indicarle a LexNET la finalización del proceso de descarga del mensaje completo.

[T3] La aplicación finalizará su sesión con LexNET haciendo una invocación al servicio de LogOut.

(21)

2.2. Arquitectura de interconexión desde servidor (certificado de

servidor/aplicación)

2.2.1. Conexión con LexNET

La segunda posibilidad de interconexión con LexNET es una arquitectura que posibilita la gestión de las conexiones desde un servidor de aplicaciones, no siendo necesaria la conexión desde la ubicación propia del cliente. Para ello, la aplicación establecerá en primer lugar una conexión SSL con LexNET utilizado el certificado de servidor de la aplicación desarrollada. Posteriormente, LexNET permite iniciar la invocación a sus servicios web, de acuerdo con las funcionalidades requeridas, solicitando el envío de un token firmado por el usuario, de forma periódica y en cada tipo de envío que implique firma del usuario o justificación de interacción del mismo para el intercambio solicitado.

(22)

2.2.2. Ejemplo de uso e invocación de los servicios web LexNET

El uso de los principales servicios web de LexNET requiere la invocación de los mismos en un orden determinado. A continuación se detalla el proceso de invocación para dos de los procesos más importantes aportados por LexNET, utilizando una arquitectura de invocación desde servidor, habiéndose establecido previamente una conexión SSL con LexNET con el certificado de servidor de dicha aplicación.

Nota: La descripción detallada de uso e invocación de todos los servicios web ofrecidos por LexNET se encuentra en el apartado 3

(23)

2.2.2.1. Autenticación en LexNET

La autenticación en LexNET, utilizando una arquitectura de interconexión con certificado de servidor, habiéndose establecido previamente SSL con el certificado de servidor, implica los siguientes pasos:

Invocación a SolicitudLoginToken: la aplicación cliente iniciará la solicitud de login, enviando su identificador de aplicación. LexNET, enviará como respuesta un token Invocación a LoginToken: la aplicación cliente enviará a LexNET el token (remitido por LexNET en respuesta a la petición anterior) firmado con el certificado del usuario conectado.

(24)

Invocación a los servicios web de LexNET: la aplicación cliente invocará a los distintos servicios web ofrecidos por LexNET. Tras un periodo de caducidad, la invocación a cualquiera de los servicios web de LexNET devolverá una respuesta de error 020000013 (error indicativo de token caducado y de necesidad de confirmar la presencia del usuario) junto con un token nuevo que será necesario firmar. La aplicación cliente deberá firmar el nuevo token con el certificado del usuario y enviarlo de nuevo a LexNET.

Invocación a LoginToken: la aplicación cliente enviará a LexNET el token firmado por el usuario.

Invocación a los servicios web de LexNET: la aplicación cliente podrá seguir invocando los servicios web de LexNET

(25)

(26)

2.2.2.2. Envío de mensajes

El envío de mensajes a través de LexNET, utilizando una arquitectura de interconexión con certificado de servidor, implica los siguientes pasos:

Invocación a EnviarMensajeToken: la aplicación cliente solicitará el envío de un mensaje. LexNET devolverá la plantilla de mensaje de envío (SMIME o CADES) junto con un token. La aplicación cliente deberá generar el mensaje de envío, firmado por el usuario y firmar el token remitido.

Invocación a EnviarBloqueToken: la aplicación cliente enviará a LexNET el mensaje, dividido en bloques, a través de invocaciones sucesivas a EnviarBloqueToken. En la primera de las invocaciones (primer bloque), la aplicación cliente remitirá a LexNET el primer bloque de envío del mensaje junto con el token firmado.

(27)

Figura 8 Envío de mensajes (conexión con certificado de servidor)

2.2.2.3. Descarga de mensajes

La descarga de mensajes desde LexNET (ej.: descarga de notificaciones), utilizando una arquitectura de interconexión con certificado de servidor, implica los siguientes pasos:

(28)

Invocación a ObtenerPendientes: la aplicación cliente, solicitará conocer el nº de mensajes recibidos nuevos que todavía no se hubiera descargado

Invocación a ObtenerCabeceras: la aplicación cliente, solicitará la cabecera de los mensajes recibidos

Invocación a EnviarVerificacionLecturaToken (en caso de usuarios que requieran firma de recibí; ej.: abogados, graduados sociales): la aplicación cliente solicitará el envío de un recibí. LexNET devolverá la plantilla de mensaje de envío (SMIME o CADES) junto con un token. La aplicación cliente deberá generar el mensaje de envío (recibí), firmado por el usuario y firmar el token remitido.

Invocación a EnviarBloqueToken: la aplicación cliente enviará a LexNET el recibí, dividido en bloques, a través de invocaciones sucesivas a EnviarBloqueToken. En la primera de las invocaciones (primer bloque), la aplicación cliente remitirá a LexNET el primer bloque de envío del mensaje junto con el token firmado.

Invocación a ObtenerMensaje: la aplicación cliente solicitará la descarga del mensaje Invocación a ObtenerBloque: la aplicación cliente solicitará la descarga en bloques de los documentos principal y adjuntos del mensaje. Los identificadores de dichos documentos fueron obtenidos en el paso anterior. Para ello, se realizará sucesivas llamadas al servicio web ObtenerBloque.

Invocación a TerminarDescarga: una vez descargados todos los bloques del documento principal y de todos los adjuntos, la aplicación cliente realizará una solicitud al servicio

(29)

web TerminarDescarga, para indicarle a LexNET la finalización del proceso de descarga del mensaje completo.

(30)

3. DESCRIPCIÓN DE LOS SERVICIOS WEB LEXNET

En este apartado se detallan los servicios Web de LexNET incluyendo su descripción y parámetros de entrada y salida. Para facilitar la integración de las aplicaciones clientes, cada una de las operaciones que se pueden realizar en LexNET a través de servicios web, se han definido como un servicio web independiente, cada uno con una sola operación. Como se verá más adelante en la definición WSDL de los servicios web, cada uno de ellos (con su única operación) aceptan como parámetro de entrada un String, el cual representa un mensaje formateado en XML a través del cual se envían los datos necesarios para realizar la operación que representa. Asimismo, el mensaje de respuesta que envía el servidor LexNET será también un String formateado en XML con los datos específicos de la operación realizada o, en caso de que ocurra algún error, los datos del mismo. Como la respuesta de error es común para todos los servicios, se indica el formato de dicha respuesta de error en el apartado 3.1.1.

3.1. De uso general (conexión con certificado de usuario o de aplicación)

A continuación se muestran el conjunto de servicios web de uso general, que pueden ser utilizados en los dos tipos de arquitecturas explicadas en el apartado 2.

(31)

3.1.1. Respuesta de error

3.1.1.1. Descripción

Se dedica este apartado al mensaje de respuesta de error ya que es único para todos los servicios. Además, como se podrá apreciar en las definiciones WSDL, ninguno de los servicios web define un mensaje “default” en sus operaciones, esto es debido a que en caso de error se utiliza el mismo mensaje de salida. Es por esto que las aplicaciones clientes, al recibir una respuesta de cualquiera de los servicios web, deberán preguntar si el mensaje es de error o de respuesta real a la operación invocada.

El mensaje de error incluye información sobre el momento en que ocurre el error, códigos definidos (para más información sobre los códigos de error consulte el apartado 4.1), un mensaje explicativo y el módulo en el que ocurre.

En el ejemplo que se muestra a continuación se ha escenificado el siguiente error: se solicita la operación ObtenerMensaje por parte de un usuario que requiere el envío de una verificación de lectura previo a la petición de este servicio web. El servicio ObtenerMensaje devolvería un mensaje de error, causado por el hecho de que el usuario necesitaba enviar una verificación de lectura antes de descargar el mensaje.

3.1.1.2. Mensaje SOAP de Respuesta

<?xmlversion="1.0"encoding="UTF-8"?>

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <soap:Body>

<ObtenerMensajeOut

xmlns="https://obtenermensaje.servicio.wsLexNET.webservices.LexNET.satec.es"> <?xmlversion="1.0"encoding="UTF-8"?>

(32)

<mensajeWS xmlns="https://wsLexNET.webservices.LexNET.satec.es" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="https://wsLexNET.webservices.LexNET.satec.es/WSLexNET.xsd"> <respuestaError>

<tiempo>[fechaError]</tiempo> <codigo>[codigoError]</codigo> <texto>[texto]</texto>

<actor>[actor]</actor> <detalle>[detalle]</detalle> <token>[token]</token> </respuestaError>

</mensajeWS> </ObtenerMensajeOut> </soap:Body>

</soap:Envelope>

Los elementos resaltados se enumeran a continuación:

fechaError: Momento en que se produce el error (según la hora del servidor

LexNET).

codigoError: Código del error. Para más información sobre los posibles códigos de

error consulte en el Anexo, el apartado “Códigos de error devueltos por el servidor”

texto: Texto descriptivo del error

actor: El módulo que causa o detecta el error.

detalle: Una descripción más detallada del error y sus posibles causas y soluciones. token: token que ha de ser firmado por aquellas aplicaciones centralizadas de

usuario profesionales que hagan uso de los servicios web una vez que ha terminado el tiempo máximo de uso.

(33)

3.1.2. LogOut

3.1.2.1. Descripción

Este servicio permite a una aplicación cliente de los servicios web LexNET solicitar la desconexión del sistema. En el lado del servidor LexNET se libera toda la información no permanente de la sesión, impidiendo futuras operaciones con esta sesión.

3.1.2.2. Ruta WSDL

Ruta WSDL (entorno de Pruebas):

https://lexnet3pruebas.justicia.es/services/Logout/wsdl/Logout.wsdl

3.1.2.3. Definición WSDL

<?xmlversion="1.0"encoding="UTF-8"?> <definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:impl="https://logout.servicio.wsLexNET.webservices.LexNET.satec.es" targetNamespace="https://logout.servicio.wsLexNET.webservices.LexNET.satec.es" xmlns="http://schemas.xmlsoap.org/wsdl/"> <types>

<xs:schemaelementFormDefault="qualified"

targetNamespace="https://logout.servicio.wsLexNET.webservices.LexNET.satec.es"> <xs:elementname="LogoutIn"type ="xs:string" />

</xs:schema> </types>

<messagename="LogoutSoapIn">

<partname="logoutRequest"element="impl:LogoutIn" /> </message>

<messagename="LogoutSoapOut" /> <portTypename="LogoutPortType"> <operationname="Logout">

<inputmessage="impl:LogoutSoapIn" /> <outputmessage="impl:LogoutSoapOut" /> </operation>

</portType>

<bindingname="LogoutServiceSoap"type="impl:LogoutPortType"> <soap:binding

transport="http://schemas.xmlsoap.org/soap/http" style="document" />

<operationname="Logout"> <soap:operation

(34)

<input>

<soap:bodyuse="literal" /> </input>

<soap:bodyuse="literal" /> </output>

</operation> </binding>

<servicename="LogoutService">

<portname="Logout"binding="impl:LogoutServiceSoap">

<soap:addresslocation="https://LexNETpruebas.justicia.es/services/Logout"/> </port>

</service> </definitions>

3.1.2.4. Mensaje SOAP de Petición

<LogoutInxmlns="https://logout.servicio.wsLexNET.webservices.LexNET.satec.es"> <![CDATA[

<mensajeWS xmlns="https://wsLexNET.webservices.LexNET.satec.es"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="https://LexNETpruebas.justicia.es/wsLexNET/WSLexNET.xsd"> <solicitudLogout>

<idSesion>[idSesion]</idSesion>

<idAplicacion>[idAplicacion]</idAplicacion> </solicitudLogout> </mensajeWS> ]]> </LogoutIn> </soap:Body> </soap:Envelope>

idSesion: Identificador de la sesión que se desea terminar.

idAplicacion: Identificador de la aplicación desde la que se hace la petición de fin

(35)

3.1.2.5. Validaciones

Este servicio web no realiza ninguna comprobación.

3.1.2.6. Mensaje SOAP de Respuesta

El servicio web no genera ninguna respuesta.

3.1.3. ObtenerRoles

3.1.3.1. Descripción

Esta funcionalidad permite a un usuario de una aplicación cliente de los servicios web LexNET, consultar los roles que dispone en LexNET así como conocer su rol principal, es decir, aquel con el que accede por defecto al sistema cuando se realiza la petición de Login.

3.1.3.2. Ruta WSDL

https://lexnet3pruebas.justicia.es/services/ObtenerRoles?wsdl

3.1.3.3. Definición WSDL

<?xmlversion="1.0"encoding="UTF-8"?> <definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:impl="https://obtenerroles.servicio.wsLexNET.webservices.LexNET.es" targetNamespace="https://obtenerroles.servicio.wsLexNET.webservices.LexNET.es" xmlns="http://schemas.xmlsoap.org/wsdl/"> <types>

targetNamespace="https://obtenerroles.servicio.wsLexNET.webservices.LexNET.es"> <xs:elementname="ObtenerRolesIn"type ="xs:string" />

</xs:schema> </types>

(36)

<messagename="ObtenerRolesSoapIn">

<partname="obtenerrolesRequest"element="impl:ObtenerRolesIn" /> </message>

<messagename="ObtenerRolesSoapOut" /> <portTypename="ObtenerRolesPortType"> <operationname="ObtenerRoles">

<inputmessage="impl:ObtenerRolesSoapIn" /> <outputmessage="impl:ObtenerRolesSoapOut" /> </operation>

</portType>

<bindingname="ObtenerRolesServiceSoap"type="impl:ObtenerRolesPortType"> <soap:binding

<operationname="ObtenerRoles"> <soap:operation

soapAction=""/> <input>

<servicename="ObtenerRolesService">

<portname="ObtenerRoles"binding="impl:ObtenerRolesServiceSoap"> <soap:addresslocation="https://LexNET.justicia.es/services/ObtenerRoles"/> </port>

3.1.3.4. Mensaje SOAP de Petición

<ObtenerRolesInxmlns="https://obtenerroles.servicio.wsLexNET.webservices.LexNET.es"> <![CDATA[

<mensajeWS xmlns="https://wsLexNET.webservices.LexNET.es"

xsi:schemaLocation="https://LexNET.justicia.es/wsLexNET/WSLexNET.xsd"> <solicitudObtenerRoles>

<idAplicacion>[idAplicacion]</idAplicacion> </solicitudObtenerRoles> </mensajeWS> ]]> </ObtenerRolesIn> </soap:Body> </soap:Envelope>

(37)

idSesion: Identificador de la sesión.

idAplicacion: Identificador de la aplicación desde la que se hace la petición.

3.1.3.5. Validaciones

Estas son las validaciones que se aplican al servicio web:

idAplicacion: se comprueba que el identificador de la aplicación está admitido en el

entorno actual.

idSesion: se comprueba que el identificador de sesión es correcto ya que el usuario

previamente lo ha debido introducir con anterioridad. Tiene una caducidad máxima de 30 minutos.

3.1.3.6. Mensaje SOAP de Respuesta

<?xmlversion="1.0"encoding="utf-8"?>

<ObtenerRolesOutxmlns="https://obtenerroles.servicio.wsLexNET.webservices.LexNET.es"> <?xmlversion="1.0"encoding="UTF-8"?>

<nombre>[nombre]</nombre> <principal>[principal]</principal>

(38)

<nombre>[nombre]</nombre>

<partidoJudicial>[partidoJudicial]</partidoJudicial> <tipo>[tipo]</tipo>

<idSujetoEntidad>[idSujetoEntidad]</idSujetoEntidad> </entidad> </rol> </roles> </respuestaObtenerRoles> </mensajeWS> </ObtenerRolesOut> </soap:Body> </soap:Envelope>

Elemento <roles>: Es el contenido de la respuesta de ObtenerRoles, consiste en un array de elementos <rol>

o Elemento <rol>: Describe un rol que dispone el usuario

tipo: Identificador del rol. Ej: 1 (=abogado), 28(=procurador),

14 (=administrador de procuradores), etc.

nombre: descripción del rol. Ej: abogado, procurador, etc. principal: Valor boolean. Si es true indica que se trata del rol

principal del usuario.

Elemento <entidad>: Describe la entidad en la que dispone de ese rol.

o nombre: Nombre de la entidad

o partidoJudicial: Código INE del partido judicial (si es aplicable)

(39)

o tipo: Define que tipo de entidad es según la tabla de tipos de entidad.Ej: 5(= Órgano judicial), 1(=Colegio de Procuradores), 2(=Colegio de Abogados), etc. o idSujetoEntidad: Identificador de LexNET de la

Entidad

3.1.4. ConfigRolPorDefecto

3.1.4.1. Descripción

Esta funcionalidad permite a un usuario de una aplicación cliente de los servicios web LexNET que disponga de más de un rol en LexNET, modificar el rol de acceso por defecto al sistema de manera que en el siguiente Login, el acceso al sistema se realice con el nuevo rol.

3.1.4.2. Ruta WSDL

https://lexnet3pruebas.justicia.es/services/ConfigRolPorDefecto?wsdl

3.1.4.3. Definición WSDL

<?xmlversion="1.0"encoding="UTF-8"?> <definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:impl="https://configrolpordefecto.servicio.wsLexNET.webservices.LexNET.es" targetNamespace="https://configrolpordefecto.servicio.wsLexNET.webservices.LexNET.es" xmlns="http://schemas.xmlsoap.org/wsdl/"> <types>

(40)

<xs:elementname="ConfigRolPorDefectoIn"type ="xs:string" /> </xs:schema>

</types>

<messagename="ConfigRolPorDefectoSoapIn">

<partname="configrolpordefectoRequest"element="impl:ConfigRolPorDefectoIn" /> </message>

<messagename="ConfigRolPorDefectoSoapOut" /> <portTypename="ConfigRolPorDefectoPortType"> <operationname="ConfigRolPorDefecto">

<inputmessage="impl:ConfigRolPorDefectoSoapIn" /> <outputmessage="impl:ConfigRolPorDefectoSoapOut" /> </operation>

</portType>

<bindingname="ConfigRolPorDefectoServiceSoap"type="impl:ConfigRolPorDefectoPortType"> <soap:binding

<operationname="ConfigRolPorDefecto"> <soap:operation

<servicename="ConfigRolPorDefectoService">

<portname="ConfigRolPorDefecto"binding="impl:ConfigRolPorDefectoServiceSoap"> <soap:addresslocation="https://LexNET.justicia.es/services/ConfigRolPorDefecto"/> </port>

3.1.4.4. Mensaje SOAP de Petición

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <soap:Body> <ConfigRolPorDefectoIn xmlns="https://configrolpordefecto.servicio.wsLexNET.webservices.LexNET.es"> <![CDATA[

xsi:schemaLocation="https://LexNET.justicia.es/wsLexNET/WSLexNET.xsd"> <solicitudConfigRolPorDefecto>

<idAplicacion>[idAplicacion]</idAplicacion> <rol>

(41)

<idSujeto>[idSujeto]</idSujeto> </entidad> </rol> </solicitudConfigRolPorDefecto> </mensajeWS> ]]> </ConfigRolPorDefectoIn> </soap:Body> </soap:Envelope>

Elemento <rol>: Describe un rol del usuario

o tipo: Identificador del nuevo rol por defecto con el que se desea entrar a la aplicación. Ej: 1 (=abogado), 28(=procurador), 14 (=administrador de procuradores), etc.

o Elemento <entidad>: Describe la entidad en la que dispone de ese rol. Este elemento sólo es obligatorio en caso de el usuario usuario disponga del mismo rol en más de una entidad.

idSujeto: Identificador de LexNET de la Entidad

3.1.4.5. Validaciones

(42)

entorno actual.

tipo: se verifica que el rol indicado es uno de los que dispone el usuario autenticado

y si dispone de ese rol en más de una entidad

idSujeto: se verifica que el usuario posee el rol indicado (tipo) asociado a ese

identificador de LexNET de la Entidad.

3.1.4.6. Mensaje SOAP de Respuesta

<?xmlversion="1.0"encoding="utf-8"?>

<ConfigRolPorDefectoOut

xmlns="https://configrolpordefecto.servicio.wsLexNET.webservices.LexNET.es"> <?xmlversion="1.0"encoding="UTF-8"?>

xsi:schemaLocation="https://LexNET.justicia.es/wsLexNET/WSLexNET.xsd"> <respuestaConfigRolPorDefecto>

<correcto>[correcto]</correcto> </respuestaConfigRolPorDefecto> </mensajeWS>

</ConfigRolPorDefectoOut> </soap:Body>

</soap:Envelope>

(43)

correcto: Valor boolean. Si es true indica que la petición se ha procesado

correctamente y, por tanto, se ha realizado el cambio de rol por defecto.

3.1.5. ObtenerDestinatarios

3.1.5.1. Descripción

Este servicio permite al cliente obtener los destinatarios a los que puede enviar mensajes en función del usuario que ha hecho Login y de los parámetros de filtrado que se le pasen (nombre, código INE de población, tipo de órgano). En una aplicación cliente que conste con una base de datos, se aconseja realizar esta operación dentro de los procesos de configuración e inicialización de la aplicación para obtener todos los destinatarios válidos y almacenar su resultado, ya que la información devuelta por esta operación no cambia frecuentemente. Si al solicitar el envío de un mensaje, el servidor devuelve un error de destinatario no válido, se podría volver a lanzar esta operación para actualizar la información de los destinatarios y así solucionar el error, pero no es aconsejable invocarla cada vez que se realiza un envío, para no saturar el servidor.

3.1.5.2. Ruta WSDL

(44)

3.1.5.3. Definición WSDL

<?xmlversion="1.0"encoding="UTF-8"?> <definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:impl="https://obtenerdestinatarios.servicio.wsLexNET.webservices.LexNET.satec.es" targetNamespace="https://obtenerdestinatarios.servicio.wsLexNET.webservices.LexNET.satec.es" xmlns="http://schemas.xmlsoap.org/wsdl/"> <types>

targetNamespace="https://obtenerdestinatarios.servicio.wsLexNET.webservices.LexNET.satec.es"> <xs:elementname="ObtenerDestinatariosIn"type ="xs:string" />

<xs:elementname="ObtenerDestinatariosOut"type="xs:string" /> </xs:schema>

</types>

<messagename="ObtenerDestinatariosSoapIn">

<partname="obtenerdestinatariosRequest"element="impl:ObtenerDestinatariosIn" /> </message>

<messagename="ObtenerDestinatariosSoapOut">

<partname="obtenerdestinatariosResponse"element="impl:ObtenerDestinatariosOut" /> </message>

<portTypename="ObtenerDestinatariosPortType"> <operationname="ObtenerDestinatarios">

<inputmessage="impl:ObtenerDestinatariosSoapIn" /> <outputmessage="impl:ObtenerDestinatariosSoapOut" /> </operation>

</portType>

<bindingname="ObtenerDestinatariosServiceSoap"type="impl:ObtenerDestinatariosPortType"> <soap:binding

transport="http://schemas.xmlsoap.org/soap/http" style="document"/>

<operationname="ObtenerDestinatarios"> <soap:operation

<servicename="ObtenerDestinatariosService">

<portname="ObtenerDestinatarios"binding="impl:ObtenerDestinatariosServiceSoap"> <soap:addresslocation="https://LexNETpruebas.justicia.es/services/ObtenerDestinatarios"/> </port>

(45)

3.1.5.4. Mensaje SOAP de Petición

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <soap:Body> <ObtenerDestinatariosIn xmlns="https://obtenerdestinatarios.servicio.wsLexNET.webservices.LexNET.satec.es"> <![CDATA[

xsi:schemaLocation="https://LexNETpruebas.justicia.es/wsLexNET/WSLexNET.xsd"> <solicitudGetDestinatarios>

<idAplicacion>[idAplicacion]</idAplicacion> <nombre>[nombre]</nombre>

<partidoJudicial>[codPartidoJudicial]</partidoJudicial> <ordenJurisdiccional>[tipoOrgano]</ordenJurisdiccional> <tipoMensaje>[tipoMensaje]</tipoMensaje>

</solicitudGetDestinatarios> </mensajeWS> ]]> </ObtenerDestinatariosIn> </soap:Body> </soap:Envelope>

tipoMensaje: Código del tipo de mensaje a enviar (ver Anexo I). En caso de

aparecer en la solicitud, se utiliza para filtrar los destinatarios en función de si son destinatarios del tipo de mensaje indicado. Si no se proporciona, por defecto, devolverá los posibles destinatarios del tipo de mensaje “Escrito”

(46)

codPartidoJudicial: Código INE del partido judicial. En caso de no aparecer en la

solicitud, se utiliza el código de población al que pertenece el usuario conectado.

tipoOrgano: Tipo de órgano. Sólo tiene sentido cuando se buscan órganos

judiciales. Los posibles valores que puede tomar este parámetro tratan de seguir la misma filosofía que la del Consejo General del Poder Judicial:

o Valor: “10-19” Indica que se solicitan órganos judiciales relativos al Tribunal Supremo, por ejemplo: Tribunal Supremo Civil. Sala Primera.

o Valor: “20-29” Indica que se solicitan órganos judiciales relativos a la Audiencia Nacional, por ejemplo: Audiencia Nacional Penal. Sección Primera.

o Valor: “30-39” Indica que se solicitan órganos judiciales relativos al Tribunal Superior y Audiencia Provincial, por ejemplo: Audiencia Provincial Penal nº 1. o Valor: “40-59” Indica que se solicitan órganos judiciales de tipo Juzgados,

ejemplo: Juzgado de Primera Instancia nº 1.

3.1.5.5. Validaciones

(47)

3.1.5.6. Mensaje SOAP de Respuesta

<ObtenerDestinatariosOut

xmlns="https://obtenerdestinatarios.servicio.wslexnet.webservices.lexnet.satec.es"> <?xmlversion="1.0"encoding="UTF-8"?>

<nombre>[nombre]</nombre>

<partidoJudicial>[partidoJudicial]</partidoJudicial> <tipo>[tipo]</tipo>

<testConsejo>[testConsejo]</ testConsejo> </entidad>

</destinatario> <destinatario> <organoJudicial>

<codigoPoblacion>[codigoPoblacion]</codigoPoblacion> <tipoOrgano>[tipoOrgano]</tipoOrgano>

<numeroOrgano>[numeroOrgano]</numeroOrgano> <dn>[dn]</dn>

<nombre>[nombre]</nombre> </organoJudicial>

</destinatario> <destinatario> <profesional>

<nombre>[nombre]</nombre> <apellido1>[apellido1]</apellido1> <apellido2>[apellido2]</apellido2> <email>[email]</email>

(48)

<codigo>[codigo]</codigo>

<codigoColegiado>[codigoColegiado]</codigoColegiado> <entidad>

<nombre>[nombre_entidad]</nombre>

<partidoJudicial>[partidoJudicial]</partidoJudicial> <tipo>[tipo_entidad]</tipo>

<dn>[dn_entidad]</dn>

<testConsejo>[testConsejo]</ testConsejo> </entidad> </profesional> </destinatario> </destinatarios> </respuestaGetDestinatarios> </mensajeWS> </ObtenerDestinatariosOut> </soap:Body> </soap:Envelope>

Elemento <destinatarios>: Es el contenido de la respuesta de ObtenerDestinatarios, consiste en un array de elementos <destinatario>

o Elemento <destinatario>: Describe un destinatario que puede ser una entidad, un órgano judicial o un profesional.

Elemento <entidad>: Describe una entidad de profesionales, que puede ser un colegio de abogados, de procuradores, etc.

nombre: Nombre de la entidad

partidoJudicial: Código INE del partido judicial

tipo: Define que tipo de entidad es: De Procuradores, de

Abogados, de Graduados Sociales, etc.

(49)

testConsejo: Código identificador de la entidad definido por el

Test del Consejo.

Elemento <organoJudicial>: Describe un órgano judicial.

codigoPoblacion: 5 dígitos del código de población.

tipoOrgano: Identificador del tipo de órgano, determina la

jurisdicción.

numeroOrgano: Numeración del órgano. dn: Identificador de LexNET del Órgano Judicial nombre: Nombre del órgano

Elemento <profesional>: Describe a una persona colegiada Procurado, Abogado, Abogado del Estado, etc.

nif: NIF del profesional

nombre: Nombre del profesional

apellido1: Primer apellido del profesional

apellido2: Segundo apellido del profesional, si existe email: Correo electrónico del profesional

(50)

tipo: Tipo de profesional: Procurador, abogado, abogado del

Estado, etc.

codigo: Código del profesional en LexNET

codigoColegiado: Código de colegiado del profesional dentro

del colegio al que pertenece, se aplica a profesionales colegiados: procuradores, abogados, graduados sociales, etc. Elemento <entidad>: Describe la entidad a la que pertenece el profesional

3.1.6. ObtenerTiposProcedimiento

3.1.6.1. Descripción

Esta funcionalidad permite obtener los tipos de procedimiento que puede utilizar en sus envíos un usuario, en función del usuario conectado y del destinatario del mensaje. Al igual que ocurre con la operación ObtenerDestinatarios, la información que devuelve esta operación no cambia frecuentemente, con lo cual se aconseja invocarla dentro de las tareas de configuración e inicialización de la aplicación cliente y almacenar su resultado. En caso de que, en el envío de un mensaje, el servidor devuelva algún error de validación relativo al Tipo de Procedimiento, se podría volver a llamar a esta función para actualizar la información y corregir el error. Esta operación se deberá invocar después de haber obtenido los destinatarios. Por ejemplo, para el

(51)

caso de las aplicaciones cliente para profesionales deberán invocar esta operación pasando como destinatario cada uno de los órganos judiciales que hayan obtenido previamente como destinatarios válidos.

3.1.6.2. Ruta WSDL

https://lexnet3pruebas.justicia.es/services/ObtenerTiposProcedimiento?wsdl

3.1.6.3. Definición WSDL

<?xmlversion="1.0"encoding="utf-8"?> <definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:impl="https://obtenertiposprocedimiento.servicio.wsLexNET.webservices.LexNET.satec.es" targetNamespace="https://obtenertiposprocedimiento.servicio.wsLexNET.webservices.LexNET.satec.es" xmlns="http://schemas.xmlsoap.org/wsdl/"> <types>

targetNamespace="https://obtenertiposprocedimiento.servicio.wsLexNET.webservices.LexNET.satec.es"

>

<xs:elementname="ObtenerTiposProcedimientoIn"type ="xs:string" /> <xs:elementname="ObtenerTiposProcedimientoOut"type="xs:string" /> </xs:schema>

</types>

<messagename="ObtenerTiposProcedimientoSoapIn">

<partname="obtenertiposprocedimientoRequest"element="impl:ObtenerTiposProcedimientoIn" /> </message>

<messagename="ObtenerTiposProcedimientoSoapOut">

<part name="obtenertiposprocedimientoResponse" element="impl:ObtenerTiposProcedimientoOut"

/>

</message>

<portTypename="ObtenerTiposProcedimientoPortType"> <operationname="ObtenerTiposProcedimiento">

<inputmessage="impl:ObtenerTiposProcedimientoSoapIn" /> <outputmessage="impl:ObtenerTiposProcedimientoSoapOut" /> </operation>

</portType>

<binding name="ObtenerTiposProcedimientoServiceSoap"

type="impl:ObtenerTiposProcedimientoPortType"> <soap:binding

transport="http://schemas.xmlsoap.org/soap/http" style="document"/>

(52)

<soap:operation soapAction=""/> <input>

<servicename="ObtenerTiposProcedimientoService">

<portname="ObtenerTiposProcedimiento"binding="impl:ObtenerTiposProcedimientoServiceSoap"> <soap:addresslocation="https://LexNETpruebas.justicia.es/services/ObtenerTiposProcedimiento"/> </port>

3.1.6.4. Mensaje SOAP de Petición

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <soap:Body> <ObtenerTiposProcedimientoIn xmlns="https://obtenertiposprocedimiento.servicio.wsLexNET.webservices.LexNET.satec.es"> <![CDATA[

xsi:schemaLocation="https://LexNETpruebas.justicia.es/wsLexNET/WSLexNET.xsd"> <solicitudGetTiposProcedimiento>

<idAplicacion>[idAplicacion]</idAplicacion> <destinoProc>

<organoJudicial>

<codigoPoblacion>[codigoPoblacion]</codigoPoblacion> <tipoOrgano>[tipoOrgano]</tipoOrgano>

<numeroOrgano>[numeroOrgano]</numeroOrgano> <dn>[dn]</dn>

<nombre>[nombre]</nombre> </organoJudicial> </destinoProc> </solicitudGetTiposProcedimiento> </mensajeWS> ]]> </ObtenerTiposProcedimientoIn> </soap:Body> </soap:Envelope>

(53)

Elemento <destinoProc>: Indica el destinatario para el cual se obtendrán los tipos de procedimiento que pueden utilizarse en envíos a aquél. En este caso, se obtendrán los tipos de procedimiento un órgano judicial:

o Elemento <organoJudicial>: Indica el órgano judicial

codigoPoblacion: 5 dígitos del código de población al que pertenece el

órgano.

tipoOrgano: Identificador del tipo de órgano. numeroOrgano: Numeración del órgano. dn: Identificador en LexNET del Órgano Judicial nombre: Nombre del órgano

3.1.6.5. Validaciones

(54)

previamente lo ha debido introducir con anterioridad. Tiene una caducidad máxima de 30 minutos

3.1.6.6. Mensaje SOAP de Respuesta

<ObtenerTiposProcedimientoOut

xmlns="https://obtenertiposprocedimiento.servicio.wsLexNET.webservices.LexNET.satec.es"> <?xmlversion="1.0"encoding="UTF-8"?>

<mensajeWS xmlns="https://wsLexNET.webservices.LexNET.satec.es" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://LexNETpruebas.justicia.es/wsLexNET/WSLexNET.xsd"> <respuestaGetTiposProcedimiento> <tiposProcedimiento> <tipoProcedimiento>

<codigo>[codigo]</codigo> <texto>[texto]</texto>

<leyAntigua>[leyAntigua]</leyAntigua> </tipoProcedimiento>

<codigo>[codigo2]</codigo> <texto>[texto2]</texto>

<leyAntigua>[leyAntigua2]</leyAntigua> </tipoProcedimiento>

...

<codigo>[codigoN]</codigo> <texto>[textoN]</texto>

<leyAntigua>[leyAntiguaN]</leyAntigua> </tipoProcedimiento> </tiposProcedimiento> </respuestaGetTiposProcedimiento> </mensajeWS> </ObtenerTiposProcedimientoOut> </soap:Body> </soap:Envelope>

(55)

Elemento <tiposProcedimiento>: Es el contenido de la respuesta de ObtenerTiposProcedimiento, consiste en un array de elementos

<tipoProcedimiento>

o Elemento < tipoProcedimiento >: Define un tipo de procedimiento.

codigo: Código del tipo de procedimiento

texto: Nombre descriptivo del tipo de procedimiento

leyAntigua: boolean que indica si el tipo de procedimiento es de la ley

antigua.

3.1.7. ObtenerPendientes

3.1.7.1. Descripción

Esta operación devuelve, para cada tipo de mensaje, el número de mensajes pendientes de descarga por parte del usuario que ha hecho Login. Los números indicados se refieren a mensajes pendientes de descarga por parte del usuario desde el cliente de servicios web.