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
- muveya.com/docs abre em inglês, espanhol e português.
- Os Guias percorrem cada área do console, de entrar até as entregas e os relatórios.
- A Referência da API explica a autenticação, os escopos, a paginação, os limites de uso e os erros, e gera uma página por operação de
/v1a partir do contrato OpenAPI. - A seção MCP documenta o servidor MCP somente leitura.
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-trende 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_HOURSeDISTINCT_CUSTODY_ACTORS. As duas últimas aceitam uma janelafrometo. 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
- Os rótulos do resumo gerencial seguem
Accept-Language(en,es,pt) emGET /v1/analytics/briefinge nas exportações CSV. Veja Exportações do resumo gerencial.
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.
Contexto do custo do catálogo
- As leituras de insumos passam a trazer
costStatuse, quando conhecido,costMeasurementjunto com o valor registrado. Isso vale para as leituras de catálogo de/v1, para a ferramenta MCPcatalog.searche 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_requiredeinvalidnão são custos que você possa aplicar à unidade de medida atual. - Sem permissão para ver custos (
catalog.cost:readpara uma chave de API,catalog.cost.readpara 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_requiredouinvalid, 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/mcpabre 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/analyticsretorna 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/exportsgera 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/meidentifica 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.