Saltar al contenido principal
Version: 1.7.2

Implementación de Sellos

A partir de EEI v1.6.0, los módulos componentes de la versión de Expediente Electrónico Integrado son:

  • Sudocu
  • Huarpe
  • Araí Usuarios
  • Araí Documentos
  • Araí Personas (nuevo)

Con respecto a la funcionalidad de sellos dinámicos, una vez desplegada la versión, se puede configurar el ambiente de tres formas

  • Ambiente sin Stamper (sin firma digital, ni estampado)
  • Ambiente con Stamper tradicional (único disponible hasta EEI v1.5.12)
  • Ambiente con Sellos Dinámicos (disponible a partir de EEI v1.6.0)

Ambiente sin Stamper

En esta modalidad los documentos que se crean en Araí Documentos, no son firmados electrónicamente por el sistema y por tanto tampoco se estampan datos de autorización de los mismos.

Parámetros de configuración para ambiente sin stamper

Editar el archivo docs.env de Araí, las siguientes líneas

STAMPER_ACTIVO=0
STAMPER_SELLOS_ACTIVO=0

Editar el archivo huarpe.env de Araí, las siguientes líneas

BUNDLE_DOCUMENTOS_SELLOS_ACTIVO=0
BUNDLE_DOCUMENTOS_SELLOS_EDITABLES=0

Ambiente con Stamper tradicional

Expediente Electrónico Integrado desde su inicio ofrece la posibilidad de activar la firma electrónica y estampado de documentos. Al hacerlo cada documento que es creado en Araí documentos contiene las siguientes características:

  • En la creación del documento.
    • Creación de hoja de firmas, se agrega una hoja al final del PDF destinada a estampar todas las firmas electrónicas del proceso de autorización.
    • Firma electrónica del sistema, en la razón se inserta el texto Cargado por SIU-Documentos
    • Estampa de la firma electrónica en la hoja de firmas.
  • En la autorización del documento.
    • Firma electrónica del sistema, en la razón se inserta el texto Autorizado por: "nombre y apellido del usuario Araí"
    • Estampa de la firma electrónica en la hoja de firmas.

Datos que se estampan en el sello de creación:

  • Sistema: sistema de origen
  • Firmado por: nombre del certificado
  • Fecha: fecha de creación del documento
  • Razón: campo razon de la firma

Las etiquetas son fijas y no son configurables, su contenido varía en función al documento, la única personalización posible es el cambio del logo.

Parámetros de configuración para ambiente con stamper tradicional

Editar el archivo docs.env de Araí, las siguientes líneas

STAMPER_ACTIVO=1
STAMPER_SELLOS_ACTIVO=0

Editar el archivo huarpe.env de Araí, las siguientes líneas

BUNDLE_DOCUMENTOS_SELLOS_ACTIVO=0
BUNDLE_DOCUMENTOS_SELLOS_EDITABLES=0

Ambientes con Sellos dinámicos

Hay dos opciones posibles de configuración:

  • Con edición de sellos. Cada usuario firmante va a poder crear y/o modificar sellos propios.
  • Sin edición de sellos. Solo un usuario administrador desde Araí usuarios va a poder crear y/o modificar los sellos de todos los usuarios.

Parámetros de configuración para cada ambiente

Para la activación del stamper Sellos Dinámicos CON edición de Sellos desde Huarpe:

Editar el archivo docs.env de Araí, las siguientes líneas

STAMPER_ACTIVO=1
STAMPER_SELLOS_ACTIVO=1

Editar el archivo huarpe.env de Araí, las siguientes líneas

BUNDLE_DOCUMENTOS_SELLOS_ACTIVO=1
BUNDLE_DOCUMENTOS_SELLOS_EDITABLES=1

Para la activación del stamper Sellos Dinámicos SIN edición de Sellos desde Huarpe:

Editar el archivo docs.env de Araí, las siguientes líneas

STAMPER_ACTIVO=1
STAMPER_SELLOS_ACTIVO=1

Editar el archivo huarpe.env de Araí, las siguientes líneas

BUNDLE_DOCUMENTOS_SELLOS_ACTIVO=1
BUNDLE_DOCUMENTOS_SELLOS_EDITABLES=0

Pasos a seguir para la configuración de sellos

  1. Precondición: Configurar y desplegar Araí-Personas

  2. Etiquetas disponibles. Deshabilitar las etiquetas que no se quieran visualizar en el reason del documento.

  3. Sincronizar los datos del punto 2.

    • Manual: Por interfaz de araí usuarios

    • Masivo: Por comando (falta desarrollar)

  4. Configurar los archivos de display de los sellos. Se detalla en el apartado "Datos que se estampan en el sello".

Datos que se estampan en el sello

Configurar el archivo docs.env para la autorizacion con el sello por defecto. Solo se pueden utilizar etiquetas reservadas.

STAMPER_SELLOS_CREACION=['Sistema: %sistema_origen%', 'Razón: Cargado por %nombre_apellido%', 'Fecha de creación: %fecha%']
STAMPER_SELLOS_AUTORIZACION=['Sistema: %sistema_origen%', 'Razón: Autorizado por %nombre_apellido%', 'Fecha de subida: %fecha%']

Configurar el archivo personas.api.envde araí personas, con el formato de sello dinámico

SELLOS_FORMATO_ESTAMPADO=["Autorizado por: %nombre_apellido% (%dni%)", "%cargo%" , "%area%", "%email%"]

(Opcional) Script para automatizar marcado inicial de firmantes en Arai Usuarios.

Para realizar el marcado de firmantes de una forma masiva se puede utilizar un proceso que releva los firmantes configurados como tal en SUDOCU, marcándolos como firmantes en Arai Usuarios.

Este proceso consta de dos stacks utilitarios dentro de la carpeta de prod/arai/util:

preparar_firmantes.yml Despliega una tarea que se encarga de recopilar los firmantes desde SUDOCU y generar un script de salida (curls_personas.sh) que impacta contra la API Arai-Personas signandolos como firmantes únicamente .

El script será guardado en la carpeta prod/arai/util/files/firmantes. Una vez finalizada dicha tarea, revise que los usuarios a marcar como firmantes sean correctos.

confirmar_firmantes.yml Despliega una nueva tarea que se encargará de ejecutar el archivo curls_personas.sh, el cual enviará una petición POST a la api de personas por cada usuario del listado.

Requisitos para ejecutar dicha herramienta:

  • Entorno con version mínima de EEI 1.6.0 desplegado en Docker Swarm.
  • Estar logueado al registry de hub.siu.edu.ar para poder acceder a la imagen (docker login hub.siu.edu.ar:5005)
  • Verifique mediante docker secret ls que los siguientes secrets existan:
- docs_conexion_usuarios
- docs_conexion_personas
- sudocu-api-server
  • Verifique también, con docker config ls, que el siguiente config exista:
- sudocu-api-server

Pasos a seguir para ejecutar dicha herramienta:

  1. Despliegue el stack preparar_firmantes.yml para ejecutar la tarea y observe los logs para verificar el estado de ejecución
docker stack deploy \
--with-registry-auth \
-c prod/arai/util/preparar_firmantes.yml \
firmantes && docker service logs firmantes_boot -f
  1. Una vez finalizado con éxito, proceda a borrar el stack:
docker stack rm firmantes
  1. Revise que el archivo curls_personas.sh creado con la tarea previa posea los usuarios que quiera marcar como firmantes.
cat prod/arai/util/files/firmantes/curls_personas.sh

(Puede borrar o agregar usuarios de este listado con su editor de texto de preferencia).

  1. Despliegue el stack confirmar_firmantes.yml para finalmente marcar los usuarios incluídos en el script .sh como firmantes.
docker stack deploy \
--with-registry-auth \
-c prod/arai/util/confirmar_firmantes.yml \
firmantes && docker service logs firmantes_confirmar -f
  1. Una vez finalizado con éxito, proceda a borrar el stack nuevamente:
docker stack rm firmantes && rm prod/arai/util/files/firmantes/curls_personas.sh

Nota: Alternativamente, si usted se encuentra en una versión de EEI previa a la 1.7.2, puede utilizar la versión standalone, descargándola desde aquí: preparar-firmante-standalone.zip.

Para poder utilizar la version standalone de esta herramienta siga las instrucciones indicadas en el README.md del .zip.