Criar e acompanhar pedidos

Um pedido solicita insumos para serem entregues em um depósito de uma das suas unidades. Ele começa como rascunho, e só você, que o solicitou, pode editá-lo. Quando você o envia, a política de aprovação decide se alguém precisa aprová-lo; depois, a equipe de entregas reserva o estoque, prepara o pedido, despacha e a unidade recebe. Esta página cobre as telas de Pedidos: a lista (console.muveya.com/orders), Novo pedido (/orders/new) e o detalhe do pedido (/orders/<orderId>).

​

Quem pode fazer o quê

Nenhuma dessas permissões vem com uma função: um Proprietário ou um Administrador também precisa recebê-las explicitamente. Além disso, vale o acesso por unidade: você só pode pedir para uma unidade atribuída a você, entregar em um depósito atribuído a você e ver pedidos das suas unidades atribuídas. Veja Funções e permissões. Só quem criou um pedido pode editá-lo, enviá-lo ou cancelá-lo. Ninguém mais pode, quaisquer que sejam suas permissões.

​

Quais pedidos você vê

O servidor decide quais pedidos aparecem na sua lista e quais você pode abrir: Se você abrir um pedido que não pode ver, o console responde exatamente como se ele não existisse: Este pedido não existe ou você não pode vê-lo.

​

A lista de pedidos

Abra Pedidos na navegação principal. A tela se chama Pedidos e mostra os pedidos do mais novo para o mais antigo, de 25 em 25; Carregar mais pedidos traz a próxima página. O seletor Mostrar filtra a lista: Com a lista vazia, você vê Não há pedidos aqui. Você vê os pedidos que solicitou, ou os das suas clínicas se você os aprova, prepara ou recebe. Se nenhuma unidade estiver atribuída a você, vê Você não tem unidades atribuídas. Peça acesso a um administrador. Em Início, a seção Trabalho pendente mostra o cartão Rascunhos de pedidos quando você tem rascunhos ainda não enviados.

​

Criar um pedido

​

Antes de começar

• A unidade precisa estar ativa e ter pelo menos um depósito ativo que pertença a ela. Veja Unidades e Depósitos.
• Os insumos precisam estar ativos no catálogo, com a unidade de medida fixada. Veja Insumos do catálogo.
• Se você quer que o pedido tenha valor (e usar regras de aprovação por valor), os insumos precisam de um custo confirmado para a unidade de medida atual. Veja Custos.

​

Passo 1: o cabeçalho do pedido

O cabeçalho não pode ser alterado depois que o pedido é criado: não há como editar a unidade, o destino, a origem, o motivo ou a referência do paciente. Se algum estiver errado, cancele o rascunho e crie um novo pedido. Se a unidade escolhida tem depósitos, mas nenhum está atribuído a você, aparece Você não tem nenhum depósito desta clínica atribuído. Peça acesso a um administrador. Se ela não tem nenhum depósito ativo, aparece Esta clínica ainda não tem um depósito ativo. Crie um em Depósitos primeiro.

​

Pedidos gerais e clínicos

​

O motivo e os dados pessoais

Um paciente só se vincula a um pedido pela referência do paciente. Para manter identificadores fora do texto livre, o servidor recusa um Motivo que contenha qualquer um destes elementos e mostra O motivo parece incluir dados pessoais. Remova nomes, telefones ou números de documento.

• Um endereço de e-mail.
• Um número de cartão escrito como quatro grupos de quatro dígitos.
• Uma das palavras rut, dni, mrn, nhs, ssn, cpf, paciente ou patient seguida imediatamente de um valor que contém um dígito (por exemplo, “paciente 12”).
• Nove ou mais dígitos seguidos. Pontos ou hífens entre dígitos não interrompem a sequência, então 12.345.678-9 conta como nove dígitos. Datas e horários não são afetados.

Reescreva o motivo sem o identificador e crie o pedido de novo.

​

Passo 2: adicione os insumos

Enquanto o pedido é um rascunho, você (quem o solicitou) vê o formulário Adicionar um insumo abaixo da tabela Insumos. Quando uma linha é adicionada, o pedido guarda uma cópia do nome, do SKU, da unidade de medida, da categoria e da marcação de alto valor do insumo e, se houver, do custo unitário vigente naquele momento. Mudanças posteriores no catálogo não alteram a linha. Para alterar uma quantidade, edite-a na coluna Quantidade e selecione Salvar. Para tirar um insumo, selecione Remover. Adicionar o mesmo insumo duas vezes cria duas linhas separadas; se você só precisa de mais, altere a linha existente.

​

Passo 3: envie o pedido

Selecione Enviar pedido. O botão fica desabilitado até o pedido ter pelo menos um insumo. Ao enviar, o sistema:

1. Passa o pedido de draft para submitted e registra a hora do envio.
2. Congela o valor do pedido a partir dos custos das linhas.
3. Coloca o pedido na fila da política de aprovação. Em poucos segundos o pedido passa para Aguardando aprovação (alguém precisa decidir) ou direto para Aprovado (a política não exige decisão). Enquanto isso, o pedido mostra O pedido está passando para o próximo passo. Esta tela se atualiza sozinha em alguns segundos.

Depois do envio, os insumos não podem mais ser alterados; se tentar, você vê Este pedido não pode mais ser alterado.

​

Status do pedido

O ciclo de vida do pedido é uma máquina de estados fechada. Um status só muda por uma das transições abaixo; qualquer outra é recusada. Tudo o que acontece a partir de allocated está em Entregas: visão geral.

​

O detalhe do pedido

Abra um pedido a partir da lista. O cabeçalho mostra Pedido # com o número, o status ao lado e Voltar aos pedidos.

​

Dados

​

Próximo passo

O painel Próximo passo diz o que acontece agora: A partir de Estoque reservado, quem tem alguma permissão de entregas também vê Acompanhar a entrega, que abre a tela da entrega. Veja Entregas: visão geral.

​

Insumos

A tabela Insumos mostra cada linha com Insumo (nome e SKU) e Quantidade (quantidade e unidade de medida, por exemplo “10 × Caixa”). Se o pedido não tem linhas, você vê Ainda não há insumos. Adicione pelo menos um para enviar o pedido. Enquanto o pedido é seu rascunho, uma coluna Alterar traz Salvar e Remover.

​

Cancelar um pedido

Quem: só quem solicitou, com orders.create. Quando: enquanto o pedido está em Rascunho, Enviado ou Aguardando aprovação. O que o sistema registra: o pedido passa para cancelled, um status definitivo. Nada é reservado nem preparado. Se ele aguardava aprovação, sai da caixa de entrada de quem aprova; as decisões já registradas continuam no histórico. Depois que um pedido está Aprovado, ele não pode mais ser cancelado pelo console, e nenhuma outra pessoa (nem um Proprietário ou um Administrador) pode cancelar o pedido de outra. Se for preciso interromper um pedido aprovado, escreva para team@muveya.com.

​

Valor e dados ocultos

• O Valor do pedido é a soma, nas linhas que têm custo, da quantidade vezes o custo unitário copiado quando a linha foi adicionada. Ele é guardado em unidades menores (centavos, ou unidades inteiras em uma moeda sem casas decimais) e exibido no formato da moeda do pedido. Linhas sem custo não somam; se nenhuma linha tiver custo, o pedido não tem valor. O valor é congelado quando o pedido é enviado.
• O valor só aparece para quem tem orders.value.read. Sem essa permissão, o dado Valor do pedido (e a coluna de valor da caixa de entrada de aprovações) simplesmente não aparece. Os custos de cada linha dependem de catalog.cost.read; esta tela não os exibe.
• A Referência do paciente só aparece com orders.patient_ref.read, e só no detalhe do pedido.
• O servidor remove os dados ocultos antes que cheguem ao seu navegador, então eles ficam ausentes, e não em branco.

​

O que pode dar errado

​

Pedidos fora do console

Pedidos só podem ser criados no console. Também existe acesso somente leitura:

• A API pública lista e lê pedidos com GET /v1/orders e GET /v1/orders/{orderId} (escopo orders:read). O valor do pedido e a referência do paciente ficam sempre ocultos para uma chave de API. Veja Escopos.
• A ferramenta MCP orders.get lê um pedido, e o recurso muveya://orders/status-model descreve este ciclo de vida. Veja Ferramentas MCP e Recursos MCP.

​

Páginas relacionadas