← Índice de manuales
Manual funcional · Sistema Plenario v14

Relaciones y Vinculaciones

Las Relaciones / Vinculaciones permiten registrar los lazos que existen entre un cliente o firmante y otras personas o entidades (por ejemplo: familiar, socio, representante, empresa vinculada, etc.). Cada vínculo une…

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

Detalle

Campo Descripción
Manual de Usuario Registro de los lazos (parentesco o vinculación) entre un cliente o firmante y otras personas o entidades, identificados por CUIT/CUIL.
Módulo Inicio / Clientes
Pantalla Relaciones / Vinculaciones
Tipo ABM (alta, baja y modificación)

Introducción

Las Relaciones / Vinculaciones permiten registrar los lazos que existen entre un cliente o firmante y otras personas o entidades (por ejemplo: familiar, socio, representante, empresa vinculada, etc.). Cada vínculo une dos CUIT/CUIL e indica el tipo de relación o parentesco.

La pantalla se abre siempre desde un cliente o firmante ya seleccionado, por lo que el sistema ya conoce el CUIT/CUIL de esa persona. Al cargar un nuevo vínculo solo se ingresa el CUIT de la otra parte. Los vínculos se clasifican en Ascendentes y Descendentes según la persona seleccionada figure como origen o como destino de la relación.

Acceso al módulo

  1. Ubicar y abrir el cliente o firmante con el que se quiere trabajar.
  2. Desde la ficha del cliente/firmante, abrir la opción Relaciones / Vinculaciones.
  3. La ventana se abre con el título "Relaciones / Vinculaciones de <nombre>", mostrando el nombre de la persona sobre la que se está trabajando.

Importante: El acceso requiere de la asignación de permisos que deben solicitarse al administrador del sistema. La pantalla no se abre de forma independiente: siempre parte de un cliente o firmante seleccionado, que es quien aporta el CUIT/CUIL de referencia.

Pantalla principal

Al ingresar se muestran los vínculos ya registrados, separados en dos listados:

Listado Descripción
Relaciones Ascendentes Vínculos donde la otra persona figura como origen de la relación
Relaciones Descendentes Vínculos donde la otra persona figura como destino de la relación

Cada listado muestra las siguientes columnas:

Columna Descripción
Id Número interno que identifica al vínculo
CUIT CUIT/CUIL de la persona o entidad vinculada
Denominación Nombre o razón social de la persona vinculada
Parentesco Tipo de relación registrada (ej.: familiar, socio, etc.)

En la parte inferior, la barra de estado indica la cantidad de registros totales o, si hay selección, la cantidad de registros seleccionados.

Importante: Si la búsqueda supera los 1000 registros, el sistema avisa y pregunta si se desea continuar de todas maneras.

Filtros de búsqueda

Esta pantalla no tiene filtros configurables: el listado se arma automáticamente a partir del CUIT/CUIL del cliente o firmante desde el que se abrió. El sistema busca por separado:

Búsqueda automática Criterio
Relaciones Ascendentes Vínculos en los que el CUIT de la persona figura como destino (la otra parte es el origen)
Relaciones Descendentes Vínculos en los que el CUIT de la persona figura como origen (la otra parte es el destino)

Resultados

Los resultados se presentan en los dos listados de la pantalla principal (Ascendentes y Descendentes). Cada fila corresponde a un vínculo registrado y muestra Id, CUIT, Denominación y Parentesco de la otra parte. Al seleccionar uno o más registros, la barra de estado actualiza el conteo de seleccionados; sin selección, muestra el total de vínculos cargados (sumando ambos listados).

Acciones disponibles

La barra de herramientas y el menú contextual ofrecen las siguientes acciones:

Acción Descripción
Nuevo Abre el formulario para cargar un nuevo vínculo
Modificar Permite editar el vínculo seleccionado en cualquiera de los dos listados
Eliminar Borra el o los vínculos seleccionados (pide confirmación)

Las mismas acciones están disponibles desde el menú contextual (clic derecho) y desde la barra de herramientas. Doble clic o Enter sobre un registro abre la modificación.

Nuevo / Modificar un vínculo

Al presionar Nuevo (o Modificar sobre un registro), se abre el formulario con los siguientes campos:

Campo Descripción
Tipo de Relación Se elige Ascendente o Descendente. Define si la otra persona queda como origen o como destino del vínculo
CUIT CUIT/CUIL de la persona o entidad que se quiere vincular
Denominación Nombre o razón social de esa persona (opcional)
Parentesco Se selecciona de una lista de parentescos pre cargados. Junto al campo hay un enlace "Parentesco:" que permite dar de alta un nuevo parentesco sin salir de la pantalla

Pasos para cargar un vínculo:

  1. Elegir el Tipo de Relación — marcar Ascendente o Descendente según corresponda.
  2. Ingresar el CUIT — escribir el CUIT/CUIL de la otra persona o entidad.
  3. Completar la Denominación — opcional; nombre o razón social de la persona vinculada.
  4. Seleccionar el Parentesco — elegir el tipo de relación de la lista. Si no existe, usar el enlace para crear uno nuevo.
  5. Aceptar — confirma y guarda el vínculo.

Importante: Si el CUIT ingresado ya está registrado en otro vínculo de esta persona, el sistema avisa "El cuit ya fue ingresado" y no permite duplicarlo.

Eliminar un vínculo

Seleccionar uno o más registros en cualquiera de los dos listados y presionar Eliminar. El sistema pide confirmación ("¿Desea Eliminar el Item?") antes de borrar. Si no hay registro seleccionado, avisa "No ha seleccionado ningún Registro".

Ejemplo práctico

Se quiere registrar que Juan Pérez (cliente seleccionado) es hijo de María Gómez.

  1. Abrir la ficha de Juan Pérez y entrar a Relaciones / Vinculaciones. La ventana muestra "Relaciones / Vinculaciones de Juan Pérez".
  2. Presionar Nuevo.
  3. En Tipo de Relación, marcar Ascendente (María queda como origen del vínculo, es el ascendiente).
  4. En CUIT, ingresar el CUIT/CUIL de María Gómez.
  5. En Denominación, escribir "María Gómez" (opcional).
  6. En Parentesco, elegir "Madre" o "Padre/Madre" de la lista. Si no existe, usar el enlace "Parentesco:" para crearlo y luego seleccionarlo.
  7. Presionar Aceptar.

El vínculo aparece ahora en el listado de Relaciones Ascendentes de Juan Pérez. Si más adelante se abre la ficha de María Gómez, el mismo vínculo se ve reflejado como Descendente respecto de ella.

Consejos útiles

  • La pantalla siempre parte de un cliente o firmante: no hace falta cargar los dos CUIT, solo el de la otra parte.
  • Elegir bien Ascendente vs. Descendente determina en qué listado queda el vínculo y el sentido de la relación; conviene pensar quién es el origen y quién el destino antes de guardar.
  • Si el parentesco que se necesita no figura en la lista, crearlo con el enlace "Parentesco:" en lugar de forzar uno parecido; queda disponible de inmediato.
  • El sistema impide duplicar un mismo CUIT en los vínculos de la misma persona: si aparece el aviso "El cuit ya fue ingresado", revisar los vínculos existentes antes de insistir.
  • Para editar un vínculo basta con hacer doble clic sobre la fila, sin necesidad de usar el botón Modificar.
  • La Denominación es opcional, pero completarla ayuda a identificar el vínculo a simple vista en el listado.

Preguntas frecuentes

¿Tengo que cargar los dos CUIT del vínculo? No. La pantalla se abre desde un cliente o firmante, así que ese CUIT ya lo conoce el sistema. Solo se ingresa el CUIT de la otra parte de la relación.
¿Qué diferencia hay entre relación Ascendente y Descendente? Define quién queda como origen y quién como destino del vínculo. Según el tipo elegido, la otra persona queda como origen o como destino de la relación, y por eso el vínculo aparece en uno u otro listado de la ventana principal.
El parentesco que necesito no está en la lista. ¿Qué hago? Junto al campo Parentesco hay un enlace que abre el alta de parentescos. Allí se crea el nuevo tipo de relación y queda disponible para seleccionarlo de inmediato.
¿Por qué me avisa que el CUIT ya fue ingresado? Significa que esa persona ya tiene un vínculo registrado con ese mismo CUIT. El sistema evita duplicar relaciones para la misma persona.
¿Puedo eliminar varios vínculos a la vez? Sí. Se pueden seleccionar varios registros dentro de un mismo listado y presionar Eliminar; el sistema pide una confirmación antes de borrarlos.

Permisos

Las acciones de esta pantalla están controladas por permisos individuales que asigna el administrador:

Permiso Habilita
Archivos.Relaciones.Nuevo Crear nuevas relaciones
Archivos.Relaciones.Modificar Modificar relaciones existentes
Archivos.Relaciones.Eliminar Eliminar relaciones

Información técnica

Sección de referencia para soporte/desarrollo. Basada en el análisis del formulario real de la v14 (frmRelaciones.vb).

Formularios principales

Componente Detalle
Formulario principal frmRelaciones (VisualPlenarioNET\Common\frmRelaciones.vb). Hereda de MultiForm. Se instancia con New(parent, strCuit, strNombre) — siempre necesita el CUIT y el nombre de la entidad de partida.
Cómo se abre Desde el ABM de Clientes (frmClientes.vb), Firmantes (frmFirmantes.vb), Cheques y Bolsa/Documentos: New frmRelaciones(Me, objClientes.cuit, objClientes.nombre) + ShowDialog. No tiene entrada propia en el menú principal.
Formulario alta/modificación frmRelaciones_AddMod (VisualPlenarioNET\Common\frmRelaciones_AddMod.vb). Se abre con ShowDialog. Campos: rbtAsc/rbtDes (tipo), txtCuit, txtDenominacion, cmbParentesco.
Alta rápida de parentescos Enlace lnkParent → abre frmParentesco(True) como diálogo; al volver recarga cmbParentesco y preselecciona el parentesco creado.
Clase de negocio clsEntidades_Relaciones (ClassVisualPlenarioNET\Common\clsEntidades_relaciones.vb). Acceso vía stored procedures, no EF.
Listados en pantalla lvwRelacionesA (ascendentes, muestra CuitOrigen) y lvwRelacionesD (descendentes, muestra CuitDestino).

Distinto de frmEntidades_Relaciones (Common\frmEntidades_Relaciones.vb): ese es otro formulario, basado en grilla DevExpress, que el menú principal/Asistente listan como "Relaciones y Vinculaciones". Esta pantalla (la documentada) es la que se abre por CUIT desde un cliente/firmante.

Permisos reales

Validados con ClassVisualPlenarioNET.Sistema.clsSeguridad.IsAllowedObject(_objUsuario, ...) dentro de cada acción.

Permiso Habilita
Archivos.Relaciones.Nuevo Crear nuevas relaciones (método Nuevo)
Archivos.Relaciones.Modificar Modificar relaciones existentes (método Modificar)
Archivos.Relaciones.Eliminar Eliminar relaciones (método Eliminar)

Tablas de base de datos principales

Tabla / entidad Contenido
Entidades_Relaciones Vínculos: Id, Id_Parentesco, CuitOrigen, CuitDestino, DenominacionO, DenominacionD, auditoría (UserAdd/UserMod/UserEnv, FechaAdd/FechaMod). SP: Entidades_relaciones_Search/_Add/_Mod/_Del/_SearchRelPorCuit.
Parentescos Catálogo de tipos de parentesco (Id, Parentesco); accedido vía clsParentescos.

Managers y clases de negocio

Componente Detalle
clsEntidades_Relaciones (ClassVisualPlenarioNET\Common\clsEntidades_relaciones.vb) Clase de negocio de los vínculos; acceso por Stored Procedures (no EF).
clsParentescos Catálogo de parentescos que llena cmbParentesco (alta rápida vía frmParentesco).
clsSeguridad.IsAllowedObject(usuario, permiso, …) Valida el permiso de cada acción antes de ejecutarla.

Stored Procedures y funciones

SP Uso
Entidades_relaciones_Search / _Add / _Mod / _Del ABM de los vínculos.
Entidades_relaciones_SearchRelPorCuit Búsqueda de relaciones por CUIT.

Relación con otros módulos / manuales

Se conecta con Cómo
Clientes Se abre por CUIT desde el ABM de Clientes para ver/editar los vínculos de la entidad. Ver ABM de Clientes.
Factoring / Firmantes También se abre por CUIT desde Firmantes, Cheques y Documentos. Ver ABM de firmantes.
Parentescos Usa el catálogo compartido de parentescos (misma tabla Parentescos).

Notas para soporte (comportamiento real del código)

  • Origen/destino según el tipo: al guardar, si se marca Ascendente el CUIT nuevo va a CuitOrigen y el de la persona de partida a CuitDestino; si es Descendente, al revés. El listado ascendente muestra CuitOrigen y el descendente CuitDestino.
  • La Denominación NO es realmente opcional a nivel de negocio: Valid() exige DenominacionO y DenominacionD no vacías. La de la otra parte se toma de txtDenominacion y la del cliente/firmante se autocompleta desde el contexto; si alguna queda vacía, Save() falla con "Debe Ingresar una Denominación.".
  • Validación de duplicados: en frmRelaciones_AddMod.Guardar se cuenta con SqlQuery(Of Integer) (consulta SQL armada por String.Format, sin parámetros) sobre Entidades_Relaciones⋈Parentescos; si hay coincidencia, ValidarCuit busca el CUIT como origen y como destino y avisa "El cuit ya fue ingresado".
  • Validación de CUIT: Valid() rechaza CUIT inválidos con Functions.IsValidCuit.
  • Aviso de >1000 registros: se evalúa por separado en cada listado (ascendentes y descendentes) dentro de Search().
  • Botón Imprimir no operativo: ToolImprimir está con Enabled = False y Visible = False (y su subítem AsociadoToolStripMenuItem no tiene handler). No funciona en esta versión.
  • Modalidad() traga excepciones: el doble clic / Enter sobre la grilla usa Modalidad(), que tiene un Catch vacío; si falla la lectura del item seleccionado no muestra error.
¿Te resultó útil este manual?