> ## 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. # Relatório de consumo > Veja o que cada insumo consumiu, na sua própria unidade de medida, por dia ou por semana, e entenda o que os números cobrem e o que não cobrem. A tela **Relatórios** mostra **Consumo por insumo**: quanto de cada insumo saiu do estoque como consumo em um período, sempre na unidade de medida desse insumo. É somente leitura. Nada do que você faz nesta tela altera o estoque. ## Quem pode usar | O quê | Permissão | Rótulo no console | | - | - | - | | Abrir a tela e ler os números | `reports.read` | **Ver relatórios** (grupo **Relatórios e auditoria**) | * Nenhuma função concede `reports.read` automaticamente, nem mesmo proprietário ou administrador. Alguém que possa gerenciar a equipe (`members.manage`, **Gerenciar acesso da equipe**) precisa concedê-la em **Equipe**. Veja [Equipe](/docs/pt/account/team) e [Funções e permissões](/docs/pt/account/roles-and-permissions). * Você não precisa de nenhuma permissão de estoque para ler o relatório. * Sem `reports.read`, o item **Relatórios** fica oculto na navegação. Se você abrir `console.muveya.com/reports/consumption` diretamente, verá **Você precisa da permissão Ver relatórios** e **Um proprietário ou administrador pode concedê-la a você em Equipe.** Se você mesmo pode gerenciar a equipe, um link **Abrir Equipe** leva até lá. ## Onde fica Navegação principal: **Relatórios**. O título da tela é **Consumo por insumo** e o caminho é `/reports/consumption`. ## O que conta como consumo O relatório lê o registro de movimentos de estoque, que é imutável, e soma cada movimento `consume` do período. Um movimento `consume` é criado quando o estoque sai de uma caixa como usado ou entregue, por exemplo: * Ao registrar um consumo a partir de uma caixa no console (veja [Registrar consumo e transferir caixas](/docs/pt/inventory/use-and-moves)). * Com **Registrar consumo** pelo WhatsApp (veja [Operações pelo WhatsApp](/docs/pt/whatsapp/operations)). Recebimentos, transferências entre depósitos, despachos, correções e contagens não são consumo e nunca aparecem aqui. A tela lembra isso quando está vazia: **O consumo registrado a partir de uma caixa aparece aqui. Tente um período maior ou todos os insumos.** ## Filtros | Filtro | Opções | Valor inicial | Observações | | - | - | - | - | | **Período** | **Últimos 7 dias**, **Últimos 30 dias**, **Últimos 90 dias** | **Últimos 30 dias** | A janela termina na próxima meia-noite UTC, então o dia de hoje conta inteiro. Ao escolher **Últimos 90 dias**, **Agrupar por** muda para **Semana**; você pode voltar para **Dia**. | | **Agrupar por** | **Dia**, **Semana** | **Dia** | A semana começa na segunda-feira, às 00:00 UTC. | | **Insumo** | **Todos os insumos**, ou um insumo | **Todos os insumos** | Cada insumo do catálogo aparece como `Nome · SKU`, em ordem alfabética, inclusive os retirados, porque o histórico ainda pode citá-los. | Abaixo dos filtros, a tela informa duas regras: * **Dias e semanas seguem o horário UTC.** Um consumo registrado tarde da noite, no seu horário local, pode cair no dia UTC seguinte. * **O uso observado é o que foi registrado onde foi usado. O que foi entregue às salas que não contam seu estoque é um consumo estimado. Os dois somam o consumido.** Quando você muda um filtro, os números anteriores continuam na tela com **Atualizando números…** até os novos chegarem. O console oferece apenas esses três períodos. Para outra janela (até 366 dias), use a operação da API pública `GET /v1/analytics/consumption-trend` ou a ferramenta MCP `analytics.consumption`. As duas retornam exatamente os mesmos números desta tela para a mesma janela. Veja [Análises gerenciais](/docs/pt/reports/management-analytics). ## Como ler a tabela A tabela **Insumos consumidos** tem uma linha por insumo **e unidade de medida**. As linhas são ordenadas pela quantidade de registros, da maior para a menor. | Coluna | O que mostra | | - | - | | **Insumo** | O nome e o SKU do insumo (`Luvas de nitrilo M · GLV-NIT-M`). Se o catálogo não consegue mais nomear o insumo, **Insumo que não está mais no catálogo**. | | **Unidade** | A unidade de medida do insumo, com a palavra do catálogo (por exemplo **Caixa**, **Mililitro**, **Par**). | | **Consumido** | Quantidade total consumida no período, nessa unidade de medida. | | **Uso observado** | A parte registrada como usada onde foi usada (**Uso direto**), mais as saídas registradas sem sala ou área. | | **Entregue às salas (estimado)** | A parte entregue a uma sala ou área que não conta seu estoque (**Entrega à sala ou área**, em um destino **Sem contagem**). Saiu do estoque, mas ninguém observou o uso, então é uma estimativa de consumo. | | **Registros** | Quantos movimentos do registro a linha soma. | | **Detalhe** | **Por dia** ou **Por semana** abre o detalhamento desse insumo. | **Uso observado** mais **Entregue às salas (estimado)** é sempre igual a **Consumido**. Para saber como uma sala ou área é configurada com **Estoque contado** ou **Sem contagem**, veja [Salas e áreas](/docs/pt/locations/destinations). ### Por que não há linha de total Cada linha é um insumo na sua própria unidade de medida. 100 luvas e 500 mL de sabonete são duas linhas e nunca "600 unidades". O relatório nunca soma insumos diferentes nem unidades de medida diferentes, e a tela nunca calcula números próprios. Se um mesmo insumo tem movimentos registrados em duas unidades de medida diferentes, ele aparece em duas linhas, uma por unidade de medida. ### O detalhamento **Por dia** (ou **Por semana**) lista apenas os dias ou semanas que têm registros, do mais antigo ao mais recente. Cada linha mostra: * a data, ou **Semana de** seguido da data da segunda-feira; * a quantidade, a unidade de medida e os registros, por exemplo `120 Caixa em 30 registros`; * a divisão, por exemplo `100 de uso observado · 20 entregues às salas (estimado)`. No celular, cada insumo aparece como um cartão com rótulos em vez de uma linha larga. ## A frase de resumo Acima da tabela, um **Resumo** pode descrever o relatório em uma frase, por exemplo: ```text theme={null} De 19 de ago. a 17 de set., 42 registros: Luvas de nitrilo M · 120 Caixa em 30 registros; Clorexidina 0,12% · 1.500 Mililitro em 12 registros. ``` * Cita até cinco insumos e depois informa quantos faltam (`e mais 3 insumos`). A tabela sempre lista todos. * Repete cada ressalva que se aplica (números parciais, registros sem unidade de medida verificada, depósitos restritos). * Aparece apenas quando o servidor conferiu cada número da frase com a tabela. A tela então informa **Cada número desta frase foi conferido com a tabela abaixo.** Se a conferência não passar, não há frase e a tabela aparece sozinha. A frase é montada com regras fixas a partir dos números; nenhuma IA a escreve. ## Cobertura e ressalvas Antes da tabela, a tela diz o que os números não cobrem. Leia estes avisos antes de tratar um número como total da clínica. | Aviso | Quando aparece | O que fazer | | - | - | - | | **Números parciais: lidos a partir de `data`. Reduza o período ou escolha um insumo para ver tudo.** | O período tem mais de 5.000 registros de consumo. O relatório lê até os 5.000 mais recentes e informa o instante a partir do qual os números estão completos (`coveredFrom`). Os registros anteriores do período não entram. | Escolha um período menor ou um único insumo. | | **`N` registros anteriores à unidade verificada são contados, mas não quantificados: `insumos`.** | Alguns registros foram feitos antes de a unidade de medida do insumo ser verificada. Eles são contados, mas sua quantidade não entra em nenhuma linha, porque não é possível provar em que unidade de medida foram registrados. O aviso cita até cinco insumos e conta o restante. | Não há nada a corrigir nos registros passados. Os novos registros já têm unidade de medida verificada. | | **Inclui apenas os depósitos atribuídos a você, não a clínica inteira.** | Seu acesso está limitado a alguns depósitos. Você vê apenas o consumo que saiu desses depósitos. | Peça a um administrador acesso a mais depósitos se precisar de totais da clínica. | Se não houver nenhum registro no período, você verá **Não há consumo neste período**. ## O que o sistema registra Nada. Abrir ou filtrar o relatório não cria movimentos, não altera o estoque e não grava registros de auditoria. ## Download Esta tela não tem botão de download. Para obter números em um arquivo, solicite a exportação do resumo gerencial pela API pública; ela inclui o consumo dos principais insumos, cada um na sua própria unidade de medida. Veja [Exportações do resumo gerencial](/docs/pt/api-reference/exports) e [Análises gerenciais](/docs/pt/reports/management-analytics). ## O que pode dar errado | Mensagem | Causa | O que fazer | | - | - | - | | **Você precisa da permissão Ver relatórios** | Você não tem `reports.read`. | Peça a alguém com **Gerenciar acesso da equipe** que conceda **Ver relatórios** em **Equipe**. | | **Sua conta não tem permissão para esta ação.** | Sua permissão foi removida enquanto a tela estava aberta. | Recarregue. Se continuar, peça **Ver relatórios** novamente. | | **Confira os dados informados antes de tentar novamente.** | O servidor recusou a janela (por exemplo, uma janela maior que 366 dias). Os períodos do console nunca causam isso. | Recarregue a página e escolha um período. | | **A conta de clínica odontológica ativa mudou. Recarregue a página antes de tentar novamente.** | Você trocou de conta em outra aba. | Recarregue a página. | | **Não foi possível confirmar a operação. Verifique sua conexão e a lista antes de tentar novamente.** | Você está sem conexão. | Verifique a conexão e use **Tentar novamente**. | | **Não foi possível concluir a solicitação. Tente novamente.** | Um problema temporário no servidor. | Use **Tentar novamente**. Se continuar falhando, escreva para [team@muveya.com](mailto:team@muveya.com). | ## Páginas relacionadas Cada métrica gerencial e onde lê-la: API, MCP e exportações. Como o consumo é registrado a partir de uma caixa no console. Registre consumo pelo celular. Conceda **Ver relatórios** a um membro. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.