← Índice de manuales
Manual funcional · Sistema Plenario v14

Impuestos Retenciones Escalas

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.

Módulo: Legales e ImpuestosVersión: 1.1Actualizado: 2026-06-19

Retenciones: Escalas

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

  1. Iniciá sesión — Entrá a Plenario con tu usuario y contraseña.
  2. Abrí la solapa Legales/Impuestos — Desde el menú principal, ingresá a la sección Legales e Impuestos.
  3. Buscá la opción de Retenciones por escala — Dentro de la solapa, ubicá la opción de Retenciones: Escalas (Percepciones / Alícuota).
  4. 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:

  1. Ingresá el N° ID que querés ubicar (o dejalo vacío para ver todas).
  2. Presioná Buscar.
  3. 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

  1. Hacé clic en Nuevo.
  2. 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.
  1. 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

  1. Seleccioná la escala en el listado.
  2. Hacé clic en Modificar (o doble clic sobre la fila, o tecla Enter).
  3. La ventana se abre con los datos cargados. Cambiá los valores que necesites.
  4. Presioná Aceptar para guardar los cambios.

Eliminar

  1. Seleccioná la escala en el listado.
  2. Hacé clic en Eliminar.
  3. El sistema pregunta "Desea eliminar el registro seleccionado ?". Confirmá con .
  4. 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:

  1. Abrís la pantalla Retenciones: Escalas.
  2. Hacés clic en Nuevo.
  3. En Importe Desde escribís 0,00.
  4. En Importe Hasta escribís 100000,00.
  5. En Importe escribís 0,00 (sin importe fijo en este tramo).
  6. En Porcentaje escribís 2,00.
  7. En Excedente escribís 0,00.
  8. En Cod Escala escribís RET-GAN.
  9. 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_Escalas ni su AddMod llaman a IsAllowedObject/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ú.
  • Importe sin decimales en la base. La columna Importe es DECIMAL(18,0) (entero), no DECIMAL(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 _Add y _Mod no incluyen el parámetro CodigoEscala (quedaron viejos); _Search usa 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 textEdit1 en vez de un nombre descriptivo (txtCodigoEscala).
¿Te resultó útil este manual?