---
alias: user-guide-transfer-material-between-containers
description: "This documentation details transferring material between containers, adhering to specific preconditions and a defined sequence"
---

# Transfer Material between Containers

:lock: Material.**TransferBetweenContainers**

## Overview

This operation is used to transfer a **Material** from one **Container** to another.

## Setup

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

## Preconditions

* For the **Material**:
    * The **Material** is *Active*, Not *OnHold* and not *InTransit*.
    * The **Material** has a **Container** associated with it.
    * The old **Container** is in state *Available*.

* For the new **Container**:
    * **Container** is *Active* and UsedPositions < TotalPositions or TotalPositions = -1.
    * The **Container** is in state *Available*.
    * **Container** *PositionUnitType* must be **Material**.
    * If the **Container** *IsAutoGeneratePositionEnabled* is set to False, the supplied position must not be in use at the **Container**.
    * Depending on the *CapacityValidationMode*:
        * *Units* -  *CapacityUnits* are the same as either the PrimaryUnits or SecondaryUnits of the **Material** being transferred. The units are taken from the **Material**, not the **Step**.
        * *Form* - *Form* of the **Material** must match the **Container** *CapacityForm*.
        * *None* - no check.
* If the *CapacityValidationMode* is *Units*, the quantity of the **Material** being transferred does not exceed the *CapacityPerPosition* (or *CapacityPerPosition* = -1)
* The new **Container** must be different from the old **Container**.
* The new **Container** *HoldCount* must be zero.
* The **Facility** of the new **Container** must be the same as the **Facility** of the old **Container**.
* If the property Use Container Restrictions in the **Step** of the **Material** is `True`, the available containers will be the ones that match the restrictions applied by the context of that **Step**. For more information, see [Contexts View](../../../business-data/step/step_page/#contexts-view) or [MaterialContainerTypeContext](../../administration/tables/smart-tables/materialcontainertypecontext.md).

    !!! note
	    The Container Used Positions must be less than the Container Max Usable Positions.

## Sequence of Steps

### Step 1

1. Verify the **Material** information.
2. Select the new **Container** to which the **Material** is going to be transferred.
3. Click **Transfer** to complete the operation.

![transfer_material][transfer_material]

[transfer_material]: images/transfer_material.png