Detalle
| Manual de Usuario | |
|---|---|
| Módulo | Firma Electrónica |
| Formulario | FormFirmas_Electronicas |
| Tipo | Consulta y gestión de procesos de firma |
| Versión del manual | 1.0 |
Introducción
La pantalla Firma Electrónica centraliza el seguimiento y la gestión de los procesos de firma electrónica de documentos. Permite ver el estado de cada documento enviado a firmar, reenviar el link al cliente, anular registros, copiar la URL de firma, ver el documento original/firmado/registro de proceso, consultar los logs y marcar manualmente como firmado un caso que quedó pendiente de análisis.
Trabaja sobre la entidad Firmas_Electronicas (manager Firmas_Electronicas_Manager) y se vincula con imágenes/documentos (Imagenes) y clientes (Clientes).
Además de la firma propia de Plenario, los documentos se pueden mandar a firmar por DocuSign desde la galería (ver Firma por DocuSign más abajo): el registro sigue el mismo ciclo de vida y se ve en esta misma pantalla.
Estados del proceso (EnumFirmasEstados): Pendiente (1), Firmado (2), Anulado (3) y Pendiente de Análisis (4) (la firma se completó pero la validación de identidad falló y requiere revisión).
Acceso al módulo
Se accede desde el menú principal, como módulo/tile destacado "Firma Electrónica" (botón btnFirmaElectronica, resaltado como "¡NUEVO!"). Requiere licencia del módulo Firma Electrónica (KeyLicences … Modulo.Firma_Electronica); si la empresa no la tiene habilitada, avisa y no abre. El ingreso no tiene un permiso propio; las acciones internas validan sus permisos FirmasElectronicas.Operaciones.*.
También puede abrirse filtrado por un cliente o un documento concreto (constructor con Id_Cliente / Id_Imagenes) cuando se invoca desde una ficha. Por defecto, sin parámetros, propone el rango de fechas del día de operación.
Pantalla principal
- Ribbon superior con las acciones (grupo Inicio y grupo Ver).
- Panel de búsqueda (
gcBusqueda) con parámetros (rango de fechas, nivel/estado, etc.) y botón Buscar. - Grilla de resultados (
gdvFirmasElectronicas): lista los procesos de firma con su estado y fechas.
La grilla colorea las filas según el estado:
- Pendiente → rojo (y negrita/rojo si está vencido, DEF < 0).
- Anulado → gris e itálica.
- Pendiente de Análisis → naranja y negrita (requiere revisión del analista).
Filtros de búsqueda
El panel de búsqueda permite filtrar por:
- Rango de fechas (
uC_Fecha_Rango1: Fecha Desde / Fecha Hasta). - Estado / Nivel (
cbx_Nivel, lista de estados deEnumFirmasEstados). - Filtros por cliente/documento cuando el formulario se abre desde una ficha concreta.
El botón Buscar (btnBuscar) refresca el manager y recarga la grilla. Hay además checks para limpiar parámetros.
Resultados
La grilla muestra, entre otras, las columnas:
| Columna | Contenido |
|---|---|
| Estado | Estado del proceso de firma |
| Cliente | Cliente asociado |
| Nro. Doc. / CUIT | Identificación del firmante |
| Envío | Fecha de envío |
| Leído | Fecha de lectura |
| Reenviado | Fecha de reenvío |
| Firmado | Fecha de firma |
| Expiración | Fecha de expiración del link |
| DEF | Días respecto del vencimiento |
| Anulacion | Fecha de anulación |
| Email / Celular | Datos de contacto |
| Metadatos | Metadatos del proceso |
Acciones disponibles
| Acción | Permiso | Descripción |
|---|---|---|
| Anular | FirmasElectronicas.Operaciones.Anular | Anula el registro seleccionado (solo si está Pendiente y sin firmar) |
| Reenviar link de firma | FirmasElectronicas.Operaciones.Reenviar | Reenvía por email el link al cliente (Pendiente o Pendiente de Análisis); genera token nuevo y registra log |
| Copiar URL de envío | FirmasElectronicas.Operaciones.CopiarUrlEnvio | Copia al portapapeles el link de firma enviado al cliente |
| Doc. Original | FirmasElectronicas.Operaciones.PrevisualizarDocumento | Previsualiza el documento original (PDF) |
| Doc. Firmado | FirmasElectronicas.Operaciones.PrevisualizarDocumento | Previsualiza el documento firmado |
| Registro de Firma Electrónica | FirmasElectronicas.Operaciones.PrevisualizarDocumento | Previsualiza el documento de registro del proceso |
| Buscar Origen | FirmasElectronicas.Operaciones.BuscarOrigen | Indica el origen del documento (cliente, liquidación, solicitud, etc.) |
| Logs | FirmasElectronicas.Operaciones.VerLogs | Abre el log del proceso de firma |
| Marcar como Firmado | FirmasElectronicas.Operaciones.MarcarFirmado | Marca manualmente como Firmado un registro en Pendiente de Análisis, exigiendo una observación obligatoria |
El botón Marcar como Firmado solo opera sobre registros en Pendiente de Análisis y pide una observación que justifique el cambio antes de confirmar.
Firma por DocuSign
Si la empresa tiene una cuenta de DocuSign y la integración está configurada (la configura Soporte de Plenario), los documentos se pueden mandar a firmar por DocuSign en lugar del circuito propio.
Enviar desde la galería:
- En la galería de documentos, elegí uno o varios PDF y presioná Enviar para firma (DocuSign). Si la integración no está lista, el sistema dice qué falta.
- Se abre Enviar para firma (DocuSign) con los documentos a enviar y el cliente precargado como firmante.
- Firmantes — agregá, quitá u ordená (Subir / Bajar) nombre y mail. Con Firman en el orden de la lista, cada uno recibe el sobre cuando firmó el anterior.
- Con copia a — mails que reciben el documento firmado sin firmar.
- Asunto y Mensaje del mail que manda DocuSign (vienen de la configuración y se pueden cambiar).
- Opciones: - Indicar dónde se firma: el recuadro de firma se ubica donde aparezca una palabra dentro del PDF (una general o una por firmante); si no aparece, el firmante elige dónde firmar. - Entrega certificada: los destinatarios solo abren el documento y confirman que lo recibieron, sin firmar. - Validar identidad (biometría): antes de ver el documento, DocuSign le pide a cada destinatario una foto de su documento y un video selfie. Lo valida DocuSign, requiere tenerlo contratado y tiene costo.
- Enviar — el registro queda Pendiente en esta pantalla.
Cuando firman: DocuSign avisa a Plenario, el registro pasa a Firmado y el documento firmado (con la leyenda Firmado, o Entregado en la entrega certificada) y el certificado de DocuSign se agregan a la galería. Si lo rechazan o se anula el sobre, el registro pasa a Anulado con el motivo.
Conciliar DocuSign (barra de esta pantalla) consulta en DocuSign todas las firmas pendientes y actualiza las que ya están firmadas, rechazadas o anuladas, con un detalle del resultado. Sirve si el aviso de DocuSign no llegó.
Importante: Reenviar link de firma, Copiar URL de envío y Marcar como Firmado son del circuito propio de Plenario y no aplican a un envío por DocuSign. Los registros de DocuSign no piden la licencia de Firma Electrónica.
Cómo consultar documentos pendientes de firma y su estado
Pasos para revisar qué documentos están pendientes de firma y en qué estado se encuentra cada uno:
- Abrir Firma Electrónica desde el menú principal.
- Desplegar el panel de búsqueda y definir el rango de fechas a revisar (por defecto trae el día de operación).
- En Estado / Nivel elegir el estado a consultar: - Pendiente → enviados al cliente que todavía no firmó (los vencidos aparecen en rojo negrita). - Pendiente de Análisis (naranja) → el cliente firmó pero la validación de identidad falló: requieren revisión manual. - Firmado / Anulado para ver los ya resueltos.
- Presionar Buscar. La grilla lista los procesos con sus fechas clave: Envío, Leído, Reenviado, Firmado, Expiración y DEF (días respecto del vencimiento; negativo = vencido).
- Sobre un registro seleccionado: - Doc. Firmado / Registro de Firma Electrónica → ver el documento y el comprobante del proceso. - Logs → ver el detalle del envío/lectura/firma. - Buscar Origen → saber a qué entidad pertenece el documento (cliente, liquidación, solicitud, crédito, etc.).
Lectura rápida por color: rojo = pendiente (rojo negrita = vencido), naranja = pendiente de análisis (revisar), gris = anulado. Así se prioriza qué firmas reclamar (reenviar link) y cuáles analizar.
Ejemplo práctico
- Abrir Firma Electrónica.
- En el panel de búsqueda, fijar un rango de fechas y/o un estado, y presionar Buscar.
- Seleccionar un registro en estado Pendiente que el cliente aún no firmó.
- Presionar Reenviar link de firma y confirmar: el sistema genera un token nuevo, lo envía por email y registra el log.
- Para un registro en Pendiente de Análisis (naranja), revisar el documento con Doc. Firmado / Registro de Firma Electrónica, y si corresponde usar Marcar como Firmado ingresando la observación.
Consejos útiles
- Los colores ayudan a priorizar: rojo = pendiente (rojo negrita = vencido), naranja = pendiente de análisis (revisar), gris = anulado.
- Solo se puede anular un registro en estado Pendiente y aún no firmado.
- Para reenviar, el cliente debe tener email cargado; si no, el sistema avisa.
- Marcar como Firmado exige una observación: dejá constancia del motivo y la verificación realizada (queda en el log).
- Usá Buscar Origen para saber a qué entidad pertenece el documento (cliente, liquidación, solicitud, proveedor, cheque, factura, etc.).
Preguntas frecuentes
¿Qué significa "Pendiente de Análisis"?
Que el cliente firmó pero la validación de identidad no pasó automáticamente; el caso queda para revisión manual de un analista (se muestra en naranja).¿Cuándo puedo anular un registro?
Solo cuando está en estado Pendiente y todavía no fue firmado. Si ya tiene fecha de firma, no se puede anular.¿Qué pasa al reenviar un link?
Se genera un token nuevo con fecha de expiración, se envía el email al cliente y se registra en el log. Si el registro estaba en Pendiente de Análisis, se reenvía anulando el viejo y creando uno nuevo para dejar histórico.El cliente dice que no le llegó el link, ¿cómo se lo paso?
Con "Copiar URL de envío" se copia el link al portapapeles para enviárselo manualmente, o con "Reenviar link de firma" se reenvía por email.¿Por qué no puedo previsualizar el documento firmado?
Porque ese registro aún no tiene fecha de firma (el documento no fue firmado todavía) o no se encuentra el archivo en la ruta esperada.Permisos
Todas las operaciones se controlan con IsAllowedObject(...) bajo la categoría FirmasElectronicas.Operaciones:
| Permiso | Acción |
|---|---|
| FirmasElectronicas.Operaciones.Anular | Anular registros de firma |
| FirmasElectronicas.Operaciones.Reenviar | Reenviar el link por email al cliente |
| FirmasElectronicas.Operaciones.CopiarUrlEnvio | Copiar el link de firma enviado al cliente |
| FirmasElectronicas.Operaciones.PrevisualizarDocumento | Previsualizar un documento del proceso de firma |
| FirmasElectronicas.Operaciones.BuscarOrigen | Buscar el origen del proceso de firma |
| FirmasElectronicas.Operaciones.VerLogs | Ver el log de un proceso de firma |
| FirmasElectronicas.Operaciones.MarcarFirmado | Marcar manualmente como Firmado un registro en Pendiente de Análisis |
| GaleriaImagenes.FirmaElectronica.Enviar | Enviar documentos a firmar desde la galería (propia o por DocuSign) |
Información técnica
Basada en el análisis del formulario real de la v14
Formularios principales
| Form | Rol |
|---|---|
FormFirmas_Electronicas |
Pantalla principal: búsqueda, grilla y operaciones |
| FormFirmas_Electronicas_Log | Visor del log del proceso de firma |
| FormPdfViewer | Previsualización de los documentos (original/firmado/registro) |
| FormFirmas_Electronicas_EnviarDocuSign | Pantalla previa al envío por DocuSign: firmantes, copias, mensaje y opciones |
| frmGalery | Botón Enviar para firma (DocuSign) |
Permisos reales
| Permiso | Acción |
|---|---|
| FirmasElectronicas.Operaciones.Anular | Anular registro |
| FirmasElectronicas.Operaciones.Reenviar | Reenviar link por email |
| FirmasElectronicas.Operaciones.CopiarUrlEnvio | Copiar URL de envío |
| FirmasElectronicas.Operaciones.PrevisualizarDocumento | Previsualizar documento |
| FirmasElectronicas.Operaciones.BuscarOrigen | Buscar origen de la firma |
| FirmasElectronicas.Operaciones.VerLogs | Ver logs |
| FirmasElectronicas.Operaciones.MarcarFirmado | Marcar como firmado manualmente |
Tablas de base de datos principales
| Tabla | Uso |
|---|---|
| Firmas_Electronicas | Registro del proceso de firma (Id_Cliente, Id_Imagenes_Original/Firmada/Registro_Firma, Id_Estado, Token_Enviado, Fecha_Firma/Expiracion/Reenvio, Email_Destino, Identidad_Detalle, etc.) |
| Imagenes | Documentos asociados (original, firmado, registro) y su origen (Id_Tipo_Entidad / Id_Entidad) |
| Clientes | Datos del cliente firmante (email destino del reenvío) |
| Plenario_Operaciones_Log | Auditoría de operaciones (reenvíos, cambios de estado) |
Relación con otros módulos / manuales
| Manual relacionado | Vínculo operativo |
|---|---|
| Documentaciones | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
| Campos definidos por el usuario | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
Notas para soporte
- DocuSign: configuración en el parámetro
FirmasElectronicas.DocuSign(JSON; clave privada encriptada), sobre por JWT conDocuSignFirmasService; el webhook de DocuSign Connect llega al WCF (Servicios\Externos\DocuSign.cs). Los datos del sobre (firmantes, copias, último evento) quedan enFirmas_Electronicas.Metadatos. - El formulario está en
VPNET_WinForms\Gestion; el managerFirmas_Electronicas_ManagerenVPNET_DataModel\Manager\Gestion\Common. - El
Id_Tipo_Entidadde la imagen mapea el origen del documento: 1 Cliente, 2 Liquidaciones, 3 Solicitudes, 4 Inversores, 5 Proveedores, 6 Cheques, 7 IVA Compras, 8 IVA Ventas, 9 Facturas, 10 Tickets, 11 Créditos, 14 Orden de Pago, 15/16 Recibo de Cobro. - El ícono del botón "Marcar como Firmado" se asigna por código (SVG en runtime), no desde el .resx; si falla la asignación el botón queda solo con texto.
- El cuerpo del mail de reenvío sale del parámetro
FirmasElectronicas.HTML.EnvioMail(ruta de HTML), con fallback aHTML\Cuerpo_Mail_FirmaElectronica.Htmlen el StartupPath. - Acceso por tile + licencia: el botón
btnFirmaElectronicaestá linkeado arbpTile(módulo destacado del menú principal, enumModulo.Firma_Electronica = 17). El ingreso valida la licencia (KeyLicences.Instance.Access(Area.Intranet, Modulo.Firma_Electronica, …)); no tiene un permiso propio de ingreso.