> ## 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. # Política de aprovação > Defina quais pedidos enviados precisam de aprovação e quantas pessoas devem aprová-los, e publique essas regras como uma nova versão. A política de aprovação é o conjunto de regras da sua clínica odontológica para os pedidos. Toda vez que um pedido é enviado, a política vigente o transforma em um **plano de aprovação**: as etapas pelas quais ele precisa passar e quantas pessoas devem aprovar cada uma. Se nenhuma regra se aplicar, o pedido é aprovado automaticamente. Esta página cobre a tela **Política de aprovação** (`console.muveya.com/approvals/policy`). ## Quem pode alterar a política | O que você quer fazer | Permissão necessária (rótulo em **Equipe**) | | - | - | | Abrir **Política de aprovação**, ler e publicar a política | `approvals.policy.manage` (**Gerenciar regras de aprovação**) | | Ver e editar limites de valor | `approvals.policy.manage` **e** `orders.value.read` (**Ver valores dos pedidos**) | 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). **Onde:** abra **Aprovação de pedidos** na navegação principal e selecione **Política de aprovação** no cabeçalho. O link só aparece com `approvals.policy.manage`. Sem essa permissão, a tela mostra **Você não pode alterar a política de aprovação. Peça a permissão ao administrador da sua clínica.** Enquanto a sua clínica odontológica não tiver política, quem tem essa permissão vê um cartão em **Início**: **Ainda não há política de aprovação: os pedidos enviados aguardam até que uma seja publicada**. ## O que a tela mostra A tela se chama **Política de aprovação**: "Quais pedidos enviados precisam da aprovação de alguém antes de serem preparados." Ela tem três partes. 1. **A versão vigente.** Uma linha com o número da versão, a data de publicação e quem a publicou. Se a versão não tem regras, acrescenta **A política vigente aprova todos os pedidos sem uma decisão.** Se nada foi publicado ainda, você vê **Ainda não há política: os pedidos enviados aguardam aqui até que uma seja publicada.** 2. **Sem aprovação.** Um atalho para publicar uma política sem regras: "Cada pedido enviado é aprovado sozinho e vai direto para a preparação." 3. **Regras.** Um editor que já vem com as regras da versão vigente: "Um pedido precisa das aprovações de cada regra que atende. Deixe uma condição vazia para valer para todos os pedidos." O console mostra só a versão vigente. Não há tela para consultar versões anteriores. ## Como uma regra funciona Uma regra é um conjunto de **condições** (a quais pedidos ela se aplica) e um **requisito** (a etapa pela qual esses pedidos precisam passar). ### Condições Todas as condições que você definir em uma regra precisam ser verdadeiras para a regra se aplicar. Uma condição deixada vazia vale para todos os pedidos. | Campo | Vale quando | Se ficar vazio | | - | - | - | | **Vale para**: **Pedidos gerais**, **Pedidos clínicos** | O tipo do pedido é o marcado. | Não marque nenhum, ou marque os dois, para valer para os dois tipos. | | **Só pedidos com insumos de alto valor** | Pelo menos uma linha do pedido é um insumo marcado como **Insumo de alto valor** no catálogo (a marcação copiada quando a linha foi adicionada). | Desmarcado: os insumos não importam. | | **Valor mínimo do pedido (unidades menores, por exemplo centavos)** | O valor do pedido é igual ou maior que este número. | Sem limite inferior. | | **Valor máximo do pedido (unidades menores, por exemplo centavos)** | O valor do pedido é igual ou menor que este número. | Sem limite superior. | Os valores são números inteiros em unidades menores: em uma moeda com duas casas decimais, `50000` significa 500,00; em uma moeda sem casas decimais, `50000` significa 50.000. O valor do pedido é o que foi congelado no envio (veja [Criar e acompanhar pedidos](/docs/pt/orders/create-and-track#valor-e-dados-ocultos)). Um pedido sem valor nunca atende a uma regra que tenha mínimo ou máximo. Um pedido não tem valor quando nenhum dos seus insumos tem custo. Se esse pedido não atender a nenhuma outra regra, ele é **aprovado automaticamente**. Mantenha os custos em dia em [Custos](/docs/pt/catalog/costs), ou adicione uma regra sem condições de valor para que todo pedido precise de pelo menos uma etapa. O motor de regras também entende uma condição de **categoria** (o pedido tem pelo menos um insumo de uma categoria da lista, conforme copiado quando a linha foi adicionada), mas o console não a oferece. Se uma regra já tem uma condição de categoria, ou um limite de valor que você não pode ver, o editor a mantém e mostra **Esta regra também tem condições que você não pode alterar aqui; elas são mantidas.** Veja [Categorias](/docs/pt/catalog/categories). As regras não expressam mais nada. Em particular, não há condição por unidade, por quem solicita, por um insumo específico, por quantidade, por fornecedor ou por data. Toda regra vale para todas as unidades da clínica odontológica. ### Requisito | Campo | Significado | Limites | | - | - | - | | **Nome da etapa** | O nome que quem aprova vê, por exemplo "Gerência da clínica". Regras com o mesmo nome de etapa formam uma única etapa. | Obrigatório, até 64 caracteres. | | **Pessoas que devem aprovar** | Quantas pessoas diferentes precisam aprovar esta etapa. | Número inteiro de 1 a 10. | A permissão exigida de quem aprova não é um campo: regras criadas no console sempre exigem `approvals.decide`. Quem aprova também precisa ter acesso à unidade do pedido, e quem solicita nunca pode aprovar o próprio pedido. Veja [Aprovar ou rejeitar pedidos](/docs/pt/orders/approvals). ## Como um pedido é avaliado Quando um pedido enviado é processado, o sistema pega a versão da política vigente naquele momento e: 1. Confere cada regra contra o pedido. A ordem das regras não importa. 2. Reúne a etapa de cada regra atendida. 3. Junta as regras com o mesmo nome de etapa em uma única etapa, que precisa da **maior** quantidade de pessoas entre elas. 4. Monta o plano com as etapas resultantes, ordenadas pelo nome, e registra a versão da política usada. 5. Se o plano tem pelo menos uma etapa, o pedido passa para **Aguardando aprovação**. Se não tem nenhuma, passa para **Aprovado**. O pedido precisa das aprovações de **todas** as etapas do plano. Uma rejeição em qualquer etapa rejeita o pedido inteiro. ## Publicar regras **Aprovação de pedidos** e depois **Política de aprovação**. O editor mostra as regras da versão vigente. Selecione **Adicionar uma regra** para incluir uma regra (**Regra 1**, **Regra 2** e assim por diante). Em cada regra, preencha **Nome da etapa**, marque as condições em **Vale para** e **Só pedidos com insumos de alto valor**, defina **Valor mínimo do pedido** ou **Valor máximo do pedido** se precisar, e informe **Pessoas que devem aprovar** (começa em 1). Cada regra tem o próprio botão para removê-la, por exemplo **Remover a regra 2**. Selecione **Publicar política**. O botão mostra **Publicando…** e depois a tela confirma que a nova versão já está em vigor. O botão fica desabilitado enquanto o editor não tiver regras; para publicar uma política sem regras, use **Publicar sem aprovações**. Publicar sempre envia o conjunto **completo** de regras mostrado no editor como uma nova versão. Uma regra que você removeu do editor não faz parte da nova versão. ## Publicar uma política sem aprovações Use esta opção quando a sua clínica odontológica não quiser aprovações. Fica na seção **Sem aprovação**. A caixa de diálogo **Publicar uma política sem aprovações?** explica: "A partir de agora nenhum pedido aguarda uma decisão. Você pode publicar regras de novo quando quiser." Selecione **Publicar sem aprovações**, ou **Manter a política vigente** para voltar. A partir daí, todo pedido enviado é aprovado automaticamente e vai direto para a preparação. Os pedidos que já aguardavam aprovação mantêm o plano que tinham. ## Versões * Cada publicação cria uma nova versão com o número seguinte (1, 2, 3...). O servidor registra a hora da publicação e quem publicou. * Uma versão publicada nunca é modificada. Alterar a política sempre significa publicar uma nova versão. * Cada pedido mantém o plano que recebeu, incluindo o número da versão usada. Publicar uma nova versão não reavalia os pedidos que já estão em **Aguardando aprovação**, **Aprovado** ou mais adiante. * Um pedido é avaliado com a versão vigente quando o sistema processa o envio, o que normalmente acontece segundos depois de quem solicitou enviar o pedido. * Se duas pessoas publicarem ao mesmo tempo, só uma versão vence. A outra pessoa vê **Alguém publicou a política há pouco. Recarregue antes de publicar de novo.** * Quando uma nova versão é lida, o editor volta para as regras dela, então você sempre edita o que está em vigor. ### Antes da primeira política Uma clínica odontológica sem nenhuma política publicada não aprova nada: os pedidos enviados ficam em **Enviado**. Publicar a primeira política (com regras ou sem aprovações) os libera. Os pedidos que já aguardavam são processados na próxima vez que o sistema processar envios da sua clínica odontológica, o que acontece sempre que um pedido é enviado. Se um pedido continuar em **Enviado** algum tempo depois da publicação, escreva para [team@muveya.com](mailto:team@muveya.com). ## Exemplo completo Uma clínica odontológica que trabalha com uma moeda de duas casas decimais publica três regras: | Regra | Nome da etapa | Vale para | Insumos de alto valor | Valor mínimo | Pessoas que devem aprovar | | - | - | - | - | - | - | | 1 | Gerência da clínica | (nenhum marcado) | Não | (vazio) | 1 | | 2 | Financeiro | (nenhum marcado) | Não | `50000` | 1 | | 3 | Gerência da clínica | **Pedidos clínicos** | Sim | (vazio) | 2 | A regra 1 vale para todos os pedidos. A regra 2 vale para pedidos de 500,00 ou mais. A regra 3 vale para pedidos clínicos com pelo menos um insumo de alto valor e, como tem o mesmo nome de etapa da regra 1, as duas se juntam em uma única etapa que precisa de 2 pessoas. | Pedido | Tipo | Valor | Insumo de alto valor | Regras atendidas | Plano | | - | - | - | - | - | - | | `#101` | Geral | 120,00 | Não | 1 | Gerência da clínica (1) | | `#102` | Geral | 800,00 | Não | 1, 2 | Financeiro (1), Gerência da clínica (1) | | `#103` | Clínico | 300,00 | Sim | 1, 3 | Gerência da clínica (2) | | `#104` | Clínico | 650,00 | Sim | 1, 2, 3 | Financeiro (1), Gerência da clínica (2) | | `#105` | Geral | Sem valor | Não | 1 | Gerência da clínica (1) | O pedido `#104` precisa de duas pessoas diferentes para **Gerência da clínica** e de uma para **Financeiro**; nenhuma delas pode ser quem o solicitou. O pedido `#105` não tem insumos com custo, então a regra 2 não pode valer para ele; sem a regra 1, ele teria sido aprovado automaticamente. ## Validações e limites | Verificação | Mensagem | | - | - | | **Nome da etapa** vazio | **Dê um nome à etapa.** | | **Nome da etapa** com mais de 64 caracteres | **O nome da etapa pode ter até 64 caracteres.** | | **Pessoas que devem aprovar** não é um número inteiro de 1 a 10 | **Informe um número inteiro de 1 a 10.** | | Um valor não é um número inteiro igual ou maior que zero | **Informe um número inteiro igual ou maior que zero.** | | **Valor mínimo do pedido** maior que **Valor máximo do pedido** | **O mínimo não pode ser maior que o máximo.** | Uma política aceita no máximo 100 regras. Espaços no início e no fim do nome da etapa são removidos. ## O que pode dar errado | Mensagem | Código | Por quê | O que fazer | | - | - | - | - | | **Você não pode alterar a política de aprovação. Peça a permissão ao administrador da sua clínica.** | | Você não tem `approvals.policy.manage`. | Peça a quem gerencia a equipe **Gerenciar regras de aprovação**. | | **Alguém publicou a política há pouco. Recarregue antes de publicar de novo.** | `approvals.policy_version_conflict` | Outra pessoa publicou ao mesmo tempo. | Recarregue a página, confira a nova versão e publique de novo se for preciso. | | **Confira os dados informados antes de tentar novamente.** | `common.invalid_request` | O servidor recusou uma regra (por exemplo, um mínimo maior que o máximo). | Corrija a regra. | | **Sua conta não tem permissão para esta ação.** | `common.forbidden` | A permissão foi removida enquanto você editava. | Peça a permissão de novo. | ## A política fora do console A política só pode ser publicada no console. O recurso MCP `muveya://tenant/approval-policy-summary` foi pensado para trazer um resumo somente leitura da versão vigente, mas precisa de `approvals.decide`, que os escopos OAuth atuais de somente leitura não concedem, então sempre responde `common.forbidden`. Veja [Recursos MCP](/docs/pt/mcp/resources). ## Páginas relacionadas Como quem aprova decide as etapas de um plano. Tipos de pedido, valores e status. Os custos por trás do valor dos pedidos e dos limites. Como os insumos são agrupados no catálogo. Quem gerencia a política e quem decide. O vocabulário de pedidos e aprovações. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.