Detalle
| Campo | Valor |
|---|---|
| Manual de Usuario | ABM (alta, baja y modificación) de escalas de retención. Define los tramos de monto (Importe Desde / Importe Hasta) y la alícuota, el importe fijo y el excedente que se aplican a cada tramo. |
| Módulo | Legales e Impuestos |
| Pantalla | Retenciones: Escalas |
Introducción
La pantalla Retenciones: Escalas te permite armar y mantener los tramos de retención que el sistema usa para calcular percepciones y retenciones por escala.
Cada escala representa un tramo de monto, definido por un Importe Desde y un Importe Hasta, al que se le asocia un Porcentaje (alícuota), un Importe fijo y un Excedente. Las escalas se agrupan mediante un Código de Escala, que permite tener varios tramos correlativos dentro de una misma tabla de retención.
Estas escalas se vinculan con los tipos de conceptos de retención que tengan marcada la opción de aplicar escala (ver impuestos-retenciones-tipo-de-conceptos).
En este manual vas a ver cómo entrar a la pantalla, buscar las escalas cargadas, crear una escala nueva, modificarla y eliminarla.
Acceso al módulo
- Iniciá sesión — Entrá a Plenario con tu usuario y contraseña.
- Abrí la solapa Legales/Impuestos — Desde el menú principal, ingresá a la sección Legales e Impuestos.
- Buscá la opción de Retenciones por escala — Dentro de la solapa, ubicá la opción de Retenciones: Escalas (Percepciones / Alícuota).
- Abrí la pantalla — Hacé clic y se abre la ventana Retenciones: Escalas con el listado de escalas ya cargadas.
Importante: el acceso a esta pantalla depende de los permisos asignados a tu usuario. Si no la ves o no podés operar, pedíselos al administrador del sistema.
Pantalla principal
Al abrir la pantalla vas a ver una ventana con tres zonas:
| Zona | Para qué sirve |
|---|---|
| Barra de herramientas (arriba) | Botones de ABM Nuevo, Modificar y Eliminar, más las opciones de búsqueda e impresión. |
| Panel de búsqueda | Permite filtrar por N° ID y tiene el botón Buscar para refrescar el listado. |
| Listado central | Tabla con todas las escalas cargadas. Se llena automáticamente al abrir la pantalla. |
El listado responde al doble clic y a la tecla Enter sobre una fila para abrir la escala en modo modificación.
Filtros de búsqueda
El panel de búsqueda permite acotar el listado:
| Campo | Descripción |
|---|---|
| N° ID | Filtra por el número de ID de una escala puntual. Si lo dejás en cero (o vacío), el sistema trae todas las escalas. |
Pasos para buscar:
- Ingresá el N° ID que querés ubicar (o dejalo vacío para ver todas).
- Presioná Buscar.
- El listado se actualiza con el resultado.
La casilla de limpiar parámetros reinicia el filtro de búsqueda a su estado inicial.
Resultados
El listado central muestra una fila por cada escala, con estas columnas:
| Columna | Descripción |
|---|---|
| Id | Número interno que el sistema asigna a la escala. |
| Importe Desde | Monto inicial del tramo. |
| Importe Hasta | Monto final del tramo. |
| Importe | Importe fijo asociado al tramo. |
| Porcentaje | Alícuota (porcentaje) que se aplica en el tramo. |
| Excedente | Importe excedente del tramo. |
| Codigo Escala | Código que agrupa los tramos de una misma tabla de retención. |
Todos los importes se muestran con dos decimales. Las columnas del listado son de solo lectura: para cambiar un valor hay que abrir la escala con Modificar.
Acciones disponibles
| Acción | Descripción |
|---|---|
| Nuevo | Crea una escala nueva. |
| Modificar | Edita los importes, el porcentaje, el excedente o el código de una escala existente. |
| Eliminar | Borra la escala seleccionada. |
| Buscar | Refresca el listado según el filtro de N° ID. |
| Imprimir | Imprime los resultados de la búsqueda y permite exportarlos a Excel y PDF. |
Nuevo
- Hacé clic en Nuevo.
- Se abre la ventana de carga con estos campos:
| Campo | Descripción |
|---|---|
| Importe Desde | Monto inicial del tramo. Debe ser menor que Importe Hasta. |
| Importe Hasta | Monto final del tramo. Es obligatorio y no puede quedar en cero. |
| Importe | Importe fijo del tramo. |
| Porcentaje | Alícuota a aplicar. Es obligatoria (no puede ser cero). |
| Excedente | Importe excedente del tramo. |
| Cod Escala | Código que agrupa los tramos. Es obligatorio. |
- Completá los campos y presioná Aceptar.
El sistema valida que ningún valor sea negativo, que Importe Desde sea menor a Importe Hasta, que Importe Hasta no quede en cero, que el Porcentaje no sea cero y que el Código de Escala esté completo. Si no se cumple alguna condición, muestra el aviso correspondiente y no guarda hasta corregirla.
Modificar
- Seleccioná la escala en el listado.
- Hacé clic en Modificar (o doble clic sobre la fila, o tecla Enter).
- La ventana se abre con los datos cargados. Cambiá los valores que necesites.
- Presioná Aceptar para guardar los cambios.
Eliminar
- Seleccioná la escala en el listado.
- Hacé clic en Eliminar.
- El sistema pregunta "Desea eliminar el registro seleccionado ?". Confirmá con Sí.
- Al borrar, muestra "Este registro fue eliminado correctamente" y refresca el listado.
Importante: eliminá solo escalas que no estén siendo usadas por un concepto de retención. Si una escala está en uso, conviene revisar la tabla completa antes de borrar un tramo, para no romper la correlatividad de los montos.
Ejemplo práctico
Querés cargar el primer tramo de una tabla de retención con código RET-GAN:
- Abrís la pantalla Retenciones: Escalas.
- Hacés clic en Nuevo.
- En Importe Desde escribís
0,00. - En Importe Hasta escribís
100000,00. - En Importe escribís
0,00(sin importe fijo en este tramo). - En Porcentaje escribís
2,00. - En Excedente escribís
0,00. - En Cod Escala escribís
RET-GAN. - Presionás Aceptar.
La escala queda agregada al listado. Repetís el proceso con los tramos siguientes (por ejemplo, de 100000,00 a 300000,00), usando siempre el mismo Código de Escala RET-GAN para que queden agrupados.
Consejos útiles
- Cargá los tramos de una misma tabla con el mismo Código de Escala para que el cálculo los reconozca como un conjunto correlativo.
- Asegurate de que los tramos no se superpongan ni dejen huecos: el Importe Hasta de un tramo debería empalmar con el Importe Desde del siguiente.
- Recordá que Importe Desde siempre tiene que ser menor que Importe Hasta; si los igualás o invertís, el sistema no te deja guardar.
- El Porcentaje es obligatorio: si un tramo solo aplica importe fijo, igual necesitás cargar un valor de alícuota distinto de cero según tu esquema.
- Usá el filtro por N° ID y el botón Imprimir (exportá a Excel/PDF) para revisar y documentar la tabla completa.
Preguntas frecuentes
¿Por qué no me deja guardar si dejo Importe Hasta en cero?
Importe Hasta es obligatorio y no puede quedar en cero. El sistema muestra "Debe definir un valor para Importe Hasta." hasta que cargues un monto válido.¿Qué pasa si pongo Importe Desde mayor o igual que Importe Hasta?
El sistema muestra "Importe Desde debe ser menor a Importe Hasta." y no guarda hasta que corrijas los valores.¿Puedo dejar el Porcentaje en cero?
No. El porcentaje es obligatorio; si lo dejás en cero el sistema avisa "Debe definir un Porcentaje." y no guarda.¿Para qué sirve el Código de Escala?
Agrupa los distintos tramos de una misma tabla de retención. Es obligatorio: si lo dejás vacío, el sistema avisa "Debe definir un Codigo de Escala.".¿Puedo cargar valores negativos?
No. Ningún valor (Importe Desde, Importe Hasta, Importe, Porcentaje o Excedente) puede ser negativo. El sistema muestra "Ningún valor puede ser negativo." y bloquea el guardado.¿Cómo busco una escala puntual?
Ingresá su N° ID en el filtro y presioná Buscar. Si dejás el filtro vacío o en cero, el listado muestra todas las escalas cargadas.Permisos
El acceso y la operación sobre esta pantalla dependen de los permisos asignados a tu usuario. Si no podés ver la pantalla o realizar alguna acción (crear, modificar, eliminar o imprimir), solicitá la habilitación al administrador del sistema.
Información técnica
Basada en el análisis del formulario real de la v14.
Formularios principales
| Form | Rol |
|---|---|
FormRetenciones_Escalas |
Listado ABM. C#, hereda de FrmResult. Ruta: VPNET_WinForms\VPNET_WinForms\Impuestos\FormRetenciones_Escalas.cs. GridControl gcRetenciones_Escalas / GridView gvRetenciones_Escalas (columnas Id, Importe_Desde, Importe_Hasta, Importe, Porcentaje, Excedente, CodigoEscala). Se abre con Me.ShowFrmInDockPanel(New FormRetenciones_Escalas) desde el botón de menú btnImpuestos_Retenciones_Escalas ("Retenciones: Escalas"). Enter / doble clic = Modificar. Confirmación de baja: "Desea eliminar el registro seleccionado ?"; éxito: "Este registro fue eliminado correctamente". |
FormRetenciones_Escalas_AddMod |
Alta/modificación. C#, hereda de FrmAddMod. Ruta: VPNET_WinForms\VPNET_WinForms\Impuestos\FormRetenciones_Escalas_AddMod.cs. Controles txtImporte_Desde, txtImporte_Hasta, txtImporte, txtPorcentaje, txtExcedente y textEdit1 (CodigoEscala). Validaciones (mensajes exactos): "Ningún valor puede ser negativo.", "Importe Desde debe ser menor a Importe Hasta.", "Debe definir un valor para Importe Hasta.", "Debe definir un Porcentaje.", "Debe definir un Codigo de Escala.". |
Tipos_Conceptos_Escalas_Manager |
Manager de negocio. C#, Base_Manager. Ruta: VPNET_DataModel\Manager\Gestion\Impuestos\Tipos_Conceptos_Escalas_Manager.cs. GetDatasources arma el listado por LINQ sobre vpnetContext.Tipos_Conceptos_Escalas filtrando solo por Id (0 = todos). Save() asigna Id = GetNextId_Numeraciones("Tipos_Conceptos_Escalas", "Id") en alta. Entidad Tipos_Conceptos_Escalas (Id, Importe_Desde, Importe_Hasta, Importe, Porcentaje, Excedente, CodigoEscala) + mapping Tipos_Conceptos_EscalasMap.cs. |
Permisos reales
| Permiso | Acción |
|---|---|
| (ninguno) | El formulario no ejecuta IsAllowedObject ni KeyLicences: abre directo desde el menú, sin chequeo de permiso (ver Notas para soporte). |
Tablas de base de datos principales
| Tabla | Uso |
|---|---|
Tipos_Conceptos_Escalas |
Tramos de retención por escala. Columnas: Id INT PK (sin IDENTITY, numerado por Get_CodNew/GetNextId_Numeraciones), Importe_Desde/Importe_Hasta/Porcentaje/Excedente DECIMAL(18,2), Importe DECIMAL(18,0), CodigoEscala VARCHAR(250) NULL. CRUD vía EF (no usa los SP). |
Relación con otros módulos / manuales
| Manual relacionado | Vínculo operativo |
|---|---|
| Impuestos Retenciones Tipo de Conceptos | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
Notas para soporte
- Sin chequeo de permisos. Ni
FormRetenciones_Escalasni su AddMod llaman aIsAllowedObject/KeyLicences. La sección Permisos del manual ("dependen de los permisos asignados") no refleja el código: el único control es la visibilidad del botón de menú. Importesin decimales en la base. La columnaImporteesDECIMAL(18,0)(entero), noDECIMAL(18,2)como las demás. Si se carga un importe fijo con centavos, el valor se trunca al guardar.- Stored procedures en desuso / desincronizados. Existen
Tipos_Conceptos_Escalas_Add/Mod/Del/Search, pero el manager opera por EF y no los invoca. Los SP_Addy_Modno incluyen el parámetroCodigoEscala(quedaron viejos);_Searchusa SQL dinámico con concatenación de strings (Exec(@SQLString)), sin parametrizar. No afectan al alta normal porque el guardado va por EF, pero conviene no llamarlos directamente. - Control mal nombrado. El campo CodigoEscala usa el control genérico
textEdit1en vez de un nombre descriptivo (txtCodigoEscala).