Tarifas¶
Las tarifas definen el precio que cobra el club por cada categoría de inscripción: cuánto cuesta el rugby infantil, cuánto el adulto, etc.
Cada tarifa puede tener múltiples períodos de vigencia según la cantidad de socios inscritos (la cuota puede variar si el club crece) y múltiples vencimientos (1er y 2do vencimiento, con importes potencialmente diferentes).
Conceptos clave¶
Tarifa¶
Una tarifa es una plantilla de precios que se asigna a una o más categorías. No es el precio en sí, sino un contenedor de períodos.
- Descripción: nombre de la tarifa (ej: "Rugby General", "Pilates").
- No aplicar descuento por forma de pago: checkbox especial para tarifas de actividades tercerizadas o con reglas especiales. Cuando está marcada, las cuotas de esta tarifa NO reciben descuento aunque se paguen con transferencia, efectivo, etc.
- Activa: si está desactivada (archivada), no aparece en el listado ni se puede asignar a nuevas categorías.
- Categorías que la usan: listado de categorías activas que tienen asignada esta tarifa. No se puede archivar una tarifa mientras tenga categorías activas asociadas.
Período¶
Un período es el precio concreto en un rango de fechas y cantidad de socios.
- Tarifa: la tarifa a la que pertenece.
- Desde / Hasta: rango de fechas. "Hasta" puede ser vacío si el período está vigente sin fecha de fin.
- Socios Desde / Hasta: rango de cantidad de socios del grupo familiar. Permite precios diferenciados: 1 socio paga X, 2+ socios pagan Y.
- Importe 1er Vencimiento: precio que se cobra en el vencimiento principal de la actividad.
- Importe 2do Vencimiento: precio adicional que se cobra DESPUÉS del vencimiento + días de gracia configurados en la categoría. Puede ser igual o mayor al 1er vencimiento.
Modo H vs. V (en cobros)¶
Este concepto se aplica a nivel de categoría (no tarifa) pero afecta cómo se calculan los precios:
- Histórico (H): cuando se recalcula una cuota vencida, usa el precio vigente EN el día del vencimiento original (el período válido en esa fecha histórica).
- Vigente (V): cuando se recalcula una cuota, usa el precio vigente HOY (el período válido en la fecha de recálculo).
Administración¶
Dónde se edita¶
Configuración → Tarifas en el menú principal.
Listado¶
El listado muestra todas las tarifas activas, ordenadas alfabéticamente:
| Columna | Contenido |
|---|---|
| Descripción | Nombre de la tarifa. |
| Tarifa 1er. Vto. | Badges con todos los períodos vigentes y futuros del 1er vencimiento. Cada badge muestra [socios_desde-socios_hasta] $importe (vigencia). El color indica el estado: verde si está vigente sin fin, gris si vencido, azul si futuro. |
| Tarifa 2do. Vto. | Solo se muestra si hay al menos un período con importe diferente en el 2do vencimiento. Mismo formato que el 1er vto. |
| No aplicar descuento | Icono de prohibición (🚫) si está marcada la opción. |
| Categorías que la utilizan | Listado de badges con las categorías activas que usan esta tarifa. Click en un badge navega a la ficha de la categoría. |
| Acciones | Botones para ver detalle, editar, archivar (si es posible) y eliminar. |
Crear una tarifa¶
- Click en el botón + Agregar (arriba del listado).
- Completá el formulario:
- Descripción: nombre único para identificar la tarifa.
- No aplicar descuento por forma de pago: dejalo sin marcar a menos que sea una tarifa especial (ej: gimnasio contratado).
- Click en Guardar.
Una vez creada, podés agregar períodos desde la vista de detalle.
Ver detalle de tarifa¶
- Click en el botón "ojo" () de la tarifa.
- Se abre la vista de solo lectura con:
- Datos de la tarifa (descripción, bandera de "no descuento").
- Tabla de períodos con todos los que han existido (vigentes, pasados y futuros).
Editar una tarifa¶
- Click en el botón "lápiz" () de la tarifa.
- Modificá Descripción y/o No aplicar descuento por forma de pago.
- Click en Guardar cambios.
Los períodos NO se editan desde aquí; véase la sección "Gestión de períodos" más abajo.
Gestión de períodos¶
Un período define un rango de fechas y un rango de socios con precios concretos.
Crear un período¶
- Desde el detalle de una tarifa, click en el botón + Agregar Período.
- Se abre el formulario con los siguientes campos:
| Campo | Descripción |
|---|---|
| Tarifa | Solo lectura; pre-completada con la tarifa actual. |
| Desde | Fecha de inicio del período. |
| Hasta | Fecha de fin del período (opcional; si está vacía, el período es vigente indefinidamente). |
| Socios Desde | Cantidad mínima de socios del grupo familiar (ej: 1). |
| Socios Hasta | Cantidad máxima de socios del grupo familiar (ej: 99). |
| Importe | Precio del 1er vencimiento. |
| % de recargo | Campo auxiliar: ingresá un porcentaje y se calcula automáticamente el Importe 2do Vto. (ej: ingresá 5 para un 5% de recargo). |
| Importe 2do Vto. | Precio del 2do vencimiento. Puede ser igual o mayor al Importe. |
- Completá los datos y click en Guardar.
Ver un período¶
- Desde el listado de tarifas, cada período aparece como un badge en la columna "Tarifa 1er. Vto." (o 2do si aplica).
- Click en el badge para ver los detalles del período.
Editar un período¶
- Desde la vista de detalle del período, click en Editar.
- Modificá los campos.
- Click en Guardar cambios.
Eliminar un período¶
- Desde la vista de detalle del período, click en Eliminar.
- Confirmá la acción.
Archivar vs. Eliminar¶
Archivar (botón ): - Desactiva la tarifa (deja de aparecer en el listado de activas). - Cierra automáticamente todos los períodos abiertos (sin "Hasta") con la fecha de hoy. - Conserva el historial de períodos. - Solo funciona si NO hay categorías activas asociadas. Si intenta archivar una tarifa con categorías activas, verá un mensaje de error y el botón estará deshabilitado (tooltip explicativo).
Eliminar (botón :material-trash:): - Borra la tarifa y todos sus períodos de la base de datos. - No se puede recuperar. - Use solo si la tarifa fue creada por error.
Relación con Categorías y Cuotas¶
Una categoría (ej: "Rugby Infantil") tiene asignada una tarifa. Cuando se genera una cuota para un socio inscrito en esa categoría, el sistema:
- Toma la tarifa de la categoría.
- Busca el período vigente EN el día del vencimiento (si es Histórico) o HOY (si es Vigente).
- Busca el período que encaje con la cantidad de socios del grupo familiar.
- Asigna el Importe 1er Vto. a la cuota.
- Después del vencimiento + días de gracia, registra una segunda cuota (o recargo) con el Importe 2do Vto.
Si no hay período vigente (todos están en el futuro o todos vencieron), la cuota no se genera o muestra un error en el flujo de cobranza.
Permisos¶
| Acción | Roles |
|---|---|
| Listar tarifas | user |
| Ver detalle | user |
| Crear tarifa | configuración, administrator |
| Editar tarifa | configuración, administrator |
| Archivar tarifa | configuración, administrator |
| Eliminar tarifa | administrator |
Para los períodos, los permisos son los mismos: crear, editar y eliminar requieren roles configuración o administrator (dependiendo del permiso específico).
Ver Roles y permisos para más detalles.