Aprovar ou rejeitar pedidos

Quando a política de aprovação 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/<orderId>).

​

Quem pode decidir

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. 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

​

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.” 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.

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

​

O que cada decisão faz

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.

​

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: 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.

​

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

​

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. A API pública não expõe as decisões de aprovação.

​

Páginas relacionadas