Solicitudes cant. final (/admin/final-qty-requests) es la bandeja de aprobadores de cantidad final (el switch de usuario finalQtyApprover, no un FunctionId). Quien edita facturas pide el cambio desde la tabla de ítems; el aprobador revisa, aprueba o rechaza acá. Al aprobar se graba Cant. de este período (billed_qty_this_period) para que Final = facturado + QBF, se escribe el historial y se recalculan impago, bond y retainage.
Diseño de pantalla
| Zona | Qué ves |
|---|---|
| Listado | Buscar, Filtro (Estado, Desde/Hasta), Exportar. Columnas: Fecha, Estado, Proyecto, Factura, Ítem, Cant. final anterior, Cant. final propuesta, Solicitado por, Acciones. Proyecto y Factura son enlaces: Proyecto abre el proyecto (/admin/projects?edit= o ?view=), Factura abre la factura. |
| Por defecto | Las solicitudes canceladas no se muestran hasta que filtres. Orden: Fecha descendente. Tamaño de página 30. |
| Acciones | El menú ⋮ de la fila tiene Ver y Eliminar (nunca un ícono de ojo junto al menú). Ver abre la solicitud. Si está pendiente aparecen Aprobar y Rechazar. Eliminar pregunta ¿Seguro que querés eliminar esta solicitud? El lote usa la misma confirmación. |
El email y las notificaciones in-app abren ?requestId=. El botón Review request del email abre /admin/final-qty-requests/approval/ más el token de la solicitud.
Ítems de factura (solicitud)
En una factura impaga ya guardada, la celda Cantidad final facturada tiene un lápiz (permiso Edit de Facturas). El aprobador ve Cambiar cantidad final facturada / Aplicar cambio (autoaprobado). El resto ve Solicitar cambio de cantidad final facturada / Enviar solicitud. El formulario pide Cant. de este período y una Nota. Si la cantidad arrastrada está sucia, primero hay que guardar la factura. El ícono de más abre el historial cuando esa línea ya tiene un cambio aprobado.