For a purchase order that was sent and is not fully received. Without items every quantity that has not shipped yet ships (ordered minus already shipped, over the lines that ship: product lines and custom items); with items the lines named ship in the quantities given, and at least one quantity must be above 0 (422). A charge line never ships and a custom item takes no lot (422). Shipping more than was ordered is allowed. shippedAt defaults to now; tracking and carrier are optional. From all shipments together each line gets its shipped quantity and status, the purchase order its vendor shipping status (pending, partly-fulfilled, fulfilled) and its expected date: the latest ETA among the shipments that have not arrived. When that date moves, the incoming stock reserved for the purchase order moves to it in the same request.
Scope: outgoing-purchase-orders:write, channel:write or admin. A permission group made before the Channel API scopes existed grants it as inventory:manage or supply-chain:manage.
Idempotency: send Idempotency-Key; a retry with the same key replays the first answer.
Rate limit: write class, 1,200 requests per minute per tenant by default (read class 6,000). Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset; a refusal is 429 rate_limited with Retry-After.

