order.mark_shipped

Ship a preparing order (preparing -> shipped), stamping the departure on its shipment (and the tracking, when it rides along). Refused while the order has an active hold. Idempotent by state; out-of-sequence is a conflict.

• Scope: order.write
• System: no
• Reachable from: POST /v1/commands/order.mark_shipped (tenant credential) · MCP tool order.mark_shipped · SDK client.call('order.mark_shipped', …)
• Events: order.shipped, shipment.shipped, order.shipment.updated

Input (JSON Schema)

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

Result (200)

{
  "additionalProperties": false,
  "properties": {
    "order_id": {
      "type": "string"
    },
    "status": {
      "type": "string"
    }
  },
  "required": [
    "order_id",
    "status"
  ],
  "type": "object"
}

Errors

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