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 (tenant credential) · 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

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)