Cómo crear / editar / eliminar beneficios

Alta, modificación y baja de beneficios del catálogo de la organización. El formulario tiene 6 secciones desplegables (acordeón) con alrededor de 62 campos que dependen del tipo de organización: qué se pide al solicitar, qué documentación exige, cómo se calcula el monto, qué reglas de acceso rigen y qué textos ve el socio. Este procedimiento describe los campos, su label real, su ayuda literal y las condiciones que los muestran/ocultan.

Pantalla de SociosPlus en el celular: Cómo crear / editar / eliminar beneficios — Así se ve la pantalla en SociosPlus. Los datos son de ejemplo; en tu organización vas a ver los tuyos.

¿Aplica a mi organización?

Este tutorial aplica si:

Tu organización administra un catálogo de beneficios.

Antes de empezar

configuración de la organización 'la funcionalidad correspondiente en tu organización' habilitado en la organización.

Paso a paso

1
Abrir la ventana de creación o edición
Desde el menú Beneficios → Catálogo de beneficios se llega a la pantalla correspondiente. Para crear, botón 'Nuevo beneficio' (ruta la pantalla correspondiente). Para editar, ícono lápiz en la fila (ruta 'beneficio/update?id=<id>'). El form es único; la única diferencia entre crear y editar es que en edición aparece la grilla histórica de precios cargados y el asistente 'Precio único'.

Rutas: la pantalla correspondiente, 'beneficio/update?id=<id>', la pantalla correspondiente.

El form tiene validación Ajax: cada campo se valida contra el servidor al blur.

El acordeón tiene 6 paneles; solo el primero ('Datos básicos') aparece expandido; el resto se abre a demanda.
2
Sección 1 — Datos básicos
Identifica el beneficio y define su visibilidad global. Es la única sección expandida por defecto.

**Tipo** — dropdown 'Seleccionar.'. Hint: 'Categoriza el beneficio para organizar la experiencia de carga y seguimiento'. Solo visible si setting `=1`.

**Tipo de monto** — dropdown. Hint: 'Define cómo se calculará el importe: fijo, porcentaje, etc.'. Solo si `=1`. Si se apaga este setting, la sección 4 (Montos e importes) desaparece del form.

**Frecuencia** — dropdown. Hint: 'Frecuencia de otorgamiento o reintegro, si aplica'. Solo si `=1`.

**Descripción (`descripcion`)** — texto libre, obligatorio, maxlength. Hint: 'Nombre claro y corto. Por ejemplo: Reintegro Óptica'. Es el nombre visible del beneficio en catálogo, app y comprobantes.

**Código (`codigo`)** — texto libre. Hint: 'Código interno opcional para identificar el beneficio'. Solo si `=1`.

**Edad máxima del familiar a cargo** — número + dropdown Años/Meses. Hint del número: 'Si aplica, límite de edad para familiares a cargo'. Hint de la unidad: 'Unidad en que se expresa la edad máxima'. Usar Meses para beneficios como Ajuar (ej: hasta 6 meses de vida). Vacío = sin límite de edad.

**Beneficio activo (`activo`)** — casilla. Hint: 'Si está desactivado, no podrá ser solicitado ni otorgado'. Desactivar es la baja lógica cuando el beneficio ya tiene solicitudes u otorgados.

**Visible en la app** — casilla. Hint: 'Habilita que aparezca en la app del socio'. Solo si `=1`.

**Mostrar en galería** — casilla. Hint: 'Incluye este beneficio en la galería pública, si aplica'.

**Habilitar carga rápida** — casilla. Hint: 'Permite crear períodos por delegación y cargar entregas rápidas desde el submenú de beneficios'. Habilita el flujo.
3
Sección 2 — Solicitud y datos a requerir
Define qué campos ve el socio (o quien carga la solicitud) al pedir el beneficio, y cuáles son obligatorios.

**Solicitar motivo** — casilla. Hint: 'Pide elegir un motivo asociado al beneficio'. Habilita el listado de motivos (ABM en `beneficio-motivo`).

**Solicitar motivo de subsidio** — casilla. Hint: 'Habilita un motivo específico para subsidios'. Solo si `=1`.

**Usar número de solicitud** — casilla. Hint: 'Genera o solicita un número de solicitud'. Solo si `=1`.

**Solicitar destino** — casilla. Hint: 'Pide especificar el destino del beneficio'. Solo si `=1`.

**Solicitar dirección de entrega** — casilla. Hint: 'Pide una dirección para la entrega del beneficio'. Solo si `=1`.

**Solicitar fecha y hora** — casilla. Hint: 'Solicita fecha/hora asociada a la prestación'. Solo si `=1`.

**Solicitar fecha de pago** — casilla. Hint: 'Incluye para registrar la fecha de pago'. Solo si `=1`.

**Solicitar medio de pago** — casilla. Hint: 'Agrega la selección de medio de pago al otorgar'. Siempre visible.

**Usar número de formulario** — casilla. Hint: 'Habilita de número de formulario impreso'. Solo si `=1`. Ver también setting `` que oculta el listado de solicitudes.

**familiar a cargo obligatorio** — casilla. Hint: 'Exige seleccionar familiar a cargo del familiares a cargo'. Cambia la validación del form del socio.

**Usar lista de familiares a cargo** — casilla. Hint: 'Pide seleccionar de una lista propia de familiares a cargo'. Habilita el widget de lista dinámica.

**Teléfono obligatorio** — casilla. Hint: 'Solicita teléfono y lo vuelve obligatorio en la carga'.
4
Sección 3 — Documentación y alcance
Restringe el universo elegible y define qué documentación se sube. Contiene pares casilla → select que se muestran/ocultan con JS.

**Usa empleadors asociadas** + **Rubro** — al marcar aparece el dropdown de rubro. Hint del casilla: 'Si el beneficio depende de empleadors asociadas, habilítelo para elegir el rubro'. Hint del rubro: 'Rubro del empleador asociada aplicable'. Solo si `=1`.

**Usa consultorios externos** — casilla. Hint: 'Habilita de consultorios/empleadors externas'. Solo si `=1`.

**Restringir por género** + **Género** — al marcar aparece el dropdown. Hints: 'Al activar, se podrá elegir el género al que aplica' / 'Género requerido para acceder al beneficio'. Solo si `=1`.

**Tipo de dependencia** — dropdown 'Sin restricción'. Hint: 'Si se selecciona, sólo podrán acceder familiares a cargo con ese tipo de dependencia'. Al elegir 'Hijo' aparece el casilla extra:

**Incluir también hijos a cargo** — casilla condicional. Hint: 'Aplica cuando el tipo de dependencia es "Hijo": el beneficio también podrá otorgarse a familiares a cargo cuyo tipo sea "Hijo a Cargo"'. Se muestra por JS solo cuando ` == `.

**Restringir por localidades** + **Localidades (`localidades`)** — casilla + Select2 multi. Hints: 'Al activar, se podrá seleccionar en qué localidades aplica' / 'El beneficio estará disponible sólo en estas localidades'.

**Solicitar documentación al socio** + **Documentaciones (`documentaciones`)** — casilla + Select2 multi. Hints: 'Define si el socio debe adjuntar documentos para pedir el beneficio' / 'Documentación que deberá adjuntar el socio'. Los tipos disponibles se administran en `documentacion/index`.

**Documentación propia de la organización** + **Documentaciones** — casilla + Select2 multi. Hints: 'La organización adjunta documentos (recibos, cheques, etc.) visibles al socio tras el pago/entrega' / 'Documentos que cargará quien otorga el beneficio (no los sube el socio)'. Este es el conjunto que se sube desde el back al pagar/entregar, y aparece en la ficha del socio.
5
Sección 4 — Montos e importes (opcional según setting)
Solo aparece si `=1`. Define cómo se calcula el importe y muestra la grilla histórica de precios cargados. También ofrece el asistente 'Precio único' como atajo (ver paso 10).

**Usa monto** — casilla. Hint: 'Habilita el ingreso de un monto al otorgar'.

**Monto precargado** — casilla. Hint: 'Se propone un monto por defecto según reglas'.

**Monto según situación afiliatoria** — casilla. Hint: 'Calcula el monto según la situación del socio'. Al activar, los precios se cargan discriminados por situación de membresía (socio, Adherente, Baja, etc.).

**Monto según motivo** — casilla. Hint: 'El monto depende del motivo seleccionado'. Habilita.

**Monto según empleador asociada** — casilla. Hint: 'El monto depende del empleador asociada elegida'. Habilita.

**Porcentaje organización** — número. Hint: 'Porcentaje que cubre la organización, si aplica'. Solo si `=1`.

**Porcentaje obra social** — número. Hint: 'Porcentaje que cubre la obra social, si aplica'. Solo si `=1`.

**Mostrar el ahorro al socio** — casilla. Hint: 'Activá esto incluso si el beneficio es gratuito o sin diferencia, para registrar cuánto valdría afuera. Es lo que el socio ve en "Mi ahorro"'. Este flag es lo que alimenta el contador `` (ver proc del mismo nombre).

**Monto según nivel de afiliación** — casilla. Solo si `=1` en la org. Hint: 'Simple = socio. Doble = Simple + tiene la obra social por defecto de la organización. Triple = Doble + socio a la organización. Si tu organización usa otro criterio, contactá con soporte antes de activar'. Al activar, los montos se cargan por nivel Simple/Doble/Triple en vez de por situación de membresía.

**Alerta condicional (obra social default vacía)**: si `` no está configurada, aparece un `alert-warning`: 'Sin eso, los niveles Doble y Triple no se pueden calcular y todos los socios quedarían en Simple'. Con permiso `administrarSP` o `canManageOrganizationUsers`, se muestra un link 'Configurarla ahora' a `configuración de la organización/update`.

**Alerta condicional (organización no habilitada)**: si `=0`, aparece un `alert-danger`: 'Sin eso, el nivel Triple no se puede usar y esos socios quedarán en Doble. Contactá a soporte para habilitarla si vas a usar el nivel Triple'.

**Grilla histórica de precios** (solo en edición): tabla ordenada por ` ` con columnas Vigente desde, Aplica a (situación de membresía / nivel), Valor, Costo afuera, Costo socio, editar (lápiz), eliminar (papelera). El más reciente lleva badge verde 'Vigente'. Botón 'Agregar precio' → `beneficio-monto/create`. Botón 'Ver listado completo de precios' → `beneficio-monto/index` filtrado.

**Comportamiento al eliminar un precio**: si es el vigente, el siguiente más reciente pasa a ser vigente (confirm dialog explícito).
6
Sección 5 — Reglas y limitaciones
Define quién puede acceder, cuántas veces por período, si requiere autorización previa, si permite cuotas, si excluye deudores, etc.

**Requiere autorización** — casilla. Hint: 'Exige una autorización previa a otorgar'. Solo si `=1`. Al activar, el flujo pasa por 'Autorizar / rechazar solicitud'.

**Entrega automática** — casilla. Hint: 'Marca como entregado automáticamente al otorgar'. Salta el paso de 'Entregar' del proc ``.

**Permite cuotas** — casilla. Hint: 'Habilita fraccionar el monto en cuotas'. Solo si `=1` en la org.

**Usa tipo de préstamo** — casilla. Hint: 'Aplica para beneficios con naturaleza de préstamo'.

**Antigüedad mínima en meses** — número. Hint: 'Antigüedad laboral mínima requerida (en meses)'. Solo si `=1`. Se compara contra del socio.

**Cantidad de beneficios en el período** — número. Hint: 'Cantidad máxima de beneficios en el período'. Solo si `=1`.

**Meses de la limitación** — número, placeholder 'Para siempre'. Hint: 'Cantidad de meses que abarca la limitación'. Vacío = sin ventana temporal (limita para siempre).

**Alcance de la limitación** — dropdown 'Por familiares a cargo' / 'Por familiar a cargo' / '---'. Hint: 'El alcance de la limitación: por familiares a cargo o familiar a cargo'.

**Cantidad máxima por emisión** — número, placeholder 'De a uno'. Hint: 'Cuántos comprobantes puede emitir el cajero de una sola vez. Vacío o 1 = de a uno. Cada comprobante descuenta un cupo del período'. puede superar ``.

**Restringir deudores de cuotas** + **Cantidad** — casilla + número condicional. Hints: 'Impide otorgar a socios con deudas de cuotas' / 'Cantidad de cuotas adeudadas que se permiten. 0 = debe estar al día hasta el mes actual. No se cuentan períodos futuros'. Solo si `=1`.

**Exclusivo organización** — casilla. Hint: 'Sólo visible y otorgable para socios de organización'. Solo si `=1`.

**Incluir jubilados/pensionados** — casilla. Hint: 'Permite solicitar/otorgar a jubilados o pensionados'.

**Sólo para padres/madres** — casilla. Hint: 'Restringe el beneficio a padres o madres'.

**Usa fecha de vencimiento** — casilla. Hint: 'Agregar una fecha de vencimiento al beneficio'. Se pide fecha al otorgar y aparece en el comprobante.

**Habilitar para personas externas** — casilla. Hint: 'Permite solicitar a personas externas (no socios)'. Activa el flujo del padrón de personas externas.

**Observaciones obligatorias** — casilla. Hint: 'Obliga a ingresar observaciones al otorgar el beneficio'.
7
Sección 6 — Textos visibles
Textos que ve el socio en distintos puntos del flujo.

**Detalles (`detalles`)** — textarea 3 filas. Placeholder: 'Agregue información adicional que aparecerá al leer el QR.'. Hint: 'Texto informativo que aparecerá en el folleto digital'. Se muestra cuando el socio escanea el QR del beneficio (folleto digital).

**Leyenda app** — textarea 3 filas. Placeholder: 'Este texto aparecerá al solicitar desde la app.'. Hint: 'Mensaje visible para el socio en la app'. Aparece al pedir el beneficio desde la app del socio.
8
Guardar
Botón 'Guardar' verde grande al final del acordeón. Ejecuta a `beneficio/create` o `beneficio/update`. Al guardar exitoso redirige a la vista/detalle o al listado según flujo.

La validación Ajax valida cada campo por separado; el submit hace validación final.

Al crear con `=1`, después del guardado el sistema muestra la sección 4 con el asistente 'Precio único' en warning para invitar a cargar el precio inicial.
9
Eliminar un beneficio
Desde la grilla `beneficio/index`, ícono papelera. Ejecuta a `beneficio/delete?id=<id>`. Confirmación obligatoria.

Si el beneficio ya tiene solicitudes u otorgados en la historia, la eliminación falla o cae a baja lógica (desactivar `activo`).

El botón aparece en la sin validación de permisos y roles granular; el Recomendación técnica: aplicar
10
Asistente 'Precio único' (atajo fuera del acordeón)
Panel separado al final de la página, solo en edición y si `=1`. Registra en un click el precio vigente cuando el costo es uniforme (no varía por situación de membresía). La fecha de vigencia es hoy.

Aparece con panel amarillo (`panel-warning`) y badge 'Sin precios cargados' si el beneficio nunca tuvo precios; en caso contrario aparece como atajo (`panel-default`) para actualizar el vigente.

**Costo afuera del organización $** — number, min 0, step 0.01, obligatorio.

**Costo para el socio $** — number opcional, placeholder 'igual al de afuera' (si se deja vacío, se guarda igual al monto real).

**Gratis para el socio** — casilla. Al marcar, se autocompleta a 0 y queda deshabilitado.

Botón 'Cargar precio vigente' → a `beneficio/asistente-precio?id=<id>`. Crea un `` con ` = hoy` y quedaría como el vigente.

Advertencias importantes

Cambios en los flags `usa_*` no borran datos históricos. Ej.: si desactivás en un beneficio que ya tenía documentaciones asociadas, la relación queda en la base pero deja de pedirse a nuevos solicitantes.
Desactivar `activo` = baja lógica. Un beneficio dado de baja lógica sigue viéndose en solicitudes/otorgados históricos pero no se puede volver a pedir.
Sección 4 (Montos e importes) desaparece completa si `=0`. Las orgs sin monto (solo entrega) no ven esa sección.
En `beneficio/index` el muestra update/delete sin validar permisos granulares; el Si se necesita restricción estricta por permiso, agregar
`porcentaje_sindicato` + `` NO se validan contra suma 100 %; queda a criterio del cargador. Ideal documentar el % efectivo en 'Detalles' para trazabilidad.
El asistente 'Precio único' crea siempre un sin discriminar situación de membresía ni nivel de afiliación. Si el beneficio usa `=1` o `=1`, el precio del asistente aplicará a 'Todas' las situaciones/niveles y hay que cargar los específicos por 'Agregar precio' aparte.

Tutoriales relacionados

Cómo pedir un beneficio y hacer seguimientoAprendé a solicitar un beneficio desde el portal o la app, adjuntar la documentación necesaria y hacer seguimiento del estado hasta que se … 5 minSocios Cómo gestionar solicitudes de beneficiosGuía para el equipo de la organización: cómo revisar solicitudes pendientes, autorizarlas o rechazarlas, otorgar el beneficio y marcarlo co… 7 minStaff Coseguros: cómo cargar y autorizar cierres diariosEste tutorial cubre el flujo completo de coseguros (copagos de obra social): cómo el cajero carga y envía su cierre diario, y cómo el super… 10 minStaff

¿Necesitás ayuda con algún proceso?

Si no encontrás lo que buscás, escribinos y lo sumamos al centro de ayuda.

Enviar email a soporte

¿Aplica a mi organización?

Antes de empezar

Paso a paso

Abrir la ventana de creación o edición

Sección 1 — Datos básicos

Sección 2 — Solicitud y datos a requerir

Sección 3 — Documentación y alcance

Sección 4 — Montos e importes (opcional según setting)

Sección 5 — Reglas y limitaciones

Sección 6 — Textos visibles

Guardar

Eliminar un beneficio

Asistente 'Precio único' (atajo fuera del acordeón)

Tutoriales relacionados

¿Necesitás ayuda con algún proceso?