Cómo pedir un beneficio y hacer seguimiento

Aprendé a solicitar un beneficio desde el portal o la app, adjuntar la documentación necesaria y hacer seguimiento del estado hasta que se apruebe y te lo entreguen.

Pantalla de SociosPlus en el celular: Cómo pedir un beneficio y hacer seguimiento — 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

Sesión iniciada.
Existe un socio destino.
Existe un beneficio catálogo activo.
configuración de la organización `la funcionalidad correspondiente en tu organizació`.
El socio cumple las reglas del beneficio (edad, situación de membresía, deudas de cuotas, cantidad en el período, antigüedad, etc.). Sino, `canBeGranted` devuelve false y el guardado se rechaza.
El socio existe en la organización.
El socio existe y tiene al menos un beneficio otorgado.

Paso a paso

1
Abrir el form de solicitud
URL: `beneficio-otorgado/create?=<id>&=<id>[&=<id>&=<id>]`. Desde el back se accede tildando 'Solicitar beneficio' en la ficha del socio y eligiendo el beneficio del catálogo. Desde la app del socio, tocando 'Pedir' en la lista de beneficios visibles.

Si el usuario es socio: renderiza como página completa (`render`).

Si el usuario es staff: renderiza como modal Ajax (`renderAjax`) para no perder contexto de la ficha.

Si el beneficio tiene `leyenda_app` cargada, aparece un alert-warning con ese texto antes del form.
2
Campos que aparecen (o casi)
El formulario tiene un núcleo obligatorio y numerosos campos condicionales que dependen del beneficio.

**** — hidden, precargado por URL.

**familiar a cargo** — dropdown. Solo si `configuración de la organizació funcionalidad correspondiente en tu organizació`. Lista el familiares a cargo del socio. Requerido si el beneficio tiene ``.

**Fecha de solicitud** —. Rango: 60 meses atrás a 7 días adelante. Está si el usuario no es 'empleado CEC' (método `esEmpleadoCec`). Un socio no puede cambiarla: se guarda con hoy.

**Celular válido de contacto (`telefono`)** — text. Requerido si `=1`.
3
Campos condicionales por flag del
Se muestran/ocultan según los flags de la sección 'Solicitud y datos a requerir' y 'Documentación y alcance' del beneficio catálogo:

**empleador asociada** — dropdown. Solo si `=1`. Requerido.

**Motivo** — dropdown. Solo si `=1`. Requerido.

**Localidad** — dropdown. Solo si `=1`. Hint: 'Se listan solamente las localidades habilitadas para este beneficio.'

**Fecha vencimiento** —. Solo si `=1`. Requerido.

**Fecha y hora** —. Solo si `=1`.

**medio de pago** — Select2 placeholder 'Seleccione un medio de pago.'. Solo si `=1`. Requerido.

**Documentaciones adjuntas** — uploader por cada tipo en ``. El socio adjunta los archivos que el catálogo pide.
4
Campos que solo ve staff CEC
Estos campos aparecen únicamente si el usuario logueado retorna `esEmpleadoCec=true`. El socio no los ve.

**Nº de formulario** — text. Solo si `esEmpleadoCec && configuración de la organizació`. Valida unicidad por org.

**Fecha de pago** —. Solo si `esEmpleadoCec && `.

**Nº de solicitud** — text. Solo si `esEmpleadoCec && `.

**Destino (`destino`)** — text. Solo si `esEmpleadoCec && `.

**Monto (`monto`)** — text con addon $. Solo si `esEmpleadoCec && `. El label pasa a 'Monto del préstamo' si el beneficio permite cuotas. Bloqueado (readonly) si `=1`: el sistema calcula el monto desde el precio vigente. Requerido si `=1`.
5
Casos hardcoded (organizaciones específicas)
Hay dos beneficios hardcoded en el form por ID que son legacy y merecen refactor:

**Beneficio (comidas)**: agrega `cantidad_comidas` (text) para pedir la cantidad. Requerido en ese caso.

**Beneficio (material ortopédico)**: agrega los campos `` (dropdown).

Estos son hardcodes por ID y solo aplican a la organización que los tiene. Si tu organización no usa esos IDs, los campos nunca aparecen.
6
Guardar
Botón 'Guardar' verde (btn-success). Ejecuta a `beneficio-otorgado/create`.

El estado inicial que queda depende de dos cosas: permiso `autorizarBeneficio` del que carga + flag `entrega_automatica` del beneficio.

Si el usuario tiene `autorizarBeneficio` O el beneficio tiene `` → ` = STATUS_PAID_DELIVERED (5)` (queda como pagado/entregado directo).

Sino → ` = STATUS_PENDING (1)` (queda a la espera de autorización manual).

Si el beneficio tiene `=1` en la org y el socio eligió cuotas>1, se crean las cuotas asociadas después de guardar (`createCuotas`).

Si el usuario es sociO y el beneficio necesita más pasos (` > 0`) → redirect a `beneficio-otorgado/view` para completar. Si no hay más pasos → redirect a `beneficio-otorgado/solicitudes` (mis solicitudes).

Si el usuario es: renderiza la vista `redirect-with-pdf` (abre el PDF del comprobante en nueva ventana y vuelve al referrer).
7
Notificaciones automáticas
Cuando la solicitud la carga un sociO (no staff), se dispara un mail a los destinatarios configurados en el setting `` (lista de emails separados por coma). El mail avisa 'Nueva solicitud del beneficio X para el socio Y'.

Si la solicitud la carga staff, NO se dispara este mail.

Si el socio no tiene `familiar a cargo` titular auto-creado, el sistema intenta crearlo con `ensureHolderBeneficiary`. Si falla, se loggea en `` pero la solicitud sigue igual.
8
Abrir la ficha del socio
Menú Padrones → socios → click en un socio. URL: `socio/view?id=<id>`. La sección de beneficios se llama según el setting (default 'Beneficios otorgados').

La sección se renderiza como partial `_view_beneficios_otorgados.php` dentro del layout general de la ficha.
9
Barra superior de la sección
Al tope de la sección aparecen:

**Título** — texto de `configuración de la organizació`.

**Botón 'Ver resumen'** — abre modal `#modalResumenBeneficios` con filtros y descarga PDF.

**Alerta de excepción** — si el socio tiene ``, se muestra un banner amarillo: 'El empleado se encuentra exceptuado de todas las restricciones establecidas para recibir beneficios.' con botón 'Eliminar Excepción'. Ver proc ``.

**Botón 'Exceptuar de restricciones'** — solo si `el permiso correspondiente` y ``. Ruta: `socio/exceptuar-beneficios?id=<id>`.

**Banner período de gracia** — warning con días restantes si el socio tiene un período de gracia activo.

**Banner material ortopédico vencido** — rojo si tiene préstamos con vencida.

**Banner material ortopédico prestado** — azul si tiene préstamos activos sin vencer.
10
Grillas por tipo de beneficio (tabs)
La sección se divide en subgrillas por tipo (Reintegros / Otros / organización), configurable según el catálogo `` de la organización. Cada grilla lista los del socio filtrados por.

Columnas típicas por fila: descripción, monto, autorizante.

Grilla secundaria adentro: para cada beneficio 'familiares a cargo', muestra qué familiares a cargo (dependientes) son elegibles y cuáles ya usaron el beneficio en el período actual.
11
Acciones por fila del histórico
Sobre cada beneficio otorgado histórico se pueden disparar (según permisos):

**Ver detalle** → `beneficio-otorgado/view?id=<id>`.

**Editar** → `beneficio-otorgado/update?id=<id>`.

**Autorizar / Rechazar** — si el estado lo permite.

**Imprimir comprobante** — PDF con el template del beneficio.

**Registrar devolución de material ortopédico** — solo.
12
Botones para otorgar nuevos beneficios
Al final de la sección aparecen botones 'Otorgar' agrupados por tipo (uno por cada beneficio activo del catálogo aplicable al socio). Solo aparecen si `el permiso correspondiente` y el socio cumple las reglas del beneficio (edad, situación, deudas).

Al hacer click, redirect a `beneficio-otorgado/create?=<id>&=<benef>`. Ver proc `` y ``.
13
Abrir el modal de resumen
Desde la ficha del socio (`socio/view`) → sección Beneficios otorgados → botón 'Ver resumen'. Abre un modal `#modalResumenBeneficios`.

El botón está siempre visible cuando la sección Beneficios se renderiza (no está gateado por permiso adicional).
14
Filtrar el rango
El modal ofrece filtros para elegir el período a incluir en el resumen (típicamente rango de fechas de otorgamiento). También puede filtrar por tipo de beneficio.
15
Descargar el PDF
Botón 'Imprimir resumen' dentro del modal → GET `beneficio-otorgado/imprimir-resumen-socio?id=<>`. Genera PDF con:

**Header**: descripción, dirección y teléfono de la organización.

**Datos del socio**: nombre, DNI, número de socio, situación de membresía.

**Grilla de beneficios**: filas con fecha, beneficio, familiar a cargo (si aplica), monto,.

**Descarga directa** (`DEST_BROWSER`), nombre de archivo: `resumen-beneficios-<numero_afiliado>.pdf`.
16
Alternativa: imprimir un comprobante individual
Si en vez del resumen general querés imprimir el comprobante de UN beneficio otorgado específico, usar el ícono impresora de la grilla. Ver proc ``.

Advertencias importantes

Anti-duplicado: revalida `canBeGranted` al guardar. Si el socio ya alcanzó la cantidad máxima del período o tiene deuda de cuotas superior a lo tolerado, el guardado se rechaza con mensaje explícito.
deshabilitada para no-staff-CEC. Un socio que pide desde la app tiene siempre = hoy.
Los campos, y `ahorro_beneficio` se guardan como hidden y se pre-calculan desde el precio vigente si `=1` en el beneficio. Estos son los valores que después alimentan el contador 'Mi ahorro' del socio.
Los IDs 105 y 112 del catálogo son hardcodes en el form. Si migrás datos a otra organización, esos IDs pueden colisionar con beneficios distintos y disparar los campos extra sin sentido.
El staff CEC es un rol identificado por `esEmpleadoCec`. En organizaciones que no tienen CEC, este método devuelve false y los campos condicionales por staff-CEC no aparecen.
El material ortopédico está hardcodeado. En orgs que reciclan ese ID, los banners de devolución aparecen sobre otros beneficios sin sentido.
El botón 'Exceptuar de restricciones' requiere el permiso `exceptuarAfiliadoDeBeneficios`. Un socio exceptuado puede pedir cualquier beneficio saltando validaciones de edad, situación, cantidad en el período y deudas.
La lista de tabs por tipo depende del catálogo `` de la organización. Si no hay tipos cargados, todos los beneficios caen en la grilla 'general'.
El label del título usa `configuración de la organizació`; personalizar acorde a la nomenclatura de la organización.
El PDF de resumen incluye los beneficios del rango, sin distinguir estados (pendientes, autorizados, entregados). Si querés solo entregados, filtrar por estado en el modal antes de imprimir.
El endpoint `beneficio-otorgado/imprimir-resumen-socio` no valida permiso granular; confía en la sesión y en la UI. Un usuario que arma la URL a mano puede descargar el resumen de cualquier socio de su organización.
El formato del PDF depende del template configurado; algunas organizaciones tienen templates personalizados que agregan campos extra (obra social, adherentes, etc.).

Tutoriales relacionados

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 Cómo ver el listado del catálogo de beneficiosÍndice de todos los beneficios del catálogo de la organización (`Beneficio` model). Es la puerta de entrada para crear, editar, eliminar o … 8 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 el form de solicitud

Campos que aparecen (o casi)

Campos condicionales por flag del

Campos que solo ve staff CEC

Casos hardcoded (organizaciones específicas)

Guardar

Notificaciones automáticas

Abrir la ficha del socio

Barra superior de la sección

Grillas por tipo de beneficio (tabs)

Acciones por fila del histórico

Botones para otorgar nuevos beneficios

Abrir el modal de resumen

Filtrar el rango

Descargar el PDF

Alternativa: imprimir un comprobante individual

Tutoriales relacionados

¿Necesitás ayuda con algún proceso?