The incoming stock still reserved for the units that will not come is released and the purchase order is received. From then on it owes for what it received, not for what it ordered: payableTotal becomes the value of the received units (per line that ships, a product line or a custom item, the lesser of the received and the ordered quantity, at its unit price) plus every charge line in full, and the balance due is counted from it, so it is below zero when more than that was paid already. total stays what was ordered. A later receipt takes the close back: the purchase order owes its total again (closedShort is false as soon as it is being received again, or once nothing is open any more). A sent purchase order that holds no line that ships (only charges) has nothing to receive: closing it completes it (received, closedAt set, it owes its total). Any other purchase order is 409 not_partly_received, also a sent one that holds a line that ships and received nothing.
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.

