Change Material Quantity#

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.