← Índice de manuales
Manual funcional · Sistema Plenario v14

ABM de Documentos

Este módulo permite definir y administrar los tipos de documento que luego se asignan a los clientes (por ejemplo balances, declaraciones juradas, informes de IVA y otra documentación relevante). Acá no se carga la…

Módulo: Inicio / ClientesVersión: 1.3Actualizado: 2026-07-21

Detalle

Campo Detalle
Manual de Usuario ABM de Documentos (Módulo Archivos) - Plenario v14
Módulo Inicio / Clientes
Solapa Archivos / Opción Documentos

Introducción

Este módulo permite definir y administrar los tipos de documento que luego se asignan a los clientes (por ejemplo balances, declaraciones juradas, informes de IVA y otra documentación relevante). Acá no se carga la documentación de un cliente puntual, sino que se configura el catálogo de documentos disponibles: cómo se clasifican, si son obligatorios, si admiten archivos adjuntos y cada cuánto vencen.

Funcionalidad principal:

Campo Descripción
Clasificación por Grupo y Sub Grupo Cada tipo de documento se organiza dentro de un Grupo y un Sub Grupo para facilitar la búsqueda y el orden del catálogo.
Documentos obligatorios Permite marcar un documento como obligatorio para los clientes.
Adjuntar archivos Permite indicar que el documento admite adjuntar archivos (PDF, Excel, Word, imágenes, etc.) cuando se asigna a un cliente.
Vigencia y vencimiento Permite establecer cada cuánto vence el documento y a partir de cuándo se considera en riesgo de vencimiento.
Alertas de riesgo Permite generar alertas cuando el documento se acerca a su fecha de vencimiento, para tomar medidas a tiempo.
Centralización de información Consolida la definición de toda la documentación de los clientes en un solo lugar.

Acceso al módulo

Se ingresa desde la solapa Archivos, opción Documentos.

El acceso requiere de la asignación de permisos que deben solicitarse al administrador del sistema.

Al ingresar a este menú se despliega la pantalla de Documentos, con la grilla de tipos de documento y las acciones disponibles.

Pantalla principal

La pantalla muestra la grilla de tipos de documento con las siguientes columnas:

Campo Descripción
Grupo Grupo al que pertenece el documento.
Sub Grupo Sub Grupo dentro del Grupo.
Nombre Nombre del tipo de documento.
Descripción Descripción del documento.
O Indica si el documento es Obligatorio.
AD Indica si el documento Adjunta Documentación (admite archivos).
E Indica si el documento está Eliminado.
Vencimiento Vigencia / período de vencimiento configurado.
Riesgo de Vencimiento Período a partir del cual el documento se considera en riesgo de vencimiento.

Filtros de búsqueda

La opción de Búsqueda Avanzada permite filtrar el catálogo de documentos por:

Campo Descripción
Campo N° Permite filtrar por número de documento.
Campo Nombre Permite filtrar por nombre del documento.

Una vez definidos los filtros, se presiona el botón Buscar para aplicarlos y mostrar los documentos.

Resultados

Los documentos que cumplen con los filtros se listan en la grilla de la pantalla principal (ver columnas en la sección Pantalla principal). Desde el resultado de la búsqueda se pueden ejecutar las acciones disponibles (Nuevo, Modificar, Eliminar, Imprimir).

Acciones disponibles

Campo Descripción
Botón Buscar Aplica los filtros de la Búsqueda Avanzada y muestra los documentos.
Botón Nuevo Abre la ventana de alta para definir un nuevo tipo de documento (ver campos más abajo).
Botón Modificar Abre la ventana de edición del documento seleccionado. También se accede haciendo doble clic sobre la fila.
Botón Eliminar Elimina el documento seleccionado (eliminación lógica).
Botón Imprimir Permite imprimir / previsualizar el resultado de la búsqueda.

Importante: las acciones Nuevo, Modificar y Eliminar requieren el permiso correspondiente. Si los botones no responden, solicitá el permiso al administrador del sistema.

Alta y Modificación de un Documento (Nuevo / Modificar)

Al presionar Nuevo o Modificar se abre la ventana del documento, donde se completan los siguientes campos:

Campo Descripción
Grupo Seleccionamos el grupo del documento. Es obligatorio.
Sub Grupo Seleccionamos el sub grupo. Las opciones se actualizan según el grupo elegido.
Nombre Colocamos el nombre del documento. Es obligatorio.
Descripción Colocamos una descripción del documento.
Checkbox Obligatorio Lo clickeamos si el documento es obligatorio.
Checkbox Adjunta documentación Lo clickeamos si el documento admite adjuntar archivos.

Dentro de la sección "Vigencia del Documento" completamos:

Campo Descripción
Vencimiento cada Colocamos un número que indica cada cuánto vence el documento. Al cargarlo se habilitan los campos de identificador (día, semana, mes, año), Riesgo de vencimiento y Variación.
Identificador de vencimiento Seleccionamos la unidad del vencimiento (día, semana, mes o año).
Riesgo de vencimiento Colocamos el número y la unidad a partir de la cual el documento se considera en riesgo. El sistema valida que no supere el período de vigencia.
Variación Define la variación del vencimiento.

En la sección "Alerta si está en riesgo de vencimiento":

Campo Descripción
Checkbox Alerta si está en riesgo de vencimiento Si lo clickeamos se habilita el campo "Alerta cada"; si no lo clickeamos, queda deshabilitado.
Alerta cada Colocamos un número que indica la frecuencia de la alerta y su identificador.

Campos Adicionales

En la sección "Campos Adicionales" encontramos dos listas: Sin Asignar y Asignados. Se mueven entre ambas con los botones:

Campo Descripción
Botón > Asigna el campo adicional seleccionado de Sin Asignar a Asignados.
Botón < Quita el campo adicional seleccionado de Asignados y lo devuelve a Sin Asignar.
Botón >> Quita todos los campos adicionales asignados de una sola vez.

Para confirmar el alta o la modificación se usa el botón Aceptar.

Importante: para guardar, el documento debe tener al menos un Nombre y un Grupo seleccionado. Si falta alguno, el sistema avisa con el mensaje "Error en la entrada de los datos" y no guarda.

Eliminación de un Documento

La eliminación es lógica (el documento queda marcado como Eliminado). Si el tipo de documento ya fue asignado a uno o más clientes, el sistema avisa la cantidad de clientes afectados y, al confirmar, elimina también esos documentos de los clientes.

Importante: revisá el aviso de clientes afectados antes de confirmar, ya que la eliminación se propaga a la documentación cargada en cada cliente.

Ejemplo práctico

Supongamos que queremos definir el tipo de documento "Balance General" obligatorio, con vencimiento anual:

  1. Presionamos Nuevo.
  2. Seleccionamos el Grupo (por ejemplo "Contable") y el Sub Grupo correspondiente.
  3. En Nombre escribimos "Balance General" y completamos la Descripción.
  4. Tildamos Obligatorio y, si se va a adjuntar el PDF del balance, Adjunta documentación.
  5. En "Vigencia del Documento" cargamos Vencimiento cada = 1 e Identificador de vencimiento = Año.
  6. Cargamos el Riesgo de vencimiento (por ejemplo 1 mes antes) y la Variación.
  7. Si queremos avisos automáticos, tildamos Alerta si está en riesgo de vencimiento y configuramos Alerta cada.
  8. Asignamos los Campos Adicionales que correspondan con el botón >.
  9. Presionamos Aceptar. El documento queda disponible para asignarse a los clientes.

Consejos útiles

  • Acá se define el catálogo de tipos de documento, no la documentación de un cliente puntual: esa carga se hace luego desde la documentación de cada cliente.
  • Los campos de Riesgo de vencimiento y Variación se habilitan recién después de cargar "Vencimiento cada".
  • El campo "Alerta cada" se habilita solo al tildar "Alerta si está en riesgo de vencimiento".
  • Para guardar siempre es obligatorio completar el Nombre y seleccionar un Grupo.
  • Antes de eliminar un documento, revisá el aviso de clientes afectados: la eliminación se propaga a la documentación cargada en cada cliente.

Preguntas frecuentes

¿Acá cargo la documentación de un cliente puntual? No. En esta pantalla se definen los **tipos de documento** (el catálogo) con su clasificación, obligatoriedad, vencimientos y campos adicionales. La carga de archivos de cada cliente se realiza luego desde la documentación del cliente, usando los tipos definidos acá.
¿Por qué no puedo cargar el vencimiento o el riesgo de vencimiento? Los campos de Riesgo de vencimiento y Variación se habilitan recién después de cargar un valor en "Vencimiento cada". De igual modo, el campo "Alerta cada" se habilita solo al tildar "Alerta si está en riesgo de vencimiento".
¿Por qué no me deja guardar el documento? Para guardar es obligatorio completar el Nombre y seleccionar un Grupo. Si falta alguno, el sistema muestra "Error en la entrada de los datos".
¿Qué pasa si elimino un documento que ya usan clientes? La eliminación es lógica. Si el documento ya estaba asignado a clientes, el sistema avisa cuántos están afectados y, al confirmar, elimina también esos documentos en cada cliente.
¿Qué permisos necesito para administrar documentos? El acceso y las acciones de Nuevo, Modificar y Eliminar requieren el permiso correspondiente asignado por el administrador del sistema. Si no podés operar, solicitalo.

Permisos

Permiso Descripción
Acceso al módulo Requerido para ingresar a la opción Documentos (solapa Archivos).
Nuevo Requerido para dar de alta un nuevo tipo de documento.
Modificar Requerido para editar un tipo de documento existente.
Eliminar Requerido para eliminar (lógicamente) un tipo de documento.

Si los botones no responden o no podés operar, los permisos deben solicitarse al administrador del sistema.

Información técnica

Basada en el análisis del formulario real de la v14 (FormClientesDocumentosDocumentos.cs, proyecto VPNET_WinForms, carpeta ClientesDocumentacion).

Formularios y pantallas

Form Rol
FormClientesDocumentosDocumentos Pantalla principal (grilla + búsqueda). C#, namespace VPNET.Windows.Forms.ClientesDocumentacion.
FormClientesDocumentosDocumentosAddMod Ficha de alta/modificación (se abre con ShowDialog desde Nuevo / Modificar / doble clic).
FormClientesDocumentosGrupo / FormClientesDocumentosGrupoAddMod ABM de Grupos de documentos.
FormClientesDocumentosSubAgrupaciones / FormClientesDocumentosSubGrupoAddMod ABM de Sub Grupos / subagrupaciones.
FormClientesDocumentosCamposAdicionales / ...AddMod ABM del catálogo de Campos Adicionales.

Managers y clases de negocio

Componente Detalle
Gestion_Documentos_DocumentosManager Manager del ABM. Implementa IDisposable y opera un VisualPlenarioNetContext vpnetContext propio (EF Code First; no hereda de Base_Manager). Ruta VPNET_DataModel\Manager\Gestion\ClientesDocumentacion. Save usa EntityState.Added/Modified; Eliminar(_Documento, idUser) hace la baja lógica.
Gestion_Documentos_DocumentosManager.ParametrosBusquedas Clase interna de filtros (N° / Nombre) de la búsqueda avanzada.
ClassVisualPlenarioNET.Sistema.clsSeguridad IsAllowedObject(...) valida el permiso antes de operar.

Stored Procedures y funciones

SP Uso
El ABM se resuelve por EF Code First vía Gestion_Documentos_DocumentosManager (LINQ sobre VisualPlenarioNetContext); no usa Stored Procedures.

Tablas de base de datos

Tabla Uso
Gestion_Documentos_Documentos Entidad principal del ABM: nombre, descripción, grupo/subgrupo, obligatorio, adjunta documentación, vigencia/vencimiento, riesgo, alerta y flag Eliminado.
Gestion_Documentos_Grupos Catálogo de Grupos.
Gestion_Documentos_SubAgrupaciones / Gestion_Documentos_Grupos_SubGrupos Subgrupos y su relación con los grupos (alimentan el combo Sub Grupo según el Grupo elegido).
Gestion_Documentos_CamposAdicionales Catálogo de campos adicionales (lista Sin Asignar / Asignados).
Gestion_Documentos_Documentos_CamposAdicionales Relación N:N entre el tipo de documento y sus campos adicionales asignados.
Gestion_Documentos_Documentos_Clientes Asignación del tipo de documento a cada cliente. Al eliminar el tipo, el sistema cuenta los registros aquí y, al confirmar, los elimina también.
Documentaciones Documentación asociada (referenciada en el guardado del manager).

Permisos reales

Las acciones Nuevo, Modificar y Eliminar verifican el mismo permiso; no hay permisos separados por acción.

Permiso Acción
Clientes.Documentos.AdministarConfiguracion Alta (btnNuevo), Modificación (btnModificar) y Eliminación (barButtonItem3) del tipo de documento. (El string está escrito así en el código: "Administar", sin la segunda "r".)

Relación con otros módulos / manuales

Se conecta con Cómo
ABM de Clientes Los tipos de documento definidos acá se asignan a cada cliente (Gestion_Documentos_Documentos_Clientes); al eliminar un tipo, la baja se propaga a sus clientes.
Documentos: campos adicionales La lista Sin Asignar / Asignados toma su catálogo de Gestion_Documentos_CamposAdicionales.
Documentos: subagrupaciones Los combos Grupo / Sub Grupo se alimentan de las agrupaciones y subagrupaciones.

Notas para soporte

  • Eliminación lógica con propagación a clientes. Eliminar llama a manager.Eliminar(...). Antes consulta Gestion_Documentos_Documentos_Clientes; si hay clientes con ese documento, avisa la cantidad y al confirmar los elimina también. El cartel siempre dice "Desea Eliminar..." (la rama Habilitar está comentada en el código, no operativa).
  • Validación de alta mínima. Guardar solo exige Nombre no vacío y Grupo distinto de 0; si falta alguno muestra "Error en la entrada de los datos" y no guarda.
  • Validación de vigencia. El Riesgo de vencimiento no puede superar el período de vigencia: el form recalcula MaxValue del control de vencimiento según la unidad (día/semana/mes/año).
  • Imprimir sin chequeo de permiso. Las acciones Imprimir / Vista previa (btnResultadoBusqueda, imprimirToolStripMenuItem, gcDocuGrupos.ShowRibbonPrintPreview()) NO validan permiso; cualquiera con acceso al form puede previsualizar/imprimir la grilla.
  • Handlers vacíos. Varios eventos están definidos pero sin lógica: gcPrestamosPersonalizados_Enter, ButtonPressed, ParseEditValue, cbx_Subgrupo_EditValueChanged, labelControl3_Click.
  • Bug latente en gridView1_FocusedRowChanged. Entra al bloque solo si ...Current == null y luego hace cast/uso de curr (sería NullReference); la lógica de cambiar el caption a "Habilitar/Eliminar" está invertida y no se ejecuta en la práctica. El caption "Elimnar" además está mal escrito en el código.
  • Nombres heredados de otra plantilla. Controles como gcPrestamosPersonalizados y variables tipo ppc vienen de copiar el ABM de Préstamos Personalizados; no implican relación con préstamos.
¿Te resultó útil este manual?