firmaDocumentos
La operación firmaDocumentos permite enviar un o varios documentos a portafirmas e indicar el expediente donde deben almacenarse una vez firmados.
Esta operación genera un evento en la bandeja de entrada. Este evento permite verificar la entrada de la petición de firma en el Portafirmas y conocer cuando los documentos de la petición han sido firmado o rechazados.
Los documentos son recuperados automáticamente por SANDRA desde el portafirmas y almacenados en el expediente, sin que tenga que realizar ninguna tarea más por parte de la aplicación sectorial.
Las credenciales (aplicacion, apikey e idTransacción) y los parámetros codigoProcedimiento, departamentoTramitador y clase de documento son validados como se indica aquí
En este caso la referencia del expediente (parámetro referenciaExpediente) y la carpeta (parámetro carpeta) son opcionales. Si no se indica, los documentos quedan asociados al evento de la bandeja y deben ser incorporados por el gestor desde DELFOS o desde su propia aplicación (usando la operación generaExpedienteSolicitud).
Lo indicado en el párrafo anterior no está implementado aún. En la operación actual si no se indica el expediente, tras la firma del documento se crea un expediente donde se incorpora el documento firmado.
En cuanto a los parámetros propios del portafirmas:
FlujoOrdenado: Si es “true” los firmantes realizaran la firma en secuencia indicada en los pasos. Por defecto “true”. En caso contrario pueden firmar en cualquier orden.
RechazoPasoUnFirmante: Si es “true" el rechazo de la firma de un solo firmante supone el rechazo completo de la firma. Por defecto “true”.
Tanto flujoOrdenado como rechazoPasoUnFirmante son parámetros opcionales en el interfaz de SANDRA: firmaDocumentos. En el caso de que no vengan en la invocación se aplicaran los valores por defecto.
La solicitud de firma puede tener distintos firmantes en distintos pasos, en este método solo se permite un firmante por paso.
PasoFirma: Para cada paso de firma
- pasoFirma.Descripción: El texto especificado en el interfaz.
- Firmante.identificador: El código de firmante especificado en el interfaz. (en nuestro caso es el Correo electrónico sin @carm.es)
Clase de documento: Es un documento DA definido por el gestor para este procedimiento.
El parametro sufijoNombreNatural sirve para añadir un texto al "nombre natural" del documento. El nombre natural es un metadato obligatorio ENI, que se obtiene de la clase de documento definida en DEXEL (sandra-suite-v1.0.22 PRO 16/07/2020)
Por ejemplo: si el documento que se da de alta es un DA036, el nombre natural por defecto es "Informe". Se puede añadir el sufijoNombreNatural " de fiscalización" (SANDRA no añade el espacio por defecto al concatenar, por si se quieren añadir signos de puntuación, por ejemplo). El nombre natural que se incorporara al documento y que verá el gestor en el expediente será "Informe de fiscalizacion". También en expedientes con pluralidad de interesados, se puede utilizar para facilitar la identificación visual en el expediente de los documentos que solo afecten a alguno de ellos, añadiendo el nombre o nif como sufijo del nombre natural.
También aparecerá en la descripción del documento en el portafirmas, concatenado al código y nombre natural del documento, es decir, que la descipción del documento en el Portafirmas sigue el patrón: <codigo_clase_documento> <nombre natural><sufijo nombre natural>, reemplazando, tanto en el nombre natural como en el sufijo, los caracteres no permitidos por Portafirmas:
- new String[] {"\", "/", "|", ":", "*", "?", """, "<", ">"}, -- Estos no los permite Portafirmas
- new String[] {"-", "-", "-", "-", "", "", "'", "'", "'"}); -- Los reemplazamos por estos, antes de hacer la llamada a guardar documento en Portafirmas
Contenido: El un fichero PDF a firmar en base 64.
En el portafirmas, el firmante dispondrá de una solicitud de firma con la siguiente información:
- Asunto: se concatenara el código de procedimiento con el código de expediente. “Expediente ES_A14013863_2017_EXP_113 - Procedimiento 345”
- Descripción: Denominación del procedimiento p.e “Alta de instalaciones eléctricas”
La operación devuelve los siguientes valores:**
- numeroEvento: la referencia del evento de la bandeja de entrada.
- IdSolicitud: la referencia de la solicitud realizada al portafirmas.
- IdDocumentos: las referencias que el portafirmas ha dado a los documentos incluidos en la petición.
En la bandeja de entrada se crea un evento del tipo 09-FIRMA en fase 03- FIRMA SOLICITADA. Indica que se ha iniciado la petición de firma. ver eventos
Cuando se concluye la firma (o el flujo de firma), la fase de este evento se modificara a
- 04-FIRMA REALIZADA si se han firmado todos los documentos de la petición
- 05-FIRMA RECHAZADA si se han rechazado todos los documentos de la petición.
- 13-FIRMA REALIZADA PARCIALMENTE si se han firmado algunos de los documentos y otros se han rechazo.
La fase 04 0 13 supone la incorporación de los documentos firmados al expediente, salvo en los casos indicados anteriormente.
El campo referenciaOrigen asociado a este evento contendrá la referencia IdSolicitud generada por el portafirmas, asociado además a cada uno de los documentos firmados. El ámbito de la referenciaOrigen es portafirmas. La referenciaEa de cada uno de los documentos firmados, cuando ya están en Sandra, contiene la referencia que el Portafirmas ha dado al documento.
En caso de error devuelve alguno de los errores indicados aquí