Gestión de Localidades (Alta, Modificación y Administración) en el Módulo ARCHIVOS

Detalle

Campo	Valor
Manual de Usuario	ABM de Localidades: alta, modificación, eliminación y consulta de localidades (código postal, provincia, clearing) dentro del módulo ARCHIVOS.

Introducción

El módulo de Localidades permite organizar y mantener el catálogo geográfico del sistema, donde cada localidad se identifica por su Código Postal y se asocia a una Provincia. Este catálogo se reutiliza luego para vincular clientes, proveedores y demás entidades a un lugar específico.

Cada localidad almacena, además del nombre y la provincia, datos operativos como el Clearing (usado en operaciones de cheques), las Comisiones, los Días de más y, opcionalmente, un Número Hipotecario y un detalle de Códigos Hipotecarios por partido/provincia.

Importante: en este sistema el Código Postal es el identificador (Id) de la localidad. No se ingresa por separado: el campo "Cód. Postal" cumple ambas funciones.

Acceso al módulo

Ingresar a la solapa Archivos.
Seleccionar la opción Localidades.
Se abre la ventana Localidades con la barra de herramientas, los filtros de búsqueda y la grilla de resultados.

Importante: el acceso y cada operación requieren permisos asignados por el administrador del sistema (Archivos.Localidades y sus permisos de Nuevo, Modificar y Eliminar).

Pantalla principal

La ventana Localidades se compone de tres áreas:

Área	Descripción
Barra de herramientas superior	Botones Nuevo, Modificar, Eliminar, Imprimir y el check "Mostrar Codigos Hipotecarios".
Barra de filtros	Campos Nombre, Cód. Postal y Clearing más el botón Buscar.
Grilla de resultados	Lista las localidades con sus columnas, con totalizador y cantidad de registros en la barra inferior de estado.

La grilla incluye fila de autofiltro, panel de agrupamiento (se arrastran encabezados para agrupar) y permite selección múltiple.

Filtros de búsqueda

Los filtros de la barra superior se combinan al presionar Buscar:

Campo	Descripción
Nombre	Busca por coincidencia parcial del nombre de la localidad (los espacios actúan como comodín entre palabras).
Cód. Postal	Busca por código postal exacto. Solo se aplica si el valor ingresado es numérico.
Clearing	Busca por clearing exacto. Solo se aplica si el valor ingresado es numérico.
Mostrar Codigos Hipotecarios	Al tildarlo, agrega las columnas Partido y Código Hipotecario y vuelve a ejecutar la búsqueda incluyendo el detalle hipotecario.

Importante: tras cada búsqueda los campos de filtro se limpian automáticamente para preparar la siguiente consulta.

Resultados

La grilla muestra las siguientes columnas:

Columna	Descripción
Nombre	Nombre de la localidad.
Código Postal	Código postal / identificador de la localidad.
Clearing	Clearing asociado a la localidad.
Partido	Partido del código hipotecario (visible solo con "Mostrar Codigos Hipotecarios" tildado).
Código Hipotecario	Código hipotecario asociado (visible solo con "Mostrar Codigos Hipotecarios" tildado).

En la barra inferior de estado se indica el Total de Registros y la cantidad de Registros Seleccionados.

Acciones disponibles

Acción	Descripción
Nuevo	Abre la ventana de alta para crear una nueva localidad.
Modificar	Abre la ventana de edición de la localidad seleccionada.
Eliminar	Elimina la localidad seleccionada previa confirmación.
Imprimir	Genera la vista previa imprimible del resultado de la búsqueda.
Mostrar Codigos Hipotecarios	Muestra u oculta las columnas de detalle hipotecario en la grilla.

Nuevo (Alta)

Al presionar Nuevo se abre la ventana Alta y/o Modificacion de Localidades con los campos vacíos y el Cód. Postal habilitado para edición. Campos del grupo "Datos de Localidad":

Campo	Descripción
Descripción	Nombre de la localidad.
Provincia	Provincia a la que pertenece (combo; el enlace "Provincia:" abre el ABM de Provincias).
Comisiones	Valor de comisiones (numérico, admite decimales).
Cód. Postal	Código postal de la localidad. Es el identificador; obligatorio, numérico y distinto de cero.
Clearing	Clearing de la localidad. Debe ser múltiplo de 24.
Días mas	Días de más (obligatorio).
Hipotecario	Número hipotecario (visible solo si el parámetro `Localidades.NroHipotecario` está en 1).

Se confirma con el botón Aceptar. Si el Cód. Postal ya existe (y el modo hipotecario está desactivado), el sistema avisa que ya existe y no permite el alta.

Modificar

Con una localidad seleccionada en la grilla, Modificar abre la misma ventana con los datos cargados. Se ajustan los campos y se confirma con Aceptar. También se accede haciendo doble clic sobre la fila.

Eliminar

Con una localidad seleccionada, Eliminar pide confirmación ("Desea Eliminar el Item?") y, al aceptar, borra la localidad. Si no puede borrarse, muestra el mensaje correspondiente.

Códigos Hipotecarios (detalle)

Dentro de la ventana de Alta/Modificación, el grupo Código Hipotecario permite administrar el detalle por partido y provincia con los botones Agregar, Modificar y Eliminar sobre la lista de detalles.

Ejemplo práctico

Ingresar a Archivos > Localidades.
En el filtro Nombre escribir "Mar del Plata" y presionar Buscar para verificar si ya existe.
Si no existe, presionar Nuevo.
Completar Descripción = "Mar del Plata", elegir la Provincia = "Buenos Aires", Cód. Postal = "7600", Clearing = "24" (múltiplo de 24) y Días mas = "0".
Presionar Aceptar. La localidad queda registrada y la grilla se actualiza con el nuevo registro.

Consejos útiles

El Clearing debe ser múltiplo de 24; de lo contrario el sistema rechaza el guardado con el aviso correspondiente.
El Cód. Postal es la clave de la localidad: debe ser numérico, distinto de cero y único (salvo el modo hipotecario que permite duplicados diferenciados por número de banco hipotecario).
Use el filtro Nombre antes de dar de alta para evitar duplicados.
Tilde Mostrar Codigos Hipotecarios solo cuando necesite ver el detalle de partido/código hipotecario; al hacerlo se recarga la búsqueda.
Puede operar con el teclado en la grilla: Insert abre Nuevo, Suprimir elimina y Enter/Espacio abre la modificación.

Preguntas frecuentes

¿Por qué no encuentro un campo Cód. Postal separado del Id?

Porque en Localidades el Código Postal es el propio identificador (Id) del registro. El campo "Cód. Postal" cumple ambas funciones.

El sistema no me deja guardar el Clearing, ¿por qué?

El Clearing debe ser un número múltiplo de 24. Si ingresa otro valor, aparece el aviso "El Clerin no es válido..." y debe corregirlo.

¿Por qué no veo el campo Hipotecario en el alta?

El campo Hipotecario y la lógica de número hipotecario solo aparecen cuando el parámetro `Localidades.NroHipotecario` está configurado en 1. Con valor 0 permanece oculto.

Me avisa que el código postal ya existe, ¿qué hago?

Significa que ya hay una localidad con ese Cód. Postal. Verifique con el filtro de búsqueda y, si corresponde, modifique la existente en lugar de crear una nueva.

Permisos

Permiso	Descripción
Archivos.Localidades	Acceso al módulo de Localidades.
Archivos.Localidades.Nuevo	Permite crear localidades.
Archivos.Localidades.Modificar	Permite modificar localidades.
Archivos.Localidades.Eliminar	Permite eliminar localidades.

Los permisos se asignan desde la administración de seguridad del sistema. Sin el permiso correspondiente, la acción no se ejecuta.

Información técnica

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

Formularios principales

Componente	Detalle
Formulario principal	`frmLocalidades` (título "Localidades") — `VisualPlenarioNET/VisualPlenarioNET/CommonUI/frmLocalidades.vb`. Es esta copia (carpeta `CommonUI`) la que compila el proyecto (`.vbproj`) y la que abre el menú; la copia en `Common/frmLocalidades.vb` queda fuera de compilación. Hereda de `MultiForm`.
Formulario alta/modificación	`frmLocalidades_AddMod` ("Alta y/o Modificacion de Localidades") — `CommonUI/frmLocalidades_AddMod.vb`.
Detalle hipotecario	`frmLocalidades_Add_CodigosHipotecarios` — `CommonUI/`.
Clase de negocio	`clsLocalidades` (+ `clsLocalidades_hipotecario` / `_Collection`) — `ClassVisualPlenarioNET/Common/clsLocalidades.vb` (ADO.NET sobre SPs, no EF).
Acceso (menú)	Archivos > Localidades — `frmNewMain.vb` abre `New frmLocalidades(Me)` con `ShowFrmInDockPanel`, previo permiso `Archivos.Localidades`.

Permisos reales

Permiso (objeto)	Habilita
`Archivos.Localidades`	Abrir el formulario (gate en `frmNewMain.vb`, padre `Archivos`).
`Archivos.Localidades.Nuevo`	Crear localidad (validado en `Nuevo()`, padre `Archivos.Localidades`).
`Archivos.Localidades.Modificar`	Modificar localidad.
`Archivos.Localidades.Eliminar`	Eliminar localidad.

Tablas de base de datos principales

Tabla	Uso
`Localidades`	Tabla principal. `id` = código postal (PK), `nombre`, `provincia`, `comi`, `clearing`, `dias_de_mas`, `Nro_Hipotecario`, `ValorAlCobro`.
`Localidades_Hipotecario`	Detalle partido/código hipotecario (se une al activar "Mostrar Codigos Hipotecarios").
`Provincias`	Provincia asociada a la localidad.

Relación con otros módulos / manuales

Esta funcionalidad forma parte de Gestión Comercial. No declara otro manual operativo como dependencia directa en su metadata actual.

Notas para soporte (comportamiento real del código)

Acceso por SPs ADO.NET (no EF): Localidades_Search, Localidades_Add, Localidades_Mod, Localidades_Del (más variantes Localidades_Hipotecario_*), invocados desde clsLocalidades.vb con SqlCommand/SqlDataAdapter.
Parámetro Localidades.NroHipotecario: 1 = usa número de banco hipotecario (permite CP duplicados diferenciados por nro., habilita campo Hipotecario); 0 = desactivado/oculto. Se lee con clsParametros.GetParameterValue.
Columnas de grilla (FieldName reales): nombre, id (Código Postal), clearing, PartHip (Partido), CodHip (Código Hipotecario). Las dos últimas se ocultan/muestran según el check chkFiltroHipotecario.
Búsqueda: objLocalidades.Search(...) con CP y clearing solo si son numéricos (IsNumeric), nombre por LIKE parcial; el último parámetro (@filtroHip = 1 al tildar "Mostrar Codigos Hipotecarios") agrega el detalle hipotecario. Tras cada búsqueda se limpian txtNombre/txtCP/txtClearing.
El check chkFiltroHipotecario arranca en True por Designer, pero el Load lo fuerza a False.
Atajos sobre la grilla: Insert = Nuevo, Supr = Eliminar, Enter/Espacio = Modificar (o selección si es selector), Esc cierra.