CheckQtyTransferFromFromBranch

Check Quantity Transfer From From Branch

Major Business Rule

Object Name: B4100350

Parent DLL: COPBASE

Location: Client/Server

Language: C

Functional Description

Purpose
This function performs a test to see if the lot amount is correct for the location.

Setup Notes and Prerequisites
The Short Item Number (ITM), Branch/Plant (MCU), Location (LOCN), Lot Number (LOTN), Inventory
Reversal flag (EV01) and Primary Transaction Quantity (TQOH) are required parameters.

Special Logic

Technical Specification
Parameters
Data Item     Data Structure Description     I/O     Required     Notes
ITM           Short Item Number               I         Y
MCU           Branch/Plant                    I         Y
LOCN          Location                        I         Y
LOTN          Lot Number                      I         Y
EV01          Inventory Reversal              I         Y
EV01          Suppress Error Message          I         N
DTAI          Error Message ID                O         N
LOTF          Lot Number - From               I         N
LOCF          Location - From                 I         N
MCUF          Branch/Plant - From             I         N
TQOH          Primary Transaction Quantity    I         Y

Related Tables
F41021 - Item Location

Related Business Functions
Verify And Get Item Location - XF41021
Free Ptr To Data Structure - B4000460

Processing
This function retrieves the Item Location records for the specified key and accumulates the Quantity
on Hand (PQOH) for each location.  Once all locations have been accumulated, compare the accumulated
quantity on hand against the primary transaction quantity passed in.  If the total quantity on hand is
greater than the primary transaction quantity OR the quantity on hand for the specified quantity is
not equal to the primary transaction quantity, an error is set on.

^

Data Structure

D4100350 - Check Quantity Transfer From From Branch

Parameters
Data Item     Data Structure Description     I/O     Required     Notes
ITM           Short Item Number               I         Y
MCU           Branch/Plant                    I         Y
LOCN          Location                        I         Y
LOTN          Lot Number                      I         Y
EV01          Inventory Reversal              I         Y
EV01          Suppress Error Message          I         N
DTAI          Error Message ID                O         N
LOTF          Lot Number - From               I         N
LOCF          Location - From                 I         N
MCUF          Branch/Plant - From             I         N
TQOH          Primary Transaction Quantity    I         Y

^

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
mnShortItemNumber	ITM	MATH_NUMERIC	NONE	NONE
An inventory item number. The system provides three separate item numbers plus an extensive cross-reference capability to other item numbers (see data item XRT) to accommodate substitute item numbers, replacements, bar codes, customer numbers, supplier numbers, and so forth. The item numbers are as follows: o Item Number (short) - An eight-digit, computer-assigned item number o 2nd Item Number - The 25-digit, free-form, user defined alphanumeric item number o 3rd Item Number - Another 25-digit, free-form, user defined alphanumeric item number
szBranchPlant	MCU	char	NONE	NONE
An alphanumeric code that identifies a separate entity within a business for which you want to track costs. For example, a business unit might be a warehouse location, job, project, work center, branch, or plant. You can assign a business unit to a document, entity, or person for purposes of responsibility reporting. For example, the system provides reports of open accounts payable and accounts receivable by business unit to track equipment by responsible department. Business unit security might prevent you from viewing information about business units for which you have no authority.
szLocation	LOCN	char	NONE	NONE
The storage location from which goods will be moved.
szLotNumber	LOTN	char	NONE	NONE
A number that identifies a lot or a serial number. A lot is a group of items with similar characteristics.
cSuppressErrorMessage	EV03	char	NONE	NONE
A radio button that specifies the level at which trace/track result is to be displayed. Select the Detail to display all transactions except IB, IX, and IZ types. Or, select Derivative Lots Only to display only those transactions that may have created new derivative lot.
szErrorMessageID	DTAI	char	NONE	NONE
A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or special characters such as %, &, or +. You create new data items using system codes 55-59. You cannot change the alias.
cInventoryReversal	REVL	char	NONE	NONE
This field indicates whether the record being processed is a reversal.
szFromLotNumber	LOTF	char	NONE	NONE
The lot number for the from side of a transfer.
szFromLocation	LOCF	char	NONE	NONE
The location for the from side of a transfer.
szFromBranchPlant	MCUF	char	NONE	NONE
The lowest value of the range a given user is authorized to view and process data. It is used in conjunction with the Business Unit Through Code which defines highest value. If no record exists for a user and file, the user is completely authorized to the file. If the file name is blank for a given user, the Business Unit range setup applies to all users of the file.
mnPrimaryTransactionQuantity	TQOH	MATH_NUMERIC	NONE	NONE
The total quantity on hand in the primary unit of measure for an item at the beginning of the cycle count.

Related Functions

XF41021 Update F41021 Locations

Related Tables

F41021 Item Location File