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

@@ -1227,6 +1227,164 @@ 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.
 
+
+
+
+
+
+
+
+
+
+### Outside services
+
+![Work order item outside services](img/svc-wo-outside services.png)
+
+The Work order item Outside service record is where you record 3rd party service such as service depot or RMA repairs.
+
+The Outside services section of a work order is **optional** and won't be displayed until a work order item outside service 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.Outside services` customization box.
+
+If more than one outside service 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 the row selected.
+
+A work order item can have zero to many separate Work order item outside service records as required.
+
+All Work order item outside service edit form fields here are **optional**.
+
+#### Start date
+
+This field is a [date time field](ay-start-common-controls.md#date-and-time) control and is used to enter the point in time when outside service began.
+
+If the [Global settings outside service default minutes](adm-global-settings.md#outside service-default-minutes) value is set, AyaNova will automatically set the _Stop date_ 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.
+
+#### Stop date
+
+This field is a [date time field](ay-start-common-controls.md#date-and-time) control and is used to enter the point in time when outside service ended.
+
+If the [Global settings outside service default minutes](adm-global-settings.md#outside service-default-minutes) value is set, and the _Start date_ field is empty, AyaNova will automatically set the _Start date_ 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.
+
+#### Quantity
+
+This is hours of outside 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.
+
+#### Distance
+
+This optional field is the distance outside serviceled.
+
+#### Outside service rate
+
+This is the [outside service rate](acc-outside service-rates.md) that is billable rate for this outside service item.
+
+#### User
+
+Here you select the service technician User that had to outside service to provide service.
+
+#### No charge quantity
+
+Enter no charge hours here (Outside service that was required 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 _Quantity_ it is simply tracked here so the Customer can see they received some free outside service 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 Outside service.
+
+#### 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.
+
+#### Outside service details
+
+This optional field is used to record the details of the outside service required. Text entered here appears on stock work order and invoice reports as the explanation of outside service required.
+
+### Outside service table info fields
+
+The outside service table contains some read-only fields that are calculated or brought in from other records for reference purposes. Some of these fields are only visible to [higher rights users](#cost-restrictions).
+
+#### Unit of measure
+
+This is mirrored from the [Outside service rate's](acc-outside service-rates.md) _Unit charge description_ field and can be removed if not required through [Customizing](ay-customize.md) the work order form.
+
+#### Cost
+
+This is mirrored from the [Outside service rate's](acc-outside service-rates.md) _Cost_ field and can be removed if not required through [Customizing](ay-customize.md) the work order form.
+
+#### List price
+
+This is mirrored from the [Outside service rate's](acc-outside service-rates.md) _Retail charge_ field and can be removed if not required through [Customizing](ay-customize.md) the work order form.
+
+#### Price
+
+This is the calculated effective price of this record. If Price override is set, _that_ is the effective price no matter any other setting, otherwise it's the Outside service's List price as is, or adjusted if there is a Contract with a Outside service rate price adjustment in effect.
+
+#### Net price
+
+This calculated value is the effective Price field multiplied by the Quantity field.
+
+#### Tax A amount
+
+Net price multiplied by the selected Tax's A percentage.
+
+#### Tax B amount
+
+If the selected Tax does not have a Tax B set this field will be zero.
+
+If the selected Tax has Tax on Tax checked then this value is (Net price + Tax A amount) multiplied by Tax's B percentage.
+
+If Tax on Tax is not set then this is Net price multiplied by the selected Tax's B percentage.
+
+#### Line total
+
+Net price + Tax A amount + Tax B amount.
+
+### Outside service context menu
+
+![Work order item outside service context menu](img/svc-wo-outside services-context-menu.png)
+
+#### New
+
+Add a new work order item Outside service record to the collection and open it's record in the edit form.
+
+#### Mark for deletion
+
+Flag the selected row work order item outside service record to be permanently deleted.
+
+When clicked the work order item outside service 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 outside service'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 outside services, in this work order item only, to be permanently deleted when the work order is saved.
+
+When clicked, all the work order item outside services 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 outside service'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