> ## Documentation Index
> Fetch the complete documentation index at: https://muveya.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Reporte de consumo
> Consulta el consumo de cada insumo, en su propia unidad, por día o por semana, y entiende qué cubren y qué no cubren las cifras.
La pantalla **Reportes** muestra **Consumo por insumo**: cuánto de cada insumo salió del inventario como consumo en un período, siempre en la unidad de ese insumo. Es de solo lectura. Nada de lo que hagas en esta pantalla cambia las existencias.
## Quién puede usarla
| Qué | Permiso | Etiqueta en la consola |
| - | - | - |
| Abrir la pantalla y leer las cifras | `reports.read` | **Ver reportes** (grupo **Reportes y auditoría**) |
* Ningún rol otorga `reports.read` automáticamente, ni siquiera el de propietario o el de administrador. Alguien que pueda gestionar el equipo (`members.manage`, **Gestionar acceso del equipo**) debe otorgarlo en **Equipo**. Consulta [Equipo](/docs/es/account/team) y [Roles y permisos](/docs/es/account/roles-and-permissions).
* No necesitas ningún permiso de inventario para leer el reporte.
* Sin `reports.read`, la opción **Reportes** no aparece en la navegación. Si abres `console.muveya.com/reports/consumption` directamente, ves **Necesitas el permiso Ver reportes** y **Un propietario o administrador puede otorgártelo en Equipo.** Si tú puedes gestionar el equipo, un enlace **Abrir Equipo** te lleva allí.
## Dónde está
Navegación principal: **Reportes**. El título de la pantalla es **Consumo por insumo** y su ruta es `/reports/consumption`.
## Qué cuenta como consumo
El reporte lee el registro de movimientos, que es inmutable, y suma cada movimiento `consume` del período. Un movimiento `consume` se crea cuando las existencias salen de una caja como usadas o entregadas, por ejemplo:
* Al registrar un consumo desde una caja en la consola (consulta [Registrar consumo y trasladar cajas](/docs/es/inventory/use-and-moves)).
* Con **Registrar consumo** desde WhatsApp (consulta [Operaciones por WhatsApp](/docs/es/whatsapp/operations)).
Las recepciones, los traslados entre bodegas, los despachos, las correcciones y los conteos no son consumo y nunca aparecen aquí. La pantalla lo recuerda cuando está vacía: **Aquí aparece el consumo registrado desde una caja. Prueba con un período más largo o con todos los insumos.**
## Filtros
| Filtro | Opciones | Valor inicial | Notas |
| - | - | - | - |
| **Período** | **Últimos 7 días**, **Últimos 30 días**, **Últimos 90 días** | **Últimos 30 días** | La ventana termina en la próxima medianoche UTC, así que el día de hoy cuenta completo. Al elegir **Últimos 90 días**, **Agrupar por** cambia a **Semana**; puedes volver a **Día**. |
| **Agrupar por** | **Día**, **Semana** | **Día** | La semana empieza el lunes a las 00:00 UTC. |
| **Insumo** | **Todos los insumos**, o un insumo | **Todos los insumos** | Cada insumo del catálogo aparece como `Nombre · SKU`, en orden alfabético, incluidos los retirados, porque el historial todavía puede mencionarlos. |
Debajo de los filtros la pantalla indica dos reglas:
* **Los días y las semanas siguen la hora UTC.** Un consumo registrado tarde en la noche, en tu hora local, puede caer en el día UTC siguiente.
* **El uso observado es lo que se registró donde se usó. Lo entregado a salas que no cuentan su stock es un consumo estimado. Ambos suman lo consumido.**
Cuando cambias un filtro, las cifras anteriores se mantienen en pantalla con **Actualizando cifras…** hasta que llegan las nuevas.
La consola ofrece solo estos tres períodos. Para otra ventana (hasta 366 días) usa la operación de la API pública `GET /v1/analytics/consumption-trend` o la herramienta MCP `analytics.consumption`. Ambas devuelven exactamente las mismas cifras que esta pantalla para la misma ventana. Consulta [Analítica de gestión](/docs/es/reports/management-analytics).
## Cómo leer la tabla
La tabla **Insumos consumidos** tiene una fila por insumo **y unidad**. Las filas se ordenan por cantidad de registros, de mayor a menor.
| Columna | Qué muestra |
| - | - |
| **Insumo** | El nombre y el SKU del insumo (`Guantes de nitrilo M · GLV-NIT-M`). Si el catálogo ya no puede nombrar el insumo, **Insumo que ya no está en el catálogo**. |
| **Unidad** | La unidad de medida del insumo, con la palabra del catálogo (por ejemplo **Caja**, **Mililitro**, **Par**). |
| **Consumido** | Cantidad total consumida en el período, en esa unidad. |
| **Uso observado** | La parte registrada como usada donde se usó (**Uso directo**), más las salidas registradas sin box o área. |
| **Entregado a salas (estimado)** | La parte entregada a un box o área que no cuenta sus existencias (**Entrega al box o área**, en un destino con **Sin conteo**). Salió del inventario, pero nadie observó su uso, así que es una estimación del consumo. |
| **Registros** | Cuántos movimientos del registro suma la fila. |
| **Detalle** | **Por día** o **Por semana** abre el desglose de ese insumo. |
**Uso observado** más **Entregado a salas (estimado)** siempre es igual a **Consumido**. Para saber cómo se configura un box o área con **Stock contado** o **Sin conteo**, consulta [Boxes y áreas](/docs/es/locations/destinations).
### Por qué no hay fila de total
Cada fila es un insumo en su propia unidad. 100 guantes y 500 mL de jabón son dos filas y nunca "600 unidades". El reporte nunca suma insumos distintos ni unidades distintas, y la pantalla nunca calcula cifras propias. Si un mismo insumo tiene movimientos registrados en dos unidades distintas, aparece en dos filas, una por unidad.
### El desglose
**Por día** (o **Por semana**) lista solo los días o semanas que tienen registros, del más antiguo al más reciente. Cada línea muestra:
* la fecha, o **Semana del** seguido de la fecha del lunes;
* la cantidad, la unidad y los registros, por ejemplo `120 Caja en 30 registros`;
* la división, por ejemplo `100 de uso observado · 20 entregados a salas (estimado)`.
En un teléfono, cada insumo se muestra como una tarjeta con etiquetas en lugar de una fila ancha.
## La frase de resumen
Encima de la tabla, un **Resumen** puede describir el reporte en una frase, por ejemplo:
```text theme={null}
Del 19 ago al 17 sept, 42 registros: Guantes de nitrilo M · 120 Caja en 30 registros; Clorhexidina 0,12 % · 1500 Mililitro en 12 registros.
```
* Nombra hasta cinco insumos y luego indica cuántos más hay (`y 3 insumos más`). La tabla siempre los lista todos.
* Repite cada advertencia que aplique (cifras parciales, registros sin unidad verificada, bodegas restringidas).
* Aparece solo cuando el servidor verificó cada cifra de la frase contra la tabla. La pantalla indica entonces **Cada cifra de esta frase se verificó con la tabla de abajo.** Si la verificación no pasa, no hay frase y la tabla se muestra sola. La frase se genera con reglas fijas a partir de las cifras; ninguna IA la escribe.
## Cobertura y advertencias
Antes de la tabla, la pantalla te dice qué no cubren las cifras. Lee estos avisos antes de tratar una cifra como total de la clínica.
| Aviso | Cuándo aparece | Qué hacer |
| - | - | - |
| **Cifras parciales: se leyó desde el `fecha`. Acota el período o elige un insumo para verlo completo.** | El período tiene más de 5000 registros de consumo. El reporte lee hasta los 5000 más recientes e indica el instante desde el cual las cifras están completas (`coveredFrom`). Los registros anteriores del período no se incluyen. | Elige un período más corto o un solo insumo. |
| **`N` registros anteriores a la unidad verificada se cuentan, pero no se cuantifican: `insumos`.** | Algunos registros se hicieron antes de que se verificara la unidad de medida del insumo. Se cuentan, pero su cantidad no se suma a ninguna fila, porque no se puede probar en qué unidad se registraron. El aviso nombra hasta cinco insumos y cuenta el resto. | No hay nada que corregir en los registros pasados. Los registros nuevos llevan una unidad verificada. |
| **Solo incluye tus bodegas asignadas, no toda la clínica.** | Tu membresía está limitada a algunas bodegas. Solo ves el consumo que salió de esas bodegas. | Pide a un administrador acceso a más bodegas si necesitas totales de la clínica. |
Si no hay ningún registro en el período, ves **No hay consumo en este período**.
## Qué registra el sistema
Nada. Abrir o filtrar el reporte no crea movimientos, no cambia existencias y no escribe registros de auditoría.
## Descarga
Esta pantalla no tiene botón de descarga. Para obtener cifras en un archivo, solicita la exportación del resumen gerencial mediante la API pública; incluye el consumo de los insumos principales, cada uno en su propia unidad. Consulta [Exportaciones](/docs/es/api-reference/exports) y [Analítica de gestión](/docs/es/reports/management-analytics).
## Qué puede salir mal
| Mensaje | Causa | Qué hacer |
| - | - | - |
| **Necesitas el permiso Ver reportes** | No tienes `reports.read`. | Pide a alguien con **Gestionar acceso del equipo** que te otorgue **Ver reportes** en **Equipo**. |
| **Tu cuenta no tiene permiso para esta acción.** | Te quitaron el permiso mientras la pantalla estaba abierta. | Recarga. Si continúa, vuelve a pedir **Ver reportes**. |
| **Revisa los datos ingresados antes de volver a intentar.** | El servidor rechazó la ventana (por ejemplo, una de más de 366 días). Los períodos de la consola nunca lo provocan. | Recarga la página y elige un período. |
| **La cuenta de clínica dental activa cambió. Recarga la página antes de volver a intentar.** | Cambiaste de cuenta en otra pestaña. | Recarga la página. |
| **No pudimos confirmar la operación. Revisa tu conexión y la lista antes de volver a intentar.** | No tienes conexión. | Revisa tu conexión y luego usa **Reintentar**. |
| **No pudimos completar la solicitud. Intenta nuevamente.** | Un problema temporal del servidor. | Usa **Reintentar**. Si sigue fallando, escribe a [team@muveya.com](mailto:team@muveya.com). |
## Páginas relacionadas
Cada métrica de gestión y dónde leerla: API, MCP y exportaciones.
Cómo se registra el consumo desde una caja en la consola.
Registra consumo desde el teléfono.
Otorga **Ver reportes** a un miembro.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.