Skip to main content
Login OAuth para MCP
  • As conexões MCP agora usam OAuth pelo Muveya Console. Se você não estiver conectado, faça login primeiro, escolha sua clínica odontológica e confira as permissões solicitadas pelo aplicativo antes de autorizar. As chaves de API continuam funcionando em /v1, mas não autenticam mais /mcp. Veja Conectar um cliente.
Portal de documentação

A documentação do muveya está no ar

Recolhimento de lotes, diferenças de contagem e medições do piloto

Inventário e relatórios

  • Recolhimento de lotes. Encontre todas as caixas de um lote em todos os depósitos e coloque-as em quarentena em um único passo confirmado. O console avisa que as caixas do lote que estão em trânsito não ficam retidas. Veja Recolhimento de lote.
  • Números de série únicos. Um número de série só pode ser recebido uma vez por insumo, pelo console ou pelo WhatsApp, e a tela de recebimento indica os números de série que já foram recebidos. Veja Receber estoque.
  • Diferenças de contagem exibidas por insumo e unidade de medida, e por campanha de contagem. Veja Contagens físicas.
  • Uso observado e consumo estimado. O relatório de consumo separa o que foi usado do que foi entregue a salas que não têm contagem própria. GET /v1/analytics/consumption-trend e o resumo gerencial informam os dois números para cada insumo. Veja Relatório de consumo.
  • Novas métricas em GET /v1/analytics/metrics/{metric}: BOX_TRACEABILITY, APPROVAL_DECISION_MEDIAN_HOURS e DISTINCT_CUSTODY_ACTORS. As duas últimas aceitam uma janela from e to. Veja Análises gerenciais.
  • Reposição indica a sala à qual pertence cada ponto de estoque. Veja Reposição e alertas de estoque.

Equipe e documentos legais

  • Membros que gerenciam a equipe mas só alcançam algumas unidades podem conceder acesso a unidades e depósitos, convidar pessoas e reativar ou promover membros apenas dentro do próprio acesso a unidades e depósitos. Veja Equipe.
  • Os termos de serviço, a política de privacidade e o acordo de tratamento de dados estão publicados em muveya.com, e as telas de entrada do console trazem links para os termos e a política de privacidade. Veja Segurança e privacidade.
Receber qualquer insumo pela web, etiquetas de caixas e apresentações

Recebimento e caixas

  • Receba qualquer insumo lendo seu código, buscando pelo nome, como apresentação ou como unidades soltas. Veja Receber estoque.
  • Etiquetas de caixas. Imprima uma etiqueta Code 128 para uma caixa recebida ou separada. Veja Caixas e etiquetas.
  • Toda quantidade de estoque mostra sua unidade de medida, caixas ativas com a validade vencida ficam sinalizadas e depósitos inativos deixam de ser oferecidos para recebimento ou transferência.

Catálogo, configuração e acesso

  • Apresentações e códigos comerciais são gerenciados na página do insumo. Veja Apresentações e códigos.
  • Início mostra a uma clínica odontológica nova o que ainda falta configurar antes de operar. Veja Início rápido.
  • Acesso explícito a unidades e depósitos. Cada membro tem acesso a todas, a algumas ou a nenhuma unidade e depósito, e o console explica o que significa não ter nenhuma unidade. Veja Funções e permissões.

API

Pedidos, aprovações e entregas no console

Pedidos e entregas

  • Pedidos. Peça insumos para uma unidade, preencha e envie o pedido e acompanhe-o até o fim. Veja Criar e acompanhar pedidos.
  • Aprovação de pedidos. Decida as aprovações pendentes e publique a política de aprovação. Veja Aprovar ou rejeitar pedidos e Política de aprovação.
  • Entregas. Separe, despache, entregue, receba e encerre pedidos, e consulte o histórico de custódia. Veja Entregas: visão geral.
  • Início mostra a cada membro o trabalho pendente de acordo com as permissões que ele tem.

Estoque

  • Reposição. Defina um mínimo por insumo e depósito, receba um único alerta quando o estoque ficar abaixo dele (encerrado quando o estoque se recupera) e faça contagens rápidas. Veja Reposição e alertas de estoque.
  • Segunda aprovação para correções grandes. Uma correção grande de estoque ou uma diferença de contagem grande aguarda uma segunda pessoa em Correções de estoque. Veja Correções de estoque.
  • Salas e áreas. Declare salas de atendimento e áreas por unidade, registre o uso ou a entrega para uma sala com o profissional responsável, consulte o uso por sala e atribua saídas anteriores. Veja Salas e áreas e Registrar consumo e transferir caixas.
  • Separe uma quantidade em uma caixa nova que mantém a origem, inclusive durante a separação de um pedido. Veja Caixas e etiquetas.
  • Permissões do dia a dia permitem que um membro receba, use ou transfira estoque sem a permissão para corrigi-lo, e as caixas podem ser transferidas entre depósitos. Veja Funções e permissões.

Relatórios

  • O relatório de consumo em Relatórios mostra o consumo por insumo na sua própria unidade de medida. Veja Relatório de consumo.
Inventário no console e contexto do custo do catálogo

Inventário

  • Telas de inventário para receber estoque, registrar uso, corrigir estoque, tirar uma caixa de uso e fazer contagens. Veja Visão geral do estoque.
  • Recebimento por apresentação: três caixas de 100 unidades são registradas como exatamente 300 unidades. As entregas também podem ser recebidas lendo o código do fornecedor. Veja Apresentações e códigos.
  • Lote, números de série e data de validade são pedidos apenas quando o insumo os controla.

Conta

  • A verificação em duas etapas com um aplicativo autenticador pode ser configurada em Segurança da conta e é opcional. Veja Segurança da conta.
  • As leituras de insumos passam a trazer costStatus e, quando conhecido, costMeasurement junto com o valor registrado. Isso vale para as leituras de catálogo de /v1, para a ferramenta MCP catalog.search e para as exportações CSV autorizadas. As rotas e os escopos não mudam, e uma chave de API continua sem poder gravar custos.
  • Confira o estado antes de usar um valor: review_required e invalid não são custos que você possa aplicar à unidade de medida atual.
  • Sem permissão para ver custos (catalog.cost:read para uma chave de API, catalog.cost.read para um membro), todos os campos de custo e as seis colunas de custo da exportação CSV (cost, currency, costStatus, costUnitOfMeasure, costMeasurementVersion, costQuantityProtocol) ficam ausentes.
  • A importação CSV rejeita linhas cujo custo está marcado como review_required ou invalid, linhas com valores de custo e unidade de medida contraditórios e arquivos que repetem uma coluna de custo ou de unidade de medida.
  • Veja Custos e Escopos.
Convites para a equipe
  • Convide pessoas para sua clínica odontológica por e-mail. Elas aceitam com uma senha ou com o Google.
  • Suspenda, reative ou remova membros em Equipe. Veja Equipe.
Unidades, depósitos, catálogo e equipe no console
  • Unidades e Depósitos: crie e gerencie as unidades da sua clínica odontológica e seus depósitos centrais e express. Veja Unidades e Depósitos.
  • Catálogo: categorias, insumos, custos, e importação e exportação CSV. Veja Insumos do catálogo e Importar e exportar.
  • Equipe: o diretório de membros da sua clínica odontológica. Veja Equipe.
Acesso ao console
  • Entre em console.muveya.com com seu e-mail e senha ou com o Google, e escolha a clínica odontológica em que você trabalha. Veja Entrar.
Servidor MCP por HTTP
  • POST https://api.muveya.com/mcp abre o servidor MCP somente leitura para assistentes de IA, autenticado com uma chave de API. Veja Servidor MCP e Conectar um cliente.
  • Ferramentas somente leitura para unidades, catálogo, estoque, pedidos e análises, além de recursos de referência para códigos de erro, status de pedidos e políticas do catálogo. Veja Ferramentas MCP e Recursos MCP.
Análises gerenciais na API
  • /v1/analytics retorna métricas operacionais, exceções, uma comparação entre unidades, tendências de consumo, as aprovações pendentes, os tempos de ciclo dos pedidos e o resumo gerencial diário ou semanal. Veja Análises gerenciais.
  • POST /v1/analytics/exports gera em segundo plano um CSV do resumo gerencial sem dados sensíveis. Veja Exportações do resumo gerencial.
Recursos da API somente leitura
  • Leia unidades, depósitos, o catálogo, saldos e caixas de estoque, pedidos e atendimentos em /v1. Veja API para desenvolvedores.
  • Paginação com cursor para pedidos, atendimentos e saldos. Veja Paginação.
  • Um orçamento de requisições por chave de API, informado nos cabeçalhos de resposta. Veja Limites de uso.
  • O contrato OpenAPI público de /v1.
Chaves de API
  • Chaves de API no formato mvy_test_, cada uma vinculada a uma clínica odontológica.
  • GET /v1/me identifica uma chave e lista seus escopos. Veja Autenticação.
Operações pelo WhatsApp
  • Membros vinculados podem consultar o estoque, registrar uso e receber estoque pelo WhatsApp, com uma etapa de confirmação antes de qualquer mudança de estoque. Veja Canal do WhatsApp e Operações pelo WhatsApp.