---
alias: user-guide-compose-material
description: "This operation increases a material’s quantity by incorporating quantities from other materials, tracking composition history"
---

# Compose Material (Quantities)

:lock: Material.**Compose**

## Overview

This operation is used to compose a **Material**, thus increasing its quantity, by incorporating quantities from other **Materials**. It can be seen as a lightweight Merge/Assemble **Material**.

An example of its application can be seen in the solar ingot fabrication. An ingot of a certain weight is the result of the composition of different **Materials** with different weights and with different **Products**.
A big difference from Combine **Material** is that the Target **Material** quantity is increased with the computed quantities of the Source **Materials**.

As a naming convention, the **Materials** from which quantity is taken are called Source **Materials**, and the **Material** receiving the quantity is called Target **Material**. The transferred quantity from each Source **Material** is called Composed Quantity.

It records the history of this composition and it is shown in the [[user-guide-material-genealogy]].

## Setup

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

## Preconditions

* Source and Target **Materials** are Active.
* Source and Target **Materials** are not On Hold and are not In Transit.
* Source and Target **Materials** must be in the same **Facility**.
* Source **Materials** must not have expired or an Expiration Date has not been defined.
* Composed Primary Quantity must be between `0` and the Source Material Primary Quantity; Composed Secondary Quantity must be `0` and the Source Material Secondary Quantity (if a Secondary Quantity is defined for the Source Step).

    !!! note
        The Composed Quantity can only be decimal if the Is Decimal Quantity Allowed property is set to `true` in the Step and the Product Discrete property is `false`.

* For each Source **Material**, the primary units are either:
    * the same as the Target **Material** (conversion factor = `1`) or;
    * defined in the Product Unit Conversion Factors.
* If the Target **Material** resides in a **Container** with Capacity Validation Mode property defined as Units; the position of the **Container** must be able to accommodate the new Target **Material** Quantity.
* Top-Most of Source and Target **Materials** must not have Current BOM Version.
* Top-Most of Source and Target **Materials** must have different Top-Mosts.
* The Top-Most Source and the Top-Most Target **Materials** must have the Current Transfer Material property set to `null`.
* The Source **Material** Products must not be blocked, or if blocked, the Source **Materials** property Override Product Block must be `true`.
* The Source **Materials** must not have any open defects (Open Defect Count is `0`).

!!! info
	  This transaction is relevant for genealogy.

## Sequence of Steps

### Step 1

1. Select a **Material** that complies with the preconditions.
2. Select the **Quantities** button, accessible through the **More** button on the top ribbon.

![Screenshot showing the Quantities button in the More menu on the top ribbon.](images/compose_material_option.png)

### Step 2

1. Verify the **Material** information.
2. Choose the **Materials** to compose by selecting the :material-plus: icon. For each **Material**, specify the Primary and, if defined, the Secondary Quantities. It is also possible to remove the **Materials** by selecting the :material-trash-can: icon. To perform the transaction, it is necessary to select at least one Source **Material**.

    !!! note
        The final Primary and Secondary Quantities (if defined) are automatically updated to reflect the Composed Quantities.

3. Optionally, enter a comment.
4. Select **Compose** to complete the operation.

![Screenshot showing a UI element labeled "Compose" in the process of completing an operation.](images/compose_material.png)