Appearance
Retenciones Genéricas - Módulo Tesorería
Módulo: Tesorería Estado: 🟡 PARCIALMENTE IMPLEMENTADO
- ✅ ABM de conceptos de retención (boniret)
- ✅ Carga de retenciones en recibo (implementado)
- ❌ Visualización de retenciones en PDF de recibo (pendiente)
Última actualización: 2026-03-11
Introducción
Las Retenciones Genéricas son deducciones fiscales que la empresa debe aplicar en operaciones de cobro y pago, como retenciones de:
- Ingresos Brutos (IIBB)
- SUSS (Sistema Único de Seguridad Social)
- Otras retenciones provinciales o municipales
A diferencia de las Retenciones de Ganancias, estas retenciones tienen reglas más simples y se configuran en el módulo de Tesorería.
Características Principales
Simplicidad vs Retenciones de Ganancias
| Característica | Retenciones Genéricas | Retenciones de Ganancias |
|---|---|---|
| Módulo | Tesorería | Compras/CtaCte |
| Método de cálculo | Porcentaje o monto fijo | Escalas progresivas o % |
| Acumulados mensuales | ❌ No | ✅ Sí |
| Mínimo no imponible | ❌ No | ✅ Sí |
| Inscripción fiscal | ❌ N/A | ✅ Inscripto/No inscripto |
| Escalas progresivas | ❌ No | ✅ Sí (inscriptos) |
| Acumulables | ✅ Sí (entre conceptos) | ❌ No |
| Complejidad | Baja | Alta |
Documentación de Ganancias: Ver ../../compra/retenciones/
Flujo Simplificado
┌─────────────────────────────────────────────────────────┐
│ FLUJO DE RETENCIONES GENÉRICAS │
├─────────────────────────────────────────────────────────┤
│ │
│ 1. CONFIGURACIÓN (Tesorería) │
│ └─ Crear Concepto de Retención (boniret) │
│ ├─ Nombre (ej: "IIBB - 3%") │
│ ├─ Tipo: Porcentaje o Monto Fijo │
│ ├─ Valor (3.0 para 3%) │
│ ├─ Cuenta contable │
│ └─ Acumulable (opcional) │
│ │
│ 2. APLICACIÓN (Tesorería) │
│ └─ Crear Recibo o Orden de Pago │
│ └─ Seleccionar conceptos de retención │
│ └─ Sistema calcula: │
│ ├─ Si porcentaje: monto × % │
│ └─ Si fijo: monto configurado │
│ │
│ 3. REGISTRO (Tesorería) │
│ └─ Registrar movimiento de recibo/orden │
│ └─ Registrar relación en recret │
│ └─ Movimiento contable │
│ │
└─────────────────────────────────────────────────────────┘Documentación por Componentes
01. Conceptos de Tesorería
Qué cubre: Tabla boniret - Configuración de conceptos de retención
Contenido:
- Atributos de la entidad (nombre, valor, tipo, cuenta contable)
- Tipo de cálculo (porcentaje vs monto fijo)
- Clasificación (impuesto/servicio)
- Acumulación entre conceptos
- Operaciones CRUD
- Reglas de validación
Cuándo leer: Para configurar nuevos conceptos de retención genérica
02. Gestión de UI
Qué cubre: Interfaz de usuario para gestión de retenciones
Contenido:
- Listado de retenciones
- Formularios de alta/edición
- Búsqueda y filtros
- Validaciones de frontend
- Flujo de usuario
Cuándo leer: Para entender cómo los usuarios gestionan retenciones desde la UI
02b. Carga de Retenciones en Recibos
Qué cubre: Proceso de aplicación de retenciones durante la generación de recibos
Contenido:
- Interacción del botón "Retenciones" y modal en el formulario de recibos
- Reglas de cálculo (porcentaje y monto fijo)
- Registro de movimientos en cuenta corriente
- Impacto en tesorería (ingresos y egresos)
- Cancelación de deuda sin retenciones
- Casos de uso detallados
Cuándo leer: Para entender cómo se aplican retenciones al generar un recibo de cobro
03. Visualización en PDF de Recibo
Qué cubre: Proceso de muestra de retenciones de cobranza en el PDF generado al emitir o reimprimir un recibo
Contenido:
- Comportamiento esperado en el PDF (retenciones dinámicas, total correcto)
- Approach: análogo a retenciones de ganancias en orden de pago
- Reglas de negocio RN-008 y RN-009
- Casos de uso: emisión, reimpresión, recibo sin retenciones
Cuándo leer: Para entender qué debe mostrarse en el PDF cuando un recibo tiene retenciones genéricas aplicadas
03. Relaciones
Qué cubre: Tabla recret - Relación recibo-retenciones
Contenido:
- Esquema de la tabla recret
- Vinculación recibo-retención
- Campos y relaciones
- Uso y contexto
Cuándo leer: Para entender cómo se vinculan recibos con retenciones aplicadas
Entidades de Base de Datos
Tabla: boniret (Conceptos de Retención)
Configuración de conceptos de retenciones genéricas.
| Campo | Descripción |
|---|---|
nombre | Identificador del concepto (ej: "IIBB") |
cuenta_contable | Cuenta para imputación |
valor | Monto o porcentaje a aplicar |
tipo_calculo | PORCENTAJE o FIJO |
es_impuesto_servicio | Indicador de clasificación |
acumulable | Si se suma a otras retenciones |
Tabla: recret (Relación Recibo-Retenciones)
Vinculación entre recibos y retenciones aplicadas.
| Campo | Descripción |
|---|---|
id_recibo | UUID del recibo |
id_mov_retencion | UUID del movimiento de retención |
mulcta | Multiplicador de cuenta |
id_retencion | ID del concepto de retención |
Tipos de Cálculo
Porcentaje
El valor se interpreta como porcentaje a aplicar sobre el monto del recibo/orden.
Ejemplo:
Concepto: IIBB - 3%
- Tipo: PORCENTAJE
- Valor: 3.0
Recibo de $10,000
Retención = $10,000 × 3% = $300Monto Fijo
El valor es un monto fijo que se deduce independientemente del total.
Ejemplo:
Concepto: Tasa Municipal
- Tipo: FIJO
- Valor: 250
Recibo de $10,000
Retención = $250 (fijo)Acumulación de Retenciones
Si el concepto tiene acumulable = true, su cálculo se suma a las retenciones previas ya agregadas.
Ejemplo:
Recibo: $10,000
Retención 1: IIBB 3%
- Sobre $10,000 = $300
Retención 2: SUSS 2% (acumulable)
- Sobre ($10,000 + $300) = $206
Total retenido: $506
Neto al cliente: $9,494Diferencias Clave con Retenciones de Ganancias
1. Sin Acumulados Mensuales
No hay tabla de acumulados. Cada retención se calcula independientemente sin considerar el historial del período.
2. Sin Mínimo No Imponible
No existe umbral mínimo. Si se configura la retención, se aplica siempre.
3. Sin Escalas Progresivas
El cálculo es directo: porcentaje o monto fijo, sin rangos ni tramos.
4. Sin Diferenciación de Inscripción
No se considera si el tercero es inscripto o no. Se aplica el mismo cálculo para todos.
Casos de Uso
CU-1: Aplicar IIBB en Recibo de Cobro
Flujo:
- Usuario crea recibo de cobro por $15,000
- Usuario selecciona concepto "IIBB - 3%"
- Sistema calcula: $15,000 × 3% = $450
- Usuario confirma
- Sistema registra:
- Recibo por $15,000
- Retención IIBB: $450
- Neto a cobrar: $14,550
- Relación en
recret
CU-2: Múltiples Retenciones Acumulables
Flujo:
- Usuario crea orden de pago por $20,000
- Usuario agrega "IIBB - 2%" → $400
- Usuario agrega "SUSS - 1%" (acumulable) → $204 (sobre $20,400)
- Sistema calcula total: $604
- Proveedor recibe: $19,396
Reglas de Negocio
RN-001: Unicidad del Nombre
No pueden existir dos conceptos activos con el mismo nombre.
RN-002: Validación de Cuenta Contable
La cuenta contable debe existir en el plan de cuentas.
RN-003: Consistencia del Valor
- Si tipo es PORCENTAJE: valor entre 0 y 100
- Si tipo es FIJO: valor > 0
RN-004: Borrado Lógico
Los conceptos usados en transacciones no pueden eliminarse, solo desactivarse.
Integraciones
Con Contabilidad
Cada retención genera un movimiento contable usando la cuenta configurada en boniret.cuenta_contable.
Con Tesorería
Las retenciones afectan el flujo de caja:
- En recibos: reducen el ingreso neto
- En órdenes de pago: reducen el egreso neto
Navegación
- Retenciones de Ganancias →: Sistema complejo con escalas y acumulados (Módulo Compras)
- Documentación General de Retenciones: Para entender la integración entre ambos sistemas
Documentación Técnica
Base de Datos
- Diagrama ERD: Ver diagrama de relaciones
- Tablas:
boniret,recret
Backend
- Documentación Backend: ../../../backend/index.md
Frontend
- Documentación Frontend: ../../../frontend/index.md
Documentación de Retenciones Genéricas Sistema Bautista ERP