Purchase Order Workflow

On this page

Default Workflow: This page describes the purchase order statuses, lifecycle stages, and actions, the PO item statuses and types, and the PO Items views of a new Alloy Navigator 2026.1 database created with the Default Workflow. An upgraded database need not contain them, and an administrator may have changed them. See Default Workflow Configuration.

In this configuration, the create action Purchase Order creates a purchase order at Draft. Lines are added with the purchase order action Add Line Item, which is offered only while the order is at the status Draft; Copy Order and Auto-Create PO on Reorder Request also create lines. Place Order sets the order to Ordered. It is offered only on an order that has at least one line: at Draft, while the order has no approval stage at Pending with an approval request at Pending and either its total is less than the workflow parameter Cost Requiring Approval (Cost) or that parameter is 0 (the parameter is set to 0 in the supplied configuration); at Approved, which the order reaches through approval (see Have an order approved), while the order has an approval stage and an approval request.

The lines are received with the purchase order actions Receive Items, Receive All Items, and Mark Partial Order, which are offered on an order at the status Ordered that has at least one line at the status Open. What a receipt creates (assets, a consumable, or nothing) depends on the line's product class. Receive All Items sets the order to Received, and so does an automatic update when a line is saved while its order is at Ordered and no line of the order is left at Open or Partially Received. Close Order, offered at Received and Rejected, sets the order to Closed.

Beside this path, Cancel Order sets an order at Draft, Pending Approval, Approved, or Ordered to Canceled; Reopen Order reopens a Closed order; and Assign Ownership changes the owner in every status except Closed. Purchase Order, Place Order, Close Order, Cancel Order, Reopen Order, and Assign Ownership are offered to the Administrator (Full), Administrator (Workflow), and Purchasing Manager roles, and Add Line Item to the Administrator (Full) and Purchasing Manager roles.

For the purchase order form, PO items, addresses, and invoices themselves, see Purchase Orders. For where the actions are in the Web App, see Actions in the Web App, and for how to run an action, see Perform Actions on Records.

Take a purchase order from Draft to Closed

  1. Create the order with Purchase Order, which is offered to the Administrator (Full), Administrator (Workflow), and Purchasing Manager roles; in the Web App, it is on the New menu of the Purchase Orders list. Enter a title and a requester; the owner, also required, is pre-filled with you. Click Submit. The order is created at Draft; see Create an order.
  2. Add the lines with Add Line Item, which is offered only while the order is at Draft, to the Administrator (Full) and Purchasing Manager roles. Each run adds one line; see Add lines to an order.
  3. Run Place Order, which is offered to the Administrator (Full), Administrator (Workflow), and Purchasing Manager roles on an order that has at least one line. At Draft, it is offered while the order has no approval stage at Pending with an approval request at Pending and either its total is less than the workflow parameter Cost Requiring Approval (Cost) or that parameter is 0; the parameter is set to 0 in the supplied configuration. At Approved, it is offered while the order has an approval stage and an approval request. Complete the "Place this Order" form, whose fields are all optional, and click Submit. The status becomes Ordered.
  4. Receive the items with Receive Items or Receive All Items, which are offered at Ordered while at least one line of the order is at Open. Receive All Items is offered to the Administrator (Full), Administrator (Workflow), and Purchasing Manager roles, and Receive Items to every role of the supplied configuration except the Administrator (Log Management), Administrator (Security), Administrator (Services), Administrator (Views/Dashboards), Report Designer, Report Viewer, and Viewer roles; see Receive the items of an order. The status becomes Received when Receive All Items runs, or when a line is saved while the order is at Ordered and no line of the order is left at Open or Partially Received; see Automatic updates after a receipt.
  5. Run Close Order, which is offered at Received and Rejected to the Administrator (Full), Administrator (Workflow), and Purchasing Manager roles. In the "Provide a Reason" form, which has Comment, Time Spent, and attachments, click Submit. The status becomes Closed.

When the workflow parameter Cost Requiring Approval (Cost) is set to an amount other than 0 and the order's total is that amount or more, Place Order is not offered at Draft, and the order is placed from Approved; see Have an order approved. In the Web App, Place Order, Receive All Items, and Close Order stop when an active follower of the order has no valid primary e-mail address; see Notifications to followers. To cancel or reopen an order, or to change its owner, see Other purchase order tasks.

Create an order

In the Web App, choose Purchase Order from New on the Purchase Orders list; see Create a purchase order. The action is offered to the Administrator (Full), Administrator (Workflow), and Purchasing Manager roles.

Its form, "Create a Purchase Order", requires a title, a requester, and an owner, and the owner is pre-filled with you. The form also has fields for a vendor, a type, a category, an organization, the person who authorized the order, and the date required. When an organization is chosen, the requester can be picked only from the persons of that organization.

When you submit the form, the action creates the order at Draft, sets the order's date to the current date and time, places the order in the IT workspace, copies the vendor's name, FEIN, contact, phone, e-mail, address, and fax into the order, and logs "New Purchase Order was created". The order takes the organization of its requester: an organization chosen on the form that differs from the requester's is replaced, and an order whose requester has no organization keeps the one you entered.

Copy Order and Auto-Create PO on Reorder Request also create orders at Draft.

Add lines to an order

Lines are added with the purchase order action Add Line Item, which is offered only while the order is at the status Draft, to the Administrator (Full) and Purchasing Manager roles. It opens the "Add Line Item" wizard and adds one line each time it runs.

  • When the order has no vendor yet, the action gives it the vendor of the vendor product chosen in the wizard's Product field, or else the vendor chosen in its Vendor field.
  • When no vendor product is chosen and Create Item in Product Catalog is on, the action also creates the product in the product catalog. The option is set to on in the supplied configuration.
  • The PO item class's own create action, API PO Item Creation, runs only for requests made through the API.

Lines are also created by Copy Order, which copies a purchase order, and by Auto-Create PO on Reorder Request, which the threshold triggers of stock rules run. In the Web App, Copy Order is a button on the purchase order form's toolbar; it works on one order at a time and makes the copy when you submit its form.

Have an order approved

An order is approved between Draft and Ordered. Approval is required when the workflow parameter Cost Requiring Approval (Cost) is set to an amount other than 0 and the order's total is that amount or more: Place Order is then not offered at Draft, and the order is placed from Approved. The parameter is set to 0 in the supplied configuration, which turns the requirement off, so a Draft order with at least one line and no approval stage at Pending with an approval request at Pending can be placed directly. An administrator changes the parameter on the Workflow Configuration page of the Admin Center or of the Settings App, in the category Misc Automation > Approvals > Purchasing, which is not the category Purchasing directly under Misc Automation; see Workflow Configuration and Parameters. For approval stages, approvers, and how the votes are counted, see Approvals.

  1. Run Create Approval, which is offered at Draft to the Administrator (Full), Administrator (Workflow), and Purchasing Manager roles. Complete the "Create an Approval" wizard (see Request an approval) and click Submit. The action creates an approval stage and logs "Created Approval"; the status stays Draft.
  2. Run Request Approval, which is offered at Draft to the Administrator (Full), Administrator (Workflow), and Purchasing Manager roles while the order has at least one line and an approval stage at Pending with an approval request at Pending. Enter the Approval Deadline, which is required and is pre-filled with the date five days from now, and optionally Comments and Time Spent, and click Submit. The status becomes Pending Approval, the action logs "Approval Requested by <current user>", and the approval stage at Pending with the lowest rank starts.
  3. An approver votes with Approve Request or Reject Request, which are offered at Pending Approval to every role of the supplied configuration except the Administrator (Log Management), Administrator (Security), Administrator (Services), Administrator (Views/Dashboards), Report Designer, Report Viewer, and Viewer roles, and only to a user who has a pending approval request in a pending approval stage; see Vote on an approval request. Approve Request logs "Approved by <user>", and Reject Request logs "Rejected by <user>".

When the approval stage created last for the order is approved, the order is set to Approved, and its owner is sent an e-mail with the subject "Approved (PO): <title>". When that stage is rejected, the order is set to Rejected, and its owner is sent an e-mail with the subject "Rejected (PO): <title>". At Approved, Place Order is offered while the order has at least one line, an approval stage, and an approval request. A Rejected order does not return to Draft: Close Order is the only action that changes its status.

When you choose the approvers by a position that the order does not fill, the "Create an Approval" wizard refuses it with one of these messages:

  • "The Owner is not set in the Purchase Order."
  • "The Requester or the Requester's Manager value is not set."
  • "The Vendor or the Vendor's Manager value is not set."
  • "The Organization or the Organization's Manager value is not set."

Cancel Approvals is offered at Draft and Pending Approval while an approval stage of the order is Pending or Pending Approval, to the Administrator (Full), Administrator (Workflow), and Approval Manager roles, and not to the Purchasing Manager role. It sets those stages and their pending approval requests to Not Required, logs "Approvals Canceled", and sets the order to Draft.

Receive the items of an order

The purchase order actions Receive Items, Receive All Items, and Mark Partial Order receive the lines of an order. They are offered on an order at the status Ordered that has at least one line at the status Open. Receive All Items and Mark Partial Order are offered only to the Administrator (Full), Administrator (Workflow), and Purchasing Manager roles; Receive Items is offered to every role of the supplied configuration except the Administrator (Log Management), Administrator (Security), Administrator (Services), Administrator (Views/Dashboards), Report Designer, Report Viewer, and Viewer roles.

In the Web App, the three actions are not on the form's toolbar, and a PO item does not offer them:

  1. Open the purchase order and find the Receiving section of its Action Bar. Alternatively, select the order in the Purchase Orders list, click Actions, and point to Actions and then Receiving. The list can also offer the three actions when several orders are selected, but only when every selected order is at the status Ordered.
  2. Click the action, complete the form or wizard it opens, and click Submit.

What each receiving action does

Action What you enter What it does
Receive Items One Open line, which is required; a quantity, which starts at the line's remaining quantity; and a received date, which starts at the current date and time Adds the quantity to the line's quantity received and adds "Received <n> PO Item(s)" to the order's activity. It does not set the line's status or date received itself.
Receive All Items A received date, which starts at the current date and time, and a comment For every Open or Partially Received line, adds the remaining quantity to the quantity received and sets the line's date received to the date. Sets the order's status to Received and its date received to the date.
Mark Partial Order One Open line and a comment Sets the line's status to Partially Received and its date received to today. Quantities and the order's status stay as they were.
  • Receive Items refuses a quantity greater than the line's remaining quantity with the error "You cannot receive more than is remaining. (Ordered: … Received: …)".
  • Receive Items and Mark Partial Order pick only Open lines, so Receive All Items is the only receiving action that receives a line at Partially Received.
  • An order whose outstanding lines are all at Partially Received is offered none of the three actions.

For the automatic updates that set a line and its order to Received, see Automatic updates after a receipt.

Other purchase order tasks

Cancel an order

Run Cancel Order, which is offered at Draft, Pending Approval, Approved, and Ordered to the Administrator (Full), Administrator (Workflow), and Purchasing Manager roles. In the "Provide a Reason" form, Comment, Time Spent, and attachments are optional; click Submit. The action logs "Marked as 'Cancelled'" and sets the order to Canceled. Each line of the order at Open is set to Partially Received when its quantity received is more than 0, and to Canceled otherwise; lines at Partially Received or Received keep their status.

None of the actions on this page changes the status of a Canceled order: it does not return to Draft, and it cannot be closed or reopened.

Reopen a closed order

Run Reopen Order, which is offered at Closed to the Administrator (Full), Administrator (Workflow), and Purchasing Manager roles. It opens the "Provide a Reason" form; click Submit. The action logs "Record was Reopened" and sets the order back to the status that its history records before the close, or to Draft when the history has none.

Change the owner of an order

Run Assign Ownership, which is offered in every status except Closed to the Administrator (Full), Administrator (Workflow), and Purchasing Manager roles. In the "Assign Ownership" form, choose the Owner, which is required and is pre-filled with the current owner, optionally enter a Comment and Time Spent, and click Submit. The action logs "Ownership assigned to <owner>", with the comment as its details, and e-mails the new owner with the subject "Assignment (PO): <title>". The status does not change.

When you run Assign Ownership, it stops if the new owner has no primary e-mail address, with the message "<full name>'s Primary E-mail does not exist. Please review as this process will result in an E-mail notification.", or if the address is not valid, with a message that names the person and says that the Primary E-mail is not a valid address. A stopped action saves nothing: the owner is not changed, no activity is logged, and no e-mail is sent.

Statuses and lifecycle stages

A purchase order has eight statuses: Draft, Pending Approval, Approved, Rejected, Ordered, Received, Canceled, and Closed. Closed is the inactive status of a purchase order: on a Closed order, Reopen Order is the only action offered. The status field is read-only on the purchase order form; the status is set by workflow actions and automatic updates.

In the Web App, the progress bar at the top of a purchase order's full form shows five lifecycle stages in order and highlights the stage that the order's status belongs to:

Stage Statuses
Submission Draft
Approval Pending Approval, Rejected
Ordering Approved
The receiving stage Ordered
Close Received, Canceled, Closed

Action reference

Place Order, Cancel Order, Close Order, Reopen Order, Assign Ownership, Create Approval, Request Approval, Receive All Items, and Mark Partial Order, like the create action Purchase Order, are offered to the Administrator (Full), Administrator (Workflow), and Purchasing Manager roles. Add Line Item is offered to the Administrator (Full) and Purchasing Manager roles, and Cancel Approvals to the Administrator (Full), Administrator (Workflow), and Approval Manager roles. Receive Items, Approve Request, Reject Request, and Add Comment are offered to every role of the supplied configuration except the Administrator (Log Management), Administrator (Security), Administrator (Services), Administrator (Views/Dashboards), Report Designer, Report Viewer, and Viewer roles.

Action Offered in What it does
Add Line Item Draft Opens the "Add Line Item" wizard and adds one line; see Add lines to an order.
Create Approval Draft Opens the "Create an Approval" wizard, creates an approval stage, and logs "Created Approval". The status stays.
Request Approval Draft, while the order has at least one line and an approval stage at Pending with an approval request at Pending Opens the form "Request Approval" with Approval Deadline, which is required and is pre-filled with the date five days from now, Comments, and Time Spent. Sets Pending Approval, logs "Approval Requested by <current user>", and starts the approval stage at Pending with the lowest rank.
Approve Request, Reject Request Pending Approval, only to a user with a pending approval request in a pending approval stage Approve Request logs "Approved by <user>", and Reject Request logs "Rejected by <user>". The order's status then follows the approval outcome; see Have an order approved.
Cancel Approvals Draft, Pending Approval, while an approval stage of the order is Pending or Pending Approval Sets those stages and their pending approval requests to Not Required, logs "Approvals Canceled", and sets Draft.
Place Order Draft, while the order has at least one line and no approval stage at Pending with an approval request at Pending, and either its total is less than the workflow parameter Cost Requiring Approval (Cost) or that parameter is 0; Approved, while the order has at least one line, an approval stage, and an approval request Opens the form "Place this Order" with the vendor, budget, payment terms, shipping, invoice date, invoice number, tax rate, sales tax, shipping tax rate, shipping price, price adjustment, Comment, and Time Spent, none of them required; the form notes "Providing either the Tax Rate or Sales Tax will calculate the other." Logs "Purchase Order Placed" and sets Ordered. When the order has a vendor, it copies the vendor's name, FEIN, contact, phone, e-mail, address, and fax into the order again. The order's date stays the date the order was created.
Receive Items, Receive All Items, Mark Partial Order Ordered, while at least one line of the order is at Open See What each receiving action does.
Close Order Received, Rejected Opens the form "Provide a Reason" with Comment, Time Spent, and attachments. Logs "Marked as 'Closed'" and sets Closed. The lines and the order's dates stay as they are.
Cancel Order Draft, Pending Approval, Approved, Ordered Opens the form "Provide a Reason" with Comment, Time Spent, and attachments, none of them required. Logs "Marked as 'Cancelled'" and sets Canceled. Sets each line at Open to Partially Received when its quantity received is more than 0, and to Canceled otherwise.
Reopen Order Closed Opens the form "Provide a Reason". Logs "Record was Reopened" and sets the status that the order's history records before the close, or Draft when the history has none.
Assign Ownership Every status except Closed Opens the form "Assign Ownership" with Owner, which is required and is pre-filled with the current owner, Comment, and Time Spent. Logs "Ownership assigned to <owner>" and e-mails the new owner. The status stays.
Copy Order Every status except Closed Creates a copy of the order at Draft; the action also creates lines. It runs on one order at a time.

The order also carries Add Comment, which is offered in every status except Closed, and Follow and Unfollow, which are offered in every status except Closed under a further condition; see Follow and unfollow a record.

Actions in the Web App

In the Web App, an open purchase order shows its actions on the Action Bar, in these sections (the actions are listed here in alphabetical order):

  • the General section: Add Line Item, Assign Ownership, Cancel Order, Close Order, Place Order, and Reopen Order;
  • the Approvals section: Approve Request, Cancel Approvals, Create Approval, Reject Request, and Request Approval;
  • the Receiving section: Mark Partial Order, Receive All Items, and Receive Items;
  • the Communication section: Add Comment.

None of these actions is on the form's toolbar. The toolbar carries Copy Order, as an icon-only button, and Follow and Unfollow, as buttons that show their captions. In the Purchase Orders list, the toolbar's Actions menu offers all of these actions, under Actions and then their group: General, Approvals, Receiving, Communication, or Relationships, which holds Copy Order, Follow, and Unfollow. Every one of them except Copy Order can run on several selected orders.

Notifications to followers

These status changes send an e-mail to the order's active followers: the changes made by Place Order, Cancel Order, Close Order, Request Approval, Cancel Approvals, and Receive All Items, by the approval outcome, and by the automatic update that sets the order to Received (see Automatic updates after a receipt). Add Comment notifies the followers too, and Reopen Order notifies no one. For a status change or a comment, the subject of the e-mail to a follower is "Followed order update (Purchase Order): <title>". The followers are notified while at least one of these five workflow parameters is on, each kind of notice under its own parameter, and all five are on in the supplied configuration: Notify Followers on Purchase Order Comments, Notify Followers on Purchase Order Creation, Notify Followers on PO Required Date Breaches, Notify Followers on PO Required Date Warnings, and Notify Followers when Purchase Order Status Changes. For following an order, see Follow and unfollow a record.

In the Web App, Place Order, Cancel Order, Close Order, Request Approval, Cancel Approvals, Receive All Items, and Add Comment stop when an active follower of the order has no primary e-mail address, with the message "<full name>'s Primary E-mail does not exist. Please review as this process will result in an E-mail notification.", or has an address that is not valid, with a message that names the person and says that the Primary E-mail is not a valid address. When you run Add Comment on an order that has an owner, it also e-mails the owner, with the subject "Note Added (PO): <title>", and it stops if the owner has no primary e-mail address or an address that is not valid, with the same messages, which then name the owner. The followers are checked before the owner. A stopped action saves nothing: the order keeps its status, no activity is logged, and no e-mail is sent.

Records created on receipt

What a receipt creates depends on the line's product class:

  • Hardware, Asset, Computer, or Software License: assets, as many as the quantity received.
  • Consumable: one consumable.
  • Other: nothing.

Each asset created is at the status In Stock. It takes the order's number and date as its purchase order and purchase date, records the received date, takes its unit cost and price from the line's unit price, has its default depreciation and workspace set, and gets a stock movement record. For a Computer, Hardware, or Software License line, the receipt also creates the matching computer, hardware item, or software license, associated with the asset; an Asset line gets no such record. Receive All Items also sets the stock room of each record it creates. The records created are linked to the line, so they appear on the Assets and Consumables tabs of the line and of its order.

PO item statuses and types

PO items have the statuses Open, Partially Received, Received, and Canceled, and the types IT Equipment, Office Supplies, Other, Services, and Software. The status field of a PO item is read-only on the form; Mark Partial Order, Cancel Order, and the automatic update that sets a line to Received (see Automatic updates after a receipt) set it. Cancel Order is the only action that sets a line to Canceled: it sets each line at Open to Partially Received when its quantity received is more than 0 and to Canceled otherwise, and lines at Partially Received or Received keep their status. The quantity received stays editable.

PO Items views

In the Web App, the PO Items list offers the shared views List, All PO Items, Open, Partially Received, Received by Date, by Product, by Product Class, by Requester, by Stock Room, and by Type/Category. When no current view is saved, the list opens on List, which shows each line's flag, ID, PO number, PO date, vendor, quantity, unit price, and line price, sorted by PO number, with the quantity, unit price, and line price summed.

Automatic updates after a receipt

Two automatic updates finish a receipt:

  • When a line is created or changed so that its quantity received equals its quantity, and its status is not Received, the line's status is set to Received, and its date received to today if it is blank.
  • When a line is saved while its order is at Ordered and no line of the order is left at Open or Partially Received, the order's status is set to Received and its date received is set.

Because the quantity received stays editable, raising it to the quantity on the PO item form and saving also lets the line become Received.