A line of items with an id keeps that line; a line without one is new; a stored line that is not sent is removed. A line cannot be removed, change product or go below what was received or shipped (409). A kept line sent with the quantity it has is accepted as it is, also a quantity of 0 (a product that was received without being ordered); a new line, or a quantity that changes, needs at least 1 (422). kind is refused on a product line and landedCost on a custom item (422); a kept custom line keeps its kind unless kind says otherwise, and a custom item that shipped or was received cannot become a charge (409). Every custom line sent is stored with its kind. A sent purchase order moves its incoming stock reservations to the new quantities, dates and warehouse in the same request, and notifyVendor: true emails the vendor the revision. balanceDueDate and shipNotBeforeDate follow the order date and the net days: when orderDate or paymentTerms changes, a date that was derived moves with it and a date the caller set is kept; sending one sets it, and sending null gives it back to the rule. An update of anything else leaves both dates as they are. Refused with 409 once the purchase order is received, cancelled or exported to accounting, and with 409 version_conflict when version is not the current one.
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.

