3.1.17 CU-SPF-GS-17: Crear Documento

Permite crear un “documento de solicitud” en una solicitud de firma que no haya sido entregada para ser firmada y cuyo documento no haya sido ya creado previamente en la solicitud. En caso de éxito la operación no devolverá ningún parámetro. En caso de error, se devuelve una excepción indicando el error producido (véase sección “4.1: Solicitud Firma Exception”).

El formato permitido de los documentos a insertar en una solicitud del Portafirmas es el de “pdf”. El backoffice correspondiente deberá ser el encargado deberá realizar dicha comprobación.

A consecuencia de la limitación existente con nuestro proveedor de validaciones de firmas y certificados, @fima Plataforma, existe una restricción con el tamaño máximo de los ficheros que se pueden subir como documentos principales al Portafirmas que es de 8.8MB.

En el caso de suministrar la URI de un documento del gestor documental de PLATINO, su metainformación debe cumplir estas condiciones:

  • En caso de contener una firma, ésta debe ser válida.

  • No debe contener un sellado.

  • El tamaño del documento principal no puede ser superior a 8.8MB.

  • No debe contener información de registro.

  • Si el documento esta protegido por contraseña tanto apertura como modificación, solo será aceptado como anexo; nunca como documento principal de la solicitud.

  • El documento no puede contener ni formularios editables, ni las siguientes anotaciones:

    • Caja de Texto

    • Ficheros Adjuntos al propio PDF.

    • Formas.

Interfaz

diagram
Figure 1. Diagrama de secuencia

Entrada al servicio

A continuación se muestra el modelo de datos que se utiliza cuando se desea invocar a esta operación.

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

A continuación se detallan cada uno de los parámetros pasados en la invocación de la operación.

Table 1. Parámetros de entrada
Parámetro Descripción Tipo

uriSolicitudFirma

URI de la solicitud de firma a la que se quiere anexar el documento.

String (véase “5.3.1: Simple: Uri Simple Type”)

documento

Documento que se desea añadir a la solicitud.

DocumentoSolicitudFirmaType

tipoDocumentacion

Tipo de documento añadido. Este campo sólo puede tomar dos valores PRINCIPAL (Si se firmar) y ANEXA (No se firma).

TipoDocumentacionEnumType

Un ejemplo típico de invocación de esta operación es el que se muestra a continuación.

Ejemplo de entrada al servicio.
<soapenv:Envelope
     xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
     xmlns:sol="http://platino.gobcan.es/servicios/portafirmas/servicio/solicitudfirma"
     xmlns:dom="http://platino.gobcan.es/servicios/portafirmas/dominio">
  <soapenv:Header />
  <soapenv:Body>
    <sol:crearDocumento>
      <sol:uriSolicitud>platino://gobcan.es/servicios/portafirmas/solicitudfirma/cb6a3c1e-84c8-48cc-bc41-f8be4a36dd55</sol:uriSolicitud>
      <sol:documento>
        <dom:uriDocumento>urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxx001</dom:uriDocumento>
      </sol:documento>
      <sol:tipoDocumentacion>PRINCIPAL</sol:tipoDocumentacion>
    </sol:crearDocumento>
  </soapenv:Body>
</soapenv:Envelope>

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.

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

A continuación se detallan cada uno de los parámetros devueltos tras la invocación de la operación.

Table 2. Parámetros de salida
Parámetro Descripción Tipo

uriDocumentoSolicitudFirma

URI del “Documento Solicitud” creado la solicitud de firma seleccionada.

String (véase “5.3.1: Simple: Uri Simple Type“)

Un ejemplo típico de respuesta de esta operación es el que se muestra a continuación.

Ejemplo de respuesta del servicio.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <crearDocumentoResponse
         xmlns="http://platino.gobcan.es/servicios/portafirmas/servicio/solicitudfirma"
         xmlns:ns2="http://platino.gobcan.es/servicios/portafirmas/dominio"
         xmlns:ns3="http://platino.gobcan.es/servicios/portafirmas/excepcion/solicitudfirma">
      <uriDocumentoSolicitudFirma>platino://gobcan.es/servicios/portafirmas/documento/0ddd66ed-fd55-4a76-a205-36c50a4c9883</uriDocumentoSolicitudFirma>
    </crearDocumentoResponse>
  </soapenv:Body>
</soapenv:Envelope>