Requerimiento de Feature: Gestión de Conceptos de Retenciones

Módulo: Tesorería
Ubicación: Tesorería -> Bases -> Retenciones
Concepto: Retención de Tesorería (Boniret)

---

1. Descripción General

Este requerimiento define la necesidad de una interfaz de usuario para la administración de los Conceptos de Retención. Esta funcionalidad permitirá a los usuarios definir y configurar los tipos de retenciones que el sistema aplicará posteriormente en los procesos de cobros y pagos.

El objetivo es proveer una herramienta sencilla y rápida para que el tesorero o administrador pueda dar de alta, modificar o eliminar estos conceptos sin requerir intervención técnica.

2. Alcance Funcional

La funcionalidad debe permitir gestionar el ciclo de vida completo de una retención:

• Visualización: Listado de todas las retenciones configuradas.
• Alta: Registro de nuevas retenciones.
• Modificación: Edición de parámetros de retenciones existentes.
• Baja: Eliminación de retenciones que ya no se utilicen.

3. Especificaciones de la Interfaz

3.1. Listado Principal

La vista principal debe presentar una lista con las retenciones existentes. Dado que el volumen de datos suele ser bajo para esta entidad, el listado debe priorizar la inmediatez en la interacción.

Datos a mostrar por fila:

• Código/ID: Identificador único.
• Nombre: Descripción de la retención (ej. "IIBB", "Ganancias").
• Acciones: Opciones para Editar y Eliminar el registro.

Funcionalidades requeridas en el listado:

• Búsqueda rápida: Capacidad de filtrar las retenciones en tiempo real escribiendo parte del nombre.
• Ordenamiento: Posibilidad de ordenar la lista por sus columnas.
• Paginación: Navegación por páginas si el listado excede un tamaño manejable visualmente.

3.2. Gestión de Registros (Alta y Edición)

La creación y edición de registros debe realizarse en una ventana emergente o formulario dedicado que mantenga al usuario en contexto.

Campos del Formulario:

1. Nombre: Texto libre para identificar la retención. Dato obligatorio.

2. Tipo de Facturación:

   • Debe permitir seleccionar entre dos modalidades (ej. Porcentaje vs Monto Fijo).
   • Esta selección determinará cómo se interpreta el valor numérico ingresado.

   Ayuda contextual importante:

   ⚠️ Escalas progresivas de retención de ganancias:

   Las escalas progresivas (según RG AFIP 5423/2023) solo se aplican a proveedores INSCRIPTOS en ganancias.

   Los proveedores NO INSCRIPTOS siempre usan un porcentaje fijo de 28%, independientemente de las escalas configuradas en el concepto de retención.

   Ver: RG_5423_Codigo_119_Calculo_Retenciones.md para detalles de las escalas del código 119.

3. Valor:

   • Campo numérico obligatorio.
   • Representará el % o el monto fijo $.

4. Imputación Contable:

   • Buscador predictivo para seleccionar la Cuenta Contable asociada.
   • El usuario debe poder escribir parte del nombre o número de la cuenta contable para encontrarla.

5. Acumulación de Retenciones:

   • Opción activable (Check) para indicar si esta retención se acumula con otras.
   • Ayuda al usuario: Debe incluir una explicación visual destacada (tipo etiqueta o distintivo) que aclare: "Si se activa, este concepto se calculará porcentualmente sobre las retenciones previamente agregadas."

3.3. Eliminación

• La acción de eliminar debe solicitar una confirmación explícita al usuario para evitar borrados accidentales.
• El sistema debe validar que la retención no esté siendo utilizada en operaciones históricas antes de permitir su eliminación completa (o gestionar un borrado lógico transparente al usuario).

4. Flujo de Usuario

1. El usuario navega a Tesorería -> Bases -> Retenciones.
2. Visualiza el listado.
3. Para crear: presiona botón "Alta" -> Completa formulario -> Guarda -> El listado se actualiza.
4. Para editar: presiona "Modificar" en un renglón -> Modifica formulario -> Guarda -> El listado se actualiza.
5. Para borrar: presiona "Borrar" -> Confirma -> El registro desaparece del listado.

---

Documento de Requerimiento Funcional