---
alias: user-guide-grade-material
description: "This documentation outlines the process for grading materials based on binning data"
---

# Grade Material

:lock: Material.**Grade**

## Overview

A **Material** is graded based on the **Product** Binning information.

!!! note
	Grading is done **Material** by **Material**, be it Topmost or SubMaterial.

## Setup

No special setup is required other than to meet the preconditions of the transaction.

## Preconditions

* The **Material** exists and is Active.
* The **Material** is not On Hold or In Transit.
* The Topmost **Material** CurrentBOMVersion must not be defined.
* The **Material** primary quantity is greater than zero.
* The **Product** in the **Material** must have a BinningTree defined for the current **Step** of the **Material**.
* The **Flow** and **Product(s)** on which the **Material** will be graded exist, and are Active and enabled.
* Primary quantities of new SubMaterials can only be fractional if the property IsDecimalQuantityAllowed of the **Step** is set to `true`.
* The **Material** secondary quantity is zero.
* If the **Material** has a Production Order associated with it, the property IsProductionComplete of the **Material** must be set to `false`.

!!! info
	This transaction is relevant for Genealogy.

## Sequence of Steps

### Step 1

1. Verify the **Material** information.
2. Distribute the **Material** primary quantity across all the possible bins.

	!!! note
		Bins correspond to MainProduct, SubProduct, or Loss.

3. The **Material** primary quantity must be fully assigned to the available bins.
4. Verify the SubProduct information.
5. For all the new SubProducts, a new SubMaterial will be created. If there is a name generator, the name of the SubMaterial will be automatically created, otherwise, it must be provided by you.
6. Optionally, enter a comment.
7. Select **Grade** to complete the operation.

![grade_material][grade_material]

[grade_material]: images/grade_material.png