Historial de custodia

​

Quién puede verlo

• Permiso fulfillment.read (Ver abastecimiento).
• La sede del pedido en tu Acceso a sedes.

​

Dónde

• En Entregas, sección Por cerrar o Problemas de entrega, selecciona el número del pedido.
• En la página del pedido, Seguir la entrega (se muestra a quienes tienen algún permiso de custodia). Consulta Crear y seguir pedidos.
• Después de confirmar una recepción, el enlace debajo del mensaje de confirmación.
• En la pantalla de preparación de un pedido que ya no se está preparando, el enlace Seguimiento del pedido #1042.
• Ruta directa: console.muveya.com/fulfillment/:orderId.

​

Qué muestra la pantalla

​

Datos y siguiente paso

​

Cajas

​

Historial

​

Usarlo en auditorías y disputas

​

Qué no muestra la pantalla

• El texto de Evidencia del problema escrito en la recepción. Se guarda, pero por ahora no se muestra en la consola ni lo devuelve la API.
• Las notas por caja de una disputa y la elección de cuarentena. La API devuelve ambas.
• La referencia del transportista escrita al despachar. GET /v1/fulfillments la devuelve como carrierRef.
• El registro de auditoría. Por ahora no hay una pantalla de auditoría en la consola.
• Una exportación. Para guardar los historiales de custodia fuera de muveya, léelos desde la API.

​

Leerlo desde la API

• Autenticación: una clave de API (mvy_test_...) en el encabezado Authorization: Bearer. Por ahora las claves de API no se crean desde la consola; consulta Autenticación.
• Scope: fulfillment:read. Consulta Scopes.
• Cobertura: toda la cuenta de clínica dental de la clave. Una clave no tiene filtro por sede.
• Solo lectura: los pasos de custodia (preparar, despachar, entregar, recibir, cerrar) no se pueden hacer por la API ni por MCP.

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

​

Respuesta

{
  "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": "Sello roto al llegar"
      }
    ]
  }
}

• Devuelve ids, no nombres ni códigos de caja. Lee el código y el estado de una caja con GET /v1/inventory/boxes/{boxId} (scope inventory:read), y un insumo con GET /v1/catalog/items/{itemId} (scope catalog:read).
• actorId y actorUserId son ids de integrantes. Las acciones que muveya hizo por su cuenta llevan system:fulfillment.
• El estado allocating puede aparecer por un momento mientras corre la reserva; la consola lo muestra como Reservando existencias.
• Responde 404 cuando el pedido no existe, pertenece a otra cuenta de clínica dental o todavía no tiene registro de custodia (un pedido aprobado cuyas existencias no están reservadas).
• Otras respuestas: 401 si la clave falta o no es válida, 403 si la clave no tiene fulfillment:read, 429 si la clave supera su límite de solicitudes. Consulta Errores y Límites de uso.

​

Páginas relacionadas