All lines are answered (never capped). allowedActions is decided by the server from the stage, what was received, what was paid, the limits and whether the purchase order was exported to accounting: a client shows exactly these actions, and each of them is accepted for this purchase order as it stands (the one exception: send is offered to a draft that still lacks a ship-to warehouse or a line, and refused with what is missing). A received purchase order keeps record_payment when nothing is owed (a refund, a late charge, a correction); a cancelled one offers record_payment alone, and only while money that was paid has not come back. A draft that was never sent offers delete; a draft that was sent before offers cancel in its place (it cannot be deleted), unless units were received against it. email (send it to the vendor again) is offered while the purchase order is sent, not cancelled and names a vendor. vendorContacts.contacts lists the vendor contacts that have an email (the primary one first, then by name); buyerBillTo is who the vendor bills: always the buyer, the stored bill-to unless it is empty or the vendor's own address, else the workspace's billing (or mailing) address. Money: total is what was ordered. payableTotal is what the purchase order costs in the end: its total; while it is closed short, what was received (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; 0 once it is cancelled. closedShort is true while the purchase order is received, was closed short (closedAt) and still has units that did not come (openUnits above 0); when the rest is received after all, closedAt stays, closedShort is false and the purchase order owes its total like any other. balanceDue is always payableTotal minus paid (below zero when the vendor holds money that is owed back; null while payments are not tracked). For a purchase order that tracks payments the financial status is always the one of these two figures: paid when what was paid covers a payableTotal above 0, partly-paid when something was paid otherwise, unbilled when nothing was; one that does not track payments keeps the status it has. depositDue is the deposit (the deposit percent of the total, rounded half away from zero to the minor unit of the currency: a cent, a yen) minus what was paid, never below 0, and 0 once the purchase order is received or cancelled. openUnits is what is still to come: over the lines that ship (product lines and custom items), ordered minus received, never below 0 per line. Each line answers its kind (product, item or charge). receipts lists the stock ledger receipts of the products and the receipts kept on the custom items (lineId set, no product, location or lot) together, newest first; lastReceivedAt is the newest of them. A line or a receipt with a lot answers the lot under lotNumber as people read it: the lot number, else its barcode, else its label; a line also answers lotExpirationDate. version is the optimistic lock a PATCH may send back.
Scope: outgoing-purchase-orders:read, outgoing-purchase-orders:write, channel:write or admin. A permission group made before the Channel API scopes existed grants it as inventory:read or supply-chain:read.
Idempotency: not keyed; the request itself is safe to repeat.
Rate limit: read class, 6,000 requests per minute per tenant by default (write class 1,200). Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset; a refusal is 429 rate_limited with Retry-After.

