> ## 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. # Solução de problemas > Descubra o que deu errado a partir do que você vê na tela, por que acontece e o que fazer, do acesso às entregas, ao WhatsApp, à API e ao MCP. Use esta página quando algo não funcionou. As entradas estão agrupadas por área e têm o nome do que você vê. Cada uma explica por que acontece, o que fazer e qual página trata o assunto por completo. O console mostra as mensagens no idioma que você escolheu. Esta página as cita em português, em negrito, exatamente como o console as escreve. Muitos problemas vêm do acesso. O acesso de uma pessoa tem três partes: permissões, unidades e depósitos. Nenhuma função inclui permissões de estoque, pedidos, aprovações, entregas ou relatórios, nem mesmo **Proprietário**. Quando uma tela aparece vazia ou recusa uma ação, confira primeiro [Funções e permissões](/docs/pt/account/roles-and-permissions). ## Antes de falar com o suporte Reúna estes dados antes de escrever, para que a equipe encontre o problema já na primeira resposta: | O quê | Onde encontrar | | - | - | | O nome da clínica odontológica | O seletor **Clínica odontológica**, no alto da barra lateral, ou **Escolha uma clínica odontológica**. | | O e-mail da sua conta | Na barra lateral, acima de **Sair**. Se puder, escreva a partir desse endereço. | | O endereço da tela | A barra de endereços do navegador, por exemplo `console.muveya.com/fulfillment/…/pick`. | | A data, a hora e o fuso horário | Quando aconteceu, com a maior precisão possível. | | A mensagem exata | Copie o texto mostrado na tela. | | O registro | O número do pedido (por exemplo `#42`), o código da caixa (por exemplo `BX-7K3QM9`), o SKU (por exemplo `GLV-NIT-M`) ou o endereço da página de status da importação. | | Para erros da API e do MCP | O `requestId` do documento de problema, a operação e, somente para `/v1`, o nome ou prefixo da chave de API. | | Para o WhatsApp | O horário da mensagem e a opção que você estava usando. | Nunca envie uma senha, um código de verificação, uma chave de API completa ou uma referência de paciente (`patientRef`, referências de atendimento ou qualquer dado que identifique um paciente). Também não envie capturas de tela que os mostrem. O suporte nunca pede esses dados. ## Acesso à conta **O que você vê:** falta uma entrada como **Pedidos**, **Aprovação de pedidos**, **Entregas**, **Relatórios** ou **Equipe** no menu. **Por que acontece:** o console mostra essas cinco entradas só para quem pode usá-las. | Entrada do menu | Aparece quando você tem | | - | - | | **Pedidos** | `orders.create`, `orders.read.all`, `approvals.decide` ou qualquer permissão de entregas | | **Aprovação de pedidos** | `approvals.decide` ou `approvals.policy.manage` | | **Entregas** | Alguma de `fulfillment.pick`, `fulfillment.dispatch`, `delivery.confirm`, `receipt.confirm`, `fulfillment.close`, `fulfillment.read` | | **Relatórios** | `reports.read` | | **Equipe** | `members.manage` | As outras entradas (**Início**, **Unidades**, **Depósitos**, **Catálogo**, **Inventário**, **Reposição**, **Correções de estoque**) aparecem para todos, mas o conteúdo delas também depende das suas permissões. **O que fazer:** 1. Peça a uma pessoa que administra a equipe para abrir **Equipe**, selecionar seu nome e marcar a permissão de que você precisa. Um **Proprietário** faz isso na própria página. 2. Recarregue a página depois da mudança. 3. No celular, abra o menu pelo botão de menu da barra superior. Se você digitou ou colou um endereço e vê **Esta página não existe**, o endereço está errado. Selecione **Voltar ao início** e use o menu. Veja [Funções e permissões](/docs/pt/account/roles-and-permissions) e [Equipe](/docs/pt/account/team). **O que você vê:** uma destas mensagens. | Mensagem | O que falta | | - | - | | **Sua conta não tem permissão para esta ação.** | Uma permissão dessa tela ou ação. Em **Inventário** (**Estoque**) significa `inventory.read`. | | **Você não tem permissão para receber entregas. Peça a um administrador a permissão “Receber entregas”.** | `inventory.receive` | | **Você não tem permissão para ver o estoque. Peça acesso a um administrador.** | `inventory.read` (em **Recolhimento de lote**) | | **Você não pode criar pedidos. Peça ao administrador da sua clínica a permissão para solicitar insumos.** | `orders.create` | | **Você não decide aprovações de pedidos. Se deveria, peça a permissão ao administrador da sua clínica.** | `approvals.decide` | | **Você não pode alterar a política de aprovação. Peça a permissão ao administrador da sua clínica.** | `approvals.policy.manage` | | **Você não participa das entregas. Pergunte ao administrador da sua clínica se você deveria preparar, entregar ou receber pedidos.** | As seis permissões de entregas | | **Você não pode preparar pedidos. Peça ao administrador da sua clínica a permissão para separar.** | `fulfillment.pick` | | **Você não pode receber pedidos. Peça a permissão ao administrador da sua clínica.** | `receipt.confirm` | | **Para receber caixa por caixa você também precisa de permissão para ver entregas. Peça ao administrador da sua clínica.** | `fulfillment.read` | | **Você precisa da permissão Ver relatórios** | `reports.read` | | **Você não tem acesso à administração da equipe. Consulte o administrador da sua clínica.** | `members.manage` | Outras duas mensagens tratam de unidades e depósitos, não de permissões: * **Você não tem depósitos atribuídos. Peça acesso a um administrador.** Seu **Acesso aos depósitos** está vazio, então nenhum estoque pode aparecer. * **Você não tem unidades atribuídas. Peça acesso a um administrador.** Seu **Acesso às unidades** está vazio, então nenhum pedido pode aparecer. **Por que acontece:** o muveya confere cada solicitação no servidor com suas permissões e suas unidades e depósitos. O que está fora das suas unidades ou depósitos responde como se não existisse, por exemplo **Este registro não está disponível na conta de clínica odontológica ativa.** ou **Este pedido não existe ou você não pode vê-lo.** **O que fazer:** peça a uma pessoa com **Gerenciar acesso da equipe** que conceda a permissão, ou a unidade ou o depósito, em **Equipe**. As mudanças valem a partir da sua próxima ação. Se **Alertas de estoque** ou **Contagens** só mostram a mensagem de carregamento, falta **Ver estoque**. **Ajustar e contar estoque** não inclui **Ver estoque**: quem corrige o estoque precisa das duas. Veja [Funções e permissões](/docs/pt/account/roles-and-permissions). **O que você vê:** * **Esta clínica odontológica não está mais disponível para sua conta. Escolha outra clínica.** ao selecionar uma clínica em **Escolha uma clínica odontológica**. * **Nenhuma clínica odontológica disponível** com **Sua conta não tem acesso ativo a uma clínica odontológica. Peça a um administrador para revisar seu convite ou vínculo.** * **Não foi possível carregar suas clínicas odontológicas** com o botão **Tentar de novo**. **Por que acontece:** seu vínculo com essa clínica terminou (você foi suspenso ou removido) depois que a lista foi carregada, ou você não tem nenhum vínculo ativo. Também pode ser que você ainda não tenha aceitado o convite. Vínculos suspensos e removidos não aparecem na lista. **O que fazer:** 1. Escolha outra clínica, ou selecione **Tentar de novo** se a lista não carregou. 2. Se você deveria fazer parte da clínica, fale com uma pessoa que administra a equipe dela. Uma pessoa suspensa pode ser reativada com **Reativar acesso**; uma pessoa removida precisa de um novo convite. 3. Depois de uma reativação, entre novamente. Se outra aba mudou a clínica, você vê **A conta de clínica odontológica ativa mudou em outra aba. O que você estava registrando aqui não foi enviado: confira nesta conta antes de continuar.** ou **A conta de clínica odontológica ativa mudou. Recarregue a página antes de tentar novamente.** Recarregue a página e confira qual clínica está ativa antes de repetir a ação. Veja [Entrar](/docs/pt/account/sign-in). | O que você vê | Por que acontece | O que fazer | | - | - | - | | **Confira seu e-mail, senha e código de verificação, se usar um. Depois tente novamente.** | E-mail ou senha errados, código do autenticador ausente ou errado, e-mail não verificado ou senha nunca configurada. A mensagem é a mesma de propósito. | Confira cada dado. Se sua conta tem autenticador, abra **Tenho um código de verificação** e digite os seis dígitos. Se você nunca concluiu a configuração, use **Precisa verificar seu e-mail?** | | **Houve muitas tentativas. Aguarde alguns minutos antes de tentar novamente.** | Tentativas com falha demais para esse e-mail a partir da sua rede. | Aguarde 15 minutos e tente de novo com cuidado. | | **Este link não está mais disponível** | Um link de verificação ou do Google já foi usado, expirou ou foi removido ao recarregar a página. | Peça um link novo ou comece de novo o acesso com o Google. | | Você cai na tela de acesso enquanto trabalha | Sua sessão terminou: 30 minutos sem atividade, 30 dias depois do acesso, ou seu acesso mudou (suspensão, remoção ou mudança de função). | Entre novamente e escolha a clínica. Você volta à página em que estava; o que não tinha sido salvo não foi enviado. | Ainda não existe uma tela para recuperar a senha. Escreva para [team@muveya.com](mailto:team@muveya.com) a partir do e-mail da sua conta. Se você criou a conta com o Google, continue usando **Continuar com o Google**: essa conta não tem senha do muveya. Veja [Entrar](/docs/pt/account/sign-in) e [Segurança da conta](/docs/pt/account/security). **O que você vê** e **o que fazer**: | Mensagem | Por que acontece | O que fazer | | - | - | - | | **Este convite não está disponível** | O link não existe, expirou (vale 24 horas), foi revogado, já foi usado ou foi substituído por um e-mail mais novo. | Use o e-mail de convite mais recente ou peça um novo convite. | | **Abra novamente o link do seu convite** | Por segurança, um convite aberto dura só 10 minutos depois de cada etapa. | Abra de novo o link do e-mail. Ele continua funcionando enquanto o convite for válido. | | **Não conseguimos verificar seu e-mail** | O link de confirmação foi aberto em outro navegador, depois de 10 minutos ou duas vezes. | Abra novamente o link do convite em um só navegador e repita as etapas nele. | | **Este convite é para outra conta. Use a conta que recebeu o convite.** | Você entrou, ou escolheu uma conta do Google, com outro e-mail. | Use **Usar outra conta** e entre com o e-mail convidado. | | **Você já tem uma conta com este e-mail. Entre para continuar com o convite.** | Você escolheu **Criar minha conta**, mas o e-mail já tem uma conta. | Entre e continue com essa conta. | | **Você já faz parte desta clínica odontológica. Entre para acessar.** | Seu vínculo já existe, ativo ou suspenso. | Entre e escolha a clínica, ou peça para ser reativado. | | **O administrador da clínica precisa revisar este convite. Peça que ele o envie novamente.** | Quem enviou não tem mais o acesso que o convite oferece. | Peça a quem administra a equipe para revogá-lo e criar um novo. Reenviar não resolve. | | **Ainda estamos preparando seu acesso. Tente novamente em instantes.** | Sua conta ainda está sendo preparada. | Aguarde alguns segundos e repita. | | **Este convite mudou enquanto você o revisava. Abra novamente o link do seu convite.** | Ele foi reenviado ou revogado nesse meio-tempo. | Abra o e-mail de convite mais recente. | Abrir o link nunca aceita nada sozinho: você só entra na clínica quando seleciona **Aceitar convite**. Veja a parte sobre convites em [Entrar](/docs/pt/account/sign-in). **Para a pessoa convidada:** confira a pasta de spam. O assunto do e-mail é **Você foi convidado para uma clínica na muveya**. Só o e-mail mais recente funciona. **Para quem convida:** **Convite criado para** só significa que o muveya está enviando o e-mail; nunca confirma a entrega. Em **Equipe**, na seção **Convites pendentes**: * **Reenviar convite** envia um link novo de 24 horas e cancela o anterior. Você pode reenviar uma vez por minuto; até lá a linha mostra **Você poderá reenviá-lo a partir de** e um horário. * Um convite cujo horário em **Expira** já passou continua na lista e continua bloqueando um novo convite para esse e-mail. Reenvie ou revogue o convite. | Mensagem ao convidar | O que fazer | | - | - | | **Este e-mail já tem um convite pendente. Reenvie-o na página da equipe.** | Reenvie ou revogue o convite existente em **Convites pendentes**. | | **Algumas permissões ou locais selecionados não podem ser concedidos. Revise a seleção.** | Desmarque o que você mesmo não tem, ou as unidades e depósitos fora do seu próprio acesso. | | **Somente um owner pode convidar um administrador ou alterar esta função. Escolha a função de membro ou peça a um owner.** | Convide com a função **Membro**, ou peça a um **Proprietário**. | | **Esta pessoa já faz parte desta clínica.** | Abra a página dela em **Equipe**. | Veja [Equipe](/docs/pt/account/team). ## Catálogo **O que você vê:** você tem **Importar CSV** e **Exportar CSV** em **Catálogo**, mas o envio ou a exportação responde **Sua conta não tem permissão para esta ação.** **Por que acontece:** os botões aparecem para qualquer pessoa com `catalog.manage` (**Gerenciar catálogo**), mas o muveya só aceita importação ou exportação CSV de um membro com a função **Proprietário** ou **Administrador**. Um **Membro** com **Gerenciar catálogo** é recusado. **O que fazer:** peça a um proprietário ou administrador para importar ou exportar o arquivo, ou peça a um proprietário para mudar sua função para **Administrador**. Enquanto isso, você ainda pode criar e editar insumos um por um. Veja [Importar e exportar](/docs/pt/catalog/import-export). | O que você vê | O que fazer | | - | - | | **O arquivo não contém as colunas CSV obrigatórias.** | Confira os nomes das colunas (em inglês, com maiúsculas e minúsculas exatas), se o separador é vírgula (planilhas em português ou espanhol costumam salvar com ponto e vírgula) e se nenhuma aspa ficou aberta. | | **O arquivo deve ter no máximo 5 MB.** / **Use no máximo 10.000 linhas de dados por arquivo.** | Divida o arquivo. | | **O processamento foi interrompido. A recuperação automática tentará retomar o trabalho pendente.** | Aguarde. A página continua verificando, e as linhas já criadas não são criadas duas vezes. | | **Este SKU já existe.** | Uma importação nunca atualiza insumos. Remova a linha ou use outro SKU. | | **A categoria não existe nesta clínica.** | Copie o id em **IDs de categorias para seu CSV** na tela de importação. | | **A pessoa que enviou o arquivo não tem mais permissão.** | Quem enviou o arquivo perdeu o acesso durante a importação. Peça a um proprietário ou administrador para enviar as linhas restantes. | Monte o arquivo corrigido só com as linhas rejeitadas. Os insumos importados começam como rascunho: ative cada um antes de poder pedi-lo ou recebê-lo. Não existe uma lista de importações anteriores, então guarde o endereço da página **Status da importação**. Veja [Importar e exportar](/docs/pt/catalog/import-export). **O que você vê:** em um rascunho de pedido, **Adicionar insumo** responde **O registro mudou ou já existe. Confira antes de tentar novamente.** **Por que acontece:** o insumo tem um custo que não está confirmado para a unidade de medida atual (status de custo `review_required` ou `invalid`, código `catalog.cost_unverified`). O muveya se recusa a copiar um custo que pode estar contado em outra unidade de medida. A tela do pedido mostra a mensagem genérica. **O que fazer:** 1. Peça a alguém com **Gerenciar catálogo** e **Ver custos dos materiais** para abrir o insumo em **Catálogo**. 2. Se o custo mostra **Requer confirmação para a unidade atual.**, essa pessoa confere o valor e seleciona **Salvar custo** em **Custo do insumo** para confirmá-lo na unidade de medida atual. 3. Se mostra **Os dados anteriores do custo precisam de revisão.**, escreva para [team@muveya.com](mailto:team@muveya.com) com o SKU. 4. Adicione o insumo ao pedido de novo. Um insumo sem nenhum custo (**Não definido**) pode ser pedido; ele só não soma ao valor do pedido. Outras mensagens do mesmo formulário: **A unidade deste insumo ainda não foi revisada no catálogo.** (a unidade de medida não está fixada) e **Este insumo não está ativo no catálogo.** Veja [Custos](/docs/pt/catalog/costs). ## Inventário **O que você vê:** **Este insumo precisa do lote, dos números de série ou da data de validade para ser recebido. Confira-os e receba de novo.** Nada foi recebido. **Por que acontece:** o insumo controla lote, números de série ou validade, e algum deles está faltando ou é inválido: * **Número do lote** está vazio ou só com espaços. * **Data de validade** está faltando ou é anterior a hoje (UTC). Uma data passada é sempre recusada. * **Números de série** não batem com a quantidade: é preciso exatamente um número de série por unidade base recebida (a quantidade multiplicada pelo conteúdo da apresentação), sem vazios nem repetidos. O campo tem uma só linha: separe os números com vírgulas, porque Enter envia o formulário. **O que fazer:** confira a embalagem, corrija os campos e pressione **Receber** de novo. Um produto com a data de validade já vencida não pode ser recebido. Outra mensagem cita números de série, por exemplo **Estes números de série já foram recebidos para este insumo: SN-0042. Um número de série identifica uma única unidade: confira a embalagem ou corrija a caixa original com um ajuste.** Cada número de série identifica uma unidade em todas as caixas do insumo, em qualquer status. Compare os números com a embalagem; se uma caixa anterior foi registrada errado, veja [Correções de estoque](/docs/pt/inventory/corrections). Veja [Receber estoque](/docs/pt/inventory/receive). **Por que acontece:** a tela de escaneamento mostra essa mesma mensagem sempre que a busca falha: * o código não existe na sua clínica odontológica, ou não é exatamente igual (maiúsculas e minúsculas contam; espaços no início e no fim são ignorados); * a caixa está em um depósito fora do seu **Acesso aos depósitos**; * você não tem **Ver estoque**; * a conexão falhou. O muveya nunca revela se um código existe em um depósito que você não pode ver. **O que fazer:** 1. Compare o código com a etiqueta impressa e digite-o à mão. 2. Confira se você está na clínica odontológica certa. 3. Abra **Inventário**: se aparecer **Sua conta não tem permissão para esta ação.** ou **Você não tem depósitos atribuídos. Peça acesso a um administrador.**, peça acesso em **Equipe**. 4. Confira sua conexão e tente de novo. Um escaneamento na tela de preparação que responde **Esse código não está reservado para este pedido. Confira a etiqueta e escaneie de novo.** é outro caso: veja [Preparar e despachar](/docs/pt/deliveries/picking). Veja [Caixas e etiquetas](/docs/pt/inventory/boxes). **O que você vê:** a tela da caixa diz **Esta caixa está fechada e não aceita mais movimentos.** e não oferece formulários. **Por que acontece:** só caixas com status **Ativa** aceitam movimentos. O status aparece abaixo do código da caixa: | Status | Como chegou lá | O que você pode fazer | | - | - | - | | **Esgotada** | O estoque em mãos chegou a zero por um consumo ou uma correção de saída. | Nada nessa caixa. Se aparecerem unidades depois, receba-as como uma caixa nova com **Receber**. | | **Em quarentena** | Alguém a colocou em quarentena, um recolhimento de lote a reteve ou um recebimento contestado a devolveu retida. | Nada pelo console: não há como voltar uma caixa para **Ativa**. | | **Vencida** / **Descartada** | Alguém a tirou de uso. | Nada. O histórico continua disponível. | | **Em trânsito** | Foi despachada para um pedido. | Aguarde o recebimento no destino (veja Entregas, mais abaixo). | **Uma caixa vencida que ainda aparece como Ativa.** Uma caixa não muda de status quando a data de validade passa. A partir do dia seguinte a essa data (UTC), consumir ou transferir a caixa responde **O registro mudou ou já existe. Confira antes de tentar novamente.**, separar responde **Esta caixa está vencida e não pode ser separada.** e os pedidos nunca a reservam. Com **Ajustar e contar estoque**, abra **Tirar a caixa de uso** e escolha **Marcar como vencida** (ou **Descartar**). Para descartar uma caixa que já está em quarentena ou vencida, escreva para [team@muveya.com](mailto:team@muveya.com): o console só oferece essa ação para caixas ativas. Veja [Caixas e etiquetas](/docs/pt/inventory/boxes) e [Visão geral do estoque](/docs/pt/inventory/overview). **O que você vê:** depois de **Registrar correção**, **Enviada para aprovação. Outra pessoa com permissão para corrigir o estoque precisa aprová-la.** O valor **Em mãos** da caixa não mudou. **Por que acontece:** a quantidade passa do limite de aprovação desse insumo nesse depósito. Sem limite configurado, ele é 100; um limite configurado no formulário de mínimo (de 0 a 100) o reduz; um insumo marcado como de alto valor sempre precisa de aprovação. **O que fazer:** 1. Peça a outro membro com **Ajustar e contar estoque** e acesso a esse depósito para abrir **Correções de estoque** e selecionar **Aprovar** ou **Rejeitar**. Você não pode decidir a própria solicitação (**Você não pode aprovar sua própria solicitação.**). 2. Se ela não for mais necessária, selecione **Retirar** na sua solicitação. | Mensagem | O que significa | | - | - | | **Esta caixa já tem uma correção aguardando aprovação.** | Só pode haver uma correção pendente por caixa. Decida ou retire essa primeiro. | | **A caixa mudou; é preciso solicitar a correção ou contar novamente.** | A caixa teve um movimento físico depois da solicitação. Nada foi registrado. Confira **Movimentos** e registre de novo ou conte a caixa. | | **Alguém já decidiu esta solicitação.** | Mude **Mostrar** para **Decididas** para ver o resultado. | | **A caixa não tem essa quantidade.** | Uma saída não pode passar do que a caixa tem em mãos. | O motivo de uma rejeição é guardado, mas não aparece na lista. Veja [Correções de estoque](/docs/pt/inventory/corrections). **O que você vê:** em **Estoque**, o valor **Disponível** de uma caixa está abaixo de zero. **Por que acontece:** **Disponível** é **Em mãos** menos **Reservado**. Uma correção de saída ou um consumo reduziu o que a caixa tem, mas as unidades que a caixa guarda para pedidos aprovados continuam reservadas. O muveya nunca inventa estoque para cobri-las, então o número negativo é o que falta para esses pedidos. **Reposição** conta essa caixa como zero unidades utilizáveis. **O que fazer:** 1. Abra a caixa e leia os **Movimentos** para ver o que a reduziu. 2. Se as unidades realmente estão na prateleira, registre uma correção com **Somar ao registro** (pode precisar de aprovação). 3. Se as unidades realmente faltam, o pedido que depende da caixa não pode ser despachado com ela (o despacho responde **Uma caixa retirada tem mais do que este pedido leva…**, mesmo que a caixa tenha menos). Escreva para [team@muveya.com](mailto:team@muveya.com) com o número do pedido e o código da caixa. Veja [Correções de estoque](/docs/pt/inventory/corrections) e [Visão geral do estoque](/docs/pt/inventory/overview). ## Pedidos e aprovações **O que você vê:** o pedido mostra **Enviado** e **O pedido está passando para o próximo passo. Esta tela se atualiza sozinha em alguns segundos.**, mas nunca avança. Quem administra a política também pode ver **Ainda não há política de aprovação: os pedidos enviados aguardam até que uma seja publicada** em **Início**. **Por que acontece:** sua clínica odontológica nunca publicou uma política de aprovação. Sem ela, o muveya não aprova nada nem pede a ninguém para decidir. Os pedidos enviados só são processados quando o muveya processa os envios da clínica, o que acontece sempre que alguém envia um pedido. **O que fazer:** 1. Alguém com **Gerenciar regras de aprovação** abre **Aprovação de pedidos**, depois **Política de aprovação**, e publica uma política: com regras, ou com **Publicar sem aprovações** em **Sem aprovação**. 2. Os pedidos que já aguardavam avançam na próxima vez que alguém da sua clínica odontológica enviar um pedido. 3. Se um pedido continuar em **Enviado** algum tempo depois, escreva para [team@muveya.com](mailto:team@muveya.com) com o número do pedido. Veja [Política de aprovação](/docs/pt/orders/approval-policy). **O que você vê:** seu pedido não aparece em **Aprovação de pedidos**. Ao abri-lo, você vê **Você solicitou este pedido, então outra pessoa precisa decidi-lo.** e nenhum formulário, e o pedido diz **Você solicitou este pedido, então outra pessoa precisa aprová-lo.** Se mesmo assim uma decisão chegar ao muveya: **Você solicitou este pedido, então não pode decidi-lo.** **Por que acontece:** separação de funções. Quem solicita um pedido nunca pode aprová-lo nem rejeitá-lo, quaisquer que sejam suas permissões. A tentativa fica registrada na auditoria. **O que fazer:** outra pessoa com **Decidir aprovações** e acesso à unidade do pedido precisa decidir. Garanta que cada unidade tenha pelo menos uma pessoa assim além de quem costuma fazer pedidos. Quem aprova também precisa receber **Decidir aprovações** de forma explícita: nenhuma função inclui essa permissão. Veja [Aprovar ou rejeitar pedidos](/docs/pt/orders/approvals). **O que você vê:** * **Alguém decidiu ou alterou este pedido há pouco. A tela já mostra a versão mais recente; revise antes de decidir.** * **Este pedido não aguarda mais uma decisão. A tela já mostra em que passo está.** * **Essa etapa não faz parte do plano de aprovação deste pedido.** **Por que acontece:** o muveya só registra uma decisão contra a versão do pedido que a sua tela carregou. Outra pessoa decidiu antes, quem solicitou cancelou o pedido, ou você já tinha registrado uma decisão diferente nessa etapa. Uma decisão não pode ser alterada depois, nem por quem a tomou. **O que fazer:** leia a tela atualizada. Se o pedido ainda aguarda, escolha a etapa de novo e decida. Se ele já foi aprovado, rejeitado ou cancelado, não é preciso fazer mais nada. A seção **Decisões**, no fim da tela, lista todas as decisões. Veja [Aprovar ou rejeitar pedidos](/docs/pt/orders/approvals). **O que você vê:** o botão **Cancelar pedido** não aparece, ou o cancelamento responde **O pedido não está mais em um passo em que isso possa ser feito.** **Por que acontece:** só quem solicitou pode cancelar o pedido, e só enquanto ele está em **Rascunho**, **Enviado** ou **Aguardando aprovação**. De **Aprovado** em diante o muveya recusa o cancelamento para todos, inclusive proprietários e administradores. **Rejeitado**, **Cancelado** e **Encerrado** são status finais. **O que fazer:** se um pedido aprovado precisa ser interrompido, escreva para [team@muveya.com](mailto:team@muveya.com) com o número do pedido. Se você só precisa corrigir o cabeçalho (unidade, destino, origem ou motivo), cancele o rascunho enquanto ainda pode e crie um pedido novo: o cabeçalho não pode ser editado. Veja [Criar e acompanhar pedidos](/docs/pt/orders/create-and-track). ## Entregas **O que você vê:** o pedido continua **Aprovado** com **O pedido está passando para o próximo passo. Esta tela se atualiza sozinha em alguns segundos.**, não aparece em **A preparar** e a tela de preparação diz **Não há caixas reservadas para este pedido por enquanto.** **Por que acontece:** o muveya reserva o estoque sozinho quando um pedido é aprovado, tudo ou nada. Se alguma linha não puder ser coberta por caixas utilizáveis, ele não reserva nada e deixa o pedido **Aprovado**. Utilizável significa **Ativa**, dentro da validade, contada na mesma unidade de medida da linha do pedido e no depósito de origem quando o pedido indica um em **Retirar estoque de**. A reserva só é tentada de novo quando outro pedido da sua clínica odontológica é aprovado; não há botão para tentar de novo. **O que fazer:** 1. Confira o estoque de cada insumo em **Estoque** e **Reposição**. 2. Receba ou transfira o estoque que falta para um lugar utilizável. 3. O pedido é reservado na próxima vez que outro pedido da clínica odontológica for aprovado. 4. Se ele continuar **Aprovado**, escreva para [team@muveya.com](mailto:team@muveya.com) com o número do pedido. Com **Qualquer depósito central**, a reserva pode usar caixas de qualquer depósito da clínica odontológica: confira **Retirar de** na lista de preparação. Veja [Entregas: visão geral](/docs/pt/deliveries/overview). | O que você vê | Por que acontece | O que fazer | | - | - | - | | O painel **Despacho** não aparece, ou você não consegue abrir a tela de preparação | O despacho é feito na tela de preparação, que exige **Preparar pedidos** além de **Despachar pedidos**. | Peça as duas permissões. | | **O despacho fica disponível quando todas as caixas forem retiradas.** | Alguma caixa da lista ainda não foi retirada. | Escaneie todas as caixas de **Caixas a retirar**. | | **Ainda não há caixas retiradas para despachar.** | Nenhuma caixa foi retirada, o pedido não está **Em preparação**, ou a unidade de origem está fora do seu **Acesso às unidades**. | Retire as caixas primeiro, ou peça acesso à unidade de origem. | | **Uma caixa retirada tem mais do que este pedido leva. As caixas viajam inteiras: escaneie-a de novo para separar a quantidade do pedido em seu próprio recipiente.** | Uma caixa retirada não corresponde mais exatamente ao pedido: o **Em mãos** ou o **Reservado** dela difere da quantidade do pedido (unidades a mais, a reserva de outro pedido, ou um consumo ou correção depois da retirada), ou ela não está mais ativa ou venceu. A mensagem é a mesma mesmo quando a caixa agora tem menos. | Escanear a caixa de novo não a separa: uma caixa já retirada só responde **Essa caixa já está registrada como retirada para este pedido.** Abra a caixa e leia os **Movimentos**. Se uma correção foi registrada por engano e a caixa realmente tem a quantidade do pedido, registre a correção contrária. Caso contrário, escreva para [team@muveya.com](mailto:team@muveya.com) com o número do pedido e o código da caixa. | | **Este registro não está disponível na conta de clínica odontológica ativa.** | Uma caixa está em um depósito fora do seu **Acesso aos depósitos**. | Peça acesso, ou peça ajuda a alguém que tenha. | Nada é despachado até que todas as caixas retiradas passem na verificação. Uma caixa fora do seu **Acesso aos depósitos** só é recusada durante o despacho, então as caixas anteriores podem já estar em trânsito: peça a um colega com acesso a esse depósito que despache de novo. Se uma caixa reservada saiu da lista antes de ser retirada (por exemplo, depois de um recolhimento de lote), o pedido pode ser despachado sem ela: compare antes a lista com as linhas do pedido. Veja [Preparar e despachar](/docs/pt/deliveries/picking). **Por que acontece e o que fazer:** | Situação | O que fazer | | - | - | | O pedido está **Despachado** ou **Entregue** | É normal: a caixa fica **Em trânsito** até o destino confirmar o recebimento. Confirme a entrega e depois receba o pedido. | | O pedido está em **Problema de entrega** | Um problema foi informado na entrega. Não há tela para resolvê-lo, e as caixas continuam **Em trânsito**. O dono da clínica odontológica escreve para [team@muveya.com](mailto:team@muveya.com) com o número do pedido e o que aconteceu. | | O pedido está **Recebido** ou **Recebido em parte** | Uma etapa de estoque depois do recebimento não terminou. O muveya tenta de novo em segundo plano. Confira mais tarde a tabela **Caixas** na página de acompanhamento do pedido. Se uma caixa continuar **Em trânsito**, escreva para [team@muveya.com](mailto:team@muveya.com). | Uma caixa em trânsito não conta em nenhum dos dois depósitos e não aceita movimentos. Veja [Confirmar a entrega, receber e encerrar](/docs/pt/deliveries/delivery-and-receipt). | O que você vê | O que fazer | | - | - | | **Este pedido ainda não foi entregue, então não há nada a receber.** | A origem precisa confirmar a entrega primeiro. | | **Não há nada a receber deste pedido aqui.** | O pedido não está **Entregue**, ou a unidade de destino está fora do seu **Acesso às unidades**. | | **Esta entrega não existe ou você não pode vê-la.** | Aparece ao abrir a página: a unidade do pedido está fora do seu **Acesso às unidades**, ou o endereço está errado. | | **Sua conta não tem permissão para esta ação.** | Falta **Confirmar recebimento**, ou seu **Acesso às unidades** é uma lista de unidades que inclui a unidade de origem de uma transferência entre duas unidades. Peça ajuda a um membro da unidade de destino. | | **Uma caixa contestada precisa de evidência. Descreva o que você viu.** | Preencha **Evidência do problema** ao contestar uma caixa. | | **A decisão deve cobrir exatamente as caixas entregues. Recarregue a página e confira de novo.** | Recarregue e decida de novo cada caixa. | O recebimento é por caixa inteira: não existe quantidade recebida. Veja [Confirmar a entrega, receber e encerrar](/docs/pt/deliveries/delivery-and-receipt). **O que você vê:** o botão **Encerrar pedido** não aparece, ou aparece **Este pedido ainda não pode ser encerrado.** **Por que acontece:** * O botão fica na página de acompanhamento do pedido, que exige **Ver atendimento** além de **Encerrar atendimento**. * Só pedidos **Recebido** ou **Recebido em parte** podem ser encerrados. Um pedido com **Problema de entrega** não pode. * Uma caixa do pedido continua **Em trânsito** (veja a entrada anterior). * A unidade de destino está fora do seu **Acesso às unidades**, ou seu acesso é uma lista de unidades que inclui a unidade de origem de uma transferência entre duas unidades. **O que fazer:** confira o status do pedido e a tabela **Caixas**, peça a permissão ou a unidade que falta e, se uma caixa ainda estiver em trânsito, tente de novo mais tarde. Encerrar duas vezes só mostra **Este pedido já estava encerrado.** Veja [Confirmar a entrega, receber e encerrar](/docs/pt/deliveries/delivery-and-receipt). ## WhatsApp **O que você vê:** toda mensagem recebe o aviso de vinculação. O canal escreve em espanhol: **Para operar muveya desde WhatsApp, primero vincula tu cuenta: responde con el código de un solo uso que generaste en la consola.** (Para operar o muveya pelo WhatsApp, primeiro vincule sua conta: responda com o código de uso único que você gerou no console.) Um código que falha recebe **Ese código no es válido o expiró. Genera uno nuevo en la consola y envíalo por aquí.** (Esse código não é válido ou expirou. Gere um novo no console e envie por aqui.) **Por que acontece:** o número não está vinculado, o vínculo com a clínica foi suspenso ou removido, ou a vinculação é anterior a uma suspensão (as vinculações continuam encerradas depois de uma reativação). Um código vale 10 minutos, funciona uma única vez, e um código mais novo cancela o anterior. **O que fazer:** o console ainda não tem uma tela para criar o código de vinculação, embora o aviso a mencione. Além disso, o canal do WhatsApp ainda não está ativado no serviço de produção. Um código só pode ser criado para você com a sua sessão iniciada na sua própria conta; a equipe do muveya não pode criá-lo por você. Escreva para [team@muveya.com](mailto:team@muveya.com) se quiser usar o canal. Para passar um número vinculado para outra pessoa ou clínica, ou para desvinculá-lo, escreva também para [team@muveya.com](mailto:team@muveya.com). Uma resposta que começa com **No tienes permiso para** (Você não tem permissão para) significa que falta a permissão dessa opção ou que você não tem depósitos atribuídos: peça em **Equipe**. Veja [Canal do WhatsApp](/docs/pt/whatsapp/overview). **Por que acontece:** por enquanto o canal responde em espanhol para todo mundo, qualquer que seja o idioma que você usa no console. Existem versões em português e em inglês de cada mensagem, mas elas ainda não são selecionadas. Os botões também estão em espanhol: **Confirmar**, **Corregir** (Corrigir) e **Cancelar**. **O que fazer:** não há nada errado com sua conta. [Operações pelo WhatsApp](/docs/pt/whatsapp/operations) mostra cada mensagem com o texto em português. ## App Android O app Android mostra as próprias mensagens no idioma em que está configurado. Esta seção as cita em português, exatamente como o app as escreve. **O que você vê:** **Este app de desenvolvimento ainda não está conectado. Peça à sua equipe o app configurado.** Nenhuma opção de login aparece. **Por que acontece:** esta cópia do app não está conectada a um serviço do muveya, então não é possível fazer nada com ela. O app Android ainda não está disponível para todos e não está publicado no Google Play. **O que fazer:** escreva para [team@muveya.com](mailto:team@muveya.com) se quiser usar o app. Enquanto isso, use o console no navegador do celular. Veja [App Android](/docs/pt/android/overview). **O que você vê:** **Não há uma conta Muveya para este e-mail. Peça a um administrador da sua clínica que convide você.** **Por que acontece:** a conta do Google que você escolheu usa um e-mail sem conta do muveya. O app só entra com contas que já existem: ele nunca cria uma conta nem uma clínica odontológica. **O que fazer:** 1. Se você já tem uma conta do muveya com outro e-mail, escolha a conta do Google com esse e-mail, ou entre com e-mail e senha. 2. Caso contrário, peça um convite a uma pessoa que gerencia a equipe da sua clínica e aceite-o no console. 3. Depois entre no app com o e-mail convidado. Para criar uma clínica odontológica nova, crie-a no console. Veja [Entre e crie sua conta](/docs/pt/account/sign-in). **O que você vê:** a tela de login com **Confira seu e-mail, senha e código de autenticação.**, embora você não tenha digitado nada. **Por que acontece:** sua sessão terminou: 30 minutos sem atividade, 30 dias depois do login, ou seu acesso mudou (suspensão, remoção ou mudança de função). O app mostra a mesma mensagem de dados incorretos. **O que fazer:** entre de novo. O que você não tinha enviado não foi registrado. Se a mesma mensagem aparecer quando você digitar seus dados, confira-os e adicione o código de autenticação se a sua conta usar um. Veja [App Android](/docs/pt/android/overview). **O que você vê:** **O leitor não está disponível neste telefone. Digite o código.** **Por que acontece:** o leitor de códigos funciona dentro do Google Play Services. Ele não consegue iniciar quando o celular não tem o Google Play Services, quando ele está desativado ou quando o componente do leitor ainda não terminou de ser baixado no celular. **O que fazer:** digite o código em **Ou digite o código** e toque em **Buscar**, ou receba o insumo com **Receber um insumo sem código**. Em um celular com Google Play Services, confira se ele está ativado e atualizado, deixe o celular conectado por alguns minutos e tente de novo. **O que você vê:** **Código não reconhecido** com **Nenhuma caixa ou insumo ao seu alcance tem o código** seguido do código, ou **A operação não é permitida.** **Por que acontece:** * Nenhuma caixa dos seus depósitos tem exatamente esse código. Uma caixa fora dos seus depósitos é tratada como se não existisse. * O código do fornecedor não está cadastrado em uma apresentação ativa, ou a apresentação dele foi retirada. * Em um GS1 DataMatrix, a apresentação tem o GTIN na forma de 13 dígitos, enquanto o DataMatrix traz 14 dígitos. * Você não pode receber (`inventory.receive`), então o app não procura códigos de fornecedor. * **A operação não é permitida.** significa que falta `inventory.read`, que o app precisa para procurar uma caixa. **O que fazer:** confira o código e o seu acesso aos depósitos. Peça a quem gerencia o catálogo que cadastre o código, incluindo o GTIN de 14 dígitos de um DataMatrix, ou receba o insumo pelo nome. Peça **Ver estoque** se aparecer **A operação não é permitida.** Veja [Operações no app Android](/docs/pt/android/operations). **Por que acontece:** **Registrar uso** só aparece quando você pode consumir, a caixa está **Ativa**, a unidade não precisa de revisão e **Disponível** é maior que zero. **Transferir para outro almoxarifado** só aparece quando você pode transferir caixas e a caixa está **Ativa**. O app mostra os botões conforme as permissões que leu no login ou na última atualização. **O que fazer:** confira o **Status** e o **Disponível** da caixa. Se um administrador acabou de conceder uma permissão, abra o **Menu**, **Trocar organização** e toque em **Atualizar acesso**. Uma caixa cuja unidade precisa de revisão é corrigida no console. **O que você vê:** **Esta unidade ainda não tem salas nem áreas, então este uso não dirá para onde foi.** **Por que acontece:** a unidade da caixa não tem salas ou áreas ativas, ou a caixa está em um depósito **Central**. O app só oferece salas para caixas de um depósito express. **O que fazer:** configure as salas e áreas da unidade (veja [Salas e áreas](/docs/pt/locations/destinations)). Para registrar para onde foi um uso a partir de um depósito central, use o console. **Por que acontece:** as linhas abrem o console no navegador do celular, que tem a própria sessão, separada da do app. **O que fazer:** entre uma vez no console nesse navegador. Se nada abrir, o app mostra **Não foi possível abrir um navegador. Verifique se há um disponível e tente novamente.**: instale ou ative um navegador. ## API e MCP **Por que acontece:** uma única resposta cobre todos os problemas da chave de API: o cabeçalho `Authorization` está ausente, vazio ou não usa `Bearer`; a chave está malformada, digitada errado ou incompleta; a chave não existe ou foi revogada; o membro para quem ela foi criada foi suspenso ou removido (uma reativação não a recupera); ou a clínica odontológica está suspensa. **O que fazer:** 1. Envie exatamente `Authorization: Bearer` seguido da chave, sem aspas nem quebras de linha. 2. Confira se a variável que guarda a chave está definida onde o programa roda. 3. Chame `GET /v1/me`, que não exige nenhum escopo. 4. Pergunte ao membro que pediu a chave se ela foi revogada ou se ele continua ativo. Se precisar, peça uma chave nova para [team@muveya.com](mailto:team@muveya.com): ainda não existe tela no console para as chaves. Veja [Autenticação](/docs/pt/api-reference/authentication). **Por que acontece:** a chave é válida, mas não tem um escopo que a operação exige. A resposta não diz qual. Não é possível adicionar escopos a uma chave existente. **O que fazer:** chame `GET /v1/me`, compare os `scopes` com [Escopos](/docs/pt/api-reference/scopes) e peça uma chave nova com os escopos certos. Valores de pedidos e referências de pacientes nunca são devolvidos a uma chave, quaisquer que sejam seus escopos: isso não é um erro. Um registro de outra clínica odontológica responde `404`, nunca `403`. Veja [Erros](/docs/pt/api-reference/errors). **Por que acontece:** a chave de API esgotou o orçamento de requisições de `/v1` na janela atual. O MCP usa autenticação OAuth separadamente. **O que fazer:** aguarde os segundos de `Retry-After` e tente de novo. Acompanhe `X-RateLimit-Remaining`, use páginas grandes, guarde em cache o que muda pouco e não rode processos sobrepostos com a mesma chave. Se precisar de um orçamento maior, escreva para [team@muveya.com](mailto:team@muveya.com) com o volume esperado. Veja [Limites de uso](/docs/pt/api-reference/rate-limits). **Por que acontece:** * `approvals.list_pending`, `management.pending_decisions` e `fulfillment.get_pick_list` leem o trabalho de uma pessoa (as decisões pendentes dela, a lista de preparação dela). Os escopos OAuth atuais de somente leitura não concedem essas permissões, então elas respondem `common.forbidden`, mesmo aparecendo em `tools/list`. A leitura do recurso `muveya://tenant/approval-policy-summary` também é recusada, com um erro JSON-RPC `-32600` cujo `data.code` é `common.forbidden`. * `clinics.list` exige `inventory:read`, não `clinics:read`. * Qualquer outra ferramenta responde `common.forbidden` quando falta à conexão o escopo delegado ou à pessoa a permissão. **O que fazer:** use o console para aprovações e preparação. Para as outras ferramentas, confira o escopo de cada uma em [Ferramentas MCP](/docs/pt/mcp/tools) e conecte novamente com esse escopo OAuth permitido. As respostas seguem o idioma solicitado. Veja [Conectar um cliente](/docs/pt/mcp/connect). ## Contato Se o seu problema não está aqui, ou os passos não resolveram, escreva para **[team@muveya.com](mailto:team@muveya.com)** com os dados de **Antes de falar com o suporte**, no início desta página. Se puder, escreva a partir do e-mail da sua conta do muveya. ## Páginas relacionadas O que cada permissão libera e como unidades e depósitos a limitam. Contas, clínicas, sessões e convites. As etapas de custódia e quem cuida de cada uma. Todos os códigos de erro da API e do MCP. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.