CalculateQuantityWithShrink

Calculate Quantity With Shrink

Minor Business Rule

Object Name: N3003220

Parent DLL: CMFGBASE

Location: Client/Server

Language: NER

1.Functional Description

1.1Purpose
This function calculates a total quantity with shrink for a parent item by taking the passed 
transaction quantity, converting it to the item's primary unit of measure, and increasing (or decreasing) that 
quantity based on the shrink factor (IBSRNK) and Shrink Factor Method (IBSRKF),  percentage yield (%) 
or yield quantity (F), in the Item Branch table (F4102) for that item.  The result is rounded based 
on the "Round to Whole Number" value (SNS) on the Item Master (F4101).

1.2Setup Notes and Prerequisites
None.

1.3Special Logic
The value returned in the Component Multiplier field will be the quantity used to extend the 
component required quantity.  The components or routing hours are extended by the requested qty w/ shrink 
converted to the Bill of material or routing UOM. 

2.Technical Specifications

2.4Processing 
1.0.Convert Requested Qty to primary UOM.

WK Requested Qty Primary = DS Requested Qty converted to primary UOM from the DS Requested Qty 
UOM.

2.0.Retrieve the Shrink Factor and Shrink Factor method from F4102 using DS Item Number and DS 
Branch.  Retrieve the Rounding Indicator (SNS) from F4101 using DS Item Number.

3.0.Calculate Requested Qty w/ Shrink.

IF F4102 SRNK is equal to 0, WK Requested Qty w/ Shrink Primary = WK Requested Qty Primary

IF F4102 SRNK is not equal to 0 and F4102 SRKF = '%', 
WK Requested Qty w/ Shrink Primary = WK Requested Qty Primary  + (WK Requested Qty Primary * 
(F4102 SRNK / 100)) 

       IF F4102 SRNK is note equal to 0 and F4102 SRKF is not equal to '%', 
WK Requested Qty w/ Shrink Primary  = WK Requested Qty Primary  + F4102 Shrink Qty

4.0.Round the Requested Qty w/ Shrink.

If F4101 SNS is equal to 'R', round WK Requested Qty w/ Shrink primary

5.0.Convert to BOM UOM to calculate the component multiplier.

DS Component Multiplier = WK Requested Qty w/ Shrink Primary converted to the DS BOM Routing UOM.

6.0.Calculate Requested Qty w/ Shrink in Requested Qty UOM.

DS Requested Qty w/ Shrink = WK Requested Qty w/ Shrink primary converted to DS Requested Qty UOM.
If F4101 Rounding indicator is equal to 'R', round DS Requested Qty w/ Shrink 

Data Structure

D3003220 - CalculateQuantityWithShrink

Parameter NameData ItemData TypeReq/OptI/O/Both
mnParentItemNumberShortKITMATH_NUMERICOPTNONE

Parent Short Item Number (KIT) - Required Input Parameter
^

szBranchPlantMMCUcharOPTNONE

Parent Branch (MMCU) - Required Input Parameter
^

mnRequestedQuantityTRQTMATH_NUMERICOPTNONE

Requested Qty in Requested Qty UOM (TRQT) - Required Input Parameter
Note: Business function will convert this value to primary unit of measure for calculation; do not 
send in the value converted to primary.

^

mnRequestedQtyWithShrinkRQTE1MATH_NUMERICOPTNONE

Requested Qty w/ Shrink in Requested Qty UOM (RQTE1) - Output parameter.  Business function returns 
the requested qty adjusted for shrink in the unit of measure passed in as the Requested Qty UOM; zero 
is returned if there are errors converting the requested qty with shrink to the requested qty UOM.  
This quantity is rounded based on the "Round to Whole Number" flag (SNS) on the Item Master (F4101).

^

cShrinkFactorMethodSRKFcharOPTNONE

Shrink Factor Method (SRKF) - Output parameter; returns the shrink factor method for the parent item 
from F4101.  If errors encountered in business function (see ErrorMsgId parameter), returns blank in 
this field.

^

mnShrinkFactorSRNKMATH_NUMERICOPTNONE

Shrink Factor (SRNK) - Output parameter; returns the shrink factor for the parent item from F4101.  
If errors encountered in business function (see ErrorMsgId parameter), returns zero in this field.

^

szRequestedQtyUOMUOMcharOPTNONE

Requested Qty UOM (UOM) - Required input parameter.  Business function will convert the requested qty 
with shrink to this unit of measure.

^

szBOMRoutingUOMUOMcharOPTNONE

BOM Routing UOM (UOM) - Required input parameter.  Business function will convert the component 
multiplier to this unit of measure.  NOTE: If you are not using the Component Multiplier output parameter, 
pass the Requested Qty UOM into this field to avoid a Uom Conversion error.

^

mnComponentMultiplierMN29D9MATH_NUMERICOPTNONE

Component Multipier (MN29D9) - Output parameter.  Business function returns requested qty w/ shrink 
converted to the BOM Routing UOM; zero is returned if there is an error converting the requested qty w/ 
shrink to the BOM Routing UOM.  Used by calling program for extending component quantity required. 
This quantity is NOT rounded based on the "Round to Whole Number" flag (SNS) on the Item Master (F4101).

^

cSuppressErrorMsgsEV01charOPTNONE

Suppress Error Msgs (EV01) - Optional input parameter.  If set to '1', business function will 
suppress setting system errors; if any other value is passed, the business function will set system errors 
data structure fields associated with the error. The ErrorMsgId will contain the error message number 
regardless of whether or not errors are suppressed by this parameter.

^

szErrorMsgIdDTAIcharOPTNONE

Error Msg Id (DTAI) - Output parameter; returns error message numbers if errors are encountered in 
the business function.

^

Related Functions

None

Related Tables

None