> ## 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. # Preparar e despachar um pedido > Escaneie as caixas reservadas para um pedido na ordem FEFO, divida as caixas que têm mais do que o pedido precisa e despache-as. Preparar um pedido confirma, caixa por caixa, que as caixas que o muveya reservou estão fisicamente com você. Depois, o despacho envia todas as caixas retiradas para fora do depósito de origem de uma só vez. As duas coisas acontecem na tela de preparação. ## Quem pode fazer | Ação | Permissão | Também é necessário | | - | - | - | | Abrir a tela de preparação, ver a lista e escanear caixas | `fulfillment.pick` (**Preparar pedidos**) | A unidade do pedido no seu **Acesso às unidades**, e o depósito da caixa no seu **Acesso aos depósitos**. | | Despachar as caixas retiradas | `fulfillment.dispatch` (**Despachar pedidos**) | `fulfillment.pick`, porque o painel **Despacho** fica na tela de preparação. A unidade de origem no seu **Acesso às unidades** (a unidade do pedido quando a origem é um depósito central ou o pedido não indicou origem), e o depósito de cada caixa no seu **Acesso aos depósitos**. | Preparar e despachar são etapas da parte de origem. Veja [Parte de origem e parte de destino](/docs/pt/deliveries/overview#parte-de-origem-e-parte-de-destino). Sem `fulfillment.pick`, a tela só diz "Você não pode preparar pedidos. Peça ao administrador da sua clínica a permissão para separar." ## Onde * Em **Entregas**, abra **A preparar** e selecione o número do pedido. A seção lista os pedidos em **Estoque reservado** (`allocated`) e **Em preparação** (`picking`). * No detalhe de custódia do pedido, **Preparar o pedido**. * Caminho direto: `console.muveya.com/fulfillment/:orderId/pick`. A tela se chama **Preparar o pedido #1042**, com o destino abaixo do título, por exemplo "Entregar em Depósito Norte · Clínica Norte". **Voltar às entregas** retorna à lista. Ela tem três partes: **Escanear uma caixa**, **Caixas a retirar** e, para quem despacha, **Despacho**. ## A lista de preparação **Caixas a retirar** lista cada caixa reservada para o pedido: | Coluna | O que mostra | | - | - | | **Insumo** | O nome e o SKU do insumo, por exemplo "Luvas de nitrilo M · GLV-NIT-M". | | **Código da caixa** | O código impresso na etiqueta que você deve procurar, por exemplo `BX-000123`. | | **Retirar de** | O depósito onde a caixa está agora. | | **Lote** | O número do lote, quando a caixa tem um. | | **Vence** | A data de validade, quando a caixa tem uma. | | **Quantidade** | A quantidade reservada dessa caixa para o pedido. | | **Situação** | **A retirar** ou **Retirada**. Uma caixa com mais do que o pedido acrescenta "Tem mais que o pedido: ao escaneá-la, 20 são separados em um novo recipiente". | Regras da lista: * A ordem é **FEFO**: a validade mais próxima primeiro, caixas sem validade no final. Retire as caixas nessa ordem. * Só aparecem caixas utilizáveis. Uma caixa reservada que não está mais **Ativa** ou que passou da validade (por exemplo, entrou em quarentena por um [recolhimento de lote](/docs/pt/inventory/lot-recall)) some da lista. * **Retirar de** mostra a localização atual da caixa. Se uma caixa reservada foi movida para outro depósito depois da reserva, ela continua válida: retire-a onde ela está agora. * Se nada estiver reservado, ou se o pedido estiver fora das suas unidades, a lista diz "Não há caixas reservadas para este pedido por enquanto." * A lista é somente leitura. Você não escolhe uma caixa nela: cada caixa precisa ser escaneada ou digitada. Se uma caixa sumir da lista antes de você retirá-la, o pedido pode acabar despachado sem ela: o painel **Despacho** só espera as caixas que continuam na lista. Antes de despachar, compare a lista com as linhas do pedido na página dele e escreva para [team@muveya.com](mailto:team@muveya.com) se faltar algo em uma linha. ## Escanear as caixas Vá ao depósito indicado em **Retirar de** e encontre a caixa com o **Código da caixa** impresso. O campo **Código da caixa** fica em foco quando a tela abre. Um leitor de código de barras em modo teclado digita o código e pressiona Enter por você. Sem leitor, digite o código e pressione Enter, ou selecione **Registrar caixa**. "Caixa BX-000123 registrada." significa que a caixa foi retirada e a linha dela muda para **Retirada**. O campo é limpo e continua em foco para o próximo escaneamento. O pedido passa para **Em preparação** com a primeira caixa registrada. ### O que o muveya verifica em cada escaneamento A reserva é a verificação. O muveya aceita o código somente se ele pertencer a uma caixa reservada para este pedido e que continue **Ativa**. Como a caixa já carrega o insumo, o lote, a validade e a quantidade, não há mais nada para digitar: uma caixa do insumo certo que não foi reservada para este pedido é recusada, mesmo que o SKU e o lote coincidam. | Situação | Resposta na tela | | - | - | | O código está reservado para este pedido | "Caixa BX-000123 registrada." | | O código não existe, não está reservado para este pedido, não está **Ativa** ou está em um depósito fora do seu **Acesso aos depósitos** | "Esse código não está reservado para este pedido. Confira a etiqueta e escaneie de novo." O pedido não avança. | | A caixa já estava registrada para este pedido | "Essa caixa já está registrada como retirada para este pedido." É um aviso, não um erro. | | O mesmo escaneamento foi enviado de novo depois de perder a conexão | "A caixa BX-000123 já estava registrada." | | O pedido não está mais em preparação | "Não resta nada a retirar para este pedido." | Um escaneamento que ficou sem resposta (por exemplo, a conexão caiu) pode ser repetido sem risco: enquanto você tenta de novo o mesmo código, o console reutiliza a mesma chave de solicitação, então a caixa nunca é retirada duas vezes. ## Dividir uma caixa ao preparar As caixas viajam inteiras. Quando uma caixa reservada tem mais do que o pedido leva, escaneá-la separa exatamente a quantidade reservada em um novo recipiente, e é esse recipiente que é retirado e despachado. A **Situação** dela diz "Tem mais que o pedido: ao escaneá-la, 20 são separados em um novo recipiente". Enquanto houver uma caixa assim a retirar, o formulário mostra **Etiqueta do recipiente separado (opcional)**. Coloque a quantidade do pedido em um saco ou caixa novos. Se você tiver uma etiqueta para ele, digite o código em **Etiqueta do recipiente separado (opcional)**, com até 64 caracteres. Se deixar vazio, o muveya cria um nome a partir da caixa original, por exemplo `BX-000123-F1`. Escaneie o código da caixa original. A resposta é "A quantidade do pedido agora está no novo recipiente BX-000123-F1. Cole essa etiqueta nele." Cole a etiqueta no novo recipiente. A lista agora o mostra como **Retirada** com o código novo. O que o sistema registra em uma divisão: * **Separação (saída)** na caixa original e **Separação (entrada)** no novo recipiente, pela mesma quantidade, então o total do insumo não muda. * A reserva do pedido passa da caixa original para o novo recipiente (movimentos **Liberado** e **Reservado**). * **Retirado para o pedido** no novo recipiente. * O novo recipiente mantém o insumo, o lote, a data de validade e a data de recebimento da caixa original. A caixa original continua **Ativa** no depósito dela com o restante do conteúdo. Limites: * Uma etiqueta que já é usada por outra caixa da conta de clínica odontológica é recusada: "O registro mudou ou já existe. Confira antes de tentar novamente." Escolha outra etiqueta ou deixe o campo vazio. * Caixas com números de série não podem ser divididas. O escaneamento é recusado com a mesma mensagem de conflito. * Se o escaneamento for interrompido depois da divisão, escaneie de novo a caixa original ou a etiqueta do novo recipiente: o muveya reconhece a divisão que já fez e não divide duas vezes. ## Despachar o pedido O painel **Despacho** aparece para quem tem `fulfillment.dispatch` enquanto o pedido está em preparação. Até que todas as caixas da lista sejam retiradas, ele diz "O despacho fica disponível quando todas as caixas forem retiradas." Quando todas as linhas dizem **Retirada**, o painel diz "Todas as caixas foram retiradas. Entregue-as a quem as leva ao destino." Digite a transportadora, o mensageiro ou o código de rastreio em **Transportadora ou mensageiro (opcional)**, com até 120 caracteres. Selecione **Despachar pedido**. A resposta é "Pedido despachado. As caixas estão a caminho." Se você também pode confirmar entregas, aparece o link **Confirmar a entrega**. Antes de movimentar o estoque, o muveya verifica cada caixa retirada: ela precisa continuar **Ativa**, e a quantidade que contém e a quantidade reservada nela precisam ser iguais ao que este pedido leva. Uma caixa com estoque a mais ou com a reserva de outro pedido é recusada inteira, e nada é despachado. O que o sistema registra: * Um movimento **Despachado** em cada caixa retirada: a quantidade sai do estoque do depósito de origem e a reserva é consumida. * Cada caixa passa para **Em trânsito**. Ela continua em trânsito até que o destino a aceite ou ela seja devolvida. * O horário do despacho e a referência da transportadora no registro de custódia. O console não mostra a referência da transportadora; a API a devolve como `carrierRef` em `GET /v1/fulfillments`. * O pedido passa para **Despachado** (`dispatched`) e o registro de auditoria `fulfillment.dispatched` é gravado. Despachar um pedido que já estava despachado não muda nada e diz "Este pedido já estava despachado." ## Quando não há estoque reservado A tela de preparação só funciona depois que o muveya reservou estoque para o pedido. Se o pedido está aprovado, mas não reservado: * Ele não aparece em **A preparar**, e a página dele continua dizendo "O pedido está passando para o próximo passo. Esta tela se atualiza sozinha em alguns segundos." * Ao abrir a tela de preparação, aparece "Não há caixas reservadas para este pedido por enquanto." A reserva é tudo ou nada e é tentada de novo sempre que outro pedido da conta de clínica odontológica é aprovado; não há botão para tentar de novo. Receba ou movimente o estoque que falta e, se o pedido continuar em **Aprovado**, escreva para [team@muveya.com](mailto:team@muveya.com) com o número do pedido. Veja [Etapa 1: o sistema reserva o estoque](/docs/pt/deliveries/overview#etapa-1-o-sistema-reserva-o-estoque). ## O que pode dar errado | Mensagem | Código | O que fazer | | - | - | - | | "Esse código não está reservado para este pedido. Confira a etiqueta e escaneie de novo." | `fulfillment.scan_mismatch` | Compare a etiqueta com o **Código da caixa** da lista. Confira se o depósito da caixa está no seu **Acesso aos depósitos**. | | "Essa caixa já está registrada como retirada para este pedido." | `fulfillment.over_pick` | Nada: a caixa já foi retirada. Siga para a próxima. | | "Não resta nada a retirar para este pedido." | `fulfillment.nothing_to_pick` | O pedido não está mais em **Estoque reservado** nem em **Em preparação**, ou está fora das suas unidades. Abra o detalhe de custódia para ver o status. | | "Ainda não há caixas retiradas para despachar." | `fulfillment.nothing_to_dispatch` | Retire pelo menos uma caixa antes; ou o pedido não está em **Em preparação**, ou a unidade de origem está fora do seu **Acesso às unidades**. | | "Uma caixa retirada tem mais do que este pedido leva. As caixas viajam inteiras: escaneie-a de novo para separar a quantidade do pedido em seu próprio recipiente." | `fulfillment.box_not_dispatchable` | O despacho é recusado enquanto uma caixa retirada não está mais **Ativa**, venceu ou não tem mais exatamente o que este pedido reservou nela (por exemplo, unidades foram consumidas ou corrigidas depois da reserva, ou outro pedido compartilha a caixa). Escanear de novo uma caixa retirada não resolve: só responde "Essa caixa já está registrada como retirada para este pedido." Abra a página da caixa para ver o que mudou e depois escreva para [team@muveya.com](mailto:team@muveya.com) com o número do pedido. | | "Este pedido não está mais sendo preparado." | | O pedido já passou da preparação. Use o link para a página de acompanhamento. | | "Este registro não está disponível na conta de clínica odontológica ativa." | `orders.not_found` | O pedido não existe ou pertence a uma unidade fora do seu **Acesso às unidades**. | | "O registro mudou ou já existe. Confira antes de tentar novamente." | `inventory.box_code_taken` e outros conflitos de estoque | Use outra etiqueta para o novo recipiente, ou recarregue a página e confira a caixa na página dela (veja [Caixas e etiquetas](/docs/pt/inventory/boxes)). | | "Este registro não está disponível na conta de clínica odontológica ativa." | `inventory.box_not_found` | Uma caixa está em um depósito fora do seu **Acesso aos depósitos**. Peça a um administrador para ampliá-lo, ou peça ajuda a um colega com acesso. | | "Sua conta não tem permissão para esta ação." | `common.forbidden` | Falta `fulfillment.pick` ou `fulfillment.dispatch`. | | "Não foi possível confirmar a operação. Verifique sua conexão e a lista antes de tentar novamente." | | Reconecte e escaneie o mesmo código de novo; ele não será retirado duas vezes. | ## Páginas relacionadas As etapas da custódia, as permissões e a custódia por caixa inteira. As etapas depois do despacho. Códigos de caixa, situações e movimentos. Lotes em quarentena e por que uma caixa reservada pode sumir da lista. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.