docs/8.0/ayanova/docs/svc-workorders.md

@@ -759,10 +759,118 @@ You can also refresh the page to abandon this and any other changes made locally
 
 Until the work order is saved the items are not actually deleted.
 
-## Extras info that may or may not be added later
+
+
+
+
+
+
+
+### Labors
+
+![Work order item labors](img/svc-wo-labors.png)
+
+The Work order item Labors record is where you enter labor provided during service. 
+
+The Labors section of a work order is **optional** and won't be displayed until a work order item labor record is added from the [Work order Items context menu](#work-order-item-context-menu). It can also be completely removed as an option if it won't be required by [customizing](ay-customize.md) the work order form and un-checking the _Visible_ checkbox in the `Work order Item.Labors` customization box.
+
+If more than one labor record is added to the work order item they will be displayed in a table with an edit form below. Selecting a row in the table will switch the edit form below to row selected.
+
+A work order item can have zero to many separate Work order item labor records as required.
+
+All Work order item labor edit form fields here are **optional**.
+
+#### Service Start date time
+
+This field is a standard form [date time field](ay-start-common-controls.md#date-and-time) control and is used to enter the point in time when labor began.
+
+If the [Global settings Scheduled / labor default minutes](adm-global-settings.md#scheduled--labor-default-minutes) value is set, AyaNova will automatically set the _Service Stop date time_ and _Quantity_ on new records.
+
+If a stop time is already set, adjusting the start time will cause AyaNova to calculate the _Quantity_ field automatically.
+
+
+#### Service Stop date time
+
+This field is a standard form [date time field](ay-start-common-controls.md#date-and-time) control and is used to enter the point in time when labor ended.
+
+If the [Global settings Scheduled / labor default minutes](adm-global-settings.md#scheduled--labor-default-minutes) value is set, and the _Service Start date time_ field is empty, AyaNova will automatically set the _Service Start date time_ and _Quantity_ on new records.
+
+If a start time is already set, adjusting the stop time will cause AyaNova to calculate the _Quantity_ field automatically.
+
+#### Service rate quantity
+
+This is hours of service to be recorded / billed. It doesn't have to match the selected time period between the start and stop fields but it's a good idea to do so to avoid confusion.
+
+#### Service rate
+
+This is the [service rate](acc-service-rates.md) that is billable rate for this labor item.
+
+#### User
+
+Here you select the service technician User that provided service.
+
+#### No charge quantity
+
+Enter no charge hours here (Labor that was provided but will not be billed) so that they appear on the stock Customer invoice / work order and other reports and are tracked in the system.  This value is **not deducted** from the *Service rate quantity* it is simply tracked here so the Customer can see they received some free labor and so that time can be tracked in AyaNova for reporting and business metric purposes.
+
+#### Sales Tax
+
+[Tax](acc-tax-codes.md) to be charged for this Labor.
+
+#### Price override
+
+Manually force the price to a certain value. This override supersedes any other source for the price including Contracts and / or the source object's price itself.
+
+Contract adjusted pricing is not part of the Manual Price Override feature; only values entered by a user manually in this field will be present.
+
+#### Service details
+
+This optional field is used to record the details of the labor provided.  Text entered here appears on stock work order and invoice reports as the explanation of labor provided and is (along with all other text entered on a work order) indexed for searching so it can be useful as a reference for future technicians searching for past resolutions to similar problems.
+
+Typically the more technical or complex the labor provided the more details are entered here.
+
+### Labor context menu
+
+![Work order item labor context menu](img/svc-wo-labors-context-menu.png)
+
+#### New
+
+Add a new work order item Labor record to the collection and open it's record in the edit form.
+
+#### Generate Unit from selected labor
+
+It's often the case that service companies will supply Labors to a customer during service which in turn are large enough units of equipment that they may also need to be serviced or maintained themselves in future and tracked in AyaNova as a [Customer unit](svc-units.md) which can be selected on work orders as the Unit under service.
+
+This menu option is provided to easily create a new [Customer unit](svc-units.md) in AyaNova based on the selected Labor. Clicking on this option will open a Unit form for entry and autoamtically select the Customer and fill in some fields based on the labor selected in the work order. Once this new Unit record is saved it's immediately available to be selected as a Unit for this Customer.
+
+#### Labor assembly
+
+The *Labor assembly* feature is used to append a pre-made list of labors from a [Labor assembly](inv-labor-assemblies.md) into this work order item. This is ideal for common lists of labors that are always used as a group together but need to be tracked individually.
+
+Clicking on this option will open a dialog box for selecting an existing Labor assembly:
+
+![Work order item labor assembly dialog](img/svc-wo-labors-assembly-dialog.png)
+
+Select the desired labor assembly and labor warehouse and click _Add_ to append them all to the current work order item labor section.
+
+#### Mark for deletion
+
+Flag the selected row work order item labor record to be permanently deleted. When clicked the work order item labor record selected will display in the table with a line through it indicating it will deleted on the next save of the work order and an _Undelete_ button for reversing the delete flag will appear at the top of this work order item labor's edit form.
+
+You can also refresh the page to abandon this and any other changes made locally to the work order that have not yet been saved at the server.
+
+Until the work order is saved it's not actually deleted.
+
+#### Mark ALL for deletion
+
+Flag all work order item labors, in this work order item only, to be permanently deleted when the work order is saved. When clicked, all the work order item labors on this work order item will display in the table with lines through them indicating they will be deleted on the next save of the work order and an _Undelete_ button for reversing the delete flag will appear at the top of each work order item labor's edit forms.
+
+You can also refresh the page to abandon this and any other changes made locally to the work order that have not yet been saved at the server.
+
+Until the work order is saved the items are not actually deleted.
 
 ## OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
-
+## Extras info that may or may not be added later
 000000000000000000000000000000000000000000000000000000000000
 
 -