---
alias: record-assembled-material-loss-bonus
description: "Record assembled material loss or bonus transactions require specific material and quantity criteria"
---

# Record Assembled Material Loss/Bonus

:lock: Material.**RecordAssembledLossBonus**

## Overview

The user accesses the system in order to record an assembled quantity loss or bonus for the **Material**.

## Setup

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

## Preconditions

* **Material** exists, is Active and is not InTransit.
* Used Loss/Bonus **Reasons** are the ones which are defined for the current **Material** *Step* and which are applicable to *Record Loss*.
* If **Material** current *Step* *IsDecimalQuantityAllowed* is set to true, the user can specify decimal quantity losses, otherwise they must be integer.
* When reporting a Loss, the **Material** has a *PrimaryQuantity* or *SecondaryQuantity* greater than zero.
* There is a **BOM** defined for the topmost of the **Material** on which losses or bonuses are to be recorded.
* To record losses, the **Material** *AssembledQuantity* must be greater than zero.
* To record bonuses in a **Material**, its Topmost **Material** must have an *AssemblyType* different from *AutomaticAtTrackOut* in the associated **BOM**.
* For each selected Loss/Bonus **Reason**, either PrimaryQuantityLoss(Bonus) or SecondaryQuantityLoss(Bonus) are greater than zero.
* If recording bonus for a **Material**, since it is assumed that the bonus quantity will reside at the same container/position as the **Material**, it must be checked that, if a *Container Position* is defined for the **Material**, then the **Container** *CapacityPerPosition* can hold the **Material** plus the additional bonus quantity (*Primary* or *Secondary Quantity* as defined in the **Container** *CapacityUnits*).
* To record losses, if the Package Count is greater that zero, this operation can only be called from Terminate Package.

## Sequence of Steps

### Step 1

This screen captures all the information necessary to complete the transaction.

1. Verify the Material information.
2. Check the Terminate Material on zero quantities and no SubMaterials to terminate the Material automatically if it meets that criteria.
3. It is possible to set the Material final quantity, in which case the delta will be shown and automatically calculated.
4. In case that there is a catalogue of losses associated, it is possible, clicking on the multimedia button to visually select the appropriate loss reason - pressing OK will automatically add it to the list.
5. For each loss and bonus reason (if existing) enter the amount of primary quantities for that loss / bonus code.
6. Optionally enter a comment.
7. Press Record Loss/Bonus to complete the operation.

![recordAssembledLosses][recordAssembledLoss]

!!! info
	In case that Loss Classifications are defined, loss reason rows have to be added manually and all loss classifications must be provided by the user.

!!! info
	In this transaction is not possible to change the secondary quantities - if defined.

!!! info
	Only losses which have been qualified to apply to Record Loss appear in the losses grid.

[recordAssembledLoss]: ../../images/recordAssembledLoss.gif