Purchase Orders

On this page

A purchase order contains a header and line items. The header records the vendor, the billing and shipping addresses, the requester, the dates, and the terms of the order. Each line, a PO item, records one item with its unit price, quantity, line price, and the quantity received so far. An invoice is a separate document for the same line items.

For the actions, statuses, and views that the Default Workflow gives purchase orders and PO items, see Purchase Order Workflow.

In the Web App

Find purchase orders

The Purchasing section of the sidebar holds Purchase Orders, PO Items, Vendors, and Product Catalog. Invoices have no entry of their own: you reach them from the Invoices tab of their purchase order.

The PO Items list has no New button: a PO item is created from a purchase order, not from the list. The list does offer the preview, the actions, and batch update. When no view is defined for PO items, the list shows a built-in view with each line's flag, ID, part number, description, quantity, and status.

Create a purchase order

  1. In the sidebar, under Purchasing, open Purchase Orders.
  2. Click New. The menu lists the create actions available for purchase orders, and shows No Actions when there are none.
  3. Pick a create action, complete the form or wizard that opens, and click Submit. On the form for a new purchase order, Submit and open follows Submit; it also opens the new order once it is created.

For the create action of the Default Workflow and the path of an order from Draft to Closed, see Take a purchase order from Draft to Closed.

Add and open PO items

The Items sub-tab of the order's General tab lists the order's lines. While the form is editable, it offers New for a PO Item, which lists the create actions for PO items, and it has an Actions menu. When the order has unsaved changes, choosing an action from that menu first asks you to save or discard them.

  • A PO item created from an open purchase order has that order filled in when its form opens, and the form for a new PO item has no Submit and open.
  • Double-click a line to open its PO item form. The form opens in the current browser tab, or in a new tab when your setting to open records in a new tab is on.
  • By default the grid shows each line's flag, description, line number, quantity, quantity received, line price, and date received.

For the action that adds lines in the Default Workflow, see Add lines to an order.

Receive items

Receiving a line and creating the records it becomes is done by a workflow action. See Workflow Overview. For the receiving actions of the Default Workflow, see Receive the items of an order.

When you save the PO item form, the received quantity is not checked against the quantity ordered.

See received assets and consumables

The Assets and Consumables tabs of a PO item list the assets and consumables created from that line. The same two tabs of a purchase order list the assets and consumables of all its lines. They also list any asset or consumable that has no line but whose stored purchase order number equals the order's number. When two orders share a number, which of the two lists such a record is not defined.

All four grids offer Actions and no Delete. By default the assets grids show the flag, asset tag, purchase date, received date, type, owner, serial number, and status of each asset, and the consumables grids show the flag, name, purchase date, received date, type, owner, and status of each consumable.

Set the billing and shipping addresses

A purchase order has a bill-to field and a ship-to field. Each is a free-text field with an options button:

  • The button's search opens a list of company addresses: billing addresses for the bill-to field, shipping addresses for the ship-to field. A company address is listed for the bill-to field only when it is marked as a billing address, and for the ship-to field only when it is marked as a shipping address. One address can be marked as both.
  • When you pick an address, the field takes the address's description, and the address's phone, fax, contact, address, and email are copied into the order's matching billing or shipping fields. A value that is empty in the address clears the matching field.
  • The button's Open item finds the company address whose description matches the field's text.

The order keeps its own copy of the address. Editing or deleting a company address later leaves existing purchase orders as they were.

Company addresses are kept under Miscellaneous > Company Addresses in the sidebar, and one permission covers viewing, adding, editing, and deleting them. See Company Addresses and Brands.

Check the vendor's details

The Vendor Details sub-tab shows the vendor's name, FEIN, phone, fax, contact, email, and address. The vendor's web page is not among them.

  • You can type into the fields, but they are fetched from the vendor record when you first open the sub-tab, and after that every time the order's vendor changes, including before the order is saved, so switching the vendor updates the whole panel at once and replaces anything typed into it.
  • After the sub-tab has been opened, clearing the vendor of an order that has one blanks the seven fields.
  • On a saved order, opening Vendor Details replaces the order's own vendor fields on the form with the vendor's current values. Saving the order then sends those values with the rest of the form.

Work with invoices

An invoice belongs to one purchase order. It carries an invoice number, an invoice date, a payment due date, and a total amount that is stored with the invoice. Each invoice item links to one PO item and records the quantity invoiced alongside the quantity received, so an invoice can differ from the purchase order about how much arrived. No sidebar entry and no tab of a form leads to invoice items.

The purchase order's Invoices tab lists its invoices. An invoice created from an open purchase order has that order filled in when its form opens. The invoice form's tabs are General, Custom Data, Notes, History, and Attachments.

Reference

This section gives the details of purchase orders and PO items in the Web App.

What you can see and change

  • Viewing and adding PO items follows the permission to view PO items. Editing and deleting PO items follows the permission to edit purchase orders.
  • One permission covers viewing, adding, editing, and deleting invoices and their items.

See Permissions Reference.

Order figures and totals

The Purchase Orders list computes each order's figures from its lines: the subtotal, the quantity ordered, the quantity received, and the quantity remaining, which never drops below zero. The order total is computed rather than stored, as the sum of:

  • the shipping price
  • the subtotal
  • the sales tax
  • the shipping tax, which is the shipping tax rate as a percentage of the shipping price
  • the price adjustment

The purchase order form

The top of the form shows the order's title, status, and lifecycle, and Purchase Order: with the order number.

The General tab has these sections:

  • Details - the order's ID, status, number, date, title, vendor, currency, owner, the person who authorized it, and the budget.
  • Categorization - workspace, type, tags, and category.
  • Requester - the requester and the organization.
  • Shipping - the date required, payment terms, shipping, freight terms, the date received, and an invoice number and date.
  • Custom data, shown only when custom fields are placed on the General tab.

The choices for the budget, payment terms, shipping, and freight terms, and for the units of measure of a PO item, come from lookup lists that an administrator maintains.

Next to these sections, the General tab has the sub-tabs Items, Vendor Details, Bill To, and Ship To. Items holds the order's lines and the totals: subtotal, tax rate, sales tax, shipping price, shipping tax rate, price adjustment, and total.

The form's other tabs are Activity, Approvals, Custom Data, Assets, Consumables, Invoices, Related Objects, Notes, History, and Attachments. The Approvals tab is hidden on an order that has no approvals, and the Custom Data tab is hidden when no custom fields are placed on it.

PO item numbering, history, and deletion

  • Lines are numbered in the order they are added. The number of a deleted line is not given out again.
  • A line's ID is the order's ID followed by # and the line number. When the order's ID changes, the IDs of its lines change with it.
  • A new line's quantity defaults to 1.
  • The order's history records each line added ("PO Item added", with the line number and the line's description) and each line deleted ("PO Item deleted").
  • Deleting a line leaves the assets created from it in place and clears their link to the line.
  • Deleting a line does not clear the link of a consumable created from it. A delete from a grid of a line that a consumable still links to is refused with the message "Unable to delete/modify object because it is referenced by other database object(s). To delete/modify the object, you need to remove these dependencies first."
  • Deleting a purchase order deletes its lines. Stock movements that referred to the order keep the order's ID and title.

The PO item form

A line can link to a product from the product catalog and to a stock room; both links are optional. A line also carries a product class, and for each class the line could become, a default type and category.

The PO item form shows the line's description and status at the top, and PO Item: with the line number. Its General tab has these sections:

  • Purchase Order - the order number and the line number.
  • Details - workspace, type, tags, category, description, part number, unit price, quantity, and line price.
  • Comment.
  • Custom data, shown only when custom fields are placed on the General tab.
  • Product info - the product, SKU, return policy, and return period.
  • Units of measure - the purchasing unit, the stocking unit, and the conversion factor.
  • Receiving - the date received, the quantity received, the stock room, the status, and a Categories section with the asset categorization.

The line price field of the PO item form shows a calculator icon.

The PO item form's tabs are General, Custom Data, Assets, Consumables, Notes, and Attachments.

Currency display

A purchase order has a currency field in its Details section. An order that names no currency uses the installation's default currency.

PO items, invoices, and invoice items have no currency of their own. Their lists read the currency from a purchase order instead: a PO item takes the currency of its purchase order, an invoice the currency of its purchase order, and an invoice item the currency of the purchase order of its invoice. See Currencies and Multicurrency.