docs/8.0/ayanova/docs/inv-purchase-orders.md

@@ -39,9 +39,9 @@ Purchase orders are accessed in the following ways:
 
 The Purchase orders [data table](ay-start-form-data-tables.md) lists all the purchase orders previously entered, where you create a new purchase order and provides access to common [data table menu options](ay-start-form-data-tables.md#common-menu-options).
 
-## Purchase order edit form
+## Purchase order edit form header
 
-The Purchase order edit form provides all the [standard edit form](ay-start-edit-forms.md) functionality and the following fields:
+The Purchase order edit form provides all the [standard edit form](ay-start-edit-forms.md) functionality and the following header fields that are not part of the purchase order items collection documented [below](#order-items).
 
 #### PO number
 
@@ -97,6 +97,107 @@ Optional notes area for any purpose that makes sense to your business. Often thi
 
 This field does not display on the stock vendor purchase order report.
 
+#### Tags
+
+Optional [tags control](ay-start-form-tags.md) for categorizing and notification [filtering](home-notify-subscriptions.md#tags).
+
+#### Wiki
+
+Optional [wiki control](ay-start-form-wiki.md).
+
+#### Attached files
+
+Optional [attachments control](ay-start-form-attachments.md).
+
+## Order items
+
+### Items table
+
+![po items table](img/inv-po-items-table.png)
+
+The Items table is where the details of each line item in the PO are viewed, entered and where each item can be received individually in the case of a partial receipt.
+
+The columns displayed in the order items table are a mix of user entered PO Item fields and read only fields containing extra details for reference purposes.
+
+Many of these columns can be hidden in the user interface via [form customization](ay-customize.md) if not required.
+
+The far right column contains an Open button to open the purchase order item edit form to make changes to an existing item.
+
+### Items menu
+
+The items collection has it's own menu accessed from the context menu at the end of the "Order items" title in the items table.
+
+The menu offers options for adding items from various sources as well as bulk receiving all items when the order is received exactly as requested:
+
+![po items menu](img/inv-po-items-menu.png)
+
+#### New
+
+This menu option opens a [form](#item-edit-form) for entering a new purchase order line item manually.
+
+#### Restock list
+
+This menu option opens a form for selecting parts to add to this purchase order that have fallen below their [required minimum inventory quantity level](inv-part-stock-levels.md). Selections made in that form will be turned into PO items automatically and added to this purchase order.
+
+#### Part requests
+
+This menu option opens a form for selecting parts to add to this purchase order that have been [requested](inv-part-requests.md) by a service technician on a work order when they have insufficient inventory of a part to provide service. Selections made in that form will be turned into PO items automatically and added to this purchase order and a connection will be made between the work order item part request and this purchase order item to facilitate notification and provide a navigation link between both records.
+
+#### Receive all
+
+Use this menu option to completely receive the items on order that have not been received yet.  This option should only be used when the order matches the received quantities exactly.  In all other cases you should receive items individually inside their line item edit form.
+
+### Item edit form
+
+![po item edit form](img/inv-po-item-edit.png)
+
+
+
+
+#### Changing received line items
+
+Inventory is _live_ in AyaNova and received items affect inventory when first received and when edited later. If you modify a received purchase order item, for example adjusting the quantity or changing a part and save the record those changes will take effect immediately in the inventory that all other AyaNova Users have access to.
+
+#### Part
+
+This column displays the selected [Part](inv-parts.md) being ordered.
+
+#### Part description
+
+This read only field displays the value entered in the [Part](inv-parts.md) records `Part description` field. This field is also available to the Part [autocomplete list template](adm-global-autocomplete-templates.md) for selection purposes.
+
+#### Part UPC
+
+This read only field displays the value entered in the [Part](inv-parts.md) records `UPC` field. This field is also available to the Part [autocomplete list template](adm-global-autocomplete-templates.md) for selection purposes.
+
+#### Part warehouse
+
+This column displays the selected part [warehouse](inv-part-warehouses.md) that will receive this line item.
+
+#### Part Unit of measure
+
+This read only field displays the value entered in the [Part](inv-parts.md) records `Unit of measure` field. This field is also available to the Part [autocomplete list template](adm-global-autocomplete-templates.md) for selection purposes.
+
+#### Quantity ordered
+
+#### Net total
+
+This value is the sum of the Quantity multiplied by the received cost of this line item before taxes. This value is calculated at the _server_ so will not display until a record is saved.
+
+#### Tax A
+
+This is the line total Tax A amount calculated by multiplying the Tax A percentage in the selected [Tax Code](acc-tax-codes.md) by the Net total. This value is calculated at the server and will display once a record is saved.
+
+#### Tax B
+
+This is the line total Tax B amount calculated by multiplying the Tax B percentage in the selected [Tax Code](acc-tax-codes.md) by the Net total. This value is calculated at the server and will display once a record is saved.
+
+#### Line total
+
+This value is the total sum of the Net total + Tax A amount + Tax B amount. This value is calculated at the server and will display once a record is saved.
+
+#### New item
+
 00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
 
 ## New PO Item first save