order.shipment.mark_picked_up

Record that the buyer collected ONE parcel — the retrieval sibling of marking it delivered. Requires the parcel to have been marked ready for pickup first (a named refusal otherwise). Idempotent by state. The ORDER advances only when every one of its parcels has arrived.

• Scope: order.write
• System: no
• Reachable from: POST /v1/commands/order.shipment.mark_picked_up — the tenant data face, with a tenant credential carrying order.write · MCP tool order.shipment.mark_picked_up · SDK client.call('order.shipment.mark_picked_up', …)
• Events: shipment.picked_up, order.preparing, order.shipped, order.delivered, inventory.committed

Input (JSON Schema)

{
  "properties": {
    "order_id": {
      "minLength": 1,
      "type": "string"
    },
    "shipment_id": {
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "order_id",
    "shipment_id"
  ],
  "type": "object"
}

Result (200)

{
  "additionalProperties": false,
  "properties": {
    "order_id": {
      "type": "string"
    },
    "order_status": {
      "type": "string"
    },
    "picked_up_at": {
      "type": "string"
    },
    "shipment_id": {
      "type": "string"
    }
  },
  "required": [
    "order_id",
    "shipment_id",
    "picked_up_at",
    "order_status"
  ],
  "type": "object"
}

Errors

validation_failed (400) · unauthorized (401) · forbidden (403) · conflict (409) · internal (500)