unapprovePurchaseOrder

Mutation

Takes back an approval so the order can be revised, returning it to 'draft' and incrementing its revision. The unlock half of the approval lock: approving is what freezes an order's lines, so unapproving is what thaws them, and resubmitting builds a fresh rule route against the revised total. The committed cost entries the approval emitted are reversed, because an order back in draft commits nothing. Distinct from reject, which is the approver's answer before approval, and from close and cancel, which end the order. Access: 'purchasingApprove' in a workspace where finance is enabled. Errors: refuses an order that is not approved, and refuses a missing or blank reason. Refuses an order anything has already arrived against — a linked vendor bill, a recorded receipt, or an open prebilled cost accrual — because revising the lines those reference would strand them.

Returns PurchaseOrder !.