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

# Criar e acompanhar pedidos

> Solicite insumos para uma das suas unidades, envie o pedido e acompanhe-o do rascunho até o encerramento.

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](/docs/pt/orders/approval-policy) 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>`).

<Note>
  Nas telas de pedidos, a unidade aparece como **Clínica** (coluna, campo e dado). É a mesma coisa que a navegação principal chama de **Unidades**. Veja [Conceitos](/docs/pt/concepts).
</Note>

## Quem pode fazer o quê

| O que você quer fazer | Permissão necessária (rótulo em **Equipe**) |
| - | - |
| Ver **Pedidos** na navegação principal | Qualquer uma de `orders.create`, `orders.read.all`, `approvals.decide`, `fulfillment.pick`, `fulfillment.dispatch`, `delivery.confirm`, `receipt.confirm`, `fulfillment.close`, `fulfillment.read` |
| Criar um pedido geral, adicionar e alterar seus insumos, enviá-lo, cancelá-lo | `orders.create` (**Criar pedidos de materiais**) |
| Criar um pedido clínico com referência de paciente | `orders.create` **e** `orders.clinical.create` (**Criar pedidos clínicos**) |
| Ver todos os pedidos das suas unidades, não só os seus | `orders.read.all` (**Ver todos os pedidos**), ou `approvals.decide`, ou qualquer permissão de entregas |
| Ver o **Valor do pedido** | `orders.value.read` (**Ver valores dos pedidos**) |
| Ver a **Referência do paciente** de um pedido clínico | `orders.patient_ref.read` (**Ver referências externas de pacientes**) |

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](/docs/pt/account/roles-and-permissions).

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:

| Suas permissões | Pedidos que você vê |
| - | - |
| `orders.read.all`, `approvals.decide` ou qualquer permissão de entregas | Todos os pedidos cuja unidade está atribuída a você |
| Só `orders.create` | Só os pedidos que você solicitou, em unidades atribuídas a você |
| Nenhuma das anteriores | Nenhum: a lista é recusada com **Sua conta não tem permissão para esta ação.** |

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.

| Coluna | O que mostra |
| - | - |
| **Pedido** | O número do pedido, por exemplo `#42`. Abre o detalhe. Os números são sequenciais dentro da sua clínica odontológica. |
| **Status** | O status atual (veja [Status do pedido](#status-do-pedido)). |
| **Tipo** | **Geral** ou **Clínico**. |
| **Clínica** | A unidade para a qual é o pedido. |
| **Entregar em** | O depósito de destino. |
| **Solicitado por** | Quem solicitou, pelo nome, ou **Você** para os seus próprios pedidos. |
| **Criado** | Data e hora de criação. |

O seletor **Mostrar** filtra a lista:

| Opção | Status incluídos |
| - | - |
| **Todos os pedidos** | Todos |
| **Rascunhos** | `draft` |
| **Aguardando aprovação** | `submitted`, `pending_approval`, `approved` |
| **A preparar** | `allocated`, `picking` |
| **A caminho** | `dispatched`, `delivered` |
| **Recebidos** | `received`, `partially_fulfilled`, `closed` |
| **Problemas de entrega** | `exception` |
| **Rejeitados ou cancelados** | `rejected`, `cancelled` |

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](/docs/pt/locations/clinics) e [Depósitos](/docs/pt/locations/warehouses).
* Os insumos precisam estar ativos no catálogo, com a unidade de medida fixada. Veja [Insumos do catálogo](/docs/pt/catalog/items).
* 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](/docs/pt/catalog/costs).

### Passo 1: o cabeçalho do pedido

<Steps>
  <Step title="Abra Novo pedido">
    Vá em **Pedidos** e selecione **Novo pedido**. O link só aparece se você tem `orders.create`. A tela se chama **Novo pedido**: "Escolha a clínica e onde entregar. Depois você adiciona os insumos."
  </Step>

  <Step title="Escolha a Clínica">
    Selecione a unidade em **Clínica**. Só aparecem unidades ativas atribuídas a você. Se você tiver exatamente uma, ela aparece como texto e já fica selecionada.
  </Step>

  <Step title="Escolha Entregar no depósito">
    Selecione o destino em **Entregar no depósito**. A lista traz os depósitos ativos que pertencem à unidade escolhida e estão atribuídos a você. Enquanto você não escolher uma unidade, o campo indica **Escolha a clínica primeiro.** Se só um depósito atender, ele aparece como texto e já fica selecionado.
  </Step>

  <Step title="Se quiser, escolha Retirar estoque de">
    **Retirar estoque de** vem com **Qualquer depósito central**. Você pode indicar, em vez disso, um depósito central ativo como origem preferida. Apesar do rótulo, um pedido sem origem indicada pode ter estoque reservado de qualquer caixa utilizável em qualquer depósito da clínica odontológica, inclusive os express; confira **Retirar de** na [lista de preparação](/docs/pt/deliveries/picking) antes de buscar as caixas.
  </Step>

  <Step title="Se quiser, escreva um Motivo">
    **Motivo (opcional)** é um texto livre para quem aprova e para a equipe de entregas. Não pode conter dados pessoais (veja [O motivo e os dados pessoais](#o-motivo-e-os-dados-pessoais)).
  </Step>

  <Step title="Marque como clínico, se for o caso">
    Se você tem `orders.clinical.create`, vê a caixa **É para o tratamento de um paciente**. Marque-a para criar um pedido clínico; aparece o campo **Referência do paciente (opcional)** com a dica "Use o código interno da sua clínica, nunca um nome ou número de documento."
  </Step>

  <Step title="Crie o pedido">
    Selecione **Criar pedido**. O console abre o novo pedido em **Rascunho**, pronto para receber os insumos.
  </Step>
</Steps>

| Campo | Obrigatório | Regras |
| - | - | - |
| **Clínica** | Sim | Precisa ser uma unidade ativa atribuída a você. Vazio: **Escolha a clínica.** |
| **Entregar no depósito** | Sim | Precisa estar ativo, pertencer à unidade escolhida e estar atribuído a você. Vazio: **Escolha onde entregar.** |
| **Retirar estoque de** | Não | Um depósito central ativo, ou **Qualquer depósito central**. |
| **Motivo (opcional)** | Não | Até 2000 caracteres. Espaços no início e no fim são removidos. Sem dados pessoais. |
| **É para o tratamento de um paciente** | Não | Só aparece com `orders.clinical.create`. Desmarcada, o pedido é geral. |
| **Referência do paciente (opcional)** | Não | Só pedidos clínicos. Até 200 caracteres. |

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

| | Geral (`general`) | Clínico (`clinical`) |
| - | - | - |
| Permissões | `orders.create` | `orders.create` e `orders.clinical.create` |
| Referência do paciente | Nunca | Opcional |
| Política de aprovação | As regras o alcançam com **Pedidos gerais** | As regras o alcançam com **Pedidos clínicos** |
| Todo o resto | Mesmos campos, mesmo ciclo de vida | Mesmos campos, mesmo ciclo de vida |

<Warning>
  A referência do paciente é um código opaco do seu próprio sistema clínico, por exemplo `ext-7f3a`. Nunca informe um nome, um número de documento, um telefone ou qualquer coisa que identifique uma pessoa. O muveya nunca consulta a que esse código corresponde. Ele é guardado criptografado e só aparece para integrantes com `orders.patient_ref.read`, e apenas no detalhe do pedido: nunca aparece na lista de pedidos, nas telas de aprovação nem na API pública.
</Warning>

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

<Steps>
  <Step title="Escolha o insumo">
    Selecione-o em **Insumo**. A lista mostra os insumos ativos com nome e SKU, por exemplo "Luvas de nitrilo M · GLV-NIT-M".
  </Step>

  <Step title="Confira a unidade de medida">
    O console lê a unidade de medida do insumo e mostra **Contado em:** seguido dela (por exemplo **Caixa**). A quantidade que você informar está nessa unidade de medida.
  </Step>

  <Step title="Informe a quantidade e adicione">
    Digite um número inteiro maior que zero em **Quantidade** e selecione **Adicionar insumo**.
  </Step>
</Steps>

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.

| Mensagem | Por quê | O que fazer |
| - | - | - |
| **Informe uma quantidade inteira maior que zero.** | A quantidade está vazia, é zero, negativa ou tem decimais. | Informe um número inteiro, 1 ou mais. |
| **A unidade deste insumo mudou no catálogo. Escolha-o de novo para ver a unidade atual.** | A unidade de medida mudou depois que o formulário a leu. | Escolha o insumo de novo e confira **Contado em:**. |
| **A unidade deste insumo ainda não foi revisada no catálogo.** | A unidade de medida do insumo ainda não está fixada. | Peça a quem gerencia o catálogo que fixe a unidade de medida. Veja [Insumos do catálogo](/docs/pt/catalog/items). |
| **Este insumo não está ativo no catálogo.** | O insumo foi desativado. | Escolha outro insumo. |
| **O registro mudou ou já existe. Confira antes de tentar novamente.** | O insumo tem um custo que não está confirmado para a unidade de medida atual (`catalog.cost_unverified`). | Peça a quem gerencia o catálogo que confirme o custo. Veja [Custos](/docs/pt/catalog/costs). |
| **Esse insumo não está mais no pedido.** | A linha já foi removida, por exemplo em outra aba. | Confira o pedido atualizado. |

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

<Note>
  Se a sua clínica odontológica nunca publicou uma política de aprovação, um pedido enviado fica em **Enviado**. Publicar a primeira política não o faz avançar sozinho: os pedidos que já aguardavam são processados na próxima vez que qualquer pedido for enviado na sua clínica odontológica. Quem gerencia a política vê em **Início** o cartão **Ainda não há política de aprovação: os pedidos enviados aguardam até que uma seja publicada**. Veja [Política de aprovação](/docs/pt/orders/approval-policy).
</Note>

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.

| Status | Rótulo | Significado | O que o faz avançar |
| - | - | - | - |
| `draft` | **Rascunho** | Sendo preparado por quem solicitou. | Quem solicitou envia ou cancela. |
| `submitted` | **Enviado** | Enviado; aguarda a aplicação da política de aprovação. | O sistema: para `pending_approval` se a política exige decisão, para `approved` se não exige. Quem solicitou pode cancelar. |
| `pending_approval` | **Aguardando aprovação** | Aguarda as decisões que o plano de aprovação exige. | Pessoas com `approvals.decide`: para `approved` quando todas as etapas são aprovadas, para `rejected` quando qualquer etapa é rejeitada. Quem solicitou pode cancelar. Veja [Aprovar ou rejeitar pedidos](/docs/pt/orders/approvals). |
| `approved` | **Aprovado** | Aprovado por pessoas ou pela política. Não pode mais ser cancelado. | O sistema reserva o estoque e passa para `allocated`. Se faltar estoque, fica em **Aprovado** até a reserva ser possível. |
| `rejected` | **Rejeitado** | Alguém rejeitou. É definitivo. | Nada. Crie um novo pedido se os insumos ainda forem necessários. |
| `cancelled` | **Cancelado** | Quem solicitou cancelou. É definitivo. | Nada. |
| `allocated` | **Estoque reservado** | Há estoque reservado no depósito de origem. | A primeira leitura válida de uma caixa (`fulfillment.pick`) passa para `picking`. |
| `picking` | **Em preparação** | As caixas estão sendo separadas. | O despacho (`fulfillment.dispatch`) passa para `dispatched`. |
| `dispatched` | **Despachado** | As caixas saíram do depósito de origem. | A confirmação de entrega (`delivery.confirm`): para `delivered`, ou para `exception` se um problema for informado. |
| `delivered` | **Entregue** | Entregue no destino. | A confirmação de recebimento (`receipt.confirm`): para `received`, ou para `partially_fulfilled` se o recebimento for contestado. |
| `exception` | **Problema de entrega** | Um problema foi informado na entrega. | Nenhuma ação do console o faz avançar. O pedido mostra "Foi informado um problema de entrega. A resolução está pendente com o dono da clínica." |
| `received` | **Recebido** | Recebido por completo. | O encerramento (`fulfillment.close`) passa para `closed`. |
| `partially_fulfilled` | **Recebido em parte** | Recebido com contestação (danificado, faltante ou parcial). | O encerramento (`fulfillment.close`) passa para `closed`. |
| `closed` | **Encerrado** | Encerrado administrativamente. É definitivo. | Nada. |

```mermaid theme={null}
stateDiagram-v2
  [*] --> draft : criar
  draft --> submitted : enviar
  draft --> cancelled : cancelar
  submitted --> pending_approval : exige aprovação
  submitted --> approved : não exige aprovação
  submitted --> cancelled : cancelar
  pending_approval --> approved : todas as etapas aprovadas
  pending_approval --> rejected : uma etapa rejeitada
  pending_approval --> cancelled : cancelar
  approved --> allocated : estoque reservado
  allocated --> picking : primeira caixa lida
  picking --> dispatched : despachar
  dispatched --> delivered : entrega confirmada
  dispatched --> exception : entrega com problema
  delivered --> received : recebimento confirmado
  delivered --> partially_fulfilled : recebimento contestado
  received --> closed : encerrar
  partially_fulfilled --> closed : encerrar
  rejected --> [*]
  cancelled --> [*]
  closed --> [*]
```

Tudo o que acontece a partir de `allocated` está em [Entregas: visão geral](/docs/pt/deliveries/overview).

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

| Dado | Quando aparece |
| - | - |
| **Tipo** | Sempre. |
| **Clínica** | Sempre. |
| **Entregar em** | Sempre. |
| **Retirar estoque de** | Sempre; **Qualquer depósito central** se nenhuma origem foi escolhida. |
| **Solicitado por** | Sempre. |
| **Motivo** | Se o pedido tiver um. |
| **Referência do paciente** | Pedidos clínicos com referência, e só se você tiver `orders.patient_ref.read`. |
| **Valor do pedido** | Se você tiver `orders.value.read` e pelo menos uma linha tiver custo. |

### Próximo passo

O painel **Próximo passo** diz o que acontece agora:

| Status | O que o painel diz ou oferece |
| - | - |
| **Rascunho** | Para quem solicitou: "Adicione os insumos e envie o pedido quando estiver completo." Para as demais pessoas: o nome de quem solicitou e "ainda está preparando este pedido." |
| **Enviado**, **Aprovado** | "O pedido está passando para o próximo passo. Esta tela se atualiza sozinha em alguns segundos." A tela se atualiza a cada poucos segundos enquanto o pedido está em um desses status. |
| **Aguardando aprovação** | "Aguardando aprovação." e, para cada etapa do plano, o nome e a quantidade de aprovações necessárias. Para quem solicitou: "Você solicitou este pedido, então outra pessoa precisa aprová-lo." Para quem tem `approvals.decide`: o link **Revisar e decidir**. |
| **Rejeitado** | "Este pedido foi rejeitado. Crie um novo se os insumos ainda forem necessários." |
| **Cancelado** | "Este pedido foi cancelado." |
| De **Estoque reservado** a **Entregue** | "O pedido está sendo preparado e entregue." |
| **Recebido**, **Recebido em parte**, **Encerrado** | "O pedido foi recebido." |
| **Problema de entrega** | "Foi informado um problema de entrega. A resolução está pendente com o dono da clínica." |

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](/docs/pt/deliveries/overview).

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

<Steps>
  <Step title="Abra o pedido">
    Abra-o a partir de **Pedidos**.
  </Step>

  <Step title="Selecione Cancelar pedido">
    A caixa de diálogo **Cancelar o pedido #1042?** (com o número do pedido) explica: "O pedido para aqui e ninguém vai prepará-lo. Isso não pode ser desfeito."
  </Step>

  <Step title="Confirme">
    Selecione **Sim, cancelar**, ou **Manter o pedido** para voltar.
  </Step>
</Steps>

**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](mailto: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

| Mensagem | Código | Por quê | O que fazer |
| - | - | - | - |
| **Você não pode criar pedidos. Peça ao administrador da sua clínica a permissão para solicitar insumos.** | | Você não tem `orders.create`. | Peça a quem gerencia a equipe **Criar pedidos de materiais**. |
| **Você não tem unidades atribuídas para criar pedidos. Peça acesso a um administrador.** | | Seu acesso por unidade está vazio. | Peça acesso a uma unidade. |
| **Essa clínica não está ativa.** | `orders.clinic_unavailable` | A unidade está inativa, não existe ou não está atribuída a você. | Escolha outra unidade ou peça acesso. |
| **Esse depósito não está ativo.** | `orders.warehouse_unavailable` | O destino está inativo, pertence a outra unidade ou não está atribuído a você, ou o depósito de origem escolhido está inativo. | Escolha outro depósito ou peça acesso. |
| **O motivo parece incluir dados pessoais. Remova nomes, telefones ou números de documento.** | `orders.justification_rejected` | O motivo coincidiu com um padrão de dados pessoais. | Remova o identificador. |
| **Você não pode adicionar uma referência de paciente.** | `orders.patient_ref_forbidden` | Você tentou criar um pedido clínico sem `orders.clinical.create`. | Crie um pedido geral, ou peça **Criar pedidos clínicos**. |
| **Este insumo não está ativo no catálogo.** | `orders.catalog_item_unavailable` | O insumo está inativo ou não existe. | Escolha outro insumo. |
| **A unidade deste insumo mudou no catálogo. Escolha-o de novo para ver a unidade atual.** | `catalog.measurement_conflict` | A unidade de medida mudou depois que você escolheu o insumo. | Escolha-o de novo. |
| **A unidade deste insumo ainda não foi revisada no catálogo.** | `catalog.measurement_unverified` | A unidade de medida não está fixada. | Fale com quem gerencia o catálogo. |
| **Este pedido não pode mais ser alterado.** | `orders.not_editable` | O pedido não é mais um rascunho. | Não há o que alterar; acompanhe o status. |
| **Esse insumo não está mais no pedido.** | `orders.line_not_found` | A linha foi removida nesse meio-tempo. | Confira o pedido. |
| **Alguém alterou este pedido há pouco. A tela já mostra a versão mais recente; revise e tente novamente.** | `orders.version_conflict` | O pedido mudou desde que a sua tela o carregou (por exemplo, foi enviado ou cancelado em outra aba). | Confira o pedido atualizado e repita a ação se ainda fizer sentido. |
| **O pedido não está mais em um passo em que isso possa ser feito.** | `orders.transition_not_allowed` | O status não permite a ação (por exemplo, cancelar um pedido aprovado). | Veja [Status do pedido](#status-do-pedido). |
| **Este pedido não existe ou você não pode vê-lo.** | `orders.not_found` | Link errado, outra unidade, ou o pedido de outra pessoa sem permissão para vê-lo. | Confira o link e o seu acesso. |
| **Sua conta não tem permissão para esta ação.** | `common.forbidden` | Falta uma permissão. | Peça a permissão indicada na seção **Quem pode fazer o quê**. |

## 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](/docs/pt/api-reference/scopes).
* A ferramenta MCP `orders.get` lê um pedido, e o recurso `muveya://orders/status-model` descreve este ciclo de vida. Veja [Ferramentas MCP](/docs/pt/mcp/tools) e [Recursos MCP](/docs/pt/mcp/resources).

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Aprovar ou rejeitar pedidos" icon="circle-check" href="/docs/pt/orders/approvals">
    Decida os pedidos que aguardam a sua aprovação.
  </Card>

  <Card title="Política de aprovação" icon="scale-balanced" href="/docs/pt/orders/approval-policy">
    Quais pedidos precisam de aprovação, e de quem.
  </Card>

  <Card title="Entregas: visão geral" icon="truck" href="/docs/pt/deliveries/overview">
    O que acontece depois que um pedido é aprovado.
  </Card>

  <Card title="Custos" icon="coins" href="/docs/pt/catalog/costs">
    De onde vem o valor do pedido.
  </Card>

  <Card title="Funções e permissões" icon="user-shield" href="/docs/pt/account/roles-and-permissions">
    Atribua permissões de pedidos e acesso por unidade.
  </Card>

  <Card title="Conceitos" icon="book" href="/docs/pt/concepts">
    Clínica odontológica, unidades, depósitos e pedidos.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.