---
alias: user-guide-combine-material
description: "This documentation details combining materials, maintaining traceability and quantity within a system"
---

# Combine Material

:lock: Material.**Combine**

## Overview

This operation is used to combine one **Material** (Source) with another (Target), without changing the quantity of the Target **Material**. It is useful to consume the Source **Material** and keeping the genealogy and traceability of the Target **Material**.

## Setup

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

## Preconditions

* Source and Target **Material** are Active.
* Source and Target **Material** are not On Hold and are not In Transit.
* Source **Material** and Target **Material** must be in the same **Facility**.
* Source **Materials** must not have expired or an Expiration Date has not been defined.
* Combined PrimaryQuantity >= 0 and Combined SecondaryQuantity >= 0 (if Step of Target Material contains a Secondary Unit). Note that, the combine quantity can only be decimal if the property IsDecimalQuantityAllowed is set to `True` in the Step and the Product Discrete property is `False`.
* Combined PrimaryQuantity <= Source **Material** Primary Quantity; Combined Secondary Quantity <= Source **Material** SecondaryQuantity.
* Topmost of Source and Target **Materials** must not have a CurrentBOMVersion.
* Topmost of Source and Target **Materials** must have different Topmost **Materials**.
* The Topmost Source and Topmost Target **Materials** must have the TransferMaterial property set to `Null`.
* The Source **Material** Products must not be blocked or if blocked, the Source **Materials** property OverrideProductBlock must be `True`.
* The Source **Materials** must not have any open defects (Open Defect Count is zero).

## Sequence of Steps

### Step 1

1. Verify the **Material** information.
2. Select the **Materials** to combine by selecting :material-plus: and specify, for each **Material**, the primary and secondary quantities (if defined) to combine. It is also possible to remove the **Materials** by selecting :material-trash-can:.
3. Optionally, enter a comment.
4. Select **Combine** to complete the operation.

![Screenshot showing a UI element labeled "Combine" in the context of combining materials.](images/combine_material.png)