Cómo gestionar solicitudes de beneficios

Guía para el equipo de la organización: cómo revisar solicitudes pendientes, autorizarlas o rechazarlas, otorgar el beneficio y marcarlo como pagado o entregado.

Pantalla de SociosPlus en el celular: Cómo gestionar solicitudes de 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

Sesión iniciada.
configuración de la organización `la funcionalidad correspondiente en tu organizació`.
El rol 'Beneficios Lectura SPIQyP' tiene una restricción adicional: solo ve estados (3) y PAID_DELIVERED (5).
El existe y está en estado que admite autorización (típicamente (1) o (2)).
Sesión iniciada como staff (no socio).
Existe un socio destino y un beneficio activo.
Permiso `autorizarBeneficio` para que el otorgamiento quede como pagado/entregado directo (sino queda como pendiente y hay que autorizarlo aparte).
Sesión iniciada como staff (no socio — el socio no ve estas acciones).
El existe en estado previo a PAID_DELIVERED (, o ).
Sesión iniciada como staff.
Existe el (`id` en URL).
El staff debería tener permiso implícito de edición (el

Paso a paso

1
Abrir el listado
Menú Beneficios → 'Solicitudes de beneficios' (label puede variar). URL: `beneficio-otorgado/solicitudes`. Sorting default: ` ASC, ` (los pendientes al tope, luego los más recientes).

Si el usuario es socio, el listado se filtra automáticamente por del usuario logueado y solo muestra sus propias solicitudes.

Si el usuario es 'Beneficios Lectura SPIQyP', el filtro por estado se aplica en el back a y PAID_DELIVERED.
2
Columnas de la grilla (todas condicionales por configuración de la organización)
El header muestra columnas según lo que administra la organización:

**Nº beneficio (`contador`)** — número correlativo interno del.

**familiar a cargo** o **socio** — nombre + link a la ficha. El label cambia según sea socio logueado (ve 'familiar a cargo') o staff (ve 'socio' con nº socio).

**Fecha otorgado** — date range filter.

**Fecha entregado empleador** — date range filter. Solo visible si aplica.

**Beneficio** — `beneficio.descripcion`. No visible si el usuario es 'empleador asociada'.

**empleador asociada** — dropdown. No visible si el usuario ya es empleador asociada (filtro implícito).

**Monto** — visible si `=1`.

**Nº formulario** — visible siempre.

**organización (% y $)** — dos columnas. Solo si `configuración de la organizació=1`.

**Obra Social (% y $)** — dos columnas. Solo si `configuración de la organizació=1`.

**Cuota (X/Y)** — número de cuota. Solo si `configuración de la organizació=1`.

**Monto cuota** — decimal. Solo si `configuración de la organizació=1`.

**Autorizante** — usuario que autorizó. No visible para empleador asociada.

**¿Autorizado?** — booleano. Solo si `configuración de la organizació=1` y no es empleador asociada.

**Estado** — dropdown con los estados del.

**¿Descontado?** — booleano. Solo si `configuración de la organizació=1`.
3
Filtros disponibles
El search model `` expone estos filtros:

**Date range**:,.

**Dropdown**:, ``, ``.

**Texto**: `` (busca en apellido, nombre, DNI, nº socio), `empleador_search` (busca en empleador, CUIT).

**Implícitos** (no visibles en el header): filtro por (multi-tenant) y por si el usuario logueado es socio.
4
Alertas y banners que aparecen sobre la grilla
Según el estado del socio o de sus beneficios, se muestran banners al tope del listado:

**Material ortopédico con devolución vencida** — banner rojo. Aparece si el socio tiene un préstamo de material con vencida.

**Material ortopédico prestado (pendiente)** — banner azul. Igual pero la fecha no venció.

**Período de gracia activo** — banner warning. Si el socio tiene un período de gracia y le quedan días.

**Documentación pendiente** — tarjetas de alerta cuando el socio tiene beneficios que le faltan adjuntar documentos.
5
Botones globales (topbar)
Arriba de la grilla:

**Solicitar beneficio** — botón verde. Solo si `el permiso correspondiente`. Ruta: `beneficio-otorgado/solicitar`.
6
Acciones por fila
Según el estado del beneficio y el rol del usuario, se muestran diferentes acciones:

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

**Ver fotos/documentación adjunta** — abre modal.

**Rechazar documentación** — modal `#modalRechazarDoc` para exigir re-subida al socio.

**Autorizar** — solo si estado ∈ {, }. Ver proc ``.

**Rechazar** — idem.

**Marcar pagado / Entregar** — solo si estado ∈ {, }. Ver proc ``.

**Imprimir comprobante** — ícono impresora. PDF con el template configurado. Ver proc ``.

**Descargar ZIP de documentación** — ícono archivo. Ver proc ``.
7
Ir al listado de solicitudes
Menú Beneficios → Solicitudes de beneficios (ruta `beneficio-otorgado/indexSolicitudes`). El listado muestra los en estado no-final, con filtros por, socio, beneficio, fecha.

Alternativa: entrar a la ficha del socio → tab 'Beneficios' → click en el beneficio pendiente.
8
Autorizar la solicitud
Botón 'Autorizar' (o ícono check verde). Dispara a `beneficio-otorgado/autorizar?id=<id>`. NO tiene form: es una mutación directa.

Efectos en la base:

– ` = date('Y-m-d')` (hoy).

– ` = STATUS_AUTHORIZED (3)` si el beneficio tiene ``.

– ` = STATUS_PAID_DELIVERED (5)` si el beneficio NO lleva autorización explícita (edge case: autoriza directo).

Flash success: 'El beneficio ha sido autorizado correctamente.'
9
Notificación al socio (al autorizar)
El sistema crea automáticamente:

`` (app + campana): title 'Beneficio [descripción] autorizado' | msg 'Tu solicitud de beneficio [descripción] ha sido autorizada.'

Si el socio tiene `email` cargado, además envía mail: 'Tu solicitud de beneficio [descripción] ha sido autorizada. Próximamente nos estaremos comunicando con vos para coordinar la entrega o pago del mismo. ¡Muchas gracias! '
10
Rechazar la solicitud
Botón 'Rechazar' (o ícono cruz roja). Dispara a `beneficio-otorgado/rechazar?id=<id>`. Sin form.

Efectos: ` = STATUS_PENDING (1)` (vuelve a pendiente para que el socio o staff corrijan y reenvíen).

Flash success: 'El beneficio ha sido rechazado correctamente.'

Notificación al socio: title 'Beneficio [descripción] rechazado' | msg 'Tu solicitud de beneficio [descripción] ha sido rechazada, por favor comunicate con nosotros para más información.' + mail si tiene email.
11
Ir a la ficha del socio
Menú Padrones → socios → click en el socio. Ruta `socio/view?id=<id>`.
12
Abrir el modal 'Solicitar beneficio'
En la sección 'Beneficios' de la ficha, botón 'Solicitar beneficio' o 'Otorgar beneficio' (el label puede variar por organización). Elegir un beneficio del catálogo (dropdown con los ``).

El modal se abre por Ajax; el URL de fondo es `beneficio-otorgado/create?=<id>&=<id>`.
13
Completar los campos del form
El form es el mismo descripto en el procedimiento `` (pasos 2 al 5). Staff ve los campos, incluyendo los que un socio no ve: `numero_formulario`, `numero_solicitud`, `destino`, `monto` con addon $, y habilitada.

Ver el detalle completo de cada campo en el procedimiento ``.

Los campos condicionales por beneficio aparecen igual que en la solicitud del socio.

Si el beneficio tiene `=1`, el monto se autocompleta desde el precio vigente y queda readonly.
14
Guardar y comportamiento del estado
Botón 'Guardar' (btn-success).

Estado inicial resultante:

– Si staff tiene permiso `autorizarBeneficio` → ` = PAID_DELIVERED (5)`. El beneficio queda pagado/entregado directo.

– Si el beneficio tiene `` → idem PAID_DELIVERED.

– Sino → ` = (1)`. Requiere autorización explícita.

Post-save: renderiza vista `redirect-with-pdf` (abre PDF del comprobante en pestaña nueva y vuelve a la ficha del socio). El PDF es el que se imprime como constancia.

Si el usuario carga con `cantidad_emision > 1`, se generan tantos como esa cantidad (útil para bonos/tickets impresos).
15
Marcar como pagado (con form)
URL: `beneficio-otorgado/pagado?id=<id>`. GET renderiza el form `_entregar_empresa_asociada.php`, valida y guarda.

Campos del form:

– **Nº de formulario** — text, readonly (se muestra el que ya tenía el beneficio, no editable).

– **Fecha entregado** —, label 'Fecha Entregado' o 'Fecha Entregado empleador' si el beneficio usa empleador asociada. Placeholder '-MM-DD'.

– **Monto** — text con addon $ prepend.

Botón 'Guardar' (btn-success). Al validar OK: ` = PAID_DELIVERED (5)` + seteada al valor del form.

**Consumo de contador**: si `$ === null` (aún no consumió cupo del período), se llama `` para descontar del límite ``.

Redirect si staff → renderiza `redirect-with-pdf` (abre PDF del comprobante + vuelve a referrer o a `beneficio-otorgado/solicitudes`).
16
Marcar como entregado (sin form)
URL: `beneficio-otorgado/entregar?id=<id>`. Es una acción directa sin form. Un solo click desde el listado.

Efectos: ` = PAID_DELIVERED (5)`. NO modifica (queda como estaba).

Flash success: 'El beneficio ha sido entregado correctamente.'
17
Notificación al socio (pagado o entregado)
Ambas acciones disparan `` (notif en app + campana) y mail si el socio tiene email cargado.

**Pagado**: title 'Beneficio [descripción] pagado' | msg 'Tu beneficio [descripción] ha sido pagado, por favor comunicate con nosotros para más información.'

**Entregado**: title 'Beneficio [descripción] entregado' | msg 'Tu beneficio [descripción] ha sido entregado, por favor comunicate con nosotros para más información.'

El mail es análogo con la descripción del beneficio y la organización.
18
Cargar la documentación de la organización
Si el beneficio catálogo tiene `=1`, después de marcar pagado/entregado hay que subir los comprobantes que ese config exige (recibos, cheques, transferencias) desde la vista de detalle del beneficio otorgado. Ver proc `` para el detalle.

Estos comprobantes quedan visibles para el socio en su historial de beneficios (app y web).
19
Abrir el form de edición
URL: `beneficio-otorgado/update?id=<id>`. Se accede desde el listado de beneficios de la ficha del socio (ícono lápiz) o desde `beneficio-otorgado/solicitudes`.

Renderiza como Ajax inline (`renderAjax('update')`), NO como modal completo como create.
20
Editar los campos
Se muestra el mismo `_form.php` de create con los valores actuales. Los campos condicionales por `*` se evalúan igual: si el catálogo cambió después de emitir el beneficio, pueden aparecer campos vacíos o desaparecer campos que estaban.

Ver el detalle completo de cada campo en el procedimiento `` (pasos 2 al 5).

El NO se edita desde este form: se conserva el que tenía.

` se sobreescribe con el ID del usuario que hace el update (queda registrado quién fue el último editor).
21
Guardar
Botón 'Guardar' (btn-success). Valida y guarda con `save` (revalida rules ).

Redirect al éxito: `socio/view?id=<>` (vuelve a la ficha del socio).

Registro en historiales:

– ``: desc 'Modificación de beneficio #<id>' (queda en el log del usuario que editó).

– ``: desc 'Se actualizó el beneficio: <descripción>' (queda en el historial del socio).

Advertencias importantes

El listado se comparte entre staff y socios. La diferencia la hace el filtro implícito por en el back cuando el usuario es sociO.
El rol 'Beneficios Lectura SPIQyP' está pensado como perfil de auditoría: solo ve estados finales (, PAID_DELIVERED). No puede ver pendientes ni actuar.
El material ortopédico está hardcodeado en el código para mostrar los banners de devolución. En organizaciones que reciclan ese ID para otro beneficio, aparecen banners fantasma.
El label del menú y del título usan la nomenclatura configurada.
Las acciones `autorizar` y `rechazar` usan `guardar` — NO revalidan las reglas. Modifican solo sin correr validaciones cruzadas.
El La restricción por permiso `autorizarBeneficio` la hace la UI (aparecen los botones o no). Un usuario avanzado que arma la URL a mano podría disparar el sin tener el permiso. Recomendación técnica: agregar check `->el permiso correspondiente` al inicio de las acciones.
Rechazar deja al socio en otra vez, no en un estado 'rechazado' específico. Si querés dejar un estado final 'rechazado' distinto, revisá las constantes (`STATUS_REJECTED` si existe) — actualmente el flujo default rebota a.
Si el usuario no tiene la propiedad `email` cargada, el mail no se envía pero la notificación en la app y campana sí se crea.
Es el endpoint que usa la solicitud del socio. La diferencia entre 'solicitar' y 'otorgar' es transparente en la UI y solo se refleja en (a) modal vs página y (b) estado inicial según permisos. Semánticamente es el mismo save.
Si querés que todos los otorgamientos de un beneficio queden PAID_DELIVERED directo sin necesitar que cada empleado tenga `autorizarBeneficio`, activá `` en el catálogo del beneficio.
El PDF que se abre al guardar es el comprobante para firmar/entregar. Si tiene errores no visibles, el PDF NO se abre y el modal queda con el error.
`actionPagado` consume el contador de límites solo si `$ === null`. Si el beneficio ya lo consumió antes (ej. en la solicitud), no se doble-descuenta.
`actionEntregar` NO consume contador; asume que el contador se consumió al solicitar u otorgar.
Los errores de validación de `actionPagado` se muestran en `errorSummary` del form. Si falla hidden (raro), el mensaje puede ser opaco.
Ambas acciones solo tienen sentido si el beneficio está en estado previo a PAID_DELIVERED. Si ya está pagado/entregado, dispararlas de nuevo re-envía notificaciones y confunde al socio.
El Recomendación técnica: agregar guard `if (in_array($, [, ]))` al inicio.
El Podés editar un beneficio ya pagado/entregado; los cambios se aplican y quedan en el historial pero el socio no recibe notificación de la corrección.
` se setea de validar. Si la validación falla, el `` en memoria queda modificado aunque no se persista (menor).
Si tu organización necesita restringir edición por permiso granular, agregarlo explícitamente al
El monto editable no revierte los cálculos de `ahorro_beneficio` automáticamente. Si cambiás el monto sustancialmente, revisá y para mantener consistencia con 'Mi ahorro'.
Editar un beneficio otorgado NO regenera el PDF del comprobante. Si querés re-imprimir con los datos nuevos, hay que reimprimir explícitamente desde el proc ``.

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 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 listado

Columnas de la grilla (todas condicionales por configuración de la organización)

Filtros disponibles

Alertas y banners que aparecen sobre la grilla

Botones globales (topbar)

Acciones por fila

Ir al listado de solicitudes

Autorizar la solicitud

Notificación al socio (al autorizar)

Rechazar la solicitud

Ir a la ficha del socio

Abrir el modal 'Solicitar beneficio'

Completar los campos del form

Guardar y comportamiento del estado

Marcar como pagado (con form)

Marcar como entregado (sin form)

Notificación al socio (pagado o entregado)

Cargar la documentación de la organización

Abrir el form de edición

Editar los campos

Guardar

Tutoriales relacionados

¿Necesitás ayuda con algún proceso?