> ## 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. # Confirmar a entrega, receber e encerrar > Confirme a entrega de um pedido despachado ou informe um problema, aceite ou conteste cada caixa entregue e encerre o pedido. Depois do despacho, uma entrega precisa de mais três atos, feitos por duas partes diferentes: 1. A **parte de origem** confirma que entregou as caixas, ou informa um problema de entrega. 2. A **parte de destino** confere cada caixa e a aceita ou contesta. 3. A **parte de destino** encerra o pedido. Para saber quem é cada parte, veja [Parte de origem e parte de destino](/docs/pt/deliveries/overview#parte-de-origem-e-parte-de-destino). ## Confirmar a entrega ### Quem pode fazer * Permissão `delivery.confirm` (**Confirmar entrega**). * 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). * Para ver as caixas entregues pelo código, você também precisa de `fulfillment.read`. Sem ela, a tela lista os insumos pedidos. Sem `delivery.confirm`, a tela diz "Você não pode confirmar entregas. Peça a permissão ao administrador da sua clínica." ### Onde * Em **Entregas**, abra **A entregar** e selecione o número do pedido. A seção lista os pedidos em **Despachado** (`dispatched`). * Logo depois de despachar, o link **Confirmar a entrega** na tela de preparação. * No detalhe de custódia, **Confirmar a entrega**. * Caminho direto: `console.muveya.com/fulfillment/:orderId/delivery`. A tela se chama **Entrega do pedido #1042**. Em **O que está sendo entregue**, ela mostra as caixas (**Código da caixa**, **Insumo**, **Quantidade**) ou, sem `fulfillment.read`, os insumos pedidos (**Insumo** como "nome · SKU", **Quantidade** como "10 × unidade"). ### Confirmar uma entrega sem problemas Compare as caixas que você entrega com **O que está sendo entregue**. Selecione **Confirmar entrega**. Não há uma caixa de diálogo de confirmação extra. "Entrega confirmada. Agora o destino confirma o recebimento." O pedido passa para **Entregue** (`delivered`) e aparece em **A receber** para a parte de destino. ### Informar um problema de entrega Use esta opção quando as caixas não puderam ser entregues como deveriam. Selecione **Informar um problema**. Escolha uma opção em **O que aconteceu** (obrigatório) e acrescente contexto em **Detalhes (opcional)**, com até 2000 caracteres. Selecione **Informar problema**. Uma caixa de diálogo avisa: "O pedido para como problema de entrega, e a resolução fica pendente com o dono da clínica." Selecione **Informar problema** de novo para enviar, ou **Voltar** para deixar o pedido como está. | Opção em **O que aconteceu** | Código gravado | | - | - | | **Não foi possível entregar** | `not_delivered` | | **Chegou danificado** | `damaged` | | **Foi para o lugar errado** | `wrong_destination` | | **Outra coisa** | `other` | A resposta é "O problema foi registrado. O pedido agora é um problema de entrega." O pedido passa para **Problema de entrega** (`exception`). ### O que o sistema registra * Um registro de entrega com quem confirmou, quando, quais caixas foram entregues e, se houve problema, o código do motivo e os detalhes. Ele é gravado uma única vez e não pode ser alterado: confirmar de novo só diz "Esta entrega já estava registrada." * Nenhum movimento de estoque. As caixas continuam **Em trânsito** até o destino recebê-las. * O status do pedido (`delivered` ou `exception`) e o registro de auditoria `fulfillment.delivered` ou `fulfillment.delivery_exception`. ### Se um problema de entrega for informado Um problema de entrega para o pedido: * As caixas continuam **Em trânsito**. Elas não contam nem no depósito de origem nem no de destino. * O pedido não pode ser recebido nem encerrado. O detalhe de custódia diz "A resolução está pendente com o dono da clínica. Por enquanto não há mais nada a fazer aqui." * Ele aparece em **Problemas de entrega** para quem tem `fulfillment.read`. Por enquanto não há uma tela para resolver um problema de entrega no console, e um problema informado não pode ser retirado. O dono da conta deve escrever para [team@muveya.com](mailto:team@muveya.com) com o número do pedido e o que aconteceu. ## Receber o pedido ### Quem pode fazer * Permissão `receipt.confirm` (**Confirmar recebimento**) e permissão `fulfillment.read` (**Ver atendimento**). * A unidade de destino no seu **Acesso às unidades** (a unidade do pedido quando o destino é um depósito central). * Se os depósitos de origem e de destino pertencem a duas unidades diferentes, seu **Acesso às unidades** não pode incluir a unidade de origem, a menos que você tenha **Todas as unidades desta conta**. A tela explica o que falta: "Você não pode receber pedidos. Peça a permissão ao administrador da sua clínica." ou "Para receber caixa por caixa você também precisa de permissão para ver entregas. Peça ao administrador da sua clínica." ### Onde * Em **Entregas**, abra **A receber** e selecione o número do pedido. A seção lista os pedidos em **Entregue** (`delivered`). * No detalhe de custódia, **Receber o pedido**. * Caminho direto: `console.muveya.com/fulfillment/:orderId/receipt`. A tela se chama **Receber o pedido #1042**. Ela mostra um cartão para cada caixa entregue, com o código, o insumo e "Quantidade: 10". Se o pedido não estiver em **Entregue**, ela diz "Este pedido ainda não foi entregue, então não há nada a receber." ### Passos A tela lembra: "Confira cada caixa. Aceite o que chegou bem; conteste o que chegou danificado ou está faltando." Todas as caixas começam em **Aceitar**. Para cada caixa com problema, mude **Decisão para a caixa BX-000123** para **Contestar** e preencha os campos dela (veja a tabela abaixo). Assim que uma caixa é contestada, aparece **Evidência do problema**, que é obrigatória: "Descreva o que você viu e onde estão as fotos. Obrigatória quando você contesta uma caixa." Até 2000 caracteres. Selecione **Confirmar recebimento**. A resposta é "Recebimento confirmado: todas as caixas foram aceitas." ou "Recebimento confirmado com caixas contestadas. Elas voltam ao depósito de onde saíram." Um link abre a página de acompanhamento do pedido. Campos de uma caixa contestada: | Campo | Valores | Valor inicial | | - | - | - | | **Motivo da caixa BX-000123** | **Danificada** (`damaged`), **Faltando** (`missing`), **Insumo errado** (`wrong_item`), **Vencida** (`expired`), **Outro** (`other`) | **Danificada** | | **Deixar a caixa BX-000123 em quarentena quando voltar** | Marcado ou não | Marcado | | **Observação para a caixa BX-000123 (opcional)** | Texto livre, até 2000 caracteres | Vazio | Por enquanto não é possível anexar fotos no console. Informe na evidência onde as fotos estão guardadas. ### O que acontece com cada caixa | Decisão | Movimento de estoque | Onde a caixa fica | Situação da caixa | | - | - | - | - | | **Aceitar** | **Recebido**: a quantidade entra no depósito de destino. | O depósito de destino. | **Ativa** | | **Contestar** com quarentena marcada | **Devolvido**: a quantidade volta ao depósito de origem, com o código do motivo. | O depósito de origem. | **Em quarentena** (fora das reservas e do consumo) | | **Contestar** sem quarentena | **Devolvido**, como acima. | O depósito de origem. | **Ativa** | Uma caixa contestada fica registrada de volta no depósito de onde saiu, então envie-a de volta fisicamente. O movimento original **Despachado** continua no registro: a devolução é um novo movimento de compensação, nunca uma edição. Para conferir depois uma caixa em quarentena, veja [Caixas e etiquetas](/docs/pt/inventory/boxes) e [Recolhimento de lote](/docs/pt/inventory/lot-recall); nenhuma ação tira uma caixa da quarentena. O pedido passa para **Recebido** (`received`) quando todas as caixas foram aceitas, ou para **Recebido em parte** (`partially_fulfilled`) quando pelo menos uma foi contestada. O registro de auditoria é `fulfillment.received` ou `fulfillment.received.disputed`. ### Quantidades parciais O recebimento é por caixa inteira: cada caixa é aceita ou contestada como uma unidade, e não existe um campo para a quantidade recebida. Se uma caixa chegou com menos unidades do que o esperado, escolha uma destas opções: * Conteste a caixa (por exemplo com **Faltando** ou **Outro**) e descreva a diferença na evidência. A caixa inteira fica registrada de volta na origem, onde a contagem pode ser corrigida. * Aceite a caixa e depois corrija a quantidade dela no destino com uma [correção de estoque](/docs/pt/inventory/corrections). ### Regras e limites * Só é possível receber um pedido em **Entregue**. * O recebimento precisa cobrir exatamente as caixas entregues, cada uma uma única vez. O console monta isso para você; se a entrega mudou enquanto a página estava aberta, recarregue-a. * Um recebimento pode incluir até 200 caixas aceitas e 200 caixas contestadas. * Vale o primeiro recebimento. Confirmar de novo só diz "Este recebimento já estava registrado." * O texto da evidência é gravado com o recebimento, mas por enquanto não aparece no detalhe de custódia nem é devolvido pela API. As observações de cada caixa são devolvidas pela API, mas não aparecem no console. ## Encerrar o pedido Encerrar é a última etapa, administrativa. Ela não movimenta estoque: cada caixa já foi recebida no destino ou devolvida à origem. ### Quem pode fazer * Permissão `fulfillment.close` (**Encerrar atendimento**) e permissão `fulfillment.read` (**Ver atendimento**), porque o botão fica no detalhe de custódia. * As mesmas regras de unidade do recebimento: quem encerra é a parte de destino. ### Passos Em **Entregas**, abra **A encerrar** e selecione o número do pedido. A seção lista os pedidos em **Recebido** e **Recebido em parte**. O detalhe de custódia mostra "Tudo foi recebido ou devolvido. Encerre o pedido para concluí-lo." Selecione **Encerrar pedido**. "Pedido encerrado." O pedido passa para **Encerrado** (`closed`). Uma segunda tentativa diz "Este pedido já estava encerrado." O que o sistema registra: um registro de encerramento com quem encerrou e quando, o status `closed` do pedido e o registro de auditoria `fulfillment.closed`. ### Regras * Só pedidos em **Recebido** ou **Recebido em parte** podem ser encerrados. Um pedido com **Problema de entrega** não pode ser encerrado. * **Uma caixa ainda em trânsito impede o encerramento.** Depois de um recebimento, o muveya leva cada caixa para o destino ou de volta à origem. Se uma dessas etapas de estoque não terminou, a caixa continua **Em trânsito** e o encerramento responde "Este pedido ainda não pode ser encerrado." O muveya tenta de novo a etapa pendente em segundo plano; confira a tabela **Caixas** no detalhe de custódia e tente mais tarde. Se uma caixa continuar **Em trânsito**, escreva para [team@muveya.com](mailto:team@muveya.com). ## O que pode dar errado | Mensagem | Código | O que fazer | | - | - | - | | "Este pedido não está a caminho." | `fulfillment.not_dispatched` | O pedido não está em **Despachado**, ou a unidade de origem está fora do seu **Acesso às unidades**. Confira o status no detalhe de custódia. | | "Escolha o que aconteceu." | | Selecione uma opção em **O que aconteceu** antes de enviar. | | "Diga o que aconteceu em até 200 caracteres." | `fulfillment.invalid_delivery_exception` | Encurte o motivo do problema. | | "Não há nada a receber deste pedido aqui." | `fulfillment.nothing_to_receive` | O pedido não está em **Entregue**, ou a unidade de destino está fora do seu **Acesso às unidades**. | | "A decisão deve cobrir exatamente as caixas entregues. Recarregue a página e confira de novo." | `fulfillment.over_receipt` | Recarregue a página e decida de novo para cada caixa. | | "Descreva a evidência antes de contestar uma caixa." | | Preencha **Evidência do problema**. | | "Uma caixa contestada precisa de evidência. Descreva o que você viu." | `fulfillment.discrepancy_requires_evidence` | Preencha **Evidência do problema** e confirme de novo. | | "Este texto pode ter até 2000 caracteres." | | Encurte a observação ou a evidência. | | "Um motivo ou uma observação é longo demais." | `fulfillment.invalid_receipt` | Encurte as observações das caixas ou a evidência. | | "Este pedido ainda não pode ser encerrado." | `fulfillment.nothing_to_close` | O pedido não está em **Recebido** nem em **Recebido em parte**, uma caixa continua **Em trânsito**, ou a unidade de destino está fora do seu **Acesso às unidades**. | | "Esta entrega não existe ou você não pode vê-la." (tela de recebimento) ou "Este registro não está disponível na conta de clínica odontológica ativa." (tela de entrega) | `common.not_found`, `orders.not_found` | O pedido não existe ou está fora das suas unidades. | | "Sua conta não tem permissão para esta ação." | `common.forbidden` | Falta a permissão da etapa, ou você pertence à unidade de origem de uma transferência entre duas unidades e não pode recebê-la nem encerrá-la. Peça a um integrante da unidade de destino. | | "Confira os dados informados antes de tentar novamente." | `common.invalid_request` | Caixas demais em um recebimento, ou um campo inválido. Recarregue e tente de novo. | | "Não foi possível concluir a solicitação. Tente novamente." | | Se, depois de recarregar, a tela de recebimento disser "Este recebimento já estava registrado.", o recebimento vale e o muveya conclui as etapas de estoque em segundo plano. | ## Páginas relacionadas Etapas da custódia, custódia por caixa inteira e permissões. Confira os registros de entrega, recebimento e encerramento. Corrija a quantidade de uma caixa depois de aceitar uma entrega. Coloque em quarentena e acompanhe as caixas de um lote. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.