← Índice de manuales
Manual funcional · Sistema Plenario v14

Gestión de Oficiales (Alta, Modificación y Configuración) en el Módulo ARCHIVOS

Los Oficiales son las personas responsables de la relación comercial con el cliente: brindan asesoramiento, seguimiento y soporte de las operaciones. En Plenario, cada Oficial guarda sus datos generales (nombre, CUIT…

Módulo: Gestión ComercialVersión: 1.1Actualizado: 2026-06-19

Detalle

Campo Valor
Manual de Usuario ABM de Oficiales (de cuenta / comerciales): alta, modificación y configuración de comisiones por producto dentro del módulo ARCHIVOS.

Introducción

Los Oficiales son las personas responsables de la relación comercial con el cliente: brindan asesoramiento, seguimiento y soporte de las operaciones. En Plenario, cada Oficial guarda sus datos generales (nombre, CUIT, e-mail, fórmula) y un esquema de comisiones por producto que el sistema aplica luego en las operaciones de Factoring, Cambios y Bolsa.

Este manual explica cómo buscar, dar de alta, modificar y configurar un Oficial.

Acceso al módulo

  1. Ingresar al módulo ARCHIVOS.
  2. Seleccionar la opción Oficiales.
  3. Se abre la pantalla de búsqueda de Oficiales.

Importante: El acceso a esta opción requiere el permiso Factoring.Archivos.Oficiales. Si no lo tiene asignado, solicítelo al administrador del sistema.

Pantalla principal

La pantalla de Oficiales se divide en dos áreas:

Área Descripción
Filtros de búsqueda Permite acotar el listado por ID o por Nombre.
Grilla de resultados Muestra los Oficiales encontrados y permite seleccionarlos para modificarlos.

Desde la barra de herramientas se accede a las acciones Buscar, Nuevo y Modificar. Las acciones Operaciones y Modificar se habilitan solo cuando hay un Oficial seleccionado en la grilla.

Filtros de búsqueda

Campo Descripción
ID Filtra por el número identificador del Oficial. Si se completa, tiene prioridad sobre el resto de los filtros.
Nombre Filtra por coincidencia parcial sobre el nombre del Oficial.

Si no se completa ningún filtro y se presiona Buscar, el sistema lista todos los Oficiales.

Resultados

La grilla muestra los Oficiales que cumplen el criterio de búsqueda. Cada fila corresponde a un Oficial.

Columna / dato Descripción
ID Identificador único del Oficial.
Nombre Nombre del Oficial.
Proveedor Financiero Inversor / proveedor financiero asociado al Oficial (si tiene).

Para editar un registro, hacer doble clic sobre la fila o seleccionarla y presionar Modificar (también se puede presionar Enter sobre la fila).

Acciones disponibles

Acción Descripción
Buscar Ejecuta la búsqueda según los filtros cargados y refresca la grilla.
Nuevo Abre el formulario de alta para crear un Oficial.
Modificar Abre el formulario de edición del Oficial seleccionado.
Aceptar Dentro del formulario de alta/modificación, valida y guarda los datos.

Buscar

Presione Buscar para traer los Oficiales. Puede dejar los filtros vacíos para ver el listado completo o usar ID / Nombre para acotar.

Nuevo / Modificar

Ambas acciones abren el formulario Alta y/o Modificación de Oficiales, dividido en datos generales y comisiones por producto.

Datos Generales:

Campo Descripción
Nombre Nombre del Oficial (obligatorio).
CUIT CUIT del Oficial con máscara ##-########-#. Se valida que sea un CUIT correcto al guardar.
Fórmula Fórmula asociada al Oficial (texto, hasta 30 caracteres).
E-Mail Correo del Oficial. Si se completa, se valida el formato.
Inversor Proveedor Financiero anclado al Oficial. Se selecciona desde el buscador de Inversores (link Inversor).
Informa Cheque Rechazado Si está tildado, el Oficial informa los cheques rechazados.

Comisiones — Solapa Factoring:

Campo Descripción
Gastos % Porcentaje de gastos sobre cheques.
Gastos V.C. % Porcentaje de gastos V.C.
Tasa Anual % Tasa anual aplicada.
Importe Fijo Importe fijo.
Otras Comisiones % Otras comisiones.
ITF % Porcentaje de ITF.
Comisión % Comisión del Oficial (se habilita y guarda solo si el Oficial tiene un Inversor asignado).
Interés % Interés del Oficial (se habilita y guarda solo si el Oficial tiene un Inversor asignado).

Comisiones — Solapa Bolsa:

Campo Descripción
Comisión % Comisión aplicada en operaciones de Bolsa.

Comisiones — Solapa Cambios:

Campo Descripción
Comisión % Comisión aplicada en operaciones de Cambios.

Importante: La solapa Cambios solo se muestra si el parámetro Cambios.PrecioDeCosto está activado. Si está desactivado, la solapa no aparece en el formulario.

Ejemplo práctico

  1. Ingresar a ARCHIVOS > Oficiales.
  2. Presionar Nuevo.
  3. En Datos Generales, cargar Nombre (ej.: "Juan Pérez"), CUIT y, opcionalmente, E-Mail y Fórmula.
  4. Si el Oficial trabaja contra un proveedor financiero, hacer clic en Inversor y seleccionarlo; luego cargar Comisión % e Interés % en la solapa Factoring.
  5. Completar las comisiones de Factoring (Gastos, Tasa, ITF, etc.) y, si corresponde, las de Bolsa y Cambios.
  6. Presionar Aceptar. El sistema valida el CUIT y el e-mail antes de guardar.

Consejos útiles

  • Cargue el CUIT completo: el sistema lo valida y no permite guardar si es inválido.
  • Los campos Comisión % e Interés % del Oficial solo se guardan cuando hay un Inversor asignado; si lo quita, esos valores se ponen en cero.
  • Si usa comisiones de Oficial (Comisión/Interés) debe seleccionar un Proveedor Financiero; de lo contrario el sistema avisa al aceptar.
  • Verifique el E-Mail antes de guardar: si el formato es incorrecto, el sistema lo advierte y no permite continuar.

Preguntas frecuentes

¿Por qué no veo la solapa Cambios? Porque el parámetro Cambios.PrecioDeCosto está desactivado. Solicite al administrador que lo habilite si necesita configurar comisiones de Cambios para el Oficial.
¿Por qué no puedo editar Comisión % e Interés % del Oficial? Esos campos solo se habilitan cuando el Oficial tiene un Inversor (Proveedor Financiero) asignado. Seleccione un Inversor desde el link correspondiente.
El sistema no me deja guardar por el CUIT, ¿qué hago? El CUIT se valida al aceptar. Verifique que esté completo y sea un CUIT correcto según la máscara ##-########-#.
¿Cómo listo todos los Oficiales? Deje los filtros (ID y Nombre) vacíos y presione Buscar.

Permisos

Permiso Descripción
Factoring.Archivos.Oficiales Permite el ingreso al formulario de Alta y Modificación de Oficiales.
Factoring.Archivos.Oficiales.Nuevo Permite crear Oficiales.
Factoring.Archivos.Oficiales.Modificar Permite modificar Oficiales.
Factoring.Archivos.Oficiales.Eliminar Permite eliminar Oficiales.

Información técnica

Sección de referencia para soporte/desarrollo. Basada en el análisis del formulario real de la v14 (FormOficiales, WinForms C#).

Formularios principales

Componente Detalle
Formulario búsqueda (form vivo) FormOficialesVPNET_WinForms/VPNET_WinForms/Factoring/FormOficiales.cs. Es el que abre el menú (frmNewMain.vbNew FormOficiales() con ShowFrmInDockPanel). Hereda de MultiForm; grilla gvResults de solo lectura. Soporta modo "Buscar" y modo "Seleccionar" (FormArgs.ModeEnum).
Formulario alta/mod (form vivo) FormOficialesAddModVPNET_WinForms/VPNET_WinForms/Factoring/FormOficialesAddMod.cs. Usa OficialesEditor (binding bsOficial).
Forms VB legacy (en desuso para este menú) VisualPlenarioNET/Factoring/frmOficiales.vb y frmOficiales_AddMod.vb. Quedan en el código pero el menú v14 ya no los abre.
Entidad / modelo VPNET_DataModel/Modelo/Oficiales.cs; mapping Mappings/Factoring/OficialesMap.cs.
Manager búsqueda (form vivo) VPNET_DataModel/Legacy/Factoring/OficialesManager.csOficialesManager.Buscar(BuscarArgs).
Manager EF (WCF/web) VPNET_DataModel/Manager/Gestion/Factoring/Oficiales_Manager.cs (Base_Manager<Oficiales>).

Permisos reales

Permiso (objeto) Habilita
Factoring.Archivos.Oficiales Abrir el formulario (gate en frmNewMain.vb, padre Factoring.Archivos; tipo Archivos.Oficiales).
Factoring.Archivos.Oficiales.Nuevo Crear oficial.
Factoring.Archivos.Oficiales.Modificar Modificar oficial.
Factoring.Archivos.Oficiales.Eliminar Eliminar oficial (definido en Oficiales_Manager; el form vivo no expone botón Eliminar).

Tablas de base de datos principales

Tabla Uso
Oficiales Tabla principal. PK Id; FK Id_InversorInversores (relación opcional ProveedorFinanciero). Campos de comisiones Cheques_*, CC_*, Bolsa_*, etc. Acceso EF.
Inversores Proveedor financiero asociado al oficial (combo/selector).

Relación con otros módulos / manuales

Manual relacionado Vínculo operativo
Cobradores y Vendedores Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad.

Notas para soporte (comportamiento real del código)

  • El form vivo es EF, no SP. OficialesManager.Buscar ejecuta LINQ sobre db.Oficiales.Include(ProveedorFinanciero), filtrando por Id (prioritario) o Nombre (Contains). El alta/baja se hace por EF (Oficiales_Manager.Save numera el Id con GetNextId_Numeraciones("Oficiales","Id")). Los SPs Oficiales_Search/Oficiales_Del corresponden a las clases VB legacy, no al flujo actual.
  • BuscarArgs solo expone Id y Nombre. Si ambos vacíos, lista todos.
  • Validaciones de alta (FormOficialesAddMod): CUIT validado con Functions.IsValidCuit; si se cargan comisiones de oficial (Comisión/Interés > 0) y no hay inversor, avisa "Si utiliza comisiones debe seleccionar un inversor". El inversor se elige lanzando por reflexión VisualPlenarioNET.frmInversores.
  • Exclusión mutua de comisiones: al cargar comisiones de cuenta corriente (CC_*) se ponen en cero las de cheques (Cheques_*) y viceversa (Validar_Comisiones_*).
  • Sobre la solapa "Cambios": el form vivo C# (FormOficialesAddMod) no contiene lógica que muestre/oculte una solapa Cambios según Cambios.PrecioDeCosto. Esa visibilidad condicional, si aplica, pertenece al form VB legacy frmOficiales_AddMod.vb, que ya no es el que abre el menú v14. Verificar contra el form efectivamente desplegado antes de afirmarlo en soporte.
¿Te resultó útil este manual?