For any purchase order that is not cancelled. items, when sent, replaces the lines of the shipment. The shipped quantities and statuses of the lines, the vendor shipping status and the expected date are recomputed from all shipments. :shipmentId is the id the purchase order answers for the shipment; an unknown one is 404.
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.

