---
alias: user-guide-change-material-quantity
description: "This operation adjusts material quantities, requiring specific preconditions and step-by-step execution for accurate changes"
---

# Change Material Quantity

:lock: Material.**ChangeQuantity**

## Overview

This operation is used to change the quantity of a **Material** and/or one of its Child Materials, usually to correct a mistake.

## Setup

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

## Preconditions

* **Material** is Active and not In Transit.
* Final primary and secondary quantity (if defined) must be greater or equal to zero.
* If the TopMost **Material** Current BOM Version is not empty:
    * If the TopMost **Material** Current Assembly Type is not Automatic At Track In, the final **Material** BOM Version Matching BOM Quantity must be greater or equal to the Assembled Quantity.
    * If the TopMost **Material** Current Assembly Type is Automatic At Track In, Explicit Add, Explicit Long Running, or Packing, you cannot use the Change Quantity operation.
* If the **Material** Package Count is greater than zero:
    * If the **Material** is a Sub-Material, the Change Quantity operation is not allowed.
    * If the **Material** is TopMost:
        * The **Material** Primary Units must match the Packed Quantity Units of any Active Package of that **Material**.
        * The final **Material** Primary Quantity must be greater than the Total Packed Quantity of all the Active Packages that reference that **Material**, with the exclusion of the Packages of Content Type Material Ids.
* If the property Packing Step of the **Step** associated to the **Material** is set to `true`, and the **Material** is In-Process or Processed, the Change Quantity operation is not possible.
* If **Material** is associated with a **Container** and the Container Capacity Validation Mode is Units, that same Container must have enough capacity to support the new quantities.
* If the Step to which the **Material** is associated has the Is Decimal Quantity Allowed set to false, the final **Material** primary and secondary quantity must be integer quantities.
* If the **Material** is associated with a **Production Order**, when changing the **Material** Primary Quantity, the **Production Order** must not be closed.
* If the **Material** is associated with a **Production Order**, it is not possible to change the **Material** Primary or Secondary Units.  
* The TopMost **Material** property Current Material Transfer must be `null`.
* If the **Material Product** has its Product Type set to Part and the Part Type set to Repairable, the **Material** cannot be referenced in any active Resource Part.

## Sequence of Steps

### Step 1: Material

1. Verify the **Material** information.
2. If the **Material** is at a Step for which the property Set Units is false and the **Material** is Queued and has no parent or Sub-Materials, it is possible to specify new Units for the **Material**.

    !!! note
        The quantities can only be decimal if the **Step** Is Decimal Quantity Allowed property is `true` and the Product Discrete property is `false`.

3. Specify the new primary and secondary (if defined) quantities for the **Material** and, optionally, for its Sub-Materials (on the following screen).
4. If the **Step** has loss and bonus **Reasons** associated with it, it is possible to record the quantity's increases and decreases as bonuses and losses respectively, by selecting a loss and a bonus Reason. The quantity change will be handled as loss or bonus and will be shown automatically in the column Change Type.
5. Optionally, enter a Comment.
6. Select **Change** to complete the operation.

![change_material_quantity][change_material_quantity]

!!! info
	If the Material is currently part of an Inspection Order, it may become invalid after changing the Material Quantity.

!!! info
	If the Step where the Material is currently placed has the Print Material Labels Automatically property set to `true`, that information will be displayed on the bottom section of the wizard.

![Screenshot showing a printer displaying automatically generated labels for materials.](images/material_label_printing_automatically.png)

[change_material_quantity]: images/change_material_quantity.png