OBTENER CABECERAS GENERAL

Este caso de uso le proporciona al cliente obtener las cabeceras de los mensajes que cumplan unas determinadas condiciones de filtrado para el actor que realiza la petición. El servidor LexNET devuelve como salida del servicio una lista con las cabeceras de los mensajes (de cada mensaje: identificador LexNET más datos de origen y destino y datos adicionales) que cumplen con los parámetros de búsqueda. Es condición indispensable para superar la homologación realizar el filtrado por los siguientes campos:

rango de fechas (obligatorio)
tipo de mensaje (opcional)
sólo mensajes pendientes de descarga (obligatorio)

En el caso de que para la entidad conectada sea obligatorio el envío de una verificación de lectura antes de la descarga del mensaje, la petición a este servicio sin haber enviado previamente la verificación de lectura, devolvería únicamente como respuesta el identificador del mensaje en LexNET y la fecha de envío del mismo.

Por tanto, para este tipo de entidades, la secuencia de petición a los servicios web LexNET para la descarga de la cabecera de un mensaje o del mensaje completo sería la siguiente: primero se enviaría la verificación de lectura (petición al servicio EnviarVerificacionLecturaGeneral e EnviarBloqueGeneral), posteriormente se descargaría el mensaje completo (petición al servicio DescargarMensaje y mensajeDescargadoACK).

Interfaz

A continuación se detallarán los datos de entrada necesarios que necesita este caso de uso para su ejecución. Además se describe la respuesta del servicio a la ejecución del mismo.

Figure 1. Diagrama de secuencia

Entrada al servicio

El parámetro de entrada a este método del servicio es el siguiente:

Figure 2. Campos de la petición como un diagrama de clases

Ejemplo de entrada al servicio.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ent="http://platino.gobcan.es/servicios/lexnet/entidades">
  <soapenv:Header/>
  <soapenv:Body>
    <ent:ObtenerCabecerasGeneral>
      <ent:ObtenerCabecerasGeneralIn>
      <![CDATA[<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
        <ns2:mensajeWS xmlns:ns2="https://wslexnet.webservices.lexnet/3.26">
            <solicitudGetCabeceras>
                <idSesion>1189893722</idSesion>
                <idAplicacion>PLATINO</idAplicacion>
                <idSujetoEntidadTC>3501606S08</idSujetoEntidadTC>
                <fechaInicio>2021-01-04T11:27:21.251Z</fechaInicio>
                <fechaFin>2021-02-03T11:27:21.251Z</fechaFin>
                <soloPendientes>true</soloPendientes>
                <estadoMensaje>true</estadoMensaje>
            </solicitudGetCabeceras>
        </ns2:mensajeWS>]]>
      </ent:ObtenerCabecerasGeneralIn>
    </ent:ObtenerCabecerasGeneral>
  </soapenv:Body>
</soapenv:Envelope>

Salida del servicio

Figure 3. Campos de la respuesta como un diagrama de clases

Ejemplo de respuesta del servicio.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ns2:ObtenerCabecerasGeneralResponse xmlns:ns2="http://platino.gobcan.es/servicios/lexnet/entidades">
      <ns2:ObtenerCabecerasGeneralOut>
        <![CDATA[<?xml version="1.0" encoding="ISO-8859-1"?>
        <mensajeWS xmlns="https://wslexnet.webservices.lexnet/3.26">
            <respuestaGetCabeceras xmlns="">
                <cabeceras/>
            </respuestaGetCabeceras>
        </mensajeWS>]]>
      </ns2:ObtenerCabecerasGeneralOut>
    </ns2:ObtenerCabecerasGeneralResponse>
  </soap:Body>
</soap:Envelope>