MARCO DE REFERENCIA PARA LA PLATAFORMA DE INTEROPERABILIDAD VOLUMEN IV: MANUAL DEL DESARROLLADOR SERVICIO DE MENSAJES A MÓVILES Y CORREO ELECTRÓNICO

Transcripción

1 Interoperabilidad de los servicios telemáticos de la Administración Pública de la CAC Página 1 de 127 MARCO DE REFERENCIA PARA LA PLATAFORMA DE INTEROPERABILIDAD VOLUMEN IV: MANUAL DEL DESARROLLADOR SERVICIO DE MENSAJES A MÓVILES Y CORREO ELECTRÓNICO Documento : PLA-DOC-FIN Vol IV. Servicio de Mensajes a Moviles y Correo Ubicación en eroom: Preparado por D. Gral. de Telecomunicaciones y Nuevas Tecnologías Revisado por D. Gral. de Telecomunicaciones y Nuevas Tecnologías Aprobado por D. Gral. de Telecomunicaciones y Nuevas Tecnologías Fecha: 26/08/2014 Fecha: 26/08/2014 Fecha: 26/08/2014

2 Página 2 de 127 Rev. 0 Fecha 11/07/ /07/ /07/ /11/ /01/ /06/ /11/ /03/ /05/ /03/ /07/ /09/ /09/ /01/ /02/2013 Versión Inicial Corregidos errores en los referencias dentro del documento Añadido métodos de auditorías. Pequeñas modificaciones en otros métodos Actualizado tabla de valores. Se actualiza el documento hasta la versión v Se actualiza el documento hasta la versión v Se actualiza el documento hasta la versión v Se actualiza el documento hasta la versión v Se actualiza el documento hasta la versión v Se actualiza el documento hasta la versión v Se actualiza el documento hasta la versión v Se actualiza el documento hasta la versión v Se actualiza el documento hasta la versión v Se recomienda la utilización de las codificaciones UTF8 o ISO en el envío de mensajes. Se actualiza el documento hasta la versión v Se actualiza el documento hasta la versión v Se añade la versión del servicio de EDMYCE en Platino /04/2013 Se añade la auditoría a la versión del servicio en Platino /05/2013 Se corrige la incidencia que impedía enviar correos en el entorno de desarrollo y pre-explotación. # /12/2013 Se realiza un cambio en la capa de acceso a BBDD del servicio para corregir posibles bloqueos de BBDD. # /08/2014 Se externaliza el envío de s y sms a un core desplegado en servidor Jboss6. Se corrige error en la búsqueda de mensajes, cuando el criterio de búsqueda incluía ciertos parámetros.

3 Página 3 de 127 ÍNDICE 1 INTRODUCCIÓN Cambios en el documento con respecto a versiones anteriores VERSIÓN DEL SERVICIO CASOS DE USO SERVICIO DE ÁREAS CU-MSJ-AREA-01: Crear área CU-MSJ-AREA-02: Actualizar área CU-MSJ-AREA-03: Actualizar área y suscripciones CU-MSJ-AREA-04: Eliminar área CU-MSJ-AREA-05: Obtener área CU-MSJ-AREA-06: Obtener áreas CU-MSJ-AREA-07: Buscar áreas CU-MSJ-AREA-08: Obtener suscripciones CU-MSJ-AREA-09: Añadir suscripciones CU-MSJ-AREA-10: Actualizar suscripciones CU-MSJ-AREA-11: Eliminar suscripciones CU-MSJ-AREA-12: Eliminar todas suscripciones CU-MSJ-AREA-13: Existe tercero en área CU-MSJ-AREA-14: Obtener Auditoría Área CU-MSJ-AREA-15: Obtener Auditoría Suscripción CU-MSJ-AREA-16: Obtener versión servicio SERVICIO DE LISTAS DE DISTRIBUCIÓN CU-MSJ-LD-01: Crear lista de distribución CU-MSJ-LD-02: Actualizar lista de distribución CU-MSJ-LD-03: Actualizar lista de distribución y miembros CU-MSJ-LD-04: Eliminar lista de distribución CU-MSJ-LD-05: Obtener lista de distribución CU-MSJ-LD-06: Obtener listas de distribución CU-MSJ-LD-07: Buscar listas de distribución CU-MSJ-LD-08: Añadir miembros lista de distribución CU-MSJ-LD-09: Actualizar miembros lista de distribución CU-MSJ-LD-10: Eliminar miembros lista de distribución CU-MSJ-LD-11: Eliminar todos los miembros lista de distribución CU-MSJ-LD-12: Obtener miembros lista de distribución CU-MSJ-LD-13: Existe tercero en lista de distribución CU-MSJ-LD-14: Obtener Auditoría Lista Distribución CU-MSJ-LD-15: Obtener Auditoría Miembros Lista Distribución CU-MSJ-LD-16: Obtener versión servicio SERVICIO DE MENSAJES SALIENTES CU-MSJ-MEN-01: Enviar mensaje oficio...90

4 Página 4 de CU-MSJ-MEN-02: Enviar mensajes oficio CU-MSJ-MEN-03: Enviar mensaje área CU-MSJ-MEN-04: Enviar mensajes área CU-MSJ-MEN-05: Obtener remesa CU-MSJ-MEN-06: Obtener mensajes CU-MSJ-MEN-07: Buscar remesas CU-MSJ-MEN-08: Buscar mensajes CU-MSJ- MEN-09: Obtener versión servicio SERVICIO DE MENSAJES ENTRANTES CU-MSJ-MEN-10: Consulta Expediente CONTROL DE EXCEPCIONES Área Exception Lista distribución Exception Mensaje Exception INFORMACIÓN ADICIONAL DEL SERVICIO Incorporación de cabeceras de seguridad en la invocación del servicio Tabla Valores: Área Tabla Valores: Código de Errores Tabla Valores: Estados Remesas Tabla Valores: Estados Mensajes Tabla Valores: Remesa Tabla Valores: Auditoria Operaciones Realizadas

5 1 Página 5 de 127 INTRODUCCIÓN El Servicio de Mensajes de PLATINO no es el medio para trasmitir las comunicaciones formales ni las notificaciones tal y como se describe en los artículos 27 y 28 de la Ley 11/2007. El motivo es que los canales de comunicación contemplados en este Servicio no permiten garantizar la recepción de las comunicaciones. Por ello, este Servicio sólo posibilita las comunicaciones informativas de carácter no formal. El Servicio de Mensajes de PLATINO permite realizar las siguientes acciones: Envío de comunicaciones a un sólo tercero o a un conjunto de ellos (a través de una remesa). La definición de los destinatarios de las comunicaciones se puede especificar de diferentes maneras: A través de una lista de identificadores de terceros A través de una lista de número de teléfonos y/o correos electrónicos A través de una lista de distribución Crear listas de distribución para conformar conjuntos de terceros que serán potenciales destinatarios de diversas comunicaciones en distintos momentos a lo largo del tiempo. Definir Áreas que categorizan algún tema de interés (un procedimiento en concreto o algún tema general). Los terceros interesados en esas áreas pueden suscribirse para así poder recibir toda la información relacionada con esa área. Cuando haya algún evento o noticia sobre un área, la Administración puede enviar un mensaje que recibirán todos los terceros suscritos a esa área. Que los terceros puedan realizar consultas o pedir información sobre algunas de las áreas de tipo procedimiento a las que se haya suscrito previamente. De esta forma, un tercero se puede suscribir a una área que represente a un procedimiento en particular y posteriormente puede solicitar en cualquier momento conocer el estado de los expedientes de ese procedimiento que el tercero tiene abierto con la Administración. Que los terceros, cuando realizan una suscripción a un área, decidan el canal de comunicación (correo electrónico o SMS) por el que quieren recibir los mensajes. En los mensajes que la Administración envía directamente a los terceros (sin previa suscripción) es ésta la que decide por qué canal desea enviar los mensajes.

6 Página 6 de 127 Consultar el estado en el que se encuentra cada mensaje o remesa, tanto antes como después de que se haya enviado. Destacar que el envío de mensajes SMS a través del servicio se realiza de forma asíncrona a través de la pasarela SMS del Gobierno de Canarias. Los consumidores del servicio podrán consultar el estado de envío de los mensajes a través de los métodos proporcionados por el servicio. 1.1 Cambios en el documento con respecto a versiones anteriores Cambios en la versión: Se externaliza el envío de s y SMS fuera del servicio, el funcionamiento del mismo sigue siendo el mismo, ofreciendo los mismos métodos hasta esta versión. Sin embargo, el responsable del envío asíncrono de los s y SMS es un core externalizado en un servidor JBoss6, funcionando de forma autónoma. Se corrige error a la hora de buscar mensajes, cuando el criterio de búsqueda incluía ciertos parámetros en la búsqueda, los cuales no se estaban parseando correctamente. Cambios en la versión: Se realiza un cambio en la capa de acceso a BBDD del servicio para corregir posibles bloqueos de BBDD. #3850 Cambios en la versión: Se corrige la incidencia #3073 que impedía enviar correos en el entorno de Desarrollo y Pre-Explotación. Cambios en la versión: v Se añade la auditoría del Servicio EDMYCE en la plataforma Platino 2.0. Cambios en la versión: v Actualmente ya se permite el consumo del servicio en la nueva arquitectura de Platino, la cual denominamos Platino 2.0. Para más información consultar el

7 Página 7 de 127 documento de consumo de Platino de 2.0 en el siguiente enlace. Dicho servicio estará en un modelo dual de arquitectura por tiempo limitado, es decir se permite su consumo tanto en la arquitectura antigua como en la nueva. Es importante destacar que los nuevos correctivos únicamente se resolverán únicamente en Platino 2.0 a partir de su puesta en explotación. En la versión v , no se incorporan cambios en la interfaz, sólo se han realizado cambios internos en el servicio. La actual versión del servicio v , con respecto a la versión anterior v , no incorpora cambios en la interfaz, sólo se han realizado cambios internos en el servicio. La actual versión del servicio v , con respecto a la versión anterior v , no incorpora cambios en la interfaz, sólo se han realizado cambios internos en el servicio. La actual versión del servicio v , con respecto a la versión anterior v , no incorpora cambios en la interfaz, sólo se han realizado cambios internos en el servicio. La actual versión del servicio v , con respecto a la versión anterior v , no incorpora cambios en la interfaz, sólo se han realizado cambios internos en el servicio. La actual versión del servicio v , con respecto a la versión anterior v , no incorpora cambios en la interfaz, sólo se han realizado cambios internos en el servicio. La actual versión del servicio v , con respecto a la versión anterior v , no incorpora cambios en la interfaz, sólo se han realizado cambios internos en el servicio. La actual versión del servicio v , con respecto a la versión anterior v , no incorpora cambios en la interfaz, sólo se han realizado cambios internos en el servicio. La actual versión del servicio v , con respecto a la versión anterior v , no incorpora cambios en la interfaz, sólo se han realizado cambios internos en el servicio. La actual versión del servicio v , con respecto a la versión anterior v , incorpora los siguientes cambios:

8 Página 8 de 127 Se obliga a partir de esta versión a enviar las cabeceras de seguridad en donde se indican las credenciales del usuario del servicio SMS del Gobierno de Canarias cuando se requiera enviar un SMS (véase: 5.1:Incorporación de cabeceras de seguridad en la invocación del servicio). Se han actualizado los códigos de error de la aplicación (véase: 5.3:Tabla Valores: Código de Errores). La versión del servicio v , con respecto a la versión anterior del servicio v , incorpora los siguientes cambios: Se añade a la definición de un Área el atributo borrado el cual sirve para detectar que áreas están borradas cuando en las búsquedas se permita devolver las áreas borradas. Se añade a la definición de una Lista de Distribución el atributo borrado el cual sirve para detectar que listas de distribución están borradas cuando en las búsquedas se permita devolver las áreas borradas. Se permite realizar una búsqueda paginadas de áreas. Se permite realizar búsquedas de áreas ya borradas. Se permite realizar una búsqueda paginadas de listas de distribución. Se permite realizar búsquedas de listas de distribución ya borradas. Se incorporan dos operaciones de auditoría en el servicio de Áreas. Se incorporan dos operaciones de auditorías en el servicio de Listas de Distribución. Se permite realizar búsquedas paginadas de los mensajes enviados. Se permite realizar búsquedas paginadas de las remesas de mensajes generadas. Se actualiza la tabla de valores de códigos de Error (véase: Tabla Valores: Código de Errores)

9 2 Página 9 de 127 VERSIÓN DEL SERVICIO Este documento corresponde a la versión del servicio en la antigua arquitectura y en Platino 2.0.

10 3 Página 10 de 127 CASOS DE USO El Servicio de Mensajes se ha dividido en los siguientes grupos de servicios: Servicio de Áreas: Servicio encargado de la gestión de las áreas que pueden crear los Organismos. Servicio de Listas de Distribución: Servicio encargado de las gestión de las listas de distribución que pueden conformar los Organismos. Servicio de Mensajes Salientes: Servicio que permite realizar envío de mensajes así como permite también la consulta del estado de los mismos. Servicio de Mensajes Entrantes: Servicio encargado de gestionar las consultas de expedientes que pueden realizar los Terceros vía Correo Electrónico o SMS. Cada uno de estos grupos queda reflejado por los siguientes casos de uso.

11 3.1 Página 11 de 127 SERVICIO DE ÁREAS Este Servicio permite a los Organismos crear Áreas que permitan identificar temas a los que los terceros se puedan suscribir. Estas áreas pueden representar temas particulares o pueden representar a procedimientos concretos CU-MSJ-AREA-01: CREAR ÁREA Permite crear una nueva área asociada al Organismo pertinente. Así mismo, si el cliente lo desea puede asignar suscriptores a la misma. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.1:Área ExceptionError: No se encuentra la fuente de referencia ). Interfaz:

12 Página 12 de 127 Entrada del servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:creararea> <ser:area> <dom:nombrearea>area_1</dom:nombrearea> <dom:descripcion></dom:descripcion> <dom:tipoarea>general</dom:tipoarea> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> </ser:area> <ser:suscripciones> <dom:suscripcion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xxx</dom:uritercero> <dom:enviarmensajetelefono>true</dom:enviarmensajetelefono> <dom:enviarmensajecorreoelectronio>true</dom:enviarmensajecorreoelectronio> </dom:suscripcion> </ser:suscripciones> </ser:creararea> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación.

13 Página 13 de 127 nombrearea Nombre asignado al área. Este nombre debe de ser único, es decir, un organismo no puede crear dos áreas con el mismo nombre, tiene un tamaño máximo de 255 caracteres. String descripcion asociada al área. Debe de contener como máximo 4000 caracteres. String tipoarea de área (véase sección: 5.2: Tabla Valores: Área). String fechainiciovigencia Fecha en la cual el área empieza a ser vigente. date fechainiciovigencia Fecha en la cual el área finaliza. Date uritercero URI que identifica unívocamente al tercero. String enviarmensajetelefono Expresa el deseo o no del tercero a recibir mensajes al área suscrita a través del teléfono. boolean uriprocedimiento En aquellos casos en que el área sea de tipo procedimiento, este campo contendrá al URI del procedimiento asociado, un String organismo no puede tener más de un área asociada al mismo procedimiento. enviarmensajecorreoele Expresa el deseo o no del tercero a recibir mensajes al área ctronico suscrita a través de correos electrónicos. boolean Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida

14 Página 14 de 127 xmlns:ser=" xmlns:dom=" <ser:creararearesponse> <ser:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</ser:uriarea> </ser:creararearesponse> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uriarea URI que identifica unívocamente al área creada. String CU-MSJ-AREA-02: ACTUALIZAR ÁREA Actualiza los datos asociados a un área. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.1:Área Exception ). Interfaz: Entrada del Servicio:

15 Página 15 de 127 A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:actualizararea> <ser:area> <dom:nombrearea>area_1</dom:nombrearea> <dom:descripcion> Nueva</dom:descripcion> <dom:tipoarea>general</dom:tipoarea> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> <dom:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</dom:uriarea> <dom:borrada>false</dom:borrada> </ser:area> </ser:actualizararea> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación.

16 Página 16 de 127 nombrearea Nombre asignado al área. Este nombre debe de ser único, es decir, un organismo no puede crear dos áreas con el mismo nombre, tiene un tamaño máximo de 255 caracteres. descripcion asociada al área. Debe de contener como máximo 4000 caracteres. tipoarea de área (véase sección: 5.2: Tabla Valores: Área). fechainiciovigencia Fecha en la cual el área empieza a ser vigente. date fechainiciovigencia Fecha en la cual el área finaliza. date uriarea URI que identifica unívocamente al área. uriprocedimiento En aquellos casos en que el área sea de tipo procedimiento, este campo contendrá al URI del procedimiento asociado, un organismo no puede tener más de un área asociada al mismo procedimiento. borrada Campo que determina si el área ha sido borrada o no. boolean Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:actualizararearesponse /> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación.

17 Página 17 de 127 No hay parámetros CU-MSJ-AREA-03: ACTUALIZAR ÁREA Y SUSCRIPCIONES Permite actualizar los datos asociados a un área así como actualiza también las suscripciones asociadas a la misma. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.1:Área Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación.

18 Página 18 de 127 Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:actualizarareaysuscripciones> <ser:area> <dom:nombrearea>area_1</dom:nombrearea> <dom:descripcion> Nueva</dom:descripcion> <dom:tipoarea>general</dom:tipoarea> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> <dom:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</dom:uriarea> <dom:borrada>false</dom:borrada> </ser:area> <ser:suscripciones> <dom:suscripcion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xxx</dom:uritercero> <dom:enviarmensajetelefono>true</dom:enviarmensajetelefono> <dom:enviarmensajecorreoelectronio>true</dom:enviarmensajecorreoelectronio> </dom:suscripcion> </ser:suscripciones> </ser:actualizarareaysuscripciones> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. nombrearea Nombre asignado al área. Este nombre debe de ser único, es decir, un organismo no puede crear dos áreas con el mismo nombre, tiene un tamaño máximo de 255 caracteres. descripcion asociada al área. Debe de contener como máximo 4000 caracteres. tipoarea de área (véase sección: 5.2: Tabla Valores: Área). fechainiciovigencia Fecha en la cual el área empieza a ser vigente. date fechainiciovigencia Fecha en la cual el área finaliza. date uriarea URI que identifica unívocamente al área a actualizar. borrada Campo que determina si el área ha sido borrada o no. boolean

19 Página 19 de 127 uriprocedimiento En aquellos casos en que el área sea de tipo procedimiento, este campo contendrá al URI del procedimiento asociado, un organismo no puede tener más de un área asociada al mismo procedimiento. uritercero URI que identifica unívocamente al tercero. enviarmensajetelefono Expresa el deseo o no del tercero a recibir mensajes al área suscrita a través del teléfono. boolean enviarmensajecorreoele Expresa el deseo o no del tercero a recibir mensajes al área ctronico suscrita a través de correos electrónicos. boolean Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:actualizarareaysuscripcionresponse /> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. No hay parámetros

20 3.1.4 Página 20 de 127 CU-MSJ-AREA-04: ELIMINAR ÁREA Permite eliminar los datos asociados a un área, así como a las suscripciones que se hayan asignado a la misma. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.1:Área Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" <ser:eliminararea> <ser:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</ser:uriarea> </ser:eliminararea> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación.

21 uriarea Página 21 de 127 URI que identifica unívocamente al área a actualizar. String Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" <ser:eliminararearesponse /> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. No hay parámetros CU-MSJ-AREA-05: OBTENER ÁREA Permite obtener los datos registrados para un área determinada. En caso de éxito, la operación devolverá el área solicitada. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.1:Área Exception ). Interfaz

22 Página 22 de 127 Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" <ser:obtenerarea> <ser:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</ser:uriarea> </ser:obtenerarea> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uriarea URI que identifica unívocamente al área a actualizar. String Salida del Servicio:

23 Página 23 de 127 A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:obtenerarearesponse> <ser:area> <dom:nombrearea>area_1</dom:nombrearea> <dom:descripcion>descripcion Nueva</dom:descripcion> <dom:tipoarea>general</dom:tipoarea> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> <dom:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</dom:uriarea> <dom:borrada>false</dom:borrada> </ser:area> </ser:obtenerarearesponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. nombrearea Nombre asignado al área. Este nombre debe de ser único, es String

24 Página 24 de 127 decir, un organismo no puede crear dos áreas con el mismo nombre, tiene un tamaño máximo de 255 caracteres. descripcion asociada al área. Debe de contener como máximo 4000 caracteres. String tipoarea de área (véase sección: 5.2: Tabla Valores: Área). String fechainiciovigencia Fecha en la cual el área empieza a ser vigente. date fechainiciovigencia Fecha en la cual el área finaliza. Date uriarea URI que identifica unívocamente al área a actualizar. String borrada Campo que determina si el área ha sido borrada o no. boolean CU-MSJ-AREA-06: OBTENER ÁREAS Permite obtener todas las áreas asociadas a un Organismo dado que no hayan sido borradas. En caso de éxito, la operación devolverá la lista de áreas asociadas al Organismo indicado. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.1:Área Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a

25 Página 25 de 127 Ejemplo de Entrada xmlns:ser=" <ser:obtenerarea> </ser:obtenerarea> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. No hay parámetros Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a

26 Página 26 de 127 Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:obtenerareasresponse> <ser:areas> <ser:area> <dom:nombrearea>nombre_area_1</dom:nombrearea> <dom:descripcion>descripcionnueva</dom:descripcion> <dom:tipoarea>general</dom:tipoarea> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> <dom:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xx1</dom:uriarea> <dom:borrada>false</dom:borrada> </ser:area> <ser:area> <dom:nombrearea>nombre_area_2</dom:nombrearea> <dom:descripcion>descripcion2</dom:descripcion> <dom:tipoarea>general</dom:tipoarea> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> <dom:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xx2</dom:uriarea> <dom:borrada>false</dom:borrada> </ser:area> </ser:areas> </ser:obtenerareasresponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. nombrearea Nombre asignado al área. Este nombre debe de ser único, es decir, un organismo no puede crear dos áreas con el mismo nombre, tiene un tamaño máximo de 255 caracteres. descripcion asociada al área. Debe de contener como máximo 4000 caracteres. tipoarea de área (véase sección: 5.2: Tabla Valores: Área). fechainiciovigencia Fecha en la cual el área empieza a ser vigente. date fechainiciovigencia Fecha en la cual el área finaliza. date uriarea URI que identifica unívocamente al área a actualizar. borrada Campo que determina si el área ha sido borrada o no. boolean

27 3.1.7 Página 27 de 127 CU-MSJ-AREA-07: BUSCAR ÁREAS Permite buscar áreas en base a un criterio de búsqueda. Si se desea, el resultado de la búsqueda se podrá obtener paginado para evitar resultados masivos. En caso de éxito, la operación devolverá la lista de áreas encontradas. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.1:Área Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:buscarareas> <ser:criteriobusqueda> <dom:nombrearea>anuncio</dom:nombrearea> </ser:criteriobusqueda>

28 Página 28 de 127 </ser:buscarareas> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uritercero URI del tercero del cual se de desea saber en que áreas está suscrito. nombrearea Nombre del área que se desea buscar. Tiene un tamaño máximo de 255 caracteres. tipoarea de área (véase sección: 5.2: Tabla Valores: Área).. fechavigencia Fecha que permite buscar aquellas áreas que estén vigentes en la fecha indicada. date uriprocedimiento En aquellos casos en que el área sea de tipo procedimiento, este campo contendrá al URI del procedimiento asociado, un organismo no puede tener más de un área asociada al mismo procedimiento. borrada Permite reir la búsqueda de las áreas a aquellas que se hayan borrado o no. boolean posicionprimerresultado Posición del primer resultado a devolver en aquellas búsquedas en que se desee paginación int numeroresultados Máximo número de resultados devueltos en la búsqueda. int Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación.

29 Página 29 de 127 Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:buscarareasresponse> <ser:resultado> <ser:areas> <ser:area> <dom:nombrearea>nombre_area_1</dom:nombrearea> <dom:descripcion>descripcionnueva</dom:descripcion> <dom:tipoarea>general</dom:tipoarea> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> <dom:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</dom:uriarea> <dom:borrada>false</dom:borrada> </ser:area> </ser:areas> <ser:numerototalresultados>1</ser:numerototalresultados> </ser:resultado> </ser:buscarareasresponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. nombrearea Nombre asignado al área. Este nombre debe de ser único, es decir, un organismo no puede crear dos áreas con el mismo

30 Página 30 de 127 nombre, tiene un tamaño máximo de 255 caracteres. descripcion asociada al área. Debe de contener como máximo 4000 caracteres. tipoarea de área (véase sección: 5.2: Tabla Valores: Área). fechainiciovigencia Fecha en la cual el área empieza a ser vigente. date fechainiciovigencia Fecha en la cual el área finaliza. date uriprocedimiento En aquellos casos en que el área sea de tipo procedimiento, este campo contendrá al URI del procedimiento asociado, un organismo no puede tener más de un área asociada al mismo procedimiento. uriarea URI que identifica unívocamente al área a actualizar. borrada Campo que determina si el área ha sido borrada o no. boolean numerototalresultados Número total de áreas que concuerdan con la búsqueda seleccionada. Nótese que este valor puede o no coincidir con el número total de áreas devuelto en la consulta, que viene fijado por numeroresultados. int CU-MSJ-AREA-08: OBTENER SUSCRIPCIONES Permite obtener las suscripciones existentes para un área determinada. En caso de éxito, la operación devolverá la lista de suscripciones asociadas al área. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.1:Área Exception ). Interfaz: Entrada del Servicio:

31 Página 31 de 127 A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" <ser:obtenersuscripciones> <ser:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</ser:uriarea> </ser:obtenersuscripciones> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uriarea URI que identifica unívocamente al área a actualizar. String Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación.

32 Página 32 de 127 Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:obtenersuscripcionesresponse> <ser:suscripciones> <ser:suscripcion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx1</dom:uritercero> <dom:enviarmensajetelefono>true</dom:enviarmensajetelefono> <dom:enviarmensajecorreoelectronico>true</dom:enviarmensajecorreoelectronico> </ser:suscripcion> <ser:suscripcion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx2</dom:uritercero> <dom:enviarmensajetelefono>false</dom:enviarmensajetelefono> <dom:enviarmensajecorreoelectronico>true</dom:enviarmensajecorreoelectronico> </ser:suscripcion> </ser:suscripciones> </ser:obtenersuscripcionesresponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. uritercero URI que identifica unívocamente al tercero. String enviarmensajetelefono Expresa el deseo o no del tercero a recibir mensajes al área suscrita a través del teléfono. boolean enviarmensajecorreoele Expresa el deseo o no del tercero a recibir mensajes al área ctronico suscrita a través de correos electrónicos. boolean

33 3.1.9 Página 33 de 127 CU-MSJ-AREA-09: AÑADIR SUSCRIPCIONES Permite añadir nuevas suscripciones a un área determinada. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.1:Área Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:annadirsuscripciones> <ser:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</ser:uriarea> <ser:suscripciones> <dom:suscripcion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx4</dom:uritercero> <dom:enviarmensajetelefono>false</dom:enviarmensajetelefono> <dom:enviarmensajecorreoelectronico>true</dom:enviarmensajecorreoelectronico> </dom:suscripcion>

34 Página 34 de 127 <dom:suscripcion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx5</dom:uritercero> <dom:enviarmensajetelefono>true</dom:enviarmensajetelefono> <dom:enviarmensajecorreoelectronico>false</dom:enviarmensajecorreoelectronico> </dom:suscripcion> </ser:suscripciones> </ser:annadirsuscripciones> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uriarea URI que identifica unívocamente al área a actualizar. String uritercero URI que identifica unívocamente al tercero. String enviarmensajetelefono Expresa el deseo o no del tercero a recibir mensajes al área suscrita a través del teléfono. boolean enviarmensajecorreoele Expresa el deseo o no del tercero a recibir mensajes al área ctronico suscrita a través de correos electrónicos. boolean Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:annadirsuscripcionesresponse />

35 Página 35 de 127 A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. No hay parámetros CU-MSJ-AREA-10: ACTUALIZAR SUSCRIPCIONES Permite actualizar las suscripciones asignadas al área por las suscripciones pasada, es decir, elimina las suscripciones existentes y añade las suscripciones pasadas. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.1:Área Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a

36 Página 36 de 127 Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:actualizarsuscripciones> <ser:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</ser:uriarea> <ser:suscripciones> <dom:suscripcion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xxx</dom:uritercero> <dom:enviarmensajetelefono>true</dom:enviarmensajetelefono> <dom:enviarmensajecorreoelectronico>false</dom:enviarmensajecorreoelectronico> </dom:suscripcion> </ser:suscripciones> </ser:actualizarsuscripciones> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uriarea URI que identifica unívocamente al área a actualizar. String uritercero URI que identifica unívocamente al tercero. String enviarmensajetelefono Expresa el deseo o no del tercero a recibir mensajes al área suscrita a través del teléfono. boolean enviarmensajecorreoele Expresa el deseo o no del tercero a recibir mensajes al área ctronico suscrita a través de correos electrónicos. boolean Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación.

37 Página 37 de 127 Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:actualizarsuscripcionesresponse /> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. No hay parámetros CU-MSJ-AREA-11: ELIMINAR SUSCRIPCIONES Permite eliminar las suscripciones pasadas como parámetros del área indicada. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.1:Área Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación.

38 Página 38 de 127 Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:eliminarsuscripciones> <ser:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</ser:uriarea> <ser:suscripciones> <dom:suscripcion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xxx</dom:uritercero> <dom:enviarmensajetelefono>true</dom:enviarmensajetelefono> <dom:enviarmensajecorreoelectronico>false</dom:enviarmensajecorreoelectronico> </dom:suscripcion> </ser:suscripciones> </ser:eliminarsuscripciones> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uriarea URI que identifica unívocamente al área a actualizar. uritercero URI que identifica unívocamente al tercero. enviarmensajetelefono Expresa el deseo o no del tercero a recibir mensajes al área suscrita a través del teléfono. boolean enviarmensajecorreoele Expresa el deseo o no del tercero a recibir mensajes al área ctronico suscrita a través de correos electrónicos. boolean Salida del Servicio:

39 Página 39 de 127 A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:eliminarsuscripcionesresponse /> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. No hay parámetros CU-MSJ-AREA-12: ELIMINAR TODAS SUSCRIPCIONES Permite eliminar todas las suscripciones asignadas al área indicada. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.1:Área Exception ). Interfaz: Entrada del Servicio:

40 Página 40 de 127 A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:eliminartodassuscripciones> <ser:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</ser:uriarea> </ser:eliminartodassuscripciones> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uriarea URI que identifica unívocamente al área a actualizar. Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación.

41 Página 41 de 127 Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:eliminartodassuscripcionesresponse /> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. No hay parámetros CU-MSJ-AREA-13: EXISTE TERCERO EN ÁREA Permite conocer si ya existe una suscripción para un determinado tercero. En caso de éxito, la operación devolverá un valor indicando si existe o no la suscripción. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.1:Área Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación.

42 Página 42 de 127 Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:existesuscripcion> <ser:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</ser:uriarea> <ser:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xxx</ser:uritercero> </ser:existesuscripcion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uriarea URI que identifica unívocamente al área a actualizar. uritercero URI que identifica unívocamente al tercero. Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación.

43 Página 43 de 127 Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:existeterceroenarearesponse> <ser:existeterceroenarearesult> <ser:existe>true</ser:existe> </ser:existeterceroenarearesult> </ser:existeterceroenarearesponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. existe que indica o no la existencia del tercero en el área indicada. boolean CU-MSJ-AREA-14: OBTENER AUDITORÍA ÁREA Permite obtener una auditoría del área seleccionada. Interfaz:

44 Página 44 de 127 Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:obtenerauditoriaarea> <ser:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</ser:uriarea> </ser:obtenerauditoriaarea> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uriarea URI que identifica unívocamente al área. Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación.

45 Página 45 de 127 Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:obtenerauditoriaarearesponse> <ser:auditoriaareas> <dom:auditoriaarea> <dom:nombrearea>area_1</dom:nombrearea> <dom:descripcion> Nueva</dom:descripcion> <dom:tipoarea>general</dom:tipoarea> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> <dom:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</dom:uriarea> <dom:borrada>false</dom:borrada> <dom:uriauditoriaarea>platino://gobcan.es/servicios/edmyce/auditarea/xxx-xxxxxx</dom:uriauditoriaarea> <dom:auditfechaactualizacion> t10:00:05</dom:auditfechaactualizacion> <dom:auditusuario>user_1</dom:auditusuario> <dom:auditoperacionrealizada>create</dom:auditoperacionrealizada> </dom:auditoriaarea> </ser:auditoriaareas>

46 Página 46 de 127 </ser:obtenerauditoriaarearesponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. nombrearea Nombre asignado al área. Este nombre debe de ser único, es decir, un organismo no puede crear dos áreas con el mismo nombre, tiene un tamaño máximo de 255 caracteres. descripcion asociada al área. Debe de contener como máximo 4000 caracteres. tipoarea de área (véase sección: 5.2: Tabla Valores: Área). fechainiciovigencia Fecha en la cual el área empieza a ser vigente. date fechainiciovigencia Fecha en la cual el área finaliza. date uriarea URI que identifica unívocamente al área. uriprocedimiento En aquellos casos en que el área sea de tipo procedimiento, este campo contendrá al URI del procedimiento asociado, un organismo no puede tener más de un área asociada al mismo procedimiento. borrada Campo que determina si el área ha sido borrada o no. boolean uriauditoriaarea URI que identifica unívocamente a la auditoría del área. auditfechaactualizacion Fecha en la que se realizó la modificación en el área solicitada. datetime auditusuario Usuario que realizó la modificación en el área auditoperacionrealizada Operación realizada por el usuario en el área. (Véase sección 5.7: Tabla Valores: Auditoria Operaciones Realizadas) CU-MSJ-AREA-15: OBTENER AUDITORÍA SUSCRIPCIÓN Permite obtener una auditoría de las suscripciones asociadas al área auditada.

47 Página 47 de 127 Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:obtenerauditoriasuscripcion> <ser:uriauditarea>platino://gobcan.es/servicios/edmyce/auditarea/xxx-xxxxxx</ser:uriauditarea> </ser:obtenerauditoriasuscripcion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uriauditarea URI que identifica unívocamente a la auditoria del área. Salida del Servicio:

48 Página 48 de 127 A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:obtenerauditoriasuscripcionresponse> <ser:auditoriassuscripciones> <dom:auditoriasuscripcion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xxx</dom:uritercero> <dom:enviarmensajetelefono> Nueva</dom:enviarMensajeTelefono> <dom:enviarmensajecorreoelectronico></dom:enviarmensajecorreoelectronico> </dom:auditoriaarea> </ser:auditoriasuscripcion> </ser:obtenerauditoriasuscripcionresponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. uritercero URI que identifica unívocamente al tercero. enviarmensajetelefono Expresa el deseo o no del tercero a recibir mensajes al área boolean

49 Página 49 de 127 suscrita a través del teléfono. enviarmensajecorreoele Expresa el deseo o no del tercero a recibir mensajes al área ctronico suscrita a través de correos electrónicos boolean CU-MSJ-AREA-16: OBTENER VERSIÓN SERVICIO Permite obtener la versión del servicio desplegado. Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:getversion/> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación.

50 Página 50 de 127 No hay parámetros Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:getversionresponse> <ser:version> </ser:version> </ser:getversionresponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. Número de versión del servicio desplegado. El tipo de dato de la versión será la fecha de despliegue usando el siguiente formato: X.AAAAMMDD.0 dónde; version X: Versión de interfaz AAAA: Año en formato numérico de cuatro dígitos. MM: Mes en formato numérico de 2 dígitos. DD: Día en formato numérico de 2 dígitos.

51 3.2 Página 51 de 127 SERVICIO DE LISTAS DE DISTRIBUCIÓN El Servicio permite a los Organismos conformar las Listas de Distribución que podrán ser utilizadas en el envío de mensajes de oficio CU-MSJ-LD-01: CREAR LISTA DE DISTRIBUCIÓN Crear una nueva lista de distribución asociada al Organismo pertinente. Así mismo, si el cliente lo desea puede asignar miembros a la misma. En caso de éxito, la operación devolverá el identificador de la lista de distribución. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.2:Lista distribución Exception ).

52 Página 52 de 127 Interfaz: Entrada del servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:crearlistadistribucion> <ser:listadistribucion> <dom:nombrelistadistribucion>nombrelistadistribucion_1</dom:nombrelistadistribucion> <dom:descripcion></dom:descripcion> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia>

53 Página 53 de 127 </ser:listadistribucion> <ser:miembroslistadistribucion> <dom:miembrolistadistribucion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx1</dom:uritercero> </dom:miembrolistadistribucion> <dom:miembrolistadistribucion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx2</dom:uritercero> </dom:miembrolistadistribucion> </ser:miembroslistadistribucion> </ser:crearlistadistribucion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. nombrelistadistribucion Nombre asignado a la lista de distribución. Este nombre debe de ser único, es decir, un organismo no puede crear dos listas de distribución con el mismo nombre, tiene un tamaño máximo de 255 caracteres. descripcion asociada al área. Debe de contener como máximo 4000 caracteres. fechainiciovigencia Fecha en la cual la lista de distribución empieza a ser vigente. date fechainiciovigencia Fecha en la cual la lista de distribución finaliza. date uritercero URI que identifica unívocamente al tercero. Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a

54 Página 54 de 127 Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:crearlistadistribucionresponse> <ser:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxxx</ser:urilistadistribucion> </ser:crearlistadistribucionresponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. urilistadistribucion URI que identifica unívocamente a la lista de distribución creada CU-MSJ-LD-02: ACTUALIZAR LISTA DE DISTRIBUCIÓN Permite actualizar los datos asociados a una lista de distribución registrados en el Servicio. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.2:Lista distribución Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación.

55 Página 55 de 127 Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:actualizarlistadistribucion> <ser:listadistribucion> <dom:nombrelistadistribucion>nombrelistadistribucion_1</dom:nombrelistadistribucion> <dom:descripcion> NUEVA</dom:descripcion> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> <dom:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxxx</dom:urilistadistribucion> <dom:borrada>false</dom:borrada> </ser:listadistribucion> </ser:actualizarlistadistribucion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. nombrelistadistribucion Nombre asignado a la lista de distribución. Este nombre debe de ser único, es decir, un organismo no puede crear dos listas de distribución con el mismo nombre, tiene un tamaño máximo de 255 caracteres.

56 Página 56 de 127 descripcion asociada al área. Debe de contener como máximo 4000 caracteres. fechainiciovigencia Fecha en la cual la lista de distribución empieza a ser vigente. date fechainiciovigencia Fecha en la cual la lista de distribución finaliza. date urilistadistribucion URI que identifica unívocamente a la lista de distribución. borrada Indica si la lista de distribución esta marcada como borrada o no. boolean Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:actualizarlistadistribucionresponse /> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. No hay parámetros

57 3.2.3 Página 57 de 127 CU-MSJ-LD-03: ACTUALIZAR LISTA DE DISTRIBUCIÓN Y MIEMBROS Permite actualizar una nueva lista de distribución asociada al Organismo pertinente, así como los miembros asociados a la mismo. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.2:Lista distribución Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación.

58 Página 58 de 127 Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:actualizarlistadistribucionymiembros> <ser:listadistribucion> <dom:nombrelistadistribucion>nombrelistadistribucion_1</dom:nombrelistadistribucion> <dom:descripcion></dom:descripcion> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> <dom:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxxx</dom:urilistadistribucion> <dom:borrada>false</dom:borrada> </ser:listadistribucion> <ser:miembroslistadistribucion> <dom:miembrolistadistribucion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx1</dom:uritercero> </dom:miembrolistadistribucion>

59 Página 59 de 127 <dom:miembrolistadistribucion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx2</dom:uritercero> </dom:miembrolistadistribucion> </ser:miembroslistadistribucion> </ser:actualizarlistadistribucionymiembros> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. nombrelistadistribucion Nombre asignado a la lista de distribución. Este nombre debe de ser único, es decir, un organismo no puede crear dos listas de distribución con el mismo nombre, tiene un tamaño máximo de 255 caracteres. descripcion asociada al área. Debe de contener como máximo 4000 caracteres. fechainiciovigencia Fecha en la cual la lista de distribución empieza a ser vigente. date fechainiciovigencia Fecha en la cual la lista de distribución finaliza. date urilistadistribucion URI que identifica unívocamente a la lista de distribución. uritercero URI que identifica unívocamente al tercero. borrada Indica si la lista de distribución esta marcada como borrada o no. boolean Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a

60 Página 60 de 127 Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:actualizarlistadistribucionymiembros /> CU-MSJ-LD-04: ELIMINAR LISTA DE DISTRIBUCIÓN Permite eliminar todos los datos asociados a una lista de distribución así como todos los miembros que hayan sido asignados a la misma. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.2:Lista distribución Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom="

61 Página 61 de 127 <ser:eliminarlistadistribucion> <ser:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxxx</ser:urilistadistribucion> </ser:eliminarlistadistribucion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. urilistadistribucion URI que identifica unívocamente a la lista de distribución. Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" <ser:eliminarlistadistribucionresponse /> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación.

62 Página 62 de 127 No hay parámetros CU-MSJ-LD-05: OBTENER LISTA DE DISTRIBUCIÓN Permite obtener los datos registrados para una lista de distribución determinada. En caso de éxito, la operación devolverá la lista de distribución solicitada. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.2:Lista distribución Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:obtenerlistadistribucion> <ser:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxxx</ser:urilistadistribucion>

63 Página 63 de 127 </ser:obtenerlistadistribucion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. urilistadistribucion URI que identifica unívocamente a la lista de distribución. Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:obtenerlistadistribucionresponse> <ser:listadistribucion> <dom:nombrelistadistribucion>nombrelistadistribucion_1</dom:nombrelistadistribucion> <dom:descripcion> NUEVA</dom:descripcion> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> <dom:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxxx</dom:urilistadistribucion> <dom:borrada>false</dom:borrada> </ser:listadistribucion> </ser:obtenerlistadistribucionresponse>

64 Página 64 de 127 A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. nombrelistadistribucion Nombre asignado a la lista de distribución. Este nombre debe de ser único, es decir, un organismo no puede crear dos listas de distribución con el mismo nombre, tiene un tamaño máximo de 255 caracteres. descripcion asociada al área. Debe de contener como máximo 4000 caracteres. fechainiciovigencia Fecha en la cual la lista de distribución empieza a ser vigente. date fechainiciovigencia Fecha en la cual la lista de distribución finaliza. date urilistadistribucion URI que identifica unívocamente a la lista de distribución. borrada Indica si la lista de distribución esta marcada como borrada o no. boolean CU-MSJ-LD-06: OBTENER LISTAS DE DISTRIBUCIÓN Permite obtener los datos registrados para todas las listas de distribución asociadas al Organismo indicado. En caso de éxito, la operación devolverá una lista conteniendo todas las listas de distribución solicitadas. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.2:Lista distribución Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación.

65 Página 65 de 127 Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:obtenerlistasdistribucion> </ser:obtenerlistasdistribucion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. No hay parámetros Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación.

66 Página 66 de 127 Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:obtenerlistasdistribucionresponse> <ser:listasdistribucion> <ser:listadistribucion> <dom:nombrelistadistribucion>nombrelistadistribucion_1</dom:nombrelistadistribucion> <dom:descripcion></dom:descripcion> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> <dom:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxx1</dom:urilistadistribucion> <dom:borrada>false</dom:borrada> </ser:listadistribucion> <ser:listadistribucion> <dom:nombrelistadistribucion>nombrelistadistribucion_2</dom:nombrelistadistribucion> <dom:descripcion> NUEVA</dom:descripcion> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> <dom:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxx2</dom:urilistadistribucion> <dom:borrada>false</dom:borrada> </ser:listadistribucion> </ser:listasdistribucion> </ser:obtenerlistasdistribucionresponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación.

67 Página 67 de 127 nombrelistadistribucion Nombre asignado a la lista de distribución. Este nombre debe de ser único, es decir, un organismo no puede crear dos listas de distribución con el mismo nombre, tiene un tamaño máximo de 255 caracteres. descripcion asociada al área. Debe de contener como máximo 4000 caracteres. fechainiciovigencia Fecha en la cual la lista de distribución empieza a ser vigente. date fechainiciovigencia Fecha en la cual la lista de distribución finaliza. date urilistadistribucion URI que identifica unívocamente a la lista de distribución. borrada Indica si la lista de distribución esta marcada como borrada o no. boolean CU-MSJ-LD-07: BUSCAR LISTAS DE DISTRIBUCIÓN Permite buscar listas de distribución en base a un criterio de búsqueda. Si se desea, el resultado de la búsqueda se podrá obtener paginado para evitar resultados masivos. En caso de éxito, la operación devolverá una lista conteniendo todas las listas de distribución solicitadas. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.2:Lista distribución Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación.

68 Página 68 de 127 Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:buscarlistasdistribucion> <ser:criteriobusqueda> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xxx</dom:uritercero> </ser:criteriobusqueda> </ser:buscarlistasdistribucion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uritercero URI del tercero por el cual se desea ralizar la búsqueda. Si este parámetro es añadido, el servicio dará todas aquellas listas de distribución en las que el tercero sea miembro de ella. nombrelistadistribucion Nombre asignado a la lista de distribución por el cual se desea hacer la búsqueda de las listas de distribución. fechavigencia Fecha en la cual la lista de distribución será vigente. Si este parámetro es rellenado, el servicio devolverá aquellas listas de distribución que será vigentes en la fecha pasada. date borrada Permite reir la búsqueda de las listas de distribución a aquellas que se hayan borrado o no. boolean posicionprimerresultado Posición del primer resultado a devolver en aquellas búsquedas en que se desee paginación int numeroresultados Máximo número de resultados devueltos en la búsqueda. int Salida del Servicio:

69 Página 69 de 127 A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:buscarlistasdistribucionresponse> <ser:resultado> <ser:listasdistribucion> <dom:listadistribucion> <dom:nombrelistadistribucion>nombrelistadistribucion_1</dom:nombrelistadistribucion> <dom:descripcion> NUEVA</dom:descripcion> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> <dom:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxxxxx-xxx</dom:urilistadistribucion> <dom:borrada>false</dom:borrada> </dom:listadistribucion> </ser:listasdistribucion> <ser:numerottalresultados>1</ser:numerottalresultados> <ser:resultado> </ser:buscarlistasdistribucionresponse>

70 Página 70 de 127 A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. nombrelistadistribucion Nombre asignado a la lista de distribución. Este nombre debe de ser único, es decir, un organismo no puede crear dos listas de distribución con el mismo nombre, tiene un tamaño máximo de 255 caracteres. descripcion asociada al área. Debe de contener como máximo 4000 caracteres. fechainiciovigencia Fecha en la cual la lista de distribución empieza a ser vigente. date fechainiciovigencia Fecha en la cual la lista de distribución finaliza. date urilistadistribucion URI que identifica unívocamente a la lista de distribución. borrada Indica si la lista de distribución esta marcada como borrada o no. boolean numerototalresultados Número total de listas de distribución que concuerdan con la búsqueda seleccionada. Nótese que este valor puede o no coincidir con el número total de listas de distribución devuelto en la consulta, que viene fijado por numeroresultados. int CU-MSJ-LD-08: AÑADIR MIEMBROS LISTA DE DISTRIBUCIÓN Permite añadir un nuevo miembro a la lista de distribución indicada. Si este miembro ya existe no será añadido. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.2:Lista distribución Exception ). Interfaz:

71 Página 71 de 127 Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:annadirmiembroslistadistribucion> <ser:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxxx</ser:urilistadistribucion> <ser:miembroslistadistribucion> <dom:miembrolistadistribucion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx1</dom:uritercero> </dom:miembrolistadistribucion> <dom:miembrolistadistribucion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx2</dom:uritercero> </dom:miembrolistadistribucion> </ser:miembroslistadistribucion> </ser:annadirmiembroslistadistribucion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. urilistadistribucion URI que identifica unívocamente a la lista de distribución.

72 uritercero URI que identifica unívocamente al tercero. Página 72 de 127 Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:annadirmiembroslistadistribucionresponse /> CU-MSJ-LD-09: ACTUALIZAR MIEMBROS LISTA DE DISTRIBUCIÓN Permite actualizar la lista de miembros asignados a una lista de distribución: se eliminarán todos los miembros existentes en la lista de distribución y se añadirán los miembros indicados en la operación. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.2:Lista distribución Exception ). Interfaz:

73 Página 73 de 127 Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:actualizarmiembroslistadistribucion> <ser:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxxx</ser:urilistadistribucion> <ser:miembroslistadistribucion> <dom:miembrolistadistribucion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx1</dom:uritercero> </dom:miembrolistadistribucion> <dom:miembrolistadistribucion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx2</dom:uritercero> </dom:miembrolistadistribucion> </ser:miembroslistadistribucion> </ser:actualizarmiembroslistadistribucion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. urilistadistribucion URI que identifica unívocamente a la lista de distribución. uritercero URI que identifica unívocamente al tercero.

74 Página 74 de 127 Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:actualizarmiembroslistadistribucionresponse /> CU-MSJ-LD-10: ELIMINAR MIEMBROS LISTA DE DISTRIBUCIÓN Permite eliminar un determinado conjunto de miembros de una una lista de distribución. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.2:Lista distribución Exception ). Interfaz: Entrada del Servicio:

75 Página 75 de 127 A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:eliminarmiembroslistadistribucion> <ser:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxxx</ser:urilistadistribucion> <ser:miembroslistadistribucion> <dom:miembrolistadistribucion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx1</dom:uritercero> </dom:miembrolistadistribucion> </ser:eliminarmiembroslistadistribucion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. urilistadistribucion URI que identifica unívocamente a la lista de distribución. uritercero URI que identifica unívocamente al tercero. Salida del Servicio:

76 Página 76 de 127 A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:eliminarmiembroslistadistribucionresponse /> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. No hay parámetros CU-MSJ-LD-11: ELIMINAR TODOS LOS MIEMBROS LISTA DE DISTRIBUCIÓN Permite eliminar todos los miembros de una una lista de distribución. En caso de éxito, la operación no devolverá ningún parámetro. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.2:Lista distribución Exception). Interfaz: Entrada del Servicio:

77 Página 77 de 127 A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:eliminartodosmiembroslistadistribucion> <ser:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxxx</ser:urilistadistribucion> </ser:eliminartodosmiembroslistadistribucion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. urilistadistribucion URI que identifica unívocamente a la lista de distribución. Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida

78 Página 78 de 127 xmlns:ser=" xmlns:dom=" <ser:eliminartodosmiembroslistadistribucionresponse /> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. No hay parámetros CU-MSJ-LD-12: OBTENER MIEMBROS LISTA DE DISTRIBUCIÓN Permite obtener todos los miembros de una una lista de distribución. En caso de éxito, la operación devolverá la lista de los miembros de la lista de distribución. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.2:Lista distribución Exception ). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación.

79 Página 79 de 127 Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:eliminartodosmiembroslistadistribucion> <ser:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxxx</ser:urilistadistribucion> </ser:eliminartodosmiembroslistadistribucion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. urilistadistribucion URI que identifica unívocamente a la lista de distribución. Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida

80 Página 80 de 127 xmlns:ser=" xmlns:dom=" <ser:obtenermiembroslistadistribucionresponse > <ser:miembroslistadistribucion> <ser:miembrolistadistribucion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx1</dom:uritercero> </ser:miembrolistadistribucion> <ser:miembrolistadistribucion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx2</dom:uritercero> </ser:miembrolistadistribucion> </ser:miembroslistadistribucion> </ser:obtenermiembroslistadistribucionresponse> A continuación se detallan cada uno de los parámetros devueltos por la ejecución de la invocación de la operación. uritercero URI que identifica unívocamente al tercero CU-MSJ-LD-13: EXISTE TERCERO EN LISTA DE DISTRIBUCIÓN Permite comprobar si un determinado tercero ha sido ya asignado a la lista de distribución. En caso de éxito, la operación devolverá un valor indicando si el tercero está o no asignado. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.2:Lista distribución Exception ). Interfaz: Entrada del Servicio:

81 Página 81 de 127 A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" xmlns:dom=" <ser:existeterceroenlistadistribucion> <ser:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxxx</ser:urilistadistribucion> <ser:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xxx</ser:uritercero> </ser:existeterceroenlistadistribucion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. urilistadistribucion URI que identifica unívocamente a la lista de distribución. uritercero URI que identifica unívocamente al tercero. Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación.

82 Página 82 de 127 Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:existeterceroenlistadistribucionresponse> <ser:existe>true</ser:existe> </ser:existeterceroenlistadistribucionresponse> A continuación se detallan cada uno de los parámetros devueltos por la invocación de la operación. existe que indica la existencia o no del tercero en la lista de distribución indicada. boolean CU-MSJ-LD-14: OBTENER AUDITORÍA LISTA DISTRIBUCIÓN Permite obtener la auditoría asociada a una lista de distribución determinada. Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación.

83 Página 83 de 127 Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" <ser:obtenerauditorialistadistribucion> <ser:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxxx</ser:urilistadistribucion> </ser:obtenerauditorialistadistribucion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. urilistadistribucion URI que identifica unívocamente a la lista de distribución. String Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación.

84 Página 84 de 127 Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:obtenerauditorialistadistribucionresponse> <ser:auditoriaslistadistribucion> <dom:auditorialistadistribucion> <dom:nombrelistadistribucion>nombrelistadistribucion_1</dom:nombrelistadistribuionc> <dom:descripcion></dom:descripcion> <dom:fechainiciovigencia> </dom:fechainiciovigencia> <dom:fechafinvigencia> </dom:fechafinvigencia> <dom:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxxxxx-xxx</dom:urilistadistribucion> <dom:borrada>false</dom:borrada> <dom:uriauditorialistadistribucion>platino://gobcan.es/servicios/edmyce/auditlistadistribucion/xxxxxx-xxx</dom:uriauditorialistadistribucion> <dom:auditfechaactualizacion> t10:00:05</dom:auditfechaactualizacion> <dom:auditusuario>user_1</dom:auditusuario> <dom:auditoperacionrealizada>create</dom:auditoperacionrealizada> </dom:listadistribucion> </ser:auditoriaslistadistribucion> </ser:obtenerauditorialistadistribucionresponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación.

85 Página 85 de 127 nombrelistadistribucion Nombre asignado a la lista de distribución. Este nombre debe de ser único, es decir, un organismo no puede crear dos listas de distribución con el mismo nombre, tiene un tamaño máximo de 255 caracteres. descripcion asociada al área. Debe de contener como máximo 4000 caracteres. fechainiciovigencia Fecha en la cual la lista de distribución empieza a ser vigente. date fechainiciovigencia Fecha en la cual la lista de distribución finaliza. date urilistadistribucion URI que identifica unívocamente a la lista de distribución. borrada Indica si la lista de distribución esta marcada como borrada o no. boolean uriauditorialistadistribuci URI que identifica unívocamente a la auditoría de la lista de on distribución. auditfechaactualizacion Fecha en la que se realizó la modificación en la lista de distribución solicitada. datetime auditusuario Usuario que realizó la modificación en la lista de distribución. Operación realizada por el usuario en la lista de distribución. auditoperacionrealizada (Véase sección 5.7: Tabla Valores: Auditoria Operaciones Realizadas) CU-MSJ-LD-15: OBTENER AUDITORÍA MIEMBROS LISTA DISTRIBUCIÓN Permite obtener la auditoría de los miembros de una lista de distribución auditada. Interfaz: Entrada del Servicio:

86 Página 86 de 127 A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" <ser:obtenerauditoriamiembroslistadistribucion> <ser:uriauditorialistadistribucion>platino://gobcan.es/servicios/edmyce/auditlistadistribucion/xxxxxx-xxx</ser:uriauditorialistadistribucion> </ser:obtenerauditoriamiembroslistadistribucion> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uriauditorialistadistribuci URI que identifica unívocamente a auditoría de la lista de on distribución. Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación.

87 Página 87 de 127 Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" xmlns:dom=" <ser:obtenerauditoriamiembroslistadistribucionresponse> <ser:auditoriasmiembrolistadistribucion> <dom:auditoriamiembrolistadistribucion> <dom:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xxx</dom:uritercero> </dom:auditoriamiembrolistadistribucion> </ser:auditoriasmiembrolistadistribucion> </ser:obtenerauditoriamiembroslistadistribucionresponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. uritercero URI que identifica unívocamente a un tercero CU-MSJ-LD-16: OBTENER VERSIÓN SERVICIO Permite obtener la versión del servicio desplegado. Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación.

88 Página 88 de 127 Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:ser=" <ser:getversion/> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. No hay parámetros Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:ser=" <ser:getversionresponse> <ser:version> </ser:version>

89 Página 89 de 127 </ser:getversionresponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. Número de versión del servicio desplegado. El tipo de dato de la versión será la fecha de despliegue usando el siguiente formato: X.AAAAMMDD dónde; version X: Versión de interfaz. AAAA: Año en formato numérico de cuatro dígitos. MM: Mes en formato numérico de 2 dígitos. DD: Día en formato numérico de 2 dígitos.

90 3.3 Página 90 de 127 SERVICIO DE MENSAJES SALIENTES Este Servicio permite a los Organismos enviar mensajes ya sean de oficio o relacionados con una determinada área, así como obtener el estado de las remesas y mensajes generados en los envíos. Para los campos que recogen los textos a enviar en el mensaje (textosms, text ) se recomienza la utilización de codificaciones UTF8 o ISO para evitar la aparición de caracteres extraños en el mensaje CU-MSJ-MEN-01: ENVIAR MENSAJE OFICIO Permite enviar un mensaje de oficio a un determinado número de terceros. En caso de éxito, la operación devolverá el identificador de la remesa generada para el envío. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.3:Mensaje Exception ).

91 Página 91 de 127 Para poder realizar envíos de mensajes SMS se requiere la incorporación de unas determinadas cabeceras a la hora de utilizar este caso de uso que indican que usuario (Registrado en el servicio de SMS del Gobierno de Canarias) se va a utilizar para realizar el envío del mensaje (véase: 5.1:Incorporación de cabeceras de seguridad en la invocación del servicio). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:men=" xmlns:men1=" xmlns:com="

92 Página 92 de 127 <men:enviarmensajeoficio> <men:mensajedeoficio> <men1:canal>sms</men1:canal> <men1:textosms>texto SMS</men1:textoSms> <men1:telefonosmoviles> <com:telefonomovil> </com:telefonomovil> </men1:telefonosmoviles> <men1:uristerceros> <com:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xxx</com:uritercero> </men1:uristerceros> <men1:urislistasdistribuciones> <com:urilistadistribucion>platino://gobcan.es/servicios/edmyce/listadistribucion/xxx-xxxxxx</com:urilistadistribucion> </men1:urislistasdistribuciones> </men:mensajedeoficio> </men:enviarmensajeoficio> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. canal Canal utilizado para realizar el envío de mensajes. Los posibles valores son o SMS textosms Texto utilizado cuando el canal de envío es SMS. Este parámetro es requerido si el canal seleccionado es SMS. Puede contener como máximo 140 caracteres. texto Texto utilizado cuando el canal de envío es . Este parámetro es requerido si el canal seleccionado es . Puede contener como máximo 4000 caracteres. uritercero URI que identifica unívocamente a un tercero. urilistadistribucion URI que identifica unívocamente a una lista de distribución. telefonomovil Teléfono Móvil utilizado en el envío de mensajes. El servicio enviará un mensaje a este número si y solo si el canal elegido es SMS. correoelectronico Correo electrónico utilizado en el envío de mensajes. El servicio enviará un mensaje a este correo electrónico si y solo si el canal elegido es .

93 Página 93 de 127 Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:men=" xmlns:men1=" xmlns:com=" <men:enviarmensajeoficioresponse> <men:uriremesa>platino://gobcan.es/servicios/edmyce/remesa/xxx-xxx-xxx</men:uriremesa> </men:enviarmensajeoficioresponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. uriremesa URI que identifica unívocamente a la remesa creada CU-MSJ-MEN-02: ENVIAR MENSAJES OFICIO Permite enviar un conjunto de mensajes de oficio a un determinado número de terceros. En caso de éxito, la operación devolverá los identificadores de las remesas generadas para el envío. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.3:Mensaje Exception ).

94 Página 94 de 127 Para poder realizar envíos de mensajes SMS se requiere la incorporación de unas determinadas cabeceras a la hora de utilizar este caso de uso que indican que usuario (Registrado en el servicio de SMS del Gobierno de Canarias) se va a utilizar para realizar el envío del mensaje (véase: 5.1:Incorporación de cabeceras de seguridad en la invocación del servicio). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:men=" xmlns:men1="

95 Página 95 de 127 xmlns:com=" <men:enviarmensajesoficio> <men:mensajesdeoficio> <men1:mensajeoficio> <men1:canal> </men1:canal> <men1:texto >texto </men1:texto > <men1:uristerceros> <com:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx2</com:uritercero> </men1:uristerceros> <men1:correoselectronicos> </men1:correoselectronicos> </men1:mensajeoficio> <men1:mensajeoficio> <men1:canal>sms</men1:canal> <men1:textosms>texto SMS</men1:textoSms> <men1:uristerceros> <com:uritercero>platino://gobcan.es/servicios/terceros/xxx-xxx-xx1</com:uritercero> </men1:uristerceros> </men1:mensajeoficio> </men:mensajesdeoficio> </men:enviarmensajesoficio> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. canal Canal utilizado para realizar el envío de mensajes. Los posibles valores son o SMS textosms Texto utilizado cuando el canal de envío es SMS. Este parámetro es requerido si el canal seleccionado es SMS. Puede contener como máximo 140 caracteres. texto Texto utilizado cuando el canal de envío es . Este parámetro es requerido si el canal seleccionado es . Puede contener como máximo 4000 caracteres. uritercero URI que identifica unívocamente a un tercero. urilistadistribucion URI que identifica unívocamente a una lista de distribución. telefonomovil Teléfono Móvil utilizado en el envío de mensajes. El servicio enviará un mensaje a este número si y solo si el canal elegido es SMS. correoelectronico Correo electrónico utilizado en el envío de mensajes. El servicio enviará un mensaje a este correo electrónico si y solo

96 Página 96 de 127 si el canal elegido es . Salida del Servicio: A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:men=" xmlns:men1=" xmlns:com=" <men:enviarmensajesoficioresponse> <men:urisremesas> <com:uriremesa>platino://gobcan.es/servicios/edmyce/remesa/xxx-xxx-xx1</com:uriremesa> <com:uriremesa>platino://gobcan.es/servicios/edmyce/remesa/xxx-xxx-xx2</com:uriremesa> </men:urisremesas> </men:enviarmensajesoficioresponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. uriremesa URI que identifica unívocamente a la remesa creada.

97 3.3.3 Página 97 de 127 CU-MSJ-MEN-03: ENVIAR MENSAJE ÁREA Permite enviar un mensaje a cada uno de los terceros suscritos al área indicada, enviándole el mensaje por el canal que el tercero ha elegido, en caso de que se pase una lista de terceros, estos terceros deben de estar suscritos al área y sólo se le enviará el mensaje a los terceros seleccionados. En caso de éxito, la operación devolverá el identificador de la remesa generada para el envío. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.3:Mensaje Exception ). Para poder realizar envíos de mensajes SMS se requiere la incorporación de unas determinadas cabeceras a la hora de utilizar este caso de uso que indican que usuario (Registrado en el servicio de SMS del Gobierno de Canarias) se va a utilizar para realizar el envío del mensaje (véase: 5.1:Incorporación de cabeceras de seguridad en la invocación del servicio). Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a

98 Página 98 de 127 Ejemplo de Entrada xmlns:men=" xmlns:men1=" xmlns:com=" <men:enviarmensajearea> <men:mensajearea> <men1:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xxx</men1:uriarea> <men1:texto >texto si se hace un envío por </men1:texto > <men1:textosms>texto si se hace un envío por Sms</men1:textoSms> </men:mensajearea> </men:enviarmensajearea> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uriarea URI que identifica unívocamente al área para la que se quiere hacer el envío del mensaje. uriprocedimiento URI que identifica unívocamente a un procedimiento. Si se desea, se puede pasar el identificador del procedimiento y el servicio es el encargado de buscar el área asociada a este procedimiento para realizar el envío de mensajes. textosms Texto utilizado para enviar mensajes sms a los terceros suscritos al área. Este texto se utiliza si el tercero está suscrito al área y ha aceptado recibir información por este canal. Puede contener como máximo 140 caracteres. texto Texto utilizado para enviar mensajes de correos electrónicos a los terceros suscritos al área. Este texto se utiliza si el tercero está suscrito al área y ha aceptado recibir información por este canal. Puede contener como máximo 4000 caracteres. uritercero URI que identifica unívocamente a un tercero. Si se utiliza este parámetro, el tercero debe de estar suscrito al área y sólo se enviará mensajes a los terceros seleccionados. Salida del Servicio:

99 Página 99 de 127 A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:men=" xmlns:men1=" xmlns:com=" <men:enviarmensajearearesponse> <men:uriremesa>platino://gobcan.es/servicios/edmyce/remesa/xxx-xxx-xx1</com:uriremesa> </men:enviarmensajearearesponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. uriremesa URI que identifica unívocamente a la remesa creada CU-MSJ-MEN-04: ENVIAR MENSAJES ÁREA Permite enviar un conjunto de mensajes a cada uno de los terceros suscritos a las áreas indicadas, enviándole el mensaje por el canal que el tercero ha elegido, en caso de que se pase una lista de terceros, estos terceros deben de estar suscritos al área y sólo se le enviará el mensaje a los terceros seleccionados. En caso de éxito, la operación devolverá los identificadores de las remesas generadas para el envío. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.3:Mensaje Exception ).

100 Página 100 de 127 Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:men=" xmlns:men1=" xmlns:com=" <men:enviarmensajesarea> <men:mensajesarea> <men1:mensajearea>

101 Página 101 de 127 <men1:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xx1</men1:uriarea> <men1:texto >texto si se hace un envío por </men1:texto > <men1:textosms>texto si se hace un envío por Sms</men1:textoSms> </men1:mensajearea> <men1:mensajearea> <men1:uriarea>platino://gobcan.es/servicios/edmyce/area/xxx-xxx-xx2</men1:uriarea> <men1:texto >texto si se hace un envío por </men1:texto > <men1:textosms>texto si se hace un envío por Sms</men1:textoSms> <men1:uristerceros> <com:uritercero>platino://gobcan.es/servicios/terceros/xx-xx-x1</com:uritercero> <com:uritercero>platino://gobcan.es/servicios/terceros/xx-xx-x2</com:uritercero> </men1:uristerceros> </men1:mensajearea> </men:mensajesarea> </men:enviarmensajesarea> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uriarea URI que identifica unívocamente al área para la que se quiere hacer el envío del mensaje. uriprocedimiento URI que identifica unívocamente a un procedimiento. Si se desea, se puede pasar el identificador del procedimiento y el servicio es el encargado de buscar el área asociada a este procedimiento para realizar el envío de mensajes. textosms Texto utilizado para enviar mensajes sms a los terceros suscritos al área. Este texto se utiliza si el tercero está suscrito al área y ha aceptado recibir información por este canal. Puede contener como máximo 140 caracteres. texto Texto utilizado para enviar mensajes de correos electrónicos a los terceros suscritos al área. Este texto se utiliza si el tercero está suscrito al área y ha aceptado recibir información por este canal. Puede contener como máximo 4000 caracteres. uritercero URI que identifica unívocamente a un tercero. Si se utiliza este parámetro, el tercero debe de estar suscrito al área y sólo se enviará mensajes a los terceros seleccionados. Salida del Servicio:

102 Página 102 de 127 A continuación se muestra el modelo de datos que devuelve el Servicio en respuesta a una invocación con éxito de esta operación. Un ejemplo típico de respuesta de esta operación es el que se muestra a Ejemplo de Salida xmlns:men=" xmlns:men1=" xmlns:com=" <men:enviarmensajesarearesponse> <men:urisremesas> <com:uriremesa>platino://gobcan.es/servicios/edmyce/remesa/xxx-xxx-xx1</com:uriremesa> <com:uriremesa>platino://gobcan.es/servicios/edmyce/remesa/xxx-xxx-xx2</com:uriremesa> </men:urisremesas> </men:enviarmensajesarearesponse> A continuación se detallan cada uno de los parámetros devueltos en la invocación de la operación. uriremesa URI que identifica unívocamente a la remesa creada CU-MSJ-MEN-05: OBTENER REMESA Permite obtener la remesa solicitada. En caso de éxito, la operación devolverá la remesa solicitada. En caso de error, se devuelve un Fault indicando el error producido (véase sección 4.3:Mensaje Exception ).

103 Página 103 de 127 Interfaz: Entrada del Servicio: A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación. Un ejemplo típico de invocación de esta operación es el que se muestra a Ejemplo de Entrada xmlns:men=" xmlns:men1=" xmlns:com=" <men:obtenerremesa> <men:uriremesa>platino://gobcan.es/servicios/edmyce/remesa/xxx-xxx-xxx</men:uriremesa> </men:obtenerremesa> A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación. uriremesa URI que identifica unívocamente a la remesa que se quiere obtener.