> ## 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. # Aprovar ou rejeitar pedidos > Encontre os pedidos que aguardam a sua decisão, aprove ou rejeite uma etapa e consulte o histórico de decisões. Quando a [política de aprovação](/docs/pt/orders/approval-policy) indica que um pedido enviado precisa de uma decisão, o pedido recebe um **plano de aprovação** e fica em **Aguardando aprovação** (`pending_approval`) até que as pessoas certas decidam. Esta página cobre as telas de **Aprovação de pedidos**: a caixa de entrada (`console.muveya.com/approvals`) e a tela de decisão (`/approvals/`). ## Quem pode decidir | O que você quer fazer | Permissão necessária (rótulo em **Equipe**) | | - | - | | Ver **Aprovação de pedidos** na navegação principal | `approvals.decide` (**Decidir aprovações**) ou `approvals.policy.manage` (**Gerenciar regras de aprovação**) | | Ver a caixa de entrada, decidir e consultar o histórico de decisões | `approvals.decide` | | Ver o valor dos pedidos na caixa de entrada e na tela de decisão | `orders.value.read` (**Ver valores dos pedidos**) | | Abrir **Política de aprovação** a partir da caixa de entrada | `approvals.policy.manage` | Essas permissões nunca vêm com uma função: um **Proprietário** ou um **Administrador** também precisa recebê-las. Veja [Funções e permissões](/docs/pt/account/roles-and-permissions). Quatro regras definem em quais pedidos você pode agir, e todas são aplicadas pelo servidor: 1. **A permissão de decisão.** Sem `approvals.decide` não há caixa de entrada nem decisão. 2. **Acesso por unidade.** Você só vê e decide pedidos cuja unidade está atribuída a você. Um pedido de outra unidade responde como se não existisse. 3. **Permissões da etapa.** Cada etapa de um plano indica a permissão que seus aprovadores precisam ter. As regras publicadas pelo console sempre exigem `approvals.decide`, então, na prática, qualquer pessoa que decide atende. Você precisa ter as permissões de todos os passos da etapa que decide. 4. **Separação de funções.** Quem solicitou um pedido nunca pode decidi-lo (veja a seção **Separação de funções**). ## Como um pedido chega à caixa de entrada O pedido passa para **Enviado**. Veja [Criar e acompanhar pedidos](/docs/pt/orders/create-and-track). Em poucos segundos, a versão vigente da política é avaliada contra o pedido: o tipo, o valor e os insumos. O resultado é o plano de aprovação: uma lista de etapas, cada uma com a quantidade de pessoas que precisam aprová-la, mais a versão da política usada. Se o plano tem pelo menos uma etapa, o pedido passa para **Aguardando aprovação** e aparece na caixa de entrada de cada pessoa habilitada a decidir. Se o plano não tem etapas, o pedido é aprovado automaticamente (veja a seção **Aprovação automática**). ## A caixa de entrada Abra **Aprovação de pedidos** na navegação principal. A tela se chama **Aprovação de pedidos**: "Pedidos das suas clínicas aguardando a sua decisão. Você nunca vê os seus." | Coluna | O que mostra | | - | - | | **Pedido** | O número do pedido. Abre a tela de decisão. | | **Tipo** | **Geral** ou **Clínico**. | | **Clínica** | A unidade do pedido. | | **Solicitado por** | Quem solicitou, pelo nome. | | **Enviado** | Quando o pedido foi enviado. | | **Aprovações necessárias** | Cada etapa com a quantidade de aprovações necessárias, por exemplo "Financeiro (1), Gerência da clínica (1)". | | **Valor** | Só se você tiver `orders.value.read` e pelo menos um pedido da lista tiver valor. Pedidos sem valor mostram uma marca vazia. | A caixa de entrada mostra só pedidos em **Aguardando aprovação**, do mais antigo para o mais novo, e lê até 200 pedidos pendentes por vez. Ela exclui: * pedidos de unidades não atribuídas a você; * pedidos cujas etapas exigem uma permissão que você não tem; * pedidos que você mesmo solicitou. | O que você vê | Por quê | | - | - | | **Não há pedidos aguardando a sua decisão.** | Não há nada pendente para você. | | **Você não decide aprovações de pedidos. Se deveria, peça a permissão ao administrador da sua clínica.** | Você não tem `approvals.decide` (talvez gerencie a política). | | Um link **Política de aprovação** no cabeçalho | Você tem `approvals.policy.manage`. | Em **Início**, a seção **Trabalho pendente** mostra **Pedidos aguardando a sua aprovação**, com uma contagem, quando a sua caixa de entrada não está vazia. ## Decidir um pedido Selecione o número do pedido na caixa de entrada, ou **Revisar e decidir** no detalhe do pedido. A tela se chama **Decidir o pedido #** com o número, e oferece **Voltar às aprovações**. Os dados mostram **Status**, **Tipo**, **Clínica**, **Entregar em**, **Solicitado por**, **Motivo** (se houver) e **Valor do pedido** (com `orders.value.read`). A tabela **Insumos** mostra cada **Insumo** (nome e SKU) e sua **Quantidade** com a unidade de medida. A referência do paciente nunca aparece aqui. Em **Etapa que você decide**, escolha a etapa. Cada opção mostra o nome da etapa e, entre parênteses, as aprovações necessárias. A primeira etapa do plano vem selecionada. **Comentário (opcional)** aceita até 500 caracteres. Um texto maior mostra **O comentário pode ter até 500 caracteres.** e bloqueia os dois botões. Selecione **Aprovar** ou **Rejeitar**. Enquanto a decisão é registrada, o botão mostra **Registrando…**. Depois a tela confirma "Você aprovou a etapa (etapa). O pedido avança sozinho." ou "Você rejeitou a etapa (etapa). Quem solicitou pode criar um novo pedido." ### O que cada decisão faz | Decisão | Resultado | | - | - | | **Aprovar**, e alguma etapa ainda precisa de aprovações | A sua aprovação é registrada. O pedido continua em **Aguardando aprovação** para as demais pessoas. | | **Aprovar**, e isso completa todas as etapas | O pedido passa para **Aprovado**. Em seguida o sistema reserva o estoque e o fluxo de entrega começa. Veja [Entregas: visão geral](/docs/pt/deliveries/overview). | | **Rejeitar** | O pedido inteiro passa na hora para **Rejeitado**, independentemente das outras etapas. É definitivo: quem solicitou precisa criar um novo pedido se ainda precisar dos insumos. | **O que o sistema registra:** uma decisão com a etapa, o resultado, você como quem decidiu, a hora do servidor, o seu comentário, a versão da política do plano e a versão do pedido sobre a qual você decidiu. O registro de auditoria também recebe uma entrada `approvals.decision`. Decisões nunca são editadas nem apagadas. ### Regras e limites * O comentário é opcional, com até 500 caracteres; espaços no início e no fim são removidos. * A etapa precisa fazer parte do plano do pedido. * Cada pessoa decide uma única vez uma determinada etapa de um pedido. Uma etapa que precisa de duas aprovações precisa de duas pessoas diferentes. * A mesma pessoa pode decidir etapas diferentes do mesmo pedido, se estiver habilitada para cada uma. * Uma decisão não pode ser alterada. Se você aprovou uma etapa, não pode depois rejeitar essa mesma etapa; a tentativa é recusada. * Repetir exatamente a mesma decisão (por exemplo, depois de recarregar a página) não cria uma segunda entrada. * Você só pode decidir enquanto o pedido está em **Aguardando aprovação**. Decidir é uma ação marcada como sensível. Na versão atual, o segundo fator é opcional e não bloqueia decisões. Se algum dia a verificação de identidade for solicitada, a tela mostra **Verifique sua identidade para continuar.** com o botão **Verifique sua identidade**, e o seu comentário é mantido para você tentar de novo. Veja [Segurança da conta](/docs/pt/account/security). ## Separação de funções Quem solicita um pedido nunca pode aprová-lo nem rejeitá-lo, mesmo tendo `approvals.decide`: * A caixa de entrada nunca mostra os seus próprios pedidos. * Se você abrir o seu próprio pedido na tela de decisão, vê **Você solicitou este pedido, então outra pessoa precisa decidi-lo.** e nenhum formulário de decisão. O detalhe do pedido informa: **Você solicitou este pedido, então outra pessoa precisa aprová-lo.** * Se mesmo assim uma decisão sobre o seu próprio pedido chegar ao servidor, ela é recusada com **Você solicitou este pedido, então não pode decidi-lo.** (`approvals.self_approval_forbidden`) e a tentativa fica no registro de auditoria como `approvals.decision.denied`. Garanta que cada unidade tenha pelo menos uma pessoa habilitada a decidir que não seja quem costuma fazer os pedidos; caso contrário, esses pedidos ficarão aguardando. ## Planos com várias etapas e várias pessoas Um plano pode ter várias etapas, e cada etapa pode precisar de mais de uma pessoa: * **Todas as etapas precisam ser aprovadas** para o pedido passar para **Aprovado**. Não há ordem fixa entre as etapas; elas podem ser decididas em qualquer ordem. * **Uma etapa que precisa de N aprovações** precisa de N pessoas diferentes. Até lá, o pedido continua em **Aguardando aprovação** e na caixa de entrada das pessoas habilitadas que ainda não decidiram essa etapa. * **Uma única rejeição basta** para rejeitar o pedido inteiro. Por exemplo, um plano "Financeiro (1), Gerência da clínica (2)" precisa que duas pessoas diferentes aprovem **Gerência da clínica** e que uma aprove **Financeiro**. O pedido é aprovado quando chega a terceira aprovação necessária, seja qual for a etapa que ela completa. O detalhe do pedido mostra as mesmas etapas em **Próximo passo**, para que quem solicitou saiba o que o pedido está aguardando. ## Quando o pedido mudou antes da sua decisão A decisão é tomada sobre a versão do pedido que a sua tela carregou. Se algo mudou nesse meio-tempo, nada é registrado e a tela recarrega o pedido: | Situação | O que você vê | | - | - | | Quem solicitou cancelou o pedido, ou a decisão de outra pessoa já o aprovou ou rejeitou | O formulário de decisão some e a tela mostra **Este pedido não aguarda mais uma decisão.** com **Abrir o pedido**. | | A versão do pedido mudou desde que você o carregou | **Alguém decidiu ou alterou este pedido há pouco. A tela já mostra a versão mais recente; revise antes de decidir.** | | Você já registrou uma decisão diferente nesta etapa | A mesma mensagem. A sua decisão anterior continua valendo. | | A etapa escolhida não está mais no plano | **Essa etapa não faz parte do plano de aprovação deste pedido.** | Revise a tela atualizada antes de decidir de novo. ## Aprovação automática Se a política vigente não exige nenhuma etapa para um pedido (nenhuma regra o alcança, ou a política não tem regras), o sistema aprova o pedido sozinho: ele passa de **Enviado** direto para **Aprovado** e segue para a preparação. * Ninguém decide, então nenhuma decisão é criada e o histórico mostra **Ainda não há decisões.** * O pedido mantém o plano com a versão da política que o aprovou, e o registro de auditoria guarda `approvals.auto_approved` como ação do sistema. * Se a clínica odontológica não tem nenhuma política publicada, nada é aprovado automaticamente: os pedidos enviados aguardam em **Enviado**. Depois que uma for publicada, eles avançam na próxima vez que qualquer pedido for enviado na clínica odontológica. Veja [Política de aprovação](/docs/pt/orders/approval-policy). ## Histórico de decisões No fim da tela de decisão, a seção **Decisões** lista todas as decisões do pedido, da mais antiga para a mais recente. Ela aparece para quem tem `approvals.decide`, nos pedidos das suas unidades, qualquer que seja o status atual do pedido. Cada entrada mostra: * o resultado (**Aprovado** ou **Rejeitado**), a etapa e a pessoa que decidiu (**Você** para as suas próprias decisões); * a data e a hora; * o comentário, se houver. Se ninguém decidiu ainda, a seção mostra **Ainda não há decisões.** O histórico só cresce: as entradas nunca são alteradas nem removidas. ## Notificações Por enquanto, o muveya não envia e-mails, mensagens de WhatsApp nem notificações push sobre aprovações. Quem aprova encontra o trabalho pendente em dois lugares: o cartão **Pedidos aguardando a sua aprovação** em **Início** e a caixa de entrada **Aprovação de pedidos**. Quem solicita acompanha o status do pedido em **Pedidos**. ## O que pode dar errado | Mensagem | Código | Por quê | O que fazer | | - | - | - | - | | **Você solicitou este pedido, então não pode decidi-lo.** | `approvals.self_approval_forbidden` | Separação de funções. | Outra pessoa habilitada precisa decidir. | | **Este pedido não aguarda mais uma decisão. A tela já mostra em que passo está.** | `approvals.order_not_pending` | O pedido foi cancelado ou já foi decidido. | Abra o pedido para ver o status. | | **Essa etapa não faz parte do plano de aprovação deste pedido.** | `approvals.stage_not_in_plan` | A etapa não existe no plano deste pedido. | Escolha uma etapa da lista. | | **Alguém decidiu ou alterou este pedido há pouco. A tela já mostra a versão mais recente; revise antes de decidir.** | `approvals.decision_conflict`, `orders.version_conflict` | Você já decidiu esta etapa de outra forma, ou o pedido mudou. | Confira o pedido atualizado. | | **Este pedido não existe ou você não pode vê-lo.** | `orders.not_found` | Link errado, ou a unidade do pedido não está atribuída a você. | Confira o link e o seu acesso por unidade. | | **Sua conta não tem permissão para esta ação.** | `common.forbidden` | Você não tem `approvals.decide`, ou uma permissão exigida pela etapa. | Peça a permissão a quem gerencia a equipe. | | **Verifique sua identidade para continuar.** | `auth.mfa_required` | A verificação de identidade foi solicitada para esta ação sensível. | Selecione **Verifique sua identidade**, informe o código do autenticador e decida de novo. | | **O comentário pode ter até 500 caracteres.** | | O comentário é longo demais. | Encurte-o. | ## Aprovações fora do console As decisões só podem ser tomadas no console. As ferramentas MCP `approvals.list_pending` e `management.pending_decisions` foram pensadas para ler a mesma caixa de entrada, mas precisam de `approvals.decide`, que os escopos OAuth atuais de somente leitura não concedem, então sempre respondem `common.forbidden`. Veja [Ferramentas MCP](/docs/pt/mcp/tools). A API pública não expõe as decisões de aprovação. ## Páginas relacionadas As regras que montam o plano de aprovação de cada pedido. Status, detalhe do pedido e cancelamento. O que acontece quando um pedido é aprovado. Atribua `approvals.decide` e o acesso por unidade. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.