---
alias: user-guide-record-submaterial-losses
description: "Record sub-material losses, specifying quantities and reasons within existing material steps"
---

# Record Sub-Material Losses

:lock: Material.**RecordSubMaterialLosses**

## Overview

The user accesses the system in order to record a quantity loss or bonus for all **Sub-Materials** (first level only).

## Setup

No special setup is required other than to meet the preconditions of the transaction. Note that the Loss and Bonus **Reason(s)** must be associated with the current **Material** *Step*.

## Preconditions

* **Material** exists, is Active and is not InTransit.
* **Material** has **Sub-Materials**.
* **Sub-Materials** Package Count must be empty.
* Used Loss **Reasons** are the ones defined for the current **Material** *Step*.
* **Sub-Materials** on which a loss is being recorded has a *Primary Quantity* or *Secondary Quantity* greater than zero.
* If **Material** current **Step** *IsDecimalQuantityAllowed* is set to true then the user can specify decimal quantity losses, otherwise, they must be integer.
* If the Topmost of the **Material** on which the loss is being recorded has the **CurrentBOMVersion** different from Null, then the final **Material** *Primary Quantity* must be greater or equal to the **Material** *Assembled Quantity*.

## Sequence of Steps

### Step 1

1. Choose the Record SubMaterial loss, under the Record loss/bonus button.
2. Optionally, review the **Material** details, by expanding the Material section.
3. Optionally, expanding the Options section will allow two properties to be changed:
   * *Terminate Material on zero quantities and no Sub-Materials*, which, if checked, will terminate the **Material** under those circumstances.
   * *Defining final quantity manually*, which, if checked, allows the user to define the final quantity, in which case the delta will be automatically calculated and shown.
4. Choose a **Reason** for the Loss.
5. It is possible to check Full Loss option to record a full quantity loss on a particular **Sub-Material**.
6. If the Loss is not full, enter the *Quantity* lost. The final quantity will be calculated automatically and displayed both in the Final Quantity text box as well as below the **Sub-Material** list.
7. Optionally enter a *Comment*.
8. Press Record Loss to complete the operation.

:information_source:  Only losses which have been qualified to apply to Record Loss appear listed.

![recordSubmaterialLosses][recordSMLosses]

!!! info
	It is possible to define the default value for checkbox Terminate Material on zero quantity(ies) and no SubMaterials by adding the entry Context = `Material.RecordSubMaterialLosses`, `Element = TerminateOnZeroQuantity` as context in the Generic Table *GUIElementDefaultValue*.

!!! info
	The Parent **Material** will be terminated if the flag *Terminate Material on zero quantity(ies) and no Submaterials* is checked and all **Sub-Materials** are terminated and there is no *Primary Quantity* or *Secondary Quantity* left in the Parent.

[recordSMLosses]: ../../images/recordSubMaterialLoss.gif