closePurchaseOrder

Mutation

Closes an approved purchase order that will take no further vendor bills. The relief path for a prebilled cost accrual whose vendor invoice never arrives: the accrual is reversed on the closing date, and the order's open commitments and committed cost entries close with it. Distinct from cancelling, which ends an order that should not have been placed. Access: 'purchasingApprove' in a workspace where finance is enabled. Errors: refuses an order that is not approved, and refuses a missing or blank reason. Closing an already-closed order returns it unchanged.

Returns PurchaseOrder !.