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).
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 valida un permiso de objeto (el chequeo está comentado en el código); las acciones internas sí 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.
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 |
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) |
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
- 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 licencia (KeyLicences.Instance.Access(Area.Intranet, Modulo.Firma_Electronica, …)); elIsAllowedObject("Gestion.FirmasElectronicas.Busqueda", …)quedó comentado enbtnFirmaElectronica_ItemClick→ no hay permiso de objeto para el ingreso (solo licencia).