Histórico de custódia

​

Quem pode ver

• Permissão fulfillment.read (Ver atendimento).
• A unidade do pedido no seu Acesso às unidades.

​

Onde

• Em Entregas, abra A encerrar ou Problemas de entrega e selecione o número do pedido.
• Na página do pedido, Acompanhar a entrega (aparece para quem tem alguma permissão de custódia). Veja Criar e acompanhar pedidos.
• Depois de confirmar um recebimento, o link abaixo da mensagem de confirmação.
• Na tela de preparação de um pedido que não está mais sendo preparado, o link Acompanhamento do pedido #1042.
• Caminho direto: console.muveya.com/fulfillment/:orderId.

​

O que a tela mostra

​

Dados e próxima etapa

​

Caixas

​

Histórico

​

Usar em auditorias e contestações

​

O que a tela não mostra

• O texto de Evidência do problema digitado no recebimento. Ele é gravado, mas por enquanto não aparece no console nem é devolvido pela API.
• As observações por caixa de uma contestação e a escolha de quarentena. A API devolve as duas.
• A referência da transportadora digitada no despacho. GET /v1/fulfillments a devolve como carrierRef.
• O registro de auditoria. Por enquanto não há uma tela de auditoria no console.
• Uma exportação. Para guardar os históricos de custódia fora do muveya, leia-os pela API.

​

Ler pela API

• Autenticação: uma chave de API (mvy_test_...) no cabeçalho Authorization: Bearer. Por enquanto as chaves de API não são criadas pelo console; veja Autenticação.
• Escopo: fulfillment:read. Veja Escopos.
• Alcance: toda a conta de clínica odontológica da chave. Uma chave não tem filtro por unidade.
• Somente leitura: as etapas de custódia (preparar, despachar, entregar, receber, encerrar) não podem ser feitas pela API nem pelo MCP.

curl https://api.muveya.com/v1/fulfillments/66f0c1a2b3c4d5e6f7a8b9c0 \
  -H "Authorization: Bearer $MUVEYA_API_KEY"

​

Resposta

{
  "orderId": "66f0c1a2b3c4d5e6f7a8b9c0",
  "status": "partially_fulfilled",
  "movements": [
    {
      "movementId": "66f0c3000000000000000001",
      "type": "reserve",
      "boxId": "66e9a1000000000000000125",
      "catalogItemId": "66e1b2000000000000000045",
      "quantityDelta": 0,
      "reservedDelta": 10,
      "fromWarehouseId": "66e0f0000000000000000007",
      "actorId": "system:fulfillment",
      "occurredAt": "2026-09-14T13:02:11.000Z",
      "recordedAt": "2026-09-14T13:02:11.000Z"
    },
    {
      "movementId": "66f0c3000000000000000002",
      "type": "dispatch",
      "boxId": "66e9a1000000000000000125",
      "catalogItemId": "66e1b2000000000000000045",
      "quantityDelta": -10,
      "reservedDelta": -10,
      "fromWarehouseId": "66e0f0000000000000000007",
      "actorId": "66d7e4000000000000000031",
      "occurredAt": "2026-09-14T15:40:02.000Z",
      "recordedAt": "2026-09-14T15:40:02.000Z"
    },
    {
      "movementId": "66f0c3000000000000000003",
      "type": "return",
      "boxId": "66e9a1000000000000000125",
      "catalogItemId": "66e1b2000000000000000045",
      "quantityDelta": 10,
      "reservedDelta": 0,
      "reasonCode": "damaged",
      "actorId": "66d7e4000000000000000058",
      "occurredAt": "2026-09-15T09:12:44.000Z",
      "recordedAt": "2026-09-15T09:12:44.000Z"
    }
  ],
  "delivery": {
    "actorUserId": "66d7e4000000000000000031",
    "deliveredAt": "2026-09-15T08:55:10.000Z",
    "boxIds": ["66e9a1000000000000000125"]
  },
  "receipt": {
    "actorUserId": "66d7e4000000000000000058",
    "receivedAt": "2026-09-15T09:12:44.000Z",
    "acceptedBoxIds": [],
    "disputed": [
      {
        "boxId": "66e9a1000000000000000125",
        "reason": "damaged",
        "quarantine": true,
        "note": "Lacre rompido na chegada"
      }
    ]
  }
}

• Ela devolve ids, não nomes nem códigos de caixa. Leia o código e a situação de uma caixa com GET /v1/inventory/boxes/{boxId} (escopo inventory:read), e um insumo com GET /v1/catalog/items/{itemId} (escopo catalog:read).
• actorId e actorUserId são ids de integrantes. As ações que o muveya fez sozinho trazem system:fulfillment.
• O status allocating pode aparecer por um instante enquanto a reserva roda; o console o mostra como Reservando estoque.
• Ela responde 404 quando o pedido não existe, pertence a outra conta de clínica odontológica ou ainda não tem registro de custódia (um pedido aprovado cujo estoque não foi reservado).
• Outras respostas: 401 para chave ausente ou inválida, 403 quando a chave não tem fulfillment:read, 429 quando a chave passa do limite de uso. Veja Erros e Limites de uso.

​

Páginas relacionadas